@livekit/protocol 1.53.0 → 1.53.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/protocol",
-  "version": "1.53.0",
+  "version": "1.53.2",
   "description": "",
   "type": "module",
   "require": "dist/index.cjs",
@@ -27,8 +27,9 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@bufbuild/protoc-gen-es": "^1.10.0",
+    "@typescript/typescript6": "6.0.2",
     "genversion": "^3.2.0",
-    "typescript": "5.9.3",
+    "typescript": "7.0.2",
     "unbuild": "^3.6.1"
   },
   "dependencies": {

package/src/gen/agent/livekit_agent_session_pb.d.ts

@@ -131,6 +131,46 @@ export declare enum ToolReplyStatus {
   TR_SKIPPED = 3,
 }
 
+/**
+ * Why an agent session closed. Agent evals read it from the recording upload's session
+ * summary (MetricsRecordingHeader.session_summary), as the value name.
+ *
+ * @generated from enum livekit.agent.CloseReason
+ */
+export declare enum CloseReason {
+  /**
+   * not reported, or an SDK-specific reason
+   *
+   * @generated from enum value: CR_UNKNOWN = 0;
+   */
+  CR_UNKNOWN = 0,
+
+  /**
+   * @generated from enum value: CR_ERROR = 1;
+   */
+  CR_ERROR = 1,
+
+  /**
+   * @generated from enum value: CR_JOB_SHUTDOWN = 2;
+   */
+  CR_JOB_SHUTDOWN = 2,
+
+  /**
+   * @generated from enum value: CR_PARTICIPANT_DISCONNECTED = 3;
+   */
+  CR_PARTICIPANT_DISCONNECTED = 3,
+
+  /**
+   * @generated from enum value: CR_USER_INITIATED = 4;
+   */
+  CR_USER_INITIATED = 4,
+
+  /**
+   * @generated from enum value: CR_COMPLETED = 5;
+   */
+  CR_COMPLETED = 5,
+}
+
 /**
  * @generated from enum livekit.agent.AmdCategory
  */

package/src/gen/agent/livekit_agent_session_pb.js

@@ -70,6 +70,24 @@ export const ToolReplyStatus = /*@__PURE__*/ proto3.makeEnum(
   ],
 );
 
+/**
+ * Why an agent session closed. Agent evals read it from the recording upload's session
+ * summary (MetricsRecordingHeader.session_summary), as the value name.
+ *
+ * @generated from enum livekit.agent.CloseReason
+ */
+export const CloseReason = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.agent.CloseReason",
+  [
+    {no: 0, name: "CR_UNKNOWN"},
+    {no: 1, name: "CR_ERROR"},
+    {no: 2, name: "CR_JOB_SHUTDOWN"},
+    {no: 3, name: "CR_PARTICIPANT_DISCONNECTED"},
+    {no: 4, name: "CR_USER_INITIATED"},
+    {no: 5, name: "CR_COMPLETED"},
+  ],
+);
+
 /**
  * @generated from enum livekit.agent.AmdCategory
  */

package/src/gen/livekit_agent_dispatch_pb.d.ts

@@ -40,6 +40,39 @@ export declare enum JobRestartPolicy {
   JRP_NEVER = 1,
 }
 
+/**
+ * what created the dispatch
+ *
+ * @generated from enum livekit.AgentDispatchTrigger
+ */
+export declare enum AgentDispatchTrigger {
+  /**
+   * @generated from enum value: ADT_UNSPECIFIED = 0;
+   */
+  ADT_UNSPECIFIED = 0,
+
+  /**
+   * a participant joining created the room, and with it the dispatch
+   *
+   * @generated from enum value: ADT_JOIN = 1;
+   */
+  ADT_JOIN = 1,
+
+  /**
+   * the CreateRoom API created the room, and with it the dispatch
+   *
+   * @generated from enum value: ADT_ROOM_API = 2;
+   */
+  ADT_ROOM_API = 2,
+
+  /**
+   * the CreateDispatch API
+   *
+   * @generated from enum value: ADT_DISPATCH_API = 3;
+   */
+  ADT_DISPATCH_API = 3,
+}
+
 /**
  * @generated from message livekit.CreateAgentDispatchRequest
  */
@@ -306,6 +339,11 @@ export declare class AgentDispatchState extends Message<AgentDispatchState> {
    */
   deletedAt: bigint;
 
+  /**
+   * @generated from field: livekit.AgentDispatchTrigger trigger = 4;
+   */
+  trigger: AgentDispatchTrigger;
+
   constructor(data?: PartialMessage<AgentDispatchState>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_agent_dispatch_pb.js

@@ -31,6 +31,21 @@ export const JobRestartPolicy = /*@__PURE__*/ proto3.makeEnum(
   ],
 );
 
+/**
+ * what created the dispatch
+ *
+ * @generated from enum livekit.AgentDispatchTrigger
+ */
+export const AgentDispatchTrigger = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.AgentDispatchTrigger",
+  [
+    {no: 0, name: "ADT_UNSPECIFIED"},
+    {no: 1, name: "ADT_JOIN"},
+    {no: 2, name: "ADT_ROOM_API"},
+    {no: 3, name: "ADT_DISPATCH_API"},
+  ],
+);
+
 /**
  * @generated from message livekit.CreateAgentDispatchRequest
  */
