# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SCVD General Store Preflight API
  version: 1.0.0
extends: openapi/scvd-store-preflight-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: 6
- target: $.paths['/api/preflight/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Preflight up to ten x402 doors at once
      effect: read
      questions:
      - Can I check several x402 endpoints' payment challenges in one call?
      - Does batching preflight probes save outbound requests?
      instructions:
      - text: 'Preflight these x402 URLs in one batch: {urls}.'
        slots:
          urls: requestBody.urls
      - text: Batch-check the payment challenge on {urls}.
        slots:
          urls: requestBody.urls
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/preflight/checks'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the preflight battery manifest
      effect: read
      questions:
      - Which stable check IDs make up each preflight battery?
      - Where is the dated changelog of the preflight checks?
      instructions:
      - text: Get the preflight battery manifest.
      - text: Show every preflight check ID and the ruleset digest.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/preflight/v1'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the v1 preflight criteria
      effect: read
      questions:
      - What does each v1 preflight check test and what falsifies it?
      - Where are the frozen v1 criteria a verdict cites?
      instructions:
      - text: Get the v1 preflight criteria.
      - text: Show me the published v1 battery checks.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/preflight/v1'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an x402 endpoint's challenge shape with v1
      effect: read
      questions:
      - Does my x402 endpoint return a parseable PAYMENT-REQUIRED header under the v1 battery?
      - Can I run the frozen v1 structural check for free?
      instructions:
      - text: Run the v1 preflight on {url}.
        slots:
          url: requestBody.url
      - text: Check {url}'s 402 challenge shape against the frozen v1 battery.
        slots:
          url: requestBody.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/preflight/v2'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the v2 preflight criteria
      effect: read
      questions:
      - What extra checks does the v2 preflight battery add?
      - Where are the v2 criteria a current verdict cites?
      instructions:
      - text: Get the v2 preflight criteria.
      - text: Show me the published v2 battery checks.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/preflight/v2'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an x402 endpoint's challenge shape with v2
      effect: read
      questions:
      - Will my x402 endpoint pass the stricter v2 preflight, including Solana receivability?
      - Is the v2 preflight check free and rate limited?
      instructions:
      - text: Run the v2 preflight on {url}.
        slots:
          url: requestBody.url
      - text: Check {url} against the current v2 battery.
        slots:
          url: requestBody.url
      method: generated
      generated: '2026-09-26'