556 Commits

Author SHA1 Message Date
Yaroslav
757f0ec6d0
fix(spec): recent transcoding-related error changes (#1627)
Fix error code mappings table so that http codes correspond to
[`google.rpc.Code`](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto#L32)-defined
mappings.

Undo changes made in https://github.com/a2aproject/A2A/pull/1600 to
jsonrpc error handling section. The changes made were meant to address
http-grpc transcoding compatibility. I don't see a convincing reason for
forcing jsonrpc error data format, so I assume JSONRPC section was
updated by mistake.

Fixes https://github.com/a2aproject/A2A/issues/1596

---------

Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Mike Smith <mikeas@google.com>
2026-04-14 15:37:40 -04:00
Amye Scavarda Perrin
3947dacff8
docs(GOVERNANCE.md): How to add new TSC members (#1571)
1) How to add new TSC members

---------

Signed-off-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
2026-04-09 13:23:55 -04:00
Holt Skinner
8dda73b3b4
docs: Add Rust SDK to list of official SDKs (#1729)
- Change table header to include repository instead of stability (all
are currently stable)

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Sampath Kumar <sam1990kumar@gmail.com>
2026-04-09 08:38:46 +00:00
Iva Sokolaj
b9f03d4c96
docs: update code snippet markers to match refactored sample identifiers (#1732)
Fixes:
https://a2a-protocol.org/latest/tutorials/python/6-interact-with-server/#understanding-the-client-code

Sample update: #508
2026-04-09 09:55:38 +02:00
dependabot[bot]
f1b45c522a
chore(deps): bump github-community-projects/issue-metrics from 3 to 4 in the github-actions group across 1 directory (#1707)
Bumps the github-actions group with 1 update in the / directory:
[github-community-projects/issue-metrics](https://github.com/github-community-projects/issue-metrics).

Updates `github-community-projects/issue-metrics` from 3 to 4
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/github-community-projects/issue-metrics/releases">github-community-projects/issue-metrics's
releases</a>.</em></p>
<blockquote>
<h2>v4.0.0</h2>
<h1>Changelog</h1>
<h2>🧰 Maintenance</h2>
<ul>
<li>build: update org name from github to github-community-projects <a
href="https://github.com/zkoppert"><code>@​zkoppert</code></a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/684">#684</a>)</li>
<li>chore(deps): bump pylint from 4.0.4 to 4.0.5 in the dependencies
group @<a href="https://github.com/apps/dependabot">dependabot[bot]</a>
(<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/681">#681</a>)</li>
<li>chore(deps): bump python from <code>486b809</code> to
<code>6a27522</code> @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/680">#680</a>)</li>
<li>ci: Update contributors action reference after repo transfer <a
href="https://github.com/zkoppert"><code>@​zkoppert</code></a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/677">#677</a>)</li>
<li>chore(deps): bump actions/stale from 10.1.1 to 10.2.0 in the
dependencies group @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/676">#676</a>)</li>
<li>chore(deps): bump python from <code>3955a7d</code> to
<code>486b809</code> @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/675">#675</a>)</li>
<li>chore(deps): bump black from 25.12.0 to 26.1.0 @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/673">#673</a>)</li>
<li>chore(deps): bump python from <code>2751cbe</code> to
<code>3955a7d</code> @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/664">#664</a>)</li>
<li>chore(deps): bump numpy from 2.4.1 to 2.4.2 in the dependencies
group @<a href="https://github.com/apps/dependabot">dependabot[bot]</a>
(<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/672">#672</a>)</li>
<li>chore(deps): bump numpy from 2.4.0 to 2.4.1 in the dependencies
group @<a href="https://github.com/apps/dependabot">dependabot[bot]</a>
(<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/666">#666</a>)</li>
<li>chore(deps): bump types-requests from 2.32.4.20250913 to
2.32.4.20260107 @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/667">#667</a>)</li>
<li>chore(deps): bump the dependencies group across 1 directory with 2
updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/671">#671</a>)</li>
<li>chore(deps): bump numpy from 2.3.5 to 2.4.0 in the dependencies
group @<a href="https://github.com/apps/dependabot">dependabot[bot]</a>
(<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/660">#660</a>)</li>
<li>chore(deps): bump the dependencies group with 6 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/661">#661</a>)</li>
<li>chore(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/659">#659</a>)</li>
<li>chore(deps): bump github/contributors from 1.7.7 to 1.7.8 in the
dependencies group @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/658">#658</a>)</li>
<li>chore(deps): bump mypy from 1.19.0 to 1.19.1 in the dependencies
group @<a href="https://github.com/apps/dependabot">dependabot[bot]</a>
(<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/657">#657</a>)</li>
</ul>
<p>See details of <a
href="https://github.com/github-community-projects/issue-metrics/compare/v3.25.5...v4.0.0">all
code changes</a> since previous release</p>
<h2>v3.25.5</h2>
<h1>Changelog</h1>
<h2>🧰 Maintenance</h2>
<ul>
<li>chore(deps): bump the dependencies group with 2 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/655">#655</a>)</li>
<li>chore(deps): bump the dependencies group with 2 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/654">#654</a>)</li>
<li>chore(deps): bump python from <code>b823ded</code> to
<code>2751cbe</code> @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/653">#653</a>)</li>
<li>chore(deps): bump python from <code>0aecac0</code> to
<code>b823ded</code> @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/648">#648</a>)</li>
</ul>
<p>See details of <a
href="https://github.com/github/issue-metrics/compare/v3.25.4...v3.25.5">all
code changes</a> since previous release</p>
<h2>v3.25.4</h2>
<h1>Changelog</h1>
<h2>🧰 Maintenance</h2>
<ul>
<li>chore(deps): bump the dependencies group with 4 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/644">#644</a>)</li>
<li>chore(deps): bump the dependencies group with 2 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/645">#645</a>)</li>
</ul>
<p>See details of <a
href="https://github.com/github/issue-metrics/compare/v3.25.3...v3.25.4">all
code changes</a> since previous release</p>
<h2>v3.25.3</h2>
<h1>Changelog</h1>
<h2>🧰 Maintenance</h2>
<ul>
<li>chore(deps): bump actions/checkout from 5.0.0 to 6.0.0 @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/639">#639</a>)</li>
<li>chore(deps): bump the dependencies group with 2 updates @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/638">#638</a>)</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="7bee6e6914"><code>7bee6e6</code></a>
chore(deps): bump cryptography from 46.0.5 to 46.0.6 (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/716">#716</a>)</li>
<li><a
href="ff28a0cbff"><code>ff28a0c</code></a>
Merge pull request <a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/715">#715</a>
from github-community-projects/fix/test-time-to-first...</li>
<li><a
href="7a3a883da1"><code>7a3a883</code></a>
fix: correct TypeError test to actually exercise exception handler</li>
<li><a
href="8bd2f25bef"><code>8bd2f25</code></a>
Merge pull request <a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/683">#683</a>
from meoyushi/feat-time-to-first-review</li>
<li><a
href="18503f1d94"><code>18503f1</code></a>
chore(deps): bump requests from 2.32.5 to 2.33.0 (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/712">#712</a>)</li>
<li><a
href="87b910fc69"><code>87b910f</code></a>
chore(deps): bump python from <code>584e89d</code> to
<code>fb83750</code> (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/710">#710</a>)</li>
<li><a
href="034369d98e"><code>034369d</code></a>
chore(deps): bump astral-sh/setup-uv in the dependencies group (<a
href="https://redirect.github.com/redirect.github.community-projects/issue-metrics/issues/711">#711</a>)</li>
<li><a
href="be94607e29"><code>be94607</code></a>
doc: mdformat for README.md</li>
<li><a
href="676b5cfd25"><code>676b5cf</code></a>
doc: README.md edited for time_to_first_review metric</li>
<li><a
href="10383509e0"><code>1038350</code></a>
doc: README.md edited for time_to_first_review metric</li>
<li>Additional commits viewable in <a
href="https://github.com/github-community-projects/issue-metrics/compare/v3...v4">compare
view</a></li>
</ul>
</details>
<br />

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-04-08 10:49:33 -05:00
Holt Skinner
a40261c464
docs: Add local build steps to Contributing Guide (#1726) 2026-04-07 14:50:14 -05:00
Amye Scavarda Perrin
43bddf8cc1
[Feat]: New logos + mascot (#1719)
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-04-07 13:09:37 -04:00
Sampath Kumar
3c0e23e996
docs: fix table duplication in A2A Specification document (#1704) 2026-04-07 10:13:34 -05:00
Sam Betts
66df070988
docs: Add custom protocol bindings documentation (#1619)
## Summary

- Adds `docs/topics/custom-protocol-bindings.md`, a dedicated page
documenting custom protocol bindings as a concept distinct from
extensions; covers declaration in the Agent Card, specification
requirements, key areas to address (data type mappings, service
parameters, error mapping, streaming, authentication), and
interoperability testing
- Adds `docs/topics/extension-and-binding-governance.md`, merging the
governance content previously in `extensions.md` with the equivalent
custom protocol binding governance; deduplicates the tiers section into
a single section with a naming table; notes that SDKs SHOULD implement
official custom protocol bindings vs MAY for extensions
- Adds spec section 5.8 defining URI-based custom binding identification
as a SHOULD requirement and updates the section 12.7 Agent Card example
accordingly
- Replaces the verbose inline governance sections in `extensions.md` and
`custom-protocol-bindings.md` with short summaries linking to the new
governance page
- Adds Custom Protocol Bindings and Extension & Binding Governance to
the mkdocs.yml nav

---------

Signed-off-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-04-07 13:31:18 +02:00
Sam Betts
74c7c62286
fix: pin check-spelling action to v0.0.26 (#1722)
# Description

- [ ] Follow the [`CONTRIBUTING`
Guide](https://github.com/a2aproject/A2A/blob/main/CONTRIBUTING.md).
- [ ] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- [ ] Ensure the tests and linter pass (Run `nox -s format` from the
repository root to format)
- [ ] Appropriate docs were updated (if necessary)

Pins the `check-spelling/check-spelling` action to `v0.0.26` to resolve
the unsafe workflow configuration error (exit code 5) that was blocking
all PRs from passing the Check Spelling CI gate.

Fixes #1710 🦕

Signed-off-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
2026-04-07 13:07:06 +02:00
Zack Koppert
c1169f4572
fix: update OSPO action references to canonical org path (#1705)
Updates GitHub Actions workflow references from the legacy `github/` org
path to the canonical `github-community-projects/` path.

The following OSPO actions have been transferred to the
`github-community-projects` organization:

| Legacy path | Canonical path |
|---|---|
| `github/issue-metrics` | `github-community-projects/issue-metrics` |

While GitHub's repo redirect ensures the old paths still work today,
updating to the canonical path avoids depending on the redirect and
ensures long-term stability.

**No functional changes** - the same action versions are referenced.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-31 13:42:10 -07:00
alan blount
f991a08f2c
docs: add Community SDKs (#1698)
## Summary

Add a Community SDKs section to the Community Hub page listing
community-maintained A2A SDK implementations for languages not covered
by official SDKs.

Fixes #1602

## Changes

- **Updated: `docs/community.md`** — inline SDK directory section with
listings and submission requirements
- **Updated: `mkdocs.yml`** — cleaned up nav
- **Updated: `.github/actions/spelling/allow.txt`** — added GitHub
usernames

## Initial Listings

| Language | Repository | Package | Spec Version |
|----------|-----------|---------|-------------|
| 🦀 Rust | [tomtom215/a2a-rust](https://github.com/tomtom215/a2a-rust) |
[crates.io](https://crates.io/crates/a2a-protocol-sdk) | 1.0.0 |
| 🦀 Rust | [EmilLindfors/a2a-rs](https://github.com/EmilLindfors/a2a-rs)
| [crates.io](https://crates.io/crates/a2a-rs) | 0.3.0 |
| 🍎 Swift |
[tolgaki/a2a-client-swift](https://github.com/tolgaki/a2a-client-swift)
| SPM | 1.0.0 |
| 💧 Elixir |
[actioncard/a2a-elixir](https://github.com/actioncard/a2a-elixir) |
[hex.pm](https://hex.pm/packages/a2a) | 0.2.0 |

## Context

Community SDKs are emerging (see
[#1638](https://github.com/a2aproject/A2A/issues/1638) for the Rust
SDK), but there was no place in the docs for users to discover them.
Rather than a standalone page, these are inlined as a section on the
Community Hub for better discoverability.

---------

Co-authored-by: Zaf (AI Assistant) <zaf@0-a.org>
2026-03-31 09:43:27 -07:00
petterlindstrom79
5ac9d2c7d7
docs: add Strale to partners list (#1702)
Adds [Strale](https://strale.dev) to the A2A partners list.

Strale is an API capability marketplace for AI agents with a live A2A
implementation:

- **Agent Card**: https://api.strale.io/.well-known/agent-card.json
- **A2A endpoint**: `POST https://api.strale.io/a2a` (JSON-RPC:
`message/send`, `tasks/get`)
- **273 skills** across compliance, company data (27 countries),
financial validation, Web3/DeFi, and developer tools
- **Link header** on all responses: `Link:
</.well-known/agent-card.json>; rel="agent-card"`

Also accessible via MCP (Streamable HTTP), REST API, and x402 (USDC
micropayments on Base).
2026-03-30 07:35:29 -07:00
ivoshemi-sys
72d1459ddb
Add OIXA Protocol to partners list (#1692)
## Summary

[OIXA Protocol](https://oixa.io) is a live open protocol where AI agents
hire and pay other AI agents autonomously — built on A2A for agent
communication, with economic guarantees on Base Mainnet.

## How OIXA uses A2A

OIXA builds directly on A2A as the communication layer for agent
discovery and task coordination. It publishes a standard A2A agent card:

```
http://64.23.235.34:8000/.well-known/agent.json
```

**Protocol stack:**
- **COMMS:** A2A + MCP — agent discovery and task protocol
- **PAYMENT:** x402 Protocol — autonomous HTTP payments
- **FUNDS:** Base Mainnet + USDC — trustless on-chain escrow
- **REGISTRY:** ERC-8004 — on-chain agent identity

## What OIXA adds on top of A2A

A2A defines *how* agents communicate. OIXA defines *how they transact*
when that communication leads to work that should exchange value:

- Reverse auction discovery: agents bid to complete tasks (lowest bid
wins)
- On-chain USDC escrow: funds lock at bid acceptance, release
automatically on verified delivery
- Cryptographic output verification: not just delivery confirmation but
quality verification
- Stake-based anti-Sybil: 20% stake per bid makes economic attacks
impossible
- On-chain reputation: every completed A2A transaction builds a
verifiable score

## Links

- Site: https://oixa.io
- GitHub: https://github.com/ivoshemi-sys/oixa-protocol
- SDK: `pip install oixa-protocol` (LangChain, CrewAI, AutoGen,
Haystack, MCP)
- Live API: http://64.23.235.34:8000/docs
- A2A agent card: http://64.23.235.34:8000/.well-known/agent.json

Co-authored-by: Openclaw <Openclaw@Mac-mini-de-Ivan.local>
2026-03-27 09:37:45 -07:00
Iva Sokolaj
32a7d3a0bd
docs: update python tutorial for a2a-sdk v1.0.0-alpha.0 (#1678)
Issue: #1679

# Description

[a2a-samples/python](https://github.com/a2aproject/a2a-samples/tree/main/samples/python)
is being updated to use the new `v1.0`:
[samples-#462](https://github.com/a2aproject/a2a-samples/issues/462). We
are looking to merge [update helloworld sample to
v1.0-alpha](https://github.com/a2aproject/a2a-samples/pull/474) and
consequently need to update python tutorial in A2A as it references the
`helloworld sample`.

# Key Changes
- **Agent Skills & Card** (3-agent-skills-and-card.md): Updated the docs
to match the new AgentCard schema. Replaced the legacy `url` property
with `icon_url`, documented the new `supported_interfaces` field for
protocol bindings, and added mentions of the extended_agent_card
capability.
- **HelloWorldAgentExecutor logic** (4-agent-executor.md): Rewrote the
walkthrough for the execute method to reflect the modern event-driven
approach and to make the difference between non-streaming and streaming
more clear. It now explicitly describes enqueueing Task,
TaskStatusUpdateEvent (with `TASK_STATE_WORKING`),
TaskArtifactUpdateEvent, and TaskStatusUpdateEvent (with
`TASK_STATE_COMPLETED`) instead of single string messages.
- **Server Setup** (5-start-server.md): Replaced `0.0.0.0` with
`127.0.0.1` in the host binding tutorial and log examples to enforce
safer local testing defaults.
- **Client Interaction** (6-interact-with-server.md): 
- Replaced MessageSendParams dictionaries with native protobuf
`Message/Part/Role` construction.
- Replaced direct A2ACardResolver instantiation with the new
`ClientFactory` approach.
- Unified the documentation around `send_message` (which now handles
streams dynamically based on `config` and agent capabilities) and
updated expected log outputs.
2026-03-26 13:50:49 +01:00
Amye Scavarda Perrin
7b900e77be
Update CODEOWNERS (#1644)
TSC is the reviewing body for this project!
2026-03-16 11:25:06 -07:00
Alex
3c1a5ff473
docs: add WritBase to partners list (#1634)
Closes #1636

Adds [WritBase](https://github.com/Writbase/writbase) to the A2A
partners list.

WritBase is an MCP-native task management control plane for AI agent
fleets — Postgres-backed, multi-tenant, with full provenance tracking.
It includes bidirectional A2A↔WritBase status mapping alignment and
supports inter-agent task delegation with assignment tracking and
delegation safety.
2026-03-16 11:18:55 -07:00
Amye Scavarda Perrin
7df7685561
Update main.html
Reverting to previous announcement.
2026-03-12 11:59:00 -07:00
Amye Scavarda Perrin
b750332f4c
Update main.html
Dropping the override.
2026-03-12 11:25:32 -07:00
Amye Scavarda Perrin
625146ede8
Update main.html (#1623) 2026-03-12 11:18:16 -07:00
Holt Skinner
f86c799f09 docs: Update TOC to include 1.0 Blog Post 2026-03-12 12:17:47 -05:00
Darrel
4f77f1bdd0
docs: Blog post announcing V1.0 (#1621)
Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
Co-authored-by: ToddSegal <10716715+ToddSegal@users.noreply.github.com>
2026-03-12 17:02:05 +00:00
Holt Skinner
ee335737c9
ci(docs): Update docs workflow to allow manual updates for versions (#1622) 2026-03-12 11:55:05 -05:00
Holt Skinner
6845a87b50
docs: Update Specification.md for 1.0.0 from release candidate (#1620) 2026-03-12 11:47:56 -05:00
Agent2Agent (A2A) Bot
1736957556
chore(main): release 1.0.0 (#1221)
🤖 I have created a release *beep* *boop*
---


## [1.0.0](https://github.com/a2aproject/A2A/compare/v0.3.0...v1.0.0)
(2026-03-12)


### ⚠ BREAKING CHANGES

* **spec:** Combine `TaskPushNotificationConfig` and
`PushNotificationConfig`
([#1500](https://github.com/a2aproject/A2A/issues/1500))
* **spec:** remove duplicated ID from the create task push config
request ([#1487](https://github.com/a2aproject/A2A/issues/1487))
* **spec:** pluralize configs in `ListTaskPushNotificationConfigs`
([#1486](https://github.com/a2aproject/A2A/issues/1486))
* **spec:** Add LF prefix to the package.
([#1474](https://github.com/a2aproject/A2A/issues/1474))
* **spec:** Switch to non-complex IDs in requests
([#1389](https://github.com/a2aproject/A2A/issues/1389))
* **spec:** Standardize spelling of "canceled" to use American Spelling
throughout ([#1283](https://github.com/a2aproject/A2A/issues/1283))
* **spec:** Align enum format with ADR-001 ProtoJSON specification
([#1384](https://github.com/a2aproject/A2A/issues/1384))
* **spec:** Remove redundant `final` field from `TaskStatusUpdateEvent`
([#1308](https://github.com/a2aproject/A2A/issues/1308))
* **spec:** Move `extendedAgentCard` field to `AgentCapabilities`
([#1307](https://github.com/a2aproject/A2A/issues/1307))
* **spec:** Fixes for the last_updated_after field
([#1358](https://github.com/a2aproject/A2A/issues/1358))
* **spec:** modernize oauth 2.0 flows - remove implicit/password, add
device code / pkce
([#1303](https://github.com/a2aproject/A2A/issues/1303))
* **spec:** Make "message" field name consistent between protocol
bindings ([#1302](https://github.com/a2aproject/A2A/issues/1302))
* **spec:** Remove deprecated fields from a2a.proto for v1.0 release
([#1301](https://github.com/a2aproject/A2A/issues/1301))
* **spec:** Rename `supportsAuthenticatedExtendedCard` to
`supportsExtendedAgentCard`
([#1222](https://github.com/a2aproject/A2A/issues/1222))
* **spec:** Remove v1s from a2a url http bindings
* **spec:** Large refactor of specification to separate application
protocol definition from mapping to transports

### Features

* **spec:** Add `tasks/list` method with filtering and pagination to the
specification
([0a9f629](0a9f629e80))
* **spec:** modernize oauth 2.0 flows - remove implicit/password, add
device code / pkce
([#1303](https://github.com/a2aproject/A2A/issues/1303))
([525ff38](525ff38e5f))
* **spec:** Natively Support Multi-tenancy on gRPC through an additional
scope field on the request.
([#1195](https://github.com/a2aproject/A2A/issues/1195))
([cfbce32](cfbce32cb0)),
closes [#1148](https://github.com/a2aproject/A2A/issues/1148)
* **spec:** Provide ability for SDKs to be backwards compatible.
([#1401](https://github.com/a2aproject/A2A/issues/1401))
([227e249](227e2493c3))
* **spec:** Remove v1s from a2a url http bindings
([1bd263f](1bd263f537))


### Bug Fixes

* Add missing metadata field to Part message in gRPC specification
([#1019](https://github.com/a2aproject/A2A/issues/1019))
([b3b266d](b3b266d127)),
closes [#1005](https://github.com/a2aproject/A2A/issues/1005)
* Add name field to FilePart protobuf message
([#983](https://github.com/a2aproject/A2A/issues/983))
([2b7cb6f](2b7cb6f840)),
closes [#984](https://github.com/a2aproject/A2A/issues/984)
* Clarify blocking calls return on interrupted states
([#1403](https://github.com/a2aproject/A2A/issues/1403))
([0655ff3](0655ff324a))
* **doc:** Makes JSON-RPC SendMessage response clearer
([#1241](https://github.com/a2aproject/A2A/issues/1241))
([5792804](5792804372))
* **docs:** Clearer wording around context id.
([#1588](https://github.com/a2aproject/A2A/issues/1588))
([dec790a](dec790aa06))
* **grpc:** Fix inconsistent property name between gRPC and JSON-RPC in
Message object ([#1100](https://github.com/a2aproject/A2A/issues/1100))
([2a1f819](2a1f819aaa))
* **grpc:** missing field in gRPC spec - state_transition_history
([#1138](https://github.com/a2aproject/A2A/issues/1138))
([a2de798](a2de7981ca)),
closes [#1139](https://github.com/a2aproject/A2A/issues/1139)
* **grpc:** Update `CreateTaskPushNotificationConfig` endpoint to
`/v1/{parent=tasks/*/pushNotificationConfigs}`
([#979](https://github.com/a2aproject/A2A/issues/979))
([911f9b0](911f9b059c))
* **proto:** Add icon_url to a2a.proto
([#986](https://github.com/a2aproject/A2A/issues/986))
([17e7f62](17e7f62df9))
* **proto:** Adds metadata field to A2A DataPart proto
([#1004](https://github.com/a2aproject/A2A/issues/1004))
([a8b45dc](a8b45dcc42))
* Remove unimplemented state_transition_history capability field
([#1396](https://github.com/a2aproject/A2A/issues/1396))
([c768a44](c768a44da0)),
closes [#1228](https://github.com/a2aproject/A2A/issues/1228)
* Restore CreateTaskPushNotificationConfig method naming
([#1402](https://github.com/a2aproject/A2A/issues/1402))
([d14f410](d14f410711))
* Revert "chore(gRPC): Update a2a.proto to include metadata on
GetTaskRequest" ([#1000](https://github.com/a2aproject/A2A/issues/1000))
([e6b8c65](e6b8c654a8))
* Simplify Part message structure by flattening FilePart and DataPart
([#1411](https://github.com/a2aproject/A2A/issues/1411))
([bfae8f7](bfae8f7791))
* **spec:** Add LF prefix to the package.
([#1474](https://github.com/a2aproject/A2A/issues/1474))
([a54e809](a54e80904a))
* **spec:** add metadata to `CancelTaskRequest`
([#1485](https://github.com/a2aproject/A2A/issues/1485))
([c441b91](c441b910b6)),
closes [#1484](https://github.com/a2aproject/A2A/issues/1484)
* **spec:** Added clarification on timestamps in HTTP query params
([#1425](https://github.com/a2aproject/A2A/issues/1425))
([6292104](6292104e35))
* **spec:** Added clarifying text around messages and artifacts
([#1424](https://github.com/a2aproject/A2A/issues/1424))
([b03d141](b03d141aea))
* **spec:** Adjust field number for `ListTasksRequest.tenant` to prevent
missing number ([#1470](https://github.com/a2aproject/A2A/issues/1470))
([cd16c52](cd16c5276b))
* **spec:** Clarify contextId behavior when message is sent with taskId
but without contextId
([#1309](https://github.com/a2aproject/A2A/issues/1309))
([a336a5a](a336a5a484))
* **spec:** Clarify versioning strategy and client responsibilities in
protocol specification
([#1259](https://github.com/a2aproject/A2A/issues/1259))
([a4afeea](a4afeea788))
* **spec:** Fix/1251 clarify authentication scheme
([#1256](https://github.com/a2aproject/A2A/issues/1256))
([3e6c7db](3e6c7db907))
* **spec:** Fixes for the last_updated_after field
([#1358](https://github.com/a2aproject/A2A/issues/1358))
([0e204bf](0e204bf878))
* **spec:** Make "message" field name consistent between protocol
bindings ([#1302](https://github.com/a2aproject/A2A/issues/1302))
([1e5f462](1e5f462064)),
closes [#1230](https://github.com/a2aproject/A2A/issues/1230)
* **spec:** make `history_length` optional
([#1071](https://github.com/a2aproject/A2A/issues/1071))
([0572953](057295311b))
* **spec:** pluralize configs in `ListTaskPushNotificationConfigs`
([#1486](https://github.com/a2aproject/A2A/issues/1486))
([cf735cb](cf735cb870))
* **spec:** Remove config from binding.
([#1587](https://github.com/a2aproject/A2A/issues/1587))
([010b9cc](010b9cc936))
* **spec:** Remove deprecated fields from a2a.proto for v1.0 release
([#1301](https://github.com/a2aproject/A2A/issues/1301))
([60f83c3](60f83c3faa)),
closes [#1227](https://github.com/a2aproject/A2A/issues/1227)
* **spec:** remove duplicated ID from the create task push config
request ([#1487](https://github.com/a2aproject/A2A/issues/1487))
([393898d](393898dfee))
* **spec:** Remove metadata field from ListTasksRequest
([#1235](https://github.com/a2aproject/A2A/issues/1235))
([b6ef9ee](b6ef9eec55))
* **spec:** Remove reserved and fix tags ordering
([#1494](https://github.com/a2aproject/A2A/issues/1494))
([1997c9d](1997c9d630))
* **spec:** Rename `supportsAuthenticatedExtendedCard` to
`supportsExtendedAgentCard`
([#1222](https://github.com/a2aproject/A2A/issues/1222))
([c196824](c196824396)),
closes [#1215](https://github.com/a2aproject/A2A/issues/1215)
* **spec:** Standardize spelling of "canceled" to use American Spelling
throughout ([#1283](https://github.com/a2aproject/A2A/issues/1283))
([4dd980f](4dd980f6ff))
* **spec:** Suggest Unique Identifier fields to be UUID
([#966](https://github.com/a2aproject/A2A/issues/966))
([00cf76e](00cf76e7bb))
* **spec:** Switch to non-complex IDs in requests
([#1389](https://github.com/a2aproject/A2A/issues/1389))
([2596c1c](2596c1c5e0)),
closes [#1390](https://github.com/a2aproject/A2A/issues/1390)
* **spec:** Update security schemes example
([#1364](https://github.com/a2aproject/A2A/issues/1364))
([f9a8f5b](f9a8f5b85d))
* Update the Java tutorials and descriptions
([#1181](https://github.com/a2aproject/A2A/issues/1181))
([202aa06](202aa069e6))


### Documentation

* **spec:** Align enum format with ADR-001 ProtoJSON specification
([#1384](https://github.com/a2aproject/A2A/issues/1384))
([810eaa1](810eaa1c6e)),
closes [#1344](https://github.com/a2aproject/A2A/issues/1344)


### Code Refactoring

* **spec:** Combine `TaskPushNotificationConfig` and
`PushNotificationConfig`
([#1500](https://github.com/a2aproject/A2A/issues/1500))
([d1ed0da](d1ed0da587))
* **spec:** Large refactor of specification to separate application
protocol definition from mapping to transports
([b078419](b078419954))
* **spec:** Move `extendedAgentCard` field to `AgentCapabilities`
([#1307](https://github.com/a2aproject/A2A/issues/1307))
([40d6286](40d6286fbe))
* **spec:** Remove redundant `final` field from `TaskStatusUpdateEvent`
([#1308](https://github.com/a2aproject/A2A/issues/1308))
([5b101cc](5b101cce0f))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
v1.0.0
2026-03-12 12:34:00 -04:00
Copilot
087604615d
docs: fix inconsistent HTTP method for list tasks examples in specification (#1613)
Fixes #1612

Section 6.5 examples used `POST /tasks/list` with a JSON body,
contradicting section 11.3.2 which correctly defines list tasks as `GET
/tasks` with query parameters.

## Changes

- **`docs/specification.md` — Section 6.5 (Task Listing and
Management):** Updated all four HTTP examples to use `GET /tasks` with
query parameters instead of `POST /tasks/list` with a request body:

  | Example | Before | After |
  |---|---|---|
| All tasks from a specific context | `POST /tasks/list` + JSON body |
`GET /tasks?contextId=...&pageSize=10&historyLength=3` |
| All working tasks across all contexts | `POST /tasks/list` + JSON body
| `GET /tasks?status=working&pageSize=20` |
| Pagination | `POST /tasks/list` + JSON body | `GET
/tasks?contextId=...&pageSize=10&pageToken=...` |
| Validation error | `POST /tasks/list` + JSON body | `GET
/tasks?pageSize=150&historyLength=-5&status=running` |

Enum values in query parameters now use the short form (e.g.,
`status=working`) per the field type handling rules already defined in
section 11.5.

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/a2aproject/A2A/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: darrelmiller <447694+darrelmiller@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-03-12 11:30:50 -05:00
Ritsuki Yamada
727168fe1f
docs(spec): Add HTTP caching guidance for Agent Card endpoints (#1479)
Closes #1478. Related to #306.

The specification provides caching guidance for Extended Agent Cards
(Sections 3.1.11 and 13.3) but has no equivalent guidance for public
Agent Cards. This creates a gap for SDK and framework implementers —
none of the five official SDKs currently implement Agent Card caching,
and framework implementers have noted the lack of protocol-level
guidance (google/adk-python#3297).

This PR adds SHOULD-level HTTP caching guidance, following the precedent
of OpenID Connect Discovery 1.0 (same `.well-known` URI pattern).

**Changes:**

- **`docs/specification.md`**: Add Section 8.6 "Caching" with normative
guidance on `Cache-Control`, `ETag`, and conditional requests. Placed
after Section 8.5 (Sample Agent Card) to avoid renumbering existing
sections and breaking anchor links.
- **`docs/topics/agent-discovery.md`**: Add "Caching Considerations"
section with practical guidance for implementers.

---------

Co-authored-by: Darrel <darrmi@microsoft.com>
2026-03-12 16:24:35 +00:00
Kuba Herczyński
149cb82d38
docs: Fixes to the "what's new in v1" docs. (#1616) 2026-03-12 16:22:50 +00:00
Mike Smith
7415773696
refactor(spec): Update HTTP+JSON error mapping to use google.rpc.Status AIP-193 (#1600)
Updates the specification to require use of `google.rpc.Status`
formatted JSON objects for error response bodies in HTTP+JSON mapping.

See related issue for reasoning.

Fixes #1596

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-03-12 09:15:26 -07:00
dependabot[bot]
5fed760884
chore(deps): bump astral-sh/setup-uv from 5 to 7 in the github-actions group (#1572)
Bumps the github-actions group with 1 update:
[astral-sh/setup-uv](https://github.com/astral-sh/setup-uv).

Updates `astral-sh/setup-uv` from 5 to 7
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/astral-sh/setup-uv/releases">astral-sh/setup-uv's
releases</a>.</em></p>
<blockquote>
<h2>v7.2.1 🌈 update known checksums up to 0.9.28</h2>
<h2>Changes</h2>
<h2>🧰 Maintenance</h2>
<ul>
<li>chore: update known checksums for 0.9.28 @<a
href="https://github.com/apps/github-actions">github-actions[bot]</a>
(<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/744">#744</a>)</li>
<li>chore: update known checksums for 0.9.27 @<a
href="https://github.com/apps/github-actions">github-actions[bot]</a>
(<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/742">#742</a>)</li>
<li>chore: update known checksums for 0.9.26 @<a
href="https://github.com/apps/github-actions">github-actions[bot]</a>
(<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/734">#734</a>)</li>
<li>chore: update known checksums for 0.9.25 @<a
href="https://github.com/apps/github-actions">github-actions[bot]</a>
(<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/733">#733</a>)</li>
<li>chore: update known checksums for 0.9.24 @<a
href="https://github.com/apps/github-actions">github-actions[bot]</a>
(<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/730">#730</a>)</li>
</ul>
<h2>📚 Documentation</h2>
<ul>
<li>Clarify impact of using actions/setup-python <a
href="https://github.com/eifinger"><code>@​eifinger</code></a> (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/732">#732</a>)</li>
</ul>
<h2>⬆️ Dependency updates</h2>
<ul>
<li>Bump zizmorcore/zizmor-action from 0.3.0 to 0.4.1 @<a
href="https://github.com/apps/dependabot">dependabot[bot]</a> (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/741">#741</a>)</li>
</ul>
<h2>v7.0.0 🌈 node24 and a lot of bugfixes</h2>
<h2>Changes</h2>
<p>This release comes with a load of bug fixes and a speed up. Because
of switching from node20 to node24 it is also a breaking change. If you
are running on GitHub hosted runners this will just work, if you are
using self-hosted runners make sure, that your runners are up to date.
If you followed the normal installation instructions your self-hosted
runner will keep itself updated.</p>
<p>This release also removes the deprecated input
<code>server-url</code> which was used to download uv releases from a
different server.
The <a
href="https://github.com/astral-sh/setup-uv?tab=readme-ov-file#manifest-file">manifest-file</a>
input supersedes that functionality by adding a flexible way to define
available versions and where they should be downloaded from.</p>
<h3>Fixes</h3>
<ul>
<li>The action now respects when the environment variable
<code>UV_CACHE_DIR</code> is already set and does not overwrite it. It
now also finds <a
href="https://docs.astral.sh/uv/reference/settings/#cache-dir">cache-dir</a>
settings in config files if you set them.</li>
<li>Some users encountered problems that <a
href="https://github.com/astral-sh/setup-uv?tab=readme-ov-file#disable-cache-pruning">cache
pruning</a> took forever because they had some <code>uv</code> processes
running in the background. Starting with uv version <code>0.8.24</code>
this action uses <code>uv cache prune --ci --force</code> to ignore the
running processes</li>
<li>If you just want to install uv but not have it available in path,
this action now respects <code>UV_NO_MODIFY_PATH</code></li>
<li>Some other actions also set the env var <code>UV_CACHE_DIR</code>.
This action can now deal with that but as this could lead to unwanted
behavior in some edgecases a warning is now displayed.</li>
</ul>
<h3>Improvements</h3>
<p>If you are using minimum version specifiers for the version of uv to
install for example</p>
<pre lang="toml"><code>[tool.uv]
required-version = &quot;&gt;=0.8.17&quot;
</code></pre>
<p>This action now detects that and directly uses the latest version.
Previously it would download all available releases from the uv repo
to determine the highest matching candidate for the version specifier,
which took much more time.</p>
<p>If you are using other specifiers like <code>0.8.x</code> this action
still needs to download all available releases because the specifier
defines an upper bound (not 0.9.0 or later) and &quot;latest&quot; would
possibly not satisfy that.</p>
<h2>🚨 Breaking changes</h2>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="5a095e7a20"><code>5a095e7</code></a>
Bump github/codeql-action from 4.31.9 to 4.32.2 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/766">#766</a>)</li>
<li><a
href="b12532f27f"><code>b12532f</code></a>
fix: fall back to VERSION_CODENAME when VERSION_ID is not available (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/774">#774</a>)</li>
<li><a
href="0098a7571c"><code>0098a75</code></a>
chore: update known checksums for 0.10.6 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/771">#771</a>)</li>
<li><a
href="2e7ed0e2bb"><code>2e7ed0e</code></a>
chore: update known checksums for 0.10.5 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/770">#770</a>)</li>
<li><a
href="04224aa8ca"><code>04224aa</code></a>
chore: update known checksums for 0.10.4 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/768">#768</a>)</li>
<li><a
href="2bc602ff89"><code>2bc602f</code></a>
chore: update known checksums for 0.10.3 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/767">#767</a>)</li>
<li><a
href="dd9d748439"><code>dd9d748</code></a>
chore: update known checksums for 0.10.2 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/765">#765</a>)</li>
<li><a
href="14eede1834"><code>14eede1</code></a>
chore: update known checksums for 0.10.1 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/764">#764</a>)</li>
<li><a
href="c452423b2c"><code>c452423</code></a>
Bump zizmorcore/zizmor-action from 0.4.1 to 0.5.0 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/763">#763</a>)</li>
<li><a
href="eac588ad8d"><code>eac588a</code></a>
Bump typesafegithub/github-actions-typing from 2.2.1 to 2.2.2 (<a
href="https://redirect.github.com/astral-sh/setup-uv/issues/753">#753</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/astral-sh/setup-uv/compare/v5...v7">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=astral-sh/setup-uv&package-manager=github_actions&previous-version=5&new-version=7)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's major version (unless you unignore this specific
dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's minor version (unless you unignore this specific
dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR
and stop Dependabot creating any more for the specific dependency
(unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore
conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will
remove the ignore condition of the specified dependency and ignore
conditions


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-03-12 16:09:12 +00:00
Sunil Prakash
0833a5f5fd
docs: add JamJet to partners list (#1615)
## Summary

- Adds [JamJet](https://github.com/jamjet-labs/jamjet) to the partners
list in alphabetical order
- JamJet is an open-source agent-native runtime with native A2A client +
server support built in Rust

Closes #1602

---------

Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
2026-03-11 10:21:20 -07:00
Vinay Ramesh
e2eb7d2b4b
docs: Extension governance (#1488)
Brings extension governance from issue #1406 into A2A documentation spec

Closes #1406

---------

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Kuba Herczyński <herczyn@google.com>
Co-authored-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
2026-03-11 13:44:49 +01:00
Amye Scavarda Perrin
2c9bc7ecd9
docs: Update roadmap.md (#1610)
Update roadmap to forthcoming 1.0 release

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-03-10 11:44:17 -07:00
Mike Smith
477a0ee304
docs: Expand details on In-Task Authorization. (#1597)
The previous wording was very barebones. We have explored this area
significantly more, and the specification now reflects further guidance
on how to handle retrieving authorizations and credentials during Task
processing.

This specifically addresses the missing guidance on how clients are
expected to respond to a Task in `TASK_STATE_AUTH_REQUIRED`.

Fixes #1582.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2026-03-10 13:16:01 -04:00
Ivan Shymko
601c408aec
refactor(spec): rename SendMessageConfiguration.blocking to SendMessageConfiguration.return_immediately (#1507)
As mentioned in the linked issue, defaulting to non-blocking behavior is
counterintuitive and is implemented the opposite way in the SDKs.

Renaming it to `return_immediately` makes default behavior simpler while
advanced scenario requires an extra flag.

---
Previos proposals:
1. `polling` has inaccurate meaning in this context as pointed out in
the comments.
2. `non_blocking` is a negative boolean which leads to confusing
conditional expressions (`not non_blocking`).

Fixes #1453

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-03-10 17:06:43 +01:00
Amye Scavarda Perrin
aca981cee3
Update GOVERNANCE.md (#1598)
Adding new TSC member from AWS
2026-03-06 12:55:06 -08:00
Kuba Herczyński
dec790aa06
fix(docs): Clearer wording around context id. (#1588)
client side context id passing can be supported, server can choose to
reject, client's should know how to fallback accordingly
if server accepts, server must respond with the context id
if server cannot accept client side context id it MUST respond with an
error (i.e. it SHOULD not respond with a task with a different context
id?)
servers may not accept a client side context id for a number of reasons:
clashes, validation errors, not supporting context ids

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-03-05 12:33:36 +01:00
Kuba Herczyński
010b9cc936
fix(spec): Remove config from binding. (#1587)
Fix error caused by #1500:

× Failed to build `a2a-sdk @
file:///home/runner/work/a2a-python/a2a-python`
  ├─▶ The build backend returned an error
  ╰─▶ Call to `hatchling.build.build_editable` failed (exit status: 1)

      [stderr]
      Failure: failed_precondition: plugin
"buf.build/grpc-ecosystem/openapiv2:v2.28.0" failed: no field "config"
      found in TaskPushNotificationConfig
2026-03-04 13:33:14 +01:00
Kuba Herczyński
d1ed0da587
refactor(spec)!: Combine TaskPushNotificationConfig and PushNotificationConfig (#1500)
**this PR:**
- removes CreateTaskPushNotificationConfigRequest and replace it with
TaskPushNotificationConfig (same fields).
- flattend TaskPushNotificationConfig and PushNotificationConfig
removing the latter
- puts TaskPushNotificationConfig in SendMessageConfig instead of the
removed PushNotificationConfig

**why:** more readable structure, with less messages but with the same
possibilities

Release-As: 1.0.0

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-03-03 18:56:38 +01:00
AgentTrust.ai
dbb1bf8e60
docs: add AgentTrust to partners list (#1568)
This PR adds [AgentTrust](https://agenttrust.ai) to the partners list,
alphabetically between AG2AI and AI21 Labs.

**About AgentTrust:**
AgentTrust is trust and identity infrastructure for agentic
collaboration. We provide hosted A2A endpoints with Agent Card
discovery, Ed25519 message signing, human-in-the-loop escalation, and
prompt injection detection.

**What we've built:**
- Hosted A2A endpoints — agents get a public A2A identity at
`/a2a/{slug}` without running a server
- Standard Agent Card served at `/.well-known/agent.json` per agent
- Direct A2A JSON-RPC ingress (`tasks/send`) with allowlist,
InjectionGuard, and HITL rules
- Ed25519 message signing — cryptographic identity verification between
agents
- Negotiation lifecycle extending A2A task states via metadata
extensions (`propose_complete`, `disputed`, `rejected`)
- MCP server with 13 tools —
[npm](https://www.npmjs.com/package/@agenttrust/mcp-server) |
[GitHub](https://github.com/agenttrust/mcp-server)
- Webhook delivery with HMAC-SHA256 signatures

**Links:**
- Website: https://agenttrust.ai
- MCP Server: https://github.com/agenttrust/mcp-server
- npm: https://www.npmjs.com/package/@agenttrust/mcp-server

Built on Google's A2A protocol. We fill the identity and trust gap — A2A
defines how agents talk, AgentTrust helps them prove who they are.

---------

Co-authored-by: AgentTrust <hello@agenttrust.ai>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
2026-03-02 15:09:02 -08:00
Pinchwork
789bc73d8b
docs: add Pinchwork to partners list (#1498)
Hi Amye and team,

Following up on issue #1443 ("Add Pinchwork as A2A-compatible agent
marketplace") — thank you for the warm welcome and for pointing us to
the partners list!

This PR adds [Pinchwork](https://pinchwork.dev) to the partners list,
alphabetically between Personal AI and Poppulo.

**About Pinchwork:**
Pinchwork is an agent-to-agent task marketplace where AI agents can post
tasks, pick up work, and earn credits — all via a simple API. We have a
live A2A endpoint at `/.well-known/agent-card.json` and a JSON-RPC A2A
endpoint at `/a2a`, supporting `message/send`, `tasks/get`, and
`tasks/cancel`.

We're excited to be part of the A2A ecosystem and look forward to
contributing to interoperability between agents.

Resolves #1443

Co-authored-by: Pinchwork <hello@pinchwork.dev>
Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
2026-03-02 14:45:10 -08:00
Holt Skinner
4890b77d6f
docs: Fix embedded version of AgentExtension in extensions (#1550) 2026-02-26 13:14:05 -06:00
Ivan Shymko
a3e2e1f8c6
build: use go 1.25 to work with latest buf (#1509)
https://github.com/a2aproject/A2A/actions/runs/22359664144 fails with

```
go: github.com/bufbuild/buf/cmd/buf@latest: github.com/bufbuild/buf@v1.66.0 requires go >= 1.25.6 (running go 1.24.12; GOTOOLCHAIN=local)
```

Long term docs.yml probably shouldn't use `@latest` to avoid such
breakages in CI without code changes.

Re #1510 (adding `no-issue` as it's not `Fixes`)
2026-02-24 10:35:28 -06:00
Gijs Walraven
629190aea9
docs: wrap Task in result.task in life-of-a-task examples (#1492)
## Issue

Closes #1368 — Clarify whether JSON-RPC result should wrap Task/Message
objects

## Problem

Both response examples in `docs/topics/life-of-a-task.md` returned Task
fields directly inside `result`:

```json
"result": {
  "id": "task-boat-gen-123",
  "status": { ... },
  "artifacts": [ ... ]
}
```

The v1.0 specification defines `SendMessageResponse` as:

```
oneof response {
  Task task = 1;
  Message message = 2;
}
```

This means the result **must** contain either a `"task"` or `"message"`
wrapper key, not direct Task fields.

## Fix

Both response examples now correctly wrap the Task:

```json
"result": {
  "task": {
    "id": "task-boat-gen-123",
    "status": { ... },
    "artifacts": [ ... ]
  }
}
```

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Gijs Walraven <gijs.walraven@delaware.pro>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-02-18 16:13:47 +00:00
Gijs Walraven
8bf133addc
docs: use correct v1.0 method name "SendMessage" in life-of-a-task example (#1491)
## Summary

The follow-up scenario example in \`docs/topics/life-of-a-task.md\` used
\`"message.send"\` (dot notation) for the first request, while the
second request in the same example correctly used \`"SendMessage"\`
(v1.0 PascalCase). This made the file internally inconsistent and showed
a method name that doesn't exist in any version of the protocol.

## Change

\`\`\`diff
- "method": "message.send",
+ "method": "SendMessage",
\`\`\`

**File:** \`docs/topics/life-of-a-task.md\`

## Related

- Closes #1493
- Related to #1367 (method name inconsistencies across documentation)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Gijs Walraven <gijs.walraven@delaware.pro>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-18 10:12:17 -06:00
Gijs Walraven
7245512250
docs: correct Part discriminator values and remove stale v0.3.x type names (#1490)
## Summary

Fixes documentation inconsistencies related to Part discriminator field
values, identified in #1365.

## Changes

### `docs/specification.md` — Appendix A.2.1

- **Legacy Part `kind` values**: corrected from PascalCase (`"kind":
"TextPart"`, `"kind": "FilePart"`, `"kind": "DataPart"`) to lowercase
(`"kind": "text"`, `"kind": "file"`, `"kind": "data"`), consistent with
what `whats-new-v1.md` documents as the v0.3.0 format
- **Legacy FilePart structure**: added the missing nested `file` object
wrapper
- **Legacy streaming event `kind` values**: corrected from PascalCase
(`TaskStatusUpdateEvent`, `TaskArtifactUpdateEvent`) to camelCase
(`taskStatusUpdate`, `taskArtifactUpdate`)
- **Current `DataPart` migration target**: removed incorrect
double-wrapping (`{ "data": { "data": {...} } }` → `{ "data": {...},
"mediaType": "application/json" }`)
- **Current streaming event member names**: aligned with
`whats-new-v1.md` (`taskStatusUpdate` / `taskArtifactUpdate`)

### `docs/topics/key-concepts.md`

- Updated Part description to use v1.0 terminology, removing references
to the removed `TextPart`, `FilePart`, and `DataPart` types

### `docs/tutorials/python/8-next-steps.md`

- Replaced reference to removed `DataPart` type with v1.0 Part field
names

### `CONTRIBUTING.md`

- Added **Documentation Guidelines** section with correct v1.0 Part
examples (member-presence pattern) and guidance on the correct v0.3.x
lowercase `kind` discriminator values for migration docs

## Related

- Closes #1365
- External community site fix:
https://github.com/sing1ee/a2a-directory/pull/12

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Gijs Walraven <gijs.walraven@delaware.pro>
2026-02-18 10:11:37 -06:00
Kuba Herczyński
1997c9d630
fix(spec): Remove reserved and fix tags ordering (#1494)
fixes #1495 1495
2026-02-17 14:37:58 -08:00
Holt Skinner
b2daedcadf
docs: Add What's New in V1 to Docs TOC (#1489)
<img width="966" height="661" alt="Screenshot 2026-02-17 at 11 46 47 AM"
src="https://github.com/user-attachments/assets/6730cd94-bbf6-4f0a-8e33-d3a0ae2833ae"
/>
2026-02-17 12:16:53 -06:00
Sam Betts
857a995a3d
docs(spec): Correct wording around blocking=true (#1398)
This corrects the wording so that blocking=True includes terminal and
interrupted states as triggers for returning to the client.

Fixes: #1264

---------

Signed-off-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-02-17 18:06:57 +00:00
Yaroslav
393898dfee
fix(spec)!: remove duplicated ID from the create task push config request (#1487)
ID is already present in the config object.
It is not used in path segment bindings and also uses inconsistent
naming with other push-related rpc payloads.

fixes https://github.com/a2aproject/A2A/issues/1451

Follow-up to #1389

---------

Co-authored-by: Kuba Herczyński <herczyn@google.com>
2026-02-17 09:59:50 -08:00