feat: Implement the spec updates for v0.3.0 #212

fjuma · 2025-08-01T20:26:25Z

Description

This PR introduces some new spec classes and updates some existing ones based off the updates in the v0.3.0 spec.

Note that the TCK job will fail until the v0.3.0 TCK is available.

Follow the CONTRIBUTING Guide.
Make your Pull Request title in the https://www.conventionalcommits.org/ specification.
- Important Prefixes for release-please:
  - fix: which represents bug fixes, and correlates to a SemVer patch.
  - feat: represents a new feature, and correlates to a SemVer minor.
  - feat!:, or fix!:, refactor!:, etc., which represent a breaking change (indicated by the !) and will result in a SemVer major.
Ensure the tests pass
Appropriate READMEs were updated (if necessary)

Fixes #209 🦕

gemini-code-assist

Summary of Changes

Hello @fjuma, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request brings the A2A Java SDK into alignment with the recently released v0.3.0 specification. It introduces significant updates to the core data models, particularly enhancing the AgentCard structure with new fields like transport protocols and digital signatures. A key new feature is the implementation of the agent/getAuthenticatedExtendedCard API, enabling secure retrieval of extended agent metadata. Additionally, a new security scheme for mutual TLS is added, and various existing specification classes receive updated documentation and minor structural adjustments.

Highlights

Core Spec Alignment: Updates the SDK to conform with the v0.3.0 A2A specification, introducing new data models and modifying existing ones.
Authenticated Extended Agent Card API: Implements the new agent/getAuthenticatedExtendedCard JSON-RPC method, allowing clients to retrieve an authenticated extended agent card, along with corresponding request, response, and error classes.
Agent Card Structure Enhancements: Modifies the AgentCard to include preferredTransport, additionalInterfaces, and signatures, and renames the default agent card discovery path from /.well-known/agent.json to /.well-known/agent-card.json. New classes AgentCardSignature and TransportProtocol are introduced.
New Security Scheme: Introduces MutualTLSSecurityScheme to support mTLS authentication, expanding the available security options.
Project Version Update: Bumps the project's parent and dependency versions to 0.3.0.Beta1-SNAPSHOT across all modules.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments or fill out our survey to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request implements the v0.3.0 spec for the A2A protocol, introducing new spec classes and updating existing ones. The changes include updates to client, server implementations, spec definitions, and examples. The implementation is well-executed with diligent updates to tests. Minor issues related to correctness and maintainability have been identified.

gemini-code-assist · 2025-08-01T20:29:28Z

client/src/main/java/io/a2a/client/A2AClient.java

