@alis-build/alis-open-agent-v2 2.16.0 → 2.17.0

package/alis/open/agent/v2/a2a_pb.js

@@ -1,7 +1,31 @@
-// @generated by protoc-gen-es v2.13.0 with parameter "target=js+dts,import_extension=js,json_types=true"
+// @generated by protoc-gen-es v2.16.0 with parameter "target=js+dts,import_extension=js,json_types=true"
 // @generated from file alis/open/agent/v2/a2a.proto (package alis.open.agent.v2, syntax proto3)
 /* eslint-disable */
 
+// A gRPC binding of the Agent2Agent (A2A) protocol for sending messages to
+// an agent and tracking the tasks it performs, shaped to follow AIP-127
+// where appropriate.
+//
+// `A2AService` works with four nouns:
+//
+// - Messages: sent with `SendMessage` or `SendStreamingMessage`. They are
+//   not stored resources.
+// - `Task` (`tasks/{task_id}`): the unit of work, with a status, output
+//   artifacts, and message history. Read with `GetTask` and `ListTasks`,
+//   cancelled with `CancelTask`, and streamed with `TaskSubscription`.
+// - `TaskPushNotificationConfig`
+//   (`tasks/{task_id}/pushNotificationConfigs/{config_id}`): a webhook that
+//   the agent notifies of updates to one task.
+// - `AgentCard`: the agent's self-description (skills, capabilities,
+//   security requirements), read with `GetAgentCard`.
+//
+// This package defines the same service and messages as
+// `alis.open.agent.v1` with two differences: `Task` has no `name` field
+// (requests still address a task as `tasks/{task_id}`), and `Part` cannot
+// carry an arbitrary `google.protobuf.Any` message. The
+// `alis.a2a.extension` packages build on the vendored `lf.a2a.v1` contract
+// rather than on this package.
+
 import { enumDesc, fileDesc, messageDesc, serviceDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
 import { file_google_api_annotations } from "@alis-build/google-api/google/api/annotations_pb.js";
 import { file_google_api_client } from "@alis-build/google-api/google/api/client_pb.js";
@@ -350,6 +374,8 @@ export const TaskStateSchema = /*@__PURE__*/
   enumDesc(file_alis_open_agent_v2_a2a, 0);
 
 /**
+ * The set of states a Task can be in.
+ *
  * @generated from enum alis.open.agent.v2.TaskState
  */
 export const TaskState = /*@__PURE__*/
@@ -362,12 +388,25 @@ export const RoleSchema = /*@__PURE__*/
   enumDesc(file_alis_open_agent_v2_a2a, 1);
 
 /**
+ * Identifies the sender of a message.
+ *
  * @generated from enum alis.open.agent.v2.Role
  */
 export const Role = /*@__PURE__*/
   tsEnum(RoleSchema);
 
 /**
+ * A2AService defines the gRPC version of the A2A protocol. This has a slightly
+ * different shape than the JSONRPC version to better conform to AIP-127,
+ * where appropriate. The nouns are AgentCard, Message, Task and
+ * TaskPushNotificationConfig.
+ * - Messages are not a standard resource so there is no get/delete/update/list
+ *   interface, only a send and stream custom methods.
+ * - Tasks have a get interface and custom cancel and subscribe methods.
+ * - TaskPushNotificationConfig are a resource whose parent is a task.
+ *   They have get, list, create and delete methods.
+ * - AgentCard is a static resource with only a get method.
+ *
  * @generated from service alis.open.agent.v2.A2AService
  */
 export const A2AService = /*@__PURE__*/

package/package.json

@@ -25,5 +25,5 @@
   },
   "type": "module",
   "types": "./index.d.ts",
-  "version": "2.16.0"
+  "version": "2.17.0"
 }