Skip to main content

A2A v1.0.1 · executable specification

The A2A protocol,
as a specification that runs.

a2a holds the A2A (Agent2Agent) protocol v1.0.1 as an ESS specification: the task lifecycle, messages, push-notification configs and the extended Agent Card. OpenAPI, AsyncAPI and JSON Schema documents and a Rust crate are generated from it, and task check fails when any of them drifts. Each rule ESS cannot hold yet is marked UNMAPPED beside the place it belongs.

Download the documents Read the documentation Source (opens in new tab)

ESS specification · OpenAPI, AsyncAPI, JSON Schema · Rust · Apache-2.0

01 / What is here

One specification, the documents generated from it.

Every page under Reference and every file under Downloads is generated from the repository by a2a-docs, and task check fails when one of them differs from what the repository generates.

  1. The specification

    Shipped

    Domains a2a.tasks and a2a.discovery, their commands, events and views, the component a2a-agent and the system graph, generated from ess/.

  2. Downloads

    Shipped

    a2a.proto as upstream tagged it, OpenAPI of A2A's HTTP+JSON binding and of the specification, AsyncAPI of its events, and its JSON Schemas as one document, with SHA256SUMS.

  3. HTTP+JSON routes

    Shipped

    Which of A2A's routes the specification serves at their path, and the reason for each one it cannot.

  4. UNMAPPED markers

    Shipped

    Every rule of A2A the specification does not hold, linked to the comment that quotes the source and names the ESS refusal.

  5. Server, client and test kit

    Planned

    Hand-written Rust on top of the generated crate. The repository has checks only today.

02 / Built with