a2a-jsonrpc-transport

A2A JSON-RPC 2.0 Transport

Before writing code

Fetch live docs:

1. Fetch https://a2a-protocol.org/latest/specification/ for the transport layer section
2. Web-search site:github.com a2aproject A2A JSON-RPC transport for transport protocol details
3. Fetch https://www.jsonrpc.org/specification for the JSON-RPC 2.0 base specification
4. Fetch SDK docs for transport-level classes and middleware

Conceptual Architecture

Why JSON-RPC 2.0

A2A uses JSON-RPC 2.0 as its transport protocol because:

• Simple — Lightweight request/response format
• Standard — Well-established protocol with broad tooling support
• Language-agnostic — Works with any language that handles JSON over HTTP
• Extensible — Custom methods without changing the protocol

Request Format

Every A2A request is a JSON-RPC 2.0 request:

{
  "jsonrpc": "2.0",
  "method": "message/send",
  "id": "unique-request-id",
  "params": { ... }
}

• jsonrpc — Always "2.0"
• method — The A2A method name (e.g., message/send, tasks/get)
• id — Client-generated unique ID for matching responses
• params — Method-specific parameters (object)

Response Format

Success:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "result": { ... }
}

Error:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "error": {
    "code": -32600,
    "message": "Invalid Request",
    "data": { ... }
  }
}

HTTP Details

• Method: All A2A requests use HTTP POST
• URL: The agent's endpoint URL (from the Agent Card)
• Content-Type: application/json for regular requests
• Response Content-Type: application/json for message/send, text/event-stream for message/stream
• HTTP Status: Typically 200 OK — errors are in the JSON-RPC response body, not HTTP status codes

A2A Methods

Method	Direction	Purpose
message/send	Client → Server	Send message, get synchronous response
message/stream	Client → Server	Send message, get SSE stream
tasks/get	Client → Server	Retrieve task by ID
tasks/cancel	Client → Server	Cancel a task
tasks/resubscribe	Client → Server	Re-subscribe to task's SSE stream
tasks/pushNotificationConfig/set	Client → Server	Register push notification
tasks/pushNotificationConfig/get	Client → Server	Get notification config
tasks/pushNotificationConfig/list	Client → Server	List notification configs
tasks/pushNotificationConfig/delete	Client → Server	Delete notification config
agent/authenticatedExtendedCard	Client → Server	Get extended Agent Card