API Evangelist conversational phrasing for Tooloracle Io Mesh Economics API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tooloracle Io Mesh Economics API
  version: 1.0.0
extends: openapi/tooloracle-io-mesh-economics-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/economics/api/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the mesh economics service health
      effect: read
      questions:
      - Is the mesh economics service up?
      - Which pricing version is the economics service running?
      instructions:
      - text: Check the mesh economics API health.
      - text: Show the economics service status and pricing version.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics/api/price'].post
  update:
    x-apievangelist-phrasing:
      intent: Price a tool call before running it
      effect: read
      questions:
      - How much will a tool call cost my wallet, fresh or cached?
      - Can I get a pricing decision without writing anything to the ledger?
      instructions:
      - text: Price a call to tool {tool_id} for wallet {wallet}.
        slots:
          tool_id: requestBody.tool_id
          wallet: requestBody.wallet
      - text: Quote tool {tool_id} for wallet {wallet} referred by {referrer_wallet}.
        slots:
          tool_id: requestBody.tool_id
          wallet: requestBody.wallet
          referrer_wallet: requestBody.referrer_wallet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics/api/commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Book an executed call into the ledger
      effect: write
      questions:
      - How do I record a tool call in the ledger after it runs?
      - When does a referrer get its reward booked for a call?
      instructions:
      - text: Commit pricing decision {decision} for wallet {wallet} as a {kind} call.
        slots:
          decision: requestBody.decision
          wallet: requestBody.wallet
          kind: requestBody.kind
      - text: Book the {kind} call for {wallet} with decision {decision} and output hash {output_hash}.
        slots:
          kind: requestBody.kind
          wallet: requestBody.wallet
          decision: requestBody.decision
          output_hash: requestBody.output_hash
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics/api/balance/{wallet}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a wallet's mesh ledger balance
      effect: read
      questions:
      - What is my wallet's balance in the mesh ledger?
      - Does an unknown wallet show a zero balance?
      instructions:
      - text: Get the ledger balance of wallet {wallet}.
        slots:
          wallet: path.wallet
      - text: Tell me how many credits {wallet} has left in the mesh ledger.
        slots:
          wallet: path.wallet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics/api/referral'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a direct referral between wallets
      effect: write
      questions:
      - How do I register that one wallet referred another?
      - Are self-referrals or multi-level referrals allowed?
      instructions:
      - text: Register a referral from {referrer_wallet} to {referee_wallet}.
        slots:
          referrer_wallet: requestBody.referrer_wallet
          referee_wallet: requestBody.referee_wallet
      - text: Record that wallet {referrer_wallet} brought in {referee_wallet}.
        slots:
          referrer_wallet: requestBody.referrer_wallet
          referee_wallet: requestBody.referee_wallet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics/api/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live, uncached mesh economics stats
      effect: read
      questions:
      - Can I get mesh economics stats generated live instead of the five-minute cached copy?
      - What are the mesh activity and treasury numbers at this exact moment?
      instructions:
      - text: Get live mesh economics statistics, not the cached dashboard.
      - text: Generate fresh up-to-the-second mesh economics stats.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/.well-known/mesh-economics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the cached mesh economics dashboard payload
      effect: read
      questions:
      - Where is the public machine-readable mesh economics file refreshed every five minutes?
      - What do the well-known economics numbers show for rewards and referrals?
      instructions:
      - text: Fetch the well-known mesh economics JSON.
      - text: Read the five-minute cached mesh economics payload.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/economics.html'].get
  update:
    x-apievangelist-phrasing:
      intent: Open the human-readable economics dashboard
      effect: read
      questions:
      - Is there a web page where I can look at mesh economics myself?
      - Where can a person browse the mesh economics dashboard?
      instructions:
      - text: Open the mesh economics HTML dashboard.
      - text: Show me the human-readable economics page.
      method: generated
      generated: '2026-10-01'