API Evangelist conversational phrasing for Delx Agent Operations Protocol A2a API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Delx Agent Operations Protocol A2a API
  version: 1.0.0
extends: openapi/delx-ai-a2a-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['/v1/a2a'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an A2A JSON-RPC message to the Delx agent
      effect: write
      questions:
      - How do I send a JSON-RPC message/send call to Delx over the A2A protocol?
      - Can my agent post a heartbeat through the A2A endpoint?
      - Which request fields does an agent-to-agent message need, like jsonrpc, id and method?
      instructions:
      - text: Send an A2A JSON-RPC call with method {method} and request id {id}.
        slots:
          method: requestBody.method
          id: requestBody.id
      - text: Call A2A method {method} with params {params} using JSON-RPC version {jsonrpc}.
        slots:
          method: requestBody.method
          params: requestBody.params
          jsonrpc: requestBody.jsonrpc
      - text: Post a heartbeat to the agent over A2A with request id {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/a2a/methods'].get
  update:
    x-apievangelist-phrasing:
      intent: List the available A2A methods
      effect: read
      questions:
      - What methods does the A2A endpoint support?
      - Where can I find the discovery document describing every agent-to-agent method?
      instructions:
      - text: Fetch the A2A method discovery document.
      - text: Show me which JSON-RPC methods I can call over A2A.
      method: generated
      generated: '2026-09-26'