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