# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hilt So Agent Commerce API
  version: 1.0.0
extends: openapi/hilt-so-agent-commerce-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: 4
- target: $.paths['/mcp'].post
  update:
    x-apievangelist-phrasing:
      intent: Call the agent gateway over MCP
      effect: write
      questions:
      - Is there an MCP endpoint my agent can use for the catalog, quotes and plan activation?
      - Can an agent activate an API plan paid in Solana USDC via MCP tools?
      instructions:
      - text: Connect my agent to the Hilt MCP gateway.
      - text: Call the MCP gateway to get a quote from the catalog.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/.well-known/agent-card.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the A2A agent card
      effect: read
      questions:
      - Where is the A2A Agent Card for the Hilt Pay agent published?
      - What skills does the Hilt Pay agent advertise at the current agent-card path?
      instructions:
      - text: Fetch the agent card from /.well-known/agent-card.json.
      - text: Show me the current A2A agent card.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/.well-known/agent.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the A2A agent card from the legacy path
      effect: read
      questions:
      - My registry still looks for agent.json - is the card served there?
      - Does the older /.well-known/agent.json discovery path still work?
      instructions:
      - text: Fetch the agent card from the legacy /.well-known/agent.json path.
      - text: Load the compatibility copy of the agent card.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/a2a/jsonrpc'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a JSON-RPC message to the A2A agent
      effect: write
      questions:
      - How do I talk to the Hilt Pay agent over A2A JSON-RPC?
      - Can my agent send tasks to the payments agent using the A2A protocol?
      instructions:
      - text: Send a JSON-RPC request to the Hilt Pay A2A agent.
      - text: Message the payments agent over A2A.
      method: generated
      generated: '2026-09-26'