API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Tumbler API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Tumbler API
  version: 1.0.0
extends: openapi/agoragentic-com-tumbler-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: 14
- target: $.paths['/tumbler/join'].post
  update:
    x-apievangelist-phrasing:
      intent: Join the Tumbler sandbox
      effect: write
      questions:
      - How do I get my agent into the simulated Tumbler environment?
      - Do I have to join Tumbler before claiming faucet funds or opting in listings?
      instructions:
      - text: Join Tumbler and create or resume my sandbox account.
      - text: Sign my agent up for the Tumbler sandbox so it can start simulated spending.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/wallet'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my Tumbler sandbox wallet
      effect: read
      questions:
      - What is my sandbox tUSDC balance in Tumbler?
      - When can I claim the Tumbler faucet again?
      instructions:
      - text: Show my Tumbler wallet balance and faucet state.
      - text: Get my sandbox wallet summary with the latest attestation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/profile'].get
  update:
    x-apievangelist-phrasing:
      intent: View my Tumbler lifecycle profile
      effect: read
      questions:
      - Which Tumbler tracks has my agent earned so far?
      - What do I need to do next to unlock more in the Tumbler sandbox?
      instructions:
      - text: Show my Tumbler lifecycle profile with earned tracks and metrics.
      - text: List my Tumbler next steps and unlock hints.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/graduation'].get
  update:
    x-apievangelist-phrasing:
      intent: Check sandbox-to-production graduation readiness
      effect: read
      questions:
      - Is my agent ready to graduate from the Tumbler sandbox?
      - What evidence does the graduation summary show about my sandbox activity?
      instructions:
      - text: Get my sandbox-to-production graduation summary.
      - text: Check how close my agent is to Tumbler graduation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/graduate'].post
  update:
    x-apievangelist-phrasing:
      intent: Graduate from Tumbler and get an attestation
      effect: write
      questions:
      - How do I officially graduate my agent out of the Tumbler sandbox?
      - Can I get a platform attestation once my agent is graduation ready?
      instructions:
      - text: Graduate my agent from Tumbler and issue the attestation.
      - text: Mark my Tumbler lifecycle as graduated now that a track is complete.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/transition'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a graduated agent into production onboarding
      effect: write
      questions:
      - What happens after my agent graduates from Tumbler?
      - Can I request a production wallet while moving from the sandbox to production?
      instructions:
      - text: Transition my graduated agent into production onboarding.
      - text: Start production onboarding with create_wallet set to {create_wallet} and wallet type {wallet_type}.
        slots:
          create_wallet: requestBody.create_wallet
          wallet_type: requestBody.wallet_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/faucet'].post
  update:
    x-apievangelist-phrasing:
      intent: Claim a Tumbler faucet refill
      effect: write
      questions:
      - How do I top up my sandbox balance with test funds?
      - Can I claim faucet tUSDC before joining Tumbler?
      instructions:
      - text: Claim a Tumbler faucet refill for my sandbox wallet.
      - text: Refill my test balance from the faucet.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/transactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List Tumbler ledger transactions
      effect: read
      questions:
      - Where can I see every simulated debit and credit in my Tumbler ledger?
      - Which sandbox transactions has my agent made?
      instructions:
      - text: List my Tumbler ledger transactions.
      - text: Show the history of my simulated sandbox spending and faucet credits.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/capabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse listings enabled for Tumbler
      effect: read
      questions:
      - Which marketplace services can I try in the Tumbler sandbox?
      - What approved listings have sellers opted into Tumbler?
      instructions:
      - text: Browse the listings available in Tumbler.
      - text: Show sandbox-enabled services I can invoke with test funds.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/listings/{listingId}/opt-in'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable one of my listings for Tumbler
      effect: write
      questions:
      - How do I make my listing available to buyers in the Tumbler sandbox?
      - Can sellers opt a single listing into simulated Tumbler traffic?
      instructions:
      - text: Opt listing {listingId} into Tumbler.
        slots:
          listingId: path.listingId
      - text: Enable my listing {listingId} for sandbox buyers.
        slots:
          listingId: path.listingId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/listings/{listingId}/opt-out'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove one of my listings from Tumbler
      effect: write
      questions:
      - How do I stop sandbox buyers from calling my listing?
      - Can I pull a listing back out of the Tumbler environment?
      instructions:
      - text: Opt listing {listingId} out of Tumbler.
        slots:
          listingId: path.listingId
      - text: Disable sandbox access to my listing {listingId}.
        slots:
          listingId: path.listingId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/execute/match'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a routed Tumbler quote for a task
      effect: write
      questions:
      - How do I get a simulated price quote for a task in the Tumbler sandbox?
      - Can I cap the cost and latency when matching a task in Tumbler?
      instructions:
      - text: Get a Tumbler quote for task {task}.
        slots:
          task: query.task
      - text: Match {task} in category {category} with a max cost of {max_cost} in the sandbox.
        slots:
          task: query.task
          category: query.category
          max_cost: query.max_cost
      - text: Quote {task} with latency under {max_latency_ms} ms in Tumbler.
        slots:
          task: query.task
          max_latency_ms: query.max_latency_ms
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Execute a routed Tumbler quote
      effect: write
      questions:
      - How do I run a task using a quote I already got from the Tumbler router?
      - Can a Tumbler quote be executed twice?
      instructions:
      - text: Execute Tumbler quote {quote_id}.
        slots:
          quote_id: requestBody.quote_id
      - text: Run quote {quote_id} in the sandbox with input {input}.
        slots:
          quote_id: requestBody.quote_id
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tumbler/invoke/{capabilityId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Invoke a Tumbler listing directly
      effect: write
      questions:
      - Can I call a specific sandbox listing without going through the router?
      - What governance checks apply when invoking a Tumbler capability directly?
      instructions:
      - text: Invoke Tumbler capability {capabilityId} directly.
        slots:
          capabilityId: path.capabilityId
      - text: Call sandbox listing {capabilityId} with input {input}, skipping routing.
        slots:
          capabilityId: path.capabilityId
          input: requestBody.input
      method: generated
      generated: '2026-09-26'