# 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'