# 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 Owner Control API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-owner-control-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: 60
- target: $.paths['/agent-os/blackbox-local-agents/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read Blackbox local-agent preview metadata
      effect: read
      questions:
      - Which harness kinds and workspace modes does the Blackbox local-agent preview accept?
      - What schemas can I submit to the Blackbox Local Agent Control Plane preview?
      instructions:
      - text: Show the Blackbox local-agent preview metadata.
      - text: List the accepted Blackbox harness kinds and workspace modes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/blackbox-local-agents/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a Blackbox local-agent run packet
      effect: read
      questions:
      - Can I review a local agent run's blockers and replay timeline before approving it?
      - What evidence summary does a Blackbox local-agent packet preview give me?
      instructions:
      - text: Preview the Blackbox packet for local-agent run {run_id}.
        slots:
          run_id: requestBody.run_id
      - text: Normalize Blackbox events {events} for run {run_id} in workspace {workspace_id}.
        slots:
          events: requestBody.events
          run_id: requestBody.run_id
          workspace_id: requestBody.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/memory-guarded-context/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read Memory Guarded Context preview metadata
      effect: read
      questions:
      - Which memory classifications and target visibilities does the guarded context preview support?
      - What does the Memory Guarded Context Fabric preview route accept?
      instructions:
      - text: Show the Memory Guarded Context preview metadata.
      - text: List supported memory classifications for guarded context previews.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/memory-guarded-context/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a guarded memory context packet
      effect: read
      questions:
      - Which of my memory records would be eligible or blocked from an agent's context?
      - Can I see the injection policy and provenance for memory before it's used?
      instructions:
      - text: Preview guarded memory packet {packet_id} with records {records}.
        slots:
          packet_id: requestBody.packet_id
          records: requestBody.records
      - text: Check which memory records are eligible for {target_visibility} visibility on deployment {deployment_id}.
        slots:
          target_visibility: requestBody.target_visibility
          deployment_id: requestBody.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/marketplace-capability-scaffolds/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read capability scaffold factory metadata
      effect: read
      questions:
      - What capability classes and categories does the Marketplace Capability Scaffold Factory support?
      - Which schemas does the capability scaffold preview accept?
      instructions:
      - text: Show the Marketplace Capability Scaffold Factory preview metadata.
      - text: List the capability classes and category map for scaffolds.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/marketplace-capability-scaffolds/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a draft capability scaffold plan
      effect: read
      questions:
      - Can I get a risk card and evidence checklist for a new marketplace capability idea?
      - What would a draft-only Seller OS handoff look like for a capability I'm planning?
      instructions:
      - text: Preview a capability scaffold named {name} in category {category}.
        slots:
          name: requestBody.name
          category: requestBody.category
      - text: Draft a scaffold plan for capability class {capability_class} using sources {source_urls}.
        slots:
          capability_class: requestBody.capability_class
          source_urls: requestBody.source_urls
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/research-finance-work-packs/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read research and finance work-pack metadata
      effect: read
      questions:
      - What kinds of research and finance work packs can be previewed?
      - Does the finance work-pack preview ever call a live brokerage?
      instructions:
      - text: Show the research and finance work-pack preview metadata.
      - text: List the supported finance work-pack kinds.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/research-finance-work-packs/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a research-only finance work pack
      effect: read
      questions:
      - Can I review the citations and compliance gates on a finance research pack?
      - Will a finance work pack preview place any orders or give personalized advice?
      instructions:
      - text: Preview finance work pack {pack_id} of kind {pack_kind}.
        slots:
          pack_id: requestBody.pack_id
          pack_kind: requestBody.pack_kind
      - text: Build a research-only pack titled {title} citing {citation_refs} in data mode {data_mode}.
        slots:
          title: requestBody.title
          citation_refs: requestBody.citation_refs
          data_mode: requestBody.data_mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/ecf-evaluation-lab/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read ECF Evaluation Lab preview metadata
      effect: read
      questions:
      - What advisory dimensions and evidence methods does the ECF Evaluation Lab use?
      - Which route-phase evidence does the evaluation lab preview require?
      instructions:
      - text: Show the ECF Evaluation Lab preview metadata.
      - text: List the evaluation lab's advisory dimensions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/ecf-evaluation-lab/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview an advisory ECF evaluation packet
      effect: read
      questions:
      - Can I see a scorecard, trap scan and dependency review for an agent before production?
      - Does an ECF evaluation preview grant a public badge or certification?
      instructions:
      - text: Preview an ECF evaluation for subject {subject_ref} of type {subject_type}.
        slots:
          subject_ref: requestBody.subject_ref
          subject_type: requestBody.subject_type
      - text: Run an advisory evaluation lab packet for run {run_id} with dependency findings {dependency_findings}.
        slots:
          run_id: requestBody.run_id
          dependency_findings: requestBody.dependency_findings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/revenue-share-nfts/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read revenue-share NFT preview metadata
      effect: read
      questions:
      - What revenue-share NFT artifact types can be previewed?
      - Does the revenue-share NFT preview route list its supported actions?
      instructions:
      - text: Show the revenue-share NFT preview metadata.
      - text: List the supported revenue-share NFT artifact types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/revenue-share-nfts/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a revenue-share NFT review packet
      effect: read
      questions:
      - Can I preview how a revenue-share class and holder claims would look without minting?
      - What does a distribution pool preview for revenue-share NFTs show?
      instructions:
      - text: Build a revenue-share NFT preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview a revenue-share NFT suite of artifacts {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/agent-daos/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read Agent DAO preview metadata
      effect: read
      questions:
      - What Agent DAO governance artifacts can be previewed?
      - Which actions does the Agent DAO preview route support?
      instructions:
      - text: Show the Agent DAO preview metadata.
      - text: List supported Agent DAO artifact types like proposals and vote receipts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/agent-daos/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build an Agent DAO governance evidence packet
      effect: read
      questions:
      - Can I preview a DAO proposal and vote result for my agent collective without executing it?
      - Will an Agent DAO preview move funds or change policy?
      instructions:
      - text: Build an Agent DAO preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview a DAO governance evidence suite {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/compute-credits/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read compute-credit token preview metadata
      effect: read
      questions:
      - What compute-credit artifacts like grants and usage meters can be previewed?
      - Which compute-credit token actions does the preview route describe?
      instructions:
      - text: Show the compute-credit preview metadata.
      - text: List the supported compute-credit artifact types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/compute-credits/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a compute-credit review packet
      effect: read
      questions:
      - Can I preview how compute credits would map to my budget envelopes?
      - Does a compute-credit preview mint tokens or create a ledger?
      instructions:
      - text: Build a compute-credit preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview compute-credit grant and usage artifacts {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/reputation-badges/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read soulbound reputation badge preview metadata
      effect: read
      questions:
      - What soulbound reputation badge artifacts can be previewed?
      - Does the badge preview route cover revocation previews too?
      instructions:
      - text: Show the reputation badge preview metadata.
      - text: List the soulbound badge artifact types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/reputation-badges/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a reputation badge evidence packet
      effect: read
      questions:
      - Can I preview the evidence behind a soulbound reputation badge before issuing it?
      - Does a badge preview keep the verified, reachable and failed trust wording?
      instructions:
      - text: Build a reputation badge preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview a soulbound badge evidence suite {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/skill-nfts/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read Skill NFT preview metadata
      effect: read
      questions:
      - What Skill NFT access rules and entitlement artifacts can be previewed?
      - Which actions does the Skill NFT preview route support?
      instructions:
      - text: Show the Skill NFT preview metadata.
      - text: List the Skill NFT artifact types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/skill-nfts/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a Skill NFT entitlement review packet
      effect: read
      questions:
      - Can I preview whether holding a Skill NFT would unlock a skill?
      - What happens in a Skill NFT preview when ownership data is stale?
      instructions:
      - text: Build a Skill NFT entitlement preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview Skill NFT access artifacts {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/context-compression/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read context-compression preview metadata
      effect: read
      questions:
      - What context compression artifacts like chunks and retention policies can be previewed?
      - Which actions does the context-compression service preview describe?
      instructions:
      - text: Show the context-compression preview metadata.
      - text: List supported context-compression artifact types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/context-compression/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a context-compression review packet
      effect: read
      questions:
      - Can I preview how an agent's context would be indexed and chunked for retrieval?
      - Are chunks in a context-compression preview stored as raw text?
      instructions:
      - text: Build a context-compression preview of type {artifact_type} for deployment {deployment_id}.
        slots:
          artifact_type: requestBody.artifact_type
          deployment_id: requestBody.deployment_id
      - text: Preview a context index and retention suite {artifacts} for owner {owner_id}.
        slots:
          artifacts: requestBody.artifacts
          owner_id: requestBody.owner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-activation-plans/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold activation-plan preview metadata
      effect: read
      questions:
      - What approval classes and workstreams does the External Source Scaffold activation-plan preview cover?
      - Which input shapes does the scaffold activation-plan route accept?
      instructions:
      - text: Show the External Source Scaffold activation-plan preview metadata.
      - text: List the workstreams and approval classes for scaffold activation plans.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-activation-plans/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold activation-plan suite
      effect: read
      questions:
      - What approval blockers and smoke evidence stand between the scaffold workstreams and activation?
      - Can I compile an activation plan for all five External Source Scaffold workstreams?
      instructions:
      - text: Compile a scaffold activation-plan suite from readiness suite {readiness_suite}.
        slots:
          readiness_suite: requestBody.readiness_suite
      - text: Preview the activation plan using approval packets {activation_approval_packets}.
        slots:
          activation_approval_packets: requestBody.activation_approval_packets
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-activation-implementations/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold activation-implementation metadata
      effect: read
      questions:
      - What implementation packet schema does the scaffold activation-implementation preview use?
      - Which input shapes can I send to the scaffold implementation preview?
      instructions:
      - text: Show the External Source Scaffold activation-implementation preview metadata.
      - text: Describe the implementation packet schema for scaffold activation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-activation-implementations/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold activation-implementation suite
      effect: read
      questions:
      - Can I turn an activation plan into implementation packets for selected scaffold workstreams?
      - What owner-review status do scaffold implementation packets carry?
      instructions:
      - text: Compile implementation packets from activation-plan suite {activation_plan_suite}.
        slots:
          activation_plan_suite: requestBody.activation_plan_suite
      - text: Preview scaffold implementation for workstreams {selected_workstreams}.
        slots:
          selected_workstreams: requestBody.selected_workstreams
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-production-audits/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold production-audit preview metadata
      effect: read
      questions:
      - What does the External Source Scaffold production hardening audit preview accept?
      - Which workstreams are covered by the scaffold production audit?
      instructions:
      - text: Show the scaffold production-audit preview metadata.
      - text: List accepted inputs for the scaffold production hardening audit.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-production-audits/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold production hardening audit
      effect: read
      questions:
      - Are the scaffold workstreams hardened enough for production, based on canary and readiness inputs?
      - Can I audit production readiness across the scaffold program without deploying?
      instructions:
      - text: Run a production hardening audit preview from canary suite {canary_suite}.
        slots:
          canary_suite: requestBody.canary_suite
      - text: Audit production readiness using implementation suite {implementation_suite} and readiness suite {readiness_suite}.
        slots:
          implementation_suite: requestBody.implementation_suite
          readiness_suite: requestBody.readiness_suite
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-candidates/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold release-candidate preview metadata
      effect: read
      questions:
      - What release evidence does a scaffold release candidate need?
      - Which inputs does the scaffold release-candidate preview route accept?
      instructions:
      - text: Show the scaffold release-candidate preview metadata.
      - text: List the release evidence requirements for scaffold release candidates.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-candidates/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold release-candidate suite
      effect: read
      questions:
      - Can I assemble a release candidate from a production audit plus PR and smoke evidence?
      - What does a scaffold release candidate still lack before release?
      instructions:
      - text: Compile a release candidate from production audit {production_audit} and PR {implementation_pr_ref}.
        slots:
          production_audit: requestBody.production_audit
          implementation_pr_ref: requestBody.implementation_pr_ref
      - text: Preview a release candidate with smoke evidence {production_smoke_evidence_ref} and rollback acceptance {rollback_acceptance_ref}.
        slots:
          production_smoke_evidence_ref: requestBody.production_smoke_evidence_ref
          rollback_acceptance_ref: requestBody.rollback_acceptance_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-decisions/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold release-decision preview metadata
      effect: read
      questions:
      - Which owner release decisions does the scaffold release-decision preview accept?
      - What are the requirements for a scaffold release decision?
      instructions:
      - text: Show the scaffold release-decision preview metadata.
      - text: List the accepted approve, hold and reject decision formats for scaffold releases.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-decisions/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold release-decision suite
      effect: read
      questions:
      - Can I record an approve, hold or reject decision against a scaffold release candidate as a preview?
      - What checklist does each workstream get in a release-decision preview?
      instructions:
      - text: Preview release decision {decision} on release candidate {release_candidate}.
        slots:
          decision: requestBody.decision
          release_candidate: requestBody.release_candidate
      - text: Compile a release-decision suite decided by {decided_by} with rationale {rationale_ref}.
        slots:
          decided_by: requestBody.decided_by
          rationale_ref: requestBody.rationale_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-execution-preflights/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold release-execution-preflight metadata
      effect: read
      questions:
      - What must be in place before a scaffold release can execute, per the preflight preview?
      - Which inputs does the release-execution preflight preview accept?
      instructions:
      - text: Show the scaffold release-execution-preflight preview metadata.
      - text: List the preflight requirements for executing a scaffold release.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-execution-preflights/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold release-execution preflight
      effect: read
      questions:
      - Is an approved scaffold release ready to execute given the operator and release window?
      - Can I preflight a release with a smoke command and rollback plan before running it?
      instructions:
      - text: Preflight the release from decision {release_decision} with operator {release_operator_ref}.
        slots:
          release_decision: requestBody.release_decision
          release_operator_ref: requestBody.release_operator_ref
      - text: Check release execution readiness for window {release_window_ref} and smoke command {production_smoke_command_ref}.
        slots:
          release_window_ref: requestBody.release_window_ref
          production_smoke_command_ref: requestBody.production_smoke_command_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-execution-evidence/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold release-execution-evidence metadata
      effect: read
      questions:
      - Which manual release results can I report in the release-execution-evidence preview?
      - What evidence is required to document a scaffold release that was run?
      instructions:
      - text: Show the scaffold release-execution-evidence preview metadata.
      - text: List accepted manual release results for execution evidence.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-execution-evidence/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview scaffold release-execution evidence
      effect: read
      questions:
      - Can I package the receipt and operator attestation from a manual scaffold release for review?
      - How do I preview evidence that a manual release finished and passed smoke tests?
      instructions:
      - text: Preview release evidence with receipt {manual_release_execution_receipt_ref} and result {manual_release_result}.
        slots:
          manual_release_execution_receipt_ref: requestBody.manual_release_execution_receipt_ref
          manual_release_result: requestBody.manual_release_result
      - text: Compile execution evidence from preflight {release_execution_preflight} finished at {manual_release_finished_at}.
        slots:
          release_execution_preflight: requestBody.release_execution_preflight
          manual_release_finished_at: requestBody.manual_release_finished_at
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-outcome-ledgers/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold release-outcome-ledger metadata
      effect: read
      questions:
      - What does a scaffold release-outcome ledger require for closeout?
      - Which inputs does the release-outcome-ledger preview accept?
      instructions:
      - text: Show the scaffold release-outcome-ledger preview metadata.
      - text: List the release outcome ledger requirements.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-release-outcome-ledgers/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold release-outcome ledger
      effect: read
      questions:
      - Can I preview the final outcome record of a scaffold release with its customer impact and follow-ups?
      - What would the release outcome ledger show after the stability window?
      instructions:
      - text: Preview the release outcome ledger from execution evidence {release_execution_evidence}.
        slots:
          release_execution_evidence: requestBody.release_execution_evidence
      - text: Compile a release outcome with summary {release_outcome_summary_ref} and customer impact {public_customer_impact_ref}.
        slots:
          release_outcome_summary_ref: requestBody.release_outcome_summary_ref
          public_customer_impact_ref: requestBody.public_customer_impact_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-completion-audits/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read scaffold completion-audit preview metadata
      effect: read
      questions:
      - What artifact inventory is expected for the scaffold program completion audit?
      - Which inputs does the scaffold completion-audit preview accept?
      instructions:
      - text: Show the scaffold completion-audit preview metadata.
      - text: List the expected artifacts for a scaffold completion audit.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/external-source-scaffold-completion-audits/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a scaffold program completion audit
      effect: read
      questions:
      - Is the External Source Scaffold program ready to close out, given docs and OpenAPI sync evidence?
      - What live activation blockers remain according to the completion audit?
      instructions:
      - text: Preview the completion audit from release outcome ledger {release_outcome_ledger}.
        slots:
          release_outcome_ledger: requestBody.release_outcome_ledger
      - text: Audit program completion with validation bundle {validation_bundle_ref} and docs sync review {docs_sync_review_ref}.
        slots:
          validation_bundle_ref: requestBody.validation_bundle_ref
          docs_sync_review_ref: requestBody.docs_sync_review_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/channels'].get
  update:
    x-apievangelist-phrasing:
      intent: List owner-control channels for a deployment
      effect: read
      questions:
      - Which Slack, Discord, Telegram or email channels get my deployment's approval requests?
      - Can I see recent channel events for a deployed agent?
      instructions:
      - text: List the owner-control channels for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show recent channel events on deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/channels'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an owner-control channel
      effect: write
      questions:
      - How do I get budget alerts and approval requests for my agent in Slack or Telegram?
      - Which events can I subscribe an owner-control channel to?
      instructions:
      - text: Register a {type} owner channel for deployment {deployment_id}.
        slots:
          type: requestBody.type
          deployment_id: path.deployment_id
      - text: Add a {type} channel to {destination} for deployment {deployment_id} covering events {events}.
        slots:
          type: requestBody.type
          destination: requestBody.destination
          deployment_id: path.deployment_id
          events: requestBody.events
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/channels/{channel_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable an owner-control channel
      effect: destructive
      questions:
      - How do I stop approval requests from going to one of my channels?
      - Can I turn off a single owner-control channel on a deployment?
      instructions:
      - text: Disable channel {channel_id} on deployment {deployment_id}.
        slots:
          channel_id: path.channel_id
          deployment_id: path.deployment_id
      - text: Turn off owner notifications through channel {channel_id} for {deployment_id}.
        slots:
          channel_id: path.channel_id
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/handover'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a signed owner pickup handoff
      effect: write
      questions:
      - How do I send the owner an expiring link to approve or pick up an agent's session?
      - Can I limit what actions a pickup token allows and how long it lasts?
      instructions:
      - text: Create a pickup handoff on deployment {deployment_id} for approval {approval_id}.
        slots:
          deployment_id: path.deployment_id
          approval_id: requestBody.approval_id
      - text: Hand over run {run_id} of deployment {deployment_id} with a token valid for {ttl_seconds} seconds.
        slots:
          run_id: requestBody.run_id
          deployment_id: path.deployment_id
          ttl_seconds: requestBody.ttl_seconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/pickup'].post
  update:
    x-apievangelist-phrasing:
      intent: Redeem an owner pickup token
      effect: write
      questions:
      - How does an owner use a pickup token to approve a pending request?
      - Does redeeming a pickup token run the invocation it approves?
      instructions:
      - text: Redeem pickup token {token} on deployment {deployment_id}.
        slots:
          token: requestBody.token
          deployment_id: path.deployment_id
      - text: Use token {token} to record decision {decision} on deployment {deployment_id}.
        slots:
          token: requestBody.token
          decision: requestBody.decision
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/preview-links'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a short-lived preview link
      effect: write
      questions:
      - Can I share a temporary link to a code artifact or report my agent produced?
      - How long can a deployment preview link stay valid?
      instructions:
      - text: Create a preview link on deployment {deployment_id} for task {task_id}.
        slots:
          deployment_id: path.deployment_id
          task_id: requestBody.task_id
      - text: Make a preview link titled {title} for receipt {receipt_id} on {deployment_id} lasting {ttl_seconds} seconds.
        slots:
          title: requestBody.title
          receipt_id: requestBody.receipt_id
          deployment_id: path.deployment_id
          ttl_seconds: requestBody.ttl_seconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/preview-links/{token}'].get
  update:
    x-apievangelist-phrasing:
      intent: Open a sanitized preview link
      effect: read
      questions:
      - What does someone see when they open a preview link I shared?
      - Are private context fields hidden when a preview link is opened?
      instructions:
      - text: Open preview link {token}.
        slots:
          token: path.token
      - text: Show the sanitized content behind preview token {token}.
        slots:
          token: path.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/provider-profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List governed provider profiles
      effect: read
      questions:
      - Which governed model provider profiles have I set up?
      - What budget and approval policies are attached to my provider profiles?
      instructions:
      - text: List my governed provider profiles.
      - text: Show all provider profiles with their model lanes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/provider-profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a governed provider profile
      effect: write
      questions:
      - How do I define which models an agent may use along with its budget and approval rules?
      - Can a provider profile specify a fallback model?
      instructions:
      - text: Create a provider profile named {name}.
        slots:
          name: requestBody.name
      - text: Create profile {name} allowing models {allowed_models} with budget policy {budget_policy}.
        slots:
          name: requestBody.name
          allowed_models: requestBody.allowed_models
          budget_policy: requestBody.budget_policy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/local-bridge/session'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a local-harness bridge session
      effect: write
      questions:
      - How do I connect a local coding agent like Claude Code or Cursor to Agent OS?
      - Does opening a local bridge session deploy anything or spend funds?
      instructions:
      - text: Create a local bridge session for {local_agent}.
        slots:
          local_agent: requestBody.local_agent
      - text: Open a bridge session for {local_agent} on workspace {workspace_ref} using provider profile {provider_profile_id}.
        slots:
          local_agent: requestBody.local_agent
          workspace_ref: requestBody.workspace_ref
          provider_profile_id: requestBody.provider_profile_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/local-bridge/router-checkout'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a no-spend Router Checkout intent
      effect: write
      questions:
      - How can my local agent ask to use Router Checkout without spending anything?
      - What backend route comes back from a local-bridge checkout intent?
      instructions:
      - text: Record a Router Checkout intent on bridge session {session_id} for task {task}.
        slots:
          session_id: requestBody.session_id
          task: requestBody.task
      - text: Request Router Checkout from session {session_id} with constraints {constraints}.
        slots:
          session_id: requestBody.session_id
          constraints: requestBody.constraints
      method: generated
      generated: '2026-09-26'
- target: $.paths['/local-bridge/receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Link a receipt to a local bridge session
      effect: write
      questions:
      - How do I attach a receipt to my local agent's bridge session?
      - Can I tie an existing receipt ID back to a local-harness session?
      instructions:
      - text: Link receipt {receipt_id} to bridge session {session_id}.
        slots:
          receipt_id: requestBody.receipt_id
          session_id: requestBody.session_id
      - text: Attach receipt {receipt} to local session {session_id}.
        slots:
          receipt: requestBody.receipt
          session_id: requestBody.session_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect a deployed agent's full surface bundle
      effect: read
      questions:
      - Can I inspect everything generated for a private deployed agent in one bundle?
      - What does the owner-only surface envelope for a deployment include?
      instructions:
      - text: Show the full generated surface bundle for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Inspect the card, OpenAPI, MCP, receipts and trust envelope of {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a deployed agent's health
      effect: read
      questions:
      - Is my deployed agent healthy, even if it's private?
      - Where do I get a health summary for a generated agent surface?
      instructions:
      - text: Check the health of deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Get the surface health summary for deployed agent {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/agent.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed agent's generated descriptor
      effect: read
      questions:
      - What does the agent.json descriptor for my deployed agent look like?
      - Are secrets and prompts redacted from the generated agent descriptor?
      instructions:
      - text: Get the agent.json descriptor for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the redacted agent descriptor generated for {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/openapi.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed agent's OpenAPI as JSON
      effect: read
      questions:
      - Can I download the generated OpenAPI for my deployed agent in JSON?
      - Which tools are left out of a deployment's generated OpenAPI JSON?
      instructions:
      - text: Get the OpenAPI JSON for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Download deployed agent {deployment_id}'s spec in JSON format.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/openapi.yaml'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed agent's OpenAPI as YAML
      effect: read
      questions:
      - Is the generated OpenAPI for a deployment available as YAML?
      - Where do I grab a YAML contract for my private deployed agent?
      instructions:
      - text: Get the OpenAPI YAML for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Export deployed agent {deployment_id}'s spec as YAML.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/mcp'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed agent's MCP descriptor
      effect: read
      questions:
      - What MCP descriptor metadata is generated for my deployed agent?
      - Can I execute MCP tools through the deployment's MCP descriptor yet?
      instructions:
      - text: Get the MCP descriptor for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the generated MCP metadata of deployed agent {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/receipts'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize a deployed agent's receipts
      effect: read
      questions:
      - How many receipts has my deployed agent produced and what do they cover?
      - Are buyer-private details excluded from a deployment's receipt summary?
      instructions:
      - text: Summarize the receipts for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the redacted receipt summary on deployed agent {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/surface/trust'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed agent's trust and readiness summary
      effect: read
      questions:
      - How trustworthy and ready does the platform rate my deployed agent?
      - What trust summary will buyers see for a deployment?
      instructions:
      - text: Get the trust summary for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the readiness and trust status of deployed agent {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'