# 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 Agentic Market Maker API version: 1.0.0 extends: openapi/agoragentic-com-agentic-market-maker-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: 13 - target: $.paths['/agent-os/market-maker/runs'].post update: x-apievangelist-phrasing: intent: Run a market-making analysis for a deployment effect: write questions: - How do I have Market Maker find demand and draft listings for my deployed agent? - Can I run a preview-only market-making plan without supplying runtime proof? - Does a market-making run publish listings or spend money? instructions: - text: Start a market-making run for deployment {deployment_id}. slots: deployment_id: requestBody.deployment_id - text: Run market-making analysis for {deployment_id} with the goal {goal}. slots: deployment_id: requestBody.deployment_id goal: requestBody.goal - text: Do a preview-only market-making plan for deployment {deployment_id}. slots: deployment_id: requestBody.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/runs/{run_id}'].get update: x-apievangelist-phrasing: intent: Read one market-making run effect: read questions: - What did a specific market-making run produce? - Where can I review the proposals from an earlier Market Maker run? instructions: - text: Show market-making run {run_id}. slots: run_id: path.run_id - text: Get the results of Market Maker run {run_id}. slots: run_id: path.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/dashboard'].get update: x-apievangelist-phrasing: intent: View the Market Maker dashboard effect: read questions: - How many demand signals, opportunities and drafts does Market Maker have for me? - Which owner decisions are pending in Market Maker? - What first-party seed services does the dashboard suggest? instructions: - text: Show the Market Maker dashboard for deployment {deployment_id}. slots: deployment_id: query.deployment_id - text: Get dashboard counts and growth metrics for run {run_id}. slots: run_id: query.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/demand'].get update: x-apievangelist-phrasing: intent: List demand clusters found by Market Maker effect: read questions: - What demand clusters has Market Maker spotted for my deployment? - Can I see the demand groupings from a single run? instructions: - text: List demand clusters for deployment {deployment_id}. slots: deployment_id: query.deployment_id - text: Show the demand clusters from market-making run {run_id}. slots: run_id: query.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/opportunities'].get update: x-apievangelist-phrasing: intent: List market opportunities for a deployment effect: read questions: - Where do demand, my capabilities and value line up into opportunities? - Which opportunities did a market-making run identify? instructions: - text: List opportunities for deployment {deployment_id}. slots: deployment_id: query.deployment_id - text: Show the value opportunities found in run {run_id}. slots: run_id: query.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/listing-drafts'].get update: x-apievangelist-phrasing: intent: List Market Maker listing drafts effect: read questions: - What listing drafts has Market Maker written for my agent? - Can I see trust and canary status alongside each listing draft? instructions: - text: List listing drafts for deployment {deployment_id}. slots: deployment_id: query.deployment_id - text: Show the listing drafts and their canary state from run {run_id}. slots: run_id: query.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/listing-drafts/{id}/approve'].post update: x-apievangelist-phrasing: intent: Approve a listing draft as the owner effect: write questions: - How do I give owner approval to a Market Maker listing draft? - Does approving a draft make the listing public? instructions: - text: Approve listing draft {id}. slots: id: path.id - text: Record my owner approval on draft {id} for Seller OS handoff. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/listing-drafts/{id}/publish'].post update: x-apievangelist-phrasing: intent: Mark an approved draft ready to publish effect: write questions: - How do I move an approved listing draft to publish-ready? - What still has to happen before a publish-ready draft becomes a real listing? instructions: - text: Mark approved draft {id} as publish ready. slots: id: path.id - text: Prepare the Seller OS publication payload for draft {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/listing-drafts/{id}/canary'].post update: x-apievangelist-phrasing: intent: Run a canary proof on a listing draft effect: write questions: - How do I prove a listing draft works before publishing it? - Will a draft canary spend any money? instructions: - text: Run the internal canary on listing draft {id}. slots: id: path.id - text: Create a no-spend canary proof record for draft {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/canaries'].get update: x-apievangelist-phrasing: intent: List canary proofs and canary plans effect: read questions: - Which canary proofs have passed or failed for my deployment? - Can I see the no-spend canary plans for a run? instructions: - text: List canary proof records for deployment {deployment_id}. slots: deployment_id: query.deployment_id - text: Show the canary plans from run {run_id}. slots: run_id: query.run_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/canaries/{listing_id}/run'].post update: x-apievangelist-phrasing: intent: Run the canary path for a listing by listing ID effect: write questions: - Can I trigger a canary from the canaries route using a listing ID? - What comes back if I run a canary for a listing ID Market Maker doesn't know? instructions: - text: Run the canary proof path for listing {listing_id}. slots: listing_id: path.listing_id - text: Kick off a canary run keyed on listing ID {listing_id}. slots: listing_id: path.listing_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/canaries/{canary_id}'].get update: x-apievangelist-phrasing: intent: Read one canary proof record effect: read questions: - What were the results of a particular canary proof? - Where do I look up a single canary record by its ID? instructions: - text: Show canary proof {canary_id}. slots: canary_id: path.canary_id - text: Get the durable canary record {canary_id}. slots: canary_id: path.canary_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/market-maker/listing-drafts/{id}/seller-os/execute'].post update: x-apievangelist-phrasing: intent: Validate a draft's Seller OS handoff effect: write questions: - What checks does a listing draft need to pass before Seller OS takes it? - Do I need a seller slot and stake ready before the Seller OS handoff? instructions: - text: Validate the Seller OS handoff for canary-passed draft {id}. slots: id: path.id - text: Execute the Seller OS validation step on draft {id}. slots: id: path.id method: generated generated: '2026-09-26'