A2A Java SDK 1.0.0.Alpha3

Installation

Maven:

<dependency>
    <groupId>io.github.a2asdk</groupId>
    <artifactId>a2a-java-sdk-client</artifactId>
    <version>1.0.0.Alpha3</version>
</dependency>

Gradle:

implementation 'io.github.a2asdk:a2a-java-sdk-client:1.0.0.Alpha3'

Links

• Maven Central
• JavaDoc
• GitHub

Changes since v1.0.0.Alpha2

Full Changelog

What's Changed

• chore: Reenable TCK testing for Pull Requests by @jmesnil in #645
• chore: Next SNAPSHOT version by @kabir in #644
• chore: Switch to the TCK main branch for 1.0 by @jmesnil in #646
• chore: Add tests for ClientTaskManager by @tibisabau in #650
• chore: add workaround for container tests by @jmesnil in #659
• feat!: Update TaskState enums by @jmesnil in #660
• fix: handle empty Struct in valueToObject to prevent NullPointerException by @lizongbo in #619
• feat: Add metadata support to Part types by @ehsavoie in #658
• fix: Why not set tenant to "" in ListTasksParams$Builder? by @ehsavoie in #657
• chore: Renaming attributes in spec modules to align with the new names by @ehsavoie in #647
• feat!: Update Message.Role enum by @jmesnil in #662
• fix: use SERVER_URL constant in A2ACardResolver constructor in HelloWorldClient #664 by @CokeLee777 in #666
• feat: Add agent-to-agent communication testing (#625) by @kabir in #654
• chore: Fix compile errors by @kabir in #669
• feat!: Add SecurityRequirement to the domain API by @jmesnil in #670
• fix: flaky testInputRequiredWorkflow test by @kabir in #671
• fix: flaky Agent to Agent tests by @kabir in #672
• feat: Move the sendMessage with a MessageSendParams to the AbstractClient by @jmesnil in #665
• chore: release 1.0.0.Alpha3 by @kabir in #674

New Contributors

• @tibisabau made their first contribution in #650
• @lizongbo made their first contribution in #619
• @CokeLee777 made their first contribution in #666

Full Changelog: v1.0.0.Alpha2...v1.0.0.Alpha3

A2A Java SDK 1.0.0.Alpha2

Installation

Maven:

<dependency>
    <groupId>io.github.a2asdk</groupId>
    <artifactId>a2a-java-sdk-client</artifactId>
    <version>1.0.0.Alpha2</version>
</dependency>

Gradle:

implementation 'io.github.a2asdk:a2a-java-sdk-client:1.0.0.Alpha2'

Links

• Maven Central
• JavaDoc
• GitHub

Changes since v1.0.0.Alpha1

Full Changelog

What's Changed

• chore: Next is 1.0.0.Alpha2 by @kabir in #603
• feat!: update a2a.proto 0572953 by @jmesnil in #606
• test: Add input-required workflow coverage by @ehsavoie in #609
• chore: Centralise PageToken parsing by @kabir in #601
• fix: add missing META-INF/beans.xml to microprofile-config integration by @roguexz in #589
• feat: Implement MainEventBus architecture for event queue processing by @kabir in #611
• feat: Replace quarkus-rest(-client)-jackson with quarkus-rest(-client) by @kabir in #581
• refactor: extract shared SSE event handling into SPI module by @ehsavoie in #624
• chore: Managing tenant in JSONRPC. by @ehsavoie in #613
• chore: Add timouts to requesthandler tests by @kabir in #626
• feat!: Update a2a.proto d14f410 by @jmesnil in #614
• chore: fixing flaky test by @ehsavoie in #628
• chore: Upgrade Nullaway and error prone by @ehsavoie in #629
• fix: Eliminate race condition in testInputRequiredWorkflow by @kabir in #630
• fix: merge metadata appendArtifactToTask metadata #615 by @flex-myeonghyeon in #616
• fix: Eliminate intermittent failure in testQueueClosedEventTerminates… by @kabir in #631
• refactor: Update A2A protocol to align with spec revision by @ehsavoie in #633
• fix: Noargs constructor for Jakarta CDI compatibility by @kabir in #637
• fix: Race condition in testNonBlockingWithMultipleMessages by @kabir in #636
• feat: Implement PushNotifications as per the 1.0 spec by @kabir in #622
• feat!: Use AgentEmitter instead of EventQueue in AgentExecutor methods by @kabir in #621
• fix: ListTask's statusTimestampAfter only accept ISO 8601 format by @jmesnil in #640
• chore: Migrate spec module to JSpecify annotations for null-safety by @ehsavoie in #638
• fix: rename the HTTP request parameter statusTimestampAfter by @jmesnil in #641
• feat: Make RequestContext taskId and contextId nullable. by @kabir in #642
• feat: Add telemetry support. by @ehsavoie in #463
• chore: Release 1.0.0.Alpha2 by @kabir in #643

New Contributors

• @roguexz made their first contribution in #589

Full Changelog: v1.0.0.Alpha1...v1.0.0.Alpha2

A2A Java SDK 1.0.0.Alpha1

Links

• Maven Central
• JavaDoc
• GitHub

Changes since v0.3.3.Final

Full Changelog

What's Changed

• fix: use pull_request_trigger to get access to secrets by @kabir in #406
• fix: Add missing extensions to Artifact and Message by @fjuma in #409
• chore: Update COMMUNITY_ARTICLES.md by @fjuma in #407
• fix: Fix typo in Artifact.Builder#extensions by @fjuma in #413
• fix: Clean up the k8s example pom, and the extras application properties by @kabir in #415
• fix: Changes needed to have ConfigProperty injection working in Jakarta by @kabir in #417
• chore: Run TCK on 0.3.x branch too, and use latest TCK by @kabir in #421
• fix: clear status.message after adding to history in TaskManager.updateWithMessage #424 by @flex-myeonghyeon in #425
• fix: merge metadata instead of replacing in TaskManager.TaskStatusUpdateEvent #426 by @flex-myeonghyeon in #427
• fix: fixing the handling of historyLength being set to 0 by default in gRPC by @ehsavoie in #429
• fix: Change image for the multi instance replicated queuemanager test by @kabir in #439
• fix: Make sure we use @Inject on @ConfigProperty by @kabir in #437
• fix: Wait for agent completion and ensure all events processed in blo… by @kabir in #431
• fix: NPE with test JSONRPCHandlerTest.testOnMessageNewMessageSuccessMocks by @ehsavoie in #444
• chore: Update to the latest a2a.proto file and some corresponding updates for 0.4.0 by @fjuma in #392
• fix: Adding support for Jspecify for JSONRPC by @ehsavoie in #452
• fix: use main branch of TCK for 0.4.0 features by @kabir in #456
• chore: Use strict TCK mode by @kabir in #457
• feat: add list tasks functionality by @kabir in #455
• fix: Update A2A Protocol link in README.md by @448523760 in #454
• fix: Improve Kubernetes Example reliability on CI by @kabir in #435
• feat: Introduce BOMs by @kabir in #462
• feat: update tasks/list implementation to match A2A 0.4.0 spec by @kabir in #459
• feat!: Remove hard dependency on MicroProfile Config from the core SDK by @kabir in #468
• fix: Making the event queue overridable by @ehsavoie in #473
• fix: Constants to the confg properties by @kabir in #470
• chore: Remove unused imports by @kabir in #465
• feat: Add Javadoc for the spec module by @kabir in #466
• fix: Rename push_notification to push_notification_config by @kabir in #482
• fix: Store push notification config for newly created tasks by @kabir in #483
• fix: Add Content-Type header to push notification requests by @jmesnil in #489
• feat!: Updating to newest proto to align with 1.0 Draft specifications by @ehsavoie in #484
• chore: fix javadoc errors by @jmesnil in #510
• feat: update grpc-java to the newer version; handle introduced StatusException by @anFatum in #488
• chore: Upgrading and fixing nullaway on JDK 25 by @ehsavoie in #520
• chore(dep): Upgrading versions by @ehsavoie in #521
• refactor: Complete migration from Jackson to Gson across codebase by @ehsavoie in #514
• chore: Enable javadoc in the default profile by @jmesnil in #525
• docs: Add comprehensive Javadoc to spec module classes by @ehsavoie in #527
• chore: add a dedicated javadoc Maven profile by @jmesnil in #529
• chore: Use the same validation for all JSON RPC Request class by @jmesnil in #530
• chore: Add a temporary TCK job to run against a 1.0 WIP branch by @jmesnil in #533
• fix: Sending an invalid message to the server raises an InternalServerError by @ehsavoie in #536
• feat: 1.0.0 changes blocking default from true to false by @kabir in #537
• chore: Update resubscribe and sendMessage without consumers will use … by @jmesnil in #528
• chore: Updating JSpecify coverage by @ehsavoie in #534
• chore: Update repository path for a2a-tck checkout by @kabir in #538
• feat!: Replace public Builder constructors with static factory methods by @kabir in #540
• feat!: Upgrading to latest a2a.proto by @ehsavoie in #539
• feat: Add tenant parameter to REST push notification config endpoints by @ehsavoie in #542
• feat!: Align spec classes with the a2a.proto, removing compatibility code by @kabir in #546
• feat!: Unify spec domain classes as records by @kabir in #548
• feat: Set current protocol version to 1.0 by @kabir in #549
• feat: fixing issue 547 by using the tenant from the agent card on the by @ehsavoie in #550
• feat!: Remove kind discriminator as per the 1.0 specification by @kabir in #551
• feat!: Add pagination support to ListTaskPushNotificationConfig with Result wrapper by @ehsavoie in #552
• fix: InMemoryPushNotificationConfigStore uses wrong pagination token. by @ehsavoie in #555
• feat!: Trim io.a2a.apec package by @kabir in #556
• chore: Add proper testing of -P release of pull requests by @kabir in #559
• chore: Fix Javadoc warnings in spec/ module by @kabir in #561
• feat: Add Javadoc for the client modules by @kabir in #563
• feat: Javadoc for server-common integration points by @kabir in #565
• feat: Document release process in RELEASE.md by @kabir in #560
• feat!: Rework error classes for spec 1.0 update by @kabir in #558
• chore: Fix TCK GitHub actions by @jmesnil in #567
• feat: Reduce log level of JSONUtils.parseJsonString() errors by @kabir in #572
• fix: reject gRPC message without a messageId by @jmesnil in #569
• chore: Disable TCK runs for PRs while updating to 1.0.0 by @kabir in #573
• chore: Use 1.0.0.Alpha1-SNAPSHOT and fix update-version.sh by @kabir in #575
• fix: Remove remaining jackson dependencies/imports by @kabir in #579
• feat: Add nooargs constructors so we work in Jakarta by @kabir in #580
• fix: handle listTasks status wire strings by @hae02y in #578
• fix: Event consumer should stop on input_required by @cmtoan in #566
• chore: Use default protocol version in tests by @kabir in #582
• fix: fix flaky test testNonBlockingWithMultipleMessages by @cmtoan in #576
• fix: Fix Security JSON serialization by @jmesnil in #592
• feat!: 553:Adding pagination to JpaDatabasePushNotificationConfigStore by @Sathyvs in #564
• feat: Add pluggable A2AHttpClient with Vert.x implementation by @ehsavoie in #584
• fix: ListTasks validation and serialization across all transports by @kabir in #460
• fix: Make historyLength consistent with pageSize in map...

What's Changed

• chore: Next is 0.3.2 by @kabir in #420
• fix: use pull_request_trigger to get access to secrets (#406) by @fjuma in #412
• fix: Add missing extensions to Artifact and Message by @fjuma in #411
• fix: Change image for the multi instance replicated queuemanager test by @kabir in #440
• fix: Make sure we use @Inject on @ConfigProperty by @kabir in #438
• fix: fixing the handling of historyLength being set to 0 by default in gRPC. by @ehsavoie in #436
• fix: Wait for agent completion and ensure all events processed in blo… by @kabir in #441
• fix: NPE with test JSONRPCHandlerTest.testOnMessageNewMessageSuccessM… by @kabir in #446
• chore: Release 0.3.2.Final by @kabir in #450

Full Changelog: v0.3.1.Final...v0.3.2.Final

What's Changed

• fix: Clean up the k8s example pom, and the extras application properties by @kabir in #416
• fix: Changes needed to have ConfigProperty injection working in Jakarta by @kabir in #418
• chore: Release 0.3.1.Final by @kabir in #419

Full Changelog: v0.3.0.Final...v0.3.1.Final

What's Changed

• fix: Ensure proper errors are reported when authentication fails by @fjuma in #328
• feat: Add some additional methods to TaskUpdater by @fjuma in #339
• fix: Implement reference counting for EventQueue to prevent premature MainQueue closure by @kabir in #333
• feat: Implement robust replication and task-aware queue lifecycle by @kabir in #351
• fix: Add additional methods in TaskUpdater by @fjuma in #378
• fix: Update A2AException and A2AClientError so that they extend RuntimeException instead of IOException by @fjuma in #379
• feat: Add multi-server test using the replicated queue manager. by @kabir in #380
• feat: add JSON-RPC method to ServerCallContext.state by @ehsavoie in #353
• feat: Add cloud deployment example with event replication by @kabir in #389
• feat: Add optional entity operator wait skip for Kind by @kabir in #397

New Contributors

• @amithsourya made their first contribution in #326
• @survivant made their first contribution in #343
• @ethanthopkins made their first contribution in #340
• @devcom33 made their first contribution in #342
• @Akanksha928 made their first contribution in #341
• @leehuiseok made their first contribution in #350

Full Changelog: v0.3.0.Beta2...v0.3.0.Final

What's Changed

• feat: Add message creation methods with contextId and taskId support by @Asymtode712 in #322
• fix: Fixing build on Java 25. by @ehsavoie in #329
• fix: Ensure proper errors are reported when authentication fails by @fjuma in #328
• chore: Using error prone and jspecify to define nullability on the client API. by @ehsavoie in #330
• test: add test for streaming with multiple events by @amithsourya in #326
• chore: Using error prone and jspecify to expend the nullability by @ehsavoie in #332
• feat: Add some additional methods to TaskUpdater by @fjuma in #339
• test: Disable flaky KafkaReplicationIntegrationTest by @kabir in #346
• fix: Implement reference counting for EventQueue to prevent premature MainQueue closure by @kabir in #333
• docs: Fix typos and linguistic errors in documentation / hacktoberfest by @survivant in #343
• chore: Add Jspecify NullCheck in tck module #336 by @ethanthopkins in #340
• chore: add Jspecify NullCheck in grpc transport (Fixes #334) by @devcom33 in #342
• feat: Implement robust replication and task-aware queue lifecycle by @kabir in #351
• fix: Add additional methods in TaskUpdater by @fjuma in #378
• test: add ToProto and FromProto tests by @Akanksha928 in #341
• Revert "test: add ToProto and FromProto tests" by @ehsavoie in #381
• fix: Update A2AException and A2AClientError so that they extend RuntimeException instead of IOException by @fjuma in #379
• feat: Add multi-server test using the replicated queue manager. by @kabir in #380
• feat: add JSON-RPC method to ServerCallContext.state by @ehsavoie in #353
• chore: fixing issue #390 by adding copy builders to TaskArtifactUpdateEvent and TaskStatusUpdateEvent. by @ehsavoie in #391
• feat: Add cloud deployment example with event replication by @kabir in #389
• feat: add ArtifactUtils utility class and corresponding tests (#303) by @leehuiseok in #350
• feat: Add optional entity operator wait skip for Kind by @kabir in #397
• fix: Filter benign stream errors in KafkaReplicationIntegrationTest a… by @kabir in #398
• fix: javadoc issues uncovered when using -Prelease by @kabir in #404
• chore: Add workflow to build with -Prelease by @kabir in #405

New Contributors

• @amithsourya made their first contribution in #326
• @survivant made their first contribution in #343
• @ethanthopkins made their first contribution in #340
• @devcom33 made their first contribution in #342
• @Akanksha928 made their first contribution in #341
• @leehuiseok made their first contribution in #350

Full Changelog: v0.3.0.Beta2...v0.3.0.Final

What's Changed

• Database versions of TaskStore and PushNotificationStore have been added in #293 and #301
• A replicated QueueManager, with a pluggable ReplicationStrategy, has been added in #309
• Several additions, fixes, and tests from the Python SDK related to ServerCallContext, PushNotifications, TaskUpdater, and Clients have been incorporated
• We now ensure authentication is required for all endpoints that require it and add an AuthInterceptor that can obtain credentials from a CredentialService in #292
• We have upgraded our reference implementations to Quarkus 3.28.1 in #316

New Contributors

• @Niravkumar-Patel made their first contribution in #258
• @powmax-commits made their first contribution in #290
• @whatsupsumit made their first contribution in #323
• @Asymtode712 made their first contribution in #321

Full Changelog: v0.3.0.Beta1...v0.3.0.Beta2

What's Changed

• Support HTTP+JSON/REST by @ehsavoie in #229
• Agent card transport validation by @kabir in #251
• Avoid NPE for gRPC when acceptedOutputModes isn't specified for the client side by @fjuma in #256
• Use proper annotation for default beans by @kabir in #271

Full Changelog: v0.3.0.Alpha1...v0.3.0.Beta1

What's Changed

• Support for v0.3.0 of the A2A specification by @fjuma in #212
• Support for gRPC by @fjuma and @kabir in #211
• The a2a-java-reference-server module has been renamed to a2a-java-sdk-reference-jsonrpc and a new a2a-java-sdk-reference-grpc module has been introduced
• Major refactor for the A2A client to make it transport agnostic by @fjuma and @brasseld in #231 and #238
• Several updates to the README

New Contributors

• @mbroz2 made their first contribution in #203
• @holtskinner made their first contribution in #218
• @skyllarr made their first contribution in #240
• @xumk made their first contribution in #241
• @misselvexu made their first contribution in #181

Full Changelog: 0.2.5...v0.3.0.Alpha1

What's Changed

• Support for v0.2.5 of the A2A specification by @fjuma in #192
• The a2a-java-sdk-server-quarkus module has been renamed to a2a-java-reference-server by @kabir in #178. This is a reference A2A server implementation based on Quarkus
• The a2a-java-sdk-server-jakarta module has been split out into a separate repository by @kabir in #178

New Contributors

• @ChenKangQiang made their first contribution in #177

Full Changelog: 0.2.3.Beta1...0.2.5