@livekit/protocol 1.52.0 → 1.53.0

package/src/gen/livekit_agent_pb.js

@@ -126,6 +126,7 @@ export const ServerMessage = /*@__PURE__*/ proto3.makeMessageType(
     { no: 3, name: "assignment", kind: "message", T: JobAssignment, oneof: "message" },
     { no: 5, name: "termination", kind: "message", T: JobTermination, oneof: "message" },
     { no: 4, name: "pong", kind: "message", T: WorkerPong, oneof: "message" },
+    { no: 6, name: "go_away", kind: "message", T: AgentHttp_GoAway, oneof: "message" },
   ],
 );
 
@@ -175,6 +176,9 @@ export const RegisterWorkerRequest = /*@__PURE__*/ proto3.makeMessageType(
     { no: 6, name: "namespace", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 7, name: "allowed_permissions", kind: "message", T: ParticipantPermission },
     { no: 9, name: "deployment", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 10, name: "endpoints", kind: "message", T: AgentHttp_AgentEndpoint, repeated: true },
+    { no: 11, name: "instance_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 12, name: "endpoint_protocol", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
   ],
 );
 
@@ -186,6 +190,7 @@ export const RegisterWorkerResponse = /*@__PURE__*/ proto3.makeMessageType(
   () => [
     { no: 1, name: "worker_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 3, name: "server_info", kind: "message", T: ServerInfo },
+    { no: 4, name: "endpoint_settings", kind: "message", T: AgentHttp_AgentEndpointSettings },
   ],
 );
 
@@ -248,6 +253,8 @@ export const UpdateWorkerStatus = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "status", kind: "enum", T: proto3.getEnumType(WorkerStatus), opt: true },
     { no: 3, name: "load", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
     { no: 4, name: "job_count", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 5, name: "draining", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 6, name: "seq", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
   ],
 );
 
@@ -273,3 +280,149 @@ export const JobTermination = /*@__PURE__*/ proto3.makeMessageType(
   ],
 );
 
