# 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 Argent API
  version: 1.0.0
extends: openapi/agoragentic-com-argent-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['/arbiter/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Argent verifier metadata
      effect: read
      questions:
      - What is the Argent verifier and which validation routes does it expose?
      - Is the high-risk verifier ready for x402 job contracts right now?
      instructions:
      - text: Show the public Argent metadata.
      - text: Get Argent's validation routes and high-risk readiness.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arbiter/nodes'].get
  update:
    x-apievangelist-phrasing:
      intent: View Argent validation nodes
      effect: read
      questions:
      - Which nodes make up Argent's validation DAG?
      - Is an external verifier adapter configured alongside Argent?
      instructions:
      - text: List Argent's validation DAG nodes.
      - text: Show the validation status and semantic advisory posture for Argent.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arbiter/schemas'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Argent schema links
      effect: read
      questions:
      - Where are the JSON schemas for the Argent intent envelope and execution receipt?
      - What does a reconciliation verdict payload look like?
      instructions:
      - text: Give me the Argent schema URLs.
      - text: Link the intent, receipt and verdict schemas.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arbiter/receipt-reconciliation'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconcile a receipt against declared intent
      effect: read
      questions:
      - How do I check whether a paid job's receipt and output actually match what was promised?
      - Can I verify an x402 payment response against the observed output?
      instructions:
      - text: Reconcile receipt {receipt} against intent {declared_intent}.
        slots:
          receipt: requestBody.receipt
          declared_intent: requestBody.declared_intent
      - text: Verify that output {observed_output} and payment {payment_response} satisfy intent {declared_intent}.
        slots:
          observed_output: requestBody.observed_output
          payment_response: requestBody.payment_response
          declared_intent: requestBody.declared_intent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arbiter/reconcile'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconcile a receipt via the short alias
      effect: read
      questions:
      - Is there a shorter reconcile alias for receipt verification?
      - Does the reconcile alias return the same verdict as the full receipt-reconciliation route?
      instructions:
      - text: Use the reconcile alias to check receipt {receipt} against {declared_intent}.
        slots:
          receipt: requestBody.receipt
          declared_intent: requestBody.declared_intent
      - text: Call the short reconcile shortcut with observed output {observed_output}.
        slots:
          observed_output: requestBody.observed_output
      method: generated
      generated: '2026-09-26'