a2aproject · ehsavoie · Sep 28, 2026 · Sep 28, 2026
diff --git a/.oss-ai-helper-rules/project-guidelines.md b/.oss-ai-helper-rules/project-guidelines.md
@@ -0,0 +1,30 @@
+# Project Guidelines
+
+This file documents the branching strategy, commit conventions, and PR policies for the a2a-java project.
+
+- Fix branch naming pattern: `issue-<ISSUE_NUMBER>`
+- Feature branch naming pattern: `issue-<ISSUE_NUMBER>-<short-slug>`
+- Bugfix branch naming pattern: `issue-<ISSUE_NUMBER>`
+- Quick-fix branch naming pattern: `quick-fix/<short-slug>`
+- SonarCloud branch naming pattern: _(n/a — no SonarCloud)_
+- CI-fix branch naming pattern: `ci-issue/<short-slug>`
+- Commit format (fix): Conventional Commits — `<type>(<scope>): <description>\n\nFixes #<ISSUE_NUMBER>`
+- Commit format (quick-fix): `chore: <brief description>`
+- Commit format (ci-fix): `ci: <brief description>`
+- PR creation policy: always
+- Find-task source: GitHub labels
+- Find-task beginner label: `good first issue`
+- Find-task intermediate label: _(none)_
+- Find-task experienced label: `help wanted`
+- Scope-too-large redirect: break into smaller issues and PRs; squash commits into one logical commit per PR unless multiple meaningful commits are warranted
+
+## Notes
+
+- PRs must be reviewed by at least one a2a-java committer before merging.
+- Link the issue in both the PR description and the commit message (e.g. `Fixes #<NUMBER>`).
+- PRs should include tests and documentation for new functionality.
+- Prefer squashing all commits into a single commit for small changes.
+
+## Version
+
+788c6a703f406b4196cdcb5b30173bd971e1b6e0
diff --git a/.oss-ai-helper-rules/project-info.md b/.oss-ai-helper-rules/project-info.md
@@ -0,0 +1,19 @@
+# Project Information
+
+This file provides repository metadata used by AI agents to understand the project's structure, issue tracker, and related resources.
+
+- Remote pattern: `a2aproject/a2a-java`
+- GitHub repo: `a2aproject/a2a-java`
+- Issue tracker type: GitHub
+- Issue tracker URL: https://github.com/a2aproject/a2a-java/issues
+- Issue ID format: numeric
+- SonarCloud component key: _(none)_
+- Documentation URL: https://a2a-protocol.org/
+- Related repositories:
+  - `a2aproject/a2a` — A2A protocol specification
+  - `a2aproject/a2a-python` — Python SDK
+- Create-issue supported: yes
+
+## Version
+
+788c6a703f406b4196cdcb5b30173bd971e1b6e0
diff --git a/.oss-ai-helper-rules/project-standards.md b/.oss-ai-helper-rules/project-standards.md
@@ -0,0 +1,26 @@
+# Project Standards
+
+This file documents the build tools, commands, and code style conventions for the a2a-java project.
+
+- Build tool: Maven
+- Build command: `mvn clean install`
+- Test command: `mvn test`
+- Test with coverage command: `mvn verify`
+- Format command: _(none — checkstyle enforced at build time)_
+- Module-specific build: yes (`mvn clean install -pl <module>`)
+- Parallelized Maven: no
+- Code style restrictions:
+  - Java 17+ required
+  - Import statements must be sorted; no star imports
+  - Use `@Nullable` from `org.jspecify.annotations` for optional fields
+  - NullAway + JSpecify enforced via Error Prone
+  - Use Java `record` for immutable data types
+  - Use `Assert.checkNotNullParam()` in compact constructors for required fields
+  - Use `List.copyOf()` and `Map.copyOf()` for defensive copying
+  - Apply Builder pattern for records with many fields
+  - Do not split Java packages across Maven modules in production code
+  - Serialization: Gson
+
+## Version
+
+788c6a703f406b4196cdcb5b30173bd971e1b6e0
diff --git a/boms/extras/pom.xml b/boms/extras/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/boms/reference/pom.xml b/boms/reference/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/boms/sdk/pom.xml b/boms/sdk/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/boms/test-utils/pom.xml b/boms/test-utils/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/client/base/pom.xml b/client/base/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-client</artifactId>

diff --git a/client/transport/grpc/pom.xml b/client/transport/grpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-client-transport-grpc</artifactId>

diff --git a/client/transport/jsonrpc/pom.xml b/client/transport/jsonrpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-client-transport-jsonrpc</artifactId>

diff --git a/client/transport/rest/pom.xml b/client/transport/rest/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-client-transport-rest</artifactId>

diff --git a/client/transport/spi/pom.xml b/client/transport/spi/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-client-transport-spi</artifactId>

diff --git a/common/pom.xml b/common/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
     </parent>
     <artifactId>a2a-java-sdk-common</artifactId>
 

diff --git a/compat-0.3/client/base/pom.xml b/compat-0.3/client/base/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-client</artifactId>

