feat!: New permanent groupId: org.a2aproject.sdk (#750)

The old io.github.a2asdk was temporary. It was decided to not change the
package names.

Breaking Change:
------------------
Going forward `org.a2aproject.sdk` will be used as the groupId instead
of `io.github.a2asdk`

Author: kabir

.enforcer-scripts/validate-jbang-versions.groovy

@@ -14,7 +14,7 @@ if (!jbangFile.exists()) {
 }
 
 def expectedVersion = project.version
-def groupPrefix = "//DEPS io.github.a2asdk:"
+def groupPrefix = "//DEPS org.a2aproject.sdk:"
 def success = true
 
 jbangFile.eachLine { line ->

.github/workflows/create-github-release.yml

@@ -60,19 +60,19 @@ jobs:
             // Add Maven Central installation instructions
             releaseNotes += `### Installation\n\n`;
             releaseNotes += `**Maven**:\n\`\`\`xml\n<dependency>\n`;
-            releaseNotes += `    <groupId>io.github.a2asdk</groupId>\n`;
+            releaseNotes += `    <groupId>org.a2aproject.sdk</groupId>\n`;
             releaseNotes += `    <artifactId>a2a-java-sdk-client</artifactId>\n`;
             releaseNotes += `    <version>${version}</version>\n`;
             releaseNotes += `</dependency>\n\`\`\`\n\n`;
 
             releaseNotes += `**Gradle**:\n\`\`\`gradle\n`;
-            releaseNotes += `implementation 'io.github.a2asdk:a2a-java-sdk-client:${version}'\n`;
+            releaseNotes += `implementation 'org.a2aproject.sdk:a2a-java-sdk-client:${version}'\n`;
             releaseNotes += `\`\`\`\n\n`;
 
             // Add links
             releaseNotes += `### Links\n\n`;
-            releaseNotes += `- [Maven Central](https://central.sonatype.com/artifact/io.github.a2asdk/a2a-java-sdk-parent/${version})\n`;
-            releaseNotes += `- [JavaDoc](https://javadoc.io/doc/io.github.a2asdk/a2a-java-sdk-parent/${version})\n`;
+            releaseNotes += `- [Maven Central](https://central.sonatype.com/artifact/org.a2aproject.sdk/a2a-java-sdk-parent/${version})\n`;
+            releaseNotes += `- [JavaDoc](https://javadoc.io/doc/org.a2aproject.sdk/a2a-java-sdk-parent/${version})\n`;
             releaseNotes += `- [GitHub](https://github.com/a2aproject/a2a-java/tree/v${version})\n\n`;
 
             // Add changelog header
@@ -115,7 +115,7 @@ jobs:
               core.summary
                 .addHeading(`Release v${version} Created`)
                 .addLink('View Release', release.html_url)
-                .addLink('Maven Central', `https://central.sonatype.com/artifact/io.github.a2asdk/a2a-java-sdk-parent/${version}`)
+                .addLink('Maven Central', `https://central.sonatype.com/artifact/org.a2aproject.sdk/a2a-java-sdk-parent/${version}`)
                 .write();
 
             } catch (error) {

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-Java SDK for the [Agent2Agent (A2A) Protocol](https://a2a-protocol.org/). Multi-module Maven project (`io.github.a2asdk` group) providing client and server libraries for A2A agent communication over JSON-RPC, gRPC, and REST transports.
+Java SDK for the [Agent2Agent (A2A) Protocol](https://a2a-protocol.org/). Multi-module Maven project (`org.a2aproject.sdk` group) providing client and server libraries for A2A agent communication over JSON-RPC, gRPC, and REST transports.
 
 ## Build
 

README.md

@@ -58,11 +58,9 @@ The A2A Java SDK Reference Server implementations support the following transpor
 
 To use the reference implementation with the JSON-RPC protocol, add the following dependency to your project:
 
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>
@@ -71,11 +69,9 @@ To use the reference implementation with the JSON-RPC protocol, add the followin
 
 To use the reference implementation with the gRPC protocol, add the following dependency to your project:
 
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>
@@ -84,11 +80,9 @@ To use the reference implementation with the gRPC protocol, add the following de
 
 To use the reference implementation with the HTTP+JSON/REST protocol, add the following dependency to your project:
 
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>
@@ -291,13 +285,9 @@ To make use of the Java `Client`:
 Adding a dependency on `a2a-java-sdk-client` will provide access to a `ClientBuilder`
 that you can use to create your A2A `Client`.
 
-----
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-----
-
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>
@@ -311,13 +301,9 @@ By default, the `sdk-client` artifact includes the JSONRPC transport dependency.
 
 If you want to use the gRPC transport, you'll need to add a relevant dependency:
 
-----
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-----
-
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>
@@ -327,13 +313,10 @@ If you want to use the gRPC transport, you'll need to add a relevant dependency:
 
 If you want to use the HTTP+JSON/REST transport, you'll need to add a relevant dependency:
 
-----
-> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
-----
 
 ```xml
 <dependency>
-    <groupId>io.github.a2asdk</groupId>
+    <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>

RELEASE.md

@@ -16,7 +16,7 @@ The release process involves:
 
 ### Required Accounts & Access
 - GitHub repository write access to `a2aproject/a2a-java`
-- Maven Central account: namespace: `io.github.a2asdk`
+- Maven Central account: namespace: `org.a2aproject.sdk`
 
 ### Required Secrets (Repository Maintainers)
 The following secrets must be configured in GitHub repository settings:
@@ -140,7 +140,7 @@ Check that artifacts are available:
 
 **Maven Central**:
 ```
-https://central.sonatype.com/artifact/io.github.a2asdk/a2a-java-sdk-parent/0.4.0.Alpha1
+https://central.sonatype.com/artifact/org.a2aproject.sdk/a2a-java-sdk-parent/0.4.0.Alpha1
 ```
 
 **GitHub Release**:
@@ -184,7 +184,7 @@ Open PR, wait for CI, and merge.
 ./update-version.sh OLD_VERSION NEW_VERSION
 
 # Or manually check:
-grep -r "//DEPS io.github.a2asdk:" examples/
+grep -r "//DEPS org.a2aproject.sdk:" examples/
 ```
 
 ### GPG signing fails in workflow

boms/README.md

@@ -14,7 +14,7 @@ The A2A Java SDK provides three BOMs for different use cases:
 
 ### SDK BOM (`boms/sdk`)
 
-**Artifact:** `io.github.a2asdk:a2a-java-sdk-bom`
+**Artifact:** `org.a2aproject.sdk:a2a-java-sdk-bom`
 
 The SDK BOM includes:
 - All A2A SDK core modules (spec, server, client, transport)
@@ -26,7 +26,7 @@ The SDK BOM includes:
 
 ### Extras BOM (`boms/extras`)
 
-**Artifact:** `io.github.a2asdk:a2a-java-sdk-extras-bom`
+**Artifact:** `org.a2aproject.sdk:a2a-java-sdk-extras-bom`
 
 The Extras BOM includes:
 - Everything from `a2a-java-sdk-bom` (via import)
@@ -36,7 +36,7 @@ The Extras BOM includes:
 
 ### Reference BOM (`boms/reference`)
 
-**Artifact:** `io.github.a2asdk:a2a-java-sdk-reference-bom`
+**Artifact:** `org.a2aproject.sdk:a2a-java-sdk-reference-bom`
 
 The Reference BOM includes:
 - Everything from `a2a-java-sdk-bom` (via import)
@@ -56,7 +56,7 @@ Add to your project's `pom.xml`:
 <dependencyManagement>
     <dependencies>
         <dependency>
-            <groupId>io.github.a2asdk</groupId>
+            <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-bom</artifactId>
             <version>${io.a2a.sdk.version}</version>
             <type>pom</type>
@@ -68,11 +68,11 @@ Add to your project's `pom.xml`:
 <dependencies>
     <!-- No version needed - managed by BOM -->
     <dependency>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-server-common</artifactId>
     </dependency>
     <dependency>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-transport-jsonrpc</artifactId>
     </dependency>
 </dependencies>
@@ -86,7 +86,7 @@ Add to your project's `pom.xml`:
 <dependencyManagement>
     <dependencies>
         <dependency>
-            <groupId>io.github.a2asdk</groupId>
+            <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-extras-bom</artifactId>
             <version>${io.a2a.sdk.version}</version>
             <type>pom</type>
@@ -98,11 +98,11 @@ Add to your project's `pom.xml`:
 <dependencies>
     <!-- No version needed - managed by BOM -->
     <dependency>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-server-common</artifactId>
     </dependency>
     <dependency>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-extras-task-store-database-jpa</artifactId>
     </dependency>
 </dependencies>
@@ -116,7 +116,7 @@ Add to your project's `pom.xml`:
 <dependencyManagement>
     <dependencies>
         <dependency>
-            <groupId>io.github.a2asdk</groupId>
+            <groupId>org.a2aproject.sdk</groupId>
             <artifactId>a2a-java-sdk-reference-bom</artifactId>
             <version>${io.a2a.sdk.version}</version>
             <type>pom</type>
@@ -128,7 +128,7 @@ Add to your project's `pom.xml`:
 <dependencies>
     <!-- A2A SDK and Quarkus versions both managed -->
     <dependency>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-reference-jsonrpc</artifactId>
     </dependency>
     <dependency>

boms/extras/pom.xml

@@ -5,7 +5,7 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>io.github.a2asdk</groupId>
+        <groupId>org.a2aproject.sdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
         <version>1.0.0.Alpha4-SNAPSHOT</version>
         <relativePath>../../pom.xml</relativePath>
@@ -111,7 +111,7 @@
                     <invokerPropertiesFile>invoker.properties</invokerPropertiesFile>
                     <!-- Install test-utils module before running integration tests -->
                     <extraArtifacts>
-                        <extraArtifact>io.github.a2asdk:a2a-java-bom-test-utils:${project.version}:jar</extraArtifact>
+                        <extraArtifact>org.a2aproject.sdk:a2a-java-bom-test-utils:${project.version}:jar</extraArtifact>
                     </extraArtifacts>
                 </configuration>
                 <executions>