# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Dispute Observer API
  version: 1.0.0
extends: openapi/thehiveryiq-com-dispute-observer-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/dispute/check'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a counterparty's dispute history
      effect: read
      questions:
      - Has a wallet address been involved in disputes or on-chain reversals before I trade with it?
      - Which chains can I check a counterparty's arbitration history on?
      instructions:
      - text: Check dispute history for {address} on {chain}.
        slots:
          address: requestBody.address
          chain: requestBody.chain
      - text: Look for active arbitration cases involving {address} on {chain}.
        slots:
          address: requestBody.address
          chain: requestBody.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dispute/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List arbitration protocols
      effect: read
      questions:
      - Which decentralized arbitration protocols are available and how busy are they?
      - Where are the intake URLs for each arbitration provider?
      instructions:
      - text: List available arbitration providers with their case load.
      - text: Show arbitration protocol intake URLs.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dispute/route'].post
  update:
    x-apievangelist-phrasing:
      intent: Rank arbitration options for a dispute
      effect: read
      questions:
      - Which arbitration provider suits my dispute over a given amount?
      - Does the service file the dispute for me or just recommend where to go?
      instructions:
      - text: Rank arbitration options for {description} worth {amount_usd} USD.
        slots:
          description: requestBody.description
          amount_usd: requestBody.amount_usd
      - text: 'Suggest where to file a {amount_usd} USD dispute preferring {jurisdiction}: {description}.'
        slots:
          amount_usd: requestBody.amount_usd
          jurisdiction: requestBody.jurisdiction
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dispute/today'].get
  update:
    x-apievangelist-phrasing:
      intent: Get today's dispute activity rollup
      effect: read
      questions:
      - How many counterparties were flagged in the last 24 hours?
      - Which arbitration providers carry the most active cases today?
      instructions:
      - text: Show the 24-hour dispute rollup.
      - text: Get today's flagged counterparty count.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dispute/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check dispute observer health
      effect: read
      questions:
      - Is the dispute observer service up?
      - Can I run a liveness check on counterparty dispute lookups?
      instructions:
      - text: Check dispute observer health.
      - text: Confirm the dispute observer is responding.
      method: generated
      generated: '2026-09-26'