API Evangelist conversational phrasing for SCVD General Store Claims API

# 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 Claims API
  version: 1.0.0
extends: openapi/scvd-store-claims-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: 3
- target: $.paths['/api/claims/challenge'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a purchase-recovery claim
      effect: write
      questions:
      - My agent's context reset after paying — how do I start recovering the purchase?
      - How long does a purchase-recovery challenge stay valid?
      instructions:
      - text: Get a claims challenge for wallet {address}.
        slots:
          address: requestBody.address
      - text: Start a purchase recovery for the paying wallet {address}.
        slots:
          address: requestBody.address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/claims'].get
  update:
    x-apievangelist-phrasing:
      intent: Read how purchase recovery works
      effect: read
      questions:
      - How does the store's purchase-recovery door work?
      - Which rails can I recover purchases on?
      instructions:
      - text: Explain the claims door.
      - text: Show the purchase recovery steps and rails.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/claims'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover what a wallet paid for
      effect: read
      questions:
      - Can I recover everything my wallet bought after losing the response?
      - How do I get back one original good using its certificate id?
      instructions:
      - text: Recover purchases for {address} with signature {signature}.
        slots:
          address: requestBody.address
          signature: requestBody.signature
      - text: Recover certificate {cert_id} for wallet {address}, signed {signature}.
        slots:
          cert_id: requestBody.cert_id
          address: requestBody.address
          signature: requestBody.signature
      method: generated
      generated: '2026-09-26'