# 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 App Kits API
  version: 1.0.0
extends: openapi/thehiveryiq-com-app-kits-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: 6
- target: $.paths['/v1/appkits'].get
  update:
    x-apievangelist-phrasing:
      intent: Discover App Kits capabilities
      effect: read
      questions:
      - 'What can the App Kits surface do: quote, bridge, send, swap?'
      - Which chains and tokens does App Kits support?
      instructions:
      - text: Show App Kits capabilities.
      - text: List what the App Kits surface supports.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/appkits/quote'].post
  update:
    x-apievangelist-phrasing:
      intent: Quote a cross-chain token conversion
      effect: read
      questions:
      - How much would I receive converting one token to another across chains?
      - Can I get a price quote before bridging or swapping?
      instructions:
      - text: Quote {amount} {token_in} on {chain_from} to {token_out} on {chain_to}.
        slots:
          amount: requestBody.amount
          token_in: requestBody.token_in
          chain_from: requestBody.chain_from
          token_out: requestBody.token_out
          chain_to: requestBody.chain_to
      - text: Get a price for moving {amount} of {token_in} from {chain_from} into {token_out} on {chain_to}.
        slots:
          amount: requestBody.amount
          token_in: requestBody.token_in
          chain_from: requestBody.chain_from
          token_out: requestBody.token_out
          chain_to: requestBody.chain_to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/appkits/bridge'].post
  update:
    x-apievangelist-phrasing:
      intent: Bridge tokens to another chain
      effect: write
      questions:
      - How do I move a token from one chain to another address on a different chain?
      - Can I bridge USDC to a recipient on another network?
      instructions:
      - text: Bridge {amount} {token} from {from_chain} to {to_chain} for {to_address}.
        slots:
          amount: requestBody.amount
          token: requestBody.token
          from_chain: requestBody.from_chain
          to_chain: requestBody.to_chain
          to_address: requestBody.to_address
      - text: Move {amount} of {token} cross-chain from {from_chain} to address {to_address} on {to_chain}.
        slots:
          amount: requestBody.amount
          token: requestBody.token
          from_chain: requestBody.from_chain
          to_address: requestBody.to_address
          to_chain: requestBody.to_chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/appkits/send'].post
  update:
    x-apievangelist-phrasing:
      intent: Send tokens on a single chain
      effect: write
      questions:
      - How do I send tokens to an address on the same chain?
      - Can App Kits transfer a token to a recipient without swapping it?
      instructions:
      - text: Send {amount} {token} on {chain} to {to}.
        slots:
          amount: requestBody.amount
          token: requestBody.token
          chain: requestBody.chain
          to: requestBody.to
      - text: Transfer {amount} of {token} to {to} on {chain}.
        slots:
          amount: requestBody.amount
          token: requestBody.token
          to: requestBody.to
          chain: requestBody.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/appkits/swap'].post
  update:
    x-apievangelist-phrasing:
      intent: Swap one token for another on a chain
      effect: write
      questions:
      - How do I swap one token for another on the same chain?
      - Can I trade a token for a different one without bridging?
      instructions:
      - text: Swap {amount} {token_in} for {token_out} on {chain}.
        slots:
          amount: requestBody.amount
          token_in: requestBody.token_in
          token_out: requestBody.token_out
          chain: requestBody.chain
      - text: Exchange {amount} of {token_in} into {token_out} on {chain}.
        slots:
          amount: requestBody.amount
          token_in: requestBody.token_in
          token_out: requestBody.token_out
          chain: requestBody.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/appkits/balance/{address}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a wallet's unified cross-chain balance
      effect: read
      questions:
      - What is a wallet's balance across every supported chain?
      - Does the unified balance return live per-chain data yet?
      instructions:
      - text: Get the unified balance for {address}.
        slots:
          address: path.address
      - text: Show wallet {address}'s balance across all chains.
        slots:
          address: path.address
      method: generated
      generated: '2026-09-26'