@alis-build/alis-open-agent-v2 2.16.0 → 2.17.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.
@@ -1,7 +1,31 @@
1
- // @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js,json_types=true"
1
+ // @generated by protoc-gen-es v2.16.0 with parameter "target=js+dts,import_extension=js,json_types=true"
2
2
  // @generated from file alis/open/agent/v2/a2a.proto (package alis.open.agent.v2, syntax proto3)
3
3
  /* eslint-disable */
4
4
 
5
+ // A gRPC binding of the Agent2Agent (A2A) protocol for sending messages to
6
+ // an agent and tracking the tasks it performs, shaped to follow AIP-127
7
+ // where appropriate.
8
+ //
9
+ // `A2AService` works with four nouns:
10
+ //
11
+ // - Messages: sent with `SendMessage` or `SendStreamingMessage`. They are
12
+ // not stored resources.
13
+ // - `Task` (`tasks/{task_id}`): the unit of work, with a status, output
14
+ // artifacts, and message history. Read with `GetTask` and `ListTasks`,
15
+ // cancelled with `CancelTask`, and streamed with `TaskSubscription`.
16
+ // - `TaskPushNotificationConfig`
17
+ // (`tasks/{task_id}/pushNotificationConfigs/{config_id}`): a webhook that
18
+ // the agent notifies of updates to one task.
19
+ // - `AgentCard`: the agent's self-description (skills, capabilities,
20
+ // security requirements), read with `GetAgentCard`.
21
+ //
22
+ // This package defines the same service and messages as
23
+ // `alis.open.agent.v1` with two differences: `Task` has no `name` field
24
+ // (requests still address a task as `tasks/{task_id}`), and `Part` cannot
25
+ // carry an arbitrary `google.protobuf.Any` message. The
26
+ // `alis.a2a.extension` packages build on the vendored `lf.a2a.v1` contract
27
+ // rather than on this package.
28
+
5
29
  import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
6
30
  import type { JsonObject, Message as Message$1 } from "@bufbuild/protobuf";