diff --git a/compat-0.3/client/transport/grpc/pom.xml b/compat-0.3/client/transport/grpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-client-transport-grpc</artifactId>

diff --git a/compat-0.3/client/transport/jsonrpc/pom.xml b/compat-0.3/client/transport/jsonrpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-client-transport-jsonrpc</artifactId>

diff --git a/compat-0.3/client/transport/rest/pom.xml b/compat-0.3/client/transport/rest/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-client-transport-rest</artifactId>

diff --git a/compat-0.3/client/transport/spi/pom.xml b/compat-0.3/client/transport/spi/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-client-transport-spi</artifactId>

diff --git a/compat-0.3/pom.xml b/compat-0.3/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
     </parent>
 
     <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>

diff --git a/compat-0.3/reference/grpc/pom.xml b/compat-0.3/reference/grpc/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/compat-0.3/reference/jsonrpc/pom.xml b/compat-0.3/reference/jsonrpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-reference-jsonrpc</artifactId>

diff --git a/compat-0.3/reference/rest/pom.xml b/compat-0.3/reference/rest/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-reference-rest</artifactId>

diff --git a/compat-0.3/server-conversion/pom.xml b/compat-0.3/server-conversion/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-server-conversion</artifactId>

diff --git a/compat-0.3/spec-grpc/pom.xml b/compat-0.3/spec-grpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-spec-grpc</artifactId>

diff --git a/compat-0.3/spec/pom.xml b/compat-0.3/spec/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-spec</artifactId>

diff --git a/compat-0.3/tck/pom.xml b/compat-0.3/tck/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>..</relativePath>
     </parent>
 

diff --git a/compat-0.3/tests/server-common/pom.xml b/compat-0.3/tests/server-common/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-tests-server-common</artifactId>

diff --git a/compat-0.3/transport/grpc/pom.xml b/compat-0.3/transport/grpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-transport-grpc</artifactId>

diff --git a/compat-0.3/transport/jsonrpc/pom.xml b/compat-0.3/transport/jsonrpc/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-transport-jsonrpc</artifactId>

diff --git a/compat-0.3/transport/rest/pom.xml b/compat-0.3/transport/rest/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../..</relativePath>
     </parent>
     <artifactId>a2a-java-sdk-compat-0.3-transport-rest</artifactId>

diff --git a/docs/pom.xml b/docs/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 

diff --git a/examples/cloud-deployment/server/pom.xml b/examples/cloud-deployment/server/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../../pom.xml</relativePath>
     </parent>
 

diff --git a/examples/helloworld/client/pom.xml b/examples/helloworld/client/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-examples-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
     </parent>
 
     <artifactId>a2a-java-sdk-examples-client</artifactId>

diff --git a/.../client/src/main/java/org/a2aproject/sdk/examples/helloworld/client/HelloWorldRunner.java b/.../client/src/main/java/org/a2aproject/sdk/examples/helloworld/client/HelloWorldRunner.java
@@ -1,12 +1,12 @@
 
 ///usr/bin/env jbang "$0" "$@" ; exit $?
 
-//DEPS org.a2aproject.sdk:a2a-java-sdk-client:1.3.3.Final-SNAPSHOT
-//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-jsonrpc:1.3.3.Final-SNAPSHOT
-//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-grpc:1.3.3.Final-SNAPSHOT
-//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-rest:1.3.3.Final-SNAPSHOT
-//DEPS org.a2aproject.sdk:a2a-java-sdk-opentelemetry-client:1.3.3.Final-SNAPSHOT
-//DEPS org.a2aproject.sdk:a2a-java-sdk-opentelemetry-client-propagation:1.3.3.Final-SNAPSHOT
+//DEPS org.a2aproject.sdk:a2a-java-sdk-client:1.4.0.Final
+//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-jsonrpc:1.4.0.Final
+//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-grpc:1.4.0.Final
+//DEPS org.a2aproject.sdk:a2a-java-sdk-client-transport-rest:1.4.0.Final
+//DEPS org.a2aproject.sdk:a2a-java-sdk-opentelemetry-client:1.4.0.Final
+//DEPS org.a2aproject.sdk:a2a-java-sdk-opentelemetry-client-propagation:1.4.0.Final
 //DEPS io.opentelemetry:opentelemetry-sdk:1.60.1
 //DEPS io.opentelemetry:opentelemetry-exporter-otlp:1.60.1
 //DEPS io.opentelemetry:opentelemetry-exporter-logging:1.60.1

diff --git a/examples/helloworld/pom.xml b/examples/helloworld/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 

diff --git a/examples/helloworld/server/pom.xml b/examples/helloworld/server/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-examples-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
     </parent>
 
     <artifactId>a2a-java-sdk-examples-server</artifactId>

diff --git a/examples/stream-lifecycle/client/pom.xml b/examples/stream-lifecycle/client/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-examples-stream-lifecycle-parent</artifactId>
-        <version>1.3.3.Final-SNAPSHOT</version>
+        <version>1.4.0.Final</version>
     </parent>
 
     <artifactId>a2a-java-sdk-examples-stream-lifecycle-client</artifactId>