API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Agentic Market Maker 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 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'