Repository navigation
Expand file tree
/
Copy pathClient.java
More file actions
234 lines (205 loc) · 10.3 KB
/
Copy pathClient.java
File metadata and controls
234 lines (205 loc) · 10.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
package io.a2a.client;
import static io.a2a.util.Assert.checkNotNullParam;
import java.util.List;
import java.util.Map;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
import io.a2a.client.config.ClientConfig;
import io.a2a.client.transport.spi.ClientTransport;
import io.a2a.client.transport.spi.interceptors.ClientCallContext;
import io.a2a.jsonrpc.common.wrappers.ListTasksResult;
import io.a2a.spec.A2AClientError;
import io.a2a.spec.A2AClientException;
import io.a2a.spec.A2AClientInvalidStateError;
import io.a2a.spec.AgentCard;
import io.a2a.spec.DeleteTaskPushNotificationConfigParams;
import io.a2a.spec.EventKind;
import io.a2a.spec.GetTaskPushNotificationConfigParams;
import io.a2a.spec.ListTaskPushNotificationConfigParams;
import io.a2a.spec.ListTaskPushNotificationConfigResult;
import io.a2a.spec.ListTasksParams;
import io.a2a.spec.Message;
import io.a2a.spec.MessageSendConfiguration;
import io.a2a.spec.MessageSendParams;
import io.a2a.spec.PushNotificationConfig;
import io.a2a.spec.StreamingEventKind;
import io.a2a.spec.Task;
import io.a2a.spec.TaskArtifactUpdateEvent;
import io.a2a.spec.TaskIdParams;
import io.a2a.spec.TaskPushNotificationConfig;
import io.a2a.spec.TaskQueryParams;
import io.a2a.spec.TaskStatusUpdateEvent;
import org.jspecify.annotations.NonNull;
import org.jspecify.annotations.Nullable;
public class Client extends AbstractClient {
private final ClientConfig clientConfig;
private final ClientTransport clientTransport;
private AgentCard agentCard;
Client(AgentCard agentCard, ClientConfig clientConfig, ClientTransport clientTransport,
List<BiConsumer<ClientEvent, AgentCard>> consumers, @Nullable Consumer<Throwable> streamingErrorHandler) {
super(consumers, streamingErrorHandler);
checkNotNullParam("agentCard", agentCard);
this.agentCard = agentCard;
this.clientConfig = clientConfig;
this.clientTransport = clientTransport;
}
public static ClientBuilder builder(AgentCard agentCard) {
return new ClientBuilder(agentCard);
}
@Override
public void sendMessage(@NonNull Message request,
@NonNull List<BiConsumer<ClientEvent, AgentCard>> consumers,
@Nullable Consumer<Throwable> streamingErrorHandler,
@Nullable ClientCallContext context) throws A2AClientException {
MessageSendParams messageSendParams = getMessageSendParams(request, clientConfig);
sendMessage(messageSendParams, consumers, streamingErrorHandler, context);
}
@Override
public void sendMessage(@NonNull Message request,
@Nullable PushNotificationConfig pushNotificationConfiguration,
@Nullable Map<String, Object> metadata,
@Nullable ClientCallContext context) throws A2AClientException {
MessageSendConfiguration messageSendConfiguration = createMessageSendConfiguration(pushNotificationConfiguration);
MessageSendParams messageSendParams = MessageSendParams.builder()
.message(request)
.configuration(messageSendConfiguration)
.metadata(metadata)
.build();
sendMessage(messageSendParams, consumers, streamingErrorHandler, context);
}
@Override
public Task getTask(TaskQueryParams request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.getTask(request, context);
}
@Override
public ListTasksResult listTasks(ListTasksParams request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.listTasks(request, context);
}
@Override
public Task cancelTask(TaskIdParams request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.cancelTask(request, context);
}
@Override
public TaskPushNotificationConfig setTaskPushNotificationConfiguration(
TaskPushNotificationConfig request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.setTaskPushNotificationConfiguration(request, context);
}
@Override
public TaskPushNotificationConfig getTaskPushNotificationConfiguration(
GetTaskPushNotificationConfigParams request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.getTaskPushNotificationConfiguration(request, context);
}
@Override
public ListTaskPushNotificationConfigResult listTaskPushNotificationConfigurations(
ListTaskPushNotificationConfigParams request, @Nullable ClientCallContext context) throws A2AClientException {
return clientTransport.listTaskPushNotificationConfigurations(request, context);
}
@Override
public void deleteTaskPushNotificationConfigurations(
DeleteTaskPushNotificationConfigParams request, @Nullable ClientCallContext context) throws A2AClientException {
clientTransport.deleteTaskPushNotificationConfigurations(request, context);
}
@Override
public void resubscribe(@NonNull TaskIdParams request,
@NonNull List<BiConsumer<ClientEvent, AgentCard>> consumers,
@Nullable Consumer<Throwable> streamingErrorHandler,
@Nullable ClientCallContext context) throws A2AClientException {
if (! clientConfig.isStreaming() || ! agentCard.capabilities().streaming()) {
throw new A2AClientException("Client and/or server does not support resubscription");
}
ClientTaskManager tracker = new ClientTaskManager();
Consumer<Throwable> overriddenErrorHandler = getOverriddenErrorHandler(streamingErrorHandler);
Consumer<StreamingEventKind> eventHandler = event -> {
try {
ClientEvent clientEvent = getClientEvent(event, tracker);
consume(clientEvent, agentCard, consumers);
} catch (A2AClientError e) {
overriddenErrorHandler.accept(e);
}
};
clientTransport.resubscribe(request, eventHandler, overriddenErrorHandler, context);
}
@Override
public AgentCard getAgentCard(@Nullable ClientCallContext context) throws A2AClientException {
agentCard = clientTransport.getAgentCard(context);
return agentCard;
}
@Override
public void close() {
clientTransport.close();
}
private ClientEvent getClientEvent(StreamingEventKind event, ClientTaskManager taskManager) throws A2AClientError {
if (event instanceof Message message) {
return new MessageEvent(message);
} else if (event instanceof Task task) {
taskManager.saveTaskEvent(task);
return new TaskEvent(taskManager.getCurrentTask());
} else if (event instanceof TaskStatusUpdateEvent updateEvent) {
taskManager.saveTaskEvent(updateEvent);
return new TaskUpdateEvent(taskManager.getCurrentTask(), updateEvent);
} else if (event instanceof TaskArtifactUpdateEvent updateEvent) {
taskManager.saveTaskEvent(updateEvent);
return new TaskUpdateEvent(taskManager.getCurrentTask(), updateEvent);
} else {
throw new A2AClientInvalidStateError("Invalid client event");
}
}
private MessageSendConfiguration createMessageSendConfiguration(@Nullable PushNotificationConfig pushNotificationConfig) {
return MessageSendConfiguration.builder()
.acceptedOutputModes(clientConfig.getAcceptedOutputModes())
.blocking(!clientConfig.isPolling())
.historyLength(clientConfig.getHistoryLength())
.pushNotificationConfig(pushNotificationConfig)
.build();
}
private void sendMessage(@NonNull MessageSendParams messageSendParams, @NonNull List<BiConsumer<ClientEvent, AgentCard>> consumers,
@Nullable Consumer<Throwable> errorHandler, @Nullable ClientCallContext context) throws A2AClientException {
if (! clientConfig.isStreaming() || ! agentCard.capabilities().streaming()) {
EventKind eventKind = clientTransport.sendMessage(messageSendParams, context);
ClientEvent clientEvent;
if (eventKind instanceof Task task) {
clientEvent = new TaskEvent(task);
} else {
// must be a message
clientEvent = new MessageEvent((Message) eventKind);
}
consume(clientEvent, agentCard, consumers);
} else {
ClientTaskManager tracker = new ClientTaskManager();
Consumer<Throwable> overriddenErrorHandler = getOverriddenErrorHandler(errorHandler);
Consumer<StreamingEventKind> eventHandler = event -> {
try {
ClientEvent clientEvent = getClientEvent(event, tracker);
consume(clientEvent, agentCard, consumers);
} catch (A2AClientError e) {
overriddenErrorHandler.accept(e);
}
};
clientTransport.sendMessageStreaming(messageSendParams, eventHandler, overriddenErrorHandler, context);
}
}
private @NonNull Consumer<Throwable> getOverriddenErrorHandler(@Nullable Consumer<Throwable> errorHandler) {
return e -> {
if (errorHandler != null) {
errorHandler.accept(e);
} else {
if (getStreamingErrorHandler() != null) {
getStreamingErrorHandler().accept(e);
}
}
};
}
private void consume(ClientEvent clientEvent, AgentCard agentCard, @NonNull List<BiConsumer<ClientEvent, AgentCard>> consumers) {
for (BiConsumer<ClientEvent, AgentCard> consumer : consumers) {
consumer.accept(clientEvent, agentCard);
}
}
private MessageSendParams getMessageSendParams(Message request, ClientConfig clientConfig) {
MessageSendConfiguration messageSendConfiguration = createMessageSendConfiguration(clientConfig.getPushNotificationConfig());
return MessageSendParams.builder()
.message(request)
.configuration(messageSendConfiguration)
.metadata(clientConfig.getMetadata())
.build();
}
}