45 Commits

Author SHA1 Message Date
Copilot
1a1e4de92e
docs(spec): Fix TransportProtocol comment: JSON-RPC is optional, not mandatory (#1101)
The comment in the `TransportProtocol` enum incorrectly stated that
JSON-RPC was "(mandatory)" while gRPC and HTTP+JSON were "(optional)".
This contradicted the A2A specification which clearly states that all
three transport protocols are equally optional.

According to the specification Section 3.2:
- **Section 3.2.1**: "Agents **MAY** support JSON-RPC 2.0 transport"
- **Section 3.2.2**: "Agents **MAY** support gRPC transport" 
- **Section 3.2.3**: "Agents **MAY** support REST-style HTTP+JSON
transport"

The specification explicitly states: "All three protocols are considered
equal in status, and agents may choose to implement any combination of
them based on their requirements."

**Before:**
```typescript
export enum TransportProtocol {
  JSONRPC = "JSONRPC", // JSON-RPC 2.0 over HTTP (mandatory)
  GRPC = "GRPC", // gRPC over HTTP/2 (optional)
  HTTP_JSON = "HTTP+JSON", // REST-style HTTP with JSON (optional)
}
```

**After:**
```typescript
export enum TransportProtocol {
  JSONRPC = "JSONRPC", // JSON-RPC 2.0 over HTTP (optional)
  GRPC = "GRPC", // gRPC over HTTP/2 (optional)
  HTTP_JSON = "HTTP+JSON", // REST-style HTTP with JSON (optional)
}
```

This change ensures the code documentation accurately reflects the
specification requirements and prevents confusion for developers
implementing A2A-compliant agents.

Fixes #1098.

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

馃挰 Share your feedback on Copilot coding agent for the chance to win a
$200 gift card! Click
[here](https://survey3.medallia.com/?EAHeSx-AP01bZqG0Ld9QLQ) to start
the survey.

---------

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: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
2025-10-18 13:30:22 -04:00
Eden Reich
0a9f629e80
feat(spec): Add tasks/list method with filtering and pagination to the specification (#831)
# Description

Thank you for opening a Pull Request!
Before submitting your PR, there are a few things you can do to make
sure it goes smoothly:

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

Fixes #761  馃

---------

Signed-off-by: Eden Reich <eden.reich@gmail.com>
Co-authored-by: Holt Skinner <holtskinner@google.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Amye Scavarda Perrin <amye@amye.org>
2025-10-16 12:47:20 -07:00
dependabot[bot]
eb65a44963
chore(deps-dev): bump the npm-dependencies group in /types with 2 updates (#1116)
Bumps the npm-dependencies group in /types with 2 updates:
[prettier](https://github.com/prettier/prettier) and
[typescript](https://github.com/microsoft/TypeScript).

Updates `prettier` from 3.5.3 to 3.6.2
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/prettier/prettier/releases">prettier's
releases</a>.</em></p>
<blockquote>
<h2>3.6.2</h2>
<h2>What's Changed</h2>
<ul>
<li>Add missing blank line around code block by <a
href="https://github.com/fisker"><code>@鈥媐isker</code></a> in <a
href="https://redirect.github.com/prettier/prettier/pull/17675">prettier/prettier#17675</a></li>
</ul>
<p>馃敆 <a
href="https://github.com/prettier/prettier/blob/main/CHANGELOG.md#362">Changelog</a></p>
<h2>3.6.1</h2>
<ul>
<li>Fix &quot;Warning: File descriptor 39 closed but not opened in
unmanaged mode&quot; error when running
<code>--experimental-cli</code></li>
</ul>
<p>馃敆 <a
href="https://github.com/prettier/prettier/blob/main/CHANGELOG.md#361">Changelog</a></p>
<h2>3.6.0</h2>
<p><a
href="https://github.com/prettier/prettier/compare/3.5.3...3.6.0">diff</a></p>
<p>馃敆 <a href="https://prettier.io/blog/2025/06/23/3.6.0">Release note
&quot;Prettier 3.6: Experimental fast CLI and new OXC and Hermes
plugins!&quot;</a></p>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/prettier/prettier/blob/main/CHANGELOG.md">prettier's
changelog</a>.</em></p>
<blockquote>
<h1>3.6.2</h1>
<p><a
href="https://github.com/prettier/prettier/compare/3.6.1...3.6.2">diff</a></p>
<h4>Markdown: Add missing blank line around code block (<a
href="https://redirect.github.com/prettier/prettier/pull/17675">#17675</a>
by <a href="https://github.com/fisker"><code>@鈥媐isker</code></a>)</h4>
<!-- raw HTML omitted -->
<pre lang="md"><code>&lt;!-- Input --&gt;
1. Some text, and code block below, with newline after code block
<pre lang="yaml"><code>---
foo: bar
</code></pre>
<ol>
<li>Another</li>
<li>List</li>
</ol>
<p>&lt;!-- Prettier 3.6.1 --&gt;</p>
<ol>
<li>
<p>Some text, and code block below, with newline after code block</p>
<pre lang="yaml"><code>---
foo: bar
</code></pre>
<ol>
<li>Another</li>
<li>List</li>
</ol>
</li>
</ol>
<p>&lt;!-- Prettier 3.6.2 --&gt;</p>
<ol>
<li>
<p>Some text, and code block below, with newline after code block</p>
<pre lang="yaml"><code>---
foo: bar
</code></pre>
<ol>
<li>Another</li>
<li>List<br />
</code></pre></li>
</ol>
</li>
</ol>
<h1>3.6.1</h1>
<p><a
href="https://github.com/prettier/prettier/compare/3.6.0...3.6.1">diff</a></p>
<h4>TypeScript: Allow const without initializer (<a
href="https://redirect.github.com/prettier/prettier/pull/17650">#17650</a>,
<a
href="https://redirect.github.com/prettier/prettier/pull/17654">#17654</a>
by <a href="https://github.com/fisker"><code>@鈥媐isker</code></a>)</h4>
<!-- raw HTML omitted -->
<pre lang="jsx"><code>// Input
&lt;/tr&gt;&lt;/table&gt; 
</code></pre>
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="7a8b05f415"><code>7a8b05f</code></a>
Release 3.6.2</li>
<li><a
href="46526b49b6"><code>46526b4</code></a>
Add missing blank line around code block (<a
href="https://redirect.github.com/prettier/prettier/issues/17675">#17675</a>)</li>
<li><a
href="a04ec1196f"><code>a04ec11</code></a>
chore(deps): update babel to v7.27.7 (<a
href="https://redirect.github.com/prettier/prettier/issues/17684">#17684</a>)</li>
<li><a
href="32be5b6b44"><code>32be5b6</code></a>
chore(deps): update dependency flow-parser to v0.274.1 (<a
href="https://redirect.github.com/prettier/prettier/issues/17676">#17676</a>)</li>
<li><a
href="b55e777924"><code>b55e777</code></a>
Update docs about &quot;TypeScript Configuration Files&quot; (<a
href="https://redirect.github.com/prettier/prettier/issues/17677">#17677</a>)</li>
<li><a
href="b197c99224"><code>b197c99</code></a>
chore(deps): update dependency <code>@鈥媣itejs/plugin-react</code> to
v4.6.0 (<a
href="https://redirect.github.com/prettier/prettier/issues/17674">#17674</a>)</li>
<li><a
href="1185f8370a"><code>1185f83</code></a>
chore(deps): update dependency <code>@鈥媋ngular/compiler</code> to
v20.0.5 (<a
href="https://redirect.github.com/prettier/prettier/issues/17680">#17680</a>)</li>
<li><a
href="aa1316fa60"><code>aa1316f</code></a>
chore(deps): update dependency browserslist to v4.25.1 (<a
href="https://redirect.github.com/prettier/prettier/issues/17671">#17671</a>)</li>
<li><a
href="c468d33f16"><code>c468d33</code></a>
chore(deps): update dependency oxc-parser to v0.75.0 (<a
href="https://redirect.github.com/prettier/prettier/issues/17672">#17672</a>)</li>
<li><a
href="3f46d91bdb"><code>3f46d91</code></a>
chore(deps): update dependency vite to v7 (<a
href="https://redirect.github.com/prettier/prettier/issues/17673">#17673</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/prettier/prettier/compare/3.5.3...3.6.2">compare
view</a></li>
</ul>
</details>
<br />

Updates `typescript` from 5.8.3 to 5.9.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/microsoft/TypeScript/releases">typescript's
releases</a>.</em></p>
<blockquote>
<h2>TypeScript 5.9.3</h2>
<!-- raw HTML omitted -->
<h2>TypeScript 5.9</h2>
<p>For release notes, check out the <a
href="https://devblogs.microsoft.com/typescript/announcing-typescript-5-9/">release
announcement</a></p>
<ul>
<li><a
href="https://github.com/Microsoft/TypeScript/issues?utf8=%E2%9C%93&amp;q=milestone%3A%22TypeScript+5.9.0%22+is%3Aclosed+">fixed
issues query for Typescript 5.9.0 (Beta)</a>.</li>
<li><a
href="https://github.com/Microsoft/TypeScript/issues?utf8=%E2%9C%93&amp;q=milestone%3A%22TypeScript+5.9.1%22+is%3Aclosed+">fixed
issues query for Typescript 5.9.1 (RC)</a>.</li>
<li><em>No specific changes for TypeScript 5.9.2 (Stable)</em></li>
</ul>
<p>Downloads are available on:</p>
<ul>
<li><a href="https://www.npmjs.com/package/typescript">npm</a></li>
</ul>
<h2>TypeScript 5.9 RC</h2>
<p>For release notes, check out the <a
href="https://devblogs.microsoft.com/typescript/announcing-typescript-5-9-rc/">release
announcement</a></p>
<ul>
<li><a
href="https://github.com/Microsoft/TypeScript/issues?utf8=%E2%9C%93&amp;q=milestone%3A%22TypeScript+5.9.0%22+is%3Aclosed+">fixed
issues query for Typescript 5.9.0 (Beta)</a>.</li>
<li><a
href="https://github.com/Microsoft/TypeScript/issues?utf8=%E2%9C%93&amp;q=milestone%3A%22TypeScript+5.9.1%22+is%3Aclosed+">fixed
issues query for Typescript 5.9.1 (RC)</a>.</li>
</ul>
<p>Downloads are available on:</p>
<ul>
<li><a href="https://www.npmjs.com/package/typescript">npm</a></li>
</ul>
<h2>TypeScript 5.9 Beta</h2>
<p>For release notes, check out the <a
href="https://devblogs.microsoft.com/typescript/announcing-typescript-5-9-beta/">release
announcement</a>.</p>
<ul>
<li><a
href="https://github.com/Microsoft/TypeScript/issues?utf8=%E2%9C%93&amp;q=milestone%3A%22TypeScript+5.9.0%22+is%3Aclosed+">fixed
issues query for Typescript 5.9.0 (Beta)</a>.</li>
</ul>
<p>Downloads are available on:</p>
<ul>
<li><a href="https://www.npmjs.com/package/typescript">npm</a></li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="31a0ead46d"><code>31a0ead</code></a>
Don't compare &quot;missing&quot; to <code>undefined</code> in
<code>compareProperties</code> under `exactOpt...</li>
<li><a
href="d4b15eb56d"><code>d4b15eb</code></a>
Enhance type argument completions (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62170">#62170</a>)</li>
<li><a
href="83ff20281e"><code>83ff202</code></a>
Bump the github-actions group across 1 directory with 2 updates (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62507">#62507</a>)</li>
<li><a
href="e350126ab9"><code>e350126</code></a>
Port <a
href="https://redirect.github.com/microsoft/typescript-go/issues/1764">microsoft/typescript-go#1764</a>
(<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62510">#62510</a>)</li>
<li><a
href="97610a8a63"><code>97610a8</code></a>
Port <a
href="https://redirect.github.com/microsoft/typescript-go/issues/1757">microsoft/typescript-go#1757</a>
(<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62501">#62501</a>)</li>
<li><a
href="1cd5309f7d"><code>1cd5309</code></a>
Port <a
href="https://redirect.github.com/microsoft/typescript-go/pull/1759">microsoft/typescript-go#1759</a>
(<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62502">#62502</a>)</li>
<li><a
href="5f183ad73d"><code>5f183ad</code></a>
Revert PR 61928 (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62423">#62423</a>)</li>
<li><a
href="6f6efb419a"><code>6f6efb4</code></a>
Disable conditional exports fallbacks on <code>null</code> values (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62483">#62483</a>)</li>
<li><a
href="96acaa5290"><code>96acaa5</code></a>
Remove no-default-lib (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62435">#62435</a>)</li>
<li><a
href="904e7dd97d"><code>904e7dd</code></a>
Enable <code>noUncheckedSideEffectImports</code> by default (<a
href="https://redirect.github.com/microsoft/TypeScript/issues/62443">#62443</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/microsoft/TypeScript/compare/v5.8.3...v5.9.3">compare
view</a></li>
</ul>
</details>
<br />


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>
2025-10-02 09:54:13 -05:00
Holt Skinner
00cf76e7bb
fix(spec): Suggest Unique Identifier fields to be UUID (#966) 2025-08-13 20:56:28 +01:00
kthota-g
8d57eba286
docs: Address typos in docstrings and docs. Fixes #940 (#941)
Fixes #940  馃

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2025-07-31 15:59:53 +01:00
dmandar
6a152a83ad
chore: Update default protocol version to 0.3.0 (#932)
We can push this when we release 0.3.0

Release-As: 0.3.0

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2025-07-30 14:57:35 +00:00
Mike Smith
e162c0c6c4
feat!: Add mTLS to SecuritySchemes, add oauth2 metadata url field, allow Skills to specify Security (#901)
# Description

This PR makes changes to our security representations in AgentCards:

1. Adds a new MutualTLSSecurityScheme type for indicating mTLS
connection requirements. This matches the same field in the OpenAPI
specification v3.1. This type is pretty lacking: there is no way to
indicate any requirements on the certificate that is presented by the
client. I expect we'll want to extend this in the future (for example,
we may want to allow an agent to indicate that a SPIFFE certificate must
be presented). For now, users are advised to put requirements in the
description field.
2. Adds a field for specifying a URL for OAuth2 provider metadata. This
is planned for OpenAPI Specification v3.2, which has not yet been
released. This allows clients to fetch additional information about the
OAuth provider, such as to discover if they support Dynamic Client
Registration.
3. Allows AgentSkills to specify a `security` field. This allows agents
to indicate security requirements for leveraging a particular skill.

I also clarified the usage and expectations for the `security` field in
the base AgentCard.

This change is marked backwards incompatible due to the addition of the
MutualTLSSecurityScheme, which adds a new type to an exhaustive enum
(the security scheme `anyOf`).

Release-As: 0.3.0

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Holt Skinner <holtskinner@google.com>
2025-07-29 13:39:27 -06:00
kthota-g
6fb2b771b0
ci: Trigger ci build for spec update (#936) 2025-07-29 19:50:41 +01:00
kthota-g
476863efa6
chore: Push to trigger spec update wf (#934)
# Description

Thank you for opening a Pull Request!
Before submitting your PR, there are a few things you can do to make
sure it goes smoothly:

- [ ] 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)

Fixes #<issue_number_goes_here> 馃

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-07-29 11:16:51 -07:00
kthota-g
2cd7d98bc8
feat!: Add method for fetching extended card (#929)
# Description
This change adds support for a new JSON-RPC method
`agent/getAuthenticatedExtendedCard` for fetching authenticated extended
card.

This is only applicable if `AgentCard.supportsAuthenticatedExtendedCard`
bit is set to `true` that allows fetching authenticated context specific
agent card.

In the previous versions, the extended card was served via
`{AgentCard.url}/../agent/authenticatedExtendedCard` endpoint. This
endpoint is being removed in favor of the JSON-RPC method. This endpoint
will be deprecated in the SDKs and will be removed in a future release.

Release-As: 0.3.0

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2025-07-29 09:31:45 -07:00
Israel Ekpo
074a3dd06b
docs: Update Docs to Clarify that Task Id Must Be Generated By the A2A Server (#926)
Fixes #925  馃

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-07-28 17:03:25 +01:00
Mike Smith
ef4a305053
feat: Add signatures to the AgentCard (#917)
# Description

This introduces a `signatures` field on the AgentCard that contains JWS
formatted signatures. See issue #916 and discussion #199 for further
details, including how signatures are constructed and verified.

Fixes #916 馃
2025-07-25 18:12:25 +00:00
Holt Skinner
acc16128ce
fix(spec): Remove @TJS-format uri due to breaking change in Python SDK (#910)
See https://github.com/a2aproject/a2a-python/pull/346
2025-07-24 20:18:20 +01:00
Holt Skinner
e834347c27
fix(spec): Add Transport enum to specification (#909)
Adds Enum of supported Transports to Specification, with extensibility
for proprietary protocols.
Adds URL formatting requirement for `AgentInterface.url` and
`AgentCard.url`

Co-authored-by: Stefano Maestri <stefano.maestri@javalinux.it>
2025-07-24 19:56:39 +01:00
Holt Skinner
0c95b1fa8a
docs(spec): Improve docstrings in the specification (#887)
Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-07-18 18:34:47 +01:00
kthota-g
6f1d17ba80
fix: Type fix and doc clarification (#877)
Release-As: 0.2.6

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-07-17 17:10:05 +01:00
Holt Skinner
32f3f9eb2e Revert "feat(spec): Add AGENT_CARD_WELL_KNOWN_URI to spec (#824)"
This reverts commit 66da9d10ee87dc1f8baa20a21360bebbe7d4ff1b.
2025-07-02 13:09:37 -05:00
Holt Skinner
66da9d10ee
feat(spec): Add AGENT_CARD_WELL_KNOWN_URI to spec (#824)
Prevents usage of "Magic Strings" in SDKs, which supports better
adherence to the recommended path for Agent Cards.

NOTE: This path might also need to be changed based on feedback in
https://github.com/protocol-registries/well-known-uris/issues/66 so
having a global constant would make this adjustment easier.

Fixes #816 馃
2025-07-02 11:51:35 -05:00
Holt Skinner
b3a725b97a
chore(spec): Add examples and fix spelling errors in proto (#823) 2025-07-02 10:37:41 -05:00
Holt Skinner
7fd0dcc6e4
chore(spec): Add default value for AgentCard.protocolVersion (#812)
- Prevents a breaking change in the Python Library
2025-06-30 15:19:55 -05:00
dmandar
90fa642094
feat(spec)!: Add a required protocol version to the agent card. (#802)
Add a new protocol version field to the agent card.

Release-As: 0.2.5
2025-06-30 15:04:16 -05:00
Holt Skinner
3590012159
chore(spec): Add @TJS-examples to spec and add missing Union Types (#810)
- **Replaced `@example` with `@TJS-examples`**: All JSDoc `@example`
tags have been converted to `@TJS-examples`, used
by`typescript-json-schema` to generate example values.
- **Completed Union Types**: The `JSONRPCResponse` union type was
incomplete. Added the missing `ListTaskPushNotificationConfigResponse`
and `DeleteTaskPushNotificationConfigResponse` types to make it
consistent with the defined request types.
2025-06-30 19:52:04 +00:00
Matteo Murru
419a497f68
docs: Add @TJS-examples for AgentProvider and AgentExtension interfaces (#758)
Add missing `@TJS-examples` annotations to `AgentProvider` and
`AgentExtension` interfaces to improve TypeScript developer experience.

Examples use Google ecosystem references (ai.google.dev, OAuth 2.0) and
follow existing JSDoc patterns in the codebase.

First contribution to open source 鉂わ笍
2025-06-23 13:08:53 +00:00
Holt Skinner
4a5e970ec2
fix(spec): Make AgentCard.additionalInterfaces Optional for backwards compatibility (#760)
The Python SDK expects a value for `additionalInterfaces` if this is not
optional. New versions would be a breaking change.

Unit test output

```
ERROR tests/client/test_client.py - pydantic_core._pydantic_core.ValidationError: 1 validation error for AgentCard
additionalInterfaces
  Field required [type=missing, input_value={'name': 'Hello World Age... tags=['hello world'])]}, input_type=dict]
```

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-06-16 13:00:53 -05:00
Holt Skinner
14424a69d5
fix(spec): Fix casing of types.ts from #749 (#759)
Change from `snake_case` to `camelCase`
2025-06-16 12:46:59 -05:00
pstephengoogle
b35485e02e
feat: Add support for multiple transport announcement in AgentCard (#749)
This is designed to be backward compatible. Existing cards will work and
be correct with this update. New fields are added to the agent card and
default interpretation for these are provided to be backward compatible

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: Holt Skinner <holtskinner@google.com>
Co-authored-by: tomsun28 <tomsun28@outlook.com>
Co-authored-by: Mike Smith <mikeas@google.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: kthota-g <kcthota@google.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2025-06-16 11:13:44 -06:00
dependabot[bot]
2473f69a06
chore(deps): bump brace-expansion from 1.1.11 to 1.1.12 in /types (#757)
Bumps [brace-expansion](https://github.com/juliangruber/brace-expansion)
from 1.1.11 to 1.1.12.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/juliangruber/brace-expansion/releases">brace-expansion's
releases</a>.</em></p>
<blockquote>
<h2>v1.1.12</h2>
<ul>
<li>pkg: publish on tag 1.x  c460dbd</li>
<li>fmt  ccb8ac6</li>
<li>Fix potential ReDoS Vulnerability or Inefficient Regular Expression
(<a
href="https://redirect.github.com/juliangruber/brace-expansion/issues/65">#65</a>)
c3c73c8</li>
</ul>
<hr />
<p><a
href="https://github.com/juliangruber/brace-expansion/compare/v1.1.11...v1.1.12">https://github.com/juliangruber/brace-expansion/compare/v1.1.11...v1.1.12</a></p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="44f33b47c5"><code>44f33b4</code></a>
1.1.12</li>
<li><a
href="c460dbd68e"><code>c460dbd</code></a>
pkg: publish on tag 1.x</li>
<li><a
href="ccb8ac6d42"><code>ccb8ac6</code></a>
fmt</li>
<li><a
href="c3c73c8b08"><code>c3c73c8</code></a>
Fix potential ReDoS Vulnerability or Inefficient Regular Expression (<a
href="https://redirect.github.com/juliangruber/brace-expansion/issues/65">#65</a>)</li>
<li>See full diff in <a
href="https://github.com/juliangruber/brace-expansion/compare/1.1.11...v1.1.12">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=brace-expansion&package-manager=npm_and_yarn&previous-version=1.1.11&new-version=1.1.12)](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 this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/google-a2a/A2A/network/alerts).

</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 <holtskinner@google.com>
2025-06-16 10:00:18 -05:00
kthota-g
f355d3e922
feat: Support for multiple pushNotification config per task (#738)
- Support for list pushNotificationConfig for task
- Support for delete pushNotificationConfig
- Get pushNotificationConfig by id or by task
- update protos to use PushNotificationConfig

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-06-14 14:10:46 -07:00
Mike Smith
70f1e2b0c6
feat: Add protocol support for extensions (#716)
# Description

This updates the protocol to support Extensions. Extension profiles are
documents that describe modifications or additions to the core A2A
profile. AgentCards can declare supported extensions via
`capabilities.extensions`. This declaration can include additional
information via `capabilities.extensions.params`. Clients can use this
as a basis for extension negotiation: if a client supports an extension
that the server supports, the client can then follow the protocol
defined by the extension. This can include, but is not specifically
limited to:

1. Requiring specific structure of messages, such as following a
specific schema for a DataPart.
2. Providing additional information in request/response Message and
Artifact objects via their `metadata` field.
3. Exposing additional methods beyond the core A2A protocol methods.

Messages and Artifacts can now include an indication of which extensions
are present in their content. I do not yet know if extension indications
are necessary on other data structures (such as `MessageSendParams` or
`TaskStatus`). I'd say extension indications are not strictly necessary
at all: it's possible to infer that an extension was followed by
inspecting the message content itself (are the metadata fields you
expect present, does the DataPart follow the schema you expect, etc).
However, they are useful for validation and simplifying extension
implementation logic: "you said you followed this extension, so I'll
validate fields are present and then perform my processing".

Fixes #585

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
2025-06-04 10:17:37 -06:00
Holt Skinner
2e889e25b7
ci: Update Lint rules (#720) 2025-06-03 20:08:50 +00:00
MUTHU K BOMMIAH
7ec8027b5f
docs: replace all references to 'MIME type' with 'Media Type' in code (#713) 2025-06-03 14:38:58 +00:00
Holt Skinner
e5754fe9a0
ci: Fix Dispatch A2A Update to only include first line (#707) 2025-06-02 13:40:01 -05:00
pstephengoogle
89bb5b8243
feat: Add gRPC and REST definitions to A2A protocol specifications (#695)
- Requires adding a new `PushNotificationConfig.id` field to support
multiple push notification callbacks per task

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: Holt Skinner <holtskinner@google.com>
2025-06-02 12:11:28 -06:00
dmandar-google
9f3bb51257
feat(spec): Add an optional iconUrl field to the AgentCard (#687)
New addition to the agentcard: Optional iconUrl field that can point to
an image icon file for the agent.

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-05-29 21:56:55 -07:00
darkhaniop
628380e7e3
fix(spec): Spec inconsistencies and a minor bug (#322)
## Problem

In client-server messaging, the A2A protocol uses the [JSON-RPC
2.0](https://www.jsonrpc.org/specification) format, and the protocol
specification is written using the [JSON-Schema
specification](https://json-schema.org/). Fully complying with the
standards can help validate the payloads more accurately and help better
test different client and server implementations.

In addition to making the A2A spec more compliant with the mentioned
standards, changes in this PR are meant to fix a few minor bugs in the
A2A protocol spec (mismatches from what was implemented in the sample
A2A server and clients.

Addresses issue #353.

## Summary of changes
* Makes field "id" required on requests and responses. This field is
important because, according to the JSON RPC 2.0 spec, a message that
does not have an "id" is considered a notification, and the callee does
not have to send a response to such requests. Similarly, without the
"id" on the responses, the caller cannot correlate the responses to the
pending requests, meaning that fully JSON-RPC-compliant clients would
not be able to resolve such RPC calls.

---
*Edit: clearer wording + add issue references*

*Edit2: the scope of this PR has been reduced due to other updates
fixing parts of the spec, summary items were edited to reflect what has
already been addressed in other PRs.*

---

## (OLD) Summary of changes

* Add a missing definition for "TaskSendParams.acceptedOutputModes"
(described in #354). Fixed in #599.

* Remove "default" values for "const" fields. Compliance with JSON
schema, version `>=draft-6` and reduce ambiguity.
https://json-schema.org/understanding-json-schema/reference/const
Fixed in #599

* Make fields "jsonrpc" and "id" required on requests and responses.
Compliance with JSON-RPC 2.0.

* Make fields "error.code" and "error.message" required on errors. Fixed
in #599.

* In a few places, sort non-top-level dict keys to make them more
aligned with the pydantic JSON schema outputs. Since now, we are
discouraged from editing the spec manually, this item also drops out of
the scope of our concerns.

* The initial commit in this PR also included cleaning up several
unnecessary "null" types, which were addressed more thoroughly in #352.

## (OLD) Additional notes

While I sorted dictionaries within each model so that the keys of each
model would be in the same order as the pydantic-based scripts' exports,
at the same time, **I decided not to sort the top-level keys**
(`$defs/ModelKey`). Because doing so would make the diff ugly and harder
to read the applied changes. The top-level key sorting can be done
afterward.

---------

Co-authored-by: Holt Skinner <13262395+holtskinner@users.noreply.github.com>
Co-authored-by: kthota-g <kcthota@google.com>
2025-05-27 16:20:24 -07:00
Holt Skinner
8580f0a5ed
docs: Convert Spec doc to use includes from types.ts instead of hard-coding (#663)
Prevents file from becoming out of date.
2025-05-27 11:38:11 -05:00
Shingo OKAWA
38c1fa5b23
chore: fix typo in types.ts doc comment (#626)
Signed-off-by: Shingo OKAWA <shingo.okawa.g.h.c@gmail.com>
2025-05-22 09:25:31 -07:00
Holt Skinner
d49241cbc9
ci: Add Auto-generation of a2a.json from types.ts (#620)
Use @a2a-bot to auto-generate `specification/json/a2a.json` whenever
`types/src/types.ts` is updated in a PR.

---------

Co-authored-by: a2a-bot <a2a-bot@google.com>
2025-05-21 12:26:05 -07:00
Holt Skinner
4d4f04f8a6
chore: Formatting for types.ts and a2a.json (#543) 2025-05-21 11:48:09 -07:00
dmandar-google
e0a3070fc2
feat: Add a new boolean for supporting authenticated extended cards (#618)
New boolean field `supportsAuthenticatedExtendedCard` that if true,
indicates an extended agent card is available at an authenticated
endpoint.
2025-05-21 10:35:55 -07:00
dmandar-google
b5f23e885d
fix: Explicitly exclude node_modules when generating json schema. (#613)
Co-authored-by: kthota-g <kcthota@google.com>
2025-05-21 10:23:49 -07:00
Holt Skinner
65d539db3e
docs: Update Information about spec generation (#610) 2025-05-20 14:35:29 -07:00
swapydapy
5368e7728c
feat: Add optional referenceTaskIds for task followups (#608)
### Problem
Clients need to follow up or refine previously created tasks by agents.

### Proposal
**New Task in same contextId (Preferred)**

Context can be thought of as a larger goal from a client perspective.
Clients can use the same contextId from the previous task and send a
message for refinement or followup. Agents should spawn up new tasks.
Tasks cannot restart processing from terminal states (Completed, Failed
and Cancelled).

### Proposed API Change

* Addition of optional `referenceTaskIds` field in the `Message` object.
* Optional addition of `referenceArtifactId` in `part` metadata of
`Message` object.
2025-05-20 12:51:13 -07:00
kthota-g
2d386d49e4
chore: update docstrings for types (#607)
# Description

Thank you for opening a Pull Request!
Before submitting your PR, there are a few things you can do to make
sure it goes smoothly:

- [ ] Follow the [`CONTRIBUTING`
Guide](https://github.com/google/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)

Fixes #<issue_number_goes_here> 馃
2025-05-20 12:33:46 -07:00
kthota-g
50a6d6d916
chore: update main with changes from next (#599)
Changes from `next` to be merged into `main`
2025-05-20 00:41:29 -07:00