@alis-build/lf-a2a-v1 1.9.0 → 1.11.0

package/lf/a2a/v1/a2a_pb.d.ts

@@ -1,4 +1,6 @@
-// @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js,json_types=true"
+// Older protoc compilers don't understand edition yet.
+
+// @generated by protoc-gen-es v2.16.0 with parameter "target=js+dts,import_extension=js,json_types=true"
 // @generated from file lf/a2a/v1/a2a.proto (package lf.a2a.v1, syntax proto3)
 /* eslint-disable */
 
@@ -12,50 +14,88 @@ import type { EmptySchema, StructJson, Timestamp, TimestampJson, Value, ValueJso
 export declare const file_lf_a2a_v1_a2a: GenFile;
 
 /**
+ * Configuration of a send message request.
+ *
  * @generated from message lf.a2a.v1.SendMessageConfiguration
  */
 export declare type SendMessageConfiguration = Message$1<"lf.a2a.v1.SendMessageConfiguration"> & {
   /**
+   * A list of media types the client is prepared to accept for response parts.
+   * Agents SHOULD use this to tailor their output.
+   *
    * @generated from field: repeated string accepted_output_modes = 1;
    */
   acceptedOutputModes: string[];
 
   /**
+   * Configuration for the agent to send push notifications for task updates.
+   * Task id should be empty when sending this configuration in a `SendMessage` request.
+   *
    * @generated from field: lf.a2a.v1.TaskPushNotificationConfig task_push_notification_config = 2;
    */
   taskPushNotificationConfig?: TaskPushNotificationConfig | undefined;
 
   /**
+   * The maximum number of most recent messages from the task's history to retrieve in
+   * the response. An unset value means the client does not impose any limit. A
+   * value of zero is a request to not include any messages. The server MUST NOT
+   * return more messages than the provided value, but MAY apply a lower limit.
+   *
    * @generated from field: optional int32 history_length = 3;
    */
   historyLength?: number | undefined;
 
   /**
+   * If `true`, the operation returns immediately after creating the task,
+   * even if processing is still in progress.
+   * If `false` (default), the operation MUST wait until the task reaches a
+   * terminal (`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or interrupted
+   * (`INPUT_REQUIRED`, `AUTH_REQUIRED`) state before returning.
+   *
    * @generated from field: bool return_immediately = 4;
    */
   returnImmediately: boolean;
 };
 
 /**
+ * Configuration of a send message request.
+ *
  * @generated from message lf.a2a.v1.SendMessageConfiguration
  */
 export declare type SendMessageConfigurationJson = {
   /**
+   * A list of media types the client is prepared to accept for response parts.
+   * Agents SHOULD use this to tailor their output.
+   *
    * @generated from field: repeated string accepted_output_modes = 1;
    */
   acceptedOutputModes?: string[];
 
   /**
+   * Configuration for the agent to send push notifications for task updates.
+   * Task id should be empty when sending this configuration in a `SendMessage` request.
+   *
    * @generated from field: lf.a2a.v1.TaskPushNotificationConfig task_push_notification_config = 2;
    */
   taskPushNotificationConfig?: TaskPushNotificationConfigJson;
 
   /**
+   * The maximum number of most recent messages from the task's history to retrieve in
+   * the response. An unset value means the client does not impose any limit. A
+   * value of zero is a request to not include any messages. The server MUST NOT
+   * return more messages than the provided value, but MAY apply a lower limit.
+   *
    * @generated from field: optional int32 history_length = 3;
    */
   historyLength?: number;
 
   /**
+   * If `true`, the operation returns immediately after creating the task,
+   * even if processing is still in progress.
+   * If `false` (default), the operation MUST wait until the task reaches a
+   * terminal (`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or interrupted
+   * (`INPUT_REQUIRED`, `AUTH_REQUIRED`) state before returning.
+   *
    * @generated from field: bool return_immediately = 4;
    */
   returnImmediately?: boolean;
@@ -68,70 +108,112 @@ export declare type SendMessageConfigurationJson = {
 export declare const SendMessageConfigurationSchema: GenMessage<SendMessageConfiguration, {jsonType: SendMessageConfigurationJson}>;
 
 /**
+ * `Task` is the core unit of action for A2A. It has a current status
+ * and when results are created for the task they are stored in the
+ * artifact. If there are multiple turns for a task, these are stored in
+ * history.
+ *
  * @generated from message lf.a2a.v1.Task
  */
 export declare type Task = Message$1<"lf.a2a.v1.Task"> & {
   /**
+   * Unique identifier (e.g. UUID) for the task, generated by the server for a
+   * new task.
+   *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
+   * Unique identifier (e.g. UUID) for the contextual collection of interactions
+   * (tasks and messages).
+   *
    * @generated from field: string context_id = 2;
    */
   contextId: string;
 
   /**
+   * The current status of a `Task`, including `state` and a `message`.
+   *
    * @generated from field: lf.a2a.v1.TaskStatus status = 3;
    */
   status?: TaskStatus | undefined;
 
   /**
+   * A set of output artifacts for a `Task`.
+   *
    * @generated from field: repeated lf.a2a.v1.Artifact artifacts = 4;
    */
   artifacts: Artifact[];
 
   /**
+   * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+   * The history of interactions from a `Task`.
+   *
    * @generated from field: repeated lf.a2a.v1.Message history = 5;
    */
   history: Message[];
 
   /**
+   * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+   * A key/value object to store custom metadata about a task.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: JsonObject | undefined;
 };
 
 /**
+ * `Task` is the core unit of action for A2A. It has a current status
+ * and when results are created for the task they are stored in the
+ * artifact. If there are multiple turns for a task, these are stored in
+ * history.
+ *
  * @generated from message lf.a2a.v1.Task
  */
 export declare type TaskJson = {
   /**
+   * Unique identifier (e.g. UUID) for the task, generated by the server for a
+   * new task.
+   *
    * @generated from field: string id = 1;
    */
   id?: string;
 
   /**
+   * Unique identifier (e.g. UUID) for the contextual collection of interactions
+   * (tasks and messages).
+   *
    * @generated from field: string context_id = 2;
    */
   contextId?: string;
 
   /**
+   * The current status of a `Task`, including `state` and a `message`.
+   *
    * @generated from field: lf.a2a.v1.TaskStatus status = 3;
    */
   status?: TaskStatusJson;
 
   /**
+   * A set of output artifacts for a `Task`.
+   *
    * @generated from field: repeated lf.a2a.v1.Artifact artifacts = 4;
    */
   artifacts?: ArtifactJson[];
 
   /**
+   * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+   * The history of interactions from a `Task`.
+   *
    * @generated from field: repeated lf.a2a.v1.Message history = 5;
    */
   history?: MessageJson[];
 
   /**
+   * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+   * A key/value object to store custom metadata about a task.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: StructJson;
@@ -144,40 +226,58 @@ export declare type TaskJson = {
 export declare const TaskSchema: GenMessage<Task, {jsonType: TaskJson}>;
 
 /**
+ * A container for the status of a task
+ *
  * @generated from message lf.a2a.v1.TaskStatus
  */
 export declare type TaskStatus = Message$1<"lf.a2a.v1.TaskStatus"> & {
   /**
+   * The current state of this task.
+   *
    * @generated from field: lf.a2a.v1.TaskState state = 1;
    */
   state: TaskState;
 
   /**
+   * A message associated with the status.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: Message | undefined;
 
   /**
+   * ISO 8601 Timestamp when the status was recorded.
+   * Example: "2023-10-27T10:00:00Z"
+   *
    * @generated from field: google.protobuf.Timestamp timestamp = 3;
    */
   timestamp?: Timestamp | undefined;
 };
 
 /**
+ * A container for the status of a task
+ *
  * @generated from message lf.a2a.v1.TaskStatus
  */
 export declare type TaskStatusJson = {
   /**
+   * The current state of this task.
+   *
    * @generated from field: lf.a2a.v1.TaskState state = 1;
    */
   state?: TaskStateJson;
 
   /**
+   * A message associated with the status.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: MessageJson;
 
   /**
+   * ISO 8601 Timestamp when the status was recorded.
+   * Example: "2023-10-27T10:00:00Z"
+   *
    * @generated from field: google.protobuf.Timestamp timestamp = 3;
    */
   timestamp?: TimestampJson;
@@ -190,6 +290,10 @@ export declare type TaskStatusJson = {
 export declare const TaskStatusSchema: GenMessage<TaskStatus, {jsonType: TaskStatusJson}>;
 
 /**
+ * `Part` represents a container for a section of communication content.
+ * Parts can be purely textual, some sort of file (image, video, etc) or
+ * a structured data blob (i.e. JSON).
+ *
  * @generated from message lf.a2a.v1.Part
  */
 export declare type Part = Message$1<"lf.a2a.v1.Part"> & {
@@ -198,24 +302,32 @@ export declare type Part = Message$1<"lf.a2a.v1.Part"> & {
    */
   content: {
     /**
+     * The string content of the `text` part.
+     *
      * @generated from field: string text = 1;
      */
     value: string;
     case: "text";
   } | {
     /**
+     * The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string.
+     *
      * @generated from field: bytes raw = 2;
      */
     value: Uint8Array;
     case: "raw";
   } | {
     /**
+     * A `url` pointing to the file's content.
+     *
      * @generated from field: string url = 3;
      */
     value: string;
     case: "url";
   } | {
     /**
+     * Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null).
+     *
      * @generated from field: google.protobuf.Value data = 4;
      */
     value: Value;
@@ -223,56 +335,82 @@ export declare type Part = Message$1<"lf.a2a.v1.Part"> & {
   } | { case: undefined; value?: undefined };
 
   /**
+   * Optional. metadata associated with this part.
+   *
    * @generated from field: google.protobuf.Struct metadata = 5;
    */
   metadata?: JsonObject | undefined;
 
   /**
+   * An optional `filename` for the file (e.g., "document.pdf").
+   *
    * @generated from field: string filename = 6;
    */
   filename: string;
 
   /**
+   * The `media_type` (MIME type) of the part content (e.g., "text/plain", "application/json", "image/png").
+   * This field is available for all part types.
+   *
    * @generated from field: string media_type = 7;
    */
   mediaType: string;
 };
 
 /**
+ * `Part` represents a container for a section of communication content.
+ * Parts can be purely textual, some sort of file (image, video, etc) or
+ * a structured data blob (i.e. JSON).
+ *
  * @generated from message lf.a2a.v1.Part
  */
 export declare type PartJson = {
   /**
+   * The string content of the `text` part.
+   *
    * @generated from field: string text = 1;
    */
   text?: string;
 
   /**
+   * The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string.
+   *
    * @generated from field: bytes raw = 2;
    */
   raw?: string;
 
   /**
+   * A `url` pointing to the file's content.
+   *
    * @generated from field: string url = 3;
    */
   url?: string;
 
   /**
+   * Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null).
+   *
    * @generated from field: google.protobuf.Value data = 4;
    */
   data?: ValueJson;
 
   /**
+   * Optional. metadata associated with this part.
+   *
    * @generated from field: google.protobuf.Struct metadata = 5;
    */
   metadata?: StructJson;
 
   /**
+   * An optional `filename` for the file (e.g., "document.pdf").
+   *
    * @generated from field: string filename = 6;
    */
   filename?: string;
 
   /**
+   * The `media_type` (MIME type) of the part content (e.g., "text/plain", "application/json", "image/png").
+   * This field is available for all part types.
+   *
    * @generated from field: string media_type = 7;
    */
   mediaType?: string;
@@ -285,90 +423,136 @@ export declare type PartJson = {
 export declare const PartSchema: GenMessage<Part, {jsonType: PartJson}>;
 
 /**
+ * `Message` is one unit of communication between client and server. It can be
+ * associated with a context and/or a task. For server messages, `context_id` must
+ * be provided, and `task_id` only if a task was created. For client messages, both
+ * fields are optional, with the caveat that if both are provided, they have to
+ * match (the `context_id` has to be the one that is set on the task). If only
+ * `task_id` is provided, the server will infer `context_id` from it.
+ *
  * @generated from message lf.a2a.v1.Message
  */
 export declare type Message = Message$1<"lf.a2a.v1.Message"> & {
   /**
+   * The unique identifier (e.g. UUID) of the message. This is created by the message creator.
+   *
    * @generated from field: string message_id = 1;
    */
   messageId: string;
 
   /**
+   * Optional. The context id of the message. If set, the message will be associated with the given context.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId: string;
 
   /**
+   * Optional. The task id of the message. If set, the message will be associated with the given task.
+   *
    * @generated from field: string task_id = 3;
    */
   taskId: string;
 
   /**
+   * Identifies the sender of the message.
+   *
    * @generated from field: lf.a2a.v1.Role role = 4;
    */
   role: Role;
 
   /**
+   * Parts is the container of the message content.
+   *
    * @generated from field: repeated lf.a2a.v1.Part parts = 5;
    */
   parts: Part[];
 
   /**
+   * Optional. Any metadata to provide along with the message.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: JsonObject | undefined;
 
   /**
+   * The URIs of extensions that are present or contributed to this Message.
+   *
    * @generated from field: repeated string extensions = 7;
    */
   extensions: string[];
 
   /**
+   * A list of task IDs that this message references for additional context.
+   *
    * @generated from field: repeated string reference_task_ids = 8;
    */
   referenceTaskIds: string[];
 };
 
 /**
+ * `Message` is one unit of communication between client and server. It can be
+ * associated with a context and/or a task. For server messages, `context_id` must
+ * be provided, and `task_id` only if a task was created. For client messages, both
+ * fields are optional, with the caveat that if both are provided, they have to
+ * match (the `context_id` has to be the one that is set on the task). If only
+ * `task_id` is provided, the server will infer `context_id` from it.
+ *
  * @generated from message lf.a2a.v1.Message
  */
 export declare type MessageJson = {
   /**
+   * The unique identifier (e.g. UUID) of the message. This is created by the message creator.
+   *
    * @generated from field: string message_id = 1;
    */
   messageId?: string;
 
   /**
+   * Optional. The context id of the message. If set, the message will be associated with the given context.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId?: string;
 
   /**
+   * Optional. The task id of the message. If set, the message will be associated with the given task.
+   *
    * @generated from field: string task_id = 3;
    */
   taskId?: string;
 
   /**
+   * Identifies the sender of the message.
+   *
    * @generated from field: lf.a2a.v1.Role role = 4;
    */
   role?: RoleJson;
 
   /**
+   * Parts is the container of the message content.
+   *
    * @generated from field: repeated lf.a2a.v1.Part parts = 5;
    */
   parts?: PartJson[];
 
   /**
+   * Optional. Any metadata to provide along with the message.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: StructJson;
 
   /**
+   * The URIs of extensions that are present or contributed to this Message.
+   *
    * @generated from field: repeated string extensions = 7;
    */
   extensions?: string[];
 
   /**
+   * A list of task IDs that this message references for additional context.
+   *
    * @generated from field: repeated string reference_task_ids = 8;
    */
   referenceTaskIds?: string[];
@@ -381,70 +565,98 @@ export declare type MessageJson = {
 export declare const MessageSchema: GenMessage<Message, {jsonType: MessageJson}>;
 
 /**
+ * Artifacts represent task outputs.
+ *
  * @generated from message lf.a2a.v1.Artifact
  */
 export declare type Artifact = Message$1<"lf.a2a.v1.Artifact"> & {
   /**
+   * Unique identifier (e.g. UUID) for the artifact. It must be unique within a task.
+   *
    * @generated from field: string artifact_id = 1;
    */
   artifactId: string;
 
   /**
+   * A human readable name for the artifact.
+   *
    * @generated from field: string name = 2;
    */
   name: string;
 
   /**
+   * Optional. A human readable description of the artifact.
+   *
    * @generated from field: string description = 3;
    */
   description: string;
 
   /**
+   * The content of the artifact. Must contain at least one part.
+   *
    * @generated from field: repeated lf.a2a.v1.Part parts = 4;
    */
   parts: Part[];
 
   /**
+   * Optional. Metadata included with the artifact.
+   *
    * @generated from field: google.protobuf.Struct metadata = 5;
    */
   metadata?: JsonObject | undefined;
 
   /**
+   * The URIs of extensions that are present or contributed to this Artifact.
+   *
    * @generated from field: repeated string extensions = 6;
    */
   extensions: string[];
 };
 
 /**
+ * Artifacts represent task outputs.
+ *
  * @generated from message lf.a2a.v1.Artifact
  */
 export declare type ArtifactJson = {
   /**
+   * Unique identifier (e.g. UUID) for the artifact. It must be unique within a task.
+   *
    * @generated from field: string artifact_id = 1;
    */
   artifactId?: string;
 
   /**
+   * A human readable name for the artifact.
+   *
    * @generated from field: string name = 2;
    */
   name?: string;
 
   /**
+   * Optional. A human readable description of the artifact.
+   *
    * @generated from field: string description = 3;
    */
   description?: string;
 
   /**
+   * The content of the artifact. Must contain at least one part.
+   *
    * @generated from field: repeated lf.a2a.v1.Part parts = 4;
    */
   parts?: PartJson[];
 
   /**
+   * Optional. Metadata included with the artifact.
+   *
    * @generated from field: google.protobuf.Struct metadata = 5;
    */
   metadata?: StructJson;
 
   /**
+   * The URIs of extensions that are present or contributed to this Artifact.
+   *
    * @generated from field: repeated string extensions = 6;
    */
   extensions?: string[];
@@ -457,50 +669,70 @@ export declare type ArtifactJson = {
 export declare const ArtifactSchema: GenMessage<Artifact, {jsonType: ArtifactJson}>;
 
 /**
+ * An event sent by the agent to notify the client of a change in a task's status.
+ *
  * @generated from message lf.a2a.v1.TaskStatusUpdateEvent
  */
 export declare type TaskStatusUpdateEvent = Message$1<"lf.a2a.v1.TaskStatusUpdateEvent"> & {
   /**
+   * The ID of the task that has changed.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId: string;
 
   /**
+   * The ID of the context that the task belongs to.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId: string;
 
   /**
+   * The new status of the task.
+   *
    * @generated from field: lf.a2a.v1.TaskStatus status = 3;
    */
   status?: TaskStatus | undefined;
 
   /**
+   * Optional. Metadata associated with the task update.
+   *
    * @generated from field: google.protobuf.Struct metadata = 4;
    */
   metadata?: JsonObject | undefined;
 };
 
 /**
+ * An event sent by the agent to notify the client of a change in a task's status.
+ *
  * @generated from message lf.a2a.v1.TaskStatusUpdateEvent
  */
 export declare type TaskStatusUpdateEventJson = {
   /**
+   * The ID of the task that has changed.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId?: string;
 
   /**
+   * The ID of the context that the task belongs to.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId?: string;
 
   /**
+   * The new status of the task.
+   *
    * @generated from field: lf.a2a.v1.TaskStatus status = 3;
    */
   status?: TaskStatusJson;
 
   /**
+   * Optional. Metadata associated with the task update.
+   *
    * @generated from field: google.protobuf.Struct metadata = 4;
    */
   metadata?: StructJson;
@@ -513,70 +745,100 @@ export declare type TaskStatusUpdateEventJson = {
 export declare const TaskStatusUpdateEventSchema: GenMessage<TaskStatusUpdateEvent, {jsonType: TaskStatusUpdateEventJson}>;
 
 /**
+ * A task delta where an artifact has been generated.
+ *
  * @generated from message lf.a2a.v1.TaskArtifactUpdateEvent
  */
 export declare type TaskArtifactUpdateEvent = Message$1<"lf.a2a.v1.TaskArtifactUpdateEvent"> & {
   /**
+   * The ID of the task for this artifact.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId: string;
 
   /**
+   * The ID of the context that this task belongs to.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId: string;
 
   /**
+   * The artifact that was generated or updated.
+   *
    * @generated from field: lf.a2a.v1.Artifact artifact = 3;
    */
   artifact?: Artifact | undefined;
 
   /**
+   * If true, the content of this artifact should be appended to a previously
+   * sent artifact with the same ID.
+   *
    * @generated from field: bool append = 4;
    */
   append: boolean;
 
   /**
+   * If true, this is the final chunk of the artifact.
+   *
    * @generated from field: bool last_chunk = 5;
    */
   lastChunk: boolean;
 
   /**
+   * Optional. Metadata associated with the artifact update.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: JsonObject | undefined;
 };
 
 /**
+ * A task delta where an artifact has been generated.
+ *
  * @generated from message lf.a2a.v1.TaskArtifactUpdateEvent
  */
 export declare type TaskArtifactUpdateEventJson = {
   /**
+   * The ID of the task for this artifact.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId?: string;
 
   /**
+   * The ID of the context that this task belongs to.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId?: string;
 
   /**
+   * The artifact that was generated or updated.
+   *
    * @generated from field: lf.a2a.v1.Artifact artifact = 3;
    */
   artifact?: ArtifactJson;
 
   /**
+   * If true, the content of this artifact should be appended to a previously
+   * sent artifact with the same ID.
+   *
    * @generated from field: bool append = 4;
    */
   append?: boolean;
 
   /**
+   * If true, this is the final chunk of the artifact.
+   *
    * @generated from field: bool last_chunk = 5;
    */
   lastChunk?: boolean;
 
   /**
+   * Optional. Metadata associated with the artifact update.
+   *
    * @generated from field: google.protobuf.Struct metadata = 6;
    */
   metadata?: StructJson;
@@ -589,30 +851,46 @@ export declare type TaskArtifactUpdateEventJson = {
 export declare const TaskArtifactUpdateEventSchema: GenMessage<TaskArtifactUpdateEvent, {jsonType: TaskArtifactUpdateEventJson}>;
 
 /**
+ * Defines authentication details, used for push notifications.
+ *
  * @generated from message lf.a2a.v1.AuthenticationInfo
  */
 export declare type AuthenticationInfo = Message$1<"lf.a2a.v1.AuthenticationInfo"> & {
   /**
+   * HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/).
+   * Examples: `Bearer`, `Basic`, `Digest`.
+   * Scheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1).
+   *
    * @generated from field: string scheme = 1;
    */
   scheme: string;
 
   /**
+   * Push Notification credentials. Format depends on the scheme (e.g., token for Bearer).
+   *
    * @generated from field: string credentials = 2;
    */
   credentials: string;
 };
 
 /**
+ * Defines authentication details, used for push notifications.
+ *
  * @generated from message lf.a2a.v1.AuthenticationInfo
  */
 export declare type AuthenticationInfoJson = {
   /**
+   * HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/).
+   * Examples: `Bearer`, `Basic`, `Digest`.
+   * Scheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1).
+   *
    * @generated from field: string scheme = 1;
    */
   scheme?: string;
 
   /**
+   * Push Notification credentials. Format depends on the scheme (e.g., token for Bearer).
+   *
    * @generated from field: string credentials = 2;
    */
   credentials?: string;
@@ -625,50 +903,82 @@ export declare type AuthenticationInfoJson = {
 export declare const AuthenticationInfoSchema: GenMessage<AuthenticationInfo, {jsonType: AuthenticationInfoJson}>;
 
 /**
+ * Declares a combination of a target URL, transport and protocol version for interacting with the agent.
+ * This allows agents to expose the same functionality over multiple protocol binding mechanisms.
+ *
  * @generated from message lf.a2a.v1.AgentInterface
  */
 export declare type AgentInterface = Message$1<"lf.a2a.v1.AgentInterface"> & {
   /**
+   * The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
+   * Example: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
+   *
    * @generated from field: string url = 1;
    */
   url: string;
 
   /**
+   * The protocol binding supported at this URL. This is an open form string, to be
+   * easily extended for other protocol bindings. The core ones officially
+   * supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.
+   *
    * @generated from field: string protocol_binding = 2;
    */
   protocolBinding: string;
 
   /**
+   * Tenant ID to be used in the request when calling the agent.
+   *
    * @generated from field: string tenant = 3;
    */
   tenant: string;
 
   /**
+   * The version of the A2A protocol this interface exposes.
+   * Use the latest supported minor version per major version.
+   * Examples: "0.3", "1.0"
+   *
    * @generated from field: string protocol_version = 4;
    */
   protocolVersion: string;
 };
 
 /**
+ * Declares a combination of a target URL, transport and protocol version for interacting with the agent.
+ * This allows agents to expose the same functionality over multiple protocol binding mechanisms.
+ *
  * @generated from message lf.a2a.v1.AgentInterface
  */
 export declare type AgentInterfaceJson = {
   /**
+   * The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
+   * Example: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
+   *
    * @generated from field: string url = 1;
    */
   url?: string;
 
   /**
+   * The protocol binding supported at this URL. This is an open form string, to be
+   * easily extended for other protocol bindings. The core ones officially
+   * supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.
+   *
    * @generated from field: string protocol_binding = 2;
    */
   protocolBinding?: string;
 
   /**
+   * Tenant ID to be used in the request when calling the agent.
+   *
    * @generated from field: string tenant = 3;
    */
   tenant?: string;
 
   /**
+   * The version of the A2A protocol this interface exposes.
+   * Use the latest supported minor version per major version.
+   * Examples: "0.3", "1.0"
+   *
    * @generated from field: string protocol_version = 4;
    */
   protocolVersion?: string;
@@ -681,150 +991,232 @@ export declare type AgentInterfaceJson = {
 export declare const AgentInterfaceSchema: GenMessage<AgentInterface, {jsonType: AgentInterfaceJson}>;
 
 /**
+ * A self-describing manifest for an agent. It provides essential
+ * metadata including the agent's identity, capabilities, skills, supported
+ * communication methods, and security requirements.
+ * Next ID: 20
+ *
  * @generated from message lf.a2a.v1.AgentCard
  */
 export declare type AgentCard = Message$1<"lf.a2a.v1.AgentCard"> & {
   /**
+   * A human readable name for the agent.
+   * Example: "Recipe Agent"
+   *
    * @generated from field: string name = 1;
    */
   name: string;
 
   /**
+   * A human-readable description of the agent, assisting users and other agents
+   * in understanding its purpose.
+   * Example: "Agent that helps users with recipes and cooking."
+   *
    * @generated from field: string description = 2;
    */
   description: string;
 
   /**
+   * Ordered list of supported interfaces. The first entry is preferred.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentInterface supported_interfaces = 3;
    */
   supportedInterfaces: AgentInterface[];
 
   /**
+   * The service provider of the agent.
+   *
    * @generated from field: lf.a2a.v1.AgentProvider provider = 4;
    */
   provider?: AgentProvider | undefined;
 
   /**
+   * The version of the agent.
+   * Example: "1.0.0"
+   *
    * @generated from field: string version = 5;
    */
   version: string;
 
   /**
+   * A URL providing additional documentation about the agent.
+   *
    * @generated from field: optional string documentation_url = 6;
    */
   documentationUrl?: string | undefined;
 
   /**
+   * A2A Capability set supported by the agent.
+   *
    * @generated from field: lf.a2a.v1.AgentCapabilities capabilities = 7;
    */
   capabilities?: AgentCapabilities | undefined;
 
   /**
+   * The security scheme details used for authenticating with this agent.
+   *
    * @generated from field: map<string, lf.a2a.v1.SecurityScheme> security_schemes = 8;
    */
   securitySchemes: { [key: string]: SecurityScheme };
 
   /**
+   * Security requirements for contacting the agent.
+   *
    * @generated from field: repeated lf.a2a.v1.SecurityRequirement security_requirements = 9;
    */
   securityRequirements: SecurityRequirement[];
 
   /**
+   * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+   * The set of interaction modes that the agent supports across all skills.
+   * This can be overridden per skill. Defined as media types.
+   *
    * @generated from field: repeated string default_input_modes = 10;
    */
   defaultInputModes: string[];
 
   /**
+   * The media types supported as outputs from this agent.
+   *
    * @generated from field: repeated string default_output_modes = 11;
    */
   defaultOutputModes: string[];
 
   /**
+   * Skills represent the abilities of an agent.
+   * It is largely a descriptive concept but represents a more focused set of behaviors that the
+   * agent is likely to succeed at.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentSkill skills = 12;
    */
   skills: AgentSkill[];
 
   /**
+   * JSON Web Signatures computed for this `AgentCard`.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentCardSignature signatures = 13;
    */
   signatures: AgentCardSignature[];
 
   /**
+   * Optional. A URL to an icon for the agent.
+   *
    * @generated from field: optional string icon_url = 14;
    */
   iconUrl?: string | undefined;
 };
 
 /**
+ * A self-describing manifest for an agent. It provides essential
+ * metadata including the agent's identity, capabilities, skills, supported
+ * communication methods, and security requirements.
+ * Next ID: 20
+ *
  * @generated from message lf.a2a.v1.AgentCard
  */
 export declare type AgentCardJson = {
   /**
+   * A human readable name for the agent.
+   * Example: "Recipe Agent"
+   *
    * @generated from field: string name = 1;
    */
   name?: string;
 
   /**
+   * A human-readable description of the agent, assisting users and other agents
+   * in understanding its purpose.
+   * Example: "Agent that helps users with recipes and cooking."
+   *
    * @generated from field: string description = 2;
    */
   description?: string;
 
   /**
+   * Ordered list of supported interfaces. The first entry is preferred.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentInterface supported_interfaces = 3;
    */
   supportedInterfaces?: AgentInterfaceJson[];
 
   /**
+   * The service provider of the agent.
+   *
    * @generated from field: lf.a2a.v1.AgentProvider provider = 4;
    */
   provider?: AgentProviderJson;
 
   /**
+   * The version of the agent.
+   * Example: "1.0.0"
+   *
    * @generated from field: string version = 5;
    */
   version?: string;
 
   /**
+   * A URL providing additional documentation about the agent.
+   *
    * @generated from field: optional string documentation_url = 6;
    */
   documentationUrl?: string;
 
   /**
+   * A2A Capability set supported by the agent.
+   *
    * @generated from field: lf.a2a.v1.AgentCapabilities capabilities = 7;
    */
   capabilities?: AgentCapabilitiesJson;
 
   /**
+   * The security scheme details used for authenticating with this agent.
+   *
    * @generated from field: map<string, lf.a2a.v1.SecurityScheme> security_schemes = 8;
    */
   securitySchemes?: { [key: string]: SecuritySchemeJson };
 
   /**
+   * Security requirements for contacting the agent.
+   *
    * @generated from field: repeated lf.a2a.v1.SecurityRequirement security_requirements = 9;
    */
   securityRequirements?: SecurityRequirementJson[];
 
   /**
+   * protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+   * The set of interaction modes that the agent supports across all skills.
+   * This can be overridden per skill. Defined as media types.
+   *
    * @generated from field: repeated string default_input_modes = 10;
    */
   defaultInputModes?: string[];
 
   /**
+   * The media types supported as outputs from this agent.
+   *
    * @generated from field: repeated string default_output_modes = 11;
    */
   defaultOutputModes?: string[];
 
   /**
+   * Skills represent the abilities of an agent.
+   * It is largely a descriptive concept but represents a more focused set of behaviors that the
+   * agent is likely to succeed at.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentSkill skills = 12;
    */
   skills?: AgentSkillJson[];
 
   /**
+   * JSON Web Signatures computed for this `AgentCard`.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentCardSignature signatures = 13;
    */
   signatures?: AgentCardSignatureJson[];
 
   /**
+   * Optional. A URL to an icon for the agent.
+   *
    * @generated from field: optional string icon_url = 14;
    */
   iconUrl?: string;
@@ -837,30 +1229,46 @@ export declare type AgentCardJson = {
 export declare const AgentCardSchema: GenMessage<AgentCard, {jsonType: AgentCardJson}>;
 
 /**
+ * Represents the service provider of an agent.
+ *
  * @generated from message lf.a2a.v1.AgentProvider
  */
 export declare type AgentProvider = Message$1<"lf.a2a.v1.AgentProvider"> & {
   /**
+   * A URL for the agent provider's website or relevant documentation.
+   * Example: "https://ai.google.dev"
+   *
    * @generated from field: string url = 1;
    */
   url: string;
 
   /**
+   * The name of the agent provider's organization.
+   * Example: "Google"
+   *
    * @generated from field: string organization = 2;
    */
   organization: string;
 };
 
 /**
+ * Represents the service provider of an agent.
+ *
  * @generated from message lf.a2a.v1.AgentProvider
  */
 export declare type AgentProviderJson = {
   /**
+   * A URL for the agent provider's website or relevant documentation.
+   * Example: "https://ai.google.dev"
+   *
    * @generated from field: string url = 1;
    */
   url?: string;
 
   /**
+   * The name of the agent provider's organization.
+   * Example: "Google"
+   *
    * @generated from field: string organization = 2;
    */
   organization?: string;
@@ -873,50 +1281,70 @@ export declare type AgentProviderJson = {
 export declare const AgentProviderSchema: GenMessage<AgentProvider, {jsonType: AgentProviderJson}>;
 
 /**
+ * Defines optional capabilities supported by an agent.
+ *
  * @generated from message lf.a2a.v1.AgentCapabilities
  */
 export declare type AgentCapabilities = Message$1<"lf.a2a.v1.AgentCapabilities"> & {
   /**
+   * Indicates if the agent supports streaming responses.
+   *
    * @generated from field: optional bool streaming = 1;
    */
   streaming?: boolean | undefined;
 
   /**
+   * Indicates if the agent supports sending push notifications for asynchronous task updates.
+   *
    * @generated from field: optional bool push_notifications = 2;
    */
   pushNotifications?: boolean | undefined;
 
   /**
+   * A list of protocol extensions supported by the agent.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentExtension extensions = 3;
    */
   extensions: AgentExtension[];
 
   /**
+   * Indicates if the agent supports providing an extended agent card when authenticated.
+   *
    * @generated from field: optional bool extended_agent_card = 4;
    */
   extendedAgentCard?: boolean | undefined;
 };
 
 /**
+ * Defines optional capabilities supported by an agent.
+ *
  * @generated from message lf.a2a.v1.AgentCapabilities
  */
 export declare type AgentCapabilitiesJson = {
   /**
+   * Indicates if the agent supports streaming responses.
+   *
    * @generated from field: optional bool streaming = 1;
    */
   streaming?: boolean;
 
   /**
+   * Indicates if the agent supports sending push notifications for asynchronous task updates.
+   *
    * @generated from field: optional bool push_notifications = 2;
    */
   pushNotifications?: boolean;
 
   /**
+   * A list of protocol extensions supported by the agent.
+   *
    * @generated from field: repeated lf.a2a.v1.AgentExtension extensions = 3;
    */
   extensions?: AgentExtensionJson[];
 
   /**
+   * Indicates if the agent supports providing an extended agent card when authenticated.
+   *
    * @generated from field: optional bool extended_agent_card = 4;
    */
   extendedAgentCard?: boolean;
@@ -929,50 +1357,70 @@ export declare type AgentCapabilitiesJson = {
 export declare const AgentCapabilitiesSchema: GenMessage<AgentCapabilities, {jsonType: AgentCapabilitiesJson}>;
 
 /**
+ * A declaration of a protocol extension supported by an Agent.
+ *
  * @generated from message lf.a2a.v1.AgentExtension
  */
 export declare type AgentExtension = Message$1<"lf.a2a.v1.AgentExtension"> & {
   /**
+   * The unique URI identifying the extension.
+   *
    * @generated from field: string uri = 1;
    */
   uri: string;
 
   /**
+   * A human-readable description of how this agent uses the extension.
+   *
    * @generated from field: string description = 2;
    */
   description: string;
 
   /**
+   * If true, the client must understand and comply with the extension's requirements.
+   *
    * @generated from field: bool required = 3;
    */
   required: boolean;
 
   /**
+   * Optional. Extension-specific configuration parameters.
+   *
    * @generated from field: google.protobuf.Struct params = 4;
    */
   params?: JsonObject | undefined;
 };
 
 /**
+ * A declaration of a protocol extension supported by an Agent.
+ *
  * @generated from message lf.a2a.v1.AgentExtension
  */
 export declare type AgentExtensionJson = {
   /**
+   * The unique URI identifying the extension.
+   *
    * @generated from field: string uri = 1;
    */
   uri?: string;
 
   /**
+   * A human-readable description of how this agent uses the extension.
+   *
    * @generated from field: string description = 2;
    */
   description?: string;
 
   /**
+   * If true, the client must understand and comply with the extension's requirements.
+   *
    * @generated from field: bool required = 3;
    */
   required?: boolean;
 
   /**
+   * Optional. Extension-specific configuration parameters.
+   *
    * @generated from field: google.protobuf.Struct params = 4;
    */
   params?: StructJson;
@@ -985,90 +1433,126 @@ export declare type AgentExtensionJson = {
 export declare const AgentExtensionSchema: GenMessage<AgentExtension, {jsonType: AgentExtensionJson}>;
 
 /**
+ * Represents a distinct capability or function that an agent can perform.
+ *
  * @generated from message lf.a2a.v1.AgentSkill
  */
 export declare type AgentSkill = Message$1<"lf.a2a.v1.AgentSkill"> & {
   /**
+   * A unique identifier for the agent's skill.
+   *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
+   * A human-readable name for the skill.
+   *
    * @generated from field: string name = 2;
    */
   name: string;
 
   /**
+   * A detailed description of the skill.
+   *
    * @generated from field: string description = 3;
    */
   description: string;
 
   /**
+   * A set of keywords describing the skill's capabilities.
+   *
    * @generated from field: repeated string tags = 4;
    */
   tags: string[];
 
   /**
+   * Example prompts or scenarios that this skill can handle.
+   *
    * @generated from field: repeated string examples = 5;
    */
   examples: string[];
 
   /**
+   * The set of supported input media types for this skill, overriding the agent's defaults.
+   *
    * @generated from field: repeated string input_modes = 6;
    */
   inputModes: string[];
 
   /**
+   * The set of supported output media types for this skill, overriding the agent's defaults.
+   *
    * @generated from field: repeated string output_modes = 7;
    */
   outputModes: string[];
 
   /**
+   * Security schemes necessary for this skill.
+   *
    * @generated from field: repeated lf.a2a.v1.SecurityRequirement security_requirements = 8;
    */
   securityRequirements: SecurityRequirement[];
 };
 
 /**
+ * Represents a distinct capability or function that an agent can perform.
+ *
  * @generated from message lf.a2a.v1.AgentSkill
  */
 export declare type AgentSkillJson = {
   /**
+   * A unique identifier for the agent's skill.
+   *
    * @generated from field: string id = 1;
    */
   id?: string;
 
   /**
+   * A human-readable name for the skill.
+   *
    * @generated from field: string name = 2;
    */
   name?: string;
 
   /**
+   * A detailed description of the skill.
+   *
    * @generated from field: string description = 3;
    */
   description?: string;
 
   /**
+   * A set of keywords describing the skill's capabilities.
+   *
    * @generated from field: repeated string tags = 4;
    */
   tags?: string[];
 
   /**
+   * Example prompts or scenarios that this skill can handle.
+   *
    * @generated from field: repeated string examples = 5;
    */
   examples?: string[];
 
   /**
+   * The set of supported input media types for this skill, overriding the agent's defaults.
+   *
    * @generated from field: repeated string input_modes = 6;
    */
   inputModes?: string[];
 
   /**
+   * The set of supported output media types for this skill, overriding the agent's defaults.
+   *
    * @generated from field: repeated string output_modes = 7;
    */
   outputModes?: string[];
 
   /**
+   * Security schemes necessary for this skill.
+   *
    * @generated from field: repeated lf.a2a.v1.SecurityRequirement security_requirements = 8;
    */
   securityRequirements?: SecurityRequirementJson[];
@@ -1081,40 +1565,64 @@ export declare type AgentSkillJson = {
 export declare const AgentSkillSchema: GenMessage<AgentSkill, {jsonType: AgentSkillJson}>;
 
 /**
+ * AgentCardSignature represents a JWS signature of an AgentCard.
+ * This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
+ *
  * @generated from message lf.a2a.v1.AgentCardSignature
  */
 export declare type AgentCardSignature = Message$1<"lf.a2a.v1.AgentCardSignature"> & {
   /**
+   * (-- api-linter: core::0140::reserved-words=disabled
+   *     aip.dev/not-precedent: Backwards compatibility --)
+   * Required. The protected JWS header for the signature. This is always a
+   * base64url-encoded JSON object.
+   *
    * @generated from field: string protected = 1;
    */
   protected: string;
 
   /**
+   * Required. The computed signature, base64url-encoded.
+   *
    * @generated from field: string signature = 2;
    */
   signature: string;
 
   /**
+   * The unprotected JWS header values.
+   *
    * @generated from field: google.protobuf.Struct header = 3;
    */
   header?: JsonObject | undefined;
 };
 
 /**
+ * AgentCardSignature represents a JWS signature of an AgentCard.
+ * This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
+ *
  * @generated from message lf.a2a.v1.AgentCardSignature
  */
 export declare type AgentCardSignatureJson = {
   /**
+   * (-- api-linter: core::0140::reserved-words=disabled
+   *     aip.dev/not-precedent: Backwards compatibility --)
+   * Required. The protected JWS header for the signature. This is always a
+   * base64url-encoded JSON object.
+   *
    * @generated from field: string protected = 1;
    */
   protected?: string;
 
   /**
+   * Required. The computed signature, base64url-encoded.
+   *
    * @generated from field: string signature = 2;
    */
   signature?: string;
 
   /**
+   * The unprotected JWS header values.
+   *
    * @generated from field: google.protobuf.Struct header = 3;
    */
   header?: StructJson;
@@ -1127,70 +1635,100 @@ export declare type AgentCardSignatureJson = {
 export declare const AgentCardSignatureSchema: GenMessage<AgentCardSignature, {jsonType: AgentCardSignatureJson}>;
 
 /**
+ * A container associating a push notification configuration with a specific task.
+ *
  * @generated from message lf.a2a.v1.TaskPushNotificationConfig
  */
 export declare type TaskPushNotificationConfig = Message$1<"lf.a2a.v1.TaskPushNotificationConfig"> & {
   /**
+   * Optional. Tenant ID.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The push notification configuration details.
+   * A unique identifier (e.g. UUID) for this push notification configuration.
+   *
    * @generated from field: string id = 2;
    */
   id: string;
 
   /**
+   * The ID of the task this configuration is associated with.
+   *
    * @generated from field: string task_id = 3;
    */
   taskId: string;
 
   /**
+   * The URL where the notification should be sent.
+   *
    * @generated from field: string url = 4;
    */
   url: string;
 
   /**
+   * A token unique for this task or session.
+   *
    * @generated from field: string token = 5;
    */
   token: string;
 
   /**
+   * Authentication information required to send the notification.
+   *
    * @generated from field: lf.a2a.v1.AuthenticationInfo authentication = 6;
    */
   authentication?: AuthenticationInfo | undefined;
 };
 
 /**
+ * A container associating a push notification configuration with a specific task.
+ *
  * @generated from message lf.a2a.v1.TaskPushNotificationConfig
  */
 export declare type TaskPushNotificationConfigJson = {
   /**
+   * Optional. Tenant ID.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The push notification configuration details.
+   * A unique identifier (e.g. UUID) for this push notification configuration.
+   *
    * @generated from field: string id = 2;
    */
   id?: string;
 
   /**
+   * The ID of the task this configuration is associated with.
+   *
    * @generated from field: string task_id = 3;
    */
   taskId?: string;
 
   /**
+   * The URL where the notification should be sent.
+   *
    * @generated from field: string url = 4;
    */
   url?: string;
 
   /**
+   * A token unique for this task or session.
+   *
    * @generated from field: string token = 5;
    */
   token?: string;
 
   /**
+   * Authentication information required to send the notification.
+   *
    * @generated from field: lf.a2a.v1.AuthenticationInfo authentication = 6;
    */
   authentication?: AuthenticationInfoJson;
@@ -1203,20 +1741,30 @@ export declare type TaskPushNotificationConfigJson = {
 export declare const TaskPushNotificationConfigSchema: GenMessage<TaskPushNotificationConfig, {jsonType: TaskPushNotificationConfigJson}>;
 
 /**
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+ * A list of strings.
+ *
  * @generated from message lf.a2a.v1.StringList
  */
 export declare type StringList = Message$1<"lf.a2a.v1.StringList"> & {
   /**
+   * The individual string values.
+   *
    * @generated from field: repeated string list = 1;
    */
   list: string[];
 };
 
 /**
+ * protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+ * A list of strings.
+ *
  * @generated from message lf.a2a.v1.StringList
  */
 export declare type StringListJson = {
   /**
+   * The individual string values.
+   *
    * @generated from field: repeated string list = 1;
    */
   list?: string[];
@@ -1229,20 +1777,28 @@ export declare type StringListJson = {
 export declare const StringListSchema: GenMessage<StringList, {jsonType: StringListJson}>;
 
 /**
+ * Defines the security requirements for an agent.
+ *
  * @generated from message lf.a2a.v1.SecurityRequirement
  */
 export declare type SecurityRequirement = Message$1<"lf.a2a.v1.SecurityRequirement"> & {
   /**
+   * A map of security schemes to the required scopes.
+   *
    * @generated from field: map<string, lf.a2a.v1.StringList> schemes = 1;
    */
   schemes: { [key: string]: StringList };
 };
 
 /**
+ * Defines the security requirements for an agent.
+ *
  * @generated from message lf.a2a.v1.SecurityRequirement
  */
 export declare type SecurityRequirementJson = {
   /**
+   * A map of security schemes to the required scopes.
+   *
    * @generated from field: map<string, lf.a2a.v1.StringList> schemes = 1;
    */
   schemes?: { [key: string]: StringListJson };
@@ -1255,6 +1811,10 @@ export declare type SecurityRequirementJson = {
 export declare const SecurityRequirementSchema: GenMessage<SecurityRequirement, {jsonType: SecurityRequirementJson}>;
 
 /**
+ * Defines a security scheme that can be used to secure an agent's endpoints.
+ * This is a discriminated union type based on the OpenAPI 3.2 Security Scheme Object.
+ * See: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object
+ *
  * @generated from message lf.a2a.v1.SecurityScheme
  */
 export declare type SecurityScheme = Message$1<"lf.a2a.v1.SecurityScheme"> & {
@@ -1263,30 +1823,40 @@ export declare type SecurityScheme = Message$1<"lf.a2a.v1.SecurityScheme"> & {
    */
   scheme: {
     /**
+     * API key-based authentication.
+     *
      * @generated from field: lf.a2a.v1.APIKeySecurityScheme api_key_security_scheme = 1;
      */
     value: APIKeySecurityScheme;
     case: "apiKeySecurityScheme";
   } | {
     /**
+     * HTTP authentication (Basic, Bearer, etc.).
+     *
      * @generated from field: lf.a2a.v1.HTTPAuthSecurityScheme http_auth_security_scheme = 2;
      */
     value: HTTPAuthSecurityScheme;
     case: "httpAuthSecurityScheme";
   } | {
     /**
+     * OAuth 2.0 authentication.
+     *
      * @generated from field: lf.a2a.v1.OAuth2SecurityScheme oauth2_security_scheme = 3;
      */
     value: OAuth2SecurityScheme;
     case: "oauth2SecurityScheme";
   } | {
     /**
+     * OpenID Connect authentication.
+     *
      * @generated from field: lf.a2a.v1.OpenIdConnectSecurityScheme open_id_connect_security_scheme = 4;
      */
     value: OpenIdConnectSecurityScheme;
     case: "openIdConnectSecurityScheme";
   } | {
     /**
+     * Mutual TLS authentication.
+     *
      * @generated from field: lf.a2a.v1.MutualTlsSecurityScheme mtls_security_scheme = 5;
      */
     value: MutualTlsSecurityScheme;
@@ -1295,30 +1865,44 @@ export declare type SecurityScheme = Message$1<"lf.a2a.v1.SecurityScheme"> & {
 };
 
 /**
+ * Defines a security scheme that can be used to secure an agent's endpoints.
+ * This is a discriminated union type based on the OpenAPI 3.2 Security Scheme Object.
+ * See: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object
+ *
  * @generated from message lf.a2a.v1.SecurityScheme
  */
 export declare type SecuritySchemeJson = {
   /**
+   * API key-based authentication.
+   *
    * @generated from field: lf.a2a.v1.APIKeySecurityScheme api_key_security_scheme = 1;
    */
   apiKeySecurityScheme?: APIKeySecuritySchemeJson;
 
   /**
+   * HTTP authentication (Basic, Bearer, etc.).
+   *
    * @generated from field: lf.a2a.v1.HTTPAuthSecurityScheme http_auth_security_scheme = 2;
    */
   httpAuthSecurityScheme?: HTTPAuthSecuritySchemeJson;
 
   /**
+   * OAuth 2.0 authentication.
+   *
    * @generated from field: lf.a2a.v1.OAuth2SecurityScheme oauth2_security_scheme = 3;
    */
   oauth2SecurityScheme?: OAuth2SecuritySchemeJson;
 
   /**
+   * OpenID Connect authentication.
+   *
    * @generated from field: lf.a2a.v1.OpenIdConnectSecurityScheme open_id_connect_security_scheme = 4;
    */
   openIdConnectSecurityScheme?: OpenIdConnectSecuritySchemeJson;
 
   /**
+   * Mutual TLS authentication.
+   *
    * @generated from field: lf.a2a.v1.MutualTlsSecurityScheme mtls_security_scheme = 5;
    */
   mtlsSecurityScheme?: MutualTlsSecuritySchemeJson;
@@ -1331,40 +1915,56 @@ export declare type SecuritySchemeJson = {
 export declare const SecuritySchemeSchema: GenMessage<SecurityScheme, {jsonType: SecuritySchemeJson}>;
 
 /**
+ * Defines a security scheme using an API key.
+ *
  * @generated from message lf.a2a.v1.APIKeySecurityScheme
  */
 export declare type APIKeySecurityScheme = Message$1<"lf.a2a.v1.APIKeySecurityScheme"> & {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description: string;
 
   /**
+   * The location of the API key. Valid values are "query", "header", or "cookie".
+   *
    * @generated from field: string location = 2;
    */
   location: string;
 
   /**
+   * The name of the header, query, or cookie parameter to be used.
+   *
    * @generated from field: string name = 3;
    */
   name: string;
 };
 
 /**
+ * Defines a security scheme using an API key.
+ *
  * @generated from message lf.a2a.v1.APIKeySecurityScheme
  */
 export declare type APIKeySecuritySchemeJson = {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description?: string;
 
   /**
+   * The location of the API key. Valid values are "query", "header", or "cookie".
+   *
    * @generated from field: string location = 2;
    */
   location?: string;
 
   /**
+   * The name of the header, query, or cookie parameter to be used.
+   *
    * @generated from field: string name = 3;
    */
   name?: string;
@@ -1377,40 +1977,62 @@ export declare type APIKeySecuritySchemeJson = {
 export declare const APIKeySecuritySchemeSchema: GenMessage<APIKeySecurityScheme, {jsonType: APIKeySecuritySchemeJson}>;
 
 /**
+ * Defines a security scheme using HTTP authentication.
+ *
  * @generated from message lf.a2a.v1.HTTPAuthSecurityScheme
  */
 export declare type HTTPAuthSecurityScheme = Message$1<"lf.a2a.v1.HTTPAuthSecurityScheme"> & {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description: string;
 
   /**
+   * The name of the HTTP Authentication scheme to be used in the Authorization header,
+   * as defined in RFC7235 (e.g., "Bearer").
+   * This value should be registered in the IANA Authentication Scheme registry.
+   *
    * @generated from field: string scheme = 2;
    */
   scheme: string;
 
   /**
+   * A hint to the client to identify how the bearer token is formatted (e.g., "JWT").
+   * Primarily for documentation purposes.
+   *
    * @generated from field: string bearer_format = 3;
    */
   bearerFormat: string;
 };
 
 /**
+ * Defines a security scheme using HTTP authentication.
+ *
  * @generated from message lf.a2a.v1.HTTPAuthSecurityScheme
  */
 export declare type HTTPAuthSecuritySchemeJson = {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description?: string;
 
   /**
+   * The name of the HTTP Authentication scheme to be used in the Authorization header,
+   * as defined in RFC7235 (e.g., "Bearer").
+   * This value should be registered in the IANA Authentication Scheme registry.
+   *
    * @generated from field: string scheme = 2;
    */
   scheme?: string;
 
   /**
+   * A hint to the client to identify how the bearer token is formatted (e.g., "JWT").
+   * Primarily for documentation purposes.
+   *
    * @generated from field: string bearer_format = 3;
    */
   bearerFormat?: string;
@@ -1423,40 +2045,58 @@ export declare type HTTPAuthSecuritySchemeJson = {
 export declare const HTTPAuthSecuritySchemeSchema: GenMessage<HTTPAuthSecurityScheme, {jsonType: HTTPAuthSecuritySchemeJson}>;
 
 /**
+ * Defines a security scheme using OAuth 2.0.
+ *
  * @generated from message lf.a2a.v1.OAuth2SecurityScheme
  */
 export declare type OAuth2SecurityScheme = Message$1<"lf.a2a.v1.OAuth2SecurityScheme"> & {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description: string;
 
   /**
+   * An object containing configuration information for the supported OAuth 2.0 flows.
+   *
    * @generated from field: lf.a2a.v1.OAuthFlows flows = 2;
    */
   flows?: OAuthFlows | undefined;
 
   /**
+   * URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414).
+   * TLS is required.
+   *
    * @generated from field: string oauth2_metadata_url = 3;
    */
   oauth2MetadataUrl: string;
 };
 
 /**
+ * Defines a security scheme using OAuth 2.0.
+ *
  * @generated from message lf.a2a.v1.OAuth2SecurityScheme
  */
 export declare type OAuth2SecuritySchemeJson = {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description?: string;
 
   /**
+   * An object containing configuration information for the supported OAuth 2.0 flows.
+   *
    * @generated from field: lf.a2a.v1.OAuthFlows flows = 2;
    */
   flows?: OAuthFlowsJson;
 
   /**
+   * URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414).
+   * TLS is required.
+   *
    * @generated from field: string oauth2_metadata_url = 3;
    */
   oauth2MetadataUrl?: string;
@@ -1469,30 +2109,42 @@ export declare type OAuth2SecuritySchemeJson = {
 export declare const OAuth2SecuritySchemeSchema: GenMessage<OAuth2SecurityScheme, {jsonType: OAuth2SecuritySchemeJson}>;
 
 /**
+ * Defines a security scheme using OpenID Connect.
+ *
  * @generated from message lf.a2a.v1.OpenIdConnectSecurityScheme
  */
 export declare type OpenIdConnectSecurityScheme = Message$1<"lf.a2a.v1.OpenIdConnectSecurityScheme"> & {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description: string;
 
   /**
+   * The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata.
+   *
    * @generated from field: string open_id_connect_url = 2;
    */
   openIdConnectUrl: string;
 };
 
 /**
+ * Defines a security scheme using OpenID Connect.
+ *
  * @generated from message lf.a2a.v1.OpenIdConnectSecurityScheme
  */
 export declare type OpenIdConnectSecuritySchemeJson = {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description?: string;
 
   /**
+   * The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata.
+   *
    * @generated from field: string open_id_connect_url = 2;
    */
   openIdConnectUrl?: string;
@@ -1505,20 +2157,28 @@ export declare type OpenIdConnectSecuritySchemeJson = {
 export declare const OpenIdConnectSecuritySchemeSchema: GenMessage<OpenIdConnectSecurityScheme, {jsonType: OpenIdConnectSecuritySchemeJson}>;
 
 /**
+ * Defines a security scheme using mTLS authentication.
+ *
  * @generated from message lf.a2a.v1.MutualTlsSecurityScheme
  */
 export declare type MutualTlsSecurityScheme = Message$1<"lf.a2a.v1.MutualTlsSecurityScheme"> & {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description: string;
 };
 
 /**
+ * Defines a security scheme using mTLS authentication.
+ *
  * @generated from message lf.a2a.v1.MutualTlsSecurityScheme
  */
 export declare type MutualTlsSecuritySchemeJson = {
   /**
+   * An optional description for the security scheme.
+   *
    * @generated from field: string description = 1;
    */
   description?: string;
@@ -1531,6 +2191,8 @@ export declare type MutualTlsSecuritySchemeJson = {
 export declare const MutualTlsSecuritySchemeSchema: GenMessage<MutualTlsSecurityScheme, {jsonType: MutualTlsSecuritySchemeJson}>;
 
 /**
+ * Defines the configuration for the supported OAuth 2.0 flows.
+ *
  * @generated from message lf.a2a.v1.OAuthFlows
  */
 export declare type OAuthFlows = Message$1<"lf.a2a.v1.OAuthFlows"> & {
@@ -1539,18 +2201,24 @@ export declare type OAuthFlows = Message$1<"lf.a2a.v1.OAuthFlows"> & {
    */
   flow: {
     /**
+     * Configuration for the OAuth Authorization Code flow.
+     *
      * @generated from field: lf.a2a.v1.AuthorizationCodeOAuthFlow authorization_code = 1;
      */
     value: AuthorizationCodeOAuthFlow;
     case: "authorizationCode";
   } | {
     /**
+     * Configuration for the OAuth Client Credentials flow.
+     *
      * @generated from field: lf.a2a.v1.ClientCredentialsOAuthFlow client_credentials = 2;
      */
     value: ClientCredentialsOAuthFlow;
     case: "clientCredentials";
   } | {
     /**
+     * Deprecated: Use Authorization Code + PKCE instead.
+     *
      * @generated from field: lf.a2a.v1.ImplicitOAuthFlow implicit = 3 [deprecated = true];
      * @deprecated
      */
@@ -1558,6 +2226,8 @@ export declare type OAuthFlows = Message$1<"lf.a2a.v1.OAuthFlows"> & {
     case: "implicit";
   } | {
     /**
+     * Deprecated: Use Authorization Code + PKCE or Device Code.
+     *
      * @generated from field: lf.a2a.v1.PasswordOAuthFlow password = 4 [deprecated = true];
      * @deprecated
      */
@@ -1565,6 +2235,8 @@ export declare type OAuthFlows = Message$1<"lf.a2a.v1.OAuthFlows"> & {
     case: "password";
   } | {
     /**
+     * Configuration for the OAuth Device Code flow.
+     *
      * @generated from field: lf.a2a.v1.DeviceCodeOAuthFlow device_code = 5;
      */
     value: DeviceCodeOAuthFlow;
@@ -1573,32 +2245,44 @@ export declare type OAuthFlows = Message$1<"lf.a2a.v1.OAuthFlows"> & {
 };
 
 /**
+ * Defines the configuration for the supported OAuth 2.0 flows.
+ *
  * @generated from message lf.a2a.v1.OAuthFlows
  */
 export declare type OAuthFlowsJson = {
   /**
+   * Configuration for the OAuth Authorization Code flow.
+   *
    * @generated from field: lf.a2a.v1.AuthorizationCodeOAuthFlow authorization_code = 1;
    */
   authorizationCode?: AuthorizationCodeOAuthFlowJson;
 
   /**
+   * Configuration for the OAuth Client Credentials flow.
+   *
    * @generated from field: lf.a2a.v1.ClientCredentialsOAuthFlow client_credentials = 2;
    */
   clientCredentials?: ClientCredentialsOAuthFlowJson;
 
   /**
+   * Deprecated: Use Authorization Code + PKCE instead.
+   *
    * @generated from field: lf.a2a.v1.ImplicitOAuthFlow implicit = 3 [deprecated = true];
    * @deprecated
    */
   implicit?: ImplicitOAuthFlowJson;
 
   /**
+   * Deprecated: Use Authorization Code + PKCE or Device Code.
+   *
    * @generated from field: lf.a2a.v1.PasswordOAuthFlow password = 4 [deprecated = true];
    * @deprecated
    */
   password?: PasswordOAuthFlowJson;
 
   /**
+   * Configuration for the OAuth Device Code flow.
+   *
    * @generated from field: lf.a2a.v1.DeviceCodeOAuthFlow device_code = 5;
    */
   deviceCode?: DeviceCodeOAuthFlowJson;
@@ -1611,60 +2295,86 @@ export declare type OAuthFlowsJson = {
 export declare const OAuthFlowsSchema: GenMessage<OAuthFlows, {jsonType: OAuthFlowsJson}>;
 
 /**
+ * Defines configuration details for the OAuth 2.0 Authorization Code flow.
+ *
  * @generated from message lf.a2a.v1.AuthorizationCodeOAuthFlow
  */
 export declare type AuthorizationCodeOAuthFlow = Message$1<"lf.a2a.v1.AuthorizationCodeOAuthFlow"> & {
   /**
+   * The authorization URL to be used for this flow.
+   *
    * @generated from field: string authorization_url = 1;
    */
   authorizationUrl: string;
 
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 2;
    */
   tokenUrl: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 3;
    */
   refreshUrl: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 4;
    */
   scopes: { [key: string]: string };
 
   /**
+   * Indicates if PKCE (RFC 7636) is required for this flow.
+   * PKCE should always be used for public clients and is recommended for all clients.
+   *
    * @generated from field: bool pkce_required = 5;
    */
   pkceRequired: boolean;
 };
 
 /**
+ * Defines configuration details for the OAuth 2.0 Authorization Code flow.
+ *
  * @generated from message lf.a2a.v1.AuthorizationCodeOAuthFlow
  */
 export declare type AuthorizationCodeOAuthFlowJson = {
   /**
+   * The authorization URL to be used for this flow.
+   *
    * @generated from field: string authorization_url = 1;
    */
   authorizationUrl?: string;
 
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 2;
    */
   tokenUrl?: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 3;
    */
   refreshUrl?: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 4;
    */
   scopes?: { [key: string]: string };
 
   /**
+   * Indicates if PKCE (RFC 7636) is required for this flow.
+   * PKCE should always be used for public clients and is recommended for all clients.
+   *
    * @generated from field: bool pkce_required = 5;
    */
   pkceRequired?: boolean;
@@ -1677,40 +2387,56 @@ export declare type AuthorizationCodeOAuthFlowJson = {
 export declare const AuthorizationCodeOAuthFlowSchema: GenMessage<AuthorizationCodeOAuthFlow, {jsonType: AuthorizationCodeOAuthFlowJson}>;
 
 /**
+ * Defines configuration details for the OAuth 2.0 Client Credentials flow.
+ *
  * @generated from message lf.a2a.v1.ClientCredentialsOAuthFlow
  */
 export declare type ClientCredentialsOAuthFlow = Message$1<"lf.a2a.v1.ClientCredentialsOAuthFlow"> & {
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 1;
    */
   tokenUrl: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes: { [key: string]: string };
 };
 
 /**
+ * Defines configuration details for the OAuth 2.0 Client Credentials flow.
+ *
  * @generated from message lf.a2a.v1.ClientCredentialsOAuthFlow
  */
 export declare type ClientCredentialsOAuthFlowJson = {
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 1;
    */
   tokenUrl?: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl?: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes?: { [key: string]: string };
@@ -1723,40 +2449,62 @@ export declare type ClientCredentialsOAuthFlowJson = {
 export declare const ClientCredentialsOAuthFlowSchema: GenMessage<ClientCredentialsOAuthFlow, {jsonType: ClientCredentialsOAuthFlowJson}>;
 
 /**
+ * Deprecated: Use Authorization Code + PKCE instead.
+ *
  * @generated from message lf.a2a.v1.ImplicitOAuthFlow
  */
 export declare type ImplicitOAuthFlow = Message$1<"lf.a2a.v1.ImplicitOAuthFlow"> & {
   /**
+   * The authorization URL to be used for this flow. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS
+   *
    * @generated from field: string authorization_url = 1;
    */
   authorizationUrl: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme. A map between the
+   * scope name and a short description for it. The map MAY be empty.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes: { [key: string]: string };
 };
 
 /**
+ * Deprecated: Use Authorization Code + PKCE instead.
+ *
  * @generated from message lf.a2a.v1.ImplicitOAuthFlow
  */
 export declare type ImplicitOAuthFlowJson = {
   /**
+   * The authorization URL to be used for this flow. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS
+   *
    * @generated from field: string authorization_url = 1;
    */
   authorizationUrl?: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl?: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme. A map between the
+   * scope name and a short description for it. The map MAY be empty.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes?: { [key: string]: string };
@@ -1769,40 +2517,62 @@ export declare type ImplicitOAuthFlowJson = {
 export declare const ImplicitOAuthFlowSchema: GenMessage<ImplicitOAuthFlow, {jsonType: ImplicitOAuthFlowJson}>;
 
 /**
+ * Deprecated: Use Authorization Code + PKCE or Device Code.
+ *
  * @generated from message lf.a2a.v1.PasswordOAuthFlow
  */
 export declare type PasswordOAuthFlow = Message$1<"lf.a2a.v1.PasswordOAuthFlow"> & {
   /**
+   * The token URL to be used for this flow. This MUST be in the form of a URL.
+   * The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string token_url = 1;
    */
   tokenUrl: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme. A map between the
+   * scope name and a short description for it. The map MAY be empty.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes: { [key: string]: string };
 };
 
 /**
+ * Deprecated: Use Authorization Code + PKCE or Device Code.
+ *
  * @generated from message lf.a2a.v1.PasswordOAuthFlow
  */
 export declare type PasswordOAuthFlowJson = {
   /**
+   * The token URL to be used for this flow. This MUST be in the form of a URL.
+   * The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string token_url = 1;
    */
   tokenUrl?: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens. This MUST be in the
+   * form of a URL. The OAuth2 standard requires the use of TLS.
+   *
    * @generated from field: string refresh_url = 2;
    */
   refreshUrl?: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme. A map between the
+   * scope name and a short description for it. The map MAY be empty.
+   *
    * @generated from field: map<string, string> scopes = 3;
    */
   scopes?: { [key: string]: string };
@@ -1815,50 +2585,74 @@ export declare type PasswordOAuthFlowJson = {
 export declare const PasswordOAuthFlowSchema: GenMessage<PasswordOAuthFlow, {jsonType: PasswordOAuthFlowJson}>;
 
 /**
+ * Defines configuration details for the OAuth 2.0 Device Code flow (RFC 8628).
+ * This flow is designed for input-constrained devices such as IoT devices,
+ * and CLI tools where the user authenticates on a separate device.
+ *
  * @generated from message lf.a2a.v1.DeviceCodeOAuthFlow
  */
 export declare type DeviceCodeOAuthFlow = Message$1<"lf.a2a.v1.DeviceCodeOAuthFlow"> & {
   /**
+   * The device authorization endpoint URL.
+   *
    * @generated from field: string device_authorization_url = 1;
    */
   deviceAuthorizationUrl: string;
 
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 2;
    */
   tokenUrl: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 3;
    */
   refreshUrl: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 4;
    */
   scopes: { [key: string]: string };
 };
 
 /**
+ * Defines configuration details for the OAuth 2.0 Device Code flow (RFC 8628).
+ * This flow is designed for input-constrained devices such as IoT devices,
+ * and CLI tools where the user authenticates on a separate device.
+ *
  * @generated from message lf.a2a.v1.DeviceCodeOAuthFlow
  */
 export declare type DeviceCodeOAuthFlowJson = {
   /**
+   * The device authorization endpoint URL.
+   *
    * @generated from field: string device_authorization_url = 1;
    */
   deviceAuthorizationUrl?: string;
 
   /**
+   * The token URL to be used for this flow.
+   *
    * @generated from field: string token_url = 2;
    */
   tokenUrl?: string;
 
   /**
+   * The URL to be used for obtaining refresh tokens.
+   *
    * @generated from field: string refresh_url = 3;
    */
   refreshUrl?: string;
 
   /**
+   * The available scopes for the OAuth2 security scheme.
+   *
    * @generated from field: map<string, string> scopes = 4;
    */
   scopes?: { [key: string]: string };
@@ -1871,50 +2665,70 @@ export declare type DeviceCodeOAuthFlowJson = {
 export declare const DeviceCodeOAuthFlowSchema: GenMessage<DeviceCodeOAuthFlow, {jsonType: DeviceCodeOAuthFlowJson}>;
 
 /**
+ * Represents a request for the `SendMessage` method.
+ *
  * @generated from message lf.a2a.v1.SendMessageRequest
  */
 export declare type SendMessageRequest = Message$1<"lf.a2a.v1.SendMessageRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The message to send to the agent.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: Message | undefined;
 
   /**
+   * Configuration for the send request.
+   *
    * @generated from field: lf.a2a.v1.SendMessageConfiguration configuration = 3;
    */
   configuration?: SendMessageConfiguration | undefined;
 
   /**
+   * A flexible key-value map for passing additional context or parameters.
+   *
    * @generated from field: google.protobuf.Struct metadata = 4;
    */
   metadata?: JsonObject | undefined;
 };
 
 /**
+ * Represents a request for the `SendMessage` method.
+ *
  * @generated from message lf.a2a.v1.SendMessageRequest
  */
 export declare type SendMessageRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The message to send to the agent.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: MessageJson;
 
   /**
+   * Configuration for the send request.
+   *
    * @generated from field: lf.a2a.v1.SendMessageConfiguration configuration = 3;
    */
   configuration?: SendMessageConfigurationJson;
 
   /**
+   * A flexible key-value map for passing additional context or parameters.
+   *
    * @generated from field: google.protobuf.Struct metadata = 4;
    */
   metadata?: StructJson;
@@ -1927,40 +2741,62 @@ export declare type SendMessageRequestJson = {
 export declare const SendMessageRequestSchema: GenMessage<SendMessageRequest, {jsonType: SendMessageRequestJson}>;
 
 /**
+ * Represents a request for the `GetTask` method.
+ *
  * @generated from message lf.a2a.v1.GetTaskRequest
  */
 export declare type GetTaskRequest = Message$1<"lf.a2a.v1.GetTaskRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The resource ID of the task to retrieve.
+   *
    * @generated from field: string id = 2;
    */
   id: string;
 
   /**
+   * The maximum number of most recent messages from the task's history to retrieve. An
+   * unset value means the client does not impose any limit. A value of zero is
+   * a request to not include any messages. The server MUST NOT return more
+   * messages than the provided value, but MAY apply a lower limit.
+   *
    * @generated from field: optional int32 history_length = 3;
    */
   historyLength?: number | undefined;
 };
 
 /**
+ * Represents a request for the `GetTask` method.
+ *
  * @generated from message lf.a2a.v1.GetTaskRequest
  */
 export declare type GetTaskRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The resource ID of the task to retrieve.
+   *
    * @generated from field: string id = 2;
    */
   id?: string;
 
   /**
+   * The maximum number of most recent messages from the task's history to retrieve. An
+   * unset value means the client does not impose any limit. A value of zero is
+   * a request to not include any messages. The server MUST NOT return more
+   * messages than the provided value, but MAY apply a lower limit.
+   *
    * @generated from field: optional int32 history_length = 3;
    */
   historyLength?: number;
@@ -1973,90 +2809,140 @@ export declare type GetTaskRequestJson = {
 export declare const GetTaskRequestSchema: GenMessage<GetTaskRequest, {jsonType: GetTaskRequestJson}>;
 
 /**
+ * Parameters for listing tasks with optional filtering criteria.
+ *
  * @generated from message lf.a2a.v1.ListTasksRequest
  */
 export declare type ListTasksRequest = Message$1<"lf.a2a.v1.ListTasksRequest"> & {
   /**
+   * Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * Filter tasks by context ID to get tasks from a specific conversation or session.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId: string;
 
   /**
+   * Filter tasks by their current status state.
+   *
    * @generated from field: lf.a2a.v1.TaskState status = 3;
    */
   status: TaskState;
 
   /**
+   * The maximum number of tasks to return. The service may return fewer than this value.
+   * If unspecified, at most 50 tasks will be returned.
+   * The minimum value is 1.
+   * The maximum value is 100.
+   *
    * @generated from field: optional int32 page_size = 4;
    */
   pageSize?: number | undefined;
 
   /**
+   * A page token, received from a previous `ListTasks` call.
+   * `ListTasksResponse.next_page_token`.
+   * Provide this to retrieve the subsequent page.
+   *
    * @generated from field: string page_token = 5;
    */
   pageToken: string;
 
   /**
+   * The maximum number of messages to include in each task's history.
+   *
    * @generated from field: optional int32 history_length = 6;
    */
   historyLength?: number | undefined;
 
   /**
+   * Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., "2023-10-27T10:00:00Z").
+   * Only tasks with a status timestamp time greater than or equal to this value will be returned.
+   *
    * @generated from field: google.protobuf.Timestamp status_timestamp_after = 7;
    */
   statusTimestampAfter?: Timestamp | undefined;
 
   /**
+   * Whether to include artifacts in the returned tasks.
+   * Defaults to false to reduce payload size.
+   *
    * @generated from field: optional bool include_artifacts = 8;
    */
   includeArtifacts?: boolean | undefined;
 };
 
 /**
+ * Parameters for listing tasks with optional filtering criteria.
+ *
  * @generated from message lf.a2a.v1.ListTasksRequest
  */
 export declare type ListTasksRequestJson = {
   /**
+   * Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * Filter tasks by context ID to get tasks from a specific conversation or session.
+   *
    * @generated from field: string context_id = 2;
    */
   contextId?: string;
 
   /**
+   * Filter tasks by their current status state.
+   *
    * @generated from field: lf.a2a.v1.TaskState status = 3;
    */
   status?: TaskStateJson;
 
   /**
+   * The maximum number of tasks to return. The service may return fewer than this value.
+   * If unspecified, at most 50 tasks will be returned.
+   * The minimum value is 1.
+   * The maximum value is 100.
+   *
    * @generated from field: optional int32 page_size = 4;
    */
   pageSize?: number;
 
   /**
+   * A page token, received from a previous `ListTasks` call.
+   * `ListTasksResponse.next_page_token`.
+   * Provide this to retrieve the subsequent page.
+   *
    * @generated from field: string page_token = 5;
    */
   pageToken?: string;
 
   /**
+   * The maximum number of messages to include in each task's history.
+   *
    * @generated from field: optional int32 history_length = 6;
    */
   historyLength?: number;
 
   /**
+   * Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., "2023-10-27T10:00:00Z").
+   * Only tasks with a status timestamp time greater than or equal to this value will be returned.
+   *
    * @generated from field: google.protobuf.Timestamp status_timestamp_after = 7;
    */
   statusTimestampAfter?: TimestampJson;
 
   /**
+   * Whether to include artifacts in the returned tasks.
+   * Defaults to false to reduce payload size.
+   *
    * @generated from field: optional bool include_artifacts = 8;
    */
   includeArtifacts?: boolean;
@@ -2069,50 +2955,70 @@ export declare type ListTasksRequestJson = {
 export declare const ListTasksRequestSchema: GenMessage<ListTasksRequest, {jsonType: ListTasksRequestJson}>;
 
 /**
+ * Result object for `ListTasks` method containing an array of tasks and pagination information.
+ *
  * @generated from message lf.a2a.v1.ListTasksResponse
  */
 export declare type ListTasksResponse = Message$1<"lf.a2a.v1.ListTasksResponse"> & {
   /**
+   * Array of tasks matching the specified criteria.
+   *
    * @generated from field: repeated lf.a2a.v1.Task tasks = 1;
    */
   tasks: Task[];
 
   /**
+   * A token to retrieve the next page of results, or empty if there are no more results in the list.
+   *
    * @generated from field: string next_page_token = 2;
    */
   nextPageToken: string;
 
   /**
+   * The page size used for this response.
+   *
    * @generated from field: int32 page_size = 3;
    */
   pageSize: number;
 
   /**
+   * Total number of tasks available (before pagination).
+   *
    * @generated from field: int32 total_size = 4;
    */
   totalSize: number;
 };
 
 /**
+ * Result object for `ListTasks` method containing an array of tasks and pagination information.
+ *
  * @generated from message lf.a2a.v1.ListTasksResponse
  */
 export declare type ListTasksResponseJson = {
   /**
+   * Array of tasks matching the specified criteria.
+   *
    * @generated from field: repeated lf.a2a.v1.Task tasks = 1;
    */
   tasks?: TaskJson[];
 
   /**
+   * A token to retrieve the next page of results, or empty if there are no more results in the list.
+   *
    * @generated from field: string next_page_token = 2;
    */
   nextPageToken?: string;
 
   /**
+   * The page size used for this response.
+   *
    * @generated from field: int32 page_size = 3;
    */
   pageSize?: number;
 
   /**
+   * Total number of tasks available (before pagination).
+   *
    * @generated from field: int32 total_size = 4;
    */
   totalSize?: number;
@@ -2125,40 +3031,56 @@ export declare type ListTasksResponseJson = {
 export declare const ListTasksResponseSchema: GenMessage<ListTasksResponse, {jsonType: ListTasksResponseJson}>;
 
 /**
+ * Represents a request for the `CancelTask` method.
+ *
  * @generated from message lf.a2a.v1.CancelTaskRequest
  */
 export declare type CancelTaskRequest = Message$1<"lf.a2a.v1.CancelTaskRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The resource ID of the task to cancel.
+   *
    * @generated from field: string id = 2;
    */
   id: string;
 
   /**
+   * A flexible key-value map for passing additional context or parameters.
+   *
    * @generated from field: google.protobuf.Struct metadata = 3;
    */
   metadata?: JsonObject | undefined;
 };
 
 /**
+ * Represents a request for the `CancelTask` method.
+ *
  * @generated from message lf.a2a.v1.CancelTaskRequest
  */
 export declare type CancelTaskRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The resource ID of the task to cancel.
+   *
    * @generated from field: string id = 2;
    */
   id?: string;
 
   /**
+   * A flexible key-value map for passing additional context or parameters.
+   *
    * @generated from field: google.protobuf.Struct metadata = 3;
    */
   metadata?: StructJson;
@@ -2171,40 +3093,56 @@ export declare type CancelTaskRequestJson = {
 export declare const CancelTaskRequestSchema: GenMessage<CancelTaskRequest, {jsonType: CancelTaskRequestJson}>;
 
 /**
+ * Represents a request for the `GetTaskPushNotificationConfig` method.
+ *
  * @generated from message lf.a2a.v1.GetTaskPushNotificationConfigRequest
  */
 export declare type GetTaskPushNotificationConfigRequest = Message$1<"lf.a2a.v1.GetTaskPushNotificationConfigRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 2;
    */
   taskId: string;
 
   /**
+   * The resource ID of the configuration to retrieve.
+   *
    * @generated from field: string id = 3;
    */
   id: string;
 };
 
 /**
+ * Represents a request for the `GetTaskPushNotificationConfig` method.
+ *
  * @generated from message lf.a2a.v1.GetTaskPushNotificationConfigRequest
  */
 export declare type GetTaskPushNotificationConfigRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 2;
    */
   taskId?: string;
 
   /**
+   * The resource ID of the configuration to retrieve.
+   *
    * @generated from field: string id = 3;
    */
   id?: string;
@@ -2217,40 +3155,56 @@ export declare type GetTaskPushNotificationConfigRequestJson = {
 export declare const GetTaskPushNotificationConfigRequestSchema: GenMessage<GetTaskPushNotificationConfigRequest, {jsonType: GetTaskPushNotificationConfigRequestJson}>;
 
 /**
+ * Represents a request for the `DeleteTaskPushNotificationConfig` method.
+ *
  * @generated from message lf.a2a.v1.DeleteTaskPushNotificationConfigRequest
  */
 export declare type DeleteTaskPushNotificationConfigRequest = Message$1<"lf.a2a.v1.DeleteTaskPushNotificationConfigRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 2;
    */
   taskId: string;
 
   /**
+   * The resource ID of the configuration to delete.
+   *
    * @generated from field: string id = 3;
    */
   id: string;
 };
 
 /**
+ * Represents a request for the `DeleteTaskPushNotificationConfig` method.
+ *
  * @generated from message lf.a2a.v1.DeleteTaskPushNotificationConfigRequest
  */
 export declare type DeleteTaskPushNotificationConfigRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 2;
    */
   taskId?: string;
 
   /**
+   * The resource ID of the configuration to delete.
+   *
    * @generated from field: string id = 3;
    */
   id?: string;
@@ -2263,30 +3217,42 @@ export declare type DeleteTaskPushNotificationConfigRequestJson = {
 export declare const DeleteTaskPushNotificationConfigRequestSchema: GenMessage<DeleteTaskPushNotificationConfigRequest, {jsonType: DeleteTaskPushNotificationConfigRequestJson}>;
 
 /**
+ * Represents a request for the `SubscribeToTask` method.
+ *
  * @generated from message lf.a2a.v1.SubscribeToTaskRequest
  */
 export declare type SubscribeToTaskRequest = Message$1<"lf.a2a.v1.SubscribeToTaskRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 
   /**
+   * The resource ID of the task to subscribe to.
+   *
    * @generated from field: string id = 2;
    */
   id: string;
 };
 
 /**
+ * Represents a request for the `SubscribeToTask` method.
+ *
  * @generated from message lf.a2a.v1.SubscribeToTaskRequest
  */
 export declare type SubscribeToTaskRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
 
   /**
+   * The resource ID of the task to subscribe to.
+   *
    * @generated from field: string id = 2;
    */
   id?: string;
@@ -2299,50 +3265,70 @@ export declare type SubscribeToTaskRequestJson = {
 export declare const SubscribeToTaskRequestSchema: GenMessage<SubscribeToTaskRequest, {jsonType: SubscribeToTaskRequestJson}>;
 
 /**
+ * Represents a request for the `ListTaskPushNotificationConfigs` method.
+ *
  * @generated from message lf.a2a.v1.ListTaskPushNotificationConfigsRequest
  */
 export declare type ListTaskPushNotificationConfigsRequest = Message$1<"lf.a2a.v1.ListTaskPushNotificationConfigsRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 4;
    */
   tenant: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId: string;
 
   /**
+   * The maximum number of configurations to return.
+   *
    * @generated from field: int32 page_size = 2;
    */
   pageSize: number;
 
   /**
+   * A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.
+   *
    * @generated from field: string page_token = 3;
    */
   pageToken: string;
 };
 
 /**
+ * Represents a request for the `ListTaskPushNotificationConfigs` method.
+ *
  * @generated from message lf.a2a.v1.ListTaskPushNotificationConfigsRequest
  */
 export declare type ListTaskPushNotificationConfigsRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 4;
    */
   tenant?: string;
 
   /**
+   * The parent task resource ID.
+   *
    * @generated from field: string task_id = 1;
    */
   taskId?: string;
 
   /**
+   * The maximum number of configurations to return.
+   *
    * @generated from field: int32 page_size = 2;
    */
   pageSize?: number;
 
   /**
+   * A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.
+   *
    * @generated from field: string page_token = 3;
    */
   pageToken?: string;
@@ -2355,20 +3341,28 @@ export declare type ListTaskPushNotificationConfigsRequestJson = {
 export declare const ListTaskPushNotificationConfigsRequestSchema: GenMessage<ListTaskPushNotificationConfigsRequest, {jsonType: ListTaskPushNotificationConfigsRequestJson}>;
 
 /**
+ * Represents a request for the `GetExtendedAgentCard` method.
+ *
  * @generated from message lf.a2a.v1.GetExtendedAgentCardRequest
  */
 export declare type GetExtendedAgentCardRequest = Message$1<"lf.a2a.v1.GetExtendedAgentCardRequest"> & {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant: string;
 };
 
 /**
+ * Represents a request for the `GetExtendedAgentCard` method.
+ *
  * @generated from message lf.a2a.v1.GetExtendedAgentCardRequest
  */
 export declare type GetExtendedAgentCardRequestJson = {
   /**
+   * Optional. Tenant ID, provided as a path parameter.
+   *
    * @generated from field: string tenant = 1;
    */
   tenant?: string;
@@ -2381,20 +3375,28 @@ export declare type GetExtendedAgentCardRequestJson = {
 export declare const GetExtendedAgentCardRequestSchema: GenMessage<GetExtendedAgentCardRequest, {jsonType: GetExtendedAgentCardRequestJson}>;
 
 /**
+ * Represents the response for the `SendMessage` method.
+ *
  * @generated from message lf.a2a.v1.SendMessageResponse
  */
 export declare type SendMessageResponse = Message$1<"lf.a2a.v1.SendMessageResponse"> & {
   /**
+   * The payload of the response.
+   *
    * @generated from oneof lf.a2a.v1.SendMessageResponse.payload
    */
   payload: {
     /**
+     * The task created or updated by the message.
+     *
      * @generated from field: lf.a2a.v1.Task task = 1;
      */
     value: Task;
     case: "task";
   } | {
     /**
+     * A message from the agent.
+     *
      * @generated from field: lf.a2a.v1.Message message = 2;
      */
     value: Message;
@@ -2403,15 +3405,21 @@ export declare type SendMessageResponse = Message$1<"lf.a2a.v1.SendMessageRespon
 };
 
 /**
+ * Represents the response for the `SendMessage` method.
+ *
  * @generated from message lf.a2a.v1.SendMessageResponse
  */
 export declare type SendMessageResponseJson = {
   /**
+   * The task created or updated by the message.
+   *
    * @generated from field: lf.a2a.v1.Task task = 1;
    */
   task?: TaskJson;
 
   /**
+   * A message from the agent.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: MessageJson;
@@ -2424,32 +3432,44 @@ export declare type SendMessageResponseJson = {
 export declare const SendMessageResponseSchema: GenMessage<SendMessageResponse, {jsonType: SendMessageResponseJson}>;
 
 /**
+ * A wrapper object used in streaming operations to encapsulate different types of response data.
+ *
  * @generated from message lf.a2a.v1.StreamResponse
  */
 export declare type StreamResponse = Message$1<"lf.a2a.v1.StreamResponse"> & {
   /**
+   * The payload of the stream response.
+   *
    * @generated from oneof lf.a2a.v1.StreamResponse.payload
    */
   payload: {
     /**
+     * A Task object containing the current state of the task.
+     *
      * @generated from field: lf.a2a.v1.Task task = 1;
      */
     value: Task;
     case: "task";
   } | {
     /**
+     * A Message object containing a message from the agent.
+     *
      * @generated from field: lf.a2a.v1.Message message = 2;
      */
     value: Message;
     case: "message";
   } | {
     /**
+     * An event indicating a task status update.
+     *
      * @generated from field: lf.a2a.v1.TaskStatusUpdateEvent status_update = 3;
      */
     value: TaskStatusUpdateEvent;
     case: "statusUpdate";
   } | {
     /**
+     * An event indicating a task artifact update.
+     *
      * @generated from field: lf.a2a.v1.TaskArtifactUpdateEvent artifact_update = 4;
      */
     value: TaskArtifactUpdateEvent;
@@ -2458,25 +3478,35 @@ export declare type StreamResponse = Message$1<"lf.a2a.v1.StreamResponse"> & {
 };
 
 /**
+ * A wrapper object used in streaming operations to encapsulate different types of response data.
+ *
  * @generated from message lf.a2a.v1.StreamResponse
  */
 export declare type StreamResponseJson = {
   /**
+   * A Task object containing the current state of the task.
+   *
    * @generated from field: lf.a2a.v1.Task task = 1;
    */
   task?: TaskJson;
 
   /**
+   * A Message object containing a message from the agent.
+   *
    * @generated from field: lf.a2a.v1.Message message = 2;
    */
   message?: MessageJson;
 
   /**
+   * An event indicating a task status update.
+   *
    * @generated from field: lf.a2a.v1.TaskStatusUpdateEvent status_update = 3;
    */
   statusUpdate?: TaskStatusUpdateEventJson;
 
   /**
+   * An event indicating a task artifact update.
+   *
    * @generated from field: lf.a2a.v1.TaskArtifactUpdateEvent artifact_update = 4;
    */
   artifactUpdate?: TaskArtifactUpdateEventJson;
@@ -2489,30 +3519,44 @@ export declare type StreamResponseJson = {
 export declare const StreamResponseSchema: GenMessage<StreamResponse, {jsonType: StreamResponseJson}>;
 
 /**
+ * Represents a successful response for the `ListTaskPushNotificationConfigs`
+ * method.
+ *
  * @generated from message lf.a2a.v1.ListTaskPushNotificationConfigsResponse
  */
 export declare type ListTaskPushNotificationConfigsResponse = Message$1<"lf.a2a.v1.ListTaskPushNotificationConfigsResponse"> & {
   /**
+   * The list of push notification configurations.
+   *
    * @generated from field: repeated lf.a2a.v1.TaskPushNotificationConfig configs = 1;
    */
   configs: TaskPushNotificationConfig[];
 
   /**
+   * A token to retrieve the next page of results, or empty if there are no more results in the list.
+   *
    * @generated from field: string next_page_token = 2;
    */
   nextPageToken: string;
 };
 
 /**
+ * Represents a successful response for the `ListTaskPushNotificationConfigs`
+ * method.
+ *
  * @generated from message lf.a2a.v1.ListTaskPushNotificationConfigsResponse
  */
 export declare type ListTaskPushNotificationConfigsResponseJson = {
   /**
+   * The list of push notification configurations.
+   *
    * @generated from field: repeated lf.a2a.v1.TaskPushNotificationConfig configs = 1;
    */
   configs?: TaskPushNotificationConfigJson[];
 
   /**
+   * A token to retrieve the next page of results, or empty if there are no more results in the list.
+   *
    * @generated from field: string next_page_token = 2;
    */
   nextPageToken?: string;
@@ -2525,56 +3569,80 @@ export declare type ListTaskPushNotificationConfigsResponseJson = {
 export declare const ListTaskPushNotificationConfigsResponseSchema: GenMessage<ListTaskPushNotificationConfigsResponse, {jsonType: ListTaskPushNotificationConfigsResponseJson}>;
 
 /**
+ * Defines the possible lifecycle states of a `Task`.
+ *
  * @generated from enum lf.a2a.v1.TaskState
  */
 export enum TaskState {
   /**
+   * The task is in an unknown or indeterminate state.
+   *
    * @generated from enum value: TASK_STATE_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * Indicates that a task has been successfully submitted and acknowledged.
+   *
    * @generated from enum value: TASK_STATE_SUBMITTED = 1;
    */
   SUBMITTED = 1,
 
   /**
+   * Indicates that a task is actively being processed by the agent.
+   *
    * @generated from enum value: TASK_STATE_WORKING = 2;
    */
   WORKING = 2,
 
   /**
+   * Indicates that a task has finished successfully. This is a terminal state.
+   *
    * @generated from enum value: TASK_STATE_COMPLETED = 3;
    */
   COMPLETED = 3,
 
   /**
+   * Indicates that a task has finished with an error. This is a terminal state.
+   *
    * @generated from enum value: TASK_STATE_FAILED = 4;
    */
   FAILED = 4,
 
   /**
+   * Indicates that a task was canceled before completion. This is a terminal state.
+   *
    * @generated from enum value: TASK_STATE_CANCELED = 5;
    */
   CANCELED = 5,
 
   /**
+   * Indicates that the agent requires additional user input to proceed. This is an interrupted state.
+   *
    * @generated from enum value: TASK_STATE_INPUT_REQUIRED = 6;
    */
   INPUT_REQUIRED = 6,
 
   /**
+   * Indicates that the agent has decided to not perform the task.
+   * This may be done during initial task creation or later once an agent
+   * has determined it can't or won't proceed. This is a terminal state.
+   *
    * @generated from enum value: TASK_STATE_REJECTED = 7;
    */
   REJECTED = 7,
 
   /**
+   * Indicates that authentication is required to proceed. This is an interrupted state.
+   *
    * @generated from enum value: TASK_STATE_AUTH_REQUIRED = 8;
    */
   AUTH_REQUIRED = 8,
 }
 
 /**
+ * Defines the possible lifecycle states of a `Task`.
+ *
  * @generated from enum lf.a2a.v1.TaskState
  */
 export declare type TaskStateJson = "TASK_STATE_UNSPECIFIED" | "TASK_STATE_SUBMITTED" | "TASK_STATE_WORKING" | "TASK_STATE_COMPLETED" | "TASK_STATE_FAILED" | "TASK_STATE_CANCELED" | "TASK_STATE_INPUT_REQUIRED" | "TASK_STATE_REJECTED" | "TASK_STATE_AUTH_REQUIRED";
@@ -2585,26 +3653,36 @@ export declare type TaskStateJson = "TASK_STATE_UNSPECIFIED" | "TASK_STATE_SUBMI
 export declare const TaskStateSchema: GenEnum<TaskState, TaskStateJson>;
 
 /**
+ * Defines the sender of a message in A2A protocol communication.
+ *
  * @generated from enum lf.a2a.v1.Role
  */
 export enum Role {
   /**
+   * The role is unspecified.
+   *
    * @generated from enum value: ROLE_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * The message is from the client to the server.
+   *
    * @generated from enum value: ROLE_USER = 1;
    */
   USER = 1,
 
   /**
+   * The message is from the server to the client.
+   *
    * @generated from enum value: ROLE_AGENT = 2;
    */
   AGENT = 2,
 }
 
 /**
+ * Defines the sender of a message in A2A protocol communication.
+ *
  * @generated from enum lf.a2a.v1.Role
  */
 export declare type RoleJson = "ROLE_UNSPECIFIED" | "ROLE_USER" | "ROLE_AGENT";
@@ -2615,10 +3693,14 @@ export declare type RoleJson = "ROLE_UNSPECIFIED" | "ROLE_USER" | "ROLE_AGENT";
 export declare const RoleSchema: GenEnum<Role, RoleJson>;
 
 /**
+ * Provides operations for interacting with agents using the A2A protocol.
+ *
  * @generated from service lf.a2a.v1.A2AService
  */
 export declare const A2AService: GenService<{
   /**
+   * Sends a message to an agent.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.SendMessage
    */
   sendMessage: {
@@ -2627,6 +3709,9 @@ export declare const A2AService: GenService<{
     output: typeof SendMessageResponseSchema;
   },
   /**
+   * Sends a streaming message to an agent, allowing for real-time interaction and status updates.
+   * Streaming version of `SendMessage`
+   *
    * @generated from rpc lf.a2a.v1.A2AService.SendStreamingMessage
    */
   sendStreamingMessage: {
@@ -2635,6 +3720,8 @@ export declare const A2AService: GenService<{
     output: typeof StreamResponseSchema;
   },
   /**
+   * Gets the latest state of a task.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.GetTask
    */
   getTask: {
@@ -2643,6 +3730,8 @@ export declare const A2AService: GenService<{
     output: typeof TaskSchema;
   },
   /**
+   * Lists tasks that match the specified filter.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.ListTasks
    */
   listTasks: {
@@ -2651,6 +3740,8 @@ export declare const A2AService: GenService<{
     output: typeof ListTasksResponseSchema;
   },
   /**
+   * Cancels a task in progress.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.CancelTask
    */
   cancelTask: {
@@ -2659,6 +3750,9 @@ export declare const A2AService: GenService<{
     output: typeof TaskSchema;
   },
   /**
+   * Subscribes to task updates for tasks not in a terminal state.
+   * Returns `UnsupportedOperationError` if the task is already in a terminal state (completed, failed, canceled, rejected).
+   *
    * @generated from rpc lf.a2a.v1.A2AService.SubscribeToTask
    */
   subscribeToTask: {
@@ -2667,6 +3761,12 @@ export declare const A2AService: GenService<{
     output: typeof StreamResponseSchema;
   },
   /**
+   * (-- api-linter: client-libraries::4232::required-fields=disabled
+   *     api-linter: core::0133::method-signature=disabled
+   *     api-linter: core::0133::request-message-name=disabled
+   *     aip.dev/not-precedent: method_signature preserved for backwards compatibility --)
+   * Creates a push notification config for a task.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.CreateTaskPushNotificationConfig
    */
   createTaskPushNotificationConfig: {
@@ -2675,6 +3775,8 @@ export declare const A2AService: GenService<{
     output: typeof TaskPushNotificationConfigSchema;
   },
   /**
+   * Gets a push notification config for a task.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.GetTaskPushNotificationConfig
    */
   getTaskPushNotificationConfig: {
@@ -2683,6 +3785,8 @@ export declare const A2AService: GenService<{
     output: typeof TaskPushNotificationConfigSchema;
   },
   /**
+   * Get a list of push notifications configured for a task.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.ListTaskPushNotificationConfigs
    */
   listTaskPushNotificationConfigs: {
@@ -2691,6 +3795,8 @@ export declare const A2AService: GenService<{
     output: typeof ListTaskPushNotificationConfigsResponseSchema;
   },
   /**
+   * Gets the extended agent card for the authenticated agent.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.GetExtendedAgentCard
    */
   getExtendedAgentCard: {
@@ -2699,6 +3805,8 @@ export declare const A2AService: GenService<{
     output: typeof AgentCardSchema;
   },
   /**
+   * Deletes a push notification config for a task.
+   *
    * @generated from rpc lf.a2a.v1.A2AService.DeleteTaskPushNotificationConfig
    */
   deleteTaskPushNotificationConfig: {