+            String httpResponseBody = sendPostRequest(request, authHeaders);
+            return unmarshalResponse(httpResponseBody, GET_AUTHENTICATED_AGENT_CARD_RESPONSE_REFERENCE);
+        } catch (IOException | InterruptedException e) {
+            throw new A2AServerException("Failed to get authenticated extended agent card: " + e, e.getCause());


The original exception e should be passed as the cause for the new A2AServerException, not e.getCause(). Using e.getCause() can lead to loss of important stack trace information if e itself is the root cause and has no further cause.

Suggested change

throw new A2AServerException("Failed to get authenticated extended agent card: " + e, e.getCause());

throw new A2AServerException("Failed to get authenticated extended agent card: " + e, e);

gemini-code-assist · 2025-08-01T20:29:28Z

client/src/main/java/io/a2a/client/A2AClient.java

    private static final TypeReference<SetTaskPushNotificationConfigResponse> SET_TASK_PUSH_NOTIFICATION_CONFIG_RESPONSE_REFERENCE = new TypeReference<>() {};
    private static final TypeReference<ListTaskPushNotificationConfigResponse> LIST_TASK_PUSH_NOTIFICATION_CONFIG_RESPONSE_REFERENCE = new TypeReference<>() {};
    private static final TypeReference<DeleteTaskPushNotificationConfigResponse> DELETE_TASK_PUSH_NOTIFICATION_CONFIG_RESPONSE_REFERENCE = new TypeReference<>() {};
+    private static final TypeReference<GetAuthenticatedExtendedCardResponse> GET_AUTHENTICATED_AGENT_CARD_RESPONSE_REFERENCE = new TypeReference<>() {};


The name of this constant, GET_AUTHENTICATED_AGENT_CARD_RESPONSE_REFERENCE, does not match its generic type GetAuthenticatedExtendedCardResponse. For consistency and to avoid confusion, it should be renamed to GET_AUTHENTICATED_EXTENDED_CARD_RESPONSE_REFERENCE.

Suggested change

private static final TypeReference<GetAuthenticatedExtendedCardResponse> GET_AUTHENTICATED_AGENT_CARD_RESPONSE_REFERENCE = new TypeReference<>() {};

private static final TypeReference<GetAuthenticatedExtendedCardResponse> GET_AUTHENTICATED_EXTENDED_CARD_RESPONSE_REFERENCE = new TypeReference<>() {};

gemini-code-assist · 2025-08-01T20:29:28Z

spec/src/main/java/io/a2a/spec/GetAuthenticatedExtendedCardRequest.java

+        if (! method.equals(METHOD)) {
+            throw new IllegalArgumentException("Invalid GetTaskPushNotificationRequest method");
+        }


The exception message here is incorrect. It refers to GetTaskPushNotificationRequest but should refer to GetAuthenticatedExtendedCardRequest. This seems to be a copy-paste error.

Suggested change

if (! method.equals(METHOD)) {

throw new IllegalArgumentException("Invalid GetTaskPushNotificationRequest method");

}

if (! method.equals(METHOD)) {

throw new IllegalArgumentException("Invalid GetAuthenticatedExtendedCardRequest method");

}

…ion for v0.2.6

…t to JSONRPC as per v0.3.0

…tests

…emove the previous authenticatedExtendedCard endpoint

…ow Skills to specify Security as per v0.3.0

…t-card.json as per v0.3.0

…ow Skills to specify Security for gRPC as per v0.3.0

fjuma · 2025-08-18T21:04:04Z

@maeste @ehsavoie I've updated the TCK version here to 0.3.0.alpha and CI passed. Please review when you get a chance. Thanks!

# Description This PR introduces some new spec classes and updates some existing ones based off the updates in the [v0.3.0 spec](https://github.com/a2aproject/A2A/releases/tag/v0.3.0). Note that the TCK job will fail until the v0.3.0 TCK is available. - [X] Follow the [`CONTRIBUTING` Guide](../CONTRIBUTING.md). - [X] Make your Pull Request title in the <https://www.conventionalcommits.org/> specification. - Important Prefixes for [release-please](https://github.com/googleapis/release-please): - `fix:` which represents bug fixes, and correlates to a [SemVer](https://semver.org/) patch. - `feat:` represents a new feature, and correlates to a SemVer minor. - `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking change (indicated by the `!`) and will result in a SemVer major. - [X] Ensure the tests pass - [X] Appropriate READMEs were updated (if necessary) Fixes a2aproject#209 🦕

gemini-code-assist bot reviewed Aug 1, 2025

View reviewed changes

fjuma force-pushed the v0.3.0 branch from c47f50c to b682e57 Compare August 1, 2025 20:36

fjuma self-assigned this Aug 6, 2025

fjuma force-pushed the v0.3.0 branch 6 times, most recently from 5a511ff to 1f2d12f Compare August 7, 2025 21:08

fjuma added 15 commits August 13, 2025 10:48

fix: acceptedOutputModes should be optional for MessageSendConfigurat…

a61c81b

…ion for v0.2.6

fix: Add default protocol version as per v0.2.6

0263876

fix: Improve the documentation for spec classes as per v0.3.0

f240d05

fix: Add TransportProtocol enum and set the default preferredTranspor…

f2475d5

…t to JSONRPC as per v0.3.0

feat: Add signatures to AgentCard as per v0.3.0 and update AgentCard …

eff428e

…tests

feat: Add a JSON-RPC method for fetching an extended agent card and r…

2961495

…emove the previous authenticatedExtendedCard endpoint

feat: Add mTLS to SecuritySchemes, add oauth2 metadata url field, all…

c33d9c8

…ow Skills to specify Security as per v0.3.0

fix: Change well-known URI for the agent card from agent.json to agen…

554e051

…t-card.json as per v0.3.0

fix: Update to TCK v0.3.0

58df804

chore: Bump version to 0.3.0.Beta1-SNAPSHOT

4a9abb9

feat: Update the proto and grpc-spec files for v0.3.0

d5fddc6

feat: Add signatures to AgentCard for gRPC as per v0.3.0

05bd9d7

feat: Add mTLS to SecuritySchemes, add oauth2 metadata url field, all…

d45218c

…ow Skills to specify Security for gRPC as per v0.3.0

fix: Update tck agent to indicate support for gRPC

c141b68

fix: Ensure the gRPC service is started correctly

f34591a

fjuma force-pushed the v0.3.0 branch from 1f2d12f to f34591a Compare August 13, 2025 15:14

fjuma added 3 commits August 14, 2025 10:09

fix: Check if taskId is empty in FromProto#message

6db628f

fix: Fix gRPC TCK failures

ca4ee3d

fix: Update TCK version to 0.3.0alpha

0c1f335

fjuma force-pushed the v0.3.0 branch from 79c590f to 0c1f335 Compare August 18, 2025 20:59

fjuma marked this pull request as ready for review August 18, 2025 21:02

fjuma requested a review from maeste August 18, 2025 21:04

maeste approved these changes Aug 18, 2025

View reviewed changes

fjuma merged commit 198504b into a2aproject:main Aug 19, 2025
3 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Implement the spec updates for v0.3.0 #212

feat: Implement the spec updates for v0.3.0 #212

Uh oh!

fjuma commented Aug 1, 2025

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot Aug 1, 2025

Uh oh!

fjuma Aug 1, 2025

Uh oh!

gemini-code-assist bot Aug 1, 2025

Uh oh!

fjuma Aug 1, 2025

Uh oh!

gemini-code-assist bot Aug 1, 2025

Uh oh!

fjuma Aug 1, 2025

Uh oh!

fjuma commented Aug 18, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	throw new A2AServerException("Failed to get authenticated extended agent card: " + e, e.getCause());
	throw new A2AServerException("Failed to get authenticated extended agent card: " + e, e);

	private static final TypeReference<GetAuthenticatedExtendedCardResponse> GET_AUTHENTICATED_AGENT_CARD_RESPONSE_REFERENCE = new TypeReference<>() {};
	private static final TypeReference<GetAuthenticatedExtendedCardResponse> GET_AUTHENTICATED_EXTENDED_CARD_RESPONSE_REFERENCE = new TypeReference<>() {};

feat: Implement the spec updates for v0.3.0 #212

feat: Implement the spec updates for v0.3.0 #212

Uh oh!

Conversation

fjuma commented Aug 1, 2025

Description

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

fjuma Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

fjuma Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

fjuma Aug 1, 2025

Choose a reason for hiding this comment

Uh oh!

fjuma commented Aug 18, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants