API Evangelist conversational phrasing for Mandateshield Com Analysis only API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mandateshield Com Analysis only API
  version: 1.0.0
extends: openapi/mandateshield-com-analysis-only-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: 2
- target: $.paths['/api/v1/preflight'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze one purchase against mandate policy
      effect: read
      questions:
      - How can I check whether an agent's purchase would stay inside its mandate limits before paying?
      - Does the purchase preflight analysis ever authorize enforcement of a payment?
      - Which extra fields does an x402 purchase need, like the asset and network, when analyzing it?
      instructions:
      - text: Analyze a {amount} purchase by agent {agent_id} at merchant {merchant_id} under mandate {mandate_id} over {protocol}, idempotency key {idempotency_key}.
        slots:
          amount: requestBody.amount
          agent_id: requestBody.agent_id
          merchant_id: requestBody.merchant_id
          mandate_id: requestBody.mandate_id
          protocol: requestBody.protocol
          idempotency_key: requestBody.idempotency_key
      - text: Run a single non-executable policy analysis of a {amount} {protocol} purchase on asset {asset_id} over network {network} for mandate {mandate_id}.
        slots:
          amount: requestBody.amount
          protocol: requestBody.protocol
          asset_id: requestBody.asset_id
          network: requestBody.network
          mandate_id: requestBody.mandate_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze up to 25 purchases in one batch
      effect: read
      questions:
      - Can I analyze many agent purchases against policy in a single request?
      - What is the maximum number of purchases in one batch policy analysis?
      - Why would a batch item come back with LEGAL_ACCEPTANCE_REQUIRED?
      instructions:
      - text: Analyze this batch of purchases against their mandates in one request.
      - text: Run a multi-item policy analysis for my pending agent purchases, up to 25 at once.
      method: generated
      generated: '2026-09-26'