# 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 Intent Compiler API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-intent-compiler-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: 5
- target: $.paths['/agent-os/intent/fold'].post
  update:
    x-apievangelist-phrasing:
      intent: Compile an intent into a typed contract
      effect: write
      questions:
      - How do I turn what a user or LLM wants into a policy-checkable intent contract before spending?
      - Can I fold an agent's intent into a deterministic contract scoped to one deployment?
      instructions:
      - text: Fold a {intent_type} intent with payload {payload} into an Agent OS intent contract.
        slots:
          intent_type: requestBody.intent_type
          payload: requestBody.payload
      - text: Compile my {intent_type} request for deployment {deployment_id} under policy {policy}.
        slots:
          intent_type: requestBody.intent_type
          deployment_id: requestBody.deployment_id
          policy: requestBody.policy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/intent/{intent_contract_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read an intent contract
      effect: read
      questions:
      - Where can I view an intent contract that was already folded?
      - What does a compiled Agent OS intent contract contain?
      instructions:
      - text: Show intent contract {intent_contract_id}.
        slots:
          intent_contract_id: path.intent_contract_id
      - text: Fetch the stored details of intent contract {intent_contract_id}.
        slots:
          intent_contract_id: path.intent_contract_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/intent/{intent_contract_id}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate an intent contract
      effect: read
      questions:
      - How can I check whether an intent contract passes validation?
      - Is my compiled intent contract valid or blocked?
      instructions:
      - text: Validate intent contract {intent_contract_id}.
        slots:
          intent_contract_id: path.intent_contract_id
      - text: Run the validation checks on intent contract {intent_contract_id} and report problems.
        slots:
          intent_contract_id: path.intent_contract_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/intent/{intent_contract_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve an intent contract needing owner review
      effect: write
      questions:
      - How does an owner sign off on an intent contract that was flagged for review?
      - Can I approve an intent contract that is invalid or blocked?
      instructions:
      - text: Approve intent contract {intent_contract_id} as the owner.
        slots:
          intent_contract_id: path.intent_contract_id
      - text: Give owner approval to the review-required contract {intent_contract_id}.
        slots:
          intent_contract_id: path.intent_contract_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/intent/{intent_contract_id}/reconcile'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconcile an outcome against its intent
      effect: write
      questions:
      - How do I compare what actually happened against the intent contract my agent started with?
      - Can I reconcile a receipt or invocation with the intent that authorised it?
      instructions:
      - text: Reconcile receipt {receipt_id} against intent contract {intent_contract_id}.
        slots:
          receipt_id: requestBody.receipt_id
          intent_contract_id: path.intent_contract_id
      - text: Check invocation {invocation_id} and outcome {outcome} against intent {intent_contract_id}.
        slots:
          invocation_id: requestBody.invocation_id
          outcome: requestBody.outcome
          intent_contract_id: path.intent_contract_id
      method: generated
      generated: '2026-09-26'