@artinet/sdk 0.5.13 → 0.5.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/README.md +6 -2
  2. package/dist/client/a2a-client.d.ts +10 -0
  3. package/dist/client/a2a-client.js +20 -9
  4. package/dist/server/express/server.d.ts +24 -24
  5. package/dist/services/a2a/factory/builder.d.ts +24 -24
  6. package/dist/services/a2a/helpers/message-builder.d.ts +1 -1
  7. package/dist/services/a2a/helpers/message-builder.js +4 -4
  8. package/dist/services/a2a/methods/get-task.d.ts +47 -47
  9. package/dist/services/a2a/methods/send-message.js +1 -1
  10. package/dist/services/a2a/methods/stream-message.js +1 -1
  11. package/dist/services/a2a/service.d.ts +157 -157
  12. package/dist/services/a2a/state/load.d.ts +1 -1
  13. package/dist/transport/trpc/a2a/factory/router.d.ts +1096 -1096
  14. package/dist/transport/trpc/a2a/routes/info.d.ts +37 -37
  15. package/dist/transport/trpc/a2a/routes/message/route.d.ts +227 -227
  16. package/dist/transport/trpc/a2a/routes/tasks/route.d.ts +260 -260
  17. package/dist/transport/trpc/a2a/trpc.d.ts +120 -120
  18. package/dist/types/interfaces/services/a2a/service.d.ts +1 -1
  19. package/dist/types/schemas/a2a/agent.d.ts +840 -840
  20. package/dist/types/schemas/a2a/agent.js +23 -2
  21. package/dist/types/schemas/a2a/auth.d.ts +197 -197
  22. package/dist/types/schemas/a2a/auth.js +19 -4
  23. package/dist/types/schemas/a2a/error.d.ts +24 -24
  24. package/dist/types/schemas/a2a/message.d.ts +4525 -4525
  25. package/dist/types/schemas/a2a/message.js +10 -2
  26. package/dist/types/schemas/a2a/notification.d.ts +403 -403
  27. package/dist/types/schemas/a2a/notification.js +7 -3
  28. package/dist/types/schemas/a2a/parameters.d.ts +264 -264
  29. package/dist/types/schemas/a2a/parameters.js +14 -1
  30. package/dist/types/schemas/a2a/protocol.d.ts +6042 -6042
  31. package/dist/types/schemas/a2a/rpc.d.ts +20 -20
  32. package/dist/types/schemas/a2a/rpc.js +5 -0
  33. package/dist/types/schemas/a2a/task.d.ts +2536 -2536
  34. package/dist/types/schemas/a2a/task.js +12 -11
  35. package/package.json +2 -2
@@ -2,7 +2,7 @@
2
2
  * Copyright 2025 The Artinet Project
3
3
  * SPDX-License-Identifier: Apache-2.0
4
4
  */
5
- import { A2AServiceInterface, A2AEngine, AgentCard, ContextManagerInterface, ConnectionManagerInterface, CancellationManagerInterface, TaskManagerInterface, MethodOptions, TaskAndHistory, TaskIdParams, MessageSendParams, Command, State, Update, CoreContext, EventManagerOptions, MethodParams } from "../../types/index.js";
5
+ import { A2AServiceInterface, A2AEngine, AgentCard, ContextManagerInterface, ConnectionManagerInterface, CancellationManagerInterface, TaskManagerInterface, MethodOptions, TaskAndHistory, TaskIdParams, MessageSendParams, Command, State, Update, CoreContext, EventManagerOptions, MethodParams, TaskQueryParams } from "../../types/index.js";
6
6
  export declare class A2AService implements A2AServiceInterface {
7
7
  readonly agentCard: AgentCard;
8
8
  private engine;
@@ -22,7 +22,7 @@ export declare class A2AService implements A2AServiceInterface {
22
22
  removeCancellation(id: string): void;
23
23
  getState(id: string): Promise<TaskAndHistory | undefined>;
24
24
  setState(id: string, data: TaskAndHistory): Promise<void>;
25
- getTask(input: TaskIdParams): Promise<{
25
+ getTask(input: TaskQueryParams): Promise<{
26
26
  id: string;
27
27
  status: {
28
28
  state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "submitted" | "working" | "input-required" | "auth-required";
@@ -32,101 +32,101 @@ export declare class A2AService implements A2AServiceInterface {
32
32
  parts: ({
33
33
  file: {
34
34
  bytes: string;
35
- name?: string | undefined;
36
- mimeType?: string | undefined;
37
- uri?: undefined;
35
+ name?: string | null | undefined;
36
+ mimeType?: string | null | undefined;
37
+ uri?: null | undefined;
38
38
  } | {
39
39
  uri: string;
40
- name?: string | undefined;
41
- bytes?: undefined;
42
- mimeType?: string | undefined;
40
+ name?: string | null | undefined;
41
+ bytes?: null | undefined;
42
+ mimeType?: string | null | undefined;
43
43
  };
44
44
  kind: "file";
45
- metadata?: Record<string, unknown> | undefined;
45
+ metadata?: Record<string, unknown> | null | undefined;
46
46
  } | {
47
47
  text: string;
48
48
  kind: "text";
49
- metadata?: Record<string, unknown> | undefined;
49
+ metadata?: Record<string, unknown> | null | undefined;
50
50
  } | {
51
51
  data: Record<string, unknown>;
52
52
  kind: "data";
53
- metadata?: Record<string, unknown> | undefined;
53
+ metadata?: Record<string, unknown> | null | undefined;
54
54
  })[];
55
55
  messageId: string;
56
- metadata?: Record<string, unknown> | undefined;
57
- extensions?: string[] | undefined;
58
- referenceTaskIds?: string[] | undefined;
59
- taskId?: string | undefined;
60
- contextId?: string | undefined;
61
- } | undefined;
62
- timestamp?: string | undefined;
56
+ metadata?: Record<string, unknown> | null | undefined;
57
+ extensions?: string[] | null | undefined;
58
+ referenceTaskIds?: string[] | null | undefined;
59
+ taskId?: string | null | undefined;
60
+ contextId?: string | null | undefined;
61
+ } | null | undefined;
62
+ timestamp?: string | null | undefined;
63
63
  };
64
64
  kind: "task";
65
- metadata?: Record<string, unknown> | undefined;
65
+ contextId: string;
66
+ metadata?: Record<string, unknown> | null | undefined;
66
67
  history?: {
67
68
  role: "user" | "agent";
68
69
  kind: "message";
69
70
  parts: ({
70
71
  file: {
71
72
  bytes: string;
72
- name?: string | undefined;
73
- mimeType?: string | undefined;
74
- uri?: undefined;
73
+ name?: string | null | undefined;
74
+ mimeType?: string | null | undefined;
75
+ uri?: null | undefined;
75
76
  } | {
76
77
  uri: string;
77
- name?: string | undefined;
78
- bytes?: undefined;
79
- mimeType?: string | undefined;
78
+ name?: string | null | undefined;
79
+ bytes?: null | undefined;
80
+ mimeType?: string | null | undefined;
80
81
  };
81
82
  kind: "file";
82
- metadata?: Record<string, unknown> | undefined;
83
+ metadata?: Record<string, unknown> | null | undefined;
83
84
  } | {
84
85
  text: string;
85
86
  kind: "text";
86
- metadata?: Record<string, unknown> | undefined;
87
+ metadata?: Record<string, unknown> | null | undefined;
87
88
  } | {
88
89
  data: Record<string, unknown>;
89
90
  kind: "data";
90
- metadata?: Record<string, unknown> | undefined;
91
+ metadata?: Record<string, unknown> | null | undefined;
91
92
  })[];
92
93
  messageId: string;
93
- metadata?: Record<string, unknown> | undefined;
94
- extensions?: string[] | undefined;
95
- referenceTaskIds?: string[] | undefined;
96
- taskId?: string | undefined;
97
- contextId?: string | undefined;
98
- }[] | undefined;
99
- contextId?: string | undefined;
94
+ metadata?: Record<string, unknown> | null | undefined;
95
+ extensions?: string[] | null | undefined;
96
+ referenceTaskIds?: string[] | null | undefined;
97
+ taskId?: string | null | undefined;
98
+ contextId?: string | null | undefined;
99
+ }[] | null | undefined;
100
100
  artifacts?: {
101
101
  artifactId: string;
102
102
  parts: ({
103
103
  file: {
104
104
  bytes: string;
105
- name?: string | undefined;
106
- mimeType?: string | undefined;
107
- uri?: undefined;
105
+ name?: string | null | undefined;
106
+ mimeType?: string | null | undefined;
107
+ uri?: null | undefined;
108
108
  } | {
109
109
  uri: string;
110
- name?: string | undefined;
111
- bytes?: undefined;
112
- mimeType?: string | undefined;
110
+ name?: string | null | undefined;
111
+ bytes?: null | undefined;
112
+ mimeType?: string | null | undefined;
113
113
  };
114
114
  kind: "file";
115
- metadata?: Record<string, unknown> | undefined;
115
+ metadata?: Record<string, unknown> | null | undefined;
116
116
  } | {
117
117
  text: string;
118
118
  kind: "text";
119
- metadata?: Record<string, unknown> | undefined;
119
+ metadata?: Record<string, unknown> | null | undefined;
120
120
  } | {
121
121
  data: Record<string, unknown>;
122
122
  kind: "data";
123
- metadata?: Record<string, unknown> | undefined;
123
+ metadata?: Record<string, unknown> | null | undefined;
124
124
  })[];
125
- name?: string | undefined;
126
- metadata?: Record<string, unknown> | undefined;
127
- description?: string | undefined;
128
- extension?: string[] | undefined;
129
- }[] | undefined;
125
+ name?: string | null | undefined;
126
+ metadata?: Record<string, unknown> | null | undefined;
127
+ description?: string | null | undefined;
128
+ extension?: string[] | null | undefined;
129
+ }[] | null | undefined;
130
130
  }>;
