@alis-build/alis-adk-sessions-v1 1.24.0 → 1.27.0

package/alis/adk/sessions/v1/sessions_pb.d.ts

@@ -1,7 +1,32 @@
-// @generated by protoc-gen-es v2.14.1 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/adk/sessions/v1/sessions.proto (package alis.adk.sessions.v1, syntax proto3)
 /* eslint-disable */
 
+// Stores agent sessions: conversations between a user and an agent, the
+// ordered events that make them up, and the state carried across them.
+//
+// `SessionService` manages two resources:
+//
+// - `Session` (`sessions/{session}`): one conversation, owned by a `user_id`
+//   within an `app_name`, with a key-value `state` and an expiry set through
+//   `expire_time` or `ttl`.
+// - `SessionEvent` (`sessions/{session}/events/{event}`): one message from the
+//   user or an agent, with its `Content`, model response metadata, and the
+//   `EventActions` the agent took (state deltas, artifact updates, agent
+//   transfers, tool confirmations, context compaction). Events are added with
+//   `AppendEvent`; events that share an `invocation_id` belong to the same
+//   agent invocation.
+//
+// `AppState` and `UserState` hold state shared across all sessions of an app,
+// or of one user within an app. Their keys appear with the `app:` and `user:`
+// prefixes in the merged session state view; no RPC in this package takes
+// them directly.
+//
+// `Content` and `Part` carry multi-part message content (text, media, function
+// calls and responses, executable code). The remaining messages describe model
+// output: grounding, citations, token usage, log probabilities, and why
+// generation stopped.
+
 import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
 import type { JsonObject, Message } from "@bufbuild/protobuf";
 import type { Duration, DurationJson, EmptySchema, FieldMask, FieldMaskJson, StructJson, Timestamp, TimestampJson, Value, ValueJson } from "@bufbuild/protobuf/wkt";
@@ -1561,11 +1586,11 @@ export declare type EventActions = Message<"alis.adk.sessions.v1.EventActions">
   escalate: boolean;
 
   /**
-   * Optional. Will only be set by a tool response indicating tool request
-   * authentication configuration.
+   * Optional. Will only be set by a tool response requesting that the user
+   * confirm a tool execution.
    * Map key is the function call ID since one function call response (from
    * model) could correspond to multiple function calls.
-   * Map value is the required auth config, which can be another struct.
+   * Map value is the confirmation request for that function call.
    *
    * @generated from field: map<string, alis.adk.sessions.v1.ToolConfirmation> requested_tool_confirmations = 7;
    */
@@ -1627,11 +1652,11 @@ export declare type EventActionsJson = {
   escalate?: boolean;
 
   /**
-   * Optional. Will only be set by a tool response indicating tool request
-   * authentication configuration.
+   * Optional. Will only be set by a tool response requesting that the user
+   * confirm a tool execution.
    * Map key is the function call ID since one function call response (from
    * model) could correspond to multiple function calls.
-   * Map value is the required auth config, which can be another struct.
+   * Map value is the confirmation request for that function call.
    *
    * @generated from field: map<string, alis.adk.sessions.v1.ToolConfirmation> requested_tool_confirmations = 7;
    */
@@ -2047,6 +2072,9 @@ export declare const ContentSchema: GenMessage<Content, {jsonType: ContentJson}>
  */
 export declare type Part = Message<"alis.adk.sessions.v1.Part"> & {
   /**
+   * The data carried by this part: text, inline or URI-based media, a
+   * function call or response, or executable code and its result.
+   *
    * @generated from oneof alis.adk.sessions.v1.Part.data
    */
   data: {
@@ -2113,6 +2141,9 @@ export declare type Part = Message<"alis.adk.sessions.v1.Part"> & {
   } | { case: undefined; value?: undefined };
 
   /**
+   * Metadata describing the media in `data`. `video_metadata` is the only
+   * option.
+   *
    * @generated from oneof alis.adk.sessions.v1.Part.metadata
    */
   metadata: {
@@ -2607,6 +2638,8 @@ export declare const FunctionResponseSchema: GenMessage<FunctionResponse, {jsonT
  */
 export declare type FunctionResponsePart = Message<"alis.adk.sessions.v1.FunctionResponsePart"> & {
   /**
+   * The media carried by this part, as inline bytes or a URI reference.
+   *
    * @generated from oneof alis.adk.sessions.v1.FunctionResponsePart.data
    */
   data: {

package/alis/adk/sessions/v1/sessions_pb.js

@@ -1,7 +1,32 @@
-// @generated by protoc-gen-es v2.14.1 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/adk/sessions/v1/sessions.proto (package alis.adk.sessions.v1, syntax proto3)
 /* eslint-disable */
 
+// Stores agent sessions: conversations between a user and an agent, the
+// ordered events that make them up, and the state carried across them.
+//
+// `SessionService` manages two resources:
+//
+// - `Session` (`sessions/{session}`): one conversation, owned by a `user_id`
+//   within an `app_name`, with a key-value `state` and an expiry set through
+//   `expire_time` or `ttl`.
+// - `SessionEvent` (`sessions/{session}/events/{event}`): one message from the
+//   user or an agent, with its `Content`, model response metadata, and the
+//   `EventActions` the agent took (state deltas, artifact updates, agent
+//   transfers, tool confirmations, context compaction). Events are added with
+//   `AppendEvent`; events that share an `invocation_id` belong to the same
+//   agent invocation.
+//
+// `AppState` and `UserState` hold state shared across all sessions of an app,
+// or of one user within an app. Their keys appear with the `app:` and `user:`
+// prefixes in the merged session state view; no RPC in this package takes
+// them directly.
+//
+// `Content` and `Part` carry multi-part message content (text, media, function
+// calls and responses, executable code). The remaining messages describe model
+// output: grounding, citations, token usage, log probabilities, and why
+// generation stopped.
+
 import { enumDesc, fileDesc, messageDesc, serviceDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_duration, file_google_protobuf_empty, file_google_protobuf_field_mask, file_google_protobuf_struct, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
 import { file_google_type_date } from "@alis-build/google-type/google/type/date_pb.js";

package/package.json

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