@@ -118,6 +133,7 @@ export const AgentDispatchState = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "jobs", kind: "message", T: Job, repeated: true },
     { no: 2, name: "created_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
     { no: 3, name: "deleted_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 4, name: "trigger", kind: "enum", T: proto3.getEnumType(AgentDispatchTrigger) },
   ],
 );
 

package/src/gen/livekit_agent_pb.d.ts

@@ -79,6 +79,51 @@ export declare enum JobStatus {
    * @generated from enum value: JS_FAILED = 3;
    */
   JS_FAILED = 3,
+
+  /**
+   * the job ended before it was assigned to an agent
+   *
+   * @generated from enum value: JS_CANCELLED = 4;
+   */
+  JS_CANCELLED = 4,
+}
+
+/**
+ * @generated from enum livekit.JobStateReason
+ */
+export declare enum JobStateReason {
+  /**
+   * @generated from enum value: JSR_UNSPECIFIED = 0;
+   */
+  JSR_UNSPECIFIED = 0,
+
+  /**
+   * no agent was available to accept the job
+   *
+   * @generated from enum value: JSR_NO_CAPACITY = 1;
+   */
+  JSR_NO_CAPACITY = 1,
+
+  /**
+   * the room closed before an agent was assigned
+   *
+   * @generated from enum value: JSR_ROOM_CLOSED = 2;
+   */
+  JSR_ROOM_CLOSED = 2,
+
+  /**
+   * the dispatch was deleted before an agent was assigned
+   *
+   * @generated from enum value: JSR_DISPATCH_DELETED = 3;
+   */
+  JSR_DISPATCH_DELETED = 3,
+
+  /**
+   * the job failed and is being dispatched again
+   *
+   * @generated from enum value: JSR_RETRYING = 4;
+   */
+  JSR_RETRYING = 4,
 }
 
 /**
@@ -151,6 +196,13 @@ export declare class Job extends Message<Job> {
    */
   enableRedaction: boolean;
 
+  /**
+   * when the server created the job, in Unix nanoseconds
+   *
+   * @generated from field: int64 created_at = 14;
+   */
+  createdAt: bigint;
+
   constructor(data?: PartialMessage<Job>);
 
   static readonly runtime: typeof proto3;
