feat: Implement the spec updates for v0.2.4 and v0.2.5 (#192)

# Description

This PR brings in the updates required to align with the A2A v0.2.4 and
v0.2.5 spec versions.

- [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 #183  🦕

Author: fjuma

.github/workflows/run-tck.yml

@@ -11,7 +11,7 @@ on:
 
 env:
   # Tag of the TCK
-  TCK_VERSION: v0.2.3
+  TCK_VERSION: v0.2.5
   # Tells uv to not need a venv, and instead use system
   UV_SYSTEM_PYTHON: 1
 

README.md

@@ -89,6 +89,7 @@ public class WeatherAgentCardProducer {
                         .tags(Collections.singletonList("weather"))
                         .examples(List.of("weather in LA, CA"))
                         .build()))
+                .protocolVersion("0.2.5")
                 .build();
     }
 }
@@ -255,18 +256,21 @@ Map<String, Object> metadata = ...
 CancelTaskResponse response = client.cancelTask(new TaskIdParams("task-1234", metadata));
 ```
 
-#### Get the push notification configuration for a task
+#### Get a push notification configuration for a task
 
 ```java
 // Get task push notification configuration
 GetTaskPushNotificationConfigResponse response = client.getTaskPushNotificationConfig("task-1234");
 
-// You can also specify additional properties using a map
+// The push notification configuration ID can also be optionally specified
+GetTaskPushNotificationConfigResponse response = client.getTaskPushNotificationConfig("task-1234", "config-4567");
+
+// Additional properties can be specified using a map
 Map<String, Object> metadata = ...
-GetTaskPushNotificationConfigResponse response = client.getTaskPushNotificationConfig(new TaskIdParams("task-1234", metadata));
+GetTaskPushNotificationConfigResponse response = client.getTaskPushNotificationConfig(new GetTaskPushNotificationConfigParams("task-1234", "config-1234", metadata));
 ```
 
-#### Set the push notification configuration for a task
+#### Set a push notification configuration for a task
 
 ```java
 // Set task push notification configuration
@@ -277,6 +281,26 @@ PushNotificationConfig pushNotificationConfig = new PushNotificationConfig.Build
 SetTaskPushNotificationResponse response = client.setTaskPushNotificationConfig("task-1234", pushNotificationConfig);
 ```
 
+#### List the push notification configurations for a task
+
+```java
+ListTaskPushNotificationConfigResponse response = client.listTaskPushNotificationConfig("task-1234");
+
+// Additional properties can be specified using a map
+Map<String, Object> metadata = ...
+ListTaskPushNotificationConfigResponse response = client.listTaskPushNotificationConfig(new ListTaskPushNotificationConfigParams("task-123", metadata));
+```
+
+#### Delete a push notification configuration for a task
+
+```java
+DeleteTaskPushNotificationConfigResponse response = client.deleteTaskPushNotificationConfig("task-1234", "config-4567");
+
+// Additional properties can be specified using a map
+Map<String, Object> metadata = ...
+DeleteTaskPushNotificationConfigResponse response = client.deleteTaskPushNotificationConfig(new DeleteTaskPushNotificationConfigParams("task-1234", "config-4567", metadata));
+```
+
 #### Send a streaming message
 
 ```java

client/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.github.a2asdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>0.2.3.Beta2-SNAPSHOT</version>
+        <version>0.2.5.Beta1-SNAPSHOT</version>
     </parent>
     <artifactId>a2a-java-sdk-client</artifactId>
 

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

@@ -46,6 +46,7 @@
 import io.a2a.spec.FilePart;
 import io.a2a.spec.FileWithBytes;
 import io.a2a.spec.FileWithUri;
+import io.a2a.spec.GetTaskPushNotificationConfigParams;
 import io.a2a.spec.GetTaskPushNotificationConfigResponse;
 import io.a2a.spec.GetTaskResponse;
 import io.a2a.spec.Message;
@@ -328,7 +329,7 @@ public void testA2AClientGetTaskPushNotificationConfig() throws Exception {
 
         A2AClient client = new A2AClient("http://localhost:4001");
         GetTaskPushNotificationConfigResponse response = client.getTaskPushNotificationConfig("1",
-                new TaskIdParams("de38c76d-d54c-436c-8b9f-4c2703648d64", new HashMap<>()));
+                new GetTaskPushNotificationConfigParams("de38c76d-d54c-436c-8b9f-4c2703648d64", null, new HashMap<>()));
         assertEquals("2.0", response.getJsonrpc());
         assertEquals(1, response.getId());
         assertInstanceOf(TaskPushNotificationConfig.class, response.getResult());
@@ -442,6 +443,7 @@ public void testA2AClientGetAgentCard() throws Exception {
         assertEquals(outputModes, skills.get(1).outputModes());
         assertTrue(agentCard.supportsAuthenticatedExtendedCard());
         assertEquals("https://georoute-agent.example.com/icon.png", agentCard.iconUrl());
+        assertEquals("0.2.5", agentCard.protocolVersion());
     }
 
     @Test
@@ -514,6 +516,7 @@ public void testA2AClientGetAuthenticatedExtendedAgentCard() throws Exception {
         assertEquals(List.of("extended"), skills.get(2).tags());
         assertTrue(agentCard.supportsAuthenticatedExtendedCard());
         assertEquals("https://georoute-agent.example.com/icon.png", agentCard.iconUrl());
+        assertEquals("0.2.5", agentCard.protocolVersion());
     }
 
     @Test

client/src/test/java/io/a2a/client/A2AClientTest.java

@@ -67,7 +67,8 @@ public class JsonMessages {
                     ]
                   }
                 ],
-                "supportsAuthenticatedExtendedCard": true
+                "supportsAuthenticatedExtendedCard": true,
+                "protocolVersion": "0.2.5"
               }""";
 
     static final String AUTHENTICATION_EXTENDED_AGENT_CARD = """
@@ -137,7 +138,8 @@ public class JsonMessages {
                     "tags": ["extended"]
                   }
                 ],
-                "supportsAuthenticatedExtendedCard": true
+                "supportsAuthenticatedExtendedCard": true,
+                "protocolVersion": "0.2.5"
               }""";
 
 

client/src/test/java/io/a2a/client/JsonMessages.java

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.github.a2asdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>0.2.3.Beta2-SNAPSHOT</version>
+        <version>0.2.5.Beta1-SNAPSHOT</version>
     </parent>
     <artifactId>a2a-java-sdk-common</artifactId>
 

common/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.github.a2asdk</groupId>
         <artifactId>a2a-java-sdk-examples-parent</artifactId>
-        <version>0.2.3.Beta2-SNAPSHOT</version>
+        <version>0.2.5.Beta1-SNAPSHOT</version>
     </parent>
 
     <artifactId>a2a-java-sdk-examples-client</artifactId>

examples/helloworld/client/pom.xml

@@ -1,5 +1,5 @@
 ///usr/bin/env jbang "$0" "$@" ; exit $?
-//DEPS io.github.a2asdk:a2a-java-sdk-client:0.2.3.Beta2-SNAPSHOT
+//DEPS io.github.a2asdk:a2a-java-sdk-client:0.2.5.Beta2-SNAPSHOT
 //SOURCES HelloWorldClient.java
 
 /**

examples/helloworld/client/src/main/java/io/a2a/examples/helloworld/HelloWorldRunner.java

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.github.a2asdk</groupId>
         <artifactId>a2a-java-sdk-parent</artifactId>
-        <version>0.2.3.Beta2-SNAPSHOT</version>
+        <version>0.2.5.Beta1-SNAPSHOT</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>