55 Commits

Author SHA1 Message Date
Agent2Agent (A2A) Bot
82d36c7fdb
chore(main): release 0.3.13 (#354)
🤖 I have created a release *beep* *boop*
---


##
[0.3.13](https://github.com/a2aproject/a2a-js/compare/v0.3.12...v0.3.13)
(2026-03-16)


### Bug Fixes

* properly parse ProtoJSON body for POST pushNotificationConfigs
([#352](https://github.com/a2aproject/a2a-js/issues/352))
([57696a8](57696a8001)),
closes [#336](https://github.com/a2aproject/a2a-js/issues/336)

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-03-16 12:03:41 +01:00
Agent2Agent (A2A) Bot
321d331b67
chore(main): release 0.3.12 (#348)
🤖 I have created a release *beep* *boop*
---


##
[0.3.12](https://github.com/a2aproject/a2a-js/compare/v0.3.11...v0.3.12)
(2026-03-10)


### Bug Fixes

* Fixing missing push configuration after normalization for rest
transport ([#346](https://github.com/a2aproject/a2a-js/issues/346))
([54ac8c4](54ac8c41ca))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-03-10 16:29:26 +01:00
Agent2Agent (A2A) Bot
d45c212ea6
chore(main): release 0.3.11 (#320)
🤖 I have created a release *beep* *boop*
---


##
[0.3.11](https://github.com/a2aproject/a2a-js/compare/v0.3.10...v0.3.11)
(2026-03-10)


### Bug Fixes

* support proto-based AgentCard in AgentCardResolver
([#344](https://github.com/a2aproject/a2a-js/issues/344))
([e71221c](e71221cbc8))
* throw on JSON-RPC response id mismatch
([#318](https://github.com/a2aproject/a2a-js/issues/318))
([5ea1c94](5ea1c94aca))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-03-10 10:04:36 +01:00
Ivan Shymko
40b840d754
build: integrate betterer to progress with strict mode (#329)
1. Integrate
[betterer](https://phenomnomnominal.github.io/betterer/docs/introduction)
and enable strict mode test to stop introducing more errors.
2. Refactor `npm` scripts to integrate this workflow better: `npm run
lint` will do all safe automatic fixes (from both linters and betterer),
while `npm run lint:ci` will strictly fail if formatting changes or
betterer update is required.

Doing this before 1.0 work (#321) as many code changes are going to be
required either way.

Re #182

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2026-02-12 11:58:46 +01:00
Agent2Agent (A2A) Bot
e056416335
chore(main): release 0.3.10 (#312)
🤖 I have created a release *beep* *boop*
---


##
[0.3.10](https://github.com/a2aproject/a2a-js/compare/v0.3.9...v0.3.10)
(2026-01-27)


### Bug Fixes

* do not use ReadableStream async iterator in SSE stream parsing
([#311](https://github.com/a2aproject/a2a-js/issues/311))
([5359fa8](5359fa802f))
* preserve typed error as cause in SSE errors
([#315](https://github.com/a2aproject/a2a-js/issues/315))
([d39544e](d39544ea4b))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-02-03 09:59:14 +01:00
dependabot[bot]
fa8a7f5581
chore(deps): bump wrangler and @cloudflare/vitest-pool-workers (#309)
Bumps
[wrangler](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler)
to 4.59.3 and updates ancestor dependency
[@cloudflare/vitest-pool-workers](https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers).
These dependencies need to be updated together.

Updates `wrangler` from 4.54.0 to 4.59.3
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/cloudflare/workers-sdk/releases">wrangler's
releases</a>.</em></p>
<blockquote>
<h2>wrangler@4.59.3</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/9396">#9396</a>
<a
href="75386b1f14"><code>75386b1</code></a>
Thanks <a href="https://github.com/gnekich"><code>@​gnekich</code></a>!
- Fix <code>wrangler login</code> with custom
<code>callback-host</code>/<code>callback-port</code></p>
<p>The Cloudflare OAuth API always requires the
<code>redirect_uri</code> to be <code>localhost:8976</code>. However,
sometimes the Wrangler OAuth server needed to listen on a different
host/port, for example when running from inside a container. We were
previously incorrectly setting the <code>redirect_uri</code> to the
configured callback host/port, but it needs to be up to the user to map
<code>localhost:8976</code> to the Wrangler OAuth server in the
container.</p>
<p><strong>Example:</strong></p>
<p>You might run Wrangler inside a docker container like this:
<code>docker run -p 8989:8976 &lt;image&gt;</code>, which forwards port
8976 on your host to 8989 inside the container.</p>
<p>Then inside the container, run <code>wrangler login
--callback-host=0.0.0.0 --callback-port=8989</code></p>
<p>The OAuth link still has a <code>redirect_uri</code> set
to<code>localhost:8976</code>. For example
<code>https://dash.cloudflare.com/oauth2/auth?...&amp;redirect_uri=http%3A%2F%2Flocalhost%3A8976%2Foauth%2Fcallback&amp;...</code></p>
<p>However the redirect to<code> localhost:8976</code> is then forwarded
to the Wrangler OAuth server inside your container, allowing the login
to complete.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11925">#11925</a>
<a
href="8e4a0e5e8d"><code>8e4a0e5</code></a>
Thanks <a
href="https://github.com/apps/dependabot"><code>@​dependabot</code></a>!
- chore: update dependencies of &quot;miniflare&quot;,
&quot;wrangler&quot;</p>
<p>The following dependency versions have been updated:</p>
<table>
<thead>
<tr>
<th>Dependency</th>
<th>From</th>
<th>To</th>
</tr>
</thead>
<tbody>
<tr>
<td>workerd</td>
<td>1.20260114.0</td>
<td>1.20260115.0</td>
</tr>
</tbody>
</table>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11942">#11942</a>
<a
href="133bf95783"><code>133bf95</code></a>
Thanks <a
href="https://github.com/penalosa"><code>@​penalosa</code></a>! - chore:
update dependencies of &quot;miniflare&quot;, &quot;wrangler&quot;</p>
<p>The following dependency versions have been updated:</p>
<table>
<thead>
<tr>
<th>Dependency</th>
<th>From</th>
<th>To</th>
</tr>
</thead>
<tbody>
<tr>
<td>workerd</td>
<td>1.20260115.0</td>
<td>1.20260116.0</td>
</tr>
</tbody>
</table>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11922">#11922</a>
<a
href="93d8d78ce0"><code>93d8d78</code></a>
Thanks <a
href="https://github.com/dario-piotrowicz"><code>@​dario-piotrowicz</code></a>!
- Improve telemetry errors being sent to Sentry by <code>wrangler
init</code> when it delegates to C3 by ensuring that they contain the
output of the C3 execution.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11940">#11940</a>
<a
href="69ff962048"><code>69ff962</code></a>
Thanks <a
href="https://github.com/penalosa"><code>@​penalosa</code></a>! - Show
helpful messages for file not found errors (<code>ENOENT</code>)</p>
<p>When users encounter file not found errors, Wrangler now displays a
helpful message with the missing file path and common causes, instead of
reporting to Sentry.</p>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11904">#11904</a>
<a
href="22727c29ee"><code>22727c2</code></a>
Thanks <a
href="https://github.com/danielrs"><code>@​danielrs</code></a>! - Fix
false positive infinite loop detection for exact path redirects</p>
<p>Fixed an issue where the redirect validation incorrectly flagged
exact path redirects like <code>/ /index.html 200</code> as infinite
loops. This was particularly problematic when <code>html_handling</code>
is set to &quot;none&quot;, where such redirects are valid.</p>
<p>The fix makes the validation more specific to only block wildcard
patterns (like <code>/* /index.html</code>) that would actually cause
infinite loops, while allowing exact path matches that are valid in
certain configurations.</p>
<p>Fixes: <a
href="https://redirect.github.com/cloudflare/workers-sdk/issues/11824">cloudflare/workers-sdk#11824</a></p>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11946">#11946</a>
<a
href="fa39a73040"><code>fa39a73</code></a>
Thanks <a
href="https://github.com/MattieTK"><code>@​MattieTK</code></a>! - Fix
<code>configFileName</code> returning wrong filename for
<code>.jsonc</code> config files</p>
<p>Previously, users with a <code>wrangler.jsonc</code> config file
would see error messages and hints referring to
<code>wrangler.json</code> instead of <code>wrangler.jsonc</code>. This
was because the <code>configFormat</code> function collapsed both
<code>.json</code> and <code>.jsonc</code> files into a single
<code>&quot;jsonc&quot;</code> value, losing the distinction between
them.</p>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="0c7e1f4bd4"><code>0c7e1f4</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11937">#11937</a>)</li>
<li><a
href="75386b1f14"><code>75386b1</code></a>
Always pass a valid <code>redirect_uri</code> callback parameter
(<code>localhost:8976</code>) to C...</li>
<li><a
href="d58fbd1189"><code>d58fbd1</code></a>
Wrangler: Make <code>name</code> the positional argument for
<code>wrangler delete</code> instead o...</li>
<li><a
href="133bf95783"><code>133bf95</code></a>
Add <code>MessageBuilder</code> support for Email Sending API in local
mode (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11942">#11942</a>)</li>
<li><a
href="4ac7c82609"><code>4ac7c82</code></a>
[wrangler] Include version components in command event metrics (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11968">#11968</a>)</li>
<li><a
href="69ff962048"><code>69ff962</code></a>
Reduce more Sentry noise (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11940">#11940</a>)</li>
<li><a
href="029531acd2"><code>029531a</code></a>
Wrangler: cache chosen account in memory to avoid repeated prompts (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11962">#11962</a>)</li>
<li><a
href="bc70bfa486"><code>bc70bfa</code></a>
Re-enable Media binding e2e tests (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11954">#11954</a>)</li>
<li><a
href="93d8d78ce0"><code>93d8d78</code></a>
Ensure that <code>wrangler init</code> includes C3 error details when
reporting to Sentr...</li>
<li><a
href="fa39a73040"><code>fa39a73</code></a>
fix(wrangler): return correct config filename for .jsonc files (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/wrangler/issues/11946">#11946</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/cloudflare/workers-sdk/commits/wrangler@4.59.3/packages/wrangler">compare
view</a></li>
</ul>
</details>
<br />

Updates `@cloudflare/vitest-pool-workers` from 0.10.15 to 0.12.5
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/cloudflare/workers-sdk/releases"><code>@​cloudflare/vitest-pool-workers</code>'s
releases</a>.</em></p>
<blockquote>
<h2><code>@​cloudflare/vitest-pool-workers</code><a
href="https://github.com/0"><code>@​0</code></a>.12.5</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11967">#11967</a>
<a
href="202c59e4f4"><code>202c59e</code></a>
Thanks <a
href="https://github.com/emily-shen"><code>@​emily-shen</code></a>! -
chore: update undici</p>
<p>The following dependency versions have been updated:</p>
<table>
<thead>
<tr>
<th>Dependency</th>
<th>From</th>
<th>To</th>
</tr>
</thead>
<tbody>
<tr>
<td>undici</td>
<td>7.14.0</td>
<td>7.18.2</td>
</tr>
</tbody>
</table>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11943">#11943</a>
<a
href="25e2c608d5"><code>25e2c60</code></a>
Thanks <a href="https://github.com/vicb"><code>@​vicb</code></a>! - Bump
capnp-es to ^0.0.14</p>
</li>
<li>
<p>Updated dependencies [<a
href="75386b1f14"><code>75386b1</code></a>,
<a
href="8e4a0e5e8d"><code>8e4a0e5</code></a>,
<a
href="133bf95783"><code>133bf95</code></a>,
<a
href="93d8d78ce0"><code>93d8d78</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>,
<a
href="22727c29ee"><code>22727c2</code></a>,
<a
href="fa39a73040"><code>fa39a73</code></a>,
<a
href="4ac7c82609"><code>4ac7c82</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>,
<a
href="029531acd2"><code>029531a</code></a>,
<a
href="d58fbd1189"><code>d58fbd1</code></a>,
<a
href="202c59e4f4"><code>202c59e</code></a>,
<a
href="133bf95783"><code>133bf95</code></a>,
<a
href="25e2c608d5"><code>25e2c60</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>]:</p>
<ul>
<li>wrangler@4.59.3</li>
<li>miniflare@4.20260116.0</li>
</ul>
</li>
</ul>
<h2><code>@​cloudflare/vitest-pool-workers</code><a
href="https://github.com/0"><code>@​0</code></a>.12.4</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11898">#11898</a>
<a
href="c17e971af0"><code>c17e971</code></a>
Thanks <a
href="https://github.com/petebacondarwin"><code>@​petebacondarwin</code></a>!
- Bundle more third-party dependencies to reduce supply chain risk</p>
<p>Previously, several small utility packages were listed as runtime
dependencies and
installed separately. These are now bundled directly into the published
packages,
reducing the number of external dependencies users need to trust.</p>
<p>Bundled dependencies:</p>
<ul>
<li><strong>miniflare</strong>: <code>acorn</code>,
<code>acorn-walk</code>, <code>exit-hook</code>,
<code>glob-to-regexp</code>, <code>stoppable</code></li>
<li><strong>kv-asset-handler</strong>: <code>mime</code></li>
<li><strong>vite-plugin-cloudflare</strong>:
<code>@remix-run/node-fetch-server</code>, <code>defu</code>,
<code>get-port</code>, <code>picocolors</code>,
<code>tinyglobby</code></li>
<li><strong>vitest-pool-workers</strong>: <code>birpc</code>,
<code>devalue</code>, <code>get-port</code>, <code>semver</code></li>
</ul>
</li>
<li>
<p>Updated dependencies [<a
href="e78186dae9"><code>e78186d</code></a>,
<a
href="fe4faa3066"><code>fe4faa3</code></a>,
<a
href="4714ca12c1"><code>4714ca1</code></a>,
<a
href="c17e971af0"><code>c17e971</code></a>,
<a
href="695b043b4d"><code>695b043</code></a>]:</p>
<ul>
<li>miniflare@4.20260114.0</li>
<li>wrangler@4.59.2</li>
</ul>
</li>
</ul>
<h2><code>@​cloudflare/vitest-pool-workers</code><a
href="https://github.com/0"><code>@​0</code></a>.12.3</h2>
<h3>Patch Changes</h3>
<ul>
<li>Updated dependencies [<a
href="99b1f328a9"><code>99b1f32</code></a>]:
<ul>
<li>wrangler@4.59.1</li>
</ul>
</li>
</ul>
<h2><code>@​cloudflare/vitest-pool-workers</code><a
href="https://github.com/0"><code>@​0</code></a>.12.2</h2>
<h3>Patch Changes</h3>
<ul>
<li>Updated dependencies [<a
href="b0e54b26f2"><code>b0e54b2</code></a>,
<a
href="ed60c4f01c"><code>ed60c4f</code></a>,
<a
href="faa5753fa6"><code>faa5753</code></a>,
<a
href="e574ef3e73"><code>e574ef3</code></a>,
<a
href="b6148ed733"><code>b6148ed</code></a>,
<a
href="ab3859c597"><code>ab3859c</code></a>,
<a
href="0eb973deb5"><code>0eb973d</code></a>,
<a
href="ad65efa73a"><code>ad65efa</code></a>,
<a
href="fc96e5fe11"><code>fc96e5f</code></a>,
<a
href="43d5363c7b"><code>43d5363</code></a>,
<a
href="0f8d69d310"><code>0f8d69d</code></a>]:
<ul>
<li>wrangler@4.59.0</li>
<li>miniflare@4.20260111.0</li>
</ul>
</li>
</ul>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/cloudflare/workers-sdk/blob/main/packages/vitest-pool-workers/CHANGELOG.md"><code>@​cloudflare/vitest-pool-workers</code>'s
changelog</a>.</em></p>
<blockquote>
<h2>0.12.5</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11967">#11967</a>
<a
href="202c59e4f4"><code>202c59e</code></a>
Thanks <a
href="https://github.com/emily-shen"><code>@​emily-shen</code></a>! -
chore: update undici</p>
<p>The following dependency versions have been updated:</p>
<table>
<thead>
<tr>
<th>Dependency</th>
<th>From</th>
<th>To</th>
</tr>
</thead>
<tbody>
<tr>
<td>undici</td>
<td>7.14.0</td>
<td>7.18.2</td>
</tr>
</tbody>
</table>
</li>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11943">#11943</a>
<a
href="25e2c608d5"><code>25e2c60</code></a>
Thanks <a href="https://github.com/vicb"><code>@​vicb</code></a>! - Bump
capnp-es to ^0.0.14</p>
</li>
<li>
<p>Updated dependencies [<a
href="75386b1f14"><code>75386b1</code></a>,
<a
href="8e4a0e5e8d"><code>8e4a0e5</code></a>,
<a
href="133bf95783"><code>133bf95</code></a>,
<a
href="93d8d78ce0"><code>93d8d78</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>,
<a
href="22727c29ee"><code>22727c2</code></a>,
<a
href="fa39a73040"><code>fa39a73</code></a>,
<a
href="4ac7c82609"><code>4ac7c82</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>,
<a
href="029531acd2"><code>029531a</code></a>,
<a
href="d58fbd1189"><code>d58fbd1</code></a>,
<a
href="202c59e4f4"><code>202c59e</code></a>,
<a
href="133bf95783"><code>133bf95</code></a>,
<a
href="25e2c608d5"><code>25e2c60</code></a>,
<a
href="69ff962048"><code>69ff962</code></a>]:</p>
<ul>
<li>wrangler@4.59.3</li>
<li>miniflare@4.20260116.0</li>
</ul>
</li>
</ul>
<h2>0.12.4</h2>
<h3>Patch Changes</h3>
<ul>
<li>
<p><a
href="https://redirect.github.com/cloudflare/workers-sdk/pull/11898">#11898</a>
<a
href="c17e971af0"><code>c17e971</code></a>
Thanks <a
href="https://github.com/petebacondarwin"><code>@​petebacondarwin</code></a>!
- Bundle more third-party dependencies to reduce supply chain risk</p>
<p>Previously, several small utility packages were listed as runtime
dependencies and
installed separately. These are now bundled directly into the published
packages,
reducing the number of external dependencies users need to trust.</p>
<p>Bundled dependencies:</p>
<ul>
<li><strong>miniflare</strong>: <code>acorn</code>,
<code>acorn-walk</code>, <code>exit-hook</code>,
<code>glob-to-regexp</code>, <code>stoppable</code></li>
<li><strong>kv-asset-handler</strong>: <code>mime</code></li>
<li><strong>vite-plugin-cloudflare</strong>:
<code>@remix-run/node-fetch-server</code>, <code>defu</code>,
<code>get-port</code>, <code>picocolors</code>,
<code>tinyglobby</code></li>
<li><strong>vitest-pool-workers</strong>: <code>birpc</code>,
<code>devalue</code>, <code>get-port</code>, <code>semver</code></li>
</ul>
</li>
<li>
<p>Updated dependencies [<a
href="e78186dae9"><code>e78186d</code></a>,
<a
href="fe4faa3066"><code>fe4faa3</code></a>,
<a
href="4714ca12c1"><code>4714ca1</code></a>,
<a
href="c17e971af0"><code>c17e971</code></a>,
<a
href="695b043b4d"><code>695b043</code></a>]:</p>
<ul>
<li>miniflare@4.20260114.0</li>
<li>wrangler@4.59.2</li>
</ul>
</li>
</ul>
<h2>0.12.3</h2>
<h3>Patch Changes</h3>
<ul>
<li>Updated dependencies [<a
href="99b1f328a9"><code>99b1f32</code></a>]:
<ul>
<li>wrangler@4.59.1</li>
</ul>
</li>
</ul>
<h2>0.12.2</h2>
<h3>Patch Changes</h3>
<!-- raw HTML omitted -->
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="0c7e1f4bd4"><code>0c7e1f4</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11937">#11937</a>)</li>
<li><a
href="9f59043888"><code>9f59043</code></a>
fix(vitest-pool-workers): suppress deprecation warnings in test
subprocesses ...</li>
<li><a
href="25e2c608d5"><code>25e2c60</code></a>
Bump capnp-es to ^0.0.14 (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11943">#11943</a>)</li>
<li><a
href="bca7114b51"><code>bca7114</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11903">#11903</a>)</li>
<li><a
href="c17e971af0"><code>c17e971</code></a>
chore: add CI validation for external package dependencies (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11898">#11898</a>)</li>
<li><a
href="37a8607161"><code>37a8607</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11890">#11890</a>)</li>
<li><a
href="e98c95aa22"><code>e98c95a</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11836">#11836</a>)</li>
<li><a
href="455361bfbe"><code>455361b</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11819">#11819</a>)</li>
<li><a
href="f97860992d"><code>f978609</code></a>
Version Packages (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11700">#11700</a>)</li>
<li><a
href="6a05b1cdf8"><code>6a05b1c</code></a>
chore(deps): update zod from ^3.22.3 to ^3.25.76 (<a
href="https://github.com/cloudflare/workers-sdk/tree/HEAD/packages/vitest-pool-workers/issues/11493">#11493</a>)</li>
<li>Additional commits viewable in <a
href="https://github.com/cloudflare/workers-sdk/commits/@cloudflare/vitest-pool-workers@0.12.5/packages/vitest-pool-workers">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 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/a2aproject/a2a-js/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-01-22 08:10:41 +01:00
Agent2Agent (A2A) Bot
3d9a052fe8
chore(main): release 0.3.9 (#298)
🤖 I have created a release *beep* *boop*
---


## [0.3.9](https://github.com/a2aproject/a2a-js/compare/v0.3.8...v0.3.9)
(2026-01-21)


### Features

* implement gRPC client
([#299](https://github.com/a2aproject/a2a-js/issues/299))
([dbdb96e](dbdb96eeb1))
* implement gRPC server
([#279](https://github.com/a2aproject/a2a-js/issues/279))
([bd4caa2](bd4caa22a0))


### Bug Fixes

* use proto default values in generated a2a_types.ts
([#303](https://github.com/a2aproject/a2a-js/issues/303))
([0215d42](0215d42326))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-01-21 17:36:58 +01:00
Guglielmo Colombo
dbdb96eeb1
feat: implement gRPC client (#299)
# Description

This PR extends the implementation of grpc to Client.
A new index.js is created to export the grpc specific functions,
preventing the need for every client to install the `grpc/js` package

Release-As: 0.3.9

Fixes #275  🦕

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Ivan Shymko <vana.shimko@gmail.com>
2026-01-19 16:15:51 +01:00
Ivan Shymko
f1626afa2a
build: remove gts dev dependency (#301)
# Description

1. Set `clean: true` in `tsup.config.ts` which enables `Clean output
directory before each build`.
2. Remove `gts` dev dependency as it has a lot of transitive
dependencies and was only used in `clean` script which just removes the
output directory.
2026-01-16 11:32:52 +01:00
Guglielmo Colombo
bd4caa22a0
feat: implement GRPC server (#279)
# Description

This Pull Request implements server-side support for the gRPC transport
protocol.

**Schema and Generation**
The implementation is based on [A2A Proto Specification
v3.0.0](https://raw.githubusercontent.com/a2aproject/A2A/v0.3.0/specification/grpc/a2a.proto).

**Tooling**
ts-proto was adopted for generating TypeScript service definitions (with
buf), which will reuse the message types previously generated (this
requires a manual modification of the generated file).

**Limitations**
Due to the current dependency on Proto v3.0.0, the gRPC implementation
is missing some APIs already available for other transports, for example
the `getExtendedAuthenticatedAgentCard` method.
These missing endpoints will be implemented with future official
releases of proto specification.

**Entry Points**
A new dedicated entry point has been introduced to export the gRPC
server logic and @grpc/grpc-js and its related transport libraries have
been added as peer dependencies.

Fixes #275  🦕

Release-As: 0.3.9

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Ivan Shymko <ishymko@google.com>
Co-authored-by: Ivan Shymko <vana.shimko@gmail.com>
2026-01-15 13:56:11 +01:00
Agent2Agent (A2A) Bot
7f8bb6bb1d
chore(main): release 0.3.8 (#283)
🤖 I have created a release *beep* *boop*
---


## [0.3.8](https://github.com/a2aproject/a2a-js/compare/v0.3.7...v0.3.8)
(2026-01-15)


### ⚠ BREAKING CHANGES

* use ProtoJSON for REST transport
([#292](https://github.com/a2aproject/a2a-js/issues/292))

### Features

* use case-insensitive transport protocol name comparison in
ClientFactory
([5246067](5246067f5f))


### Bug Fixes

* add typesVersions to support legacy module resolution
([#288](https://github.com/a2aproject/a2a-js/issues/288))
([6499e29](6499e290f6))
* use ProtoJSON for REST transport
([#292](https://github.com/a2aproject/a2a-js/issues/292))
([d2efc4c](d2efc4cf34))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2026-01-15 10:32:57 +01:00
Aryan Raj
6499e290f6
fix: add typesVersions to support legacy module resolution (#288)
# 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/google-a2a/a2a-js/blob/main/CONTRIBUTING.md).
- [x] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- Important Prefixes for
[release-please](https://github.com/googleapis/release-please):
- `fix:` which represents bug fixes, and correlates to a
[SemVer](https://semver.org/) patch.
- `feat:` represents a new feature, and correlates to a SemVer minor.
- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking
change (indicated by the `!`) and will result in a SemVer major.
- [x] Ensure the tests and linter pass
- [x] Appropriate docs were updated (if necessary)

Fixes #287  🦕
2026-01-15 08:47:49 +01:00
Agent2Agent (A2A) Bot
5046f3a546
chore(main): release 0.3.7 (#260)
🤖 I have created a release *beep* *boop*
---


## [0.3.7](https://github.com/a2aproject/a2a-js/compare/v0.3.6...v0.3.7)
(2025-12-17)


### Features

* add rest client
([#258](https://github.com/a2aproject/a2a-js/issues/258))
([96be3a1](96be3a1d6c))
* remove EventEmitter dependency to support Edge Runtime
([#219](https://github.com/a2aproject/a2a-js/issues/219))
([6c76fef](6c76fef264)),
closes [#218](https://github.com/a2aproject/a2a-js/issues/218)


### Bug Fixes

* export transport agnostic errors from client
([#272](https://github.com/a2aproject/a2a-js/issues/272))
([23cd42e](23cd42e83d))
* pass ServerCallContext to getAuthenticatedExtendedAgentCard for REST
([#274](https://github.com/a2aproject/a2a-js/issues/274))
([89b141b](89b141b5ba)),
closes [#137](https://github.com/a2aproject/a2a-js/issues/137)

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-12-17 16:01:41 +01:00
Ivan Shymko
98b8908788
test: run tests on Edge environment (#271)
# Description

Implemented according to
https://github.com/a2aproject/a2a-js/issues/237#issuecomment-3654100699.

1. Downgrade to vitest 3 to enable
[`@cloudflare/vitest-pool-workers`](https://developers.cloudflare.com/workers/testing/vitest-integration/).
2. Disable tests which have Express dependencies.
3. Remove listener errors tests from event bus: even on Node.js
EventEmitter erroring out inside listener results in uncaught exception
which stops the process by default, with this behavior running (or not
running) other listeners makes no difference. The workaround in test is
Node.js specific.
4. Explicitly define inclusions and exclusions for coverage, as this
behavior changed after downgrade.
5. Update static esbuild test to run on server entry point as well.

Fixes #237, re #218
2025-12-17 14:27:18 +01:00
Ivan Shymko
2829681182
test: remove sinon dependency and use vitest for mocking (#261)
# Description

Follow-up for #254.

Also related to
https://github.com/a2aproject/a2a-js/issues/237#issuecomment-3654100699:
an attempt to run current tests on `@cloudflare/vitest-pool-workers`
fails with `Disallowed operation called within global scope` coming from
`sinon`. A quick try to replace one file with pure vitest worked, even
if there're going to be other blockers for running proper Edge runtime
tests this change removes extra dependency.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-12-17 11:14:24 +00:00
Drew Foxall
6c76fef264
feat: remove EventEmitter dependency to support Edge Runtime (#219)
## Summary

This PR addresses [issue
#218](https://github.com/a2aproject/a2a-js/issues/218) by replacing the
Node.js-specific `EventEmitter` with the web-standard `EventTarget` API,
enabling the SDK to run natively on edge runtimes (Cloudflare Workers,
Deno, Bun) without requiring Node.js compatibility modes.

## Changes

### Replace EventEmitter with EventTarget

**File:** `src/server/events/execution_event_bus.ts`

- Removes Node.js `events` module dependency
- Uses web-standard `EventTarget` API available in all modern runtimes
- Maintains backward-compatible API (`on`, `off`, `once`,
`removeAllListeners`)
- Adds `ExecutionEventName` type alias for `'event' | 'finished'`
- Includes `CustomEvent` polyfill for Node.js 15-18 (built-in from
Node.js 19+)

## Implementation Details

### EventEmitter Behavior Compatibility

The implementation faithfully replicates EventEmitter semantics:

- **FIFO dispatch order** - Listeners fire in the order they were
registered
- **`this` context** - Listeners are invoked with `this` bound to the
event bus instance
- **Memory semantics** - Listeners are held via strong references until
explicitly removed (identical to EventEmitter)

### Type Safety

- Uses type guards (`isAgentExecutionCustomEvent`) for safe runtime
narrowing - no unsafe casts
- `'finished'` event listeners are invoked with no arguments (using
`Function.prototype.call`) matching EventEmitter behavior
- Internal listener tracking uses `readonly` Maps

## Benefits

- ✅ **Native Cloudflare Workers support** - No `nodejs_compat` flag
needed
- ✅ **Native Deno support** - No `npm:` shims required  
- ✅ **Native Bun support** - Full web API compatibility
- ✅ **Browser compatibility** - True universal JavaScript
- ✅ **Node.js 15+** - EventTarget is built-in

## Breaking Changes

- Requires **Node.js 15+** (EventTarget support)
- Node.js 14 no longer supported (EOL anyway)

## Testing

- All **146 existing tests pass** with these changes
- Added **27 new tests** for `DefaultExecutionEventBus` covering:
  - Basic `on`/`off`/`once` functionality
  - Multiple registrations of same listener
  - `once()` auto-cleanup behavior
  - `removeAllListeners()` for specific events and all events
  - Event firing order (FIFO)
  - Method chaining
  - `this` context binding

## Related Work

I've implemented and tested these changes in my fork:
- Fork: https://github.com/drew-foxall/a2a-js-sdk
- Working Hono implementation:
https://github.com/drew-foxall/a2a-js-sdk-examples

Closes #218

Release-As: 0.3.7
2025-12-15 08:28:25 +01:00
Ivan Shymko
7f19bc4ee4
test: migrate to vitest (#254)
# Description

Migrate from mocha and chai to vitest to prepare for testing on both
Node and Edge server runtimes (see [vitest
environment](https://vitest.dev/guide/environment)) and also potentially
running non-server tests with headless browsers.

Re #237
2025-12-11 10:36:30 +00:00
Agent2Agent (A2A) Bot
a206d13c51
chore(main): release 0.3.6 (#181)
🤖 I have created a release *beep* *boop*
---


## [0.3.6](https://github.com/a2aproject/a2a-js/compare/v0.3.5...v0.3.6)
(2025-12-10)


### Features

* add support for extendedAgentCard on client side
([#234](https://github.com/a2aproject/a2a-js/issues/234))
([3073376](3073376f7c))
* Add support for extension headers on client side
([#227](https://github.com/a2aproject/a2a-js/issues/227))
([8c57002](8c57002add))
* implement client interceptors
([#223](https://github.com/a2aproject/a2a-js/issues/223))
([5694c22](5694c22e3b))
* Implement extended card support on server side
([#197](https://github.com/a2aproject/a2a-js/issues/197))
([45014ac](45014ac4a1))
* implement server http+json
([#142](https://github.com/a2aproject/a2a-js/issues/142))
([f20e662](f20e66247d))
* introduce AgentCardResolver
([#225](https://github.com/a2aproject/a2a-js/issues/225))
([ddaf7de](ddaf7ded16))
* introduce transport agnostic client
([#198](https://github.com/a2aproject/a2a-js/issues/198))
([94a9848](94a9848399))
* server side support for extensions
([5ef7396](5ef7396075))
* support authentication on server side
([#195](https://github.com/a2aproject/a2a-js/issues/195))
([9872d93](9872d93622))


### Bug Fixes

* handle errors occurred in non-blocking sendMessage
([#187](https://github.com/a2aproject/a2a-js/issues/187))
([e55c0f4](e55c0f4791))


### Miscellaneous Chores

* set version to 0.3.6
([#191](https://github.com/a2aproject/a2a-js/issues/191))
([3f8cea0](3f8cea066e))

---
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: Ivan Shymko <ishymko@google.com>
2025-12-10 16:02:35 +00:00
Ivan Shymko
bdddac42d1
chore: properly configure license field in package.json (#238)
# Description


Currently license is shown as `none` on npm:
https://www.npmjs.com/package/@a2a-js/sdk.
2025-12-08 16:26:05 +01:00
Guglielmo Colombo
a0cc13575c
refactor: create a dedicated package.json for samples (#216)
# Description

This PR creates a new `package.json` in the `samples` folder, not to
pollute the main `package.json` with libraries specific to the samples.
2025-11-28 15:48:52 +00:00
Guglielmo Colombo
31c1a6e822
build: run tsc --noEmit on lint (#214)
# Description

`tsup` does not perform strict type checking before the generation of
the `d.ts` files. Adding the `tsc --noEmit` step checks for types
violation.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Ivan Shymko <vana.shimko@gmail.com>
2025-11-28 11:36:30 +00:00
Ivan Shymko
86f6cfaacd
ci: use esbuild to ensure client and root entry points build for browser (#210)
# Description

Add an automated test for the issue solved previously in #46 to ensure
that client and root entry points build for browsers.

Example failure would look like:

```
✘ [ERROR] Could not resolve "events"

    dist/server/index.js:27:29:
      27 │ import { EventEmitter } from "events";
         ╵                              ~~~~~~~~

  The package "events" wasn't found on the file system but is built into node. Are you trying to
  bundle for node? You can use "--platform=node" to do that, which will remove this error.
```

(obtained by running `esbuild ./dist/server/index.js --bundle
--platform=browser --outdir=dist/tmp-checks --outbase=./dist`)

---------

Co-authored-by: Guglielmo Colombo <guglielmoc@google.com>
2025-11-27 15:36:26 +00:00
Ivan Shymko
94a9848399
feat: introduce transport agnostic client (#198)
# Description

As a next step after #169, define a transport agnostic client.

# Changes

## Main
- Define `Client` built around core types, not JSON-RPC wrappers.
- Define `ClientFactory` to dynamically select transport among available
based on agent card and factory level preferences.

## Misc
- Rename `A2ATransport` to `Transport` (this type is not yet exported
via `index.ts`).
- Add `AbortSignal` to `Transport` and new client for cancellation.
- Add basic E2E test for `sendMessage` and `sendMessageStream` using
server SDK wired up with real expressjs app and invoked via newly
created client.
- Fix `getTaskPushNotificationConfig` types in transport.

# TODOs
- Client interceptors.
- Extensions support.

Re #137, #142

Release-As: 0.3.6
2025-11-27 16:16:30 +01:00
Ivan Shymko
4f07c0dad5
build: explicitly install eslint-config-prettier for local linter runs (#189)
# Description

Fix `Error: Cannot find module 'eslint-config-prettier'` when doing `npm
run lint` locally.
2025-11-18 17:49:15 +01:00
Guglielmo Colombo
542c5fba70
ci: integrate prettier check in github workflow (#185)
# Description

This PR integrates the prettier check in the github workflow to ensure
the code respects the correct formatting standards

Fixes #177  🦕

---------

Co-authored-by: Ivan Shymko <vana.shimko@gmail.com>
2025-11-18 17:06:18 +01:00
Guglielmo Colombo
e7e8f35d5d
ci: introduce workflow for linter (#183)
# Description

This pull request introduces a new ESLint configuration file,
`eslint.config.mjs` to standardize code quality and style across the
project.

Here's a summary of the key changes:

- ESLint Setup with TypeScript and Prettier Integration: The
configuration now leverages @eslint/js and typescript-eslint for linting
of TypeScript code. eslint-config-prettier is included to disable any
ESLint rules that might conflict with Prettier's formatting, which will
be included in a new PR.
- Ignored Files: The dist/ and node_modules/ directories are explicitly
ignored to prevent linting of generated output and third-party
dependencies.

Custom Rule Adjustments:

- @typescript-eslint/no-explicit-any is turned off to allow the use of
the any type where necessary.
- @typescript-eslint/no-unused-vars is configured to ignore unused
arguments and caught errors that are prefixed with an underscore (_).
This is a common pattern to signal intentional unused variables.

Test File Specific Rules: 
- @typescript-eslint/no-unused-expressions is turned off to accommodate
testing libraries like Chai, which often use expression-based
assertions.
- @typescript-eslint/no-unsafe-function-type is turned off to allow more
flexible function type usage within test contexts.

Node.js Global Variables: The configuration now includes globals.node to
correctly recognize Node.js global variables, preventing false positives
for undefined variables in Node.js environments.


The changes in other files in this PR are necessary for the linter
checks to pass. They involve mainly the removal of unused parameters.


Re #177  🦕
2025-11-17 16:30:29 +01:00
Guglielmo Colombo
5ef7396075
feat: server side support for extensions (#171)
# Description

The code submitted in the PR introduces the support for extensions on
the server side.

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/google-a2a/a2a-js/blob/main/CONTRIBUTING.md).
- [x] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- Important Prefixes for
[release-please](https://github.com/googleapis/release-please):
- `fix:` which represents bug fixes, and correlates to a
[SemVer](https://semver.org/) patch.
- `feat:` represents a new feature, and correlates to a SemVer minor.
- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking
change (indicated by the `!`) and will result in a SemVer major.
- [x] Ensure the tests and linter pass
- [x] Appropriate docs were updated (if necessary)

Fixes #170 🦕

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
2025-11-17 10:13:21 +01:00
Agent2Agent (A2A) Bot
9a633164e8
chore(main): release 0.3.5 (#131)
🤖 I have created a release *beep* *boop*
---


## [0.3.5](https://github.com/a2aproject/a2a-js/compare/v0.3.4...v0.3.5)
(2025-11-05)


### Bug Fixes

* cancel/task now returns the expected 'cancelled' task status
([#158](https://github.com/a2aproject/a2a-js/issues/158))
([3eec0bd](3eec0bd98a))
* correct the default value in the agentCardPath comment
([#130](https://github.com/a2aproject/a2a-js/issues/130))
([3279c7b](3279c7bf4d))
* enable follow up task issue on non blocking request
([#160](https://github.com/a2aproject/a2a-js/issues/160))
([352dc05](352dc05851))
* ensure push notifications order
([#141](https://github.com/a2aproject/a2a-js/issues/141))
([22360e6](22360e6ba7))
* ensure user messages are added to existing tasks
([#138](https://github.com/a2aproject/a2a-js/issues/138))
([00fb916](00fb916ca4))
* validate JSON-RPC params
([#155](https://github.com/a2aproject/a2a-js/issues/155))
([5b39f4d](5b39f4dd96))
* validate JSON-RPC request id according to the spec
([#152](https://github.com/a2aproject/a2a-js/issues/152))
([9558c36](9558c3613a))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-11-05 15:38:52 +01:00
Guglielmo Colombo
3ff2660758
feat: add a hermetic sample (#144)
# Description

This PR introduces a new sample to test the A2A-js in a hermetic way,
without the need of setting up external API keys.
The sample-agent mock the execution of a streaming agent, publishing
updates the status of the task that can be tracked with the `cli.ts`.

Fixes #133 🦕
2025-10-27 14:53:21 +01:00
Ronan Takizawa
21048fb042
chore: add testing for A2AExpressApp (#107)
# Description

Add test coverage for A2AExpressApp class.  

Added 19 test cases covering all A2AExpressApp functionality: 
1. Constructor test: Verifies A2AExpressApp instantiates correctly with
requestHandler and
jsonRpcTransportHandler
2. Setup routes default: Tests setupRoutes works with default parameters
and returns the Express app
3. Setup routes custom baseUrl: Tests setupRoutes accepts and uses a
custom baseUrl parameter
4. Setup routes custom middlewares: Tests setupRoutes accepts and
applies custom middleware array
5. Setup routes custom agentCardPath: Tests setupRoutes accepts custom
agentCardPath parameter
6. Agent card GET default: Tests agent card endpoint returns correct
JSON response at default well-known
 path
7. Agent card GET custom path: Tests agent card endpoint works at custom
path when agentCardPath is
specified
8. Agent card error handling: Tests agent card endpoint returns 500
error when getAgentCard fails
9. JSON-RPC single response: Tests POST endpoint handles single JSON-RPC
response correctly
10. JSON-RPC streaming response: Tests POST endpoint handles streaming
responses with Server-Sent Events
11. JSON-RPC streaming error: Tests streaming error handling sends error
event in SSE format
12. JSON-RPC processing error: Tests A2AError handling returns proper
JSON-RPC error response
13. JSON-RPC generic error: Tests non-A2AError fallback returns generic
error response
14. JSON-RPC no ID error: Tests error response includes null ID when
request has no ID
15. Middleware integration: Tests custom middlewares are applied and
called during requests
16. Middleware error handling: Tests middleware errors are properly
handled and return 500
17. Route baseUrl mounting: Tests routes are correctly mounted at
specified baseUrl
18. Route empty baseUrl: Tests routes work correctly when baseUrl is
empty string
19. Express JSON middleware: Tests express.json() middleware is included
by default and parses request
bodies


Dependencies Added:
• Installed supertest and @types/supertest for HTTP endpoint testing

Fixes #105 🦕
2025-09-09 15:17:03 -07:00
Agent2Agent (A2A) Bot
c055b769d9
chore(main): release 0.3.4 (#127)
🤖 I have created a release *beep* *boop*
---


## [0.3.4](https://github.com/a2aproject/a2a-js/compare/v0.3.3...v0.3.4)
(2025-09-04)


### Features

* add list and delete task push notification config rpc method and
custom rpc methods for extensions
([#119](https://github.com/a2aproject/a2a-js/issues/119))
([26c4e7d](26c4e7df48))
* Added push notifications support
([#108](https://github.com/a2aproject/a2a-js/issues/108))
([45a211a](45a211a738))


### Miscellaneous Chores

* release 0.3.4
([#128](https://github.com/a2aproject/a2a-js/issues/128))
([41791d9](41791d99a4))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-09-04 11:25:08 -07:00
Agent2Agent (A2A) Bot
caeefecdde
chore(main): release 0.3.3 (#122)
🤖 I have created a release *beep* *boop*
---


## [0.3.3](https://github.com/a2aproject/a2a-js/compare/v0.3.2...v0.3.3)
(2025-08-27)


### ⚠ BREAKING CHANGES

* Update A2AClient constructor to initialize with full agentCardUrl
([#121](https://github.com/a2aproject/a2a-js/issues/121))

### Features

* Update A2AClient constructor to initialize with full agentCardUrl
([#121](https://github.com/a2aproject/a2a-js/issues/121))
([755044c](755044c6c6))


### Bug Fixes

* Improve fetch implementation handling
([#117](https://github.com/a2aproject/a2a-js/issues/117))
([09adbd3](09adbd31d1))


### Miscellaneous Chores

* release 0.3.3
([#124](https://github.com/a2aproject/a2a-js/issues/124))
([ea59193](ea59193290))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-08-27 13:10:51 -07:00
Adam Weidman
de401038fe
chore: repin express to 5.1 and express types to 5.0.3 (#115)
peerDependency allow both express 4 & 5. Current routes is compatible with both express 4 & express 5.
2025-08-20 09:48:46 -07:00
Agent2Agent (A2A) Bot
1168117482
chore(main): release 0.3.2 (#106)
🤖 I have created a release *beep* *boop*
---


## [0.3.2](https://github.com/a2aproject/a2a-js/compare/v0.3.1...v0.3.2)
(2025-08-17)


### Features

* Added generic client hooks for HTTP based authentication, and improved
agent.json resolution
([#33](https://github.com/a2aproject/a2a-js/issues/33))
([a9826ac](a9826acde3))


### Bug Fixes

* fix Incorrect Well-Known Path for Agent Card
([#102](https://github.com/a2aproject/a2a-js/issues/102))
([3a0f1d0](3a0f1d0784))


### Miscellaneous Chores

* release 0.3.2
([#111](https://github.com/a2aproject/a2a-js/issues/111))
([03f35e0](03f35e0ed2))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-08-17 15:27:18 -07:00
swapydapy
118abae80f
chore: fix repository url in package.json (#98) 2025-08-06 14:11:50 -07:00
Agent2Agent (A2A) Bot
1a5432d461
chore(main): release 0.3.1 (#97)
🤖 I have created a release *beep* *boop*
---


## [0.3.1](https://github.com/a2aproject/a2a-js/compare/v0.3.0...v0.3.1)
(2025-08-06)


### Bug Fixes

* add missing express entrypoint to tsup config
([#96](https://github.com/a2aproject/a2a-js/issues/96))
([8e990e4](8e990e4979))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-08-06 14:01:56 -07:00
Agent2Agent (A2A) Bot
92a2c9b051
chore(main): release 0.3.0 (#92)
🤖 I have created a release *beep* *boop*
---


## [0.3.0](https://github.com/a2aproject/a2a-js/compare/v0.2.5...v0.3.0)
(2025-08-05)


### ⚠ BREAKING CHANGES

* upgrade to a2a 0.3.0 spec version
([#87](https://github.com/a2aproject/a2a-js/issues/87))
* make Express dependency optional

### Features

* make Express dependency optional
([60899c5](60899c51e2))
* upgrade to a2a 0.3.0 spec version
([#87](https://github.com/a2aproject/a2a-js/issues/87))
([ae53da1](ae53da1e36))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
2025-08-05 10:46:18 -07:00
ajaynagotha
60899c51e2
feat!: make Express dependency optional for edge environment compatibility (#71)
# fix: make Express dependency optional for edge environment
compatibility

## Summary

- Move A2AExpressApp to separate module at server/express/
- Remove A2AExpressApp from main server exports to avoid forcing Express
import
- Move express to peerDependencies and devDependencies
- Remove unused cors and body-parser dependencies entirely
- Add new package.json export for ./server/express
- Update import statements in samples and documentation
- Enables usage in Cloudflare Workers, Vercel Edge, and other non-Node
environments
- A2AExpressApp uses express.json() which is built into Express, making
body-parser unnecessary
- cors is not used by the library and is an application-level concern
developers should add themselves
- Only express remains as a peerDependency, accurately reflecting actual
requirements

Fixes #69 - Express dependency breaks edge environments

## 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/google-a2a/a2a-js/blob/main/CONTRIBUTING.md).
- [x] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- Important Prefixes for
[release-please](https://github.com/googleapis/release-please):
- `fix:` which represents bug fixes, and correlates to a
[SemVer](https://semver.org/) patch.
- `feat:` represents a new feature, and correlates to a SemVer minor.
- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking
change (indicated by the `!`) and will result in a SemVer major.
- [x] Ensure the tests and linter pass
- [x] Appropriate docs were updated (if necessary)

Fixes #69 🦕

## Problem

The A2A SDK had a hard dependency on Express.js that prevented usage in
edge environments like Cloudflare Workers, Vercel Edge Runtime, and
other platforms that don't support Node.js core APIs.

**Issues identified:**
- 🚨 **Hard Express dependency** - `A2AExpressApp` was exported from main
server module, forcing Express import even when not used
- 📦 **Bloated installs** - Express and unused dependencies (cors,
body-parser) were required for all users
- 🚫 **Edge incompatibility** - Broke deployment to Cloudflare Workers,
Vercel Edge, and similar platforms
- ⚡ **Performance impact** - Unnecessary bundle size for non-Express
users
- 🗑️ **Unused dependencies** - cors and body-parser were listed but not
actually used by the library

## Solution

### 1. Modularized Express Integration
- ✅ Moved `A2AExpressApp` to separate `src/server/express/` module
- ✅ Removed Express exports from main `src/server/index.ts` 
- ✅ Created dedicated export path: `"./server/express"`

### 2. Cleaned Up Dependencies
```json
{
  "dependencies": {
    "uuid": "^11.1.0"
  },
  "peerDependencies": {
    "express": "^4.21.2"
  },
  "devDependencies": {
    "@types/express": "^4.17.23",
    "express": "^4.21.2"
  }
}
```

**Key dependency decisions:**
- ✅ **express**: Required as peerDependency - actually used by
`A2AExpressApp`
- ❌ **body-parser**: Removed entirely - `A2AExpressApp` uses
`express.json()` instead
- ❌ **cors**: Removed entirely - not used by library, application-level
concern

### 3. Updated Package Exports
```json
{
  "./server/express": {
    "types": "./dist/server/express/index.d.ts",
    "import": "./dist/server/express/index.js",
    "require": "./dist/server/express/index.cjs"
  }
}
```

## Breaking Changes & Migration

### Before (❌ Problematic)
```typescript
import { A2AExpressApp } from "@a2a-js/sdk/server"; // Forces Express dependency
```

### After (✅ Clean)
```typescript
// Core server functionality (no Express dependency)
import { DefaultRequestHandler, AgentExecutor } from "@a2a-js/sdk/server";

// Express integration (optional, only when needed) 
import { A2AExpressApp } from "@a2a-js/sdk/server/express";
```

**For Express users, install peer dependency:**
```bash
npm install express
```

**For users who need CORS support, add it to your Express app:**
```bash
npm install cors
```

```typescript
import express from 'express';
import cors from 'cors';
import { A2AExpressApp } from "@a2a-js/sdk/server/express";

const app = express();
app.use(cors()); // Add CORS at application level
// ... rest of your Express setup
```

## Benefits

| Benefit | Before | After |
|---------|--------|-------|
| **Edge compatibility** | ❌ Broken | ✅ Works |
| **Bundle size** | ~2MB+ Express deps | Minimal core |
| **Install size** | All deps required | Express optional |
| **Developer experience** | Forced dependency | Explicit choice |
| **Dependency accuracy** | Unused deps included | Only required deps |

## Dependency Analysis

### Why body-parser was removed:
- `A2AExpressApp` uses `express.json()` which is built into Express
4.16+
- No import statements found for `body-parser` in the codebase
- Listing it as a peerDependency forced unnecessary installations

### Why cors was removed:
- No import statements found for `cors` in the codebase  
- CORS is an application-level concern that developers should configure
themselves
- Different applications have different CORS requirements
- Keeping it as a dependency misrepresented the library's actual
requirements

## Testing

- ✅ **All existing tests pass** (15/15)
- ✅ **Build succeeds** with new modular structure
- ✅ **Backward compatibility** maintained for core functionality
- ✅ **Express functionality** preserved when imported from new path

## Files Changed

- **`package.json`** - Updated exports and cleaned up dependency
structure
- **`src/server/index.ts`** - Removed `A2AExpressApp` export
- **`src/server/express/`** - New modular Express integration
- **`README.md`** - Updated import examples
- **`src/samples/agents/movie-agent/index.ts`** - Updated to use new
import paths

## Impact

This change enables the A2A SDK to be used in:
- ✅ Cloudflare Workers
- ✅ Vercel Edge Runtime  
- ✅ Deno Deploy
- ✅ Any edge/serverless environment
- ✅ Traditional Node.js servers (unchanged experience)

The dependency cleanup also:
- 🎯 **Accurately represents requirements** - only lists dependencies
actually used
- 💰 **Reduces install overhead** - consumers don't install unused
packages
- 🔧 **Improves flexibility** - developers choose their own CORS
configuration

---

**Type:** Bug fix  
**Breaking Change:** Minimal (import path only)  
**SemVer:** Patch

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: swapydapy <agarwal.swapy@gmail.com>
2025-08-02 23:06:53 -07:00
release-please[bot]
305dbef3e9
chore(main): release 0.2.5 (#67)
🤖 I have created a release *beep* *boop*
---


## [0.2.5](https://github.com/a2aproject/a2a-js/compare/v0.2.4...v0.2.5)
(2025-07-30)


### Features

* add support for custom agent card url. resolves
[#68](https://github.com/a2aproject/a2a-js/issues/68)
([#79](https://github.com/a2aproject/a2a-js/issues/79))
([dc92d32](dc92d321ac))
* Export ExecutionEventQueue in server
([#61](https://github.com/a2aproject/a2a-js/issues/61))
([530c0b9](530c0b9f1f))
* Export type AgentExecutionEvent
([#66](https://github.com/a2aproject/a2a-js/issues/66))
([f4c81f4](f4c81f4186))


### Bug Fixes

* correct the example code
([#64](https://github.com/a2aproject/a2a-js/issues/64))
([126eee4](126eee4e3b))
* setting context id in _createRequestContext
([#49](https://github.com/a2aproject/a2a-js/issues/49))
([1abc8a1](1abc8a1f35))

---
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: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-07-30 15:16:44 -07:00
swapydapy
a4c4f74114
chore: fix tests & run cmd (#80) 2025-07-30 14:11:34 -07:00
release-please[bot]
c78ce31f32
chore(main): release 0.2.4 (#57)
🤖 I have created a release *beep* *boop*
---


## [0.2.4](https://github.com/a2aproject/a2a-js/compare/v0.2.3...v0.2.4)
(2025-07-14)


### Miscellaneous Chores

* fix empty npm publish by version-bump
([#56](https://github.com/a2aproject/a2a-js/issues/56))
([b12e033](b12e033ed8))

---
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: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-07-14 13:27:16 -07:00
release-please[bot]
310b90fd12
chore(main): release 0.2.3 (#47)
🤖 I have created a release *beep* *boop*
---


## [0.2.3](https://github.com/a2aproject/a2a-js/compare/v0.2.2...v0.2.3)
(2025-07-14)


### ⚠ BREAKING CHANGES

* separate entrypoints for client, server & common

### Features

* add CommonJS support alongside ESM
([#27](https://github.com/a2aproject/a2a-js/issues/27))
([1b3e516](1b3e516e2b))
* Allow adding middlewares in server
([#51](https://github.com/a2aproject/a2a-js/issues/51))
([b4fc323](b4fc323c1f))
* separate entrypoints for client, server & common
([e8dd025](e8dd025084))

---
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: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-07-14 12:21:59 -07:00
Petr Kadlec
e8dd025084
chore: add client-only entrypoint for browser usage (#46)
### Summary

This PR introduces a new `client` entrypoint to the A2A SDK to enable
use in browser-based applications without bundling server-side code.

The existing main entrypoint (`index.ts`) is left untouched to avoid
introducing any breaking changes. The new entrypoint includes only
client-safe code (e.g. `A2AClient`) and avoids importing `EventEmitter`,
`fs`, or other Node-specific APIs that would break browser builds.

This change allows users to safely do:
```ts
import { A2AClient } from '@a2a-js/sdk/client';
```

### Future Suggestions (Not part of this PR)
- Consider creating a dedicated server entrypoint (@a2a-js/sdk/server)
for server-only components and possibly keep only safe exports (types,
...) in the main entrypoint to avoid confusion and provide clear working
entrypoints.

---------

Signed-off-by: Petr Kadlec <petr@puradesign.cz>
2025-07-11 12:25:06 -07:00
hujiulong
1b3e516e2b
feat: add CommonJS support alongside ESM (#27)
# 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/google-a2a/a2a-js/blob/main/CONTRIBUTING.md).
- [x] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- Important Prefixes for
[release-please](https://github.com/googleapis/release-please):
- `fix:` which represents bug fixes, and correlates to a
[SemVer](https://semver.org/) patch.
- `feat:` represents a new feature, and correlates to a SemVer minor.
- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking
change (indicated by the `!`) and will result in a SemVer major.
- [x] Ensure the tests and linter pass
- [x] Appropriate docs were updated (if necessary)

Fixes #26  🦕

The build process now uses [tsup](https://github.com/egoist/tsup),
resulting in the following output:
```
- dist
  - index.js
  - index.cjs
  - index.d.ts
  - index.d.cts
```
2025-07-09 18:40:39 -07:00
Gili Shohat
7c63a89473
chore: align @types/express to express's major version (#35)
align `@types/express` to use the same major version of `express`.
2025-07-09 16:22:24 -07:00
release-please[bot]
a997e4b9ff
chore(main): release 0.2.2 (#18)
🤖 I have created a release *beep* *boop*
---


## [0.2.2](https://github.com/google-a2a/a2a-js/compare/v0.2.1...v0.2.2)
(2025-06-20)


### Features

* add action to publish to npm
([e4ab96e](e4ab96ed4f))
* add sample agent
([#19](https://github.com/google-a2a/a2a-js/issues/19))
([1f21a0a](1f21a0a866))
* add test coverage
([#20](https://github.com/google-a2a/a2a-js/issues/20))
([7bde9cd](7bde9cd839))
* generate types from spec & use unknown in types
([#17](https://github.com/google-a2a/a2a-js/issues/17))
([748f928](748f9283a8))
* reject sendMessage for tasks in terminal states
([#29](https://github.com/google-a2a/a2a-js/issues/29))
([9f86195](9f86195d01))
* Supply taskId & contextId in requestContext
([#22](https://github.com/google-a2a/a2a-js/issues/22))
([79db7f4](79db7f48ca))
* support non-blocking message send
([#28](https://github.com/google-a2a/a2a-js/issues/28))
([6984dbb](6984dbb365))
* use string union instead of enums
([#24](https://github.com/google-a2a/a2a-js/issues/24))
([bcc1f7e](bcc1f7e0e1))

---
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: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-06-19 18:37:42 -07:00
swapydapy
ea5a71e019
Add repo in package.json (#25) 2025-06-13 18:23:10 -07:00
swapydapy
7bde9cd839
feat: add test coverage (#20) 2025-06-10 22:16:01 -07:00
swapydapy
1f21a0a866
feat: add sample agent (#19) 2025-06-10 21:42:22 -07:00
swapydapy
748f9283a8
feat: generate types from spec & use unknown in types (#17)
* feat: generate types from spec & use unknown in types
* Add reference to TsEnums property
2025-06-10 17:09:59 -07:00