@@ -210,6 +262,27 @@ export declare class JobState extends Message<JobState> {
    */
   agentId: string;
 
+  /**
+   * why the job has no agent, for JS_PENDING and JS_CANCELLED jobs
+   *
+   * @generated from field: livekit.JobStateReason reason = 9;
+   */
+  reason: JobStateReason;
+
+  /**
+   * when the server received the worker's accept for this attempt, in Unix nanoseconds
+   *
+   * @generated from field: int64 accepted_at = 10;
+   */
+  acceptedAt: bigint;
+
+  /**
+   * when the server sent the assignment for this attempt, in Unix nanoseconds
+   *
+   * @generated from field: int64 assigned_at = 11;
+   */
+  assignedAt: bigint;
+
   constructor(data?: PartialMessage<JobState>);
 
   static readonly runtime: typeof proto3;
@@ -581,6 +654,14 @@ export declare class MigrateJobRequest extends Message<MigrateJobRequest> {
    */
   jobIds: string[];
 
+  /**
+   * the jobs in job_ids as they were assigned, with state.participant_identity
+   * set to the identity the worker accepted them with
+   *
+   * @generated from field: repeated livekit.Job jobs = 3;
+   */
+  jobs: Job[];
+
   constructor(data?: PartialMessage<MigrateJobRequest>);
 
   static readonly runtime: typeof proto3;
@@ -712,6 +793,13 @@ export declare class UpdateJobStatus extends Message<UpdateJobStatus> {
    */
   error: string;
 
+  /**
+   * set once the agent has connected to the room
+   *
+   * @generated from field: livekit.JobJoinTiming join_timing = 4;
+   */
+  joinTiming?: JobJoinTiming;
+
   constructor(data?: PartialMessage<UpdateJobStatus>);
 
   static readonly runtime: typeof proto3;
@@ -727,6 +815,85 @@ export declare class UpdateJobStatus extends Message<UpdateJobStatus> {
   static equals(a: UpdateJobStatus | PlainMessage<UpdateJobStatus> | undefined, b: UpdateJobStatus | PlainMessage<UpdateJobStatus> | undefined): boolean;
 }
 
+/**
+ * Instants of one agent join on the worker host's monotonic clock, in microseconds. The
+ * clock origin is arbitrary, so only differences between these values carry meaning on
+ * their own. The worker and its job processes share this clock.
+ *
+ * @generated from message livekit.JobJoinTiming
+ */
+export declare class JobJoinTiming extends Message<JobJoinTiming> {
+  /**
+   * availability request received
+   *
+   * @generated from field: int64 offer_received_us = 1;
+   */
+  offerReceivedUs: bigint;
+
+  /**
+   * request handler accepted the job
+   *
+   * @generated from field: int64 accepted_us = 2;
+   */
+  acceptedUs: bigint;
+
+  /**
+   * job assignment received
+   *
+   * @generated from field: int64 assignment_received_us = 3;
+   */
+  assignmentReceivedUs: bigint;
+
+  /**
+   * a job process was handed the job
+   *
+   * @generated from field: int64 launched_us = 4;
+   */
+  launchedUs: bigint;
+
+  /**
+   * an idle process took the job; false means one was spawned
+   *
+   * @generated from field: bool launch_warm = 5;
+   */
+  launchWarm: boolean;
+
+  /**
+   * the agent's entrypoint started
+   *
+   * @generated from field: int64 entrypoint_started_us = 6;
+   */
+  entrypointStartedUs: bigint;
+
+  /**
+   * the agent called room connect
+   *
+   * @generated from field: int64 connect_called_us = 7;
+   */
+  connectCalledUs: bigint;
+
+  /**
+   * the agent's primary transport connected
+   *
+   * @generated from field: int64 connected_us = 8;
+   */
+  connectedUs: bigint;
+
+  constructor(data?: PartialMessage<JobJoinTiming>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.JobJoinTiming";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): JobJoinTiming;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): JobJoinTiming;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): JobJoinTiming;
+
+  static equals(a: JobJoinTiming | PlainMessage<JobJoinTiming> | undefined, b: JobJoinTiming | PlainMessage<JobJoinTiming> | undefined): boolean;
+}
+
 /**
  * @generated from message livekit.UpdateWorkerStatus
  */

package/src/gen/livekit_agent_pb.js

@@ -53,6 +53,21 @@ export const JobStatus = /*@__PURE__*/ proto3.makeEnum(
     {no: 1, name: "JS_RUNNING"},
     {no: 2, name: "JS_SUCCESS"},
     {no: 3, name: "JS_FAILED"},
+    {no: 4, name: "JS_CANCELLED"},
+  ],
+);
+
+/**
+ * @generated from enum livekit.JobStateReason
+ */
+export const JobStateReason = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.JobStateReason",
+  [
+    {no: 0, name: "JSR_UNSPECIFIED"},
+    {no: 1, name: "JSR_NO_CAPACITY"},
+    {no: 2, name: "JSR_ROOM_CLOSED"},
+    {no: 3, name: "JSR_DISPATCH_DELETED"},
+    {no: 4, name: "JSR_RETRYING"},
   ],
 );
 
@@ -75,6 +90,7 @@ export const Job = /*@__PURE__*/ proto3.makeMessageType(
     { no: 11, name: "deployment", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 12, name: "attributes", kind: "map", K: 9 /* ScalarType.STRING */, V: {kind: "scalar", T: 9 /* ScalarType.STRING */} },
     { no: 13, name: "enable_redaction", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 14, name: "created_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
   ],
 );
 
@@ -92,6 +108,9 @@ export const JobState = /*@__PURE__*/ proto3.makeMessageType(
     { no: 6, name: "participant_identity", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 7, name: "worker_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 8, name: "agent_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 9, name: "reason", kind: "enum", T: proto3.getEnumType(JobStateReason) },
+    { no: 10, name: "accepted_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 11, name: "assigned_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
   ],
 );
 
@@ -201,6 +220,7 @@ export const MigrateJobRequest = /*@__PURE__*/ proto3.makeMessageType(
   "livekit.MigrateJobRequest",
   () => [
     { no: 2, name: "job_ids", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 3, name: "jobs", kind: "message", T: Job, repeated: true },
   ],
 );
 
@@ -241,6 +261,28 @@ export const UpdateJobStatus = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "job_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 2, name: "status", kind: "enum", T: proto3.getEnumType(JobStatus) },
     { no: 3, name: "error", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "join_timing", kind: "message", T: JobJoinTiming },
+  ],
+);
+
+/**
+ * Instants of one agent join on the worker host's monotonic clock, in microseconds. The
+ * clock origin is arbitrary, so only differences between these values carry meaning on
+ * their own. The worker and its job processes share this clock.
+ *
+ * @generated from message livekit.JobJoinTiming
+ */
+export const JobJoinTiming = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.JobJoinTiming",
+  () => [
+    { no: 1, name: "offer_received_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "accepted_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 3, name: "assignment_received_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 4, name: "launched_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 5, name: "launch_warm", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 6, name: "entrypoint_started_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 7, name: "connect_called_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 8, name: "connected_us", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
   ],
 );