# a2aproject/a2a architecture

> Architecture diagram of the GitHub repository a2aproject/a2a, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/a2aproject/a2a
- Repository: https://github.com/a2aproject/a2a
- Video tour (about a minute): https://gitdiagram.com/a2aproject/a2a/video

## Overview

A2A is a protocol specification for communication between otherwise opaque agent applications, rather than a server implementation. The principal workflow is agent discovery through Agent Cards, followed by task-oriented communication using standardized requests and responses; interactions can be synchronous, streamed, or asynchronous. The sampled source is a partial protobuf excerpt, so it supports the service and schema nodes but does not expose all RPC definitions or implementation behavior. Other capability relationships below are documented by the README, not verified against runtime code.

Main entry points: [`specification/a2a.proto`](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto) (A2A service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["Protocol contract"]
  node_service["A2A service<br/>[a2a.proto]"]
  node_transport["Protocol transports<br/>[a2a.proto]"]
end

subgraph group_interaction["Agent interaction"]
  node_discovery["Agent discovery<br/>[a2a.proto]"]
  node_tasks["Task lifecycle<br/>[a2a.proto]"]
  node_messages["Messages and content<br/>[a2a.proto]"]
  node_streaming["Streaming and async<br/>[a2a.proto]"]
  node_push["Push notifications<br/>[a2a.proto]"]
end

subgraph group_governance["Security and extensibility"]
  node_authentication["Authentication<br/>[a2a.proto]"]
  node_extensions["Protocol extensions<br/>[a2a.proto]"]
  node_observability["Observability"]
end

node_client(("Agent client"))

node_client -->|"sends requests"| node_service
node_service -->|"exposes cards"| node_discovery
node_client -->|"discovers agents"| node_discovery
node_client -->|"manages tasks"| node_tasks
node_client -->|"exchanges content"| node_messages
node_service -->|"uses bindings"| node_transport
node_client -->|"receives updates"| node_streaming
node_service -->|"supports notifications"| node_push
node_service -->|"supports security"| node_authentication
node_client -.->|"negotiates extensions"| node_extensions
node_service -.->|"supports observability"| node_observability

click node_service "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_transport "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_discovery "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_tasks "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_messages "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_streaming "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_push "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_authentication "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"
click node_extensions "https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_service,node_transport,node_client toneBlue
class node_discovery,node_tasks,node_messages,node_streaming,node_push toneAmber
class node_authentication,node_extensions,node_observability toneMint
```

## Components

### Protocol contract

- [A2A service](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Protocol transports](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`

### Agent interaction

- [Agent discovery](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Task lifecycle](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Messages and content](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Streaming and async](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Push notifications](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`

### Security and extensibility

- [Authentication](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- [Protocol extensions](https://github.com/a2aproject/a2a/blob/main/specification/a2a.proto): `specification/a2a.proto`
- **Observability**

### Other components

- **Agent client**

## Connections

- Agent client → A2A service: sends requests (evidence: `README.md`)
- A2A service → Agent discovery: exposes cards (evidence: `specification/a2a.proto`)
- Agent client → Agent discovery: discovers agents (evidence: `README.md`)
- Agent client → Task lifecycle: manages tasks (evidence: `README.md`)
- Agent client → Messages and content: exchanges content (evidence: `README.md`)
- A2A service → Protocol transports: uses bindings (evidence: `README.md`)
- Agent client → Streaming and async: receives updates (evidence: `README.md`)
- A2A service → Push notifications: supports notifications (evidence: `README.md`)
- A2A service → Authentication: supports security (evidence: `README.md`)
- Agent client → Protocol extensions: negotiates extensions (evidence: `README.md`)
- A2A service → Observability: supports observability (evidence: `README.md`)