131
131
  cancelTask(input: TaskIdParams): Promise<{
132
132
  id: string;
@@ -138,101 +138,101 @@ export declare class A2AService implements A2AServiceInterface {
138
138
  parts: ({
139
139
  file: {
140
140
  bytes: string;
141
- name?: string | undefined;
142
- mimeType?: string | undefined;
143
- uri?: undefined;
141
+ name?: string | null | undefined;
142
+ mimeType?: string | null | undefined;
143
+ uri?: null | undefined;
144
144
  } | {
145
145
  uri: string;
146
- name?: string | undefined;
147
- bytes?: undefined;
148
- mimeType?: string | undefined;
146
+ name?: string | null | undefined;
147
+ bytes?: null | undefined;
148
+ mimeType?: string | null | undefined;
149
149
  };
150
150
  kind: "file";
151
- metadata?: Record<string, unknown> | undefined;
151
+ metadata?: Record<string, unknown> | null | undefined;
152
152
  } | {
153
153
  text: string;
154
154
  kind: "text";
155
- metadata?: Record<string, unknown> | undefined;
155
+ metadata?: Record<string, unknown> | null | undefined;
156
156
  } | {
157
157
  data: Record<string, unknown>;
158
158
  kind: "data";
159
- metadata?: Record<string, unknown> | undefined;
159
+ metadata?: Record<string, unknown> | null | undefined;
160
160
  })[];
161
161
  messageId: string;
162
- metadata?: Record<string, unknown> | undefined;
163
- extensions?: string[] | undefined;
164
- referenceTaskIds?: string[] | undefined;
165
- taskId?: string | undefined;
166
- contextId?: string | undefined;
167
- } | undefined;
168
- timestamp?: string | undefined;
162
+ metadata?: Record<string, unknown> | null | undefined;
163
+ extensions?: string[] | null | undefined;
164
+ referenceTaskIds?: string[] | null | undefined;
165
+ taskId?: string | null | undefined;
166
+ contextId?: string | null | undefined;
167
+ } | null | undefined;
168
+ timestamp?: string | null | undefined;
169
169
  };
170
170
  kind: "task";
171
- metadata?: Record<string, unknown> | undefined;
171
+ contextId: string;
172
+ metadata?: Record<string, unknown> | null | undefined;
172
173
  history?: {
173
174
  role: "user" | "agent";
174
175
  kind: "message";
175
176
  parts: ({
176
177
  file: {
177
178
  bytes: string;
178
- name?: string | undefined;
179
- mimeType?: string | undefined;
180
- uri?: undefined;
179
+ name?: string | null | undefined;
180
+ mimeType?: string | null | undefined;
181
+ uri?: null | undefined;
181
182
  } | {
182
183
  uri: string;
183
- name?: string | undefined;
184
- bytes?: undefined;
185
- mimeType?: string | undefined;
184
+ name?: string | null | undefined;
185
+ bytes?: null | undefined;
186
+ mimeType?: string | null | undefined;
186
187
  };
187
188
  kind: "file";
188
- metadata?: Record<string, unknown> | undefined;
189
+ metadata?: Record<string, unknown> | null | undefined;
189
190
  } | {
190
191
  text: string;
191
192
  kind: "text";
192
- metadata?: Record<string, unknown> | undefined;
193
+ metadata?: Record<string, unknown> | null | undefined;
193
194
  } | {
194
195
  data: Record<string, unknown>;
195
196
  kind: "data";
196
- metadata?: Record<string, unknown> | undefined;
197
+ metadata?: Record<string, unknown> | null | undefined;
197
198
  })[];
198
199
  messageId: string;
199
- metadata?: Record<string, unknown> | undefined;
200
- extensions?: string[] | undefined;
201
- referenceTaskIds?: string[] | undefined;
202
- taskId?: string | undefined;
203
- contextId?: string | undefined;
204
- }[] | undefined;
205
- contextId?: string | undefined;
200
+ metadata?: Record<string, unknown> | null | undefined;
201
+ extensions?: string[] | null | undefined;
202
+ referenceTaskIds?: string[] | null | undefined;
203
+ taskId?: string | null | undefined;
204
+ contextId?: string | null | undefined;
205
+ }[] | null | undefined;
206
206
  artifacts?: {
207
207
  artifactId: string;
208
208
  parts: ({
209
209
  file: {
210
210
  bytes: string;
211
- name?: string | undefined;
212
- mimeType?: string | undefined;
213
- uri?: undefined;
211
+ name?: string | null | undefined;
212
+ mimeType?: string | null | undefined;
213
+ uri?: null | undefined;
214
214
  } | {
215
215
  uri: string;
216
- name?: string | undefined;
217
- bytes?: undefined;
218
- mimeType?: string | undefined;
216
+ name?: string | null | undefined;
217
+ bytes?: null | undefined;
218
+ mimeType?: string | null | undefined;
219
219
  };
220
220
  kind: "file";
221
- metadata?: Record<string, unknown> | undefined;
221
+ metadata?: Record<string, unknown> | null | undefined;
222
222
  } | {
223
223
  text: string;
224
224
  kind: "text";
225
- metadata?: Record<string, unknown> | undefined;
225
+ metadata?: Record<string, unknown> | null | undefined;
226
226
  } | {
227
227
  data: Record<string, unknown>;
228
228
  kind: "data";
229
- metadata?: Record<string, unknown> | undefined;
229
+ metadata?: Record<string, unknown> | null | undefined;
230
230
  })[];
231
- name?: string | undefined;
232
- metadata?: Record<string, unknown> | undefined;
233
- description?: string | undefined;
234
- extension?: string[] | undefined;
235
- }[] | undefined;
231
+ name?: string | null | undefined;
232
+ metadata?: Record<string, unknown> | null | undefined;
233
+ description?: string | null | undefined;
234
+ extension?: string[] | null | undefined;
235
+ }[] | null | undefined;
236
236
  }>;
237
237
  sendMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): Promise<{
238
238
  role: "user" | "agent";
@@ -240,32 +240,32 @@ export declare class A2AService implements A2AServiceInterface {
240
240
  parts: ({
241
241
  file: {
242
242
  bytes: string;
243
- name?: string | undefined;
244
- mimeType?: string | undefined;
245
- uri?: undefined;
243
+ name?: string | null | undefined;
244
+ mimeType?: string | null | undefined;
245
+ uri?: null | undefined;
246
246
  } | {
247
247
  uri: string;
248
- name?: string | undefined;
249
- bytes?: undefined;
250
- mimeType?: string | undefined;
248
+ name?: string | null | undefined;
249
+ bytes?: null | undefined;
250
+ mimeType?: string | null | undefined;
251
251
  };
252
252
  kind: "file";
253
- metadata?: Record<string, unknown> | undefined;
253
+ metadata?: Record<string, unknown> | null | undefined;
254
254
  } | {
255
255
  text: string;
256
256
  kind: "text";
257
- metadata?: Record<string, unknown> | undefined;
257
+ metadata?: Record<string, unknown> | null | undefined;
258
258
  } | {
259
259
  data: Record<string, unknown>;
260
260
  kind: "data";
261
- metadata?: Record<string, unknown> | undefined;
261
+ metadata?: Record<string, unknown> | null | undefined;
262
262
  })[];
263
263
  messageId: string;
264
- metadata?: Record<string, unknown> | undefined;
265
- extensions?: string[] | undefined;
266
- referenceTaskIds?: string[] | undefined;
267
- taskId?: string | undefined;
268
- contextId?: string | undefined;
264
+ metadata?: Record<string, unknown> | null | undefined;
265
+ extensions?: string[] | null | undefined;
266
+ referenceTaskIds?: string[] | null | undefined;
267
+ taskId?: string | null | undefined;
268
+ contextId?: string | null | undefined;
269
269
  } | {
270
270
  id: string;
271
271
  status: {
@@ -276,101 +276,101 @@ export declare class A2AService implements A2AServiceInterface {
276
276
  parts: ({
277
277
  file: {
278
278
  bytes: string;
279
- name?: string | undefined;
280
- mimeType?: string | undefined;
281
- uri?: undefined;
279
+ name?: string | null | undefined;
280
+ mimeType?: string | null | undefined;
281
+ uri?: null | undefined;
282
282
  } | {
283
283
  uri: string;
284
- name?: string | undefined;
285
- bytes?: undefined;
286
- mimeType?: string | undefined;
284
+ name?: string | null | undefined;
285
+ bytes?: null | undefined;
286
+ mimeType?: string | null | undefined;
287
287
  };
288
288
  kind: "file";
289
- metadata?: Record<string, unknown> | undefined;
289
+ metadata?: Record<string, unknown> | null | undefined;
290
290
  } | {
291
291
  text: string;
292
292
  kind: "text";
293
- metadata?: Record<string, unknown> | undefined;
293
+ metadata?: Record<string, unknown> | null | undefined;
294
294
  } | {
295
295
  data: Record<string, unknown>;
296
296
  kind: "data";
297
- metadata?: Record<string, unknown> | undefined;
297
+ metadata?: Record<string, unknown> | null | undefined;
298
298
  })[];
299
299
  messageId: string;
300
- metadata?: Record<string, unknown> | undefined;
301
- extensions?: string[] | undefined;
302
- referenceTaskIds?: string[] | undefined;
303
- taskId?: string | undefined;
304
- contextId?: string | undefined;
305
- } | undefined;
306
- timestamp?: string | undefined;
300
+ metadata?: Record<string, unknown> | null | undefined;
301
+ extensions?: string[] | null | undefined;
302
+ referenceTaskIds?: string[] | null | undefined;
303
+ taskId?: string | null | undefined;
304
+ contextId?: string | null | undefined;
305
+ } | null | undefined;
306
+ timestamp?: string | null | undefined;
307
307
  };
308
308
  kind: "task";
309
- metadata?: Record<string, unknown> | undefined;
309
+ contextId: string;
310
+ metadata?: Record<string, unknown> | null | undefined;
310
311
  history?: {
311
312
  role: "user" | "agent";
312
313
  kind: "message";
313
314
  parts: ({
314
315
  file: {
315
316
  bytes: string;
316
- name?: string | undefined;
317
- mimeType?: string | undefined;
318
- uri?: undefined;
317
+ name?: string | null | undefined;
318
+ mimeType?: string | null | undefined;
319
+ uri?: null | undefined;
319
320
  } | {
320
321
  uri: string;
321
- name?: string | undefined;
322
- bytes?: undefined;
323
- mimeType?: string | undefined;
322
+ name?: string | null | undefined;
323
+ bytes?: null | undefined;
324
+ mimeType?: string | null | undefined;
324
325
  };
325
326
  kind: "file";
326
- metadata?: Record<string, unknown> | undefined;
327
+ metadata?: Record<string, unknown> | null | undefined;
327
328
  } | {
328
329
  text: string;
329
330
  kind: "text";
330
- metadata?: Record<string, unknown> | undefined;
331
+ metadata?: Record<string, unknown> | null | undefined;
331
332
  } | {
332
333
  data: Record<string, unknown>;
333
334
  kind: "data";
334
- metadata?: Record<string, unknown> | undefined;
335
+ metadata?: Record<string, unknown> | null | undefined;
335
336
  })[];
336
337
  messageId: string;
337
- metadata?: Record<string, unknown> | undefined;
338
- extensions?: string[] | undefined;
339
- referenceTaskIds?: string[] | undefined;
340
- taskId?: string | undefined;
341
- contextId?: string | undefined;
342
- }[] | undefined;
343
- contextId?: string | undefined;
338
+ metadata?: Record<string, unknown> | null | undefined;
339
+ extensions?: string[] | null | undefined;
340
+ referenceTaskIds?: string[] | null | undefined;
341
+ taskId?: string | null | undefined;
342
+ contextId?: string | null | undefined;
343
+ }[] | null | undefined;
344
344
  artifacts?: {
345
345
  artifactId: string;
346
346
  parts: ({
347
347
  file: {
348
348
  bytes: string;
349
- name?: string | undefined;
350
- mimeType?: string | undefined;
351
- uri?: undefined;
349
+ name?: string | null | undefined;
350
+ mimeType?: string | null | undefined;
351
+ uri?: null | undefined;
352
352
  } | {
353
353
  uri: string;
354
- name?: string | undefined;
355
- bytes?: undefined;
356
- mimeType?: string | undefined;
354
+ name?: string | null | undefined;
355
+ bytes?: null | undefined;
356
+ mimeType?: string | null | undefined;
357
357
  };
358
358
  kind: "file";
359
- metadata?: Record<string, unknown> | undefined;
359
+ metadata?: Record<string, unknown> | null | undefined;
360
360
  } | {
361
361
  text: string;
362
362
  kind: "text";
363
- metadata?: Record<string, unknown> | undefined;
363
+ metadata?: Record<string, unknown> | null | undefined;
364
364
  } | {
365
365
  data: Record<string, unknown>;
366
366
  kind: "data";
367
- metadata?: Record<string, unknown> | undefined;
367
+ metadata?: Record<string, unknown> | null | undefined;
368
368
  })[];
369
- name?: string | undefined;
370
- metadata?: Record<string, unknown> | undefined;
371
- description?: string | undefined;
372
- extension?: string[] | undefined;
373
- }[] | undefined;
369
+ name?: string | null | undefined;
370
+ metadata?: Record<string, unknown> | null | undefined;
371
+ description?: string | null | undefined;
372
+ extension?: string[] | null | undefined;
373
+ }[] | null | undefined;
374
374
  }>;
375
375
  streamMessage(message: MessageSendParams | string, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;
376
376
  resubscribe(input: TaskIdParams, params?: Partial<Omit<MethodParams, "service" | "contextManager">>): AsyncGenerator<import("../../types/index.js").UpdateEvent, void, any>;
@@ -11,4 +11,4 @@ import { Message, TaskAndHistory, TaskStore } from "../../../types/index.js";
11
11
  * @param metadata Optional metadata
12
12
  * @returns The task and history
13
13
  */
14
- export declare function loadState(taskStore: TaskStore, message: Message, metadata?: Record<string, unknown>, taskId?: string, contextId?: string): Promise<TaskAndHistory>;
14
+ export declare function loadState(taskStore: TaskStore, message: Message, metadata?: Record<string, unknown> | null, taskId?: string | null, contextId?: string | null): Promise<TaskAndHistory>;