Skip to content

Commit 4eba5ba

Browse files
sunyuhan1998sunyuhan1998
committed
Merge branch 'main' into refactor-issue-165
2 parents 7292fc3 + abe92d8 commit 4eba5ba

File tree

15 files changed

+179
-80
lines changed

15 files changed

+179
-80
lines changed

‎README.md‎

Lines changed: 32 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -29,26 +29,38 @@ More examples will be added soon.
2929

3030
The A2A Java SDK provides a Java server implementation of the [Agent2Agent (A2A) Protocol](https://google-a2a.github.io/A2A). To run your agentic Java application as an A2A server, simply follow the steps below.
3131

32-
- [Add the A2A Java SDK Core Maven dependency to your project](#1-add-the-a2a-java-sdk-core-maven-dependency-to-your-project)
32+
- [Add an A2A Java SDK Server Maven dependency to your project](#1-add-an-a2a-java-sdk-server-maven-dependency-to-your-project)
3333
- [Add a class that creates an A2A Agent Card](#2-add-a-class-that-creates-an-a2a-agent-card)
3434
- [Add a class that creates an A2A Agent Executor](#3-add-a-class-that-creates-an-a2a-agent-executor)
35-
- [Add an A2A Java SDK Server Maven dependency to your project](#4-add-an-a2a-java-sdk-server-maven-dependency-to-your-project)
3635

37-
### 1. Add the A2A Java SDK Maven dependencies to your project
36+
### 1. Add an A2A Java SDK Server Maven dependency to your project
3837

39-
> **Note**: The A2A Java SDK isn't available yet in Maven Central but will be soon. For now, be
40-
> sure to check out the latest tag (you can see the tags [here](https://github.com/a2aproject/a2a-java/tags)), build from the tag, and reference that version below. For example, if the latest tag is `0.2.3`, you can use the following dependency.
38+
Adding a dependency on an A2A Java SDK Server will provide access to the core classes that make up the A2A specification
39+
and allow you to run your agentic Java application as an A2A server agent.
40+
41+
The A2A Java SDK provides two A2A server endpoint implementations, one based on Jakarta REST (`a2a-java-sdk-server-jakarta`) and one based on Quarkus Reactive Routes (`a2a-java-sdk-server-quarkus`). You can choose the one that best fits your application.
42+
43+
Add **one** of the following dependencies to your project:
44+
45+
> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
4146
4247
```xml
4348
<dependency>
44-
<groupId>io.a2a.sdk</groupId>
45-
<artifactId>a2a-java-sdk-client</artifactId>
46-
<version>0.2.3</version>
49+
<groupId>io.github.a2asdk</groupId>
50+
<artifactId>a2a-java-sdk-server-jakarta</artifactId>
51+
<!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
52+
<version>${io.a2a.sdk.version}</version>
4753
</dependency>
54+
```
55+
56+
OR
57+
58+
```xml
4859
<dependency>
49-
<groupId>io.a2a.sdk</groupId>
50-
<artifactId>a2a-java-sdk-server-common</artifactId>
51-
<version>0.2.3</version>
60+
<groupId>io.github.a2asdk</groupId>
61+
<artifactId>a2a-java-sdk-server-quarkus</artifactId>
62+
<!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
63+
<version>${io.a2a.sdk.version}</version>
5264
</dependency>
5365
```
5466

@@ -185,39 +197,24 @@ public class WeatherAgentExecutorProducer {
185197
}
186198
```
187199

188-
### 4. Add an A2A Java SDK Server Maven dependency to your project
189-
190-
> **Note**: The A2A Java SDK isn't available yet in Maven Central but will be soon. For now, be
191-
> sure to check out the latest tag (you can see the tags [here](https://github.com/a2aproject/a2a-java/tags)), build from the tag, and reference that version below. For example, if the latest tag is `0.2.3`, you can use the following dependency.
192-
193-
Adding a dependency on an A2A Java SDK Server will allow you to run your agentic Java application as an A2A server.
194-
195-
The A2A Java SDK provides two A2A server endpoint implementations, one based on Jakarta REST (`a2a-java-sdk-server-jakarta`) and one based on Quarkus Reactive Routes (`a2a-java-sdk-server-quarkus`). You can choose the one that best fits your application.
196-
197-
Add **one** of the following dependencies to your project:
200+
## A2A Client
198201

199-
```xml
200-
<dependency>
201-
<groupId>io.a2a.sdk</groupId>
202-
<artifactId>a2a-java-sdk-server-jakarta</artifactId>
203-
<version>${io.a2a.sdk.version}</version>
204-
</dependency>
205-
```
202+
The A2A Java SDK provides a Java client implementation of the [Agent2Agent (A2A) Protocol](https://google-a2a.github.io/A2A), allowing communication with A2A servers.
203+
To make use of the Java `A2AClient`, simply add the following dependency:
206204

207-
OR
205+
----
206+
> *⚠️ The `io.github.a2asdk` `groupId` below is temporary and will likely change for future releases.*
207+
----
208208

209209
```xml
210210
<dependency>
211-
<groupId>io.a2a.sdk</groupId>
212-
<artifactId>a2a-java-sdk-server-quarkus</artifactId>
211+
<groupId>io.github.a2asdk</groupId>
212+
<artifactId>a2a-java-sdk-client</artifactId>
213+
<!-- Use a released version from https://github.com/a2aproject/a2a-java/releases -->
213214
<version>${io.a2a.sdk.version}</version>
214215
</dependency>
215216
```
216217

217-
## A2A Client
218-
219-
The A2A Java SDK provides a Java client implementation of the [Agent2Agent (A2A) Protocol](https://google-a2a.github.io/A2A), allowing communication with A2A servers.
220-
221218
### Sample Usage
222219

223220
#### Create an A2A client

‎client/pom.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<modelVersion>4.0.0</modelVersion>
66

77
<parent>
8-
<groupId>io.a2a.sdk</groupId>
8+
<groupId>io.github.a2asdk</groupId>
99
<artifactId>a2a-java-sdk-parent</artifactId>
10-
<version>0.2.4-SNAPSHOT</version>
10+
<version>0.2.3.Beta2-SNAPSHOT</version>
1111
</parent>
1212
<artifactId>a2a-java-sdk-client</artifactId>
1313

‎common/pom.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<modelVersion>4.0.0</modelVersion>
66

77
<parent>
8-
<groupId>io.a2a.sdk</groupId>
8+
<groupId>io.github.a2asdk</groupId>
99
<artifactId>a2a-java-sdk-parent</artifactId>
10-
<version>0.2.4-SNAPSHOT</version>
10+
<version>0.2.3.Beta2-SNAPSHOT</version>
1111
</parent>
1212
<artifactId>a2a-java-sdk-common</artifactId>
1313

‎examples/helloworld/client/pom.xml‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<modelVersion>4.0.0</modelVersion>
66

77
<parent>
8-
<groupId>io.a2a.sdk</groupId>
8+
<groupId>io.github.a2asdk</groupId>
99
<artifactId>a2a-java-sdk-examples-parent</artifactId>
10-
<version>0.2.4-SNAPSHOT</version>
10+
<version>0.2.3.Beta2-SNAPSHOT</version>
1111
</parent>
1212

1313
<artifactId>a2a-java-sdk-examples-client</artifactId>
@@ -17,7 +17,7 @@
1717

1818
<dependencies>
1919
<dependency>
20-
<groupId>io.a2a.sdk</groupId>
20+
<groupId>io.github.a2asdk</groupId>
2121
<artifactId>a2a-java-sdk-client</artifactId>
2222
</dependency>
2323
</dependencies>
@@ -27,14 +27,12 @@
2727
<plugin>
2828
<groupId>org.apache.maven.plugins</groupId>
2929
<artifactId>maven-compiler-plugin</artifactId>
30-
<version>${maven-compiler-plugin.version}</version>
3130
<configuration>
3231
</configuration>
3332
</plugin>
3433
<plugin>
3534
<groupId>org.apache.maven.plugins</groupId>
3635
<artifactId>maven-surefire-plugin</artifactId>
37-
<version>${maven-surefire-plugin.version}</version>
3836
</plugin>
3937
</plugins>
4038
</build>

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
///usr/bin/env jbang "$0" "$@" ; exit $?
2-
//DEPS io.a2a.sdk:a2a-java-sdk-client:0.2.4-SNAPSHOT
2+
//DEPS io.github.a2asdk:a2a-java-sdk-client:0.2.3.Beta2-SNAPSHOT
33
//SOURCES HelloWorldClient.java
44

55
/**

‎examples/helloworld/pom.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<modelVersion>4.0.0</modelVersion>
66

77
<parent>
8-
<groupId>io.a2a.sdk</groupId>
8+
<groupId>io.github.a2asdk</groupId>
99
<artifactId>a2a-java-sdk-parent</artifactId>
10-
<version>0.2.4-SNAPSHOT</version>
10+
<version>0.2.3.Beta2-SNAPSHOT</version>
1111
<relativePath>../../pom.xml</relativePath>
1212
</parent>
1313

@@ -27,12 +27,12 @@
2727
<scope>import</scope>
2828
</dependency>
2929
<dependency>
30-
<groupId>io.a2a.sdk</groupId>
30+
<groupId>io.github.a2asdk</groupId>
3131
<artifactId>a2a-java-sdk-client</artifactId>
3232
<version>${project.version}</version>
3333
</dependency>
3434
<dependency>
35-
<groupId>io.a2a.sdk</groupId>
35+
<groupId>io.github.a2asdk</groupId>
3636
<artifactId>a2a-java-sdk-server-quarkus</artifactId>
3737
<version>${project.version}</version>
3838
</dependency>

‎examples/helloworld/server/pom.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
<modelVersion>4.0.0</modelVersion>
66

77
<parent>
8-
<groupId>io.a2a.sdk</groupId>
8+
<groupId>io.github.a2asdk</groupId>
99
<artifactId>a2a-java-sdk-examples-parent</artifactId>
10-
<version>0.2.4-SNAPSHOT</version>
10+
<version>0.2.3.Beta2-SNAPSHOT</version>
1111
</parent>
1212

1313
<artifactId>a2a-java-sdk-examples-server</artifactId>
@@ -17,7 +17,7 @@
1717

1818
<dependencies>
1919
<dependency>
20-
<groupId>io.a2a.sdk</groupId>
20+
<groupId>io.github.a2asdk</groupId>
2121
<artifactId>a2a-java-sdk-server-quarkus</artifactId>
2222
</dependency>
2323
<dependency>

0 commit comments

Comments
 (0)