# 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 Agent OS Market Intelligence API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-market-intelligence-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: 19
- target: $.paths['/agent-os/market-intel/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List market-intelligence runs
      effect: read
      questions:
      - Which market-intelligence runs have I started for my deployments?
      - Can I filter market-intel runs by status to see what still needs my decision?
      instructions:
      - text: List my market-intelligence runs for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show up to {limit} market-intel runs with status {status}.
        slots:
          limit: query.limit
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a market-intelligence run
      effect: write
      questions:
      - How do I have Agent OS research demand and draft listings for my deployment?
      - Can I feed my own candidate capabilities or external signals into a market-intel run?
      instructions:
      - text: Start a market-intelligence run for deployment {deployment_id}.
        slots:
          deployment_id: requestBody.deployment_id
      - text: Run market intelligence on deployment {deployment_id} with the goal {goal}.
        slots:
          deployment_id: requestBody.deployment_id
          goal: requestBody.goal
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/runs/{run_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one market-intelligence run
      effect: read
      questions:
      - How do I see the artifacts a specific market-intel run generated?
      - What did one particular market-intelligence run produce?
      instructions:
      - text: Show market-intelligence run {run_id} and its artifacts.
        slots:
          run_id: path.run_id
      - text: Open run {run_id} from market intel.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/dashboard'].get
  update:
    x-apievangelist-phrasing:
      intent: View the market-intelligence dashboard
      effect: read
      questions:
      - Is there one dashboard view of opportunities, drafts and pending approvals?
      - What's the next step I'm allowed to take on my market-intel work?
      instructions:
      - text: Show the market-intel dashboard for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Give me the dashboard aggregate for run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/demand'].get
  update:
    x-apievangelist-phrasing:
      intent: List demand clusters
      effect: read
      questions:
      - What demand is there for what my deployment could sell?
      - Can I see repeat buyers and paid-call counts behind each demand cluster?
      instructions:
      - text: List demand clusters for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the demand clusters found in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/opportunities'].get
  update:
    x-apievangelist-phrasing:
      intent: List matched value opportunities
      effect: read
      questions:
      - Where does demand line up with capabilities I have and a price that works?
      - Which value opportunities did market intel find for my agent?
      instructions:
      - text: List value opportunities for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the opportunities matched in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/capability-inventory'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovered capability assets
      effect: read
      questions:
      - What capabilities did market intel discover my deployment already has?
      - Can I see the capability inventory built during a run?
      instructions:
      - text: Show the capability inventory for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: List capability assets discovered in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts'].get
  update:
    x-apievangelist-phrasing:
      intent: List generated listing drafts
      effect: read
      questions:
      - Which marketplace listing drafts has market intel written for me?
      - Can I see all listing drafts from one run?
      instructions:
      - text: List listing drafts for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the listing drafts generated by run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts/{draft_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one listing draft
      effect: read
      questions:
      - How do I review the full contents of one generated listing draft?
      - What status is a particular listing draft in?
      instructions:
      - text: Show listing draft {draft_id}.
        slots:
          draft_id: path.draft_id
      - text: Open generated draft {draft_id} so I can review it.
        slots:
          draft_id: path.draft_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts/{draft_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a listing draft as owner
      effect: write
      questions:
      - How do I sign off on a generated listing draft so it can move forward?
      - Does approving a listing draft publish it to the marketplace?
      instructions:
      - text: Approve listing draft {draft_id}.
        slots:
          draft_id: path.draft_id
      - text: Give owner approval to draft {draft_id} for the next Seller OS step.
        slots:
          draft_id: path.draft_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts/{draft_id}/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark an approved draft ready to publish
      effect: write
      questions:
      - How do I get the Seller OS publish payload for a draft I already approved?
      - What gates still stand between a publish-ready draft and a public listing?
      instructions:
      - text: Prepare approved draft {draft_id} for Seller OS publication.
        slots:
          draft_id: path.draft_id
      - text: Mark draft {draft_id} publish-ready and give me the handoff payload.
        slots:
          draft_id: path.draft_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts/{draft_id}/canary'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a no-spend canary on a listing draft
      effect: write
      questions:
      - How do I prove an approved listing draft actually works before it goes public?
      - Does the canary test on a draft spend any money?
      instructions:
      - text: Run a canary test on listing draft {draft_id}.
        slots:
          draft_id: path.draft_id
      - text: Validate the schemas of draft {draft_id} with a no-spend canary.
        slots:
          draft_id: path.draft_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/canaries'].get
  update:
    x-apievangelist-phrasing:
      intent: List canary proof records
      effect: read
      questions:
      - Which canary proofs have been recorded for my deployment?
      - Can I see every canary that passed or failed in one run?
      instructions:
      - text: List canary proof records for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the canaries recorded in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/canaries/{canary_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one canary proof record
      effect: read
      questions:
      - How do I inspect the details of a single canary proof?
      - Why did one specific canary pass or fail?
      instructions:
      - text: Show canary proof {canary_id}.
        slots:
          canary_id: path.canary_id
      - text: Open the canary record {canary_id} and its receipt metadata.
        slots:
          canary_id: path.canary_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/listing-drafts/{draft_id}/seller-os/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a draft's Seller OS execution handoff
      effect: write
      questions:
      - After a canary passes, how do I check a draft is ready for a public listing?
      - Does the Seller OS handoff check verify seller slot and stake readiness?
      instructions:
      - text: Validate the Seller OS handoff for canary-proven draft {draft_id}.
        slots:
          draft_id: path.draft_id
      - text: Check whether draft {draft_id} is public-listing ready in Seller OS.
        slots:
          draft_id: path.draft_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/buy-recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: List generated buy recommendations
      effect: read
      questions:
      - What capabilities does market intel recommend my agent buy?
      - Can I see the buy recommendations from a single run?
      instructions:
      - text: List buy recommendations for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the buy recommendations generated in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/buy-recommendations/{id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a buy recommendation
      effect: write
      questions:
      - How do I accept one of the purchase suggestions market intel made?
      - Will approving a buy recommendation spend funds automatically?
      instructions:
      - text: Approve buy recommendation {id}.
        slots:
          id: path.id
      - text: Record my owner approval on purchase suggestion {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/value-assessments'].get
  update:
    x-apievangelist-phrasing:
      intent: List value, price and margin assessments
      effect: read
      questions:
      - What price and margin does market intel suggest for my capabilities?
      - Are value assessments informed by real receipt history?
      instructions:
      - text: Show value and margin assessments for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: List the pricing assessments produced by run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/market-intel/market-signals'].get
  update:
    x-apievangelist-phrasing:
      intent: List normalized market signals
      effect: read
      questions:
      - Which raw market signals fed into my market-intelligence analysis?
      - Can I see the normalized signals collected for one run?
      instructions:
      - text: List market signals for deployment {deployment_id}.
        slots:
          deployment_id: query.deployment_id
      - text: Show the normalized signals gathered in run {run_id}.
        slots:
          run_id: query.run_id
      method: generated
      generated: '2026-09-26'