7
31
  import type { EmptySchema, StructJson, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
@@ -12,50 +36,78 @@ import type { EmptySchema, StructJson, Timestamp, TimestampJson } from "@bufbuil
12
36
  export declare const file_alis_open_agent_v2_a2a: GenFile;
13
37
 
14
38
  /**
39
+ * Configuration of a send message request.
40
+ *
15
41
  * @generated from message alis.open.agent.v2.SendMessageConfiguration
16
42
  */
17
43
  export declare type SendMessageConfiguration = Message$1<"alis.open.agent.v2.SendMessageConfiguration"> & {
18
44
  /**
45
+ * The output modes that the agent is expected to respond with.
46
+ *
19
47
  * @generated from field: repeated string accepted_output_modes = 1;
20
48
  */
21
49
  acceptedOutputModes: string[];
22
50
 
23
51
  /**
52
+ * A configuration of a webhook that can be used to receive updates
53
+ *
24
54
  * @generated from field: alis.open.agent.v2.PushNotificationConfig push_notification = 2;
25
55
  */
26
56
  pushNotification?: PushNotificationConfig | undefined;
27
57
 
28
58
  /**
59
+ * The maximum number of messages to include in the history. if 0, the
60
+ * history will be unlimited.
61
+ *
29
62
  * @generated from field: int32 history_length = 3;
30
63
  */
31
64
  historyLength: number;
32
65
 
33
66
  /**
67
+ * If true, the message will be blocking until the task is completed. If
68
+ * false, the message will be non-blocking and the task will be returned
69
+ * immediately. It is the caller's responsibility to check for any task
70
+ * updates.
71
+ *
34
72
  * @generated from field: bool blocking = 4;
35
73
  */
36
74
  blocking: boolean;
37
75
  };
38
76
 
39
77
  /**
78
+ * Configuration of a send message request.
79
+ *
40
80
  * @generated from message alis.open.agent.v2.SendMessageConfiguration
41
81
  */
42
82
  export declare type SendMessageConfigurationJson = {
43
83
  /**
84
+ * The output modes that the agent is expected to respond with.
85
+ *
44
86
  * @generated from field: repeated string accepted_output_modes = 1;
45
87
  */
46
88
  acceptedOutputModes?: string[];
47
89
 
48
90
  /**
91
+ * A configuration of a webhook that can be used to receive updates
92
+ *
49
93
  * @generated from field: alis.open.agent.v2.PushNotificationConfig push_notification = 2;
50
94
  */
51
95
  pushNotification?: PushNotificationConfigJson;
52
96
 
53
97
  /**
98
+ * The maximum number of messages to include in the history. if 0, the
99
+ * history will be unlimited.
100
+ *
54
101
  * @generated from field: int32 history_length = 3;
55
102
  */
56
103
  historyLength?: number;
57
104
 
58
105
  /**
106
+ * If true, the message will be blocking until the task is completed. If
107
+ * false, the message will be non-blocking and the task will be returned
108
+ * immediately. It is the caller's responsibility to check for any task
109
+ * updates.
110
+ *
59
111
  * @generated from field: bool blocking = 4;
60
112
  */
61
113
  blocking?: boolean;
@@ -68,70 +120,116 @@ export declare type SendMessageConfigurationJson = {
68
120
  export declare const SendMessageConfigurationSchema: GenMessage<SendMessageConfiguration, {jsonType: SendMessageConfigurationJson}>;
69
121
 
70
122
  /**
123
+ * Task is the core unit of action for A2A. It has a current status
124
+ * and when results are created for the task they are stored in the
125
+ * artifact. If there are multiple turns for a task, these are stored in
126
+ * history.
127
+ *
71
128
  * @generated from message alis.open.agent.v2.Task
72
129
  */
73
130
  export declare type Task = Message$1<"alis.open.agent.v2.Task"> & {
74
131
  /**
132
+ * Unique identifier (e.g. UUID) for the task, generated by the server for a
133
+ * new task.
134
+ *
75
135
  * @generated from field: string id = 1;
76
136
  */
77
137
  id: string;
78
138
 
79
139
  /**
140
+ * Unique identifier (e.g. UUID) for the contextual collection of interactions
141
+ * (tasks and messages). Created by the A2A server.
142
+ *
80
143
  * @generated from field: string context_id = 2;
81
144
  */
82
145
  contextId: string;
83
146
 
84
147
  /**
148
+ * The current status of a Task, including state and a message.
149
+ *
85
150
  * @generated from field: alis.open.agent.v2.TaskStatus status = 3;
86
151
  */
87
152
  status?: TaskStatus | undefined;
88
153
 
89
154
  /**
155
+ * A set of output artifacts for a Task.
156
+ *
157
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
158
+ *
90
159
  * @generated from field: repeated alis.open.agent.v2.Artifact artifacts = 4;
91
160
  */
92
161
  artifacts: Artifact[];
93
162
 
94
163
  /**
164
+ * The history of interactions from a task.
165
+ *
166
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
167
+ *
95
168
  * @generated from field: repeated alis.open.agent.v2.Message history = 5;
96
169
  */
97
170
  history: Message[];
98
171
 
99
172
  /**
173
+ * A key/value object to store custom metadata about a task.
174
+ *
100
175
  * @generated from field: google.protobuf.Struct metadata = 6;
101
176
  */
102
177
  metadata?: JsonObject | undefined;
103
178
  };
104
179
 
105
180
  /**
181
+ * Task is the core unit of action for A2A. It has a current status
182
+ * and when results are created for the task they are stored in the
183
+ * artifact. If there are multiple turns for a task, these are stored in
184
+ * history.
185
+ *
106
186
  * @generated from message alis.open.agent.v2.Task
107
187
  */
108
188
  export declare type TaskJson = {
109
189
  /**
190
+ * Unique identifier (e.g. UUID) for the task, generated by the server for a
191
+ * new task.
192
+ *
110
193
  * @generated from field: string id = 1;
111
194
  */
112
195
  id?: string;
113
196
 
114
197
  /**
198
+ * Unique identifier (e.g. UUID) for the contextual collection of interactions
199
+ * (tasks and messages). Created by the A2A server.
200
+ *
115
201
  * @generated from field: string context_id = 2;
116
202
  */
117
203
  contextId?: string;
118
204
 
119
205
  /**
206
+ * The current status of a Task, including state and a message.
207
+ *
120
208
  * @generated from field: alis.open.agent.v2.TaskStatus status = 3;
121
209
  */
122
210
  status?: TaskStatusJson;
123
211
 
124
212
  /**
213
+ * A set of output artifacts for a Task.
214
+ *
215
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
216
+ *
125
217
  * @generated from field: repeated alis.open.agent.v2.Artifact artifacts = 4;
126
218
  */
127
219
  artifacts?: ArtifactJson[];
128
220
 
129
221
  /**
222
+ * The history of interactions from a task.
223
+ *
224
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
225
+ *
130
226
  * @generated from field: repeated alis.open.agent.v2.Message history = 5;
131
227
  */
132
228
  history?: MessageJson[];
133
229
 
134
230
  /**
231
+ * A key/value object to store custom metadata about a task.
232
+ *
135
233
  * @generated from field: google.protobuf.Struct metadata = 6;
136
234
  */
137
235
  metadata?: StructJson;
@@ -144,40 +242,58 @@ export declare type TaskJson = {
144
242
  export declare const TaskSchema: GenMessage<Task, {jsonType: TaskJson}>;
145
243
 
146
244
  /**
245
+ * A container for the status of a task
246
+ *
147
247
  * @generated from message alis.open.agent.v2.TaskStatus
148
248
  */
149
249
  export declare type TaskStatus = Message$1<"alis.open.agent.v2.TaskStatus"> & {
150
250
  /**
251
+ * The current state of this task
252
+ *
151
253
  * @generated from field: alis.open.agent.v2.TaskState state = 1;
152
254
  */
153
255
  state: TaskState;
154
256
 
155
257
  /**
258
+ * A message associated with the status.
259
+ *
156
260
  * @generated from field: alis.open.agent.v2.Message update = 2 [json_name = "message"];
157
261
  */
158
262
  update?: Message | undefined;
159
263
 
160
264
  /**
265
+ * Timestamp when the status was recorded.
266
+ * Example: "2023-10-27T10:00:00Z"
267
+ *
161
268
  * @generated from field: google.protobuf.Timestamp timestamp = 3;
162
269
  */
163
270
  timestamp?: Timestamp | undefined;
164
271
  };
165
272
 
166
273
  /**
274
+ * A container for the status of a task
275
+ *
167
276
  * @generated from message alis.open.agent.v2.TaskStatus
168
277
  */
169
278
  export declare type TaskStatusJson = {
170
279
  /**
280
+ * The current state of this task
281
+ *
171
282
  * @generated from field: alis.open.agent.v2.TaskState state = 1;
172
283
  */
173
284
  state?: TaskStateJson;
174
285
 
175
286
  /**
287
+ * A message associated with the status.
288
+ *
176
289
  * @generated from field: alis.open.agent.v2.Message update = 2 [json_name = "message"];
177
290
  */
178
291
  message?: MessageJson;
179
292
 
180
293
  /**
294
+ * Timestamp when the status was recorded.
295
+ * Example: "2023-10-27T10:00:00Z"
296
+ *
181
297
  * @generated from field: google.protobuf.Timestamp timestamp = 3;
182
298
  */
183
299
  timestamp?: TimestampJson;
@@ -190,26 +306,38 @@ export declare type TaskStatusJson = {
190
306
  export declare const TaskStatusSchema: GenMessage<TaskStatus, {jsonType: TaskStatusJson}>;
191
307
 
192
308
  /**
309
+ * Part represents a container for a section of communication content.
310
+ * Parts can be purely textual, some sort of file (image, video, etc) or
311
+ * a structured data blob (i.e. JSON).
312
+ *
193
313
  * @generated from message alis.open.agent.v2.Part
194
314
  */
195
315
  export declare type Part = Message$1<"alis.open.agent.v2.Part"> & {
196
316
  /**
317
+ * The content carried by this part.
318
+ *
197
319
  * @generated from oneof alis.open.agent.v2.Part.part
198
320
  */
199
321
  part: {
200
322
  /**
323
+ * Plain text content.
324
+ *
201
325
  * @generated from field: string text = 1;
202
326
  */
203
327
  value: string;
204
328
  case: "text";
205
329
  } | {
206
330
  /**
331
+ * A file, provided by URI or as inline bytes.
332
+ *
207
333
  * @generated from field: alis.open.agent.v2.FilePart file = 2;
208
334
  */
209
335
  value: FilePart;
210
336
  case: "file";
211
337
  } | {
212
338
  /**
339
+ * Structured data, such as a JSON object.
340
+ *
213
341
  * @generated from field: alis.open.agent.v2.DataPart data = 3;
214
342
  */
215
343
  value: DataPart;
@@ -217,31 +345,45 @@ export declare type Part = Message$1<"alis.open.agent.v2.Part"> & {
217
345
  } | { case: undefined; value?: undefined };
218
346
 
219
347
  /**
348
+ * Optional metadata associated with this part.
349
+ *
220
350
  * @generated from field: google.protobuf.Struct metadata = 4;
221
351
  */
222
352
  metadata?: JsonObject | undefined;
223
353
  };
224
354
 
225
355
  /**
356
+ * Part represents a container for a section of communication content.
357
+ * Parts can be purely textual, some sort of file (image, video, etc) or
358
+ * a structured data blob (i.e. JSON).
359
+ *
226
360
  * @generated from message alis.open.agent.v2.Part
227
361
  */
228
362
  export declare type PartJson = {
229
363
  /**
364
+ * Plain text content.
365
+ *
230
366
  * @generated from field: string text = 1;
231
367
  */
232
368
  text?: string;
233
369
 
234
370
  /**
371
+ * A file, provided by URI or as inline bytes.
372
+ *
235
373
  * @generated from field: alis.open.agent.v2.FilePart file = 2;
236
374
  */
237
375
  file?: FilePartJson;
238
376
 
239
377
  /**
378
+ * Structured data, such as a JSON object.
379
+ *
240
380
  * @generated from field: alis.open.agent.v2.DataPart data = 3;
241
381
  */
242
382
  data?: DataPartJson;
243
383
 
244
384
  /**
385
+ * Optional metadata associated with this part.
386
+ *
245
387
  * @generated from field: google.protobuf.Struct metadata = 4;
246
388
  */
247
389
  metadata?: StructJson;
@@ -254,20 +396,33 @@ export declare type PartJson = {
254
396
  export declare const PartSchema: GenMessage<Part, {jsonType: PartJson}>;
255
397
 
256
398
  /**
399
+ * FilePart represents the different ways files can be provided. If files are
400
+ * small, directly feeding the bytes is supported via file_with_bytes. If the
401
+ * file is large, the agent should read the content as appropriate directly
402
+ * from the file_with_uri source.
403
+ *
257
404
  * @generated from message alis.open.agent.v2.FilePart
258
405
  */
259
406
  export declare type FilePart = Message$1<"alis.open.agent.v2.FilePart"> & {
260
407
  /**
408
+ * The file content, referenced by URI or included inline.
409
+ *
261
410
  * @generated from oneof alis.open.agent.v2.FilePart.file
262
411
  */
263
412
  file: {
264
413
  /**
414
+ * A URI from which the agent can read the file content. Suited to large
415
+ * files.
416
+ *
265
417
  * @generated from field: string file_with_uri = 1;
266
418
  */
267
419
  value: string;
268
420
  case: "fileWithUri";
269
421
  } | {
270
422
  /**
423
+ * The file content as raw bytes. Suited to small files. In JSON this is
424
+ * encoded as a base64 string.
425
+ *
271
426
  * @generated from field: bytes file_with_bytes = 2;
272
427
  */
273
428
  value: Uint8Array;
@@ -275,36 +430,55 @@ export declare type FilePart = Message$1<"alis.open.agent.v2.FilePart"> & {
275
430
  } | { case: undefined; value?: undefined };
276
431
 
277
432
  /**
433
+ * The MIME type of the file, for example `image/png`.
434
+ *
278
435
  * @generated from field: string mime_type = 3;
279
436
  */
280
437
  mimeType: string;
281
438
 
282
439
  /**
440
+ * An optional name for the file, for example `document.pdf`.
441
+ *
283
442
  * @generated from field: string name = 4;
284
443
  */
285
444
  name: string;
286
445
  };
287
446
 
288
447
  /**
448
+ * FilePart represents the different ways files can be provided. If files are
449
+ * small, directly feeding the bytes is supported via file_with_bytes. If the
450
+ * file is large, the agent should read the content as appropriate directly
451
+ * from the file_with_uri source.
452
+ *
289
453
  * @generated from message alis.open.agent.v2.FilePart
290
454
  */
291
455
  export declare type FilePartJson = {
292
456
  /**
457
+ * A URI from which the agent can read the file content. Suited to large
458
+ * files.
459
+ *
293
460
  * @generated from field: string file_with_uri = 1;
294
461
  */
295
462
  fileWithUri?: string;
296
463
 
297
464
  /**
465
+ * The file content as raw bytes. Suited to small files. In JSON this is
466
+ * encoded as a base64 string.
467
+ *
298
468
  * @generated from field: bytes file_with_bytes = 2;
299
469
  */
300
470
  fileWithBytes?: string;
301
471
 
302
472
  /**
473
+ * The MIME type of the file, for example `image/png`.
474
+ *
303
475
  * @generated from field: string mime_type = 3;
304
476
  */
305
477
  mimeType?: string;
306
478
 
307
479
  /**
480
+ * An optional name for the file, for example `document.pdf`.
481
+ *
308
482
  * @generated from field: string name = 4;
309
483
  */
310
484
  name?: string;
@@ -317,20 +491,28 @@ export declare type FilePartJson = {
317
491
  export declare const FilePartSchema: GenMessage<FilePart, {jsonType: FilePartJson}>;
318
492
 
319
493
  /**
494
+ * DataPart represents a structured blob. This is most commonly a JSON payload.
495
+ *
320
496
  * @generated from message alis.open.agent.v2.DataPart
321
497
  */
322
498
  export declare type DataPart = Message$1<"alis.open.agent.v2.DataPart"> & {
323
499
  /**
500
+ * The structured data, as a JSON object.
501
+ *
324
502
  * @generated from field: google.protobuf.Struct data = 1;
325
503
  */
326
504
  data?: JsonObject | undefined;
327
505
  };
328
506
 
329
507
  /**
508
+ * DataPart represents a structured blob. This is most commonly a JSON payload.
509
+ *
330
510
  * @generated from message alis.open.agent.v2.DataPart
331
511
  */
332
512
  export declare type DataPartJson = {
333
513
  /**
514
+ * The structured data, as a JSON object.
515
+ *
334
516
  * @generated from field: google.protobuf.Struct data = 1;
335
517
  */
336
518
  data?: StructJson;
@@ -343,90 +525,152 @@ export declare type DataPartJson = {
343
525
  export declare const DataPartSchema: GenMessage<DataPart, {jsonType: DataPartJson}>;
344
526
 
345
527
  /**
528
+ * Message is one unit of communication between client and server. It is
529
+ * associated with a context and optionally a task. Since the server is
530
+ * responsible for the context definition, it must always provide a context_id
531
+ * in its messages. The client can optionally provide the context_id if it
532
+ * knows the context to associate the message to. Similarly for task_id,
533
+ * except the server decides if a task is created and whether to include the
534
+ * task_id.
535
+ *
346
536
  * @generated from message alis.open.agent.v2.Message
347
537
  */
348
538
  export declare type Message = Message$1<"alis.open.agent.v2.Message"> & {
349
539
  /**
540
+ * The unique identifier (e.g. UUID)of the message. This is required and
541
+ * created by the message creator.
542
+ *
350
543
  * @generated from field: string message_id = 1;
351
544
  */
352
545
  messageId: string;
353
546
 
354
547
  /**
548
+ * The context id of the message. This is optional and if set, the message
549
+ * will be associated with the given context.
550
+ *
355
551
  * @generated from field: string context_id = 2;
356
552
  */
357
553
  contextId: string;
358
554
 
359
555
  /**
556
+ * The task id of the message. This is optional and if set, the message
557
+ * will be associated with the given task.
558
+ *
360
559
  * @generated from field: string task_id = 3;
361
560
  */
362
561
  taskId: string;
363
562
 
364
563
  /**
564
+ * A role for the message.
565
+ *
566
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
567
+ *
365
568
  * @generated from field: alis.open.agent.v2.Role role = 4;
366
569
  */
367
570
  role: Role;
368
571
 
369
572
  /**
573
+ * Parts is the container of the message content.
574
+ *
575
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
576
+ *
370
577
  * @generated from field: repeated alis.open.agent.v2.Part parts = 5;
371
578
  */
372
579
  parts: Part[];
373
580
 
374
581
  /**
582
+ * Any optional metadata to provide along with the message.
583
+ *
375
584
  * @generated from field: google.protobuf.Struct metadata = 6;
376
585
  */
377
586
  metadata?: JsonObject | undefined;
378
587
 
379
588
  /**
589
+ * The URIs of extensions that are present or contributed to this Message.
590
+ *
380
591
  * @generated from field: repeated string extensions = 7;
381
592
  */
382
593
  extensions: string[];
383
594
 
384
595
  /**
596
+ * A list of task IDs that this message references for additional context.
597
+ *
385
598
  * @generated from field: repeated string reference_task_ids = 8;
386
599
  */
387
600
  referenceTaskIds: string[];
388
601
  };
389
602
 
390
603
  /**
604
+ * Message is one unit of communication between client and server. It is
605
+ * associated with a context and optionally a task. Since the server is
606
+ * responsible for the context definition, it must always provide a context_id
607
+ * in its messages. The client can optionally provide the context_id if it
608
+ * knows the context to associate the message to. Similarly for task_id,
609
+ * except the server decides if a task is created and whether to include the
610
+ * task_id.
611
+ *
391
612
  * @generated from message alis.open.agent.v2.Message
392
613
  */
393
614
  export declare type MessageJson = {
394
615
  /**
616
+ * The unique identifier (e.g. UUID)of the message. This is required and
617
+ * created by the message creator.
618
+ *
395
619
  * @generated from field: string message_id = 1;
396
620
  */
397
621
  messageId?: string;
398
622
 
399
623
  /**
624
+ * The context id of the message. This is optional and if set, the message
625
+ * will be associated with the given context.
626
+ *
400
627
  * @generated from field: string context_id = 2;
401
628
  */
402
629
  contextId?: string;
403
630
 
404
631
  /**
632
+ * The task id of the message. This is optional and if set, the message
633
+ * will be associated with the given task.
634
+ *
405
635
  * @generated from field: string task_id = 3;
406
636
  */
407
637
  taskId?: string;
408
638
 
409
639
  /**
640
+ * A role for the message.
641
+ *
642
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
643
+ *
410
644
  * @generated from field: alis.open.agent.v2.Role role = 4;
411
645
  */
412
646
  role?: RoleJson;
413
647
 
414
648
  /**
649
+ * Parts is the container of the message content.
650
+ *
651
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
652
+ *
415
653
  * @generated from field: repeated alis.open.agent.v2.Part parts = 5;
416
654
  */
417
655
  parts?: PartJson[];
418
656
 
419
657
  /**
658
+ * Any optional metadata to provide along with the message.
659
+ *
420
660
  * @generated from field: google.protobuf.Struct metadata = 6;
421
661
  */
422
662
  metadata?: StructJson;
423
663
 
424
664
  /**
665
+ * The URIs of extensions that are present or contributed to this Message.
666
+ *
425
667
  * @generated from field: repeated string extensions = 7;
426
668
  */
427
669
  extensions?: string[];
428
670
 
429
671
  /**
672
+ * A list of task IDs that this message references for additional context.
673
+ *
430
674
  * @generated from field: repeated string reference_task_ids = 8;
431
675
  */
432
676
  referenceTaskIds?: string[];
@@ -439,70 +683,104 @@ export declare type MessageJson = {
439
683
  export declare const MessageSchema: GenMessage<Message, {jsonType: MessageJson}>;
440
684
 
441
685
  /**
686
+ * Artifacts are the container for task completed results. These are similar
687
+ * to Messages but are intended to be the product of a task, as opposed to
688
+ * point-to-point communication.
689
+ *
442
690
  * @generated from message alis.open.agent.v2.Artifact
443
691
  */
444
692
  export declare type Artifact = Message$1<"alis.open.agent.v2.Artifact"> & {
445
693
  /**
694
+ * Unique identifier (e.g. UUID) for the artifact. It must be at least unique
695
+ * within a task.
696
+ *
446
697
  * @generated from field: string artifact_id = 1;
447
698
  */
448
699
  artifactId: string;
449
700
 
450
701
  /**
702
+ * A human readable name for the artifact.
703
+ *
451
704
  * @generated from field: string name = 3;
452
705
  */
453
706
  name: string;
454
707
 
455
708
  /**
709
+ * A human readable description of the artifact, optional.
710
+ *
456
711
  * @generated from field: string description = 4;
457
712
  */
458
713
  description: string;
459
714
 
460
715
  /**
716
+ * The content of the artifact.
717
+ *
461
718
  * @generated from field: repeated alis.open.agent.v2.Part parts = 5;
462
719
  */
463
720
  parts: Part[];
464
721
 
465
722
  /**
723
+ * Optional metadata included with the artifact.
724
+ *
466
725
  * @generated from field: google.protobuf.Struct metadata = 6;
467
726
  */
468
727
  metadata?: JsonObject | undefined;
469
728
 
470
729
  /**
730
+ * The URIs of extensions that are present or contributed to this Artifact.
731
+ *
471
732
  * @generated from field: repeated string extensions = 7;
472
733
  */
473
734
  extensions: string[];
474
735
  };
475
736
 
476
737
  /**
738
+ * Artifacts are the container for task completed results. These are similar
739
+ * to Messages but are intended to be the product of a task, as opposed to
740
+ * point-to-point communication.
741
+ *
477
742
  * @generated from message alis.open.agent.v2.Artifact
478
743
  */
479
744
  export declare type ArtifactJson = {
480
745
  /**
746
+ * Unique identifier (e.g. UUID) for the artifact. It must be at least unique
747
+ * within a task.
748
+ *
481
749
  * @generated from field: string artifact_id = 1;
482
750
  */
483
751
  artifactId?: string;
484
752
 
485
753
  /**
754
+ * A human readable name for the artifact.
755
+ *
486
756
  * @generated from field: string name = 3;
487
757
  */
488
758
  name?: string;
489
759
 
490
760
  /**
761
+ * A human readable description of the artifact, optional.
762
+ *
491
763
  * @generated from field: string description = 4;
492
764
  */
493
765
  description?: string;
494
766
 
495
767
  /**
768
+ * The content of the artifact.
769
+ *
496
770
  * @generated from field: repeated alis.open.agent.v2.Part parts = 5;
497
771
  */
498
772
  parts?: PartJson[];
499
773
 
500
774
  /**
775
+ * Optional metadata included with the artifact.
776
+ *
501
777
  * @generated from field: google.protobuf.Struct metadata = 6;
502
778
  */
503
779
  metadata?: StructJson;
504
780
 
505
781
  /**
782
+ * The URIs of extensions that are present or contributed to this Artifact.
783
+ *
506
784
  * @generated from field: repeated string extensions = 7;
507
785
  */
508
786
  extensions?: string[];
@@ -515,60 +793,86 @@ export declare type ArtifactJson = {
515
793
  export declare const ArtifactSchema: GenMessage<Artifact, {jsonType: ArtifactJson}>;
516
794
 
517
795
  /**
796
+ * TaskStatusUpdateEvent is a delta even on a task indicating that a task
797
+ * has changed.
798
+ *
518
799
  * @generated from message alis.open.agent.v2.TaskStatusUpdateEvent
519
800
  */
520
801
  export declare type TaskStatusUpdateEvent = Message$1<"alis.open.agent.v2.TaskStatusUpdateEvent"> & {
521
802
  /**
803
+ * The id of the task that is changed
804
+ *
522
805
  * @generated from field: string task_id = 1;
523
806
  */
524
807
  taskId: string;
525
808
 
526
809
  /**
810
+ * The id of the context that the task belongs to
811
+ *
527
812
  * @generated from field: string context_id = 2;
528
813
  */
529
814
  contextId: string;
530
815
 
531
816
  /**
817
+ * The new status of the task.
818
+ *
532
819
  * @generated from field: alis.open.agent.v2.TaskStatus status = 3;
533
820
  */
534
821
  status?: TaskStatus | undefined;
535
822
 
536
823
  /**
824
+ * Whether this is the last status update expected for this task.
825
+ *
537
826
  * @generated from field: bool final = 4;
538
827
  */
539
828
  final: boolean;
540
829
 
541
830
  /**
831
+ * Optional metadata to associate with the task update.
832
+ *
542
833
  * @generated from field: google.protobuf.Struct metadata = 5;
543
834
  */
544
835
  metadata?: JsonObject | undefined;
545
836
  };
546
837
 
547
838
  /**
839
+ * TaskStatusUpdateEvent is a delta even on a task indicating that a task
840
+ * has changed.
841
+ *
548
842
  * @generated from message alis.open.agent.v2.TaskStatusUpdateEvent
549
843
  */
550
844
  export declare type TaskStatusUpdateEventJson = {
551
845
  /**
846
+ * The id of the task that is changed
847
+ *
552
848
  * @generated from field: string task_id = 1;
553
849
  */
554
850
  taskId?: string;
555
851
 
556
852
  /**
853
+ * The id of the context that the task belongs to
854
+ *
557
855
  * @generated from field: string context_id = 2;
558
856
  */
559
857
  contextId?: string;
560
858
 
561
859
  /**
860
+ * The new status of the task.
861
+ *
562
862
  * @generated from field: alis.open.agent.v2.TaskStatus status = 3;
563
863
  */
564
864
  status?: TaskStatusJson;
565
865
 
566
866
  /**
867
+ * Whether this is the last status update expected for this task.
868
+ *
567
869
  * @generated from field: bool final = 4;
568
870
  */
569
871
  final?: boolean;
570
872
 
571
873
  /**
874
+ * Optional metadata to associate with the task update.
875
+ *
572
876
  * @generated from field: google.protobuf.Struct metadata = 5;
573
877
  */
574
878
  metadata?: StructJson;
@@ -581,70 +885,100 @@ export declare type TaskStatusUpdateEventJson = {
581
885
  export declare const TaskStatusUpdateEventSchema: GenMessage<TaskStatusUpdateEvent, {jsonType: TaskStatusUpdateEventJson}>;
582
886
 
583
887
  /**
888
+ * TaskArtifactUpdateEvent represents a task delta where an artifact has
889
+ * been generated.
890
+ *
584
891
  * @generated from message alis.open.agent.v2.TaskArtifactUpdateEvent
585
892
  */
586
893
  export declare type TaskArtifactUpdateEvent = Message$1<"alis.open.agent.v2.TaskArtifactUpdateEvent"> & {
587
894
  /**
895
+ * The id of the task for this artifact
896
+ *
588
897
  * @generated from field: string task_id = 1;
589
898
  */
590
899
  taskId: string;
591
900
 
592
901
  /**
902
+ * The id of the context that this task belongs too
903
+ *
593
904
  * @generated from field: string context_id = 2;
594
905
  */
595
906
  contextId: string;
596
907
 
597
908
  /**
909
+ * The artifact itself
910
+ *
598
911
  * @generated from field: alis.open.agent.v2.Artifact artifact = 3;
599
912
  */
600
913
  artifact?: Artifact | undefined;
601
914
 
602
915
  /**
916
+ * Whether this should be appended to a prior one produced
917
+ *
603
918
  * @generated from field: bool append = 4;
604
919
  */
605
920
  append: boolean;
606
921
 
607
922
  /**
923
+ * Whether this represents the last part of an artifact
924
+ *
608
925
  * @generated from field: bool last_chunk = 5;
609
926
  */
610
927
  lastChunk: boolean;
611
928
 
612
929
  /**
930
+ * Optional metadata associated with the artifact update.
931
+ *
613
932
  * @generated from field: google.protobuf.Struct metadata = 6;
614
933
  */
615
934
  metadata?: JsonObject | undefined;
616
935
  };
617
936
 
618
937
  /**
938
+ * TaskArtifactUpdateEvent represents a task delta where an artifact has
939
+ * been generated.
940
+ *
619
941
  * @generated from message alis.open.agent.v2.TaskArtifactUpdateEvent
620
942
  */
621
943
  export declare type TaskArtifactUpdateEventJson = {
622
944
  /**
945
+ * The id of the task for this artifact
946
+ *
623
947
  * @generated from field: string task_id = 1;
624
948
  */
625
949
  taskId?: string;
626
950
 
627
951
  /**
952
+ * The id of the context that this task belongs too
953
+ *
628
954
  * @generated from field: string context_id = 2;
629
955
  */
630
956
  contextId?: string;
631
957
 
632
958
  /**
959
+ * The artifact itself
960
+ *
633
961
  * @generated from field: alis.open.agent.v2.Artifact artifact = 3;
634
962
  */
635
963
  artifact?: ArtifactJson;
636
964
 
637
965
  /**
966
+ * Whether this should be appended to a prior one produced
967
+ *
638
968
  * @generated from field: bool append = 4;
639
969
  */
640
970
  append?: boolean;
641
971
 
642
972
  /**
973
+ * Whether this represents the last part of an artifact
974
+ *
643
975
  * @generated from field: bool last_chunk = 5;
644
976
  */
645
977
  lastChunk?: boolean;
646
978
 
647
979
  /**
980
+ * Optional metadata associated with the artifact update.
981
+ *
648
982
  * @generated from field: google.protobuf.Struct metadata = 6;
649
983
  */
650
984
  metadata?: StructJson;
@@ -657,50 +991,70 @@ export declare type TaskArtifactUpdateEventJson = {
657
991
  export declare const TaskArtifactUpdateEventSchema: GenMessage<TaskArtifactUpdateEvent, {jsonType: TaskArtifactUpdateEventJson}>;
658
992
 
659
993
  /**
994
+ * Configuration for setting up push notifications for task updates.
995
+ *
660
996
  * @generated from message alis.open.agent.v2.PushNotificationConfig
661
997
  */
662
998
  export declare type PushNotificationConfig = Message$1<"alis.open.agent.v2.PushNotificationConfig"> & {
663
999
  /**
1000
+ * A unique identifier (e.g. UUID) for this push notification.
1001
+ *
664
1002
  * @generated from field: string id = 1;
665
1003
  */
666
1004
  id: string;
667
1005
 
668
1006
  /**
1007
+ * Url to send the notification too
1008
+ *
669
1009
  * @generated from field: string url = 2;
670
1010
  */
671
1011
  url: string;
672
1012
 
673
1013
  /**
1014
+ * Token unique for this task/session
1015
+ *
674
1016
  * @generated from field: string token = 3;
675
1017
  */
676
1018
  token: string;
677
1019
 
678
1020
  /**
1021
+ * Information about the authentication to sent with the notification
1022
+ *
679
1023
  * @generated from field: alis.open.agent.v2.AuthenticationInfo authentication = 4;
680
1024
  */
681
1025
  authentication?: AuthenticationInfo | undefined;
682
1026
  };
683
1027
 
684
1028
  /**
1029
+ * Configuration for setting up push notifications for task updates.
1030
+ *
685
1031
  * @generated from message alis.open.agent.v2.PushNotificationConfig
686
1032
  */
687
1033
  export declare type PushNotificationConfigJson = {
688
1034
  /**
1035
+ * A unique identifier (e.g. UUID) for this push notification.
1036
+ *
689
1037
  * @generated from field: string id = 1;
690
1038
  */
691
1039
  id?: string;
692
1040
 
693
1041
  /**
1042
+ * Url to send the notification too
1043
+ *
694
1044
  * @generated from field: string url = 2;
695
1045
  */
696
1046
  url?: string;
697
1047
 
698
1048
  /**
1049
+ * Token unique for this task/session
1050
+ *
699
1051
  * @generated from field: string token = 3;
700
1052
  */
701
1053
  token?: string;
702
1054
 
703
1055
  /**
1056
+ * Information about the authentication to sent with the notification
1057
+ *
704
1058
  * @generated from field: alis.open.agent.v2.AuthenticationInfo authentication = 4;
705
1059
  */
706
1060
  authentication?: AuthenticationInfoJson;
@@ -713,30 +1067,42 @@ export declare type PushNotificationConfigJson = {
713
1067
  export declare const PushNotificationConfigSchema: GenMessage<PushNotificationConfig, {jsonType: PushNotificationConfigJson}>;
714
1068
 
715
1069
  /**
1070
+ * Defines authentication details, used for push notifications.
1071
+ *
716
1072
  * @generated from message alis.open.agent.v2.AuthenticationInfo
717
1073
  */
718
1074
  export declare type AuthenticationInfo = Message$1<"alis.open.agent.v2.AuthenticationInfo"> & {
719
1075
  /**
1076
+ * Supported authentication schemes - e.g. Basic, Bearer, etc
1077
+ *
720
1078
  * @generated from field: repeated string schemes = 1;
721
1079
  */
722
1080
  schemes: string[];
723
1081
 
724
1082
  /**
1083
+ * Optional credentials
1084
+ *
725
1085
  * @generated from field: string credentials = 2;
726
1086
  */
727
1087
  credentials: string;
728
1088
  };
729
1089
 
730
1090
  /**
1091
+ * Defines authentication details, used for push notifications.
1092
+ *
731
1093
  * @generated from message alis.open.agent.v2.AuthenticationInfo
732
1094
  */
733
1095
  export declare type AuthenticationInfoJson = {
734
1096
  /**
1097
+ * Supported authentication schemes - e.g. Basic, Bearer, etc
1098
+ *
735
1099
  * @generated from field: repeated string schemes = 1;
736
1100
  */
737
1101
  schemes?: string[];
738
1102
 
739
1103
  /**
1104
+ * Optional credentials
1105
+ *
740
1106
  * @generated from field: string credentials = 2;
741
1107
  */
742
1108
  credentials?: string;
@@ -749,30 +1115,46 @@ export declare type AuthenticationInfoJson = {
749
1115
  export declare const AuthenticationInfoSchema: GenMessage<AuthenticationInfo, {jsonType: AuthenticationInfoJson}>;
750
1116
 
751
1117
  /**
1118
+ * Defines additional transport information for the agent.
1119
+ *
752
1120
  * @generated from message alis.open.agent.v2.AgentInterface
753
1121
  */
754
1122
  export declare type AgentInterface = Message$1<"alis.open.agent.v2.AgentInterface"> & {
755
1123
  /**
1124
+ * The url this interface is found at.
1125
+ *
756
1126
  * @generated from field: string url = 1;
757
1127
  */
758
1128
  url: string;
759
1129
 
760
1130
  /**
1131
+ * The transport supported this url. This is an open form string, to be
1132
+ * easily extended for many transport protocols. The core ones officially
1133
+ * supported are JSONRPC, GRPC and HTTP+JSON.
1134
+ *
761
1135
  * @generated from field: string transport = 2;
762
1136
  */
763
1137
  transport: string;
764
1138
  };
765
1139
 
766
1140
  /**
1141
+ * Defines additional transport information for the agent.
1142
+ *
767
1143
  * @generated from message alis.open.agent.v2.AgentInterface
768
1144
  */
769
1145
  export declare type AgentInterfaceJson = {
770
1146
  /**
1147
+ * The url this interface is found at.
1148
+ *
771
1149
  * @generated from field: string url = 1;
772
1150
  */
773
1151
  url?: string;
774
1152
 
775
1153
  /**
1154
+ * The transport supported this url. This is an open form string, to be
1155
+ * easily extended for many transport protocols. The core ones officially
1156
+ * supported are JSONRPC, GRPC and HTTP+JSON.
1157
+ *
776
1158
  * @generated from field: string transport = 2;
777
1159
  */
778
1160
  transport?: string;
@@ -785,190 +1167,328 @@ export declare type AgentInterfaceJson = {
785
1167
  export declare const AgentInterfaceSchema: GenMessage<AgentInterface, {jsonType: AgentInterfaceJson}>;
786
1168
 
787
1169
  /**
1170
+ * AgentCard conveys key information:
1171
+ * - Overall details (version, name, description, uses)
1172
+ * - Skills; a set of actions/solutions the agent can perform
1173
+ * - Default modalities/content types supported by the agent.
1174
+ * - Authentication requirements
1175
+ * Next ID: 19
1176
+ *
788
1177
  * @generated from message alis.open.agent.v2.AgentCard
789
1178
  */
790
1179
  export declare type AgentCard = Message$1<"alis.open.agent.v2.AgentCard"> & {
791
1180
  /**
1181
+ * The version of the A2A protocol this agent supports.
1182
+ *
792
1183
  * @generated from field: string protocol_version = 16;
793
1184
  */
794
1185
  protocolVersion: string;
795
1186
 
796
1187
  /**
1188
+ * A human readable name for the agent.
1189
+ * Example: "Recipe Agent"
1190
+ *
797
1191
  * @generated from field: string name = 1;
798
1192
  */
799
1193
  name: string;
800
1194
 
801
1195
  /**
1196
+ * A description of the agent's domain of action/solution space.
1197
+ * Example: "Agent that helps users with recipes and cooking."
1198
+ *
802
1199
  * @generated from field: string description = 2;
803
1200
  */
804
1201
  description: string;
805
1202
 
806
1203
  /**
1204
+ * A URL to the address the agent is hosted at. This represents the
1205
+ * preferred endpoint as declared by the agent.
1206
+ *
807
1207
  * @generated from field: string url = 3;
808
1208
  */
809
1209
  url: string;
810
1210
 
811
1211
  /**
1212
+ * The transport of the preferred endpoint. If empty, defaults to JSONRPC.
1213
+ *
812
1214
  * @generated from field: string preferred_transport = 14;
813
1215
  */
814
1216
  preferredTransport: string;
815
1217
 
816
1218
  /**
1219
+ * Announcement of additional supported transports. Client can use any of
1220
+ * the supported transports.
1221
+ *
817
1222
  * @generated from field: repeated alis.open.agent.v2.AgentInterface additional_interfaces = 15;
818
1223
  */
819
1224
  additionalInterfaces: AgentInterface[];
820
1225
 
821
1226
  /**
1227
+ * The service provider of the agent.
1228
+ *
822
1229
  * @generated from field: alis.open.agent.v2.AgentProvider provider = 4;
823
1230
  */
824
1231
  provider?: AgentProvider | undefined;
825
1232
 
826
1233
  /**
1234
+ * The version of the agent.
1235
+ * Example: "1.0.0"
1236
+ *
827
1237
  * @generated from field: string version = 5;
828
1238
  */
829
1239
  version: string;
830
1240
 
831
1241
  /**
1242
+ * A url to provide additional documentation about the agent.
1243
+ *
832
1244
  * @generated from field: string documentation_url = 6;
833
1245
  */
834
1246
  documentationUrl: string;
835
1247
 
836
1248
  /**
1249
+ * A2A Capability set supported by the agent.
1250
+ *
837
1251
  * @generated from field: alis.open.agent.v2.AgentCapabilities capabilities = 7;
838
1252
  */
839
1253
  capabilities?: AgentCapabilities | undefined;
840
1254
 
841
1255
  /**
1256
+ * The security scheme details used for authenticating with this agent.
1257
+ *
1258
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
1259
+ *
842
1260
  * @generated from field: map<string, alis.open.agent.v2.SecurityScheme> security_schemes = 8;
843
1261
  */
844
1262
  securitySchemes: { [key: string]: SecurityScheme };
845
1263
 
846
1264
  /**
1265
+ * Security requirements for contacting the agent.
1266
+ * This list can be seen as an OR of ANDs. Each object in the list describes
1267
+ * one possible set of security requirements that must be present on a
1268
+ * request. This allows specifying, for example, "callers must either use
1269
+ * OAuth OR an API Key AND mTLS."
1270
+ * Example:
1271
+ * security {
1272
+ * schemes { key: "oauth" value { list: ["read"] } }
1273
+ * }
1274
+ * security {
1275
+ * schemes { key: "api-key" }
1276
+ * schemes { key: "mtls" }
1277
+ * }
1278
+ *
1279
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
1280
+ *
847
1281
  * @generated from field: repeated alis.open.agent.v2.Security security = 9;
848
1282
  */
849
1283
  security: Security[];
850
1284
 
851
1285
  /**
1286
+ * The set of interaction modes that the agent supports across all skills.
1287
+ * This can be overridden per skill. Defined as mime types.
1288
+ *
852
1289
  * @generated from field: repeated string default_input_modes = 10;
853
1290
  */
854
1291
  defaultInputModes: string[];
855
1292
 
856
1293
  /**
1294
+ * The mime types supported as outputs from this agent.
1295
+ *
857
1296
  * @generated from field: repeated string default_output_modes = 11;
858
1297
  */
859
1298
  defaultOutputModes: string[];
860
1299
 
861
1300
  /**
1301
+ * Skills represent a unit of ability an agent can perform. This may
1302
+ * somewhat abstract but represents a more focused set of actions that the
1303
+ * agent is highly likely to succeed at.
1304
+ *
862
1305
  * @generated from field: repeated alis.open.agent.v2.AgentSkill skills = 12;
863
1306
  */
864
1307
  skills: AgentSkill[];
865
1308
 
866
1309
  /**
1310
+ * Whether the agent supports providing an extended agent card when
1311
+ * the user is authenticated, i.e. is the card from .well-known
1312
+ * different than the card from GetAgentCard.
1313
+ *
867
1314
  * @generated from field: bool supports_authenticated_extended_card = 13;
868
1315
  */
869
1316
  supportsAuthenticatedExtendedCard: boolean;
870
1317
 
871
1318
  /**
1319
+ * JSON Web Signatures computed for this AgentCard.
1320
+ *
872
1321
  * @generated from field: repeated alis.open.agent.v2.AgentCardSignature signatures = 17;
873
1322
  */
874
1323
  signatures: AgentCardSignature[];
875
1324
 
876
1325
  /**
1326
+ * An optional URL to an icon for the agent.
1327
+ *
877
1328
  * @generated from field: string icon_url = 18;
878
1329
  */
879
1330
  iconUrl: string;
880
1331
  };
881
1332
 
882
1333
  /**
1334
+ * AgentCard conveys key information:
1335
+ * - Overall details (version, name, description, uses)
1336
+ * - Skills; a set of actions/solutions the agent can perform
1337
+ * - Default modalities/content types supported by the agent.
1338
+ * - Authentication requirements
1339
+ * Next ID: 19
1340
+ *
883
1341
  * @generated from message alis.open.agent.v2.AgentCard
884
1342
  */
885
1343
  export declare type AgentCardJson = {
886
1344
  /**
1345
+ * The version of the A2A protocol this agent supports.
1346
+ *
887
1347
  * @generated from field: string protocol_version = 16;
888
1348
  */
889
1349
  protocolVersion?: string;
890
1350
 
891
1351
  /**
1352
+ * A human readable name for the agent.
1353
+ * Example: "Recipe Agent"
1354
+ *
892
1355
  * @generated from field: string name = 1;
893
1356
  */
894
1357
  name?: string;
895
1358
 
896
1359
  /**
1360
+ * A description of the agent's domain of action/solution space.
1361
+ * Example: "Agent that helps users with recipes and cooking."
1362
+ *
897
1363
  * @generated from field: string description = 2;
898
1364
  */
899
1365
  description?: string;
900
1366
 
901
1367
  /**
1368
+ * A URL to the address the agent is hosted at. This represents the
1369
+ * preferred endpoint as declared by the agent.
1370
+ *
902
1371
  * @generated from field: string url = 3;
903
1372
  */
904
1373
  url?: string;
905
1374
 
906
1375
  /**
1376
+ * The transport of the preferred endpoint. If empty, defaults to JSONRPC.
1377
+ *
907
1378
  * @generated from field: string preferred_transport = 14;
908
1379
  */
909
1380
  preferredTransport?: string;
910
1381
 
911
1382
  /**
1383
+ * Announcement of additional supported transports. Client can use any of
1384
+ * the supported transports.
1385
+ *
912
1386
  * @generated from field: repeated alis.open.agent.v2.AgentInterface additional_interfaces = 15;
913
1387
  */
914
1388
  additionalInterfaces?: AgentInterfaceJson[];
915
1389
 
916
1390
  /**
1391
+ * The service provider of the agent.
1392
+ *
917
1393
  * @generated from field: alis.open.agent.v2.AgentProvider provider = 4;
918
1394
  */
919
1395
  provider?: AgentProviderJson;
920
1396
 
921
1397
  /**
1398
+ * The version of the agent.
1399
+ * Example: "1.0.0"
1400
+ *
922
1401
  * @generated from field: string version = 5;
923
1402
  */
924
1403
  version?: string;
925
1404
 
926
1405
  /**
1406
+ * A url to provide additional documentation about the agent.
1407
+ *
927
1408
  * @generated from field: string documentation_url = 6;
928
1409
  */
929
1410
  documentationUrl?: string;
930
1411
 
931
1412
  /**
1413
+ * A2A Capability set supported by the agent.
1414
+ *
932
1415
  * @generated from field: alis.open.agent.v2.AgentCapabilities capabilities = 7;
933
1416
  */
934
1417
  capabilities?: AgentCapabilitiesJson;
935
1418
 
936
1419
  /**
1420
+ * The security scheme details used for authenticating with this agent.
1421
+ *
1422
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
1423
+ *
937
1424
  * @generated from field: map<string, alis.open.agent.v2.SecurityScheme> security_schemes = 8;
938
1425
  */
939
1426
  securitySchemes?: { [key: string]: SecuritySchemeJson };
940
1427
 
941
1428
  /**
1429
+ * Security requirements for contacting the agent.
1430
+ * This list can be seen as an OR of ANDs. Each object in the list describes
1431
+ * one possible set of security requirements that must be present on a
1432
+ * request. This allows specifying, for example, "callers must either use
1433
+ * OAuth OR an API Key AND mTLS."
1434
+ * Example:
1435
+ * security {
1436
+ * schemes { key: "oauth" value { list: ["read"] } }
1437
+ * }
1438
+ * security {
1439
+ * schemes { key: "api-key" }
1440
+ * schemes { key: "mtls" }
1441
+ * }
1442
+ *
1443
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
1444
+ *
942
1445
  * @generated from field: repeated alis.open.agent.v2.Security security = 9;
943
1446
  */
944
1447
  security?: SecurityJson[];
945
1448
 
946
1449
  /**
1450
+ * The set of interaction modes that the agent supports across all skills.
1451
+ * This can be overridden per skill. Defined as mime types.
1452
+ *
947
1453
  * @generated from field: repeated string default_input_modes = 10;
948
1454
  */
949
1455
  defaultInputModes?: string[];
950
1456
 
951
1457
  /**
1458
+ * The mime types supported as outputs from this agent.
1459
+ *
952
1460
  * @generated from field: repeated string default_output_modes = 11;
953
1461
  */
954
1462
  defaultOutputModes?: string[];
955
1463
 
956
1464
  /**
1465
+ * Skills represent a unit of ability an agent can perform. This may
1466
+ * somewhat abstract but represents a more focused set of actions that the
1467
+ * agent is highly likely to succeed at.
1468
+ *
957
1469
  * @generated from field: repeated alis.open.agent.v2.AgentSkill skills = 12;
958
1470
  */
959
1471
  skills?: AgentSkillJson[];
960
1472
 
961
1473
  /**
1474
+ * Whether the agent supports providing an extended agent card when
1475
+ * the user is authenticated, i.e. is the card from .well-known
1476
+ * different than the card from GetAgentCard.
1477
+ *
962
1478
  * @generated from field: bool supports_authenticated_extended_card = 13;
963
1479
  */
964
1480
  supportsAuthenticatedExtendedCard?: boolean;
965
1481
 
966
1482
  /**
1483
+ * JSON Web Signatures computed for this AgentCard.
1484
+ *
967
1485
  * @generated from field: repeated alis.open.agent.v2.AgentCardSignature signatures = 17;
968
1486
  */
969
1487
  signatures?: AgentCardSignatureJson[];
970
1488
 
971
1489
  /**
1490
+ * An optional URL to an icon for the agent.
1491
+ *
972
1492
  * @generated from field: string icon_url = 18;
973
1493
  */
974
1494
  iconUrl?: string;
@@ -981,30 +1501,46 @@ export declare type AgentCardJson = {
981
1501
  export declare const AgentCardSchema: GenMessage<AgentCard, {jsonType: AgentCardJson}>;
982
1502
 
983
1503
  /**
1504
+ * Represents information about the service provider of an agent.
1505
+ *
984
1506
  * @generated from message alis.open.agent.v2.AgentProvider
985
1507
  */
986
1508
  export declare type AgentProvider = Message$1<"alis.open.agent.v2.AgentProvider"> & {
987
1509
  /**
1510
+ * The providers reference url
1511
+ * Example: "https://ai.google.dev"
1512
+ *
988
1513
  * @generated from field: string url = 1;
989
1514
  */
990
1515
  url: string;
991
1516
 
992
1517
  /**
1518
+ * The providers organization name
1519
+ * Example: "Google"
1520
+ *
993
1521
  * @generated from field: string organization = 2;
994
1522
  */
995
1523
  organization: string;
996
1524
  };
997
1525
 
998
1526
  /**
1527
+ * Represents information about the service provider of an agent.
1528
+ *
999
1529
  * @generated from message alis.open.agent.v2.AgentProvider
1000
1530
  */
1001
1531
  export declare type AgentProviderJson = {
1002
1532
  /**
1533
+ * The providers reference url
1534
+ * Example: "https://ai.google.dev"
1535
+ *
1003
1536
  * @generated from field: string url = 1;
1004
1537
  */
1005
1538
  url?: string;
1006
1539
 
1007
1540
  /**
1541
+ * The providers organization name
1542
+ * Example: "Google"
1543
+ *
1008
1544
  * @generated from field: string organization = 2;
1009
1545
  */
1010
1546
  organization?: string;
@@ -1017,50 +1553,70 @@ export declare type AgentProviderJson = {
1017
1553
  export declare const AgentProviderSchema: GenMessage<AgentProvider, {jsonType: AgentProviderJson}>;
1018
1554
 
1019
1555
  /**
1556
+ * Defines the A2A feature set supported by the agent
1557
+ *
1020
1558
  * @generated from message alis.open.agent.v2.AgentCapabilities
1021
1559
  */
1022
1560
  export declare type AgentCapabilities = Message$1<"alis.open.agent.v2.AgentCapabilities"> & {
1023
1561
  /**
1562
+ * If the agent will support streaming responses
1563
+ *
1024
1564
  * @generated from field: bool streaming = 1;
1025
1565
  */
1026
1566
  streaming: boolean;
1027
1567
 
1028
1568
  /**
1569
+ * If the agent can send push notifications to the clients webhook
1570
+ *
1029
1571
  * @generated from field: bool push_notifications = 2;
1030
1572
  */
1031
1573
  pushNotifications: boolean;
1032
1574
 
1033
1575
  /**
1576
+ * Extensions supported by this agent.
1577
+ *
1034
1578
  * @generated from field: repeated alis.open.agent.v2.AgentExtension extensions = 3;
1035
1579
  */
1036
1580
  extensions: AgentExtension[];
1037
1581
 
1038
1582
  /**
1583
+ * If the agent provides a history of state transitions for a task.
1584
+ *
1039
1585
  * @generated from field: bool state_transition_history = 4;
1040
1586
  */
1041
1587
  stateTransitionHistory: boolean;
1042
1588
  };
1043
1589
 
1044
1590
  /**
1591
+ * Defines the A2A feature set supported by the agent
1592
+ *
1045
1593
  * @generated from message alis.open.agent.v2.AgentCapabilities
1046
1594
  */
1047
1595
  export declare type AgentCapabilitiesJson = {
1048
1596
  /**
1597
+ * If the agent will support streaming responses
1598
+ *
1049
1599
  * @generated from field: bool streaming = 1;
1050
1600
  */
1051
1601
  streaming?: boolean;
1052
1602
 
1053
1603
  /**
1604
+ * If the agent can send push notifications to the clients webhook
1605
+ *
1054
1606
  * @generated from field: bool push_notifications = 2;
1055
1607
  */
1056
1608
  pushNotifications?: boolean;
1057
1609
 
1058
1610
  /**
1611
+ * Extensions supported by this agent.
1612
+ *
1059
1613
  * @generated from field: repeated alis.open.agent.v2.AgentExtension extensions = 3;
1060
1614
  */
1061
1615
  extensions?: AgentExtensionJson[];
1062
1616
 
1063
1617
  /**
1618
+ * If the agent provides a history of state transitions for a task.
1619
+ *
1064
1620
  * @generated from field: bool state_transition_history = 4;
1065
1621
  */
1066
1622
  stateTransitionHistory?: boolean;
@@ -1073,50 +1629,76 @@ export declare type AgentCapabilitiesJson = {
1073
1629
  export declare const AgentCapabilitiesSchema: GenMessage<AgentCapabilities, {jsonType: AgentCapabilitiesJson}>;
1074
1630
 
1075
1631
  /**
1632
+ * A declaration of an extension supported by an Agent.
1633
+ *
1076
1634
  * @generated from message alis.open.agent.v2.AgentExtension
1077
1635
  */
1078
1636
  export declare type AgentExtension = Message$1<"alis.open.agent.v2.AgentExtension"> & {
1079
1637
  /**
1638
+ * The URI of the extension.
1639
+ * Example: "https://developers.google.com/identity/protocols/oauth2"
1640
+ *
1080
1641
  * @generated from field: string uri = 1;
1081
1642
  */
1082
1643
  uri: string;
1083
1644
 
1084
1645
  /**
1646
+ * A description of how this agent uses this extension.
1647
+ * Example: "Google OAuth 2.0 authentication"
1648
+ *
1085
1649
  * @generated from field: string description = 2;
1086
1650
  */
1087
1651
  description: string;
1088
1652
 
1089
1653
  /**
1654
+ * Whether the client must follow specific requirements of the extension.
1655
+ * Example: false
1656
+ *
1090
1657
  * @generated from field: bool required = 3;
1091
1658
  */
1092
1659
  required: boolean;
1093
1660
 
1094
1661
  /**
1662
+ * Optional configuration for the extension.
1663
+ *
1095
1664
  * @generated from field: google.protobuf.Struct params = 4;
1096
1665
  */
1097
1666
  params?: JsonObject | undefined;
1098
1667
  };
1099
1668
 
1100
1669
  /**
1670
+ * A declaration of an extension supported by an Agent.
1671
+ *
1101
1672
  * @generated from message alis.open.agent.v2.AgentExtension
1102
1673
  */
1103
1674
  export declare type AgentExtensionJson = {
1104
1675
  /**
1676
+ * The URI of the extension.
1677
+ * Example: "https://developers.google.com/identity/protocols/oauth2"
1678
+ *
1105
1679
  * @generated from field: string uri = 1;
1106
1680
  */
1107
1681
  uri?: string;
1108
1682
 
1109
1683
  /**
1684
+ * A description of how this agent uses this extension.
1685
+ * Example: "Google OAuth 2.0 authentication"
1686
+ *
1110
1687
  * @generated from field: string description = 2;
1111
1688
  */
1112
1689
  description?: string;
1113
1690
 
1114
1691
  /**
1692
+ * Whether the client must follow specific requirements of the extension.
1693
+ * Example: false
1694
+ *
1115
1695
  * @generated from field: bool required = 3;
1116
1696
  */
1117
1697
  required?: boolean;
1118
1698
 
1119
1699
  /**
1700
+ * Optional configuration for the extension.
1701
+ *
1120
1702
  * @generated from field: google.protobuf.Struct params = 4;
1121
1703
  */
1122
1704
  params?: StructJson;
@@ -1129,90 +1711,158 @@ export declare type AgentExtensionJson = {
1129
1711
  export declare const AgentExtensionSchema: GenMessage<AgentExtension, {jsonType: AgentExtensionJson}>;
1130
1712
 
1131
1713
  /**
1714
+ * AgentSkill represents a unit of action/solution that the agent can perform.
1715
+ * One can think of this as a type of highly reliable solution that an agent
1716
+ * can be tasked to provide. Agents have the autonomy to choose how and when
1717
+ * to use specific skills, but clients should have confidence that if the
1718
+ * skill is defined that unit of action can be reliably performed.
1719
+ *
1132
1720
  * @generated from message alis.open.agent.v2.AgentSkill
1133
1721
  */
1134
1722
  export declare type AgentSkill = Message$1<"alis.open.agent.v2.AgentSkill"> & {
1135
1723
  /**
1724
+ * Unique identifier of the skill within this agent.
1725
+ *
1136
1726
  * @generated from field: string id = 1;
1137
1727
  */
1138
1728
  id: string;
1139
1729
 
1140
1730
  /**
1731
+ * A human readable name for the skill.
1732
+ *
1141
1733
  * @generated from field: string name = 2;
1142
1734
  */
1143
1735
  name: string;
1144
1736
 
1145
1737
  /**
1738
+ * A human (or llm) readable description of the skill
1739
+ * details and behaviors.
1740
+ *
1146
1741
  * @generated from field: string description = 3;
1147
1742
  */
1148
1743
  description: string;
1149
1744
 
1150
1745
  /**
1746
+ * A set of tags for the skill to enhance categorization/utilization.
1747
+ * Example: ["cooking", "customer support", "billing"]
1748
+ *
1151
1749
  * @generated from field: repeated string tags = 4;
1152
1750
  */
1153
1751
  tags: string[];
1154
1752
 
1155
1753
  /**
1754
+ * A set of example queries that this skill is designed to address.
1755
+ * These examples should help the caller to understand how to craft requests
1756
+ * to the agent to achieve specific goals.
1757
+ * Example: ["I need a recipe for bread"]
1758
+ *
1156
1759
  * @generated from field: repeated string examples = 5;
1157
1760
  */
1158
1761
  examples: string[];
1159
1762
 
1160
1763
  /**
1764
+ * Possible input modalities supported.
1765
+ *
1161
1766
  * @generated from field: repeated string input_modes = 6;
1162
1767
  */
1163
1768
  inputModes: string[];
1164
1769
 
1165
1770
  /**
1771
+ * Possible output modalities produced
1772
+ *
1773
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
1774
+ *
1166
1775
  * @generated from field: repeated string output_modes = 7;
1167
1776
  */
1168
1777
  outputModes: string[];
1169
1778
 
1170
1779
  /**
1780
+ * Security schemes necessary for the agent to leverage this skill.
1781
+ * As in the overall AgentCard.security, this list represents a logical OR of
1782
+ * security requirement objects. Each object is a set of security schemes
1783
+ * that must be used together (a logical AND).
1784
+ *
1785
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
1786
+ *
1171
1787
  * @generated from field: repeated alis.open.agent.v2.Security security = 8;
1172
1788
  */
1173
1789
  security: Security[];
1174
1790
  };
1175
1791
 
1176
1792
  /**
1793
+ * AgentSkill represents a unit of action/solution that the agent can perform.
1794
+ * One can think of this as a type of highly reliable solution that an agent
1795
+ * can be tasked to provide. Agents have the autonomy to choose how and when
1796
+ * to use specific skills, but clients should have confidence that if the
1797
+ * skill is defined that unit of action can be reliably performed.
1798
+ *
1177
1799
  * @generated from message alis.open.agent.v2.AgentSkill
1178
1800
  */
1179
1801
  export declare type AgentSkillJson = {
1180
1802
  /**
1803
+ * Unique identifier of the skill within this agent.
1804
+ *
1181
1805
  * @generated from field: string id = 1;
1182
1806
  */
1183
1807
  id?: string;
1184
1808
 
1185
1809
  /**
1810
+ * A human readable name for the skill.
1811
+ *
1186
1812
  * @generated from field: string name = 2;
1187
1813
  */
1188
1814
  name?: string;
1189
1815
 
1190
1816
  /**
1817
+ * A human (or llm) readable description of the skill
1818
+ * details and behaviors.
1819
+ *
1191
1820
  * @generated from field: string description = 3;
1192
1821
  */
1193
1822
  description?: string;
1194
1823
 
1195
1824
  /**
1825
+ * A set of tags for the skill to enhance categorization/utilization.
1826
+ * Example: ["cooking", "customer support", "billing"]
1827
+ *
1196
1828
  * @generated from field: repeated string tags = 4;
1197
1829
  */
1198
1830
  tags?: string[];
1199
1831
 
1200
1832
  /**
1833
+ * A set of example queries that this skill is designed to address.
1834
+ * These examples should help the caller to understand how to craft requests
1835
+ * to the agent to achieve specific goals.
1836
+ * Example: ["I need a recipe for bread"]
1837
+ *
1201
1838
  * @generated from field: repeated string examples = 5;
1202
1839
  */
1203
1840
  examples?: string[];
1204
1841
 
1205
1842
  /**
1843
+ * Possible input modalities supported.
1844
+ *
1206
1845
  * @generated from field: repeated string input_modes = 6;
1207
1846
  */
1208
1847
  inputModes?: string[];
1209
1848
 
1210
1849
  /**
1850
+ * Possible output modalities produced
1851
+ *
1852
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
1853
+ *
1211
1854
  * @generated from field: repeated string output_modes = 7;
1212
1855
  */
1213
1856
  outputModes?: string[];
1214
1857
 
1215
1858
  /**
1859
+ * Security schemes necessary for the agent to leverage this skill.
1860
+ * As in the overall AgentCard.security, this list represents a logical OR of
1861
+ * security requirement objects. Each object is a set of security schemes
1862
+ * that must be used together (a logical AND).
1863
+ *
1864
+ * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
1865
+ *
1216
1866
  * @generated from field: repeated alis.open.agent.v2.Security security = 8;
1217
1867
  */
1218
1868
  security?: SecurityJson[];
@@ -1225,40 +1875,60 @@ export declare type AgentSkillJson = {
1225
1875
  export declare const AgentSkillSchema: GenMessage<AgentSkill, {jsonType: AgentSkillJson}>;
1226
1876
 
1227
1877
  /**
1878
+ * AgentCardSignature represents a JWS signature of an AgentCard.
1879
+ * This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
1880
+ *
1228
1881
  * @generated from message alis.open.agent.v2.AgentCardSignature
1229
1882
  */
1230
1883
  export declare type AgentCardSignature = Message$1<"alis.open.agent.v2.AgentCardSignature"> & {
1231
1884
  /**
1885
+ * The protected JWS header for the signature. This is always a
1886
+ * base64url-encoded JSON object. Required.
1887
+ *
1232
1888
  * @generated from field: string protected = 1;
1233
1889
  */
1234
1890
  protected: string;
1235
1891
 
1236
1892
  /**
1893
+ * The computed signature, base64url-encoded. Required.
1894
+ *
1237
1895
  * @generated from field: string signature = 2;
1238
1896
  */
1239
1897
  signature: string;
1240
1898
 
1241
1899
  /**
1900
+ * The unprotected JWS header values.
1901
+ *
1242
1902
  * @generated from field: google.protobuf.Struct header = 3;
1243
1903
  */
1244
1904
  header?: JsonObject | undefined;
1245
1905
  };
1246
1906
 
1247
1907
  /**
1908
+ * AgentCardSignature represents a JWS signature of an AgentCard.
1909
+ * This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
1910
+ *
1248
1911
  * @generated from message alis.open.agent.v2.AgentCardSignature
1249
1912
  */
1250
1913
  export declare type AgentCardSignatureJson = {
1251
1914
  /**
1915
+ * The protected JWS header for the signature. This is always a
1916
+ * base64url-encoded JSON object. Required.
1917
+ *
1252
1918
  * @generated from field: string protected = 1;
1253
1919
  */
1254
1920
  protected?: string;
1255
1921
 
1256
1922
  /**
1923
+ * The computed signature, base64url-encoded. Required.
1924
+ *
1257
1925
  * @generated from field: string signature = 2;
1258
1926
  */
1259
1927
  signature?: string;
1260
1928
 
1261
1929
  /**
1930
+ * The unprotected JWS header values.
1931
+ *
1262
1932
  * @generated from field: google.protobuf.Struct header = 3;
1263
1933
  */
1264
1934
  header?: StructJson;
@@ -1271,30 +1941,46 @@ export declare type AgentCardSignatureJson = {
1271
1941
  export declare const AgentCardSignatureSchema: GenMessage<AgentCardSignature, {jsonType: AgentCardSignatureJson}>;
1272
1942
 
1273
1943
  /**
1944
+ * A push notification configuration for a specific task. It is a resource
1945
+ * whose parent is the task.
1946
+ *
1274
1947
  * @generated from message alis.open.agent.v2.TaskPushNotificationConfig
1275
1948
  */
1276
1949
  export declare type TaskPushNotificationConfig = Message$1<"alis.open.agent.v2.TaskPushNotificationConfig"> & {
1277
1950
  /**
1951
+ * The resource name of the config.
1952
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
1953
+ *
1278
1954
  * @generated from field: string name = 1;
1279
1955
  */
1280
1956
  name: string;
1281
1957
 
1282
1958
  /**
1959
+ * The push notification configuration details.
1960
+ *
1283
1961
  * @generated from field: alis.open.agent.v2.PushNotificationConfig push_notification_config = 2;
1284
1962
  */
1285
1963
  pushNotificationConfig?: PushNotificationConfig | undefined;
1286
1964
  };
1287
1965
 
1288
1966
  /**
1967
+ * A push notification configuration for a specific task. It is a resource
1968
+ * whose parent is the task.
1969
+ *
1289
1970
  * @generated from message alis.open.agent.v2.TaskPushNotificationConfig
1290
1971
  */
1291
1972
  export declare type TaskPushNotificationConfigJson = {
1292
1973
  /**
1974
+ * The resource name of the config.
1975
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
1976
+ *
1293
1977
  * @generated from field: string name = 1;
1294
1978
  */
1295
1979
  name?: string;
1296
1980
 
1297
1981
  /**
1982
+ * The push notification configuration details.
1983
+ *
1298
1984
  * @generated from field: alis.open.agent.v2.PushNotificationConfig push_notification_config = 2;
1299
1985
  */
1300
1986
  pushNotificationConfig?: PushNotificationConfigJson;
@@ -1307,20 +1993,30 @@ export declare type TaskPushNotificationConfigJson = {
1307
1993
  export declare const TaskPushNotificationConfigSchema: GenMessage<TaskPushNotificationConfig, {jsonType: TaskPushNotificationConfigJson}>;
1308
1994
 
1309
1995
  /**
1996
+ * A list of strings. Used as the map value in `Security.schemes` to hold the
1997
+ * scopes a security scheme requires.
1998
+ *
1310
1999
  * @generated from message alis.open.agent.v2.StringList
1311
2000
  */
1312
2001
  export declare type StringList = Message$1<"alis.open.agent.v2.StringList"> & {
1313
2002
  /**
2003
+ * The string values.
2004
+ *
1314
2005
  * @generated from field: repeated string list = 1;
1315
2006
  */
1316
2007
  list: string[];
1317
2008
  };
1318
2009
 
1319
2010
  /**
2011
+ * A list of strings. Used as the map value in `Security.schemes` to hold the
2012
+ * scopes a security scheme requires.
2013
+ *
1320
2014
  * @generated from message alis.open.agent.v2.StringList
1321
2015
  */
1322
2016
  export declare type StringListJson = {
1323
2017
  /**
2018
+ * The string values.
2019
+ *
1324
2020
  * @generated from field: repeated string list = 1;
1325
2021
  */
1326
2022
  list?: string[];
@@ -1333,20 +2029,36 @@ export declare type StringListJson = {
1333
2029
  export declare const StringListSchema: GenMessage<StringList, {jsonType: StringListJson}>;
1334
2030
 
1335
2031
  /**
2032
+ * A set of security schemes that must all be satisfied together (a logical
2033
+ * AND). `AgentCard.security` and `AgentSkill.security` list alternative sets,
2034
+ * any one of which is sufficient (a logical OR).
2035
+ *
1336
2036
  * @generated from message alis.open.agent.v2.Security
1337
2037
  */
1338
2038
  export declare type Security = Message$1<"alis.open.agent.v2.Security"> & {
1339
2039
  /**
2040
+ * The security schemes to satisfy, keyed by the scheme names declared in
2041
+ * `AgentCard.security_schemes`. Each value lists the scopes required for
2042
+ * that scheme and may be empty.
2043
+ *
1340
2044
  * @generated from field: map<string, alis.open.agent.v2.StringList> schemes = 1;
1341
2045
  */
1342
2046
  schemes: { [key: string]: StringList };
1343
2047
  };
1344
2048
 
1345
2049
  /**
2050
+ * A set of security schemes that must all be satisfied together (a logical
2051
+ * AND). `AgentCard.security` and `AgentSkill.security` list alternative sets,
2052
+ * any one of which is sufficient (a logical OR).
2053
+ *
1346
2054
  * @generated from message alis.open.agent.v2.Security
1347
2055
  */
1348
2056
  export declare type SecurityJson = {
1349
2057
  /**
2058
+ * The security schemes to satisfy, keyed by the scheme names declared in
2059
+ * `AgentCard.security_schemes`. Each value lists the scopes required for
2060
+ * that scheme and may be empty.
2061
+ *
1350
2062
  * @generated from field: map<string, alis.open.agent.v2.StringList> schemes = 1;
1351
2063
  */
1352
2064
  schemes?: { [key: string]: StringListJson };
@@ -1359,38 +2071,53 @@ export declare type SecurityJson = {
1359
2071
  export declare const SecuritySchema: GenMessage<Security, {jsonType: SecurityJson}>;
1360
2072
 
1361
2073
  /**
2074
+ * Defines a security scheme that can be used to authenticate with the agent,
2075
+ * based on the OpenAPI Security Scheme Object.
2076
+ *
1362
2077
  * @generated from message alis.open.agent.v2.SecurityScheme
1363
2078
  */
1364
2079
  export declare type SecurityScheme = Message$1<"alis.open.agent.v2.SecurityScheme"> & {
1365
2080
  /**
2081
+ * The type of security scheme and its settings.
2082
+ *
1366
2083
  * @generated from oneof alis.open.agent.v2.SecurityScheme.scheme
1367
2084
  */
1368
2085
  scheme: {
1369
2086
  /**
2087
+ * API key-based authentication.
2088
+ *
1370
2089
  * @generated from field: alis.open.agent.v2.APIKeySecurityScheme api_key_security_scheme = 1;
1371
2090
  */
1372
2091
  value: APIKeySecurityScheme;
1373
2092
  case: "apiKeySecurityScheme";
1374
2093
  } | {
1375
2094
  /**
2095
+ * HTTP authentication, such as Basic or Bearer.
2096
+ *
1376
2097
  * @generated from field: alis.open.agent.v2.HTTPAuthSecurityScheme http_auth_security_scheme = 2;
1377
2098
  */
1378
2099
  value: HTTPAuthSecurityScheme;
1379
2100
  case: "httpAuthSecurityScheme";
1380
2101
  } | {
1381
2102
  /**
2103
+ * OAuth 2.0 authentication.
2104
+ *
1382
2105
  * @generated from field: alis.open.agent.v2.OAuth2SecurityScheme oauth2_security_scheme = 3;
1383
2106
  */
1384
2107
  value: OAuth2SecurityScheme;
1385
2108
  case: "oauth2SecurityScheme";
1386
2109
  } | {
1387
2110
  /**
2111
+ * OpenID Connect authentication.
2112
+ *
1388
2113
  * @generated from field: alis.open.agent.v2.OpenIdConnectSecurityScheme open_id_connect_security_scheme = 4;
1389
2114
  */
1390
2115
  value: OpenIdConnectSecurityScheme;
1391
2116
  case: "openIdConnectSecurityScheme";
1392
2117
  } | {
1393
2118
  /**
2119
+ * Mutual TLS authentication.
2120
+ *
1394
2121
  * @generated from field: alis.open.agent.v2.MutualTlsSecurityScheme mtls_security_scheme = 5;
1395
2122
  */
1396
2123
  value: MutualTlsSecurityScheme;
@@ -1399,30 +2126,43 @@ export declare type SecurityScheme = Message$1<"alis.open.agent.v2.SecuritySchem
1399
2126
  };
1400
2127
 
1401
2128
  /**
2129
+ * Defines a security scheme that can be used to authenticate with the agent,
2130
+ * based on the OpenAPI Security Scheme Object.
2131
+ *
1402
2132
  * @generated from message alis.open.agent.v2.SecurityScheme
1403
2133
  */
1404
2134
  export declare type SecuritySchemeJson = {
1405
2135
  /**
2136
+ * API key-based authentication.
2137
+ *
1406
2138
  * @generated from field: alis.open.agent.v2.APIKeySecurityScheme api_key_security_scheme = 1;
1407
2139
  */
1408
2140
  apiKeySecurityScheme?: APIKeySecuritySchemeJson;
1409
2141
 
1410
2142
  /**
2143
+ * HTTP authentication, such as Basic or Bearer.
2144
+ *
1411
2145
  * @generated from field: alis.open.agent.v2.HTTPAuthSecurityScheme http_auth_security_scheme = 2;
1412
2146
  */
1413
2147
  httpAuthSecurityScheme?: HTTPAuthSecuritySchemeJson;
1414
2148
 
1415
2149
  /**
2150
+ * OAuth 2.0 authentication.
2151
+ *
1416
2152
  * @generated from field: alis.open.agent.v2.OAuth2SecurityScheme oauth2_security_scheme = 3;
1417
2153
  */
1418
2154
  oauth2SecurityScheme?: OAuth2SecuritySchemeJson;
1419
2155
 
1420
2156
  /**
2157
+ * OpenID Connect authentication.
2158
+ *
1421
2159
  * @generated from field: alis.open.agent.v2.OpenIdConnectSecurityScheme open_id_connect_security_scheme = 4;
1422
2160
  */
1423
2161
  openIdConnectSecurityScheme?: OpenIdConnectSecuritySchemeJson;
1424
2162
 
1425
2163
  /**
2164
+ * Mutual TLS authentication.
2165
+ *
1426
2166
  * @generated from field: alis.open.agent.v2.MutualTlsSecurityScheme mtls_security_scheme = 5;
1427
2167
  */
1428
2168
  mtlsSecurityScheme?: MutualTlsSecuritySchemeJson;
@@ -1435,40 +2175,56 @@ export declare type SecuritySchemeJson = {
1435
2175
  export declare const SecuritySchemeSchema: GenMessage<SecurityScheme, {jsonType: SecuritySchemeJson}>;
1436
2176
 
1437
2177
  /**
2178
+ * Defines a security scheme using an API key.
2179
+ *
1438
2180
  * @generated from message alis.open.agent.v2.APIKeySecurityScheme
1439
2181
  */
1440
2182
  export declare type APIKeySecurityScheme = Message$1<"alis.open.agent.v2.APIKeySecurityScheme"> & {
1441
2183
  /**
2184
+ * Description of this security scheme.
2185
+ *
1442
2186
  * @generated from field: string description = 1;
1443
2187
  */
1444
2188
  description: string;
1445
2189
 
1446
2190
  /**
2191
+ * Location of the API key, valid values are "query", "header", or "cookie"
2192
+ *
1447
2193
  * @generated from field: string location = 2;
1448
2194
  */
1449
2195
  location: string;
1450
2196
 
1451
2197
  /**
2198
+ * Name of the header, query or cookie parameter to be used.
2199
+ *
1452
2200
  * @generated from field: string name = 3;
1453
2201
  */
1454
2202
  name: string;
1455
2203
  };
1456
2204
 
1457
2205
  /**
2206
+ * Defines a security scheme using an API key.
2207
+ *
1458
2208
  * @generated from message alis.open.agent.v2.APIKeySecurityScheme
1459
2209
  */
1460
2210
  export declare type APIKeySecuritySchemeJson = {
1461
2211
  /**
2212
+ * Description of this security scheme.
2213
+ *
1462
2214
  * @generated from field: string description = 1;
1463
2215
  */
1464
2216
  description?: string;
1465
2217
 
1466
2218
  /**
2219
+ * Location of the API key, valid values are "query", "header", or "cookie"
2220
+ *
1467
2221
  * @generated from field: string location = 2;
1468
2222
  */
1469
2223
  location?: string;
1470
2224
 
1471
2225
  /**
2226
+ * Name of the header, query or cookie parameter to be used.
2227
+ *
1472
2228
  * @generated from field: string name = 3;
1473
2229
  */
1474
2230
  name?: string;
@@ -1481,40 +2237,68 @@ export declare type APIKeySecuritySchemeJson = {
1481
2237
  export declare const APIKeySecuritySchemeSchema: GenMessage<APIKeySecurityScheme, {jsonType: APIKeySecuritySchemeJson}>;
1482
2238
 
1483
2239
  /**
2240
+ * Defines a security scheme using HTTP authentication, such as Basic or
2241
+ * Bearer.
2242
+ *
1484
2243
  * @generated from message alis.open.agent.v2.HTTPAuthSecurityScheme
1485
2244
  */
1486
2245
  export declare type HTTPAuthSecurityScheme = Message$1<"alis.open.agent.v2.HTTPAuthSecurityScheme"> & {
1487
2246
  /**
2247
+ * Description of this security scheme.
2248
+ *
1488
2249
  * @generated from field: string description = 1;
1489
2250
  */
1490
2251
  description: string;
1491
2252
 
1492
2253
  /**
2254
+ * The name of the HTTP Authentication scheme to be used in the
2255
+ * Authorization header as defined in RFC7235. The values used SHOULD be
2256
+ * registered in the IANA Authentication Scheme registry.
2257
+ * The value is case-insensitive, as defined in RFC7235.
2258
+ *
1493
2259
  * @generated from field: string scheme = 2;
1494
2260
  */
1495
2261
  scheme: string;
1496
2262
 
1497
2263
  /**
2264
+ * A hint to the client to identify how the bearer token is formatted.
2265
+ * Bearer tokens are usually generated by an authorization server, so
2266
+ * this information is primarily for documentation purposes.
2267
+ *
1498
2268
  * @generated from field: string bearer_format = 3;
1499
2269
  */
1500
2270
  bearerFormat: string;
1501
2271
  };
1502
2272
 
1503
2273
  /**
2274
+ * Defines a security scheme using HTTP authentication, such as Basic or
2275
+ * Bearer.
2276
+ *
1504
2277
  * @generated from message alis.open.agent.v2.HTTPAuthSecurityScheme
1505
2278
  */
1506
2279
  export declare type HTTPAuthSecuritySchemeJson = {
1507
2280
  /**
2281
+ * Description of this security scheme.
2282
+ *
1508
2283
  * @generated from field: string description = 1;
1509
2284
  */
1510
2285
  description?: string;
1511
2286
 
1512
2287
  /**
2288
+ * The name of the HTTP Authentication scheme to be used in the
2289
+ * Authorization header as defined in RFC7235. The values used SHOULD be
2290
+ * registered in the IANA Authentication Scheme registry.
2291
+ * The value is case-insensitive, as defined in RFC7235.
2292
+ *
1513
2293
  * @generated from field: string scheme = 2;
1514
2294
  */
1515
2295
  scheme?: string;
1516
2296
 
1517
2297
  /**
2298
+ * A hint to the client to identify how the bearer token is formatted.
2299
+ * Bearer tokens are usually generated by an authorization server, so
2300
+ * this information is primarily for documentation purposes.
2301
+ *
1518
2302
  * @generated from field: string bearer_format = 3;
1519
2303
  */
1520
2304
  bearerFormat?: string;
@@ -1527,40 +2311,58 @@ export declare type HTTPAuthSecuritySchemeJson = {
1527
2311
  export declare const HTTPAuthSecuritySchemeSchema: GenMessage<HTTPAuthSecurityScheme, {jsonType: HTTPAuthSecuritySchemeJson}>;
1528
2312
 
1529
2313
  /**
2314
+ * Defines a security scheme using OAuth 2.0.
2315
+ *
1530
2316
  * @generated from message alis.open.agent.v2.OAuth2SecurityScheme
1531
2317
  */
1532
2318
  export declare type OAuth2SecurityScheme = Message$1<"alis.open.agent.v2.OAuth2SecurityScheme"> & {
1533
2319
  /**
2320
+ * Description of this security scheme.
2321
+ *
1534
2322
  * @generated from field: string description = 1;
1535
2323
  */
1536
2324
  description: string;
1537
2325
 
1538
2326
  /**
2327
+ * An object containing configuration information for the flow types supported
2328
+ *
1539
2329
  * @generated from field: alis.open.agent.v2.OAuthFlows flows = 2;
1540
2330
  */
1541
2331
  flows?: OAuthFlows | undefined;
1542
2332
 
1543
2333
  /**
2334
+ * URL to the oauth2 authorization server metadata
2335
+ * [RFC8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.
2336
+ *
1544
2337
  * @generated from field: string oauth2_metadata_url = 3;
1545
2338
  */
1546
2339
  oauth2MetadataUrl: string;
1547
2340
  };
1548
2341
 
1549
2342
  /**
2343
+ * Defines a security scheme using OAuth 2.0.
2344
+ *
1550
2345
  * @generated from message alis.open.agent.v2.OAuth2SecurityScheme
1551
2346
  */
1552
2347
  export declare type OAuth2SecuritySchemeJson = {
1553
2348
  /**
2349
+ * Description of this security scheme.
2350
+ *
1554
2351
  * @generated from field: string description = 1;
1555
2352
  */
1556
2353
  description?: string;
1557
2354
 
1558
2355
  /**
2356
+ * An object containing configuration information for the flow types supported
2357
+ *
1559
2358
  * @generated from field: alis.open.agent.v2.OAuthFlows flows = 2;
1560
2359
  */
1561
2360
  flows?: OAuthFlowsJson;
1562
2361
 
1563
2362
  /**
2363
+ * URL to the oauth2 authorization server metadata
2364
+ * [RFC8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.
2365
+ *
1564
2366
  * @generated from field: string oauth2_metadata_url = 3;
1565
2367
  */
1566
2368
  oauth2MetadataUrl?: string;
@@ -1573,30 +2375,44 @@ export declare type OAuth2SecuritySchemeJson = {
1573
2375
  export declare const OAuth2SecuritySchemeSchema: GenMessage<OAuth2SecurityScheme, {jsonType: OAuth2SecuritySchemeJson}>;
1574
2376
 
1575
2377
  /**
2378
+ * Defines a security scheme using OpenID Connect.
2379
+ *
1576
2380
  * @generated from message alis.open.agent.v2.OpenIdConnectSecurityScheme
1577
2381
  */
1578
2382
  export declare type OpenIdConnectSecurityScheme = Message$1<"alis.open.agent.v2.OpenIdConnectSecurityScheme"> & {
1579
2383
  /**
2384
+ * Description of this security scheme.
2385
+ *
1580
2386
  * @generated from field: string description = 1;
1581
2387
  */
1582
2388
  description: string;
1583
2389
 
1584
2390
  /**
2391
+ * Well-known URL to discover the [[OpenID-Connect-Discovery]] provider
2392
+ * metadata.
2393
+ *
1585
2394
  * @generated from field: string open_id_connect_url = 2;
1586
2395
  */
1587
2396
  openIdConnectUrl: string;
1588
2397
  };
1589
2398
 
1590
2399
  /**
2400
+ * Defines a security scheme using OpenID Connect.
2401
+ *
1591
2402
  * @generated from message alis.open.agent.v2.OpenIdConnectSecurityScheme
1592
2403
  */
1593
2404
  export declare type OpenIdConnectSecuritySchemeJson = {
1594
2405
  /**
2406
+ * Description of this security scheme.
2407
+ *
1595
2408
  * @generated from field: string description = 1;
1596
2409
  */
1597
2410
  description?: string;
1598
2411
 
1599
2412
  /**
2413
+ * Well-known URL to discover the [[OpenID-Connect-Discovery]] provider
2414
+ * metadata.
2415
+ *
1600
2416
  * @generated from field: string open_id_connect_url = 2;
1601
2417
  */
1602
2418
  openIdConnectUrl?: string;
@@ -1609,20 +2425,28 @@ export declare type OpenIdConnectSecuritySchemeJson = {
1609
2425
  export declare const OpenIdConnectSecuritySchemeSchema: GenMessage<OpenIdConnectSecurityScheme, {jsonType: OpenIdConnectSecuritySchemeJson}>;
1610
2426
 
1611
2427
  /**
2428
+ * Defines a security scheme using mutual TLS (mTLS) authentication.
2429
+ *
1612
2430
  * @generated from message alis.open.agent.v2.MutualTlsSecurityScheme
1613
2431
  */
1614
2432
  export declare type MutualTlsSecurityScheme = Message$1<"alis.open.agent.v2.MutualTlsSecurityScheme"> & {
1615
2433
  /**
2434
+ * Description of this security scheme.
2435
+ *
1616
2436
  * @generated from field: string description = 1;
1617
2437
  */
1618
2438
  description: string;
1619
2439
  };
1620
2440
 
1621
2441
  /**
2442
+ * Defines a security scheme using mutual TLS (mTLS) authentication.
2443
+ *
1622
2444
  * @generated from message alis.open.agent.v2.MutualTlsSecurityScheme
1623
2445
  */
1624
2446
  export declare type MutualTlsSecuritySchemeJson = {
1625
2447
  /**
2448
+ * Description of this security scheme.
2449
+ *
1626
2450
  * @generated from field: string description = 1;
1627
2451
  */
1628
2452
  description?: string;
@@ -1635,32 +2459,45 @@ export declare type MutualTlsSecuritySchemeJson = {
1635
2459
  export declare const MutualTlsSecuritySchemeSchema: GenMessage<MutualTlsSecurityScheme, {jsonType: MutualTlsSecuritySchemeJson}>;
1636
2460
 
1637
2461
  /**
2462
+ * The OAuth 2.0 flow supported by an `OAuth2SecurityScheme`, with its
2463
+ * configuration.
2464
+ *
1638
2465
  * @generated from message alis.open.agent.v2.OAuthFlows
1639
2466
  */
1640
2467
  export declare type OAuthFlows = Message$1<"alis.open.agent.v2.OAuthFlows"> & {
1641
2468
  /**
2469
+ * The OAuth 2.0 flow and its configuration.
2470
+ *
1642
2471
  * @generated from oneof alis.open.agent.v2.OAuthFlows.flow
1643
2472
  */
1644
2473
  flow: {
1645
2474
  /**
2475
+ * Configuration for the Authorization Code flow.
2476
+ *
1646
2477
  * @generated from field: alis.open.agent.v2.AuthorizationCodeOAuthFlow authorization_code = 1;
1647
2478
  */
1648
2479
  value: AuthorizationCodeOAuthFlow;
1649
2480
  case: "authorizationCode";
1650
2481
  } | {
1651
2482
  /**
2483
+ * Configuration for the Client Credentials flow.
2484
+ *
1652
2485
  * @generated from field: alis.open.agent.v2.ClientCredentialsOAuthFlow client_credentials = 2;
1653
2486
  */
1654
2487
  value: ClientCredentialsOAuthFlow;
1655
2488
  case: "clientCredentials";
1656
2489
  } | {
1657
2490
  /**
2491
+ * Configuration for the Implicit flow.
2492
+ *
1658
2493
  * @generated from field: alis.open.agent.v2.ImplicitOAuthFlow implicit = 3;
1659
2494
  */
1660
2495
  value: ImplicitOAuthFlow;
1661
2496
  case: "implicit";
1662
2497
  } | {
1663
2498
  /**
2499
+ * Configuration for the Resource Owner Password Credentials flow.
2500
+ *
1664
2501
  * @generated from field: alis.open.agent.v2.PasswordOAuthFlow password = 4;
1665
2502
  */
1666
2503
  value: PasswordOAuthFlow;
@@ -1669,25 +2506,36 @@ export declare type OAuthFlows = Message$1<"alis.open.agent.v2.OAuthFlows"> & {
1669
2506
  };
1670
2507
 
1671
2508
  /**
2509
+ * The OAuth 2.0 flow supported by an `OAuth2SecurityScheme`, with its
2510
+ * configuration.
2511
+ *
1672
2512
  * @generated from message alis.open.agent.v2.OAuthFlows
1673
2513
  */
1674
2514
  export declare type OAuthFlowsJson = {
1675
2515
  /**
2516
+ * Configuration for the Authorization Code flow.
2517
+ *
1676
2518
  * @generated from field: alis.open.agent.v2.AuthorizationCodeOAuthFlow authorization_code = 1;
1677
2519
  */
1678
2520
  authorizationCode?: AuthorizationCodeOAuthFlowJson;
1679
2521
 
1680
2522
  /**
2523
+ * Configuration for the Client Credentials flow.
2524
+ *
1681
2525
  * @generated from field: alis.open.agent.v2.ClientCredentialsOAuthFlow client_credentials = 2;
1682
2526
  */
1683
2527
  clientCredentials?: ClientCredentialsOAuthFlowJson;
1684
2528
 
1685
2529
  /**
2530
+ * Configuration for the Implicit flow.
2531
+ *
1686
2532
  * @generated from field: alis.open.agent.v2.ImplicitOAuthFlow implicit = 3;
1687
2533
  */
1688
2534
  implicit?: ImplicitOAuthFlowJson;
1689
2535
 
1690
2536
  /**
2537
+ * Configuration for the Resource Owner Password Credentials flow.
2538
+ *
1691
2539
  * @generated from field: alis.open.agent.v2.PasswordOAuthFlow password = 4;
1692
2540
  */
1693
2541
  password?: PasswordOAuthFlowJson;
@@ -1700,50 +2548,78 @@ export declare type OAuthFlowsJson = {
1700
2548
  export declare const OAuthFlowsSchema: GenMessage<OAuthFlows, {jsonType: OAuthFlowsJson}>;
1701
2549
 
1702
2550
  /**
2551
+ * Configuration for the OAuth 2.0 Authorization Code flow.
2552
+ *
1703
2553
  * @generated from message alis.open.agent.v2.AuthorizationCodeOAuthFlow
1704
2554
  */
1705
2555
  export declare type AuthorizationCodeOAuthFlow = Message$1<"alis.open.agent.v2.AuthorizationCodeOAuthFlow"> & {
1706
2556
  /**
2557
+ * The authorization URL to be used for this flow. This MUST be in the
2558
+ * form of a URL. The OAuth2 standard requires the use of TLS
2559
+ *
1707
2560
  * @generated from field: string authorization_url = 1;
1708
2561
  */
1709
2562
  authorizationUrl: string;
1710
2563
 
1711
2564
  /**
2565
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2566
+ * The OAuth2 standard requires the use of TLS.
2567
+ *
1712
2568
  * @generated from field: string token_url = 2;
1713
2569
  */
1714
2570
  tokenUrl: string;
1715
2571
 
1716
2572
  /**
2573
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2574
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2575
+ *
1717
2576
  * @generated from field: string refresh_url = 3;
1718
2577
  */
1719
2578
  refreshUrl: string;
1720
2579
 
1721
2580
  /**
2581
+ * The available scopes for the OAuth2 security scheme. A map between the
2582
+ * scope name and a short description for it. The map MAY be empty.
2583
+ *
1722
2584
  * @generated from field: map<string, string> scopes = 4;
1723
2585
  */
1724
2586
  scopes: { [key: string]: string };
1725
2587
  };
1726
2588
 
1727
2589
  /**
2590
+ * Configuration for the OAuth 2.0 Authorization Code flow.
2591
+ *
1728
2592
  * @generated from message alis.open.agent.v2.AuthorizationCodeOAuthFlow
1729
2593
  */
1730
2594
  export declare type AuthorizationCodeOAuthFlowJson = {
1731
2595
  /**
2596
+ * The authorization URL to be used for this flow. This MUST be in the
2597
+ * form of a URL. The OAuth2 standard requires the use of TLS
2598
+ *
1732
2599
  * @generated from field: string authorization_url = 1;
1733
2600
  */
1734
2601
  authorizationUrl?: string;
1735
2602
 
1736
2603
  /**
2604
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2605
+ * The OAuth2 standard requires the use of TLS.
2606
+ *
1737
2607
  * @generated from field: string token_url = 2;
1738
2608
  */
1739
2609
  tokenUrl?: string;
1740
2610
 
1741
2611
  /**
2612
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2613
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2614
+ *
1742
2615
  * @generated from field: string refresh_url = 3;
1743
2616
  */
1744
2617
  refreshUrl?: string;
1745
2618
 
1746
2619
  /**
2620
+ * The available scopes for the OAuth2 security scheme. A map between the
2621
+ * scope name and a short description for it. The map MAY be empty.
2622
+ *
1747
2623
  * @generated from field: map<string, string> scopes = 4;
1748
2624
  */
1749
2625
  scopes?: { [key: string]: string };
@@ -1756,40 +2632,62 @@ export declare type AuthorizationCodeOAuthFlowJson = {
1756
2632
  export declare const AuthorizationCodeOAuthFlowSchema: GenMessage<AuthorizationCodeOAuthFlow, {jsonType: AuthorizationCodeOAuthFlowJson}>;
1757
2633
 
1758
2634
  /**
2635
+ * Configuration for the OAuth 2.0 Client Credentials flow.
2636
+ *
1759
2637
  * @generated from message alis.open.agent.v2.ClientCredentialsOAuthFlow
1760
2638
  */
1761
2639
  export declare type ClientCredentialsOAuthFlow = Message$1<"alis.open.agent.v2.ClientCredentialsOAuthFlow"> & {
1762
2640
  /**
2641
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2642
+ * The OAuth2 standard requires the use of TLS.
2643
+ *
1763
2644
  * @generated from field: string token_url = 1;
1764
2645
  */
1765
2646
  tokenUrl: string;
1766
2647
 
1767
2648
  /**
2649
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2650
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2651
+ *
1768
2652
  * @generated from field: string refresh_url = 2;
1769
2653
  */
1770
2654
  refreshUrl: string;
1771
2655
 
1772
2656
  /**
2657
+ * The available scopes for the OAuth2 security scheme. A map between the
2658
+ * scope name and a short description for it. The map MAY be empty.
2659
+ *
1773
2660
  * @generated from field: map<string, string> scopes = 3;
1774
2661
  */
1775
2662
  scopes: { [key: string]: string };
1776
2663
  };
1777
2664
 
1778
2665
  /**
2666
+ * Configuration for the OAuth 2.0 Client Credentials flow.
2667
+ *
1779
2668
  * @generated from message alis.open.agent.v2.ClientCredentialsOAuthFlow
1780
2669
  */
1781
2670
  export declare type ClientCredentialsOAuthFlowJson = {
1782
2671
  /**
2672
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2673
+ * The OAuth2 standard requires the use of TLS.
2674
+ *
1783
2675
  * @generated from field: string token_url = 1;
1784
2676
  */
1785
2677
  tokenUrl?: string;
1786
2678
 
1787
2679
  /**
2680
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2681
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2682
+ *
1788
2683
  * @generated from field: string refresh_url = 2;
1789
2684
  */
1790
2685
  refreshUrl?: string;
1791
2686
 
1792
2687
  /**
2688
+ * The available scopes for the OAuth2 security scheme. A map between the
2689
+ * scope name and a short description for it. The map MAY be empty.
2690
+ *
1793
2691
  * @generated from field: map<string, string> scopes = 3;
1794
2692
  */
1795
2693
  scopes?: { [key: string]: string };
@@ -1802,40 +2700,62 @@ export declare type ClientCredentialsOAuthFlowJson = {
1802
2700
  export declare const ClientCredentialsOAuthFlowSchema: GenMessage<ClientCredentialsOAuthFlow, {jsonType: ClientCredentialsOAuthFlowJson}>;
1803
2701
 
1804
2702
  /**
2703
+ * Configuration for the OAuth 2.0 Implicit flow.
2704
+ *
1805
2705
  * @generated from message alis.open.agent.v2.ImplicitOAuthFlow
1806
2706
  */
1807
2707
  export declare type ImplicitOAuthFlow = Message$1<"alis.open.agent.v2.ImplicitOAuthFlow"> & {
1808
2708
  /**
2709
+ * The authorization URL to be used for this flow. This MUST be in the
2710
+ * form of a URL. The OAuth2 standard requires the use of TLS
2711
+ *
1809
2712
  * @generated from field: string authorization_url = 1;
1810
2713
  */
1811
2714
  authorizationUrl: string;
1812
2715
 
1813
2716
  /**
2717
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2718
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2719
+ *
1814
2720
  * @generated from field: string refresh_url = 2;
1815
2721
  */
1816
2722
  refreshUrl: string;
1817
2723
 
1818
2724
  /**
2725
+ * The available scopes for the OAuth2 security scheme. A map between the
2726
+ * scope name and a short description for it. The map MAY be empty.
2727
+ *
1819
2728
  * @generated from field: map<string, string> scopes = 3;
1820
2729
  */
1821
2730
  scopes: { [key: string]: string };
1822
2731
  };
1823
2732
 
1824
2733
  /**
2734
+ * Configuration for the OAuth 2.0 Implicit flow.
2735
+ *
1825
2736
  * @generated from message alis.open.agent.v2.ImplicitOAuthFlow
1826
2737
  */
1827
2738
  export declare type ImplicitOAuthFlowJson = {
1828
2739
  /**
2740
+ * The authorization URL to be used for this flow. This MUST be in the
2741
+ * form of a URL. The OAuth2 standard requires the use of TLS
2742
+ *
1829
2743
  * @generated from field: string authorization_url = 1;
1830
2744
  */
1831
2745
  authorizationUrl?: string;
1832
2746
 
1833
2747
  /**
2748
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2749
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2750
+ *
1834
2751
  * @generated from field: string refresh_url = 2;
1835
2752
  */
1836
2753
  refreshUrl?: string;
1837
2754
 
1838
2755
  /**
2756
+ * The available scopes for the OAuth2 security scheme. A map between the
2757
+ * scope name and a short description for it. The map MAY be empty.
2758
+ *
1839
2759
  * @generated from field: map<string, string> scopes = 3;
1840
2760
  */
1841
2761
  scopes?: { [key: string]: string };
@@ -1848,40 +2768,62 @@ export declare type ImplicitOAuthFlowJson = {
1848
2768
  export declare const ImplicitOAuthFlowSchema: GenMessage<ImplicitOAuthFlow, {jsonType: ImplicitOAuthFlowJson}>;
1849
2769
 
1850
2770
  /**
2771
+ * Configuration for the OAuth 2.0 Resource Owner Password Credentials flow.
2772
+ *
1851
2773
  * @generated from message alis.open.agent.v2.PasswordOAuthFlow
1852
2774
  */
1853
2775
  export declare type PasswordOAuthFlow = Message$1<"alis.open.agent.v2.PasswordOAuthFlow"> & {
1854
2776
  /**
2777
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2778
+ * The OAuth2 standard requires the use of TLS.
2779
+ *
1855
2780
  * @generated from field: string token_url = 1;
1856
2781
  */
1857
2782
  tokenUrl: string;
1858
2783
 
1859
2784
  /**
2785
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2786
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2787
+ *
1860
2788
  * @generated from field: string refresh_url = 2;
1861
2789
  */
1862
2790
  refreshUrl: string;
1863
2791
 
1864
2792
  /**
2793
+ * The available scopes for the OAuth2 security scheme. A map between the
2794
+ * scope name and a short description for it. The map MAY be empty.
2795
+ *
1865
2796
  * @generated from field: map<string, string> scopes = 3;
1866
2797
  */
1867
2798
  scopes: { [key: string]: string };
1868
2799
  };
1869
2800
 
1870
2801
  /**
2802
+ * Configuration for the OAuth 2.0 Resource Owner Password Credentials flow.
2803
+ *
1871
2804
  * @generated from message alis.open.agent.v2.PasswordOAuthFlow
1872
2805
  */
1873
2806
  export declare type PasswordOAuthFlowJson = {
1874
2807
  /**
2808
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
2809
+ * The OAuth2 standard requires the use of TLS.
2810
+ *
1875
2811
  * @generated from field: string token_url = 1;
1876
2812
  */
1877
2813
  tokenUrl?: string;
1878
2814
 
1879
2815
  /**
2816
+ * The URL to be used for obtaining refresh tokens. This MUST be in the
2817
+ * form of a URL. The OAuth2 standard requires the use of TLS.
2818
+ *
1880
2819
  * @generated from field: string refresh_url = 2;
1881
2820
  */
1882
2821
  refreshUrl?: string;
1883
2822
 
1884
2823
  /**
2824
+ * The available scopes for the OAuth2 security scheme. A map between the
2825
+ * scope name and a short description for it. The map MAY be empty.
2826
+ *
1885
2827
  * @generated from field: map<string, string> scopes = 3;
1886
2828
  */
1887
2829
  scopes?: { [key: string]: string };
@@ -1894,40 +2836,58 @@ export declare type PasswordOAuthFlowJson = {
1894
2836
  export declare const PasswordOAuthFlowSchema: GenMessage<PasswordOAuthFlow, {jsonType: PasswordOAuthFlowJson}>;
1895
2837
 
1896
2838
  /**
2839
+ * Represents a request for the `SendMessage` and `SendStreamingMessage`
2840
+ * methods.
2841
+ *
1897
2842
  * @generated from message alis.open.agent.v2.SendMessageRequest
1898
2843
  */
1899
2844
  export declare type SendMessageRequest = Message$1<"alis.open.agent.v2.SendMessageRequest"> & {
1900
2845
  /**
2846
+ * The message to send to the agent.
2847
+ *
1901
2848
  * @generated from field: alis.open.agent.v2.Message request = 1 [json_name = "message"];
1902
2849
  */
1903
2850
  request?: Message | undefined;
1904
2851
 
1905
2852
  /**
2853
+ * Configuration for the send request.
2854
+ *
1906
2855
  * @generated from field: alis.open.agent.v2.SendMessageConfiguration configuration = 2;
1907
2856
  */
1908
2857
  configuration?: SendMessageConfiguration | undefined;
1909
2858
 
1910
2859
  /**
2860
+ * Optional metadata for the request.
2861
+ *
1911
2862
  * @generated from field: google.protobuf.Struct metadata = 3;
1912
2863
  */
1913
2864
  metadata?: JsonObject | undefined;
1914
2865
  };
1915
2866
 
1916
2867
  /**
2868
+ * Represents a request for the `SendMessage` and `SendStreamingMessage`
2869
+ * methods.
2870
+ *
1917
2871
  * @generated from message alis.open.agent.v2.SendMessageRequest
1918
2872
  */
1919
2873
  export declare type SendMessageRequestJson = {
1920
2874
  /**
2875
+ * The message to send to the agent.
2876
+ *
1921
2877
  * @generated from field: alis.open.agent.v2.Message request = 1 [json_name = "message"];
1922
2878
  */
1923
2879
  message?: MessageJson;
1924
2880
 
1925
2881
  /**
2882
+ * Configuration for the send request.
2883
+ *
1926
2884
  * @generated from field: alis.open.agent.v2.SendMessageConfiguration configuration = 2;
1927
2885
  */
1928
2886
  configuration?: SendMessageConfigurationJson;
1929
2887
 
1930
2888
  /**
2889
+ * Optional metadata for the request.
2890
+ *
1931
2891
  * @generated from field: google.protobuf.Struct metadata = 3;
1932
2892
  */
1933
2893
  metadata?: StructJson;
@@ -1940,30 +2900,44 @@ export declare type SendMessageRequestJson = {
1940
2900
  export declare const SendMessageRequestSchema: GenMessage<SendMessageRequest, {jsonType: SendMessageRequestJson}>;
1941
2901
 
1942
2902
  /**
2903
+ * Represents a request for the `GetTask` method.
2904
+ *
1943
2905
  * @generated from message alis.open.agent.v2.GetTaskRequest
1944
2906
  */
1945
2907
  export declare type GetTaskRequest = Message$1<"alis.open.agent.v2.GetTaskRequest"> & {
1946
2908
  /**
2909
+ * The resource name of the task.
2910
+ * Format: tasks/{task_id}
2911
+ *
1947
2912
  * @generated from field: string name = 1;
1948
2913
  */
1949
2914
  name: string;
1950
2915
 
1951
2916
  /**
2917
+ * The number of most recent messages from the task's history to retrieve.
2918
+ *
1952
2919
  * @generated from field: int32 history_length = 2;
1953
2920
  */
1954
2921
  historyLength: number;
1955
2922
  };
1956
2923
 
1957
2924
  /**
2925
+ * Represents a request for the `GetTask` method.
2926
+ *
1958
2927
  * @generated from message alis.open.agent.v2.GetTaskRequest
1959
2928
  */
1960
2929
  export declare type GetTaskRequestJson = {
1961
2930
  /**
2931
+ * The resource name of the task.
2932
+ * Format: tasks/{task_id}
2933
+ *
1962
2934
  * @generated from field: string name = 1;
1963
2935
  */
1964
2936
  name?: string;
1965
2937
 
1966
2938
  /**
2939
+ * The number of most recent messages from the task's history to retrieve.
2940
+ *
1967
2941
  * @generated from field: int32 history_length = 2;
1968
2942
  */
1969
2943
  historyLength?: number;
@@ -1976,80 +2950,124 @@ export declare type GetTaskRequestJson = {
1976
2950
  export declare const GetTaskRequestSchema: GenMessage<GetTaskRequest, {jsonType: GetTaskRequestJson}>;
1977
2951
 
1978
2952
  /**
2953
+ * Represents a request for the `ListTasks` method.
2954
+ *
1979
2955
  * @generated from message alis.open.agent.v2.ListTasksRequest
1980
2956
  */
1981
2957
  export declare type ListTasksRequest = Message$1<"alis.open.agent.v2.ListTasksRequest"> & {
1982
2958
  /**
2959
+ * Filter tasks by context ID to get tasks from a specific conversation
2960
+ * or session.
2961
+ *
1983
2962
  * @generated from field: string context_id = 1;
1984
2963
  */
1985
2964
  contextId: string;
1986
2965
 
1987
2966
  /**
2967
+ * Filter tasks by their current status state.
2968
+ *
1988
2969
  * @generated from field: alis.open.agent.v2.TaskState status = 2;
1989
2970
  */
1990
2971
  status: TaskState;
1991
2972
 
1992
2973
  /**
2974
+ * Maximum number of tasks to return. Must be between 1 and 100.
2975
+ * Defaults to 50 if not specified.
2976
+ *
1993
2977
  * @generated from field: int32 page_size = 3;
1994
2978
  */
1995
2979
  pageSize: number;
1996
2980
 
1997
2981
  /**
2982
+ * Token for pagination. Use the next_page_token from a previous
2983
+ * ListTasksResponse.
2984
+ *
1998
2985
  * @generated from field: string page_token = 4;
1999
2986
  */
2000
2987
  pageToken: string;
2001
2988
 
2002
2989
  /**
2990
+ * Number of recent messages to include in each task's history.
2991
+ * Must be non-negative. Defaults to 0 if not specified.
2992
+ *
2003
2993
  * @generated from field: int32 history_length = 5;
2004
2994
  */
2005
2995
  historyLength: number;
2006
2996
 
2007
2997
  /**
2998
+ * Filter tasks updated after this timestamp. Only tasks with a last
2999
+ * updated time greater than or equal to this value will be returned.
3000
+ *
2008
3001
  * @generated from field: google.protobuf.Timestamp last_updated_time = 6;
2009
3002
  */
2010
3003
  lastUpdatedTime?: Timestamp | undefined;
2011
3004
 
2012
3005
  /**
3006
+ * Whether to include artifacts in the returned tasks.
3007
+ * Defaults to false to reduce payload size.
3008
+ *
2013
3009
  * @generated from field: bool include_artifacts = 7;
2014
3010
  */
2015
3011
  includeArtifacts: boolean;
2016
3012
  };
2017
3013
 
2018
3014
  /**
3015
+ * Represents a request for the `ListTasks` method.
3016
+ *
2019
3017
  * @generated from message alis.open.agent.v2.ListTasksRequest
2020
3018
  */
2021
3019
  export declare type ListTasksRequestJson = {
2022
3020
  /**
3021
+ * Filter tasks by context ID to get tasks from a specific conversation
3022
+ * or session.
3023
+ *
2023
3024
  * @generated from field: string context_id = 1;
2024
3025
  */
2025
3026
  contextId?: string;
2026
3027
 
2027
3028
  /**
3029
+ * Filter tasks by their current status state.
3030
+ *
2028
3031
  * @generated from field: alis.open.agent.v2.TaskState status = 2;
2029
3032
  */
2030
3033
  status?: TaskStateJson;
2031
3034
 
2032
3035
  /**
3036
+ * Maximum number of tasks to return. Must be between 1 and 100.
3037
+ * Defaults to 50 if not specified.
3038
+ *
2033
3039
  * @generated from field: int32 page_size = 3;
2034
3040
  */
2035
3041
  pageSize?: number;
2036
3042
 
2037
3043
  /**
3044
+ * Token for pagination. Use the next_page_token from a previous
3045
+ * ListTasksResponse.
3046
+ *
2038
3047
  * @generated from field: string page_token = 4;
2039
3048
  */
2040
3049
  pageToken?: string;
2041
3050
 
2042
3051
  /**
3052
+ * Number of recent messages to include in each task's history.
3053
+ * Must be non-negative. Defaults to 0 if not specified.
3054
+ *
2043
3055
  * @generated from field: int32 history_length = 5;
2044
3056
  */
2045
3057
  historyLength?: number;
2046
3058
 
2047
3059
  /**
3060
+ * Filter tasks updated after this timestamp. Only tasks with a last
3061
+ * updated time greater than or equal to this value will be returned.
3062
+ *
2048
3063
  * @generated from field: google.protobuf.Timestamp last_updated_time = 6;
2049
3064
  */
2050
3065
  lastUpdatedTime?: TimestampJson;
2051
3066
 
2052
3067
  /**
3068
+ * Whether to include artifacts in the returned tasks.
3069
+ * Defaults to false to reduce payload size.
3070
+ *
2053
3071
  * @generated from field: bool include_artifacts = 7;
2054
3072
  */
2055
3073
  includeArtifacts?: boolean;
@@ -2062,40 +3080,58 @@ export declare type ListTasksRequestJson = {
2062
3080
  export declare const ListTasksRequestSchema: GenMessage<ListTasksRequest, {jsonType: ListTasksRequestJson}>;
2063
3081
 
2064
3082
  /**
3083
+ * Represents the response for the `ListTasks` method.
3084
+ *
2065
3085
  * @generated from message alis.open.agent.v2.ListTasksResponse
2066
3086
  */
2067
3087
  export declare type ListTasksResponse = Message$1<"alis.open.agent.v2.ListTasksResponse"> & {
2068
3088
  /**
3089
+ * Array of tasks matching the specified criteria.
3090
+ *
2069
3091
  * @generated from field: repeated alis.open.agent.v2.Task tasks = 1;
2070
3092
  */
2071
3093
  tasks: Task[];
2072
3094
 
2073
3095
  /**
3096
+ * Token for retrieving the next page of results.
3097
+ * Empty string if no more results.
3098
+ *
2074
3099
  * @generated from field: string next_page_token = 2;
2075
3100
  */
2076
3101
  nextPageToken: string;
2077
3102
 
2078
3103
  /**
3104
+ * Total number of tasks available (before pagination).
3105
+ *
2079
3106
  * @generated from field: int32 total_size = 3;
2080
3107
  */
2081
3108
  totalSize: number;
2082
3109
  };
2083
3110
 
2084
3111
  /**
3112
+ * Represents the response for the `ListTasks` method.
3113
+ *
2085
3114
  * @generated from message alis.open.agent.v2.ListTasksResponse
2086
3115
  */
2087
3116
  export declare type ListTasksResponseJson = {
2088
3117
  /**
3118
+ * Array of tasks matching the specified criteria.
3119
+ *
2089
3120
  * @generated from field: repeated alis.open.agent.v2.Task tasks = 1;
2090
3121
  */
2091
3122
  tasks?: TaskJson[];
2092
3123
 
2093
3124
  /**
3125
+ * Token for retrieving the next page of results.
3126
+ * Empty string if no more results.
3127
+ *
2094
3128
  * @generated from field: string next_page_token = 2;
2095
3129
  */
2096
3130
  nextPageToken?: string;
2097
3131
 
2098
3132
  /**
3133
+ * Total number of tasks available (before pagination).
3134
+ *
2099
3135
  * @generated from field: int32 total_size = 3;
2100
3136
  */
2101
3137
  totalSize?: number;
@@ -2108,20 +3144,30 @@ export declare type ListTasksResponseJson = {
2108
3144
  export declare const ListTasksResponseSchema: GenMessage<ListTasksResponse, {jsonType: ListTasksResponseJson}>;
2109
3145
 
2110
3146
  /**
3147
+ * Represents a request for the `CancelTask` method.
3148
+ *
2111
3149
  * @generated from message alis.open.agent.v2.CancelTaskRequest
2112
3150
  */
2113
3151
  export declare type CancelTaskRequest = Message$1<"alis.open.agent.v2.CancelTaskRequest"> & {
2114
3152
  /**
3153
+ * The resource name of the task to cancel.
3154
+ * Format: tasks/{task_id}
3155
+ *
2115
3156
  * @generated from field: string name = 1;
2116
3157
  */
2117
3158
  name: string;
2118
3159
  };
2119
3160
 
2120
3161
  /**
3162
+ * Represents a request for the `CancelTask` method.
3163
+ *
2121
3164
  * @generated from message alis.open.agent.v2.CancelTaskRequest
2122
3165
  */
2123
3166
  export declare type CancelTaskRequestJson = {
2124
3167
  /**
3168
+ * The resource name of the task to cancel.
3169
+ * Format: tasks/{task_id}
3170
+ *
2125
3171
  * @generated from field: string name = 1;
2126
3172
  */
2127
3173
  name?: string;
@@ -2134,20 +3180,30 @@ export declare type CancelTaskRequestJson = {
2134
3180
  export declare const CancelTaskRequestSchema: GenMessage<CancelTaskRequest, {jsonType: CancelTaskRequestJson}>;
2135
3181
 
2136
3182
  /**
3183
+ * Represents a request for the `GetTaskPushNotificationConfig` method.
3184
+ *
2137
3185
  * @generated from message alis.open.agent.v2.GetTaskPushNotificationConfigRequest
2138
3186
  */
2139
3187
  export declare type GetTaskPushNotificationConfigRequest = Message$1<"alis.open.agent.v2.GetTaskPushNotificationConfigRequest"> & {
2140
3188
  /**
3189
+ * The resource name of the config to retrieve.
3190
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
3191
+ *
2141
3192
  * @generated from field: string name = 1;
2142
3193
  */
2143
3194
  name: string;
2144
3195
  };
2145
3196
 
2146
3197
  /**
3198
+ * Represents a request for the `GetTaskPushNotificationConfig` method.
3199
+ *
2147
3200
  * @generated from message alis.open.agent.v2.GetTaskPushNotificationConfigRequest
2148
3201
  */
2149
3202
  export declare type GetTaskPushNotificationConfigRequestJson = {
2150
3203
  /**
3204
+ * The resource name of the config to retrieve.
3205
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
3206
+ *
2151
3207
  * @generated from field: string name = 1;
2152
3208
  */
2153
3209
  name?: string;
@@ -2160,20 +3216,30 @@ export declare type GetTaskPushNotificationConfigRequestJson = {
2160
3216
  export declare const GetTaskPushNotificationConfigRequestSchema: GenMessage<GetTaskPushNotificationConfigRequest, {jsonType: GetTaskPushNotificationConfigRequestJson}>;
2161
3217
 
2162
3218
  /**
3219
+ * Represents a request for the `DeleteTaskPushNotificationConfig` method.
3220
+ *
2163
3221
  * @generated from message alis.open.agent.v2.DeleteTaskPushNotificationConfigRequest
2164
3222
  */
2165
3223
  export declare type DeleteTaskPushNotificationConfigRequest = Message$1<"alis.open.agent.v2.DeleteTaskPushNotificationConfigRequest"> & {
2166
3224
  /**
3225
+ * The resource name of the config to delete.
3226
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
3227
+ *
2167
3228
  * @generated from field: string name = 1;
2168
3229
  */
2169
3230
  name: string;
2170
3231
  };
2171
3232
 
2172
3233
  /**
3234
+ * Represents a request for the `DeleteTaskPushNotificationConfig` method.
3235
+ *
2173
3236
  * @generated from message alis.open.agent.v2.DeleteTaskPushNotificationConfigRequest
2174
3237
  */
2175
3238
  export declare type DeleteTaskPushNotificationConfigRequestJson = {
2176
3239
  /**
3240
+ * The resource name of the config to delete.
3241
+ * Format: tasks/{task_id}/pushNotificationConfigs/{config_id}
3242
+ *
2177
3243
  * @generated from field: string name = 1;
2178
3244
  */
2179
3245
  name?: string;
@@ -2186,40 +3252,58 @@ export declare type DeleteTaskPushNotificationConfigRequestJson = {
2186
3252
  export declare const DeleteTaskPushNotificationConfigRequestSchema: GenMessage<DeleteTaskPushNotificationConfigRequest, {jsonType: DeleteTaskPushNotificationConfigRequestJson}>;
2187
3253
 
2188
3254
  /**
3255
+ * Represents a request for the `CreateTaskPushNotificationConfig` method.
3256
+ *
2189
3257
  * @generated from message alis.open.agent.v2.CreateTaskPushNotificationConfigRequest
2190
3258
  */
2191
3259
  export declare type CreateTaskPushNotificationConfigRequest = Message$1<"alis.open.agent.v2.CreateTaskPushNotificationConfigRequest"> & {
2192
3260
  /**
3261
+ * The parent task resource for this config.
3262
+ * Format: tasks/{task_id}
3263
+ *
2193
3264
  * @generated from field: string parent = 1;
2194
3265
  */
2195
3266
  parent: string;
2196
3267
 
2197
3268
  /**
3269
+ * The ID for the new config.
3270
+ *
2198
3271
  * @generated from field: string config_id = 2;
2199
3272
  */
2200
3273
  configId: string;
2201
3274
 
2202
3275
  /**
3276
+ * The configuration to create.
3277
+ *
2203
3278
  * @generated from field: alis.open.agent.v2.TaskPushNotificationConfig config = 3;
2204
3279
  */
2205
3280
  config?: TaskPushNotificationConfig | undefined;
2206
3281
  };
2207
3282
 
2208
3283
  /**
3284
+ * Represents a request for the `CreateTaskPushNotificationConfig` method.
3285
+ *
2209
3286
  * @generated from message alis.open.agent.v2.CreateTaskPushNotificationConfigRequest
2210
3287
  */
2211
3288
  export declare type CreateTaskPushNotificationConfigRequestJson = {
2212
3289
  /**
3290
+ * The parent task resource for this config.
3291
+ * Format: tasks/{task_id}
3292
+ *
2213
3293
  * @generated from field: string parent = 1;
2214
3294
  */
2215
3295
  parent?: string;
2216
3296
 
2217
3297
  /**
3298
+ * The ID for the new config.
3299
+ *
2218
3300
  * @generated from field: string config_id = 2;
2219
3301
  */
2220
3302
  configId?: string;
2221
3303
 
2222
3304
  /**
3305
+ * The configuration to create.
3306
+ *
2223
3307
  * @generated from field: alis.open.agent.v2.TaskPushNotificationConfig config = 3;
2224
3308
  */
2225
3309
  config?: TaskPushNotificationConfigJson;
@@ -2232,20 +3316,30 @@ export declare type CreateTaskPushNotificationConfigRequestJson = {
2232
3316
  export declare const CreateTaskPushNotificationConfigRequestSchema: GenMessage<CreateTaskPushNotificationConfigRequest, {jsonType: CreateTaskPushNotificationConfigRequestJson}>;
2233
3317
 
2234
3318
  /**
3319
+ * Represents a request for the `TaskSubscription` method.
3320
+ *
2235
3321
  * @generated from message alis.open.agent.v2.TaskSubscriptionRequest
2236
3322
  */
2237
3323
  export declare type TaskSubscriptionRequest = Message$1<"alis.open.agent.v2.TaskSubscriptionRequest"> & {
2238
3324
  /**
3325
+ * The resource name of the task to subscribe to.
3326
+ * Format: tasks/{task_id}
3327
+ *
2239
3328
  * @generated from field: string name = 1;
2240
3329
  */
2241
3330
  name: string;
2242
3331
  };
2243
3332
 
2244
3333
  /**
3334
+ * Represents a request for the `TaskSubscription` method.
3335
+ *
2245
3336
  * @generated from message alis.open.agent.v2.TaskSubscriptionRequest
2246
3337
  */
2247
3338
  export declare type TaskSubscriptionRequestJson = {
2248
3339
  /**
3340
+ * The resource name of the task to subscribe to.
3341
+ * Format: tasks/{task_id}
3342
+ *
2249
3343
  * @generated from field: string name = 1;
2250
3344
  */
2251
3345
  name?: string;
@@ -2258,40 +3352,72 @@ export declare type TaskSubscriptionRequestJson = {
2258
3352
  export declare const TaskSubscriptionRequestSchema: GenMessage<TaskSubscriptionRequest, {jsonType: TaskSubscriptionRequestJson}>;
2259
3353
 
2260
3354
  /**
3355
+ * Represents a request for the `ListTaskPushNotificationConfig` method.
3356
+ *
2261
3357
  * @generated from message alis.open.agent.v2.ListTaskPushNotificationConfigRequest
2262
3358
  */
2263
3359
  export declare type ListTaskPushNotificationConfigRequest = Message$1<"alis.open.agent.v2.ListTaskPushNotificationConfigRequest"> & {
2264
3360
  /**
3361
+ * The parent task resource.
3362
+ * Format: tasks/{task_id}
3363
+ *
2265
3364
  * @generated from field: string parent = 1;
2266
3365
  */
2267
3366
  parent: string;
2268
3367
 
2269
3368
  /**
3369
+ * For AIP-158 these fields are present. Usually not used/needed.
3370
+ * The maximum number of configurations to return.
3371
+ * If unspecified, all configs will be returned.
3372
+ *
2270
3373
  * @generated from field: int32 page_size = 2;
2271
3374
  */
2272
3375
  pageSize: number;
2273
3376
 
2274
3377
  /**
3378
+ * A page token received from a previous
3379
+ * ListTaskPushNotificationConfigRequest call.
3380
+ * Provide this to retrieve the subsequent page.
3381
+ * When paginating, all other parameters provided to
3382
+ * `ListTaskPushNotificationConfigRequest` must match the call that provided
3383
+ * the page token.
3384
+ *
2275
3385
  * @generated from field: string page_token = 3;
2276
3386
  */
2277
3387
  pageToken: string;
2278
3388
  };
2279
3389
 
2280
3390
  /**
3391
+ * Represents a request for the `ListTaskPushNotificationConfig` method.
3392
+ *
2281
3393
  * @generated from message alis.open.agent.v2.ListTaskPushNotificationConfigRequest
2282
3394
  */
2283
3395
  export declare type ListTaskPushNotificationConfigRequestJson = {
2284
3396
  /**
3397
+ * The parent task resource.
3398
+ * Format: tasks/{task_id}
3399
+ *
2285
3400
  * @generated from field: string parent = 1;
2286
3401
  */
2287
3402
  parent?: string;
2288
3403
 
2289
3404
  /**
3405
+ * For AIP-158 these fields are present. Usually not used/needed.
3406
+ * The maximum number of configurations to return.
3407
+ * If unspecified, all configs will be returned.
3408
+ *
2290
3409
  * @generated from field: int32 page_size = 2;
2291
3410
  */
2292
3411
  pageSize?: number;
2293
3412
 
2294
3413
  /**
3414
+ * A page token received from a previous
3415
+ * ListTaskPushNotificationConfigRequest call.
3416
+ * Provide this to retrieve the subsequent page.
3417
+ * When paginating, all other parameters provided to
3418
+ * `ListTaskPushNotificationConfigRequest` must match the call that provided
3419
+ * the page token.
3420
+ *
2295
3421
  * @generated from field: string page_token = 3;
2296
3422
  */
2297
3423
  pageToken?: string;
@@ -2304,12 +3430,20 @@ export declare type ListTaskPushNotificationConfigRequestJson = {
2304
3430
  export declare const ListTaskPushNotificationConfigRequestSchema: GenMessage<ListTaskPushNotificationConfigRequest, {jsonType: ListTaskPushNotificationConfigRequestJson}>;
2305
3431
 
2306
3432
  /**
3433
+ * Represents a request for the `GetAgentCard` method.
3434
+ *
3435
+ * Empty. Added to fix linter violation.
3436
+ *
2307
3437
  * @generated from message alis.open.agent.v2.GetAgentCardRequest
2308
3438
  */
2309
3439
  export declare type GetAgentCardRequest = Message$1<"alis.open.agent.v2.GetAgentCardRequest"> & {
2310
3440
  };
2311
3441
 
2312
3442
  /**
3443
+ * Represents a request for the `GetAgentCard` method.
3444
+ *
3445
+ * Empty. Added to fix linter violation.
3446
+ *
2313
3447
  * @generated from message alis.open.agent.v2.GetAgentCardRequest
2314
3448
  */
2315
3449
  export declare type GetAgentCardRequestJson = {
@@ -2322,20 +3456,28 @@ export declare type GetAgentCardRequestJson = {
2322
3456
  export declare const GetAgentCardRequestSchema: GenMessage<GetAgentCardRequest, {jsonType: GetAgentCardRequestJson}>;
2323
3457
 
2324
3458
  /**
3459
+ * Represents the response for the `SendMessage` method.
3460
+ *
2325
3461
  * @generated from message alis.open.agent.v2.SendMessageResponse
2326
3462
  */
2327
3463
  export declare type SendMessageResponse = Message$1<"alis.open.agent.v2.SendMessageResponse"> & {
2328
3464
  /**
3465
+ * The result of the message: a task, or a direct reply from the agent.
3466
+ *
2329
3467
  * @generated from oneof alis.open.agent.v2.SendMessageResponse.payload
2330
3468
  */
2331
3469
  payload: {
2332
3470
  /**
3471
+ * The task created or updated by the message.
3472
+ *
2333
3473
  * @generated from field: alis.open.agent.v2.Task task = 1;
2334
3474
  */
2335
3475
  value: Task;
2336
3476
  case: "task";
2337
3477
  } | {
2338
3478
  /**
3479
+ * A message from the agent.
3480
+ *
2339
3481
  * @generated from field: alis.open.agent.v2.Message msg = 2 [json_name = "message"];
2340
3482
  */
2341
3483
  value: Message;
@@ -2344,15 +3486,21 @@ export declare type SendMessageResponse = Message$1<"alis.open.agent.v2.SendMess
2344
3486
  };
2345
3487
 
2346
3488
  /**
3489
+ * Represents the response for the `SendMessage` method.
3490
+ *
2347
3491
  * @generated from message alis.open.agent.v2.SendMessageResponse
2348
3492
  */
2349
3493
  export declare type SendMessageResponseJson = {
2350
3494
  /**
3495
+ * The task created or updated by the message.
3496
+ *
2351
3497
  * @generated from field: alis.open.agent.v2.Task task = 1;
2352
3498
  */
2353
3499
  task?: TaskJson;
2354
3500
 
2355
3501
  /**
3502
+ * A message from the agent.
3503
+ *
2356
3504
  * @generated from field: alis.open.agent.v2.Message msg = 2 [json_name = "message"];
2357
3505
  */
2358
3506
  message?: MessageJson;
@@ -2365,32 +3513,53 @@ export declare type SendMessageResponseJson = {
2365
3513
  export declare const SendMessageResponseSchema: GenMessage<SendMessageResponse, {jsonType: SendMessageResponseJson}>;
2366
3514
 
2367
3515
  /**
3516
+ * The stream response for a message. The stream should be one of the following
3517
+ * sequences:
3518
+ * If the response is a message, the stream should contain one, and only one,
3519
+ * message and then close
3520
+ * If the response is a task lifecycle, the first response should be a Task
3521
+ * object followed by zero or more TaskStatusUpdateEvents and
3522
+ * TaskArtifactUpdateEvents. The stream should complete when the Task
3523
+ * is in an interrupted or terminal state.
3524
+ *
2368
3525
  * @generated from message alis.open.agent.v2.StreamResponse
2369
3526
  */
2370
3527
  export declare type StreamResponse = Message$1<"alis.open.agent.v2.StreamResponse"> & {
2371
3528
  /**
3529
+ * One item in the stream.
3530
+ *
2372
3531
  * @generated from oneof alis.open.agent.v2.StreamResponse.payload
2373
3532
  */
2374
3533
  payload: {
2375
3534
  /**
3535
+ * The task and its current state. Sent first when the response is a task
3536
+ * lifecycle.
3537
+ *
2376
3538
  * @generated from field: alis.open.agent.v2.Task task = 1;
2377
3539
  */
2378
3540
  value: Task;
2379
3541
  case: "task";
2380
3542
  } | {
2381
3543
  /**
3544
+ * A message from the agent. When the response is a message, this is the
3545
+ * only item in the stream.
3546
+ *
2382
3547
  * @generated from field: alis.open.agent.v2.Message msg = 2 [json_name = "message"];
2383
3548
  */
2384
3549
  value: Message;
2385
3550
  case: "msg";
2386
3551
  } | {
2387
3552
  /**
3553
+ * An update to the task's status.
3554
+ *
2388
3555
  * @generated from field: alis.open.agent.v2.TaskStatusUpdateEvent status_update = 3;
2389
3556
  */
2390
3557
  value: TaskStatusUpdateEvent;
2391
3558
  case: "statusUpdate";
2392
3559
  } | {
2393
3560
  /**
3561
+ * An artifact generated or updated by the task.
3562
+ *
2394
3563
  * @generated from field: alis.open.agent.v2.TaskArtifactUpdateEvent artifact_update = 4;
2395
3564
  */
2396
3565
  value: TaskArtifactUpdateEvent;
@@ -2399,25 +3568,44 @@ export declare type StreamResponse = Message$1<"alis.open.agent.v2.StreamRespons
2399
3568
  };
2400
3569
 
2401
3570
  /**
3571
+ * The stream response for a message. The stream should be one of the following
3572
+ * sequences:
3573
+ * If the response is a message, the stream should contain one, and only one,
3574
+ * message and then close
3575
+ * If the response is a task lifecycle, the first response should be a Task
3576
+ * object followed by zero or more TaskStatusUpdateEvents and
3577
+ * TaskArtifactUpdateEvents. The stream should complete when the Task
3578
+ * is in an interrupted or terminal state.
3579
+ *
2402
3580
  * @generated from message alis.open.agent.v2.StreamResponse
2403
3581
  */
2404
3582
  export declare type StreamResponseJson = {
2405
3583
  /**
3584
+ * The task and its current state. Sent first when the response is a task
3585
+ * lifecycle.
3586
+ *
2406
3587
  * @generated from field: alis.open.agent.v2.Task task = 1;
2407
3588
  */
2408
3589
  task?: TaskJson;
2409
3590
 
2410
3591
  /**
3592
+ * A message from the agent. When the response is a message, this is the
3593
+ * only item in the stream.
3594
+ *
2411
3595
  * @generated from field: alis.open.agent.v2.Message msg = 2 [json_name = "message"];
2412
3596
  */
2413
3597
  message?: MessageJson;
2414
3598
 
2415
3599
  /**
3600
+ * An update to the task's status.
3601
+ *
2416
3602
  * @generated from field: alis.open.agent.v2.TaskStatusUpdateEvent status_update = 3;
2417
3603
  */
2418
3604
  statusUpdate?: TaskStatusUpdateEventJson;
2419
3605
 
2420
3606
  /**
3607
+ * An artifact generated or updated by the task.
3608
+ *
2421
3609
  * @generated from field: alis.open.agent.v2.TaskArtifactUpdateEvent artifact_update = 4;
2422
3610
  */
2423
3611
  artifactUpdate?: TaskArtifactUpdateEventJson;
@@ -2430,30 +3618,44 @@ export declare type StreamResponseJson = {
2430
3618
  export declare const StreamResponseSchema: GenMessage<StreamResponse, {jsonType: StreamResponseJson}>;
2431
3619
 
2432
3620
  /**
3621
+ * Represents the response for the `ListTaskPushNotificationConfig` method.
3622
+ *
2433
3623
  * @generated from message alis.open.agent.v2.ListTaskPushNotificationConfigResponse
2434
3624
  */
2435
3625
  export declare type ListTaskPushNotificationConfigResponse = Message$1<"alis.open.agent.v2.ListTaskPushNotificationConfigResponse"> & {
2436
3626
  /**
3627
+ * The list of push notification configurations.
3628
+ *
2437
3629
  * @generated from field: repeated alis.open.agent.v2.TaskPushNotificationConfig configs = 1;
2438
3630
  */
2439
3631
  configs: TaskPushNotificationConfig[];
2440
3632
 
2441
3633
  /**
3634
+ * A token, which can be sent as `page_token` to retrieve the next page.
3635
+ * If this field is omitted, there are no subsequent pages.
3636
+ *
2442
3637
  * @generated from field: string next_page_token = 2;
2443
3638
  */
2444
3639
  nextPageToken: string;
2445
3640
  };
2446
3641
 
2447
3642
  /**
3643
+ * Represents the response for the `ListTaskPushNotificationConfig` method.
3644
+ *
2448
3645
  * @generated from message alis.open.agent.v2.ListTaskPushNotificationConfigResponse
2449
3646
  */
2450
3647
  export declare type ListTaskPushNotificationConfigResponseJson = {
2451
3648
  /**
3649
+ * The list of push notification configurations.
3650
+ *
2452
3651
  * @generated from field: repeated alis.open.agent.v2.TaskPushNotificationConfig configs = 1;
2453
3652
  */
2454
3653
  configs?: TaskPushNotificationConfigJson[];
2455
3654
 
2456
3655
  /**
3656
+ * A token, which can be sent as `page_token` to retrieve the next page.
3657
+ * If this field is omitted, there are no subsequent pages.
3658
+ *
2457
3659
  * @generated from field: string next_page_token = 2;
2458
3660
  */
2459
3661
  nextPageToken?: string;
@@ -2466,56 +3668,84 @@ export declare type ListTaskPushNotificationConfigResponseJson = {
2466
3668
  export declare const ListTaskPushNotificationConfigResponseSchema: GenMessage<ListTaskPushNotificationConfigResponse, {jsonType: ListTaskPushNotificationConfigResponseJson}>;
2467
3669
 
2468
3670
  /**
3671
+ * The set of states a Task can be in.
3672
+ *
2469
3673
  * @generated from enum alis.open.agent.v2.TaskState
2470
3674
  */
2471
3675
  export enum TaskState {
2472
3676
  /**
3677
+ * The task state is unknown or has not been set.
3678
+ *
2473
3679
  * @generated from enum value: TASK_STATE_UNSPECIFIED = 0;
2474
3680
  */
2475
3681
  UNSPECIFIED = 0,
2476
3682
 
2477
3683
  /**
3684
+ * Represents the status that acknowledges a task is created
3685
+ *
2478
3686
  * @generated from enum value: TASK_STATE_SUBMITTED = 1;
2479
3687
  */
2480
3688
  SUBMITTED = 1,
2481
3689
 
2482
3690
  /**
3691
+ * Represents the status that a task is actively being processed
3692
+ *
2483
3693
  * @generated from enum value: TASK_STATE_WORKING = 2;
2484
3694
  */
2485
3695
  WORKING = 2,
2486
3696
 
2487
3697
  /**
3698
+ * Represents the status a task is finished. This is a terminal state
3699
+ *
2488
3700
  * @generated from enum value: TASK_STATE_COMPLETED = 3;
2489
3701
  */
2490
3702
  COMPLETED = 3,
2491
3703
 
2492
3704
  /**
3705
+ * Represents the status a task is done but failed. This is a terminal state
3706
+ *
2493
3707
  * @generated from enum value: TASK_STATE_FAILED = 4;
2494
3708
  */
2495
3709
  FAILED = 4,
2496
3710
 
2497
3711
  /**
3712
+ * Represents the status a task was cancelled before it finished.
3713
+ * This is a terminal state.
3714
+ *
2498
3715
  * @generated from enum value: TASK_STATE_CANCELLED = 5;
2499
3716
  */
2500
3717
  CANCELLED = 5,
2501
3718
 
2502
3719
  /**
3720
+ * Represents the status that the task requires information to complete.
3721
+ * This is an interrupted state.
3722
+ *
2503
3723
  * @generated from enum value: TASK_STATE_INPUT_REQUIRED = 6;
2504
3724
  */
2505
3725
  INPUT_REQUIRED = 6,
2506
3726
 
2507
3727
  /**
3728
+ * Represents the status that the agent has decided to not perform the task.
3729
+ * This may be done during initial task creation or later once an agent
3730
+ * has determined it can't or won't proceed. This is a terminal state.
3731
+ *
2508
3732
  * @generated from enum value: TASK_STATE_REJECTED = 7;
2509
3733
  */
2510
3734
  REJECTED = 7,
2511
3735
 
2512
3736
  /**
3737
+ * Represents the state that some authentication is needed from the upstream
3738
+ * client. Authentication is expected to come out-of-band thus this is not
3739
+ * an interrupted or terminal state.
3740
+ *
2513
3741
  * @generated from enum value: TASK_STATE_AUTH_REQUIRED = 8;
2514
3742
  */
2515
3743
  AUTH_REQUIRED = 8,
2516
3744
  }
2517
3745
 
2518
3746
  /**
3747
+ * The set of states a Task can be in.
3748
+ *
2519
3749
  * @generated from enum alis.open.agent.v2.TaskState
2520
3750
  */
2521
3751
  export declare type TaskStateJson = "TASK_STATE_UNSPECIFIED" | "TASK_STATE_SUBMITTED" | "TASK_STATE_WORKING" | "TASK_STATE_COMPLETED" | "TASK_STATE_FAILED" | "TASK_STATE_CANCELLED" | "TASK_STATE_INPUT_REQUIRED" | "TASK_STATE_REJECTED" | "TASK_STATE_AUTH_REQUIRED";
@@ -2526,26 +3756,36 @@ export declare type TaskStateJson = "TASK_STATE_UNSPECIFIED" | "TASK_STATE_SUBMI
2526
3756
  export declare const TaskStateSchema: GenEnum<TaskState, TaskStateJson>;
2527
3757
 
2528
3758
  /**
3759
+ * Identifies the sender of a message.
3760
+ *
2529
3761
  * @generated from enum alis.open.agent.v2.Role
2530
3762
  */
2531
3763
  export enum Role {
2532
3764
  /**
3765
+ * The sender role has not been set.
3766
+ *
2533
3767
  * @generated from enum value: ROLE_UNSPECIFIED = 0;
2534
3768
  */
2535
3769
  UNSPECIFIED = 0,
2536
3770
 
2537
3771
  /**
3772
+ * USER role refers to communication from the client to the server.
3773
+ *
2538
3774
  * @generated from enum value: ROLE_USER = 1;
2539
3775
  */
2540
3776
  USER = 1,
2541
3777
 
2542
3778
  /**
3779
+ * AGENT role refers to communication from the server to the client.
3780
+ *
2543
3781
  * @generated from enum value: ROLE_AGENT = 2;
2544
3782
  */
2545
3783
  AGENT = 2,
2546
3784
  }
2547
3785
 
2548
3786
  /**
3787
+ * Identifies the sender of a message.
3788
+ *
2549
3789
  * @generated from enum alis.open.agent.v2.Role
2550
3790
  */
2551
3791
  export declare type RoleJson = "ROLE_UNSPECIFIED" | "ROLE_USER" | "ROLE_AGENT";
@@ -2556,10 +3796,26 @@ export declare type RoleJson = "ROLE_UNSPECIFIED" | "ROLE_USER" | "ROLE_AGENT";
2556
3796
  export declare const RoleSchema: GenEnum<Role, RoleJson>;
2557
3797
 
2558
3798
  /**
3799
+ * A2AService defines the gRPC version of the A2A protocol. This has a slightly
3800
+ * different shape than the JSONRPC version to better conform to AIP-127,
3801
+ * where appropriate. The nouns are AgentCard, Message, Task and
3802
+ * TaskPushNotificationConfig.
3803
+ * - Messages are not a standard resource so there is no get/delete/update/list
3804
+ * interface, only a send and stream custom methods.
3805
+ * - Tasks have a get interface and custom cancel and subscribe methods.
3806
+ * - TaskPushNotificationConfig are a resource whose parent is a task.
3807
+ * They have get, list, create and delete methods.
3808
+ * - AgentCard is a static resource with only a get method.
3809
+ *
2559
3810
  * @generated from service alis.open.agent.v2.A2AService
2560
3811
  */
2561
3812
  export declare const A2AService: GenService<{
2562
3813
  /**
3814
+ * Send a message to the agent. The response is either a `Task` or a direct
3815
+ * `Message` from the agent. If `configuration.blocking` is true, the call
3816
+ * waits until the task is completed; otherwise the task is returned
3817
+ * immediately.
3818
+ *
2563
3819
  * @generated from rpc alis.open.agent.v2.A2AService.SendMessage
2564
3820
  */
2565
3821
  sendMessage: {
@@ -2568,6 +3824,9 @@ export declare const A2AService: GenService<{
2568
3824
  output: typeof SendMessageResponseSchema;
2569
3825
  },
2570
3826
  /**
3827
+ * SendStreamingMessage is a streaming call that will return a stream of
3828
+ * task update events until the Task is in an interrupted or terminal state.
3829
+ *
2571
3830
  * @generated from rpc alis.open.agent.v2.A2AService.SendStreamingMessage
2572
3831
  */
2573
3832
  sendStreamingMessage: {
@@ -2576,6 +3835,8 @@ export declare const A2AService: GenService<{
2576
3835
  output: typeof StreamResponseSchema;
2577
3836
  },
2578
3837
  /**
3838
+ * Get the current state of a task from the agent.
3839
+ *
2579
3840
  * @generated from rpc alis.open.agent.v2.A2AService.GetTask
2580
3841
  */
2581
3842
  getTask: {
@@ -2584,6 +3845,8 @@ export declare const A2AService: GenService<{
2584
3845
  output: typeof TaskSchema;
2585
3846
  },
2586
3847
  /**
3848
+ * List tasks with optional filtering and pagination.
3849
+ *
2587
3850
  * @generated from rpc alis.open.agent.v2.A2AService.ListTasks
2588
3851
  */
2589
3852
  listTasks: {
@@ -2592,6 +3855,9 @@ export declare const A2AService: GenService<{
2592
3855
  output: typeof ListTasksResponseSchema;
2593
3856
  },
2594
3857
  /**
3858
+ * Cancel a task from the agent. If supported one should expect no
3859
+ * more task updates for the task.
3860
+ *
2595
3861
  * @generated from rpc alis.open.agent.v2.A2AService.CancelTask
2596
3862
  */
2597
3863
  cancelTask: {
@@ -2600,6 +3866,11 @@ export declare const A2AService: GenService<{
2600
3866
  output: typeof TaskSchema;
2601
3867
  },
2602
3868
  /**
3869
+ * TaskSubscription is a streaming call that will return a stream of task
3870
+ * update events. This attaches the stream to an existing in process task.
3871
+ * If the task is complete the stream will return the completed task (like
3872
+ * GetTask) and close the stream.
3873
+ *
2603
3874
  * @generated from rpc alis.open.agent.v2.A2AService.TaskSubscription
2604
3875
  */
2605
3876
  taskSubscription: {
@@ -2608,6 +3879,8 @@ export declare const A2AService: GenService<{
2608
3879
  output: typeof StreamResponseSchema;
2609
3880
  },
2610
3881
  /**
3882
+ * Set a push notification config for a task.
3883
+ *
2611
3884
  * @generated from rpc alis.open.agent.v2.A2AService.CreateTaskPushNotificationConfig
2612
3885
  */
2613
3886
  createTaskPushNotificationConfig: {
@@ -2616,6 +3889,8 @@ export declare const A2AService: GenService<{
2616
3889
  output: typeof TaskPushNotificationConfigSchema;
2617
3890
  },
2618
3891
  /**
3892
+ * Get a push notification config for a task.
3893
+ *
2619
3894
  * @generated from rpc alis.open.agent.v2.A2AService.GetTaskPushNotificationConfig
2620
3895
  */
2621
3896
  getTaskPushNotificationConfig: {
@@ -2624,6 +3899,8 @@ export declare const A2AService: GenService<{
2624
3899
  output: typeof TaskPushNotificationConfigSchema;
2625
3900
  },
2626
3901
  /**
3902
+ * Get a list of push notifications configured for a task.
3903
+ *
2627
3904
  * @generated from rpc alis.open.agent.v2.A2AService.ListTaskPushNotificationConfig
2628
3905
  */
2629
3906
  listTaskPushNotificationConfig: {
@@ -2632,6 +3909,8 @@ export declare const A2AService: GenService<{
2632
3909
  output: typeof ListTaskPushNotificationConfigResponseSchema;
2633
3910
  },
2634
3911
  /**
3912
+ * GetAgentCard returns the agent card for the agent.
3913
+ *
2635
3914
  * @generated from rpc alis.open.agent.v2.A2AService.GetAgentCard
2636
3915
  */
2637
3916
  getAgentCard: {
@@ -2640,6 +3919,8 @@ export declare const A2AService: GenService<{
2640
3919
  output: typeof AgentCardSchema;
2641
3920
  },
2642
3921
  /**
3922
+ * Delete a push notification config for a task.
3923
+ *
2643
3924
  * @generated from rpc alis.open.agent.v2.A2AService.DeleteTaskPushNotificationConfig
2644
3925
  */
2645
3926
  deleteTaskPushNotificationConfig: {