Skip to content

feat: Add 0.3 compatibility layer #797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kabir wants to merge 56 commits into
base: main
Choose a base branch
from
Open

feat: Add 0.3 compatibility layer #797

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
acbc4bc
Set up folder/pom structure of compat module
kabir Apr 10, 2026
305f312
Wire in the new poms
kabir Apr 10, 2026
a21b941
Update POM names to include 'Compat 0.3'
kabir Apr 10, 2026
6f7f6d8
Port spec and spec-grpc packages
kabir Apr 10, 2026
aff7fca
Add compat client modules
kabir Apr 10, 2026
0aac6eb
Add the transport/* modules
kabir Apr 10, 2026
4c7295d
feat(compat-0.3): implement reference server endpoints and transport …
kabir Apr 13, 2026
2a8fe67
Implement rest handlers
kabir Apr 13, 2026
3ad9a78
Port Jackson to Gson/Protobuf migration
kabir Apr 13, 2026
9d9caa0
Fix Javadoc errors
kabir Apr 13, 2026
f3780d6
Enable the compat-0.3/tck module
kabir Apr 13, 2026
9af6df9
Add compat-0.3/server-conversion module
kabir Apr 13, 2026
5ba65dd
Add core 0.3-1.0 mappers
kabir Apr 13, 2026
fa1b728
Add more complex mappers
kabir Apr 13, 2026
c9b0e6a
Test Task conversion
kabir Apr 13, 2026
69133a0
Add more mappers
kabir Apr 13, 2026
ccd7170
Implement the converting requesthandler
kabir Apr 13, 2026
98ff5d7
Wire converting request handler into JSONRPCHandler
kabir Apr 13, 2026
8249dd1
Wire converting request handler into RestHandler
kabir Apr 13, 2026
1b887c2
Wire converting request handler into GrpcHandler
kabir Apr 13, 2026
df98d0d
Add compat-0.3 AbstractA2ARequestHandlerTest
kabir Apr 13, 2026
7354d8f
Get core JSONRPCHandlerTest tests working
kabir Apr 13, 2026
6a8ff7b
Get core RestHandlerTest tests working
kabir Apr 13, 2026
7c5358e
Get core GrpcHandlerTest tests working
kabir Apr 13, 2026
919af5c
Centralise error conversion
kabir Apr 14, 2026
6597073
Port GrpcErrorMapperTest from 1.0
kabir Apr 14, 2026
5eb624f
Port JSONRPC streaming and pushnotificaationconfig tests
kabir Apr 14, 2026
c1a52f5
Port REST streaming and pushnotificaationconfig tests
kabir Apr 14, 2026
3740ef0
Port gRPC transport and pushnotificaationconfig tests
kabir Apr 14, 2026
572cc38
Cleanup
kabir Apr 14, 2026
86ea0d7
Review fixes
kabir Apr 14, 2026
6d98b8d
Fix Javadoc
kabir Apr 14, 2026
ecbff87
feat: Add v0.3 client dependencies to server-conversion module
kabir Apr 14, 2026
df3b5e2
feat: Port AgentExecutorProducer with EventQueue to AgentEmitter conv…
kabir Apr 14, 2026
2d7d1df
fix: Use throw instead of fail() for error handling consistency
kabir Apr 14, 2026
4f8fd49
feat: port AbstractCompat03ServerTest with all integration tests
kabir Apr 14, 2026
dd65036
fix: Add missing test dependencies and fix JsonProcessingException im…
kabir Apr 14, 2026
f795460
fix: Convert PushNotificationConfig v0.3 to v1.0 in savePushNotificat…
kabir Apr 14, 2026
05d9b8b
fix: Use v1.0 JsonUtil for push notification config serialization
kabir Apr 14, 2026
5986eda
feat: Add server-conversion test-jar dependency to jsonrpc reference …
kabir Apr 14, 2026
1458365
feat: port A2ATestRoutes to expose v1.0 TestUtilsBean via REST endpoints
kabir Apr 14, 2026
c92990a
feat: Enable QuarkusA2AJSONRPCTest and add client dependencies
kabir Apr 14, 2026
e91ac98
fix: Add CDI bean discovery configuration for compat-0.3 modules
kabir Apr 14, 2026
08c1965
fix(compat-0.3): Fix CDI bean discovery for JSONRPC reference server …
kabir Apr 14, 2026
1e65240
fix(compat-0.3): Enable push notifications capability in test AgentCard
kabir Apr 14, 2026
ef61e77
fix(compat-0.3): Add JVM args to open java.lang for Gson reflection
kabir Apr 14, 2026
7a75be4
fix(compat-0.3): Handle initial task snapshot in resubscription tests
kabir Apr 14, 2026
6313182
feat(compat-0.3): Port REST reference server tests
kabir Apr 15, 2026
c0d177c
fix(compat-0.3): Use taskId as default configId in REST getTaskPushNo…
kabir Apr 15, 2026
f9895fd
test(compat-0.3): Add testMethodNotFound to REST reference server tests
kabir Apr 15, 2026
a1d1dbb
feat(compat-0.3): Port gRPC reference server tests
kabir Apr 15, 2026
abe1988
chore(compat-0.3): Remove placeholder A2AServerRoutesTest stubs
kabir Apr 15, 2026
f26abc4
docs(compat-0.3): Remove TODOs about initial task snapshot validity
kabir Apr 15, 2026
0441ec6
refactor(compat-0.3): Unify test infrastructure in server-conversion …
kabir Apr 15, 2026
081e9f7
fix(compat-0.3): Remove JVM args workaround for Gson reflection
kabir Apr 15, 2026
96797e1
Adapt tests so we work now that PR 788 has been merged
kabir Apr 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions ...ras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/test/ExtrasBomVerifier.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ public class ExtrasBomVerifier extends DynamicBomVerifier {
"tck/", // TCK test suite
"tests/", // Integration tests
"test-utils-docker/", // Test utilities for Docker-based tests
"compat-0.3/", // Compat 0.3 modules (part of SDK BOM, not extras BOM)
"extras/queue-manager-replicated/tests-multi-instance/", // Test harness applications
"extras/queue-manager-replicated/tests-single-instance/", // Test harness applications
"extras/opentelemetry/integration-tests/" // Test harness applications
Expand Down
3 changes: 2 additions & 1 deletion ...c/it/reference-usage-test/src/main/java/org/a2aproject/sdk/test/ReferenceBomVerifier.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ public class ReferenceBomVerifier extends DynamicBomVerifier {
"examples/", // Example applications
"tck/", // TCK test suite
"tests/", // Integration tests
"test-utils-docker/" // Test utilities for Docker-based tests
"test-utils-docker/", // Test utilities for Docker-based tests
"compat-0.3/" // Compat 0.3 modules (part of SDK BOM, not reference BOM)
// Note: reference/ is NOT in this list - we want to verify those classes load
);

Expand Down
85 changes: 85 additions & 0 deletions boms/sdk/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,91 @@
<version>${project.version}</version>
</dependency>

<!-- Compat 0.3 Spec modules -->
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec-grpc</artifactId>
<version>${project.version}</version>
</dependency>

<!-- Compat 0.3 HTTP Client -->
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-http-client</artifactId>
<version>${project.version}</version>
</dependency>

<!-- Compat 0.3 Client modules -->
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-spi</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-jsonrpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-grpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-rest</artifactId>
<version>${project.version}</version>
</dependency>

<!-- Compat 0.3 Transport modules -->
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-jsonrpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-grpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-rest</artifactId>
<version>${project.version}</version>
</dependency>

<!-- Compat 0.3 Reference modules -->
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-common</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-jsonrpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-grpc</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-rest</artifactId>
<version>${project.version}</version>
</dependency>

<!-- Test utilities -->
<dependency>
<groupId>${project.groupId}</groupId>
Expand Down
70 changes: 70 additions & 0 deletions boms/sdk/src/it/sdk-usage-test/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,76 @@
<artifactId>a2a-java-sdk-transport-rest</artifactId>
</dependency>

<!-- Compat 0.3 Spec modules -->
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec-grpc</artifactId>
</dependency>

<!-- Compat 0.3 HTTP Client -->
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-http-client</artifactId>
</dependency>

<!-- Compat 0.3 Client modules -->
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-spi</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-jsonrpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-grpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-rest</artifactId>
</dependency>

<!-- Compat 0.3 Transport modules -->
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-jsonrpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-grpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-transport-rest</artifactId>
</dependency>

<!-- Compat 0.3 Reference modules -->
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-common</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-jsonrpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-grpc</artifactId>
</dependency>
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-reference-rest</artifactId>
</dependency>

<!-- Third-party dependencies -->
<dependency>
<groupId>org.slf4j</groupId>
Expand Down
1 change: 1 addition & 0 deletions boms/sdk/src/it/sdk-usage-test/src/main/java/org/a2aproject/sdk/test/SdkBomVerifier.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ public class SdkBomVerifier extends DynamicBomVerifier {
"boms/", // BOM test modules themselves
"examples/", // Example applications
"tck/", // TCK test suite
"compat-0.3/tck/", // Compat 0.3 TCK (not yet enabled)
"tests/", // Integration tests
"test-utils-docker/" // Test utilities for Docker-based tests
);
Expand Down
84 changes: 84 additions & 0 deletions compat-0.3/client/base/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
<?xml version="1.0"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"
xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>

<parent>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-compat-0.3-parent</artifactId>
<version>1.0.0.Beta1-SNAPSHOT</version>
<relativePath>../..</relativePath>
</parent>
<artifactId>a2a-java-sdk-compat-0.3-client</artifactId>

<packaging>jar</packaging>

<name>Java SDK A2A Compat 0.3 Client</name>
<description>Java SDK for the Agent2Agent Protocol (A2A) - Client</description>

<dependencies>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-http-client</artifactId>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-spi</artifactId>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-jsonrpc</artifactId>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-grpc</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-client-transport-rest</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-common</artifactId>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec</artifactId>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>a2a-java-sdk-compat-0.3-spec-grpc</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<scope>test</scope>
</dependency>

<dependency>
<groupId>org.mock-server</groupId>
<artifactId>mockserver-netty</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-jdk14</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.grpc</groupId>
<artifactId>grpc-testing</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.grpc</groupId>
<artifactId>grpc-inprocess</artifactId>
<scope>test</scope>
</dependency>
</dependencies>

</project>
Loading
Loading