496 Commits

Author SHA1 Message Date
Holt Skinner
0710b78dee ci(lint): Add API Linting Configuration 2026-02-10 13:04:58 -06:00
Darrel Miller
3628e974ef feat(linter): Add API Linter job to workflow for proto file validation against 2026-02-10 12:58:38 -06:00
Holt Skinner
c24b1151d1
docs(spec): Update inconsistencies in documentation for 1.0 Spec (#1466)
In the future, we should probably explore refactoring the docs set to
avoid these becoming out of sync going forward

This pull request updates the project documentation to align with the
v1.0 Agent2Agent (A2A) Protocol Specification defined in
specification/a2a.proto. It ensures that all conceptual guides,
summaries, and tutorials reflect the current normative definitions,
  RPC method names, and wire formats.

  Summary of Changes


1. RPC Method Naming Updates
Standardized all method references to use the v1.0 PascalCase naming
convention:

   * `message/send` → `SendMessage`
   * `message/stream` → `SendStreamingMessage`
   * `tasks/get` → `GetTask`
   * `tasks/list` → `ListTasks`
   * `tasks/cancel` → `CancelTask`
* `tasks/pushNotificationConfig/set` →
`CreateTaskPushNotificationConfig`
   * `tasks/resubscribe` → `SubscribeToTask`
   * `agent/getAuthenticatedExtendedCard` → `GetExtendedAgentCard`

2. JSON Example & Wire Format Corrections
Updated examples across all "Topic" files and the Python Quickstart to
match v1.0 breaking changes:
* Removed `kind` discriminators: Examples for Message, Task, Part, and
StreamResponse now use member-based polymorphism (e.g.,
     {"text": "..."} instead of {"kind": "text", "text": "..."}).
* Enum Standardization: Changed role and state enums from
kebab-case/lowercase to SCREAMING_SNAKE_CASE with type prefixes (e.g.,
     `"ROLE_USER"`, `"TASK_STATE_COMPLETED"`).
* Response Wrapping: Updated examples to reflect that `SendMessage` and
`SendStreamingMessage` return a unified response object where
     the message or task is nested within the result.

  3. LLM Context (`docs/llms.txt`)
* Completely refreshed the protocol summary and RPC method list to
ensure LLM-based tools (like Gemini CLI) have an accurate
     representation of the v1.0 API surface and error codes.

  4. Link & Anchor Maintenance
* Updated internal documentation links and spans to point to the correct
sections in the specification.md (e.g., correcting the
     anchor for GetExtendedAgentCard).

  Why this is needed
The v1.0 release introduced significant structural improvements for
ProtoJSON compliance and architectural consistency. Documentation
examples were previously showing v0.3.0 patterns which would cause
integration errors for developers using the latest SDKs.
2026-02-10 11:45:49 -06:00
Ivan Shymko
3f6ad2d9d6
docs(spec): Fix MTLS scheme proto embedding (#1462)
Currently properties for `MutualTlsSecurityScheme` are not renderred
([source](https://a2a-protocol.org/latest/specification/#456-mutualtlssecurityscheme)):
<img width="1273" height="374" alt="image"
src="https://github.com/user-attachments/assets/be4c7dbb-749d-4391-aec8-fdd55c0dd625"
/>

This PR makes casing consistent for both mkdocs anchors and heading.

Tested via `mkdocs serve`:
<img width="1505" height="626" alt="image"
src="https://github.com/user-attachments/assets/348a6ef9-3868-43bf-8319-efe63092b95b"
/>

Re https://github.com/a2aproject/A2A/pull/1460#discussion_r2783691658
2026-02-10 18:17:45 +01:00
Ivan Shymko
741ccaa3af
docs(spec): Fix streaming examples (#1458)
1. Reference `StreamResponse` instead of duplicated and inconsistent
definitions in JSON-RPC and HTTP+JSON/REST message streaming protocol
bindings. Currently JSON-RPC example also contains outdated `/* Task |
Message | TaskArtifactUpdateEvent | TaskStatusUpdateEvent */` definition
which implies `kind` field.
2. Minor consistency fix:
```diff
-Referenced Objects:
+**Referenced Objects:**
```

Fixes #1459.
2026-02-09 16:21:26 +01:00
Shingo OKAWA
8c17173de3
ci: add local script to run super-linter (#1289)
## Summary

This PR adds a local helper script (`scripts/lint.sh`) to run GitHub
Super Linter in a Docker container.
It mirrors the configuration used in our CI workflow, allowing
contributors to validate linting rules locally before opening a Pull
Request.

## Details

 - Added `scripts/lint.sh` for running Super Linter locally
- Uses the same environment variables and config files as
`.github/workflows/linter.yaml`

## Motivation

The CI lint job sometimes fails due to rule violations that are hard to
reproduce locally.
This script ensures consistent developer experience by enabling
contributors to run the exact same linter setup.

## Notes

 - No functional changes to source code
 - CI behavior remains unchanged
 
 Closes #1290

Signed-off-by: Shingo OKAWA <shingo.okawa.g.h.c@gmail.com>
2026-02-06 12:56:45 -06:00
Darrel
ed97dea512
docs(spec): What changed from v0.3.0 to v1.0 (#1436)
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
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-02-05 12:23:18 -05:00
Kuba Herczyński
ce73987171
docs(spec): Fix wording around A2A-version header. (#1435)
fixes #1417

---------

Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-02-05 09:05:49 -08:00
Holt Skinner
47eda410c3
docs: Update A2A Intro Video thumbnail resolution 2026-02-04 19:02:04 -06:00
Amye Scavarda Perrin
d22ee06d36
doc: Update GOVERNANCE.md (#1447)
Adding link to LFX meetings
2026-02-03 14:07:54 -08:00
Darrel
6292104e35
fix(spec): Added clarification on timestamps in HTTP query params (#1425) v1.0.0-rc 2026-01-29 15:09:21 -05:00
Luca Muscariello
b86d8bb2ed
docs: clean up documentation build chain and fix broken links (#1400)
- Move a2a.proto to specification/ root
- Update build scripts and macros to support new proto location
- Fix broken internal links and anchor references in specification.md
- Update .gitignore to properly exclude generated SDK docs
- Configure Sphinx to suppress external SDK warnings
- Fix MkDocs redirects and Python SDK toctree structure

---------

Signed-off-by: Luca Muscariello <muscariello@ieee.org>
2026-01-29 21:00:02 +01:00
Darrel
b03d141aea
fix(spec): Added clarifying text around messages and artifacts (#1424)
This pull request updates the A2A protocol specification to clarify the
distinction between Messages and Artifacts, and makes a minor adjustment
to protocol negotiation requirements.

---------

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-01-29 14:44:25 -05:00
Sam Betts
2596c1c5e0
fix(spec)!: Switch to non-complex IDs in requests (#1389)
Some operations like GetTask / SubscribeToTask still used complex /
compound identifiers like `tasks/<uuid>` which requires the
clients/servers to deconstruct/construct these IDs as they are normally
using just the UUID to store the resource in the DB etc.

This commit refactors them so they are just the IDs, in some cases this
meant that we needed to split one field into two i.e. parent + name.

Fixes: #1390

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-29 14:26:14 -05:00
Kuba Herczyński
227e2493c3
feat(spec): Provide ability for SDKs to be backwards compatible. (#1401)
fixes #1417
for context see #1416

---------

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-29 14:22:35 -05:00
Didier Durand
f6129cafa1
docs: fix some typos in various files. (#1198)
Hi,
As per title, fixing typos in various files: see commit diffs for
details
Cheers
Didier

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-01-29 11:03:42 -06:00
Open AI Tx
59ea3f614c
docs: Auto-translate README and Wiki (#1326)
Added language badges to the README for easier access to translated
versions: German, Spanish, French, Japanese, Korean, Portuguese, and
Russian 20 languages.
System will auto-update translation for README and Wiki when this
repository updated, and support multiple languages google/bing SEO
search, and it's open source project, we can change web or local file
mode.

The updated links can be previewed in my forked repository:
https://github.com/openaitx-system/A2A/tree/Auto_translate_README_and_Wiki

Demo links : 
-
[Español](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=es)
-
[简体中文](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=zh-CN)
-
[日本語](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ja)
-
[한국어](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=ko)
-
[Français](https://openaitx.github.io/view.html?user=a2aproject&project=A2A&lang=fr)
..


<img width="1178" height="537" alt="Image"
src="https://github.com/user-attachments/assets/7cd54a88-59c1-455f-9c7d-2db7f05b2962
" />

If this doesn't align with your expectations, feel free to close this
PR. Thanks for your time! 🙌

---------

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-01-29 11:00:33 -06:00
Holt Skinner
f6e786c652
chore: Modify CODEOWNERS for updated directory paths
Updated CODEOWNERS to reflect new directory structure.
2026-01-29 11:00:10 -06:00
Holt Skinner
871924e804
chore: Update CODEOWNERS
Add Tech Writing and Google A2A Eng as owners for non-spec files
2026-01-29 10:57:43 -06:00
madankumarpichamuthu
4dd980f6ff
fix(spec)!: Standardize spelling of "canceled" to use American Spelling throughout (#1283)
Fixes inconsistent spelling of cancel-related terms across the
specification and documentation. The proto definition uses
TASK_STATE_CANCELLED (double 'l'), but various documentation files were
using single 'l' spelling.

Changes:
- cancelled → canceled
- cancellable → cancelable
- `TaskNotCancellableError` → `TaskNotCancelableError`

Files modified:
- docs/specification.md
- docs/llms.txt
- docs/topics/life-of-a-task.md

All documentation now consistently uses single 'l' to match the proto
definition and JSON naming conventions.

Fixes #1270

Release-As: 1.0.0

---------

Signed-off-by: Luca Muscariello <muscariello@ieee.org>
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: Darrel <darrmi@microsoft.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2026-01-29 09:51:18 -06:00
madankumarpichamuthu
0655ff324a
fix: Clarify blocking calls return on interrupted states (#1403)
Updates the specification to clarify that blocking SendMessage calls
must return when tasks reach interrupted states (input_required,
auth_required) in addition to terminal states. This prevents deadlock
scenarios where tasks waiting for user input would cause blocking calls
to hang indefinitely.

Changes:
- specification/grpc/a2a.proto: Updated blocking field comment to
include "terminal or interrupted state"
- specification/grpc/a2a.proto: Fixed AUTH_REQUIRED classification to be
an "interrupted state" (consistent with INPUT_REQUIRED)
- docs/specification.md: Updated blocking behavior description to
include interrupted states and changed "final task state" to "current
task state"

This enables proper client workflows where blocking calls can return on
INPUT_REQUIRED or AUTH_REQUIRED, allowing clients to provide the needed
information and resume with subsequent SendMessage calls.

Fixes #1264

---------

Co-authored-by: madankumarpichamuthu <madankumarpichamuthu@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: Darrel <darrmi@microsoft.com>
2026-01-29 11:52:29 +01:00
Darrel
bfae8f7791
fix: Simplify Part message structure by flattening FilePart and DataPart (#1411)
This change simplifies the Part message design by:
- Renaming oneof 'part' to 'content' for clarity
- Flattening FilePart fields (file_with_uri -> url, file_with_bytes ->
bytes) directly into Part
- Flattening DataPart by using google.protobuf.Value instead of Struct
- Moving media_type and filename to Part level (available for all
content types)
- Removing separate FilePart and DataPart messages

Also updated migration guidance documentation to reference ancillary
documents instead of requiring an in-spec appendix.

Related to issue #1255

Replaces PR #1363

---------

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-01-28 17:48:33 +01:00
madankumarpichamuthu
810eaa1c6e
docs(spec)!: Align enum format with ADR-001 ProtoJSON specification (#1384)
Updates specification to use ProtoJSON enum format
(SCREAMING_SNAKE_CASE) instead of kebab-case, aligning with ADR-001
decision.

Changes:
- Updated Section 5.5 enum value formatting rules
- Added reference to ADR-001 and ProtoJSON specification
- Updated all JSON examples to use SCREAMING_SNAKE_CASE enums:
  - Role enums: user -> ROLE_USER, agent -> ROLE_AGENT
- Task state enums: working -> TASK_STATE_WORKING, completed ->
TASK_STATE_COMPLETED, etc.

This aligns the specification with the TSC-approved ADR-001 decision to
leverage ProtoJSON for JSON serialization.

Fixes #1344

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
2026-01-27 09:53:46 -08:00
Darrel
3e6c7db907
fix(spec): Fix/1251 clarify authentication scheme (#1256)
Fixes #1251

---------

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2026-01-27 09:39:39 -08:00
madankumarpichamuthu
5b101cce0f
refactor(spec)!: Remove redundant final field from TaskStatusUpdateEvent (#1308)
Terminal states (COMPLETED, FAILED, CANCELLED, REJECTED) already
indicate task completion, making the final field redundant. This creates
consistency across streaming, polling, and push notification
communication patterns.

Changes:
- Removed final field (field 4) from TaskStatusUpdateEvent in proto
- Updated examples to remove final: true references
- Clarified that streams close upon terminal states
- Added migration guidance in Appendix A.2.2

Fixes #1232

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2026-01-27 09:07:50 -08:00
Vinay Ramesh
19e2059852
docs: provide clarity in task id specification to address #1406 (#1407)
# Description
Provides clarity on server generated task ids in the specification
documentation to address underspecification of Message payloads and
expected error handling.

Fixes: #1406

Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-27 09:06:05 -08:00
hugo-romero-mm
229d005bff
docs(partners): Add MasOrange to partners list (#1409)
Hi A2A Team,
I’d like to submit [MasOrange](https://masorange.es/en/) to be added to
the A2A partners list: https://a2a-protocol.org/latest/partners/

A2A integration: We are working with A2A as a core building block for
agent discovery and agent-to-agent interoperability across our
ecosystem. We also maintain ongoing discussions with Google on
A2A-related topics, including Gemini Enterprise integrations and agentic
cloud capabilities, providing them direct feedback. We are implementing
A2A as the default protocol for exposing and connecting agentic systems
within MasOrange, adapting its usage to our security and governance
requirements, with future potential benefits for the OSS community.


Best regards,
Hugo Romero, AI Engineer at MasOrange

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-01-26 09:41:30 -08:00
Ivan Shymko
bb527d4299
docs: Bring back Python SDK reference (#1415)
Currently [`SDK Reference >
Python`](https://a2a-protocol.org/latest/sdk/python.md) link gives 404:

<img width="1138" height="308" alt="image"
src="https://github.com/user-attachments/assets/2bd3bda0-0536-4450-8e82-5ec9ee5ce044"
/>

1. Fix the link to open
[this](https://a2a-protocol.org/latest/sdk/python/api/index.html)
instead. This was setup in #949 and is generated automatically from the
latest docs. Looks like it was accidentally changed to `python.md` (the
one not used ever before, it used to be `python/index.md`) in #1160.
2. Fix redirect to use absolute URL with `latest`. This is required due
to https://github.com/mkdocs/mkdocs-redirects/issues/18, current way
isn't going to work. `v0.3.0` tag of the website (the one you get after
clicking `Latest Released Version` from
[here](https://a2a-protocol.org/latest/specification/)) doesn't have the
generated documentation either way, see
[here](https://github.com/a2aproject/A2A/tree/gh-pages/v0.3.0/sdk/python).
3. Replace `Google LLC` with `The Linux Foundation` in the generated SDK
reference.
4. Update copyright year in both places.

Tested via `mkdocs serve`.

Fixes #1347.
2026-01-26 10:12:40 -06:00
madankumarpichamuthu
d14f410711
fix: Restore CreateTaskPushNotificationConfig method naming (#1402)
Bypassing tech-writing review as it is a simple rename and the majority of the changes are in the specification.  Changes to conceptual docs are just for aligning names.

Restores the intentional rename from "Set" to "Create" for push
notification configuration methods that was lost during refactoring.
When the protocol was updated to support multiple Push Notification
Configurations, the method was changed from "Set" (which implies
replacing a single config) to "Create" (which implies creating a new
instance among many).

Changes across all documentation and proto files:
- specification/grpc/a2a.proto: Renamed RPC method and request message
- docs/specification.md: Updated all references, section titles, and
method tables
- docs/topics/streaming-and-async.md: Updated links and text
- docs/llms.txt: Updated method reference

Fixes #1394

---------

Co-authored-by: madankumarpichamuthu <madankumarpichamuthu@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-25 11:42:23 -05:00
madankumarpichamuthu
c768a44da0
fix: Remove unimplemented state_transition_history capability field (#1396)
Removes the `state_transition_history` field from `AgentCapabilities`
message as it has no corresponding API implementation. This capability
flag could mislead clients into expecting functionality that doesn't
exist in v1.0.

The field can be reintroduced in a future version when a proper
implementation is designed, including:
- Adding status_history field to Task message
- Adding include_status_history parameters to Get/List operations
- Defining behavior for history storage and retrieval

Fixes #1228

Co-authored-by: madankumarpichamuthu <madankumarpichamuthu@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2026-01-25 11:25:26 -05:00
madankumarpichamuthu
92e6fb712e
docs(spec): Update outdated method references in proto file comments (#1282)
Fixes inconsistencies between proto file documentation and the actual
method names defined in section 5.3 of the specification.

Updated method references in proto comments:
- message/send → SendMessage
- tasks/get → GetTask
- tasks/cancel → CancelTask
- tasks/pushNotificationConfig/delete → DeleteTaskPushNotificationConfig
- tasks/pushNotificationConfig/set → SetTaskPushNotificationConfig
- tasks/pushNotificationConfig/list → ListTaskPushNotificationConfig

These changes align the proto documentation with the Method Mapping
Reference table in section 5.3 of specification.md, which defines the
canonical method names for JSON-RPC and gRPC bindings.

Fixes #1267

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2026-01-22 11:54:32 +01:00
Yaroslav
057295311b
fix(spec): make history_length optional (#1071)
### Description

Both fields are optional in
[types.ts](https://github.com/yarolegovich/A2A/blob/main/types/src/types.ts#L637)
and [jsonrpc
schema](https://github.com/a2aproject/A2A/blob/main/specification/json/a2a.json#L1683).
For both cases it might be useful to differentiate 0 and unset. For
example:
1. A client calls GetTask and doesn't want History to be fetched /
included in the response.
2. A client calls SendMessage and doesn't want history to be persisted
at all.

The change is backward-compatible and makes it possible for a2a servers
to provide consistent behavior regardless of the selected transport.

Fixes #1072

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-21 17:30:25 +01:00
madankumarpichamuthu
4befaeacaf
docs: Remove v1 from HTTP binding URLs in specification (#1383)
Updates specification documentation to align with proto file changes by
removing /v1/ prefix from all HTTP REST endpoint URLs.

Changes:
- Updated all HTTP endpoint examples (POST, GET, DELETE)
- Updated API operation reference table
- Removed /v1/ from 41 occurrences throughout the specification

Fixes #1350
2026-01-20 09:19:25 -08:00
Jeff Mesnil
f9a8f5b85d
fix(spec): Update security schemes example (#1364)
Update security scheme example to use the correct key for the security
schemes instead of the `type` field.

This fixes #1355

Signed-off-by: Jeff Mesnil <jmesnil@redhat.com>
2026-01-15 11:32:26 -05:00
Amye Scavarda Perrin
ca615d78e5
Update GOVERNANCE.md (#1371)
spetschulatSFDC is now the Salesforce rep!
2026-01-14 13:37:15 -08:00
madankumarpichamuthu
40d6286fbe
refactor(spec)!: Move extendedAgentCard field to AgentCapabilities (#1307)
Relocates `supports_extended_agent_card` from AgentCard to
AgentCapabilities for architectural consistency. All optional features
that enable specific operations now reside in the capabilities object.

Rationale:
- Consistent placement: streaming, push_notifications, and
state_transition_history are all in AgentCapabilities
- Improved discoverability: developers naturally check capabilities for
optional features
- Semantic correctness: extended agent card support is a capability

Changes:
- Proto: Removed field 13 from AgentCard, added field 5 to
AgentCapabilities
- Field renamed: supports_extended_agent_card → extended_agent_card
- Updated all references: AgentCard.supportsExtendedAgentCard →
AgentCard.capabilities.extendedAgentCard
- Updated JSON examples to reflect new structure
- Added migration guidance in Appendix A.2.2 of specification

Breaking change: Clients and agents must update capability checking
logic. See specification Appendix A.2.2 for migration steps.

Fixes #1229

---------

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-14 08:41:30 -05:00
Sam Betts
0e204bf878
fix(spec)!: Fixes for the last_updated_after field (#1358)
This PR combines two fixes for the ListTaskRequest last_updated_after
field one changes the field to a timestamp type and one renames it and
clarifies the ordering of the task list result.

Original PR for the timestamp type fix was:
https://github.com/a2aproject/A2A/pull/1288

Fixes: #1287
Fixes: #1206

---------

Co-authored-by: Yaroslav Shevchuk <yarolegovich@gmail.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-14 08:34:02 -05:00
Mauro Sardara
525ff38e5f
feat(spec)!: modernize oauth 2.0 flows - remove implicit/password, add device code / pkce (#1303)
## Description

Modernizes OAuth 2.0 flow support by removing deprecated
flows and adding modern, secure alternatives.

Fixes: #1234 

## Changes

### Breaking Changes

**Removed (deprecated by OAuth 2.0 Security BCP):**
- `ImplicitOAuthFlow` - Use Authorization Code + PKCE instead
- `PasswordOAuthFlow` - Use Authorization Code + PKCE or Device Code
instead

### Added

**New OAuth Flow:**
- `DeviceCodeOAuthFlow` (RFC 8628) - For CLI tools, IoT devices, and
input-constrained scenarios

**Enhanced Security:**
- `pkce_required` field added to `AuthorizationCodeOAuthFlow` (RFC 7636)

Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-13 22:24:49 -05:00
Darrel
e6c5699c55
docs: Added adr template and protojson adr (#1214)
Added ADR that captures decision to use ProtoJSON as the normative
reference for JSON serialization

---------

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-01-13 22:16:06 -05:00
Darrel
a4afeea788
fix(spec): Clarify versioning strategy and client responsibilities in protocol specification (#1259)
Fixes #1258

### High level summary of changes:

- protocolVersion in AgentCard is now an array called protocolVersions
- Servers are expected to return UnsupportedVersionError if they get a
request with an A2A-Version header higher than they support.
- Clients are expected to fallback to a supported version if that is
acceptable to them. Tooling should help here.
- Not every minor version needs to be enumerated in the protocolVersions
array. 2.2 infers support for 2.1 and 2.0.

---------

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-01-13 22:10:38 -05:00
Sam Betts
1e5f462064
fix(spec)!: Make "message" field name consistent between protocol bindings (#1302)
While this is a reserved word for proto itself, best practise is to
avoid field names that conflict with language (python etc) keywords, as
"message" isn't a language keyword this improves the consistency and
readability when using the types generated from the proto and avoids
needing to translate the name for JSON encoding.

Closes: #1230

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-13 22:00:11 -05:00
Vinay Ramesh
e8c0f0fd61
docs(spec): patched security scheme and add anchor tag for Security (#1279)
Minor patch to `security_scheme` reference to `securityScheme` and added
a missing anchor tag for `Security`. Another docs change should be added
to clarify usage of `Security`. Opened
https://github.com/a2aproject/A2A/discussions/1278 for clarification.

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

Co-authored-by: Luca Muscariello <muscariello@ieee.org>
Co-authored-by: Darrel <darrmi@microsoft.com>
2026-01-12 13:34:26 -05:00
Didier Durand
cc8e67ebea
docs: fixing some typos in various files (#1310)
Hi,
Giving a second read to the repo, I found these additional typos: see
commit diffs.
Didier

---------

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-01-08 08:55:51 -08:00
dependabot[bot]
48f58461c2
chore(deps): bump actions/cache from 4 to 5 in the github-actions group (#1332)
Bumps the github-actions group with 1 update:
[actions/cache](https://github.com/actions/cache).

Updates `actions/cache` from 4 to 5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/actions/cache/releases">actions/cache's
releases</a>.</em></p>
<blockquote>
<h2>v5.0.0</h2>
<blockquote>
<p>[!IMPORTANT]
<strong><code>actions/cache@v5</code> runs on the Node.js 24 runtime and
requires a minimum Actions Runner version of
<code>2.327.1</code>.</strong></p>
<p>If you are using self-hosted runners, ensure they are updated before
upgrading.</p>
</blockquote>
<hr />
<h2>What's Changed</h2>
<ul>
<li>Upgrade to use node24 by <a
href="https://github.com/salmanmkc"><code>@​salmanmkc</code></a> in <a
href="https://redirect.github.com/actions/cache/pull/1630">actions/cache#1630</a></li>
<li>Prepare v5.0.0 release by <a
href="https://github.com/salmanmkc"><code>@​salmanmkc</code></a> in <a
href="https://redirect.github.com/actions/cache/pull/1684">actions/cache#1684</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/actions/cache/compare/v4.3.0...v5.0.0">https://github.com/actions/cache/compare/v4.3.0...v5.0.0</a></p>
<h2>v4.3.0</h2>
<h2>What's Changed</h2>
<ul>
<li>Add note on runner versions by <a
href="https://github.com/GhadimiR"><code>@​GhadimiR</code></a> in <a
href="https://redirect.github.com/actions/cache/pull/1642">actions/cache#1642</a></li>
<li>Prepare <code>v4.3.0</code> release by <a
href="https://github.com/Link"><code>@​Link</code></a>- in <a
href="https://redirect.github.com/actions/cache/pull/1655">actions/cache#1655</a></li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a href="https://github.com/GhadimiR"><code>@​GhadimiR</code></a>
made their first contribution in <a
href="https://redirect.github.com/actions/cache/pull/1642">actions/cache#1642</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/actions/cache/compare/v4...v4.3.0">https://github.com/actions/cache/compare/v4...v4.3.0</a></p>
<h2>v4.2.4</h2>
<h2>What's Changed</h2>
<ul>
<li>Update README.md by <a
href="https://github.com/nebuk89"><code>@​nebuk89</code></a> in <a
href="https://redirect.github.com/actions/cache/pull/1620">actions/cache#1620</a></li>
<li>Upgrade <code>@actions/cache</code> to <code>4.0.5</code> and move
<code>@protobuf-ts/plugin</code> to dev depdencies by <a
href="https://github.com/Link"><code>@​Link</code></a>- in <a
href="https://redirect.github.com/actions/cache/pull/1634">actions/cache#1634</a></li>
<li>Prepare release <code>4.2.4</code> by <a
href="https://github.com/Link"><code>@​Link</code></a>- in <a
href="https://redirect.github.com/actions/cache/pull/1636">actions/cache#1636</a></li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a href="https://github.com/nebuk89"><code>@​nebuk89</code></a> made
their first contribution in <a
href="https://redirect.github.com/actions/cache/pull/1620">actions/cache#1620</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/actions/cache/compare/v4...v4.2.4">https://github.com/actions/cache/compare/v4...v4.2.4</a></p>
<h2>v4.2.3</h2>
<h2>What's Changed</h2>
<ul>
<li>Update to use <code>@​actions/cache</code> 4.0.3 package &amp;
prepare for new release by <a
href="https://github.com/salmanmkc"><code>@​salmanmkc</code></a> in <a
href="https://redirect.github.com/actions/cache/pull/1577">actions/cache#1577</a>
(SAS tokens for cache entries are now masked in debug logs)</li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a href="https://github.com/salmanmkc"><code>@​salmanmkc</code></a>
made their first contribution in <a
href="https://redirect.github.com/actions/cache/pull/1577">actions/cache#1577</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/actions/cache/compare/v4.2.2...v4.2.3">https://github.com/actions/cache/compare/v4.2.2...v4.2.3</a></p>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/actions/cache/blob/main/RELEASES.md">actions/cache's
changelog</a>.</em></p>
<blockquote>
<h1>Releases</h1>
<h2>Changelog</h2>
<h3>5.0.1</h3>
<ul>
<li>Update <code>@azure/storage-blob</code> to <code>^12.29.1</code> via
<code>@actions/cache@5.0.1</code> <a
href="https://redirect.github.com/actions/cache/pull/1685">#1685</a></li>
</ul>
<h3>5.0.0</h3>
<blockquote>
<p>[!IMPORTANT]
<code>actions/cache@v5</code> runs on the Node.js 24 runtime and
requires a minimum Actions Runner version of <code>2.327.1</code>.
If you are using self-hosted runners, ensure they are updated before
upgrading.</p>
</blockquote>
<h3>4.3.0</h3>
<ul>
<li>Bump <code>@actions/cache</code> to <a
href="https://redirect.github.com/actions/toolkit/pull/2132">v4.1.0</a></li>
</ul>
<h3>4.2.4</h3>
<ul>
<li>Bump <code>@actions/cache</code> to v4.0.5</li>
</ul>
<h3>4.2.3</h3>
<ul>
<li>Bump <code>@actions/cache</code> to v4.0.3 (obfuscates SAS token in
debug logs for cache entries)</li>
</ul>
<h3>4.2.2</h3>
<ul>
<li>Bump <code>@actions/cache</code> to v4.0.2</li>
</ul>
<h3>4.2.1</h3>
<ul>
<li>Bump <code>@actions/cache</code> to v4.0.1</li>
</ul>
<h3>4.2.0</h3>
<p>TLDR; The cache backend service has been rewritten from the ground up
for improved performance and reliability. <a
href="https://github.com/actions/cache">actions/cache</a> now integrates
with the new cache service (v2) APIs.</p>
<p>The new service will gradually roll out as of <strong>February 1st,
2025</strong>. The legacy service will also be sunset on the same date.
Changes in these release are <strong>fully backward
compatible</strong>.</p>
<p><strong>We are deprecating some versions of this action</strong>. We
recommend upgrading to version <code>v4</code> or <code>v3</code> as
soon as possible before <strong>February 1st, 2025.</strong> (Upgrade
instructions below).</p>
<p>If you are using pinned SHAs, please use the SHAs of versions
<code>v4.2.0</code> or <code>v3.4.0</code></p>
<p>If you do not upgrade, all workflow runs using any of the deprecated
<a href="https://github.com/actions/cache">actions/cache</a> will
fail.</p>
<p>Upgrading to the recommended versions will not break your
workflows.</p>
<h3>4.1.2</h3>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="9255dc7a25"><code>9255dc7</code></a>
Merge pull request <a
href="https://redirect.github.com/actions/cache/issues/1686">#1686</a>
from actions/cache-v5.0.1-release</li>
<li><a
href="8ff5423e8b"><code>8ff5423</code></a>
chore: release v5.0.1</li>
<li><a
href="9233019a15"><code>9233019</code></a>
Merge pull request <a
href="https://redirect.github.com/actions/cache/issues/1685">#1685</a>
from salmanmkc/node24-storage-blob-fix</li>
<li><a
href="b975f2bb84"><code>b975f2b</code></a>
fix: add peer property to package-lock.json for dependencies</li>
<li><a
href="d0a0e18134"><code>d0a0e18</code></a>
fix: update license files for <code>@​actions/cache</code>,
fast-xml-parser, and strnum</li>
<li><a
href="74de208dcf"><code>74de208</code></a>
fix: update <code>@​actions/cache</code> to ^5.0.1 for Node.js 24
punycode fix</li>
<li><a
href="ac7f1152ea"><code>ac7f115</code></a>
peer</li>
<li><a
href="b0f846b50b"><code>b0f846b</code></a>
fix: update <code>@​actions/cache</code> with storage-blob fix for
Node.js 24 punycode depr...</li>
<li><a
href="a783357455"><code>a783357</code></a>
Merge pull request <a
href="https://redirect.github.com/actions/cache/issues/1684">#1684</a>
from actions/prepare-cache-v5-release</li>
<li><a
href="3bb0d78750"><code>3bb0d78</code></a>
docs: highlight v5 runner requirement in releases</li>
<li>Additional commits viewable in <a
href="https://github.com/actions/cache/compare/v4...v5">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=actions/cache&package-manager=github_actions&previous-version=4&new-version=5)](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 merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@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-01-08 16:44:37 +00:00
Sam Betts
60f83c3faa
fix(spec)!: Remove deprecated fields from a2a.proto for v1.0 release (#1301)
As v1.0 is a major release and may contain breaking changes this commit
cleans up the deprecated fields in the a2a.proto and references to this
in the spec doc.

Closes: #1227
2026-01-06 11:29:53 -05:00
Kuba Herczyński
a336a5a484
fix(spec): Clarify contextId behavior when message is sent with taskId but without contextId (#1309)
Fixes #1249.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Luca Muscariello <muscariello@ieee.org>
2025-12-24 11:33:17 -05:00
William Wang
d803564477
doc: add amikonet to partners list (#1316)
Hi A2A Team,

I would like to submit AmikoNet (https://amikonet.ai/) to be added to
the A2A partners list.

About AmikoNet: AmikoNet is the first social network where AI agents and
humans interact as equals.

Our platform enables AI agents to have their own profiles(which include
its agent card), create content, and collaborate with both humans and
other agents. All content is stored in markdown format optimized for AI
agent consumption.

A2A Integration: We use Google A2A as our core protocol for agent
discovery, allowing autonomous agents to find and connect with each
other across our network. This makes AmikoNet a natural fit for the A2A
ecosystem.

We're excited to be part of the A2A community and help advance the
standard for AI agent collaboration.

Best regards,

William
Amiko Team
2025-12-18 13:00:44 -08:00
Holt Skinner
1a2d580a3e
docs: Update COMMUNITY.md (#1312)
- Removed previous events section from community documentation.
- Updated list of A2A Integrations
2025-12-15 11:59:10 -06:00
Didier Durand
33f065d3da
ci: prevent 2 workflows from failing on forks. (#1305)
Hi,

The 2 modified workflows (See commit diffs) fail when executed on forks.
They are triggered by the push coming when synching a fork with master.

The added ìf`conditions prevent them from running and failing when on
fork

Didier
2025-12-11 09:31:35 -06:00
Didier Durand
dec450b3c4
docs: fix typos in specification.md (#1304)
Hi,
Recent changes in in specification.md brought some typos: this PR fixes
them.
See commit diffs for details.
Didier
2025-12-11 09:30:47 -06:00