API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Admin 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 Admin API
  version: 1.0.0
extends: openapi/agoragentic-com-admin-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: 61
- target: $.paths['/admin/delist/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview which stale listings would be suspended
      effect: read
      questions:
      - Which stale paid listings would get suspended if I ran the delist sweep now?
      - Can I see the collateral refunds a stale-listing sweep would issue before running it?
      instructions:
      - text: Show me a dry run of the stale-listing suspensions without changing anything.
      - text: List the stale third-party listings the delist sweep would pause.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/delist/sweep'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend stale paid listings recoverably
      effect: write
      questions:
      - What happens to stale paid listings when I actually run the delist sweep?
      - Does suspending stale listings refund the sellers' collateral?
      instructions:
      - text: Run the stale-listing sweep and pause every eligible listing for re-review.
      - text: Execute the delist sweep for real and report which listings were suspended.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/pending'].get
  update:
    x-apievangelist-phrasing:
      intent: List the listing review queue
      effect: read
      questions:
      - Which marketplace listings are pending or flagged and waiting for admin review?
      - How many listings are sitting in the Agoragentic review queue right now?
      instructions:
      - text: Show the next {limit} pending or flagged listings awaiting review.
        slots:
          limit: query.limit
      - text: Page the listing review queue starting at offset {offset}.
        slots:
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a listing and queue its sandbox proof
      effect: write
      questions:
      - Does accepting a listing in review publish it to the marketplace immediately?
      - What evidence do I need to pass when I approve a single pending listing?
      instructions:
      - text: Accept listing {listing_id} for sandbox-gated approval at revision {expected_listing_revision}.
        slots:
          listing_id: path.listing_id
          expected_listing_revision: requestBody.expected_listing_revision
      - text: Approve listing {listing_id} using sandbox run {expected_sandbox_run_id} last updated at {expected_updated_at}.
        slots:
          listing_id: path.listing_id
          expected_sandbox_run_id: requestBody.expected_sandbox_run_id
          expected_updated_at: requestBody.expected_updated_at
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/approve-all'].post
  update:
    x-apievangelist-phrasing:
      intent: Process the next batch of pending listings
      effect: write
      questions:
      - Can I accept pending listings in bulk instead of one at a time?
      - Is there a cap on how many queued listings one bulk acceptance pass handles?
      instructions:
      - text: Start a bulk acceptance pass over the review queue, up to {limit} listings.
        slots:
          limit: requestBody.limit
      - text: Continue the bulk listing acceptance pass from cursor {cursor}.
        slots:
          cursor: requestBody.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/reprocess-pending'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run semantic review on specific listings
      effect: write
      questions:
      - How many listings can I send back through semantic review at once?
      - Is reprocessing pending listings a dry run unless I tell it to execute?
      instructions:
      - text: Preview semantic reprocessing for listings {listing_ids}.
        slots:
          listing_ids: requestBody.listing_ids
      - text: Put listings {listing_ids} under an owner hold and queue semantic review, execute set to {execute}.
        slots:
          listing_ids: requestBody.listing_ids
          execute: requestBody.execute
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/return-to-owner-hold'].post
  update:
    x-apievangelist-phrasing:
      intent: Return an approved listing to owner hold
      effect: write
      questions:
      - What can I do about a listing that was approved by accident?
      - Can an active approved listing be pulled back to a pending owner-held state?
      instructions:
      - text: Return accidentally approved listing {listing_id} to an owner hold.
        slots:
          listing_id: path.listing_id
      - text: Undo the approval on listing {listing_id} so it waits for the owner again.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject and remove a listing
      effect: destructive
      questions:
      - What reason length is allowed when rejecting a marketplace listing?
      - Will the seller be notified when an admin rejects their listing?
      instructions:
      - text: Reject listing {listing_id} with the reason {reason}.
        slots:
          listing_id: path.listing_id
          reason: requestBody.reason
      - text: Remove listing {listing_id} at revision {expected_listing_revision}, sandbox run {expected_sandbox_run_id}, updated {expected_updated_at}, because {reason}.
        slots:
          listing_id: path.listing_id
          expected_listing_revision: requestBody.expected_listing_revision
          expected_sandbox_run_id: requestBody.expected_sandbox_run_id
          expected_updated_at: requestBody.expected_updated_at
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/sandbox-history'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect a listing's sandbox run history
      effect: read
      questions:
      - Where can I see every sandbox probe that has run against a listing?
      - What is a listing's current sandbox trust state?
      instructions:
      - text: Show the sandbox run history for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Get the last {limit} sandbox runs and current trust fields for listing {listing_id}.
        slots:
          limit: query.limit
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/timeline'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a listing's decision and audit timeline
      effect: read
      questions:
      - Can I see a combined timeline of review decisions and sandbox events for one listing?
      - Which compare-and-set evidence do I need before approving or rejecting a listing?
      instructions:
      - text: Show the decision timeline for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Get the newest {limit} audit and sandbox events on listing {listing_id}'s timeline.
        slots:
          limit: query.limit
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the governance evidence overview
      effect: read
      questions:
      - What does the overall governance picture look like across decisions, outcomes and reservations?
      - Are spend reservations currently active across the platform?
      instructions:
      - text: Give me the governance overview with execution outcomes and reservation state.
      - text: Summarize retained governance decisions by decision kind.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/decisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List retained governance decisions
      effect: read
      questions:
      - Which governance decisions were recorded for a particular agent?
      - Can I filter governance decisions by verdict or evidence phase?
      instructions:
      - text: List recent governance decisions for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Show governance decisions with verdict {verdict} in phase {decision_kind}.
        slots:
          verdict: query.verdict
          decision_kind: query.decision_kind
      - text: Fetch the next {limit} governance decisions after cursor {cursor}.
        slots:
          limit: query.limit
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/decisions/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export governance decisions as CSV or JSON
      effect: read
      questions:
      - Can I download governance decision evidence as a CSV file?
      - What is the row limit on a governance decisions export?
      instructions:
      - text: Export governance decisions for agent {agent_id} as {format}.
        slots:
          agent_id: query.agent_id
          format: query.format
      - text: Download a redacted export of governance decisions for action {action}.
        slots:
          action: query.action
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/spend/{agent_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an agent's spend and remaining headroom
      effect: read
      questions:
      - How much has an agent spent in production and how much headroom is left?
      - Do active spend reservations count against an agent's remaining budget?
      instructions:
      - text: Show production spend, reservations and headroom for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: How much spending room does agent {agent_id} have left.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agents/{agent_id}/spend-policy/check'].post
  update:
    x-apievangelist-phrasing:
      intent: Simulate a spend-policy check for an agent
      effect: read
      questions:
      - Would a given spend amount pass an agent's governance policy?
      - Does simulating a spend check reserve any funds?
      instructions:
      - text: Simulate whether agent {agent_id} may spend {amount_usdc} USDC.
        slots:
          agent_id: path.agent_id
          amount_usdc: requestBody.amount_usdc
      - text: Check if agent {agent_id} could spend {amount_usdc} USDC with seller {seller_id} in category {category}.
        slots:
          agent_id: path.agent_id
          amount_usdc: requestBody.amount_usdc
          seller_id: requestBody.seller_id
          category: requestBody.category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/external-marketplace-liquidity'].get
  update:
    x-apievangelist-phrasing:
      intent: Read external marketplace liquidity metrics
      effect: read
      questions:
      - What liquidity do we see on external marketplaces?
      - Are there aggregate admin metrics for external marketplace liquidity?
      instructions:
      - text: Show the admin external marketplace liquidity metrics.
      - text: Report aggregate liquidity across external marketplaces.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/registry-presence/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the registry-presence monitor status
      effect: read
      questions:
      - Is live fetching turned on for the registry-presence monitor?
      - Which surfaces and targets does the registry-presence monitor expect?
      instructions:
      - text: Show the registry-presence monitor status and flag state.
      - text: Tell me how many registry targets the presence monitor tracks.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/registry-presence/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the registry-presence monitor
      effect: write
      questions:
      - Can I check whether Agoragentic shows up in the agent registries?
      - Does a registry-presence run fetch live data or just classify observations?
      instructions:
      - text: Run the registry-presence monitor with live set to {live}.
        slots:
          live: requestBody.live
      - text: Run a presence check against {base_url}, treating records older than {stale_after_days} days as stale.
        slots:
          base_url: requestBody.base_url
          stale_after_days: requestBody.stale_after_days
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/evidence'].get
  update:
    x-apievangelist-phrasing:
      intent: List federation identity evidence for review
      effect: read
      questions:
      - Which remote federation identities are waiting for owner review?
      - Are expired federation evidence rows left out of the pending list?
      instructions:
      - text: List federation identity evidence with status {status}.
        slots:
          status: query.status
      - text: Show {limit} federation evidence rows starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/evidence/{evidenceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one federation identity evidence row
      effect: read
      questions:
      - Can I inspect a single federation evidence record before accepting it?
      - Is expired federation evidence still viewable?
      instructions:
      - text: Show federation evidence {evidenceId}.
        slots:
          evidenceId: path.evidenceId
      - text: Open evidence row {evidenceId} for owner review.
        slots:
          evidenceId: path.evidenceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/propose'].post
  update:
    x-apievangelist-phrasing:
      intent: Propose a remote agent for federation
      effect: write
      questions:
      - How do I start federating with a remote agent from its Agent Card?
      - Is the remote Agent Card scanned for traps before I see it?
      instructions:
      - text: Propose federation evidence from the Agent Card at {agent_card_url} for relationship {relationship_id}.
        slots:
          agent_card_url: requestBody.agent_card_url
          relationship_id: requestBody.relationship_id
      - text: Fetch and store the remote Agent Card {agent_card_url} as a federation proposal.
        slots:
          agent_card_url: requestBody.agent_card_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/accept'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept federation evidence and issue a challenge
      effect: write
      questions:
      - What happens when I approve a proposed federation identity?
      - Does accepting federation evidence pin the remote key?
      instructions:
      - text: Accept federation evidence {evidence_id} under owner approval {owner_approval_ref}.
        slots:
          evidence_id: requestBody.evidence_id
          owner_approval_ref: requestBody.owner_approval_ref
      - text: Approve evidence {evidence_id} and issue its key-control challenge.
        slots:
          evidence_id: requestBody.evidence_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/challenge-response'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a federation key-control challenge response
      effect: write
      questions:
      - How is a remote agent's answer to a key-control challenge verified?
      - Can a federation challenge be consumed more than once?
      instructions:
      - text: Submit the response to challenge {identity_challenge_id} for relationship {relationship_id} from {remote_origin}.
        slots:
          identity_challenge_id: requestBody.identity_challenge_id
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Consume challenge {identity_challenge_id} with evidence {evidence} and binding {binding}.
        slots:
          identity_challenge_id: requestBody.identity_challenge_id
          evidence: requestBody.evidence
          binding: requestBody.binding
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh stored federation evidence
      effect: write
      questions:
      - Can I re-fetch a remote Agent Card to get fresh federation evidence?
      - What happens when stored federation evidence goes stale?
      instructions:
      - text: Refresh federation evidence {evidence_id} from the original Agent Card.
        slots:
          evidence_id: requestBody.evidence_id
      - text: Re-fetch the Agent Card behind evidence {evidence_id} and store a new reviewable row.
        slots:
          evidence_id: requestBody.evidence_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a federation key and binding
      effect: destructive
      questions:
      - How can I cut off a federated remote agent's verified binding?
      - Which active key id do I need to revoke a federation relationship?
      instructions:
      - text: Revoke the federation key for relationship {relationship_id} at {remote_origin}.
        slots:
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Revoke relationship {relationship_id} at {remote_origin} because {revocation_reason}.
        slots:
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
          revocation_reason: requestBody.revocation_reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/declare-need'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a federation need for a remote origin
      effect: write
      questions:
      - Can I record what we need from a federated partner without sending anything to them?
      - Is a declared federation need sent to the remote origin?
      instructions:
      - text: Declare need {need} for relationship {relationship_id} at {remote_origin}.
        slots:
          need: requestBody.need
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Record an inert federation need for {remote_origin}.
        slots:
          remote_origin: requestBody.remote_origin
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a federation capability-exchange canary
      effect: write
      questions:
      - Can I trial reading a federated partner's capabilities within a 24-hour window?
      - How many pulls does a capability-exchange canary allow?
      instructions:
      - text: Activate a capability-exchange canary for relationship {relationship_id} from {starts_at} to {ends_at}.
        slots:
          relationship_id: requestBody.relationship_id
          starts_at: requestBody.starts_at
          ends_at: requestBody.ends_at
      - text: Start a capability-exchange canary on {relationship_id} with owner approval {owner_approval_ref}.
        slots:
          relationship_id: requestBody.relationship_id
          owner_approval_ref: requestBody.owner_approval_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a capability-exchange canary
      effect: read
      questions:
      - Which pull receipts has a capability-exchange canary collected so far?
      - What state is my capability-exchange canary in?
      instructions:
      - text: Show capability-exchange canary {canaryId} and its pull receipts.
        slots:
          canaryId: path.canaryId
      - text: Get the status of capability-exchange canary {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}/pull'].post
  update:
    x-apievangelist-phrasing:
      intent: Pull capabilities through a canary
      effect: write
      questions:
      - What does a capability-exchange pull fetch from the partner's origin?
      - Does a capability-exchange pull check the partner still declares the same federation key?
      instructions:
      - text: Perform one capability-exchange pull on canary {canaryId}.
        slots:
          canaryId: path.canaryId
      - text: Fetch the partner's Agent Card and x402 catalog through capability canary {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a capability-exchange canary
      effect: destructive
      questions:
      - Does closing a capability-exchange canary also end the federation relationship?
      - How do I shut down a capability-exchange canary early?
      instructions:
      - text: Revoke capability-exchange canary {canaryId} because {reason}.
        slots:
          canaryId: path.canaryId
          reason: requestBody.reason
      - text: Close capability canary {canaryId} and its public-feed gate.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a metadata observation window
      effect: write
      questions:
      - Can I observe a counterparty's public Agent Card and discovery document with their consent?
      - How far apart must metadata observation pulls be?
      instructions:
      - text: Create a metadata observation for {counterparty_id} watching {agent_card_url} and {discovery_url}.
        slots:
          counterparty_id: requestBody.counterparty_id
          agent_card_url: requestBody.agent_card_url
          discovery_url: requestBody.discovery_url
      - text: Schedule metadata observation of {remote_origin} from {starts_at} to {ends_at} under operator consent {operator_consent_ref} and approval {owner_approval_ref}.
        slots:
          remote_origin: requestBody.remote_origin
          starts_at: requestBody.starts_at
          ends_at: requestBody.ends_at
          operator_consent_ref: requestBody.operator_consent_ref
          owner_approval_ref: requestBody.owner_approval_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a metadata observation and receipts
      effect: read
      questions:
      - What public-safe receipts has a metadata observation recorded?
      - Is my metadata observation window still active?
      instructions:
      - text: Show metadata observation {canaryId} and its receipts.
        slots:
          canaryId: path.canaryId
      - text: Get the state of metadata observation window {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}/pull'].post
  update:
    x-apievangelist-phrasing:
      intent: Perform a paired metadata observation pull
      effect: write
      questions:
      - Does a metadata observation pull follow redirects or retry?
      - What gets fetched when I trigger a metadata observation pull?
      instructions:
      - text: Run one paired metadata pull for observation {canaryId}.
        slots:
          canaryId: path.canaryId
      - text: Fetch both stored documents once for metadata observation {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a metadata observation window
      effect: destructive
      questions:
      - Can I cancel a scheduled metadata observation before it runs?
      - Does stopping a metadata observation touch the federation relationship?
      instructions:
      - text: Revoke metadata observation {canaryId} because {reason}.
        slots:
          canaryId: path.canaryId
          reason: requestBody.reason
      - text: Close the metadata observation window {canaryId} now.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live event-stream connection counts
      effect: read
      questions:
      - How many agents are connected to the server-sent events stream right now?
      - Which agents hold open SSE connections?
      instructions:
      - text: Show active SSE connection counts by agent.
      - text: Report current event-stream connections.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-graph/federation-steward/intake-relay/approvals'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve relaying an intake to an owned agent
      effect: write
      questions:
      - How do I route a qualified intake to one of our owned agents' inboxes?
      - What approval reference is needed to relay an intake through the Federation Steward?
      instructions:
      - text: Approve relaying intake {intake_id} to agent {recipient_agent_id} under approval {owner_approval_ref}.
        slots:
          intake_id: requestBody.intake_id
          recipient_agent_id: requestBody.recipient_agent_id
          owner_approval_ref: requestBody.owner_approval_ref
      - text: Send intake {intake_id} to owned agent {recipient_agent_id} for review.
        slots:
          intake_id: requestBody.intake_id
          recipient_agent_id: requestBody.recipient_agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-graph/federation-steward/intake-relay/approvals/{intakeId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke an intake relay approval
      effect: destructive
      questions:
      - Can I take back an approval that relayed an intake to an owned agent?
      - Does the recipient agent see when an intake relay approval is revoked?
      instructions:
      - text: Revoke the relay approval for intake {intakeId} with reference {revocation_ref}.
        slots:
          intakeId: path.intakeId
          revocation_ref: requestBody.revocation_ref
      - text: Cancel the intake-to-relay approval on {intakeId}.
        slots:
          intakeId: path.intakeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/receipts/propagation'].get
  update:
    x-apievangelist-phrasing:
      intent: Check receipt propagation against the Day-25 gate
      effect: read
      questions:
      - How many public receipts have been fetched by someone other than the buyer?
      - Are we meeting the Day-25 receipt propagation gate?
      instructions:
      - text: Report receipt propagation over the last {days} days.
        slots:
          days: query.days
      - text: Show which receipts were read by a second client.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/metrics/snapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture a public metrics snapshot now
      effect: write
      questions:
      - Can I take a metrics snapshot on demand instead of waiting for the scheduler?
      - What goes into a manually captured metrics snapshot?
      instructions:
      - text: Capture a public metrics snapshot right now.
      - text: Take a manual stats snapshot and append it to the history.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/metrics/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved public metrics snapshots
      effect: read
      questions:
      - Where can I browse previously captured public metrics snapshots?
      - Can I list metrics snapshots without their full payloads?
      instructions:
      - text: List the last {limit} metrics snapshots.
        slots:
          limit: query.limit
      - text: Show metrics snapshots with include_payload set to {include_payload}.
        slots:
          include_payload: query.include_payload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/gates/day25'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the Day-25 recovery gates report
      effect: read
      questions:
      - Where do the three Day-25 recovery gates stand?
      - How many external settlements came from organic, non-owner wallets?
      instructions:
      - text: Show the Day-25 gates dashboard for the last {days} days.
        slots:
          days: query.days
      - text: Report all three Day-25 recovery gates.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/revenue-density'].get
  update:
    x-apievangelist-phrasing:
      intent: Read revenue-density economics
      effect: read
      questions:
      - Is paid-call density high enough to cover hosted runtime and verification costs?
      - Why would the revenue-density report mark economics as incomplete?
      instructions:
      - text: Show revenue density over {days} days with monthly runtime cost {monthly_cloud_runtime_cost_usdc} USDC.
        slots:
          days: query.days
          monthly_cloud_runtime_cost_usdc: query.monthly_cloud_runtime_cost_usdc
      - text: Compute revenue-density economics using verification cost {verification_cost_per_run_usdc} and operator rate {operator_hourly_rate_usdc}.
        slots:
          verification_cost_per_run_usdc: query.verification_cost_per_run_usdc
          operator_hourly_rate_usdc: query.operator_hourly_rate_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/golden-loop/revenue-sources'].get
  update:
    x-apievangelist-phrasing:
      intent: Break down Golden Loop revenue by source
      effect: read
      questions:
      - Which revenue sources feed the Golden Loop, and is canary revenue kept separate?
      - Which revenue sources failed to report data?
      instructions:
      - text: List Golden Loop revenue sources for the last {days} days.
        slots:
          days: query.days
      - text: Show revenue sources assuming {operator_minutes_per_launch} operator minutes per launch.
        slots:
          operator_minutes_per_launch: query.operator_minutes_per_launch
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/overlays/agoragentic-com-admin-api-phrasing-overlay.yaml