+/**
+ * ----- agent HTTP endpoints data plane -----
+ *
+ * AgentHttp namespaces the data plane: workers expose HTTP endpoints served at
+ * /agents/{agent_name}/{deployment}/{path} without binding any local listener.
+ * The worker opens ONE WebTransport (QUIC) session to /agent that carries both
+ * its control stream (the same WorkerMessage/ServerMessage exchange as the
+ * WebSocket control connection, length-delimited) and every HTTP exchange: the
+ * node opens one bidirectional QUIC stream per request. QUIC provides the
+ * multiplexing and per-stream flow control, so there is no credit accounting
+ * and no attach handshake.
+ *
+ * Each exchange stream is:
+ *
+ *   [len:u32be][StreamPreamble]   the only LiveKit framing
+ *   [ ... opaque bytes ... ]      one HTTP/1.1 exchange, to FIN or RESET_STREAM
+ *
+ * After the preamble the stream is byte-transparent: the node writes a
+ * canonical HTTP/1.1 request and the worker replies with an HTTP/1.1 response,
+ * each parsed by whatever HTTP implementation the side already has. A WebSocket
+ * upgrade is therefore an ordinary request whose response is a 101, after which
+ * the stream is a byte pipe. The protocol evolves by version negotiation at
+ * registration, so the preamble carries no version of its own.
+ *
+ * Bodies use ordinary HTTP/1.1 framing, Content-Length or chunked, and are
+ * unbounded: a body may be many gigabytes and must be streamed. Request and
+ * response size limits are policy for the layer above.
+ *
+ * How one direction ends:
+ *
+ *   success             end of message per the body's own framing, then FIN.
+ *   failed mid-body     chunked trailer fields x-lk-completion and x-lk-error,
+ *                       in band, so the outcome cannot race the bytes it
+ *                       describes.
+ *   failed before any   RESET_STREAM carrying an HttpStreamResetCode, sound
+ *   bytes               only here, where nothing is in flight.
+ *
+ * FIN before the body's own framing says it is complete is truncation, and a
+ * receiver must surface it as such.
+ *
+ * The x-lk- header prefix is reserved for this signalling in both directions.
+ * A node strips it from client-supplied request headers, so a client cannot
+ * forge one, and strips it from responses, so it never reaches the end client.
+ *
+ * @generated from message livekit.AgentHttp
+ */
+export const AgentHttp = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentHttp",
+  [],
+);
+
+/**
+ * @generated from enum livekit.AgentHttp.AgentEndpointKind
+ */
+export const AgentHttp_AgentEndpointKind = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.AgentHttp.AgentEndpointKind",
+  [
+    {no: 0, name: "AEK_HTTP"},
+    {no: 1, name: "AEK_TEXT"},
+  ],
+);
+
+/**
+ * why a stream was reset before any HTTP bytes flowed. This travels as the
+ * QUIC RESET_STREAM / STOP_SENDING error code, so it is a number with no room
+ * for detail: the reason string is logged by the side that reset and joined
+ * to this by request_id. An outcome after bytes have flowed travels in
+ * trailers instead, where it cannot race them.
+ *
+ * @generated from enum livekit.AgentHttp.HttpStreamResetCode
+ */
+export const AgentHttp_HttpStreamResetCode = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.AgentHttp.HttpStreamResetCode",
+  [
+    {no: 0, name: "HSR_ABORT"},
+    {no: 1, name: "HSR_REFUSED"},
+    {no: 2, name: "HSR_INTERNAL"},
+    {no: 3, name: "HSR_TIMEOUT"},
+    {no: 4, name: "HSR_PROTOCOL"},
+  ],
+);
+
+/**
+ * @generated from message livekit.AgentHttp.AgentEndpoint
+ */
+export const AgentHttp_AgentEndpoint = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentHttp.AgentEndpoint",
+  () => [
+    { no: 1, name: "path", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "methods", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 3, name: "kind", kind: "enum", T: proto3.getEnumType(AgentHttp_AgentEndpointKind) },
+    { no: 4, name: "public", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+  {localName: "AgentHttp_AgentEndpoint"},
+);
+
+/**
+ * registration-level settings negotiated on the control connection, returned
+ * in RegisterWorkerResponse when the worker declares endpoints and the server
+ * supports the data plane.
+ *
+ * @generated from message livekit.AgentHttp.AgentEndpointSettings
+ */
+export const AgentHttp_AgentEndpointSettings = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentHttp.AgentEndpointSettings",
+  () => [
+    { no: 1, name: "protocol", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+  {localName: "AgentHttp_AgentEndpointSettings"},
+);
+
+/**
+ * the first thing on every exchange stream, node -> worker. It carries only
+ * what the worker cannot derive from the HTTP bytes that follow and what it
+ * must not infer from client-supplied headers - identity above all.
+ *
+ * @generated from message livekit.AgentHttp.StreamPreamble
+ */
+export const AgentHttp_StreamPreamble = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentHttp.StreamPreamble",
+  () => [
+    { no: 1, name: "kind", kind: "enum", T: proto3.getEnumType(AgentHttp_AgentEndpointKind) },
+    { no: 2, name: "request_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "authorized", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 4, name: "route", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 5, name: "timeout_ms", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 6, name: "client_addr", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 7, name: "scheme", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+  {localName: "AgentHttp_StreamPreamble"},
+);
+
+/**
+ * the server is draining: the worker should re-register elsewhere; in-flight
+ * HTTP exchanges run to completion
+ *
+ * @generated from message livekit.AgentHttp.GoAway
+ */
+export const AgentHttp_GoAway = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentHttp.GoAway",
+  () => [
+    { no: 1, name: "reason", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+  {localName: "AgentHttp_GoAway"},
+);
+

package/src/gen/livekit_agent_simulation_pb.d.ts

@@ -258,6 +258,13 @@ export declare class SimulationRun extends Message<SimulationRun> {
    */
   ci?: SimulationRun_CI;
 
+  /**
+   * Absent when the run ran each scenario once and required it to pass.
+   *
+   * @generated from field: optional livekit.SimulationRun.SamplingOptions sampling = 23;
+   */
+  sampling?: SimulationRun_SamplingOptions;
+
   constructor(data?: PartialMessage<SimulationRun>);
 
   static readonly runtime: typeof proto3;
@@ -384,6 +391,22 @@ export declare class SimulationRun_Job extends Message<SimulationRun_Job> {
    */
   metrics?: SimulationRun_JobMetrics;
 
+  /**
+   * The Scenario.id this job ran; empty for generated runs. Every sample
+   * of one scenario shares it, so a run's jobs group back into scenarios.
+   *
+   * @generated from field: string scenario_id = 15;
+   */
+  scenarioId: string;
+
+  /**
+   * 1-based sample of that scenario within the run; always 1 when the run's
+   * samples is 1.
+   *
+   * @generated from field: int32 sample = 16;
+   */
+  sample: number;
+
   constructor(data?: PartialMessage<SimulationRun_Job>);
 
   static readonly runtime: typeof proto3;
@@ -1194,6 +1217,45 @@ export declare class SimulationRun_CI extends Message<SimulationRun_CI> {
   static equals(a: SimulationRun_CI | PlainMessage<SimulationRun_CI> | undefined, b: SimulationRun_CI | PlainMessage<SimulationRun_CI> | undefined): boolean;
 }
 
+/**
+ * Runs each scenario more than once, so a flaky sample is distinguishable
+ * from a broken scenario. Both fields are required when it is present.
+ *
+ * @generated from message livekit.SimulationRun.SamplingOptions
+ */
+export declare class SimulationRun_SamplingOptions extends Message<SimulationRun_SamplingOptions> {
+  /**
+   * Samples per scenario, > 1. The run holds scenarios × samples jobs,
+   * subject to the usual job cap.
+   *
+   * @generated from field: int32 samples = 1;
+   */
+  samples: number;
+
+  /**
+   * The share of a scenario's samples that must pass for that scenario to
+   * pass, 0-1. A scenario needs round(rate × samples) of them, so 1
+   * requires every sample and 0.67 of 3 requires 2.
+   *
+   * @generated from field: double pass_rate = 2;
+   */
+  passRate: number;
+
+  constructor(data?: PartialMessage<SimulationRun_SamplingOptions>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.SimulationRun.SamplingOptions";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SimulationRun_SamplingOptions;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SimulationRun_SamplingOptions;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SimulationRun_SamplingOptions;
+
+  static equals(a: SimulationRun_SamplingOptions | PlainMessage<SimulationRun_SamplingOptions> | undefined, b: SimulationRun_SamplingOptions | PlainMessage<SimulationRun_SamplingOptions> | undefined): boolean;
+}
+
 /**
  * @generated from message livekit.SimulationRun.Create
  */
@@ -1282,6 +1344,15 @@ export declare class SimulationRun_Create_Request extends Message<SimulationRun_
    */
   ci?: SimulationRun_CI;
 
+  /**
+   * Absent runs each scenario once and requires it to pass. Requires
+   * scenario_group. The run fails if any scenario fails; pass@k and
+   * pass^k report over scenarios and neither gates.
+   *
+   * @generated from field: optional livekit.SimulationRun.SamplingOptions sampling = 14;
+   */
+  sampling?: SimulationRun_SamplingOptions;
+
   constructor(data?: PartialMessage<SimulationRun_Create_Request>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_agent_simulation_pb.js

@@ -91,6 +91,7 @@ export const SimulationRun = /*@__PURE__*/ proto3.makeMessageType(
     { no: 20, name: "summary_zstd", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
     { no: 21, name: "issue_count", kind: "scalar", T: 5 /* ScalarType.INT32 */, opt: true },
     { no: 22, name: "ci", kind: "message", T: SimulationRun_CI, opt: true },
+    { no: 23, name: "sampling", kind: "message", T: SimulationRun_SamplingOptions, opt: true },
   ],
 );
 
@@ -129,6 +130,8 @@ export const SimulationRun_Job = /*@__PURE__*/ proto3.makeMessageType(
     { no: 12, name: "room_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 13, name: "usage", kind: "message", T: SimulationRun_Job_Usage },
     { no: 14, name: "metrics", kind: "message", T: SimulationRun_JobMetrics },
+    { no: 15, name: "scenario_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 16, name: "sample", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
   ],
   {localName: "SimulationRun_Job"},
 );
@@ -343,6 +346,21 @@ export const SimulationRun_CI = /*@__PURE__*/ proto3.makeMessageType(
   {localName: "SimulationRun_CI"},
 );
 
+/**
+ * Runs each scenario more than once, so a flaky sample is distinguishable
+ * from a broken scenario. Both fields are required when it is present.
+ *
+ * @generated from message livekit.SimulationRun.SamplingOptions
+ */
+export const SimulationRun_SamplingOptions = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.SimulationRun.SamplingOptions",
+  () => [
+    { no: 1, name: "samples", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 2, name: "pass_rate", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+  ],
+  {localName: "SimulationRun_SamplingOptions"},
+);
+
 /**
  * @generated from message livekit.SimulationRun.Create
  */
@@ -369,6 +387,7 @@ export const SimulationRun_Create_Request = /*@__PURE__*/ proto3.makeMessageType
     { no: 11, name: "low_quality_microphone", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 12, name: "packet_loss", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 13, name: "ci", kind: "message", T: SimulationRun_CI, opt: true },
+    { no: 14, name: "sampling", kind: "message", T: SimulationRun_SamplingOptions, opt: true },
   ],
   {localName: "SimulationRun_Create_Request"},
 );

package/src/gen/livekit_agentdb_pb.d.ts

@@ -12,12 +12,16 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// AgentDB: per-agent SQLite databases. Each lives in its project's data region
+// on object storage, with one writer at a time. Queries run over the WebSocket
+// data plane (AgentDB.Wire); lifecycle is cloud-protocol's AgentDB service.
+
 // @generated by protoc-gen-es v1.10.1 with parameter "target=dts+js"
 // @generated from file livekit_agentdb.proto (package livekit, syntax proto3)
 /* eslint-disable */
 // @ts-nocheck
 
-import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
+import type { BinaryReadOptions, Duration, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage, Timestamp } from "@bufbuild/protobuf";
 import { Message, proto3 } from "@bufbuild/protobuf";
 
 /**
@@ -47,17 +51,12 @@ export declare class AgentDB extends Message<AgentDB> {
  */
 export declare class AgentDB_CreateRequest extends Message<AgentDB_CreateRequest> {
   /**
-   * @generated from field: string region = 1;
-   */
-  region: string;
-
-  /**
-   * Unset: never expires, and expires_at is then 0 everywhere.
+   * Unset: never expires, and expires_at is then unset everywhere.
    * Otherwise clamped to the server cap, and never extended.
    *
-   * @generated from field: int64 ttl_seconds = 2;
+   * @generated from field: google.protobuf.Duration ttl = 1;
    */
-  ttlSeconds: bigint;
+  ttl?: Duration;
 
   constructor(data?: PartialMessage<AgentDB_CreateRequest>);
 
@@ -86,9 +85,9 @@ export declare class AgentDB_CreateResponse extends Message<AgentDB_CreateRespon
   databaseId: string;
 
   /**
-   * @generated from field: int64 expires_at = 2;
+   * @generated from field: google.protobuf.Timestamp expires_at = 2;
    */
-  expiresAt: bigint;
+  expiresAt?: Timestamp;
 
   constructor(data?: PartialMessage<AgentDB_CreateResponse>);
 
@@ -208,14 +207,14 @@ export declare class AgentDB_AgentDatabase extends Message<AgentDB_AgentDatabase
   region: string;
 
   /**
-   * @generated from field: int64 created_at = 3;
+   * @generated from field: google.protobuf.Timestamp created_at = 3;
    */
-  createdAt: bigint;
+  createdAt?: Timestamp;
 
   /**
-   * @generated from field: int64 expires_at = 4;
+   * @generated from field: google.protobuf.Timestamp expires_at = 4;
    */
-  expiresAt: bigint;
+  expiresAt?: Timestamp;
 
   /**
    * @generated from field: int64 tip = 5;
@@ -281,33 +280,33 @@ export declare class AgentDB_DeleteResponse extends Message<AgentDB_DeleteRespon
 }
 
 /**
- * @generated from message livekit.AgentDB.DumpRequest
+ * @generated from message livekit.AgentDB.ExportRequest
  */
-export declare class AgentDB_DumpRequest extends Message<AgentDB_DumpRequest> {
+export declare class AgentDB_ExportRequest extends Message<AgentDB_ExportRequest> {
   /**
    * @generated from field: string database_id = 1;
    */
   databaseId: string;
 
-  constructor(data?: PartialMessage<AgentDB_DumpRequest>);
+  constructor(data?: PartialMessage<AgentDB_ExportRequest>);
 
   static readonly runtime: typeof proto3;
-  static readonly typeName = "livekit.AgentDB.DumpRequest";
+  static readonly typeName = "livekit.AgentDB.ExportRequest";
   static readonly fields: FieldList;
 
-  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): AgentDB_DumpRequest;
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): AgentDB_ExportRequest;
 
-  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): AgentDB_DumpRequest;
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): AgentDB_ExportRequest;
 
-  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): AgentDB_DumpRequest;
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): AgentDB_ExportRequest;
 
-  static equals(a: AgentDB_DumpRequest | PlainMessage<AgentDB_DumpRequest> | undefined, b: AgentDB_DumpRequest | PlainMessage<AgentDB_DumpRequest> | undefined): boolean;
+  static equals(a: AgentDB_ExportRequest | PlainMessage<AgentDB_ExportRequest> | undefined, b: AgentDB_ExportRequest | PlainMessage<AgentDB_ExportRequest> | undefined): boolean;
 }
 
 /**
- * @generated from message livekit.AgentDB.DumpResponse
+ * @generated from message livekit.AgentDB.ExportResponse
  */
-export declare class AgentDB_DumpResponse extends Message<AgentDB_DumpResponse> {
+export declare class AgentDB_ExportResponse extends Message<AgentDB_ExportResponse> {
   /**
    * pre-authenticated object-storage URL
    *
@@ -318,30 +317,30 @@ export declare class AgentDB_DumpResponse extends Message<AgentDB_DumpResponse>
   /**
    * of the URL, not the database
    *
-   * @generated from field: int64 expires_at = 2;
+   * @generated from field: google.protobuf.Timestamp expires_at = 2;
    */
-  expiresAt: bigint;
+  expiresAt?: Timestamp;
 
   /**
-   * what the dump is consistent at
+   * what the export is consistent at
    *
    * @generated from field: int64 tip = 3;
    */
   tip: bigint;
 
-  constructor(data?: PartialMessage<AgentDB_DumpResponse>);
+  constructor(data?: PartialMessage<AgentDB_ExportResponse>);
 
   static readonly runtime: typeof proto3;
-  static readonly typeName = "livekit.AgentDB.DumpResponse";
+  static readonly typeName = "livekit.AgentDB.ExportResponse";
   static readonly fields: FieldList;
 
-  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): AgentDB_DumpResponse;
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): AgentDB_ExportResponse;
 
-  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): AgentDB_DumpResponse;
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): AgentDB_ExportResponse;
 
-  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): AgentDB_DumpResponse;
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): AgentDB_ExportResponse;
 
-  static equals(a: AgentDB_DumpResponse | PlainMessage<AgentDB_DumpResponse> | undefined, b: AgentDB_DumpResponse | PlainMessage<AgentDB_DumpResponse> | undefined): boolean;
+  static equals(a: AgentDB_ExportResponse | PlainMessage<AgentDB_ExportResponse> | undefined, b: AgentDB_ExportResponse | PlainMessage<AgentDB_ExportResponse> | undefined): boolean;
 }
 
 /**
@@ -445,6 +444,8 @@ export declare class AgentDB_Wire_ClientMessage extends Message<AgentDB_Wire_Cli
     case: "query";
   } | {
     /**
+     * answers one result per statement, then Done
+     *
      * @generated from field: livekit.AgentDB.Wire.Batch batch = 5;
      */
     value: AgentDB_Wire_Batch;
@@ -668,12 +669,17 @@ export declare class AgentDB_Wire_Statement extends Message<AgentDB_Wire_Stateme
 }
 
 /**
+ * Applied atomically, in order, and answered with one result per
+ * statement, in order: Columns then ColumnBatch frames for a statement
+ * that returns rows, one ExecResult for one that does not, each tagged
+ * with the statement's 0-based index, then a single Done for the whole
+ * batch. A statement that returns no rows still sends its Columns. Credit
+ * paces the ColumnBatch frames of the batch as a whole.
+ *
  * @generated from message livekit.AgentDB.Wire.Batch
  */
 export declare class AgentDB_Wire_Batch extends Message<AgentDB_Wire_Batch> {
   /**
-   * applied atomically, in order
-   *
    * @generated from field: repeated livekit.AgentDB.Wire.Statement statements = 1;
    */
   statements: AgentDB_Wire_Statement[];
@@ -920,6 +926,13 @@ export declare class AgentDB_Wire_Columns extends Message<AgentDB_Wire_Columns>
    */
   names: string[];
 
+  /**
+   * index within a Batch; 0 and unused for a Query
+   *
+   * @generated from field: uint32 statement = 2;
+   */
+  statement: number;
+
   constructor(data?: PartialMessage<AgentDB_Wire_Columns>);
 
   static readonly runtime: typeof proto3;
@@ -1013,6 +1026,13 @@ export declare class AgentDB_Wire_ColumnBatch extends Message<AgentDB_Wire_Colum
    */
   rows: number;
 
+  /**
+   * index within a Batch; 0 and unused for a Query
+   *
+   * @generated from field: uint32 statement = 3;
+   */
+  statement: number;
+
   constructor(data?: PartialMessage<AgentDB_Wire_ColumnBatch>);
 
   static readonly runtime: typeof proto3;
@@ -1047,6 +1067,13 @@ export declare class AgentDB_Wire_ExecResult extends Message<AgentDB_Wire_ExecRe
    */
   tip: bigint;
 
+  /**
+   * index within a Batch; 0 and unused for an Exec
+   *
+   * @generated from field: uint32 statement = 4;
+   */
+  statement: number;
+
   constructor(data?: PartialMessage<AgentDB_Wire_ExecResult>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_agentdb_pb.js

@@ -12,12 +12,16 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
+// AgentDB: per-agent SQLite databases. Each lives in its project's data region
+// on object storage, with one writer at a time. Queries run over the WebSocket
+// data plane (AgentDB.Wire); lifecycle is cloud-protocol's AgentDB service.
+
 // @generated by protoc-gen-es v1.10.1 with parameter "target=dts+js"
 // @generated from file livekit_agentdb.proto (package livekit, syntax proto3)
 /* eslint-disable */
 // @ts-nocheck
 
-import { proto3 } from "@bufbuild/protobuf";
+import { Duration, proto3, Timestamp } from "@bufbuild/protobuf";
 
 /**
  * Nested so that names like Value and Ping need not be unique across the
@@ -36,8 +40,7 @@ export const AgentDB = /*@__PURE__*/ proto3.makeMessageType(
 export const AgentDB_CreateRequest = /*@__PURE__*/ proto3.makeMessageType(
   "livekit.AgentDB.CreateRequest",
   () => [
-    { no: 1, name: "region", kind: "scalar", T: 9 /* ScalarType.STRING */ },
-    { no: 2, name: "ttl_seconds", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 1, name: "ttl", kind: "message", T: Duration },
   ],
   {localName: "AgentDB_CreateRequest"},
 );
@@ -49,7 +52,7 @@ export const AgentDB_CreateResponse = /*@__PURE__*/ proto3.makeMessageType(
   "livekit.AgentDB.CreateResponse",
   () => [
     { no: 1, name: "database_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
-    { no: 2, name: "expires_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "expires_at", kind: "message", T: Timestamp },
   ],
   {localName: "AgentDB_CreateResponse"},
 );
@@ -99,8 +102,8 @@ export const AgentDB_AgentDatabase = /*@__PURE__*/ proto3.makeMessageType(
   () => [
     { no: 1, name: "database_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 2, name: "region", kind: "scalar", T: 9 /* ScalarType.STRING */ },
-    { no: 3, name: "created_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
-    { no: 4, name: "expires_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 3, name: "created_at", kind: "message", T: Timestamp },
+    { no: 4, name: "expires_at", kind: "message", T: Timestamp },
     { no: 5, name: "tip", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
   ],
   {localName: "AgentDB_AgentDatabase"},
@@ -127,27 +130,27 @@ export const AgentDB_DeleteResponse = /*@__PURE__*/ proto3.makeMessageType(
 );
 
 /**
- * @generated from message livekit.AgentDB.DumpRequest
+ * @generated from message livekit.AgentDB.ExportRequest
  */
-export const AgentDB_DumpRequest = /*@__PURE__*/ proto3.makeMessageType(
-  "livekit.AgentDB.DumpRequest",
+export const AgentDB_ExportRequest = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentDB.ExportRequest",
   () => [
     { no: 1, name: "database_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
   ],
-  {localName: "AgentDB_DumpRequest"},
+  {localName: "AgentDB_ExportRequest"},
 );
 
 /**
- * @generated from message livekit.AgentDB.DumpResponse
+ * @generated from message livekit.AgentDB.ExportResponse
  */
-export const AgentDB_DumpResponse = /*@__PURE__*/ proto3.makeMessageType(
-  "livekit.AgentDB.DumpResponse",
+export const AgentDB_ExportResponse = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.AgentDB.ExportResponse",
   () => [
     { no: 1, name: "download_url", kind: "scalar", T: 9 /* ScalarType.STRING */ },
-    { no: 2, name: "expires_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "expires_at", kind: "message", T: Timestamp },
     { no: 3, name: "tip", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
   ],
-  {localName: "AgentDB_DumpResponse"},
+  {localName: "AgentDB_ExportResponse"},
 );
 
 /**
@@ -257,6 +260,13 @@ export const AgentDB_Wire_Statement = /*@__PURE__*/ proto3.makeMessageType(
 );
 
 /**
+ * Applied atomically, in order, and answered with one result per
+ * statement, in order: Columns then ColumnBatch frames for a statement
+ * that returns rows, one ExecResult for one that does not, each tagged
+ * with the statement's 0-based index, then a single Done for the whole
+ * batch. A statement that returns no rows still sends its Columns. Credit
+ * paces the ColumnBatch frames of the batch as a whole.
+ *
  * @generated from message livekit.AgentDB.Wire.Batch
  */
 export const AgentDB_Wire_Batch = /*@__PURE__*/ proto3.makeMessageType(
@@ -369,6 +379,7 @@ export const AgentDB_Wire_Columns = /*@__PURE__*/ proto3.makeMessageType(
   "livekit.AgentDB.Wire.Columns",
   () => [
     { no: 1, name: "names", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 2, name: "statement", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
   ],
   {localName: "AgentDB_Wire_Columns"},
 );
@@ -404,6 +415,7 @@ export const AgentDB_Wire_ColumnBatch = /*@__PURE__*/ proto3.makeMessageType(
   () => [
     { no: 1, name: "columns", kind: "message", T: AgentDB_Wire_Column, repeated: true },
     { no: 2, name: "rows", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 3, name: "statement", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
   ],
   {localName: "AgentDB_Wire_ColumnBatch"},
 );
@@ -417,6 +429,7 @@ export const AgentDB_Wire_ExecResult = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "rows_affected", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
     { no: 2, name: "last_insert_id", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
     { no: 3, name: "tip", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 4, name: "statement", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
   ],
   {localName: "AgentDB_Wire_ExecResult"},
 );