@aramisfa/openclaw-a2a-outbound 0.1.2 → 0.2.0

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 (48) hide show
  1. package/README.md +261 -16
  2. package/dist/config.d.ts +17 -0
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/config.js +214 -8
  5. package/dist/config.js.map +1 -1
  6. package/dist/constants.d.ts +1 -1
  7. package/dist/constants.d.ts.map +1 -1
  8. package/dist/constants.js +1 -1
  9. package/dist/constants.js.map +1 -1
  10. package/dist/errors.d.ts +4 -0
  11. package/dist/errors.d.ts.map +1 -1
  12. package/dist/errors.js +37 -1
  13. package/dist/errors.js.map +1 -1
  14. package/dist/index.d.ts +1 -1
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +44 -20
  17. package/dist/index.js.map +1 -1
  18. package/dist/request-normalization.d.ts +23 -0
  19. package/dist/request-normalization.d.ts.map +1 -0
  20. package/dist/request-normalization.js +109 -0
  21. package/dist/request-normalization.js.map +1 -0
  22. package/dist/result-shape.d.ts +68 -25
  23. package/dist/result-shape.d.ts.map +1 -1
  24. package/dist/result-shape.js +192 -59
  25. package/dist/result-shape.js.map +1 -1
  26. package/dist/schemas.d.ts +81 -779
  27. package/dist/schemas.d.ts.map +1 -1
  28. package/dist/schemas.js +308 -275
  29. package/dist/schemas.js.map +1 -1
  30. package/dist/sdk-client-pool.d.ts +8 -4
  31. package/dist/sdk-client-pool.d.ts.map +1 -1
  32. package/dist/sdk-client-pool.js +21 -1
  33. package/dist/sdk-client-pool.js.map +1 -1
  34. package/dist/service.d.ts +33 -4
  35. package/dist/service.d.ts.map +1 -1
  36. package/dist/service.js +381 -60
  37. package/dist/service.js.map +1 -1
  38. package/dist/target-catalog.d.ts +66 -0
  39. package/dist/target-catalog.d.ts.map +1 -0
  40. package/dist/target-catalog.js +309 -0
  41. package/dist/target-catalog.js.map +1 -0
  42. package/dist/task-handle-registry.d.ts +29 -0
  43. package/dist/task-handle-registry.d.ts.map +1 -0
  44. package/dist/task-handle-registry.js +141 -0
  45. package/dist/task-handle-registry.js.map +1 -0
  46. package/openclaw.plugin.json +68 -1
  47. package/package.json +2 -1
  48. package/skills/remote-agent/SKILL.md +93 -0
package/dist/schemas.d.ts CHANGED
@@ -1,792 +1,94 @@
1
- import type { Message, MessageSendParams } from "@a2a-js/sdk";
1
+ import type { MessageSendParams } from "@a2a-js/sdk";
2
+ import { type A2AOutboundPluginConfig } from "./config.js";
2
3
  import { type A2ATransport } from "./constants.js";
3
- export declare const DELEGATE_INPUT_SCHEMA: {
4
- type: string;
5
- additionalProperties: boolean;
6
- properties: {
7
- target: {
8
- type: string;
9
- additionalProperties: boolean;
10
- properties: {
11
- baseUrl: {
12
- type: string;
13
- minLength: number;
14
- format: string;
15
- pattern: string;
16
- description: string;
17
- };
18
- cardPath: {
19
- type: string;
20
- minLength: number;
21
- description: string;
22
- };
23
- preferredTransports: {
24
- type: string;
25
- items: {
26
- type: string;
27
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
28
- };
29
- description: string;
30
- };
31
- };
32
- required: string[];
33
- };
34
- request: {
35
- type: string;
36
- additionalProperties: boolean;
37
- properties: {
38
- message: {
39
- description: string;
40
- type: string;
41
- additionalProperties: boolean;
42
- properties: {
43
- kind: {
44
- type: string;
45
- enum: string[];
46
- };
47
- messageId: {
48
- type: string;
49
- minLength: number;
50
- };
51
- role: {
52
- type: string;
53
- enum: readonly ["user", "agent"];
54
- };
55
- parts: {
56
- type: string;
57
- items: {
58
- oneOf: ({
59
- type: string;
60
- additionalProperties: boolean;
61
- properties: {
62
- kind: {
63
- type: string;
64
- enum: string[];
65
- };
66
- text: {
67
- type: string;
68
- };
69
- metadata: {
70
- type: string;
71
- additionalProperties: boolean;
72
- };
73
- };
74
- required: string[];
75
- } | {
76
- type: string;
77
- additionalProperties: boolean;
78
- properties: {
79
- kind: {
80
- type: string;
81
- enum: string[];
82
- };
83
- file: {
84
- type: string;
85
- additionalProperties: boolean;
86
- properties: {
87
- uri: {
88
- type: string;
89
- minLength: number;
90
- };
91
- bytes: {
92
- type: string;
93
- minLength: number;
94
- };
95
- name: {
96
- type: string;
97
- };
98
- mimeType: {
99
- type: string;
100
- };
101
- };
102
- anyOf: {
103
- required: string[];
104
- }[];
105
- };
106
- metadata: {
107
- type: string;
108
- additionalProperties: boolean;
109
- };
110
- };
111
- required: string[];
112
- } | {
113
- type: string;
114
- additionalProperties: boolean;
115
- properties: {
116
- kind: {
117
- type: string;
118
- enum: string[];
119
- };
120
- data: {
121
- type: string;
122
- additionalProperties: boolean;
123
- };
124
- metadata: {
125
- type: string;
126
- additionalProperties: boolean;
127
- };
128
- };
129
- required: string[];
130
- })[];
131
- };
132
- };
133
- contextId: {
134
- type: string;
135
- minLength: number;
136
- };
137
- taskId: {
138
- type: string;
139
- minLength: number;
140
- };
141
- extensions: {
142
- type: string;
143
- items: {
144
- type: string;
145
- };
146
- };
147
- referenceTaskIds: {
148
- type: string;
149
- items: {
150
- type: string;
151
- };
152
- };
153
- metadata: {
154
- type: string;
155
- additionalProperties: boolean;
156
- };
157
- };
158
- required: string[];
159
- };
160
- timeoutMs: {
161
- type: string;
162
- minimum: number;
163
- description: string;
164
- };
165
- serviceParameters: {
166
- type: string;
167
- additionalProperties: {
168
- type: string;
169
- };
170
- description: string;
171
- };
172
- metadata: {
173
- type: string;
174
- additionalProperties: boolean;
175
- description: string;
176
- };
177
- configuration: {
178
- description: string;
179
- type: string;
180
- additionalProperties: boolean;
181
- properties: {
182
- blocking: {
183
- type: string;
184
- description: string;
185
- };
186
- acceptedOutputModes: {
187
- type: string;
188
- items: {
189
- type: string;
190
- };
191
- description: string;
192
- };
193
- historyLength: {
194
- type: string;
195
- minimum: number;
196
- description: string;
197
- };
198
- pushNotificationConfig: {
199
- description: string;
200
- type: string;
201
- additionalProperties: boolean;
202
- properties: {
203
- url: {
204
- type: string;
205
- minLength: number;
206
- description: string;
207
- };
208
- id: {
209
- type: string;
210
- description: string;
211
- };
212
- token: {
213
- type: string;
214
- description: string;
215
- };
216
- authentication: {
217
- description: string;
218
- type: string;
219
- additionalProperties: boolean;
220
- properties: {
221
- schemes: {
222
- type: string;
223
- items: {
224
- type: string;
225
- };
226
- description: string;
227
- };
228
- credentials: {
229
- type: string;
230
- description: string;
231
- };
232
- };
233
- required: string[];
234
- };
235
- };
236
- required: string[];
237
- };
238
- };
239
- };
240
- };
241
- required: string[];
242
- };
243
- };
244
- required: string[];
245
- };
246
- export declare const STATUS_INPUT_SCHEMA: {
247
- type: string;
248
- additionalProperties: boolean;
249
- properties: {
250
- target: {
251
- type: string;
252
- additionalProperties: boolean;
253
- properties: {
254
- baseUrl: {
255
- type: string;
256
- minLength: number;
257
- format: string;
258
- pattern: string;
259
- description: string;
260
- };
261
- cardPath: {
262
- type: string;
263
- minLength: number;
264
- description: string;
265
- };
266
- preferredTransports: {
267
- type: string;
268
- items: {
269
- type: string;
270
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
271
- };
272
- description: string;
273
- };
274
- };
275
- required: string[];
276
- };
277
- request: {
278
- type: string;
279
- additionalProperties: boolean;
280
- properties: {
281
- taskId: {
282
- type: string;
283
- minLength: number;
284
- description: string;
285
- };
286
- historyLength: {
287
- type: string;
288
- minimum: number;
289
- description: string;
290
- };
291
- timeoutMs: {
292
- type: string;
293
- minimum: number;
294
- description: string;
295
- };
296
- serviceParameters: {
297
- type: string;
298
- additionalProperties: {
299
- type: string;
300
- };
301
- description: string;
302
- };
303
- };
304
- required: string[];
305
- };
306
- };
307
- required: string[];
308
- };
309
- export declare const CANCEL_INPUT_SCHEMA: {
310
- type: string;
311
- additionalProperties: boolean;
312
- properties: {
313
- target: {
314
- type: string;
315
- additionalProperties: boolean;
316
- properties: {
317
- baseUrl: {
318
- type: string;
319
- minLength: number;
320
- format: string;
321
- pattern: string;
322
- description: string;
323
- };
324
- cardPath: {
325
- type: string;
326
- minLength: number;
327
- description: string;
328
- };
329
- preferredTransports: {
330
- type: string;
331
- items: {
332
- type: string;
333
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
334
- };
335
- description: string;
336
- };
337
- };
338
- required: string[];
339
- };
340
- request: {
341
- type: string;
342
- additionalProperties: boolean;
343
- properties: {
344
- taskId: {
345
- type: string;
346
- minLength: number;
347
- description: string;
348
- };
349
- timeoutMs: {
350
- type: string;
351
- minimum: number;
352
- description: string;
353
- };
354
- serviceParameters: {
355
- type: string;
356
- additionalProperties: {
357
- type: string;
358
- };
359
- description: string;
360
- };
361
- };
362
- required: string[];
363
- };
364
- };
365
- required: string[];
366
- };
367
- export type ToolDefinition = {
368
- name: string;
369
- label: string;
370
- description: string;
371
- parameters: Record<string, unknown>;
372
- };
373
- export declare const TOOL_DEFINITIONS: {
374
- readonly a2a_delegate: {
375
- readonly name: "a2a_delegate";
376
- readonly label: "A2A Delegate";
377
- readonly description: "Delegate a request to an external A2A agent.";
378
- readonly parameters: {
379
- type: string;
380
- additionalProperties: boolean;
381
- properties: {
382
- target: {
383
- type: string;
384
- additionalProperties: boolean;
385
- properties: {
386
- baseUrl: {
387
- type: string;
388
- minLength: number;
389
- format: string;
390
- pattern: string;
391
- description: string;
392
- };
393
- cardPath: {
394
- type: string;
395
- minLength: number;
396
- description: string;
397
- };
398
- preferredTransports: {
399
- type: string;
400
- items: {
401
- type: string;
402
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
403
- };
404
- description: string;
405
- };
406
- };
407
- required: string[];
408
- };
409
- request: {
410
- type: string;
411
- additionalProperties: boolean;
412
- properties: {
413
- message: {
414
- description: string;
415
- type: string;
416
- additionalProperties: boolean;
417
- properties: {
418
- kind: {
419
- type: string;
420
- enum: string[];
421
- };
422
- messageId: {
423
- type: string;
424
- minLength: number;
425
- };
426
- role: {
427
- type: string;
428
- enum: readonly ["user", "agent"];
429
- };
430
- parts: {
431
- type: string;
432
- items: {
433
- oneOf: ({
434
- type: string;
435
- additionalProperties: boolean;
436
- properties: {
437
- kind: {
438
- type: string;
439
- enum: string[];
440
- };
441
- text: {
442
- type: string;
443
- };
444
- metadata: {
445
- type: string;
446
- additionalProperties: boolean;
447
- };
448
- };
449
- required: string[];
450
- } | {
451
- type: string;
452
- additionalProperties: boolean;
453
- properties: {
454
- kind: {
455
- type: string;
456
- enum: string[];
457
- };
458
- file: {
459
- type: string;
460
- additionalProperties: boolean;
461
- properties: {
462
- uri: {
463
- type: string;
464
- minLength: number;
465
- };
466
- bytes: {
467
- type: string;
468
- minLength: number;
469
- };
470
- name: {
471
- type: string;
472
- };
473
- mimeType: {
474
- type: string;
475
- };
476
- };
477
- anyOf: {
478
- required: string[];
479
- }[];
480
- };
481
- metadata: {
482
- type: string;
483
- additionalProperties: boolean;
484
- };
485
- };
486
- required: string[];
487
- } | {
488
- type: string;
489
- additionalProperties: boolean;
490
- properties: {
491
- kind: {
492
- type: string;
493
- enum: string[];
494
- };
495
- data: {
496
- type: string;
497
- additionalProperties: boolean;
498
- };
499
- metadata: {
500
- type: string;
501
- additionalProperties: boolean;
502
- };
503
- };
504
- required: string[];
505
- })[];
506
- };
507
- };
508
- contextId: {
509
- type: string;
510
- minLength: number;
511
- };
512
- taskId: {
513
- type: string;
514
- minLength: number;
515
- };
516
- extensions: {
517
- type: string;
518
- items: {
519
- type: string;
520
- };
521
- };
522
- referenceTaskIds: {
523
- type: string;
524
- items: {
525
- type: string;
526
- };
527
- };
528
- metadata: {
529
- type: string;
530
- additionalProperties: boolean;
531
- };
532
- };
533
- required: string[];
534
- };
535
- timeoutMs: {
536
- type: string;
537
- minimum: number;
538
- description: string;
539
- };
540
- serviceParameters: {
541
- type: string;
542
- additionalProperties: {
543
- type: string;
544
- };
545
- description: string;
546
- };
547
- metadata: {
548
- type: string;
549
- additionalProperties: boolean;
550
- description: string;
551
- };
552
- configuration: {
553
- description: string;
554
- type: string;
555
- additionalProperties: boolean;
556
- properties: {
557
- blocking: {
558
- type: string;
559
- description: string;
560
- };
561
- acceptedOutputModes: {
562
- type: string;
563
- items: {
564
- type: string;
565
- };
566
- description: string;
567
- };
568
- historyLength: {
569
- type: string;
570
- minimum: number;
571
- description: string;
572
- };
573
- pushNotificationConfig: {
574
- description: string;
575
- type: string;
576
- additionalProperties: boolean;
577
- properties: {
578
- url: {
579
- type: string;
580
- minLength: number;
581
- description: string;
582
- };
583
- id: {
584
- type: string;
585
- description: string;
586
- };
587
- token: {
588
- type: string;
589
- description: string;
590
- };
591
- authentication: {
592
- description: string;
593
- type: string;
594
- additionalProperties: boolean;
595
- properties: {
596
- schemes: {
597
- type: string;
598
- items: {
599
- type: string;
600
- };
601
- description: string;
602
- };
603
- credentials: {
604
- type: string;
605
- description: string;
606
- };
607
- };
608
- required: string[];
609
- };
610
- };
611
- required: string[];
612
- };
613
- };
614
- };
615
- };
616
- required: string[];
617
- };
618
- };
619
- required: string[];
620
- };
621
- };
622
- readonly a2a_task_status: {
623
- readonly name: "a2a_task_status";
624
- readonly label: "A2A Task Status";
625
- readonly description: "Fetch status for an external A2A task.";
626
- readonly parameters: {
627
- type: string;
628
- additionalProperties: boolean;
629
- properties: {
630
- target: {
631
- type: string;
632
- additionalProperties: boolean;
633
- properties: {
634
- baseUrl: {
635
- type: string;
636
- minLength: number;
637
- format: string;
638
- pattern: string;
639
- description: string;
640
- };
641
- cardPath: {
642
- type: string;
643
- minLength: number;
644
- description: string;
645
- };
646
- preferredTransports: {
647
- type: string;
648
- items: {
649
- type: string;
650
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
651
- };
652
- description: string;
653
- };
654
- };
655
- required: string[];
656
- };
657
- request: {
658
- type: string;
659
- additionalProperties: boolean;
660
- properties: {
661
- taskId: {
662
- type: string;
663
- minLength: number;
664
- description: string;
665
- };
666
- historyLength: {
667
- type: string;
668
- minimum: number;
669
- description: string;
670
- };
671
- timeoutMs: {
672
- type: string;
673
- minimum: number;
674
- description: string;
675
- };
676
- serviceParameters: {
677
- type: string;
678
- additionalProperties: {
679
- type: string;
680
- };
681
- description: string;
682
- };
683
- };
684
- required: string[];
685
- };
686
- };
687
- required: string[];
688
- };
689
- };
690
- readonly a2a_task_cancel: {
691
- readonly name: "a2a_task_cancel";
692
- readonly label: "A2A Task Cancel";
693
- readonly description: "Request cancellation for an external A2A task.";
694
- readonly parameters: {
695
- type: string;
696
- additionalProperties: boolean;
697
- properties: {
698
- target: {
699
- type: string;
700
- additionalProperties: boolean;
701
- properties: {
702
- baseUrl: {
703
- type: string;
704
- minLength: number;
705
- format: string;
706
- pattern: string;
707
- description: string;
708
- };
709
- cardPath: {
710
- type: string;
711
- minLength: number;
712
- description: string;
713
- };
714
- preferredTransports: {
715
- type: string;
716
- items: {
717
- type: string;
718
- enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
719
- };
720
- description: string;
721
- };
722
- };
723
- required: string[];
724
- };
725
- request: {
726
- type: string;
727
- additionalProperties: boolean;
728
- properties: {
729
- taskId: {
730
- type: string;
731
- minLength: number;
732
- description: string;
733
- };
734
- timeoutMs: {
735
- type: string;
736
- minimum: number;
737
- description: string;
738
- };
739
- serviceParameters: {
740
- type: string;
741
- additionalProperties: {
742
- type: string;
743
- };
744
- description: string;
745
- };
746
- };
747
- required: string[];
748
- };
749
- };
750
- required: string[];
751
- };
752
- };
753
- };
4
+ export declare const REMOTE_AGENT_TOOL_NAME = "remote_agent";
5
+ export declare const REMOTE_AGENT_ACTIONS: readonly ["list_targets", "send", "watch", "status", "cancel"];
6
+ export type RemoteAgentAction = (typeof REMOTE_AGENT_ACTIONS)[number];
754
7
  export interface A2ATargetInput {
755
8
  baseUrl: string;
756
9
  cardPath?: string;
757
10
  preferredTransports?: A2ATransport[];
758
11
  }
759
- export interface DelegateRequestInput {
760
- message: Message;
761
- timeoutMs?: number;
762
- serviceParameters?: Record<string, string>;
763
- metadata?: MessageSendParams["metadata"];
764
- configuration?: MessageSendParams["configuration"];
12
+ export interface RemoteAgentFileAttachmentInput {
13
+ kind: "file";
14
+ uri?: string;
15
+ bytes?: string;
16
+ name?: string;
17
+ mime_type?: string;
18
+ metadata?: Record<string, unknown>;
19
+ }
20
+ export interface RemoteAgentDataAttachmentInput {
21
+ kind: "data";
22
+ data: Record<string, unknown>;
23
+ metadata?: Record<string, unknown>;
24
+ }
25
+ export type RemoteAgentAttachmentInput = RemoteAgentFileAttachmentInput | RemoteAgentDataAttachmentInput;
26
+ interface RemoteAgentBaseInput {
27
+ target_alias?: string;
28
+ target_url?: string;
29
+ task_handle?: string;
30
+ task_id?: string;
31
+ timeout_ms?: number;
32
+ service_parameters?: Record<string, string>;
765
33
  }
766
- export interface StatusRequestInput {
767
- taskId: string;
768
- historyLength?: number;
769
- timeoutMs?: number;
770
- serviceParameters?: Record<string, string>;
34
+ export interface ListTargetsActionInput {
35
+ action: "list_targets";
771
36
  }
772
- export interface CancelRequestInput {
773
- taskId: string;
774
- timeoutMs?: number;
775
- serviceParameters?: Record<string, string>;
37
+ export interface SendActionInput extends RemoteAgentBaseInput {
38
+ action: "send";
39
+ input: string;
40
+ attachments?: RemoteAgentAttachmentInput[];
41
+ follow_updates?: boolean;
42
+ history_length?: number;
43
+ metadata?: MessageSendParams["metadata"];
44
+ }
45
+ export interface WatchActionInput extends RemoteAgentBaseInput {
46
+ action: "watch";
776
47
  }
777
- export interface DelegateToolInput {
778
- target: A2ATargetInput;
779
- request: DelegateRequestInput;
48
+ export interface StatusActionInput extends RemoteAgentBaseInput {
49
+ action: "status";
50
+ history_length?: number;
780
51
  }
781
- export interface StatusToolInput {
782
- target: A2ATargetInput;
783
- request: StatusRequestInput;
52
+ export interface CancelActionInput extends RemoteAgentBaseInput {
53
+ action: "cancel";
784
54
  }
785
- export interface CancelToolInput {
786
- target: A2ATargetInput;
787
- request: CancelRequestInput;
55
+ export type RemoteAgentToolInput = ListTargetsActionInput | SendActionInput | WatchActionInput | StatusActionInput | CancelActionInput;
56
+ export interface ToolDefinition {
57
+ name: string;
58
+ label: string;
59
+ description: string;
60
+ parameters: Record<string, unknown>;
788
61
  }
789
- export declare function validateDelegateInput(input: unknown): DelegateToolInput;
790
- export declare function validateStatusInput(input: unknown): StatusToolInput;
791
- export declare function validateCancelInput(input: unknown): CancelToolInput;
62
+ export declare function buildRemoteAgentParametersSchema(config: A2AOutboundPluginConfig): Record<string, unknown>;
63
+ export declare function buildRemoteAgentToolDefinition(config: A2AOutboundPluginConfig): ToolDefinition;
64
+ export type RemoteAgentInputValidator = (input: unknown) => RemoteAgentToolInput;
65
+ export declare function createRemoteAgentInputValidator(config: A2AOutboundPluginConfig): RemoteAgentInputValidator;
66
+ export declare const PUBLIC_TARGET_SCHEMA: {
67
+ readonly type: "object";
68
+ readonly additionalProperties: false;
69
+ readonly properties: {
70
+ readonly baseUrl: {
71
+ readonly type: "string";
72
+ readonly minLength: 1;
73
+ readonly format: "uri";
74
+ readonly pattern: "^https?://";
75
+ readonly description: "Target agent base URL.";
76
+ };
77
+ readonly cardPath: {
78
+ readonly type: "string";
79
+ readonly minLength: 1;
80
+ readonly description: "Optional override for the target agent-card path. Defaults from plugin config when omitted.";
81
+ };
82
+ readonly preferredTransports: {
83
+ readonly type: "array";
84
+ readonly items: {
85
+ readonly type: "string";
86
+ readonly enum: readonly ["JSONRPC", "HTTP+JSON", "GRPC"];
87
+ };
88
+ readonly description: "Optional transport preference override for this call. Defaults from plugin config when omitted.";
89
+ };
90
+ };
91
+ readonly required: readonly ["baseUrl"];
92
+ };
93
+ export {};
792
94
  //# sourceMappingURL=schemas.d.ts.map