feat!: Rename root package to org.a2aproject.sdk (#786)

Fixes #757  🦕

Author: kabir

.agents/skills/fix-tck-issue/SKILL.md

@@ -65,9 +65,9 @@ Create test in appropriate module. Choose location based on test complexity:
 - Testing handler logic directly
 - Need custom AgentCard configuration (e.g., capability flags)
 - Simpler to set up specific test conditions
-- **HTTP+JSON** → `transport/rest/src/test/java/io/a2a/transport/rest/handler/RestHandlerTest.java`
-- **gRPC** → `transport/grpc/src/test/java/io/a2a/transport/grpc/handler/GrpcHandlerTest.java`
-- **JSON-RPC** → `transport/jsonrpc/src/test/java/io/a2a/transport/jsonrpc/handler/JSONRPCHandlerTest.java`
+- **HTTP+JSON** → `transport/rest/src/test/java/org/a2aproject/sdk/transport/rest/handler/RestHandlerTest.java`
+- **gRPC** → `transport/grpc/src/test/java/org/a2aproject/sdk/transport/grpc/handler/GrpcHandlerTest.java`
+- **JSON-RPC** → `transport/jsonrpc/src/test/java/org/a2aproject/sdk/transport/jsonrpc/handler/JSONRPCHandlerTest.java`
 
 **Option B: reference/* modules (Integration Tests)** - Use when:
 - Testing full request/response cycle
@@ -195,9 +195,9 @@ Fixes #<issue-number>"
 
 Example for multi-transport fix:
 ```bash
-git add transport/rest/src/main/java/io/a2a/transport/rest/handler/RestHandler.java \
-        transport/jsonrpc/src/main/java/io/a2a/transport/jsonrpc/handler/JSONRPCHandler.java \
-        transport/grpc/src/main/java/io/a2a/transport/grpc/handler/GrpcHandler.java
+git add transport/rest/src/main/java/org/a2aproject/sdk/transport/rest/handler/RestHandler.java \
+        transport/jsonrpc/src/main/java/org/a2aproject/sdk/transport/jsonrpc/handler/JSONRPCHandler.java \
+        transport/grpc/src/main/java/org/a2aproject/sdk/transport/grpc/handler/GrpcHandler.java
 git commit -m "fix: Return UnsupportedOperationError when capability is disabled
 
 Applied to all three transports: HTTP+JSON, JSON-RPC, and gRPC.
@@ -245,9 +245,9 @@ builder.setTaskId(taskId);
 - More control over test setup
 
 **Test file locations**:
-- `transport/rest/src/test/java/io/a2a/transport/rest/handler/RestHandlerTest.java`
-- `transport/grpc/src/test/java/io/a2a/transport/grpc/handler/GrpcHandlerTest.java`
-- `transport/jsonrpc/src/test/java/io/a2a/transport/jsonrpc/handler/JSONRPCHandlerTest.java`
+- `transport/rest/src/test/java/org/a2aproject/sdk/transport/rest/handler/RestHandlerTest.java`
+- `transport/grpc/src/test/java/org/a2aproject/sdk/transport/grpc/handler/GrpcHandlerTest.java`
+- `transport/jsonrpc/src/test/java/org/a2aproject/sdk/transport/jsonrpc/handler/JSONRPCHandlerTest.java`
 
 ### reference/* modules (Integration Tests)
 **Best for**:

.agents/skills/update-a2a-proto/SKILL.md

@@ -22,7 +22,7 @@ Before updating, record what we have now so we can diff later.
 2. Download the latest `a2a.proto` from the upstream A2A repository at https://github.com/a2aproject/A2A/blob/main/specification/a2a.proto and save it to `spec-grpc/src/main/proto/a2a.proto`.
 3. Update the `java_package` option in the downloaded proto file to:
    ```
-   option java_package = "io.a2a.grpc";
+   option java_package = "org.a2aproject.sdk.grpc";
    ```
 4. Update the comment tracking the upstream commit hash (line starting with `// From commit`) to the commit hash / tag of the downloaded proto file.
 
@@ -39,7 +39,7 @@ Compare the old and new versions of the specification to identify changes:
 
 1. Delete all the generated gRPC Java classes (in case of resources removed from the Protobuf definitions):
    ```bash
-   find spec-grpc/src/main/java/io/a2a/grpc -maxdepth 1 -name "*.java" -delete```
+   find spec-grpc/src/main/java/org/a2aproject/sdk/grpc -maxdepth 1 -name "*.java" -delete```
    ```
 
 2. Regenerate gRPC Java classes by running:

.github/workflows/cloud-deployment-example.yml

@@ -55,7 +55,7 @@ jobs:
         working-directory: examples/cloud-deployment/server
         run: |
           mvn test-compile exec:java \
-            -Dexec.mainClass="io.a2a.examples.cloud.A2ACloudExampleClient" \
+            -Dexec.mainClass="org.a2aproject.sdk.examples.cloud.A2ACloudExampleClient" \
             -Dexec.classpathScope=test \
             -Dagent.url=http://localhost:8080 \
             -Dci.mode=true

AGENTS.md

@@ -38,7 +38,7 @@ mvn clean install
 
 ## Key Conventions
 
-- Package root: `io.a2a`
+- Package root: `org.a2aproject.sdk`
 - Serialization: Gson (see `gson.version` in parent POM)
 - Null safety: NullAway + JSpecify annotations enforced via Error Prone
 - Reference server runtime: Quarkus
@@ -51,7 +51,7 @@ mvn clean install
 - Do not use "star" imports (eg `import java.util.*`)
 - Use Java `record` for immutable data types
 - Use `@Nullable` (from org.jspecify.annotations) for optional fields
-- Use `io.a2a.util.Assert.checkNotNullParam()` in the compact constructor to validate required fields
+- Use `org.a2aproject.sdk.util.Assert.checkNotNullParam()` in the compact constructor to validate required fields
 - Use `List.copyOf()` and `Map.copyOf()` for defensive copying of collections
 - Apply the Builder pattern for records with many fields (see `AgentCard.java` as reference)
 

CONTRIBUTING_INTEGRATIONS.md

@@ -8,7 +8,7 @@ Then the project page itself needs to contain the following information as a min
 
 * How to use the integration.
    * Ideally there should be a sample demonstrating how to use it 
-* The integration should have tests, extending [AbstractA2AServerTest](tests/server-common/src/test/java/io/a2a/server/apps/common/AbstractA2AServerTest.java)
+* The integration should have tests, extending [AbstractA2AServerTest](tests/server-common/src/test/java/org/a2aproject/sdk/server/apps/common/AbstractA2AServerTest.java)
 * The integration should pass the [TCK](https://github.com/a2aproject/a2a-tck), and make it obvious how to see that it has passed.
 * Ideally, the integration should be deployed in Maven Central. If that is not possible, provide clear instructions for how to build it.
 

README.md

@@ -22,9 +22,9 @@ mvn clean install
 ### Regeneration of gRPC files
 We copy https://github.com/a2aproject/A2A/blob/main/specification/grpc/a2a.proto to the [`spec-grpc/`](./spec-grpc) project, and adjust the `java_package` option to be as follows:
 ```
-option java_package = "io.a2a.grpc";
+option java_package = "org.a2aproject.sdk.grpc";
 ```
-Then build the `spec-grpc` module with `mvn clean install  -Dskip.protobuf.generate=false` to regenerate the gRPC classes in the `io.a2a.grpc` package.
+Then build the `spec-grpc` module with `mvn clean install  -Dskip.protobuf.generate=false` to regenerate the gRPC classes in the `org.a2aproject.sdk.grpc` package.
 
 ## Examples
 
@@ -63,7 +63,7 @@ To use the reference implementation with the JSON-RPC protocol, add the followin
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-reference-jsonrpc</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases --> 
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 
@@ -74,7 +74,7 @@ To use the reference implementation with the gRPC protocol, add the following de
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-reference-grpc</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases --> 
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 
@@ -85,7 +85,7 @@ To use the reference implementation with the HTTP+JSON/REST protocol, add the fo
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-reference-rest</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases --> 
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 
@@ -95,12 +95,12 @@ you'd like to support.
 ### 2. Add a class that creates an A2A Agent Card
 
 ```java
-import io.a2a.server.PublicAgentCard;
-import io.a2a.spec.AgentCapabilities;
-import io.a2a.spec.AgentCard;
-import io.a2a.spec.AgentInterface;
-import io.a2a.spec.AgentSkill;
-import io.a2a.spec.TransportProtocol;
+import org.a2aproject.sdk.server.PublicAgentCard;
+import org.a2aproject.sdk.spec.AgentCapabilities;
+import org.a2aproject.sdk.spec.AgentCard;
+import org.a2aproject.sdk.spec.AgentInterface;
+import org.a2aproject.sdk.spec.AgentSkill;
+import org.a2aproject.sdk.spec.TransportProtocol;
 ...
 
 @ApplicationScoped
@@ -138,17 +138,17 @@ public class WeatherAgentCardProducer {
 ### 3. Add a class that creates an A2A Agent Executor
 
 ```java
-import io.a2a.server.agentexecution.AgentExecutor;
-import io.a2a.server.agentexecution.RequestContext;
-import io.a2a.server.events.EventQueue;
-import io.a2a.server.tasks.AgentEmitter;
-import io.a2a.spec.JSONRPCError;
-import io.a2a.spec.Message;
-import io.a2a.spec.Part;
-import io.a2a.spec.Task;
-import io.a2a.spec.TaskNotCancelableError;
-import io.a2a.spec.TaskState;
-import io.a2a.spec.TextPart;
+import org.a2aproject.sdk.server.agentexecution.AgentExecutor;
+import org.a2aproject.sdk.server.agentexecution.RequestContext;
+import org.a2aproject.sdk.server.events.EventQueue;
+import org.a2aproject.sdk.server.tasks.AgentEmitter;
+import org.a2aproject.sdk.spec.JSONRPCError;
+import org.a2aproject.sdk.spec.Message;
+import org.a2aproject.sdk.spec.Part;
+import org.a2aproject.sdk.spec.Task;
+import org.a2aproject.sdk.spec.TaskNotCancelableError;
+import org.a2aproject.sdk.spec.TaskState;
+import org.a2aproject.sdk.spec.TextPart;
 ...
 
 @ApplicationScoped
@@ -290,7 +290,7 @@ that you can use to create your A2A `Client`.
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-client</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 
@@ -306,7 +306,7 @@ If you want to use the gRPC transport, you'll need to add a relevant dependency:
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-client-transport-grpc</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 
@@ -319,7 +319,7 @@ If you want to use the HTTP+JSON/REST transport, you'll need to add a relevant d
     <groupId>org.a2aproject.sdk</groupId>
     <artifactId>a2a-java-sdk-client-transport-rest</artifactId>
     <!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
-    <version>${io.a2a.sdk.version}</version>
+    <version>${org.a2aproject.sdk.version}</version>
 </dependency>
 ```
 

boms/README.md

@@ -58,7 +58,7 @@ Add to your project's `pom.xml`:
         <dependency>
             <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-bom</artifactId>
-            <version>${io.a2a.sdk.version}</version>
+            <version>${org.a2aproject.sdk.version}</version>
             <type>pom</type>
             <scope>import</scope>
         </dependency>
@@ -88,7 +88,7 @@ Add to your project's `pom.xml`:
         <dependency>
             <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-extras-bom</artifactId>
-            <version>${io.a2a.sdk.version}</version>
+            <version>${org.a2aproject.sdk.version}</version>
             <type>pom</type>
             <scope>import</scope>
         </dependency>
@@ -118,7 +118,7 @@ Add to your project's `pom.xml`:
         <dependency>
             <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-reference-bom</artifactId>
-            <version>${io.a2a.sdk.version}</version>
+            <version>${org.a2aproject.sdk.version}</version>
             <type>pom</type>
             <scope>import</scope>
         </dependency>

boms/extras/src/it/extras-usage-test/pom.xml

@@ -154,7 +154,7 @@
                             <goal>java</goal>
                         </goals>
                         <configuration>
-                            <mainClass>io.a2a.test.ExtrasBomVerifier</mainClass>
+                            <mainClass>org.a2aproject.sdk.test.ExtrasBomVerifier</mainClass>
                         </configuration>
                     </execution>
                 </executions>

…/java/io/a2a/test/ExtrasBomVerifier.java …aproject/sdk/test/ExtrasBomVerifier.javaboms/extras/src/it/extras-usage-test/src/main/java/io/a2a/test/ExtrasBomVerifier.java renamed to boms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/test/ExtrasBomVerifier.java boms/extras/src/it/extras-usage-test/src/main/java/io/a2a/test/ExtrasBomVerifier.java renamed to boms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/test/ExtrasBomVerifier.java

@@ -1,6 +1,6 @@
-package io.a2a.test;
+package org.a2aproject.sdk.test;
 
-import io.a2a.bom.test.DynamicBomVerifier;
+import org.a2aproject.sdk.bom.test.DynamicBomVerifier;
 
 import java.util.Set;
 

boms/reference/src/it/reference-usage-test/pom.xml

@@ -131,7 +131,7 @@
                             <goal>java</goal>
                         </goals>
                         <configuration>
-                            <mainClass>io.a2a.test.ReferenceBomVerifier</mainClass>
+                            <mainClass>org.a2aproject.sdk.test.ReferenceBomVerifier</mainClass>
                         </configuration>
                     </execution>
                 </executions>