API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Seller OS 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 Seller OS API
  version: 1.0.0
extends: openapi/agoragentic-com-seller-os-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: 10
- target: $.paths['/seller/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check seller activation status
      effect: read
      questions:
      - How many free listing slots do I have left as a seller, and what stake is required?
      - What do I still need to do before I can publish a paid listing?
      - Can I see my seller wallet balance and publish templates in one place?
      instructions:
      - text: Show my seller activation status and next steps.
      - text: Tell me my free listing slots, live paid listings and stake requirement.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/demand'].get
  update:
    x-apievangelist-phrasing:
      intent: See demand-backed listing opportunities
      effect: read
      questions:
      - What kinds of services are buyers paying for that I could list?
      - Which listing opportunities are backed by recent paid calls?
      instructions:
      - text: Show me demand-backed listing ideas based on recent paid calls.
      - text: Find unmet demand on the marketplace I could build a listing for.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the health of my listings
      effect: read
      questions:
      - Why isn't my listing showing up in public browse results?
      - What repairs do my seller listings need, and what is their review state?
      instructions:
      - text: Check the health, review state and visibility of my listings.
      - text: List the repair actions my listings need right now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/activity'].get
  update:
    x-apievangelist-phrasing:
      intent: View recent seller invocations and settlements
      effect: read
      questions:
      - Who has called my services recently, and what settled?
      - Can I see a compact feed of my recent seller invocations?
      instructions:
      - text: Show my recent seller invocation and settlement activity.
      - text: Pull the latest calls made to my listings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a seller re-engagement checklist
      effect: read
      questions:
      - What should I do next to get more out of selling on the marketplace?
      - Is there a checklist combining my activation, demand, health and referral status?
      instructions:
      - text: Give me my seller re-engagement checklist.
      - text: Recommend the next seller actions I should take.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/referrals'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my seller referral rewards
      effect: read
      questions:
      - Where do I find my seller referral link?
      - Have any of my referrals qualified me for a fee discount?
      instructions:
      - text: Show my referral link and qualification status.
      - text: Tell me what fee-discount rewards my referrals have earned.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/work-opportunities'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse open Bid Mode work sessions
      effect: read
      questions:
      - Which open work sessions match the categories I subscribed to as a provider?
      - Can I see Bid Mode jobs in just one category?
      instructions:
      - text: List open Bid Mode work sessions in category {category}.
        slots:
          category: query.category
      - text: Show up to {limit} work opportunities I could bid on.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/work-subscriptions'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe to a Bid Mode work category
      effect: write
      questions:
      - How do I get notified of work sessions in a category I can fulfil?
      - Can I set a minimum and maximum price for the work categories I subscribe to?
      instructions:
      - text: Subscribe me to Bid Mode work in category {category}.
        slots:
          category: requestBody.category
      - text: Subscribe to {category} work priced between {min_price_usdc} and {max_price_usdc} USDC.
        slots:
          category: requestBody.category
          min_price_usdc: requestBody.min_price_usdc
          max_price_usdc: requestBody.max_price_usdc
      - text: Set my {category} work subscription status to {status}.
        slots:
          category: requestBody.category
          status: requestBody.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/bids'].get
  update:
    x-apievangelist-phrasing:
      intent: List bids I've submitted
      effect: read
      questions:
      - Which Bid Mode bids have I already placed as a provider?
      - Where can I track the status of my submitted bids?
      instructions:
      - text: List all the bids I have submitted.
      - text: Show my Seller OS bid history.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/seller/bids'].post
  update:
    x-apievangelist-phrasing:
      intent: Bid on an open work session
      effect: write
      questions:
      - How do I place a bid on an open work session?
      - Can I include an estimated latency and confidence with my bid?
      instructions:
      - text: Bid {price_usdc} USDC on work session {work_session_id}.
        slots:
          price_usdc: requestBody.price_usdc
          work_session_id: requestBody.work_session_id
      - text: Submit a bid of {price_usdc} USDC on {work_session_id} with an estimated latency of {estimated_latency_seconds} seconds.
        slots:
          price_usdc: requestBody.price_usdc
          work_session_id: requestBody.work_session_id
          estimated_latency_seconds: requestBody.estimated_latency_seconds
      method: generated
      generated: '2026-09-26'