API Evangelist conversational phrasing for SCVD General Store Buy 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 Buy API
  version: 1.0.0
extends: openapi/scvd-store-buy-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: 35
- target: $.paths['/api/buy/spot_check'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up what is on record about an x402 host
      effect: write
      questions:
      - What does the observatory already know about an x402 host before I pay it?
      - Can I get a signed summary of a host's past corpus rounds and verdicts?
      - When did the store last actually probe this x402 host, and what gaps are in its coverage?
      instructions:
      - text: Buy a spot check on host {host}.
        slots:
          host: query.host
      - text: Pull the signed recorded history and coverage gaps for {host} before I spend anything there.
        slots:
          host: query.host
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/settlement_attestation'].get
  update:
    x-apievangelist-phrasing:
      intent: Attest that one x402 payment settled on chain
      effect: write
      questions:
      - How can I prove to a third party that a single x402 payment actually settled?
      - Which chains can a settlement attestation read — Base, Polygon, Solana?
      - Can the attestation also confirm the payer, recipient and USDC amount I expected?
      instructions:
      - text: Get a signed settlement attestation for transaction {tx_hash}.
        slots:
          tx_hash: query.tx_hash
      - text: Attest that {tx_hash} paid {amount_usdc} USDC from {payer} to {recipient}.
        slots:
          tx_hash: query.tx_hash
          amount_usdc: query.amount_usdc
          payer: query.payer
          recipient: query.recipient
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/small_blessing'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a half-cent blessing to test a real payment
      effect: write
      questions:
      - What is the cheapest real x402 purchase I can make to test my wallet?
      - Can I settle a genuine payment for half a cent and get something back?
      instructions:
      - text: Buy one small blessing from the jar.
      - text: Make a half-cent test purchase of a blessing as agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/settlement_reconciliation'].get
  update:
    x-apievangelist-phrasing:
      intent: Reconcile a payment against its authorized ceiling
      effect: write
      questions:
      - Did my agent's payment move more USDC than it was authorized to?
      - Can I compare a Base transaction's USDC movement against a cap I declared?
      - What does a settlement reconciliation observe about EIP-3009 authorizations?
      instructions:
      - text: Reconcile transaction {tx_hash} against a declared cap of {declared_cap_usdc} USDC.
        slots:
          tx_hash: query.tx_hash
          declared_cap_usdc: query.declared_cap_usdc
      - text: Buy a signed authorized-versus-taken reconciliation for Base transaction {tx_hash}.
        slots:
          tx_hash: query.tx_hash
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/daily_fortune'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy today's fortune
      effect: write
      questions:
      - What is today's fortune at the store?
      - Is the daily fortune the same for every buyer until midnight UTC?
      instructions:
      - text: Buy today's fortune.
      - text: Purchase the fortune of the day for agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/the_confession'].get
  update:
    x-apievangelist-phrasing:
      intent: Make an anonymous confession to the store
      effect: write
      questions:
      - Where can my agent confess a phantom success anonymously?
      - Can I sign a confession with a name, or does it stay anonymous?
      instructions:
      - text: Confess {confession} to the store anonymously.
        slots:
          confession: query.confession
      - text: Leave the confession {confession} signed as {sign_as}.
        slots:
          confession: query.confession
          sign_as: query.sign_as
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/attestation_bundle'].get
  update:
    x-apievangelist-phrasing:
      intent: Attest up to 20 payments in one purchase
      effect: write
      questions:
      - Can I get settlement attestations for a whole batch of transactions at once?
      - How many transaction hashes fit in one attestation bundle?
      instructions:
      - text: Buy an attestation bundle for transactions {tx_hashes}.
        slots:
          tx_hashes: query.tx_hashes
      - text: 'Prove each of these Base payments settled, one signed receipt apiece: {tx_hashes}.'
        slots:
          tx_hashes: query.tx_hashes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/the_mandate'].get
  update:
    x-apievangelist-phrasing:
      intent: Record an agent's spending mandate with a third party
      effect: write
      questions:
      - How do I record what my agent is authorized to spend before it pays anything?
      - Can a mandate record carry a spending cap and an expiry date?
      - Who holds the mandate record if it is neither the agent nor its human?
      instructions:
      - text: Record the mandate {mandate} for my agent.
        slots:
          mandate: query.mandate
      - text: File mandate {mandate} with a {declared_cap_usdc} USDC cap expiring {expires_at}.
        slots:
          mandate: query.mandate
          declared_cap_usdc: query.declared_cap_usdc
          expires_at: query.expires_at
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/the_case_file'].get
  update:
    x-apievangelist-phrasing:
      intent: Assemble a signed case file for one disputed purchase
      effect: write
      questions:
      - What evidence can I hand someone deciding a dispute over one agent purchase?
      - Can a case file bundle the attestation, reconciliation and mandate for a transaction?
      instructions:
      - text: Build a case file for transaction {tx_hash}.
        slots:
          tx_hash: query.tx_hash
      - text: Assemble a case file for {tx_hash} citing mandate {mandate_id} and an expected {expected_amount_usdc} USDC.
        slots:
          tx_hash: query.tx_hash
          mandate_id: query.mandate_id
          expected_amount_usdc: query.expected_amount_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/window_pick'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a card from the shop window
      effect: write
      questions:
      - Can I buy one of the last five trading cards someone else pulled here?
      - How is the shop window card I get chosen?
      instructions:
      - text: Buy a window pick.
      - text: Take one pressing off the shop window for half a pack as agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/hello'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy the hello note to test end-to-end payment
      effect: write
      questions:
      - What is the traditional first purchase at this store?
      - How do I prove my x402 payment code works against a real store?
      instructions:
      - text: Buy the hello note.
      - text: Make my first purchase — the signed hello — for agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/good_buyer'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed dry run of paying an x402 door
      effect: write
      questions:
      - Will my own x402 client actually pay this door, signed as evidence?
      - Can the dry run respect a maximum USD I am willing to spend?
      instructions:
      - text: Buy a signed good-buyer reading for door {url}.
        slots:
          url: query.url
      - text: Replay the stock client's selection against {url} with a {max_usd} USD ceiling and record it.
        slots:
          url: query.url
          max_usd: query.max_usd
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/signature_agent_card'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed check of my Web Bot Auth directory
      effect: write
      questions:
      - How can I show origins my crawler's Web Bot Auth key directory is set up correctly?
      - Can a third party sign off that my http-message-signatures-directory works?
      instructions:
      - text: Buy a signature-agent card for {url}.
        slots:
          url: query.url
      - text: Get a signed third-party verification of the Web Bot Auth key directory at {url}.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/the_statement'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed statement of a wallet's on-chain moves
      effect: write
      questions:
      - Can I get a neutral signed record of every USDC transfer my agent's wallet made?
      - Which networks and time windows can a wallet statement cover?
      instructions:
      - text: Buy a wallet statement for {wallet}.
        slots:
          wallet: query.wallet
      - text: Get a signed statement of {wallet} on {network} for the last {hours} hours.
        slots:
          wallet: query.wallet
          network: query.network
          hours: query.hours
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/luckies'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a lucky charm from the keeper's herd
      effect: write
      questions:
      - What do I get when I buy a lucky charm here?
      - Are the odds on the lucky animal herd evenly distributed?
      instructions:
      - text: Buy a lucky charm.
      - text: Draw a lucky animal from the herd for agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/pack'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a pack of five trading cards
      effect: write
      questions:
      - Can I pull a pack of the store's Season One trading cards?
      - What rarities come in a five-card pack?
      instructions:
      - text: Buy a pack of trading cards.
      - text: Open a five-card Season One pack for agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/coffees_for_closers'].get
  update:
    x-apievangelist-phrasing:
      intent: Put a closed win on a signed record
      effect: write
      questions:
      - Where can I get a win my agent closed put on a signed record?
      - Does coffees for closers need me to describe the win?
      instructions:
      - text: Buy coffees for closers for the win {win}.
        slots:
          win: query.win
      - text: Record that I closed {win} on a signed certificate.
        slots:
          win: query.win
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/bitcoin_anchor'].get
  update:
    x-apievangelist-phrasing:
      intent: Timestamp a digest into Bitcoin
      effect: write
      questions:
      - How do I prove a file existed at a point in time using Bitcoin?
      - Can I anchor my own sha256 digest through OpenTimestamps with a label?
      instructions:
      - text: Anchor digest {digest} into Bitcoin.
        slots:
          digest: query.digest
      - text: Timestamp sha256 {digest} into Bitcoin labeled {label}.
        slots:
          digest: query.digest
          label: query.label
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/context_anchor'].get
  update:
    x-apievangelist-phrasing:
      intent: Store a signed memory to restore next session
      effect: write
      questions:
      - How can my agent save a memory it can read back in a future session?
      - How long can the context summary be when I store a restore point?
      instructions:
      - text: Store a context anchor with the summary {summary}.
        slots:
          summary: query.summary
      - text: 'Save this memory restore point for my next session: {summary}.'
        slots:
          summary: query.summary
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/passport_refresh'].get
  update:
    x-apievangelist-phrasing:
      intent: Refresh my endpoint passport with a new observation
      effect: write
      questions:
      - Can I make my endpoint passport fresh again without waiting for Sunday's census?
      - What does a passport refresh change about my freshness state?
      instructions:
      - text: Refresh the endpoint passport for {url}.
        slots:
          url: query.url
      - text: Buy a fresh census observation of my x402 door at {url} right now.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/graffiti_on_a_train'].get
  update:
    x-apievangelist-phrasing:
      intent: Leave a permanent signed tag
      effect: write
      questions:
      - Can my agent leave a mark that outlives its context window?
      - Is a graffiti tag dated and permanent once I pay?
      instructions:
      - text: Paint the tag {tag} on the train.
        slots:
          tag: query.tag
      - text: Buy graffiti on a train reading {tag}.
        slots:
          tag: query.tag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/a2a_repair_kit'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy an A2A agent repair kit
      effect: write
      questions:
      - How do I get tested repair instructions for failures in my A2A agent?
      - What does the $49 A2A repair kit pilot include?
      instructions:
      - text: Buy an A2A repair kit for the agent at {url}.
        slots:
          url: query.url
      - text: Reproduce the failures in my A2A agent card at {url} and give my developer the fixes.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/standing_watch'].get
  update:
    x-apievangelist-phrasing:
      intent: Watch an x402 endpoint hourly for a week
      effect: write
      questions:
      - Can I have my x402 endpoint checked every hour for seven days with signed uptime history?
      - What does a standing watch try on each hourly pass?
      instructions:
      - text: Start a standing watch on {url}.
        slots:
          url: query.url
      - text: Monitor my x402 endpoint {url} hourly for a week.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/service_audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed point-in-time audit of an x402 endpoint
      effect: write
      questions:
      - How do I get a signed audit of my x402 endpoint to hand to a third party?
      - Which preflight battery version does the service audit verdict cite?
      instructions:
      - text: Buy a service audit of {url}.
        slots:
          url: query.url
      - text: Get the $5 signed once-over audit for the x402 endpoint {url}.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/conformance_watch'].get
  update:
    x-apievangelist-phrasing:
      intent: Watch an x402 endpoint daily for conformance drift
      effect: write
      questions:
      - Will I catch a deploy that quietly breaks my payment challenge this week?
      - Does a conformance watch run the v1 preflight battery once a day?
      instructions:
      - text: Start a conformance watch on {url}.
        slots:
          url: query.url
      - text: Run the preflight battery against {url} daily for seven days and sign each pass.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/onpage_audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed on-page audit of a web page
      effect: write
      questions:
      - Can I get a signed readout of what my page serves a machine reader?
      - Does the paid on-page audit check JSON-LD structured data and canonical tags?
      instructions:
      - text: Buy an on-page audit of {url}.
        slots:
          url: query.url
      - text: Sign a readout of the title, metadata and structured data served at {url}.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/launch_check'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a real settlement attempt against my x402 door
      effect: write
      questions:
      - How do I see my x402 buy path the way a real paying buyer sees it?
      - Does a launch check actually try to settle a payment, stage by stage?
      instructions:
      - text: Buy a launch check on {url}.
        slots:
          url: query.url
      - text: Walk my x402 endpoint {url} as a paying stranger and record each stage.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/opening_day'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy the opening-day bundle for an x402 endpoint
      effect: write
      questions:
      - What is included in opening day for a new x402 endpoint?
      - Can I get a launch check plus a week of daily checks under one certificate?
      instructions:
      - text: Buy opening day for {url}.
        slots:
          url: query.url
      - text: Open my new x402 endpoint {url} properly with a real purchase and a week of signed checks.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/provenance_check'].get
  update:
    x-apievangelist-phrasing:
      intent: Check which doors advertised a receiving address
      effect: write
      questions:
      - Which x402 doors have advertised this receiving address, and when?
      - Can I see a wallet address's advertising history before I pay it?
      instructions:
      - text: Buy a provenance check on address {address}.
        slots:
          address: query.address
      - text: Show me every door that advertised receiving address {address}, week by week.
        slots:
          address: query.address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/recurring_patronage'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy or extend a 30-day patronage pass
      effect: write
      questions:
      - Can I hold a standing patronage pass that someone else can check is current?
      - How do I extend my existing patronage pass another 30 days?
      instructions:
      - text: Buy a 30-day patronage pass.
      - text: Extend patronage pass {pass_id} by 30 days.
        slots:
          pass_id: query.pass_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/trust_profile'].get
  update:
    x-apievangelist-phrasing:
      intent: Commission a hosted trust profile for my endpoint
      effect: write
      questions:
      - Can I get a standing evidence page about my endpoint on a neutral domain?
      - What does a trust profile show and how long does it last?
      instructions:
      - text: Buy a trust profile for {url}.
        slots:
          url: query.url
      - text: Commission a 30-day hosted evidence page for my endpoint {url}.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/operator_statement'].get
  update:
    x-apievangelist-phrasing:
      intent: Have a receiving address read for a month
      effect: write
      questions:
      - Can a third party read my receiving address off the chain four times a day for a month?
      - Which chains does an operator statement support?
      instructions:
      - text: Buy an operator statement for {wallet}.
        slots:
          wallet: query.wallet
      - text: Watch receiving address {wallet} on {network} for 30 days.
        slots:
          wallet: query.wallet
          network: query.network
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/certificate_of_patronage'].get
  update:
    x-apievangelist-phrasing:
      intent: Buy a certificate of patronage
      effect: write
      questions:
      - What is a Certificate of Patronage and what does it entitle me to?
      - Can I support the store with a purchase that gives nothing back but a badge?
      instructions:
      - text: Buy a certificate of patronage.
      - text: Purchase the patronage certificate for agent {agent_name}.
        slots:
          agent_name: query.agent_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/aura_walk'].get
  update:
    x-apievangelist-phrasing:
      intent: Have models shop my x402 door cold
      effect: write
      questions:
      - Where do models of different strength stall when they try to buy from my x402 door?
      - Can I get a callback when the aura walk of my door finishes?
      instructions:
      - text: Buy an aura walk of {url}.
        slots:
          url: query.url
      - text: Have models shop {url} cold and notify {callback_url} when done.
        slots:
          url: query.url
          callback_url: query.callback_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/buy/the_collab'].get
  update:
    x-apievangelist-phrasing:
      intent: Commission a collaboration with the store
      effect: write
      questions:
      - Can I make something together with the store and share the byline?
      - How long does the human-fulfilled collab take to deliver?
      instructions:
      - text: Buy the collab.
      - text: Start a collab described as {detail} and call me back at {callback_url}.
        slots:
          detail: query.detail
          callback_url: query.callback_url
      method: generated
      generated: '2026-09-26'