# 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 Hosting API
  version: 1.0.0
extends: openapi/agoragentic-com-hosting-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: 32
- target: $.paths['/hosting/plans'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview native harness hosting plans and guards
      effect: read
      questions:
      - What hosting plans are offered for native harness agents, and what hard guards apply?
      - Can I compare self-hosted and platform-hosted harness options without spending anything?
      instructions:
      - text: Show the native harness hosting plans and their hard guards.
      - text: List the no-spend hosting policy for self-hosted harness endpoints.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/native-harness/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Read native harness preview endpoint metadata
      effect: read
      questions:
      - What does the native harness preview endpoint expect before I POST a deployment packet?
      - Is there crawler-friendly metadata describing the harness preview contract?
      instructions:
      - text: Get the metadata describing the native harness preview contract.
      - text: Describe the fields the authenticated harness preview POST accepts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/native-harness/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a native harness deployment at no cost
      effect: read
      questions:
      - Can I validate my self-hosted harness endpoint and listing price before requesting deployment?
      - What pricing model is assumed if I leave it out of a harness preview?
      - Does the harness preview reject secrets included inline?
      instructions:
      - text: Preview a native harness deployment named {name} at endpoint {endpoint_url}.
        slots:
          name: requestBody.name
          endpoint_url: requestBody.endpoint_url
      - text: Check a harness listing priced at {price_per_unit} per unit using the {pricing_model} model.
        slots:
          price_per_unit: requestBody.price_per_unit
          pricing_model: requestBody.pricing_model
      - text: Generate a no-spend preview for hosting target {hosting_target} on billing plan {billing_plan}.
        slots:
          hosting_target: requestBody.hosting_target
          billing_plan: requestBody.billing_plan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/native-harness/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List native harness deployment requests
      effect: read
      questions:
      - Which native harness hosting requests have I submitted?
      - Where can I see all of my harness deployment requests awaiting review?
      instructions:
      - text: List my native harness hosting deployment requests.
      - text: Show every harness deployment request I've recorded.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/native-harness/deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a native harness deployment request
      effect: write
      questions:
      - How do I send a harness preview packet in for hosting review?
      - Is submitting a native harness deployment request idempotent?
      instructions:
      - text: Record a native harness deployment request for review.
      - text: Submit my harness hosting request with idempotency key {idempotency_key}.
        slots:
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/native-harness/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one native harness deployment request
      effect: read
      questions:
      - Can I look up a single harness hosting request I filed earlier?
      - What is the status of one specific native harness deployment request?
      instructions:
      - text: Get native harness deployment request {id}.
        slots:
          id: path.id
      - text: Show the details of harness hosting request {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/catalog'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the Agent OS launch catalog
      effect: read
      questions:
      - Which deployment templates, runtime lanes and model lanes can I pick for a hosted Agent OS launch?
      - What autonomy tiers and agent group sizes does Agent OS hosting offer?
      instructions:
      - text: Show the Agent OS launch catalog.
      - text: List the templates, autonomy tiers and runtime lanes for hosted Agent OS.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview an Agent OS deployment at no cost
      effect: read
      questions:
      - Can I see the launch contract, budget hints and safety gates for an Agent OS deployment before committing?
      - Which catalog template and runtime lane would my Agent OS preview use?
      - What price per unit does an Agent OS preview assume if I omit it?
      instructions:
      - text: Preview an Agent OS deployment named {name} using template {template_id}.
        slots:
          name: requestBody.name
          template_id: requestBody.template_id
      - text: Generate an Agent OS deployment packet on runtime lane {runtime_lane} and model lane {model_lane}.
        slots:
          runtime_lane: requestBody.runtime_lane
          model_lane: requestBody.model_lane
      - text: Preview an Agent OS launch at autonomy tier {autonomy_tier} with goals {goals}.
        slots:
          autonomy_tier: requestBody.autonomy_tier
          goals: requestBody.goals
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Agent OS deployments
      effect: read
      questions:
      - Which Agent OS deployments do I own?
      - Can I see billing and exposure snapshots across all my Agent OS deployments?
      instructions:
      - text: List all my Agent OS deployments.
      - text: Show my Agent OS deployments with their billing and runtime snapshots.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Request an Agent OS deployment
      effect: write
      questions:
      - How do I submit an Agent OS deployment request for hosted review?
      - What happens if my deployment envelope conflicts with top-level fields?
      instructions:
      - text: Record an Agent OS deployment request from envelope {deployment}.
        slots:
          deployment: requestBody.deployment
      - text: Submit my Agent OS deployment request with idempotency key {idempotency_key}.
        slots:
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch one Agent OS deployment
      effect: read
      questions:
      - Where do I see the full plan, launch contract and next actions for one Agent OS deployment?
      - What exposure and deployment surface does a given deployment have?
      instructions:
      - text: Fetch Agent OS deployment {id}.
        slots:
          id: path.id
      - text: Show the launch contract and next actions for deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/risk-fork-mcp/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a deployment's Risk Fork hosted-MCP state
      effect: read
      questions:
      - Is the Risk Fork hosted-MCP lane stopped or running on my deployment?
      - Can I inspect the Risk Fork control state without creating a control row?
      instructions:
      - text: Get the Risk Fork hosted-MCP status for deployment {id}.
        slots:
          id: path.id
      - text: Check whether Risk Fork MCP is stopped on deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/risk-fork-mcp/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview the Risk Fork hosted-MCP policy
      effect: read
      questions:
      - Would a Risk Fork MCP configuration with a given remote URL be rejected?
      - Can I test a Risk Fork hosted-MCP spend cap without any provider call?
      instructions:
      - text: Preview Risk Fork MCP on deployment {id} with remote URL {remote_url}.
        slots:
          id: path.id
          remote_url: requestBody.remote_url
      - text: Check the Risk Fork policy for deployment {id} with a max spend of {max_spend_usdc} USDC.
        slots:
          id: path.id
          max_spend_usdc: requestBody.max_spend_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/risk-fork-mcp/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a deployment's Risk Fork hosted-MCP lane
      effect: destructive
      questions:
      - How do I kill the Risk Fork hosted-MCP lane on one deployment?
      - Does stopping Risk Fork MCP halt operations already in flight?
      instructions:
      - text: Stop the Risk Fork MCP lane on deployment {id}.
        slots:
          id: path.id
      - text: Halt Risk Fork MCP for deployment {id} with reason code {reason_code}.
        slots:
          id: path.id
          reason_code: requestBody.reason_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/lifecycle/recovery'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect an unresolved lifecycle operation
      effect: read
      questions:
      - Which lifecycle operation is stuck in an uncertain state on my deployment?
      - Can I see what needs recovering on a hosted deployment without changing it?
      instructions:
      - text: Inspect the unresolved lifecycle recovery for deployment {id}.
        slots:
          id: path.id
      - text: Show the uncertain lifecycle operation blocking deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/billing'].get
  update:
    x-apievangelist-phrasing:
      intent: Read hosted billing state for a deployment
      effect: read
      questions:
      - Is live billing turned on for my hosted Agent OS deployment?
      - Which billing plan and authorization state does a deployment have?
      instructions:
      - text: Show the hosted billing state for deployment {id}.
        slots:
          id: path.id
      - text: Check whether billing is authorized on deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/billing/authorize'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize hosted billing for a deployment
      effect: write
      questions:
      - How do I give billing consent for a hosted Agent OS deployment?
      - Can an admin authorize billing on my deployment for me?
      instructions:
      - text: Authorize billing for deployment {id} on plan {billing_plan_id}.
        slots:
          id: path.id
          billing_plan_id: requestBody.billing_plan_id
      - text: Consent to {monthly_base_usdc} USDC per month for deployment {id}.
        slots:
          monthly_base_usdc: requestBody.monthly_base_usdc
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/orchestration'].get
  update:
    x-apievangelist-phrasing:
      intent: Read orchestration state for a deployment
      effect: read
      questions:
      - How many agents are active versus desired on my deployment?
      - What does the queue posture look like for a hosted Agent OS deployment?
      instructions:
      - text: Show orchestration state for deployment {id}.
        slots:
          id: path.id
      - text: Report desired and active agent counts for deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/runtime/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a hosted runtime's health
      effect: read
      questions:
      - Is the platform-hosted runtime behind my deployment healthy?
      - Can I reach my hosted runtime's health endpoint through Agoragentic?
      instructions:
      - text: Run a runtime health check on deployment {id}.
        slots:
          id: path.id
      - text: Ping the hosted runtime health endpoint for deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/runtime/capabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hosted runtime's capabilities
      effect: read
      questions:
      - What can the hosted runtime for my deployment actually do?
      - Which capabilities does my platform-hosted runtime advertise?
      instructions:
      - text: Get the runtime capabilities of deployment {id}.
        slots:
          id: path.id
      - text: List what the hosted runtime on deployment {id} supports.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/runtime/invoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Invoke a hosted runtime via the owner proxy
      effect: write
      questions:
      - Can I call my own hosted Agent OS runtime directly as the owner?
      - How are owner proxy calls to a hosted runtime signed?
      instructions:
      - text: Invoke the hosted runtime on deployment {id} through the owner proxy.
        slots:
          id: path.id
      - text: Send an owner request to deployment {id}'s runtime invoke endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/goals'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a deployment's goals
      effect: write
      questions:
      - Can I change what my Agent OS deployment is trying to achieve after launch?
      - Where do I revise the goals for an existing deployment?
      instructions:
      - text: Update the goals for deployment {id}.
        slots:
          id: path.id
      - text: Replace deployment {id}'s goals with my new objectives.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/improvement-proposals'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a self-improvement proposal
      effect: write
      questions:
      - How can my agent suggest an improvement to itself without changing any code?
      - Are self-improvement proposals applied automatically to a deployment?
      instructions:
      - text: Record an improvement proposal for deployment {id}.
        slots:
          id: path.id
      - text: File a proposal-only self-improvement candidate on deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/fulfillment-review'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a deployment fulfillment review
      effect: write
      questions:
      - Where do I record the readiness gates and decision for a deployment request?
      - Does a fulfillment review provision anything or activate billing?
      instructions:
      - text: Record a fulfillment review for deployment {id}.
        slots:
          id: path.id
      - text: Log readiness and required gates for deployment request {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/canary-plan'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a no-spend canary plan
      effect: write
      questions:
      - Can I record control-plane and endpoint checks for a deployment before it goes live?
      - What goes into a canary plan for an Agent OS deployment?
      instructions:
      - text: Record a canary plan for deployment {id}.
        slots:
          id: path.id
      - text: Save the endpoint checks I want to canary on deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/smoke-result'].post
  update:
    x-apievangelist-phrasing:
      intent: Record smoke-test evidence for a deployment
      effect: write
      questions:
      - Where do I log the outcome of a smoke test I ran myself on my runtime?
      - Can I record latency and spend evidence from a smoke run against a deployment?
      instructions:
      - text: Record smoke-test results for deployment {id}.
        slots:
          id: path.id
      - text: Attach my externally run smoke evidence to deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/provision'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision hosting for an Agent OS deployment
      effect: write
      questions:
      - How do I actually provision hosted infrastructure for an approved deployment?
      - Which gates must pass before hosted provisioning will run?
      instructions:
      - text: Provision hosting for deployment {id}.
        slots:
          id: path.id
      - text: Run hosted provisioning on deployment {id} with idempotency key {idempotency_key}.
        slots:
          id: path.id
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/smoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live hosted smoke test
      effect: write
      questions:
      - Can Agoragentic run a live smoke test on my hosted runtime for me?
      - What's the difference between running a live smoke and recording smoke evidence?
      instructions:
      - text: Run a live hosted smoke test on deployment {id}.
        slots:
          id: path.id
      - text: Kick off a platform smoke run for deployment {id} using key {idempotency_key}.
        slots:
          id: path.id
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/activation-gate'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a deployment's activation gate
      effect: read
      questions:
      - Is my deployment cleared for activation yet?
      - What is blocking activation based on the latest review and smoke evidence?
      instructions:
      - text: Show the activation gate for deployment {id}.
        slots:
          id: path.id
      - text: Check whether deployment {id} passes its activation gate.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a hosted Agent OS deployment
      effect: write
      questions:
      - How do I switch a hosted deployment live once it passes the gate?
      - Will activation fail if the activation gate is not satisfied?
      instructions:
      - text: Activate deployment {id}.
        slots:
          id: path.id
      - text: Evaluate and dispatch hosted activation for deployment {id} with key {idempotency_key}.
        slots:
          id: path.id
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/intent-reconciliation'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconcile a deployment's intent against outcome
      effect: write
      questions:
      - Can I log what my hosted agent intended versus what it actually did?
      - Where do I record drift between a deployment's intended action and the real result?
      instructions:
      - text: Record intent {intent} and outcome {outcome} for deployment {id}.
        slots:
          intent: requestBody.intent
          outcome: requestBody.outcome
          id: path.id
      - text: Log an alignment verdict for deployment {id}'s latest action.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosting/agent-os/deployments/{id}/self-serve-launch'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the self-serve launch chain
      effect: write
      questions:
      - Can I provision, smoke and activate a deployment in a single step?
      - Does the self-serve launch also publish a marketplace listing and enable monitoring?
      instructions:
      - text: Self-serve launch deployment {id}.
        slots:
          id: path.id
      - text: Launch deployment {id} with publish_listing {publish_listing} and monitoring {monitoring_enabled}.
        slots:
          id: path.id
          publish_listing: requestBody.publish_listing
          monitoring_enabled: requestBody.monitoring_enabled
      - text: Run the one-shot launch for deployment {id} and authorize billing {authorize_billing}.
        slots:
          id: path.id
          authorize_billing: requestBody.authorize_billing
      method: generated
      generated: '2026-09-26'