@livekit/protocol 1.53.1 → 1.53.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/protocol",
-  "version": "1.53.1",
+  "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/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

@@ -196,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;
@@ -262,6 +269,20 @@ export declare class JobState extends Message<JobState> {
    */
   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;
@@ -772,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;
@@ -787,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

@@ -90,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 */ },
   ],
 );
 
@@ -108,6 +109,8 @@ export const JobState = /*@__PURE__*/ proto3.makeMessageType(
     { 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 */ },
   ],
 );
 
@@ -258,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 */ },
   ],
 );
 

package/src/gen/livekit_agent_simulation_pb.d.ts

@@ -1476,6 +1476,27 @@ export declare class SimulationRun_Create_Request extends Message<SimulationRun_
    */
   sampling?: SimulationRun_SamplingOptions;
 
+  /**
+   * When set, every job dials this number over SIP instead of dispatching
+   * agent_name, as CreateSIPParticipantRequest would. AUDIO mode only.
+   *
+   * @generated from field: string sip_call_to = 15;
+   */
+  sipCallTo: string;
+
+  /**
+   * Outbound trunk to dial through. Empty dials from sip_number, which must
+   * then be a LiveKit phone number the project owns.
+   *
+   * @generated from field: string sip_trunk_id = 16;
+   */
+  sipTrunkId: string;
+
+  /**
+   * @generated from field: string sip_number = 17;
+   */
+  sipNumber: string;
+
   constructor(data?: PartialMessage<SimulationRun_Create_Request>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_agent_simulation_pb.js

@@ -422,6 +422,9 @@ export const SimulationRun_Create_Request = /*@__PURE__*/ proto3.makeMessageType
     { 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 },
+    { no: 15, name: "sip_call_to", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 16, name: "sip_trunk_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 17, name: "sip_number", kind: "scalar", T: 9 /* ScalarType.STRING */ },
   ],
   {localName: "SimulationRun_Create_Request"},
 );

package/src/gen/livekit_internal_pb.d.ts

@@ -485,11 +485,11 @@ export declare class NodeStats extends Message<NodeStats> {
   forwardJitter: number;
 
   /**
-   * p90 time from arrival to dequeue, in ns, for packets that found their forwarder idle
+   * mean forwarding work per write to a subscriber, in ns: (end of fan-out - dequeue) / writes
    *
-   * @generated from field: uint32 forward_scheduling_delay = 57;
+   * @generated from field: uint32 forward_processing_per_write = 57;
    */
-  forwardSchedulingDelay: number;
+  forwardProcessingPerWrite: number;
 
   /**
    * @generated from field: repeated livekit.NodeStatsRate rates = 50;

package/src/gen/livekit_internal_pb.js

@@ -143,7 +143,7 @@ export const NodeStats = /*@__PURE__*/ proto3.makeMessageType(
     { no: 54, name: "participant_rtc_active", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
     { no: 48, name: "forward_latency", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
     { no: 49, name: "forward_jitter", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
-    { no: 57, name: "forward_scheduling_delay", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 57, name: "forward_processing_per_write", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
     { no: 50, name: "rates", kind: "message", T: NodeStatsRate, repeated: true },
   ],
 );

package/src/gen/livekit_sip_pb.d.ts

@@ -484,6 +484,57 @@ export declare enum SIPMediaEncryption {
   SIP_MEDIA_ENCRYPT_REQUIRE = 2,
 }
 
+/**
+ * Dial tone (ringback) played while a call is being placed or transferred.
+ * Receivers treat unknown values as SIP_DIALTONE_ETSI.
+ *
+ * @generated from enum livekit.SIPDialtone
+ */
+export declare enum SIPDialtone {
+  /**
+   * no tone
+   *
+   * @generated from enum value: SIP_DIALTONE_DISABLED = 0;
+   */
+  SIP_DIALTONE_DISABLED = 0,
+
+  /**
+   * 425 Hz, 1s on / 4s off; the tone play_dialtone used
+   *
+   * @generated from enum value: SIP_DIALTONE_ETSI = 1;
+   */
+  SIP_DIALTONE_ETSI = 1,
+
+  /**
+   * pick by the country of the called number, ETSI if unknown
+   *
+   * @generated from enum value: SIP_DIALTONE_AUTO = 2;
+   */
+  SIP_DIALTONE_AUTO = 2,
+
+  /**
+   * North America (NANP)
+   *
+   * @generated from enum value: SIP_DIALTONE_US = 3;
+   */
+  SIP_DIALTONE_US = 3,
+
+  /**
+   * @generated from enum value: SIP_DIALTONE_UK = 4;
+   */
+  SIP_DIALTONE_UK = 4,
+
+  /**
+   * @generated from enum value: SIP_DIALTONE_JP = 5;
+   */
+  SIP_DIALTONE_JP = 5,
+
+  /**
+   * @generated from enum value: SIP_DIALTONE_AU = 6;
+   */
+  SIP_DIALTONE_AU = 6,
+}
+
 /**
  * @generated from enum livekit.ProviderType
  */
@@ -841,6 +892,14 @@ export declare class SIPMediaConfig extends Message<SIPMediaConfig> {
    */
   mediaTimeout?: Duration;
 
+  /**
+   * Stop sending audio RTP while outbound DTMF digits are sent.
+   * Always on when the telephone-event clock rate differs from the audio codec's.
+   *
+   * @generated from field: bool drop_audio_during_dtmf = 5;
+   */
+  dropAudioDuringDtmf: boolean;
+
   constructor(data?: PartialMessage<SIPMediaConfig>);
 
   static readonly runtime: typeof proto3;
@@ -2667,7 +2726,7 @@ export declare class CreateSIPParticipantRequest extends Message<CreateSIPPartic
   dtmf: string;
 
   /**
-   * Optionally play dialtone in the room as an audible indicator for existing participants. The `play_ringtone` option is deprectated but has the same effect.
+   * Deprecated: use dialtone. Setting play_dialtone (or play_ringtone) is equivalent to SIP_DIALTONE_ETSI when dialtone is unset.
    *
    * @generated from field: bool play_ringtone = 6 [deprecated = true];
    * @deprecated
@@ -2675,10 +2734,18 @@ export declare class CreateSIPParticipantRequest extends Message<CreateSIPPartic
   playRingtone: boolean;
 
   /**
-   * @generated from field: bool play_dialtone = 13;
+   * @generated from field: bool play_dialtone = 13 [deprecated = true];
+   * @deprecated
    */
   playDialtone: boolean;
 
+  /**
+   * Optionally play dialtone in the room as an audible indicator for existing participants.
+   *
+   * @generated from field: livekit.SIPDialtone dialtone = 28;
+   */
+  dialtone: SIPDialtone;
+
   /**
    * By default the From value (Phone number) is used for participant name/identity (if not set) and added to attributes.
    * If true, a random value for identity will be used and numbers will be omitted from attributes.
@@ -2758,7 +2825,7 @@ export declare class CreateSIPParticipantRequest extends Message<CreateSIPPartic
   displayName?: string;
 
   /**
-   * NEXT ID: 28
+   * NEXT ID: 29
    *
    * @generated from field: optional livekit.Destination destination = 22;
    */
@@ -2838,12 +2905,20 @@ export declare class TransferSIPParticipantRequest extends Message<TransferSIPPa
   transferTo: string;
 
   /**
-   * Optionally play dialtone to the SIP participant as an audible indicator of being transferred
+   * Deprecated: use dialtone. Setting play_dialtone is equivalent to SIP_DIALTONE_ETSI when dialtone is unset.
    *
-   * @generated from field: bool play_dialtone = 4;
+   * @generated from field: bool play_dialtone = 4 [deprecated = true];
+   * @deprecated
    */
   playDialtone: boolean;
 
+  /**
+   * Optionally play dialtone to the SIP participant as an audible indicator of being transferred.
+   *
+   * @generated from field: livekit.SIPDialtone dialtone = 7;
+   */
+  dialtone: SIPDialtone;
+
   /**
    * Add the following headers to the REFER SIP request.
    *

package/src/gen/livekit_sip_pb.js

@@ -143,6 +143,25 @@ export const SIPMediaEncryption = /*@__PURE__*/ proto3.makeEnum(
   ],
 );
 
+/**
+ * Dial tone (ringback) played while a call is being placed or transferred.
+ * Receivers treat unknown values as SIP_DIALTONE_ETSI.
+ *
+ * @generated from enum livekit.SIPDialtone
+ */
+export const SIPDialtone = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.SIPDialtone",
+  [
+    {no: 0, name: "SIP_DIALTONE_DISABLED"},
+    {no: 1, name: "SIP_DIALTONE_ETSI"},
+    {no: 2, name: "SIP_DIALTONE_AUTO"},
+    {no: 3, name: "SIP_DIALTONE_US"},
+    {no: 4, name: "SIP_DIALTONE_UK"},
+    {no: 5, name: "SIP_DIALTONE_JP"},
+    {no: 6, name: "SIP_DIALTONE_AU"},
+  ],
+);
+
 /**
  * @generated from enum livekit.ProviderType
  */
@@ -275,6 +294,7 @@ export const SIPMediaConfig = /*@__PURE__*/ proto3.makeMessageType(
     { no: 2, name: "codecs", kind: "message", T: SIPCodec, repeated: true },
     { no: 3, name: "encryption", kind: "enum", T: proto3.getEnumType(SIPMediaEncryption), opt: true },
     { no: 4, name: "media_timeout", kind: "message", T: Duration, opt: true },
+    { no: 5, name: "drop_audio_during_dtmf", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
   ],
 );
 
@@ -782,6 +802,7 @@ export const CreateSIPParticipantRequest = /*@__PURE__*/ proto3.makeMessageType(
     { no: 5, name: "dtmf", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 6, name: "play_ringtone", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 13, name: "play_dialtone", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 28, name: "dialtone", kind: "enum", T: proto3.getEnumType(SIPDialtone) },
     { no: 10, name: "hide_phone_number", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 16, name: "headers", kind: "map", K: 9 /* ScalarType.STRING */, V: {kind: "scalar", T: 9 /* ScalarType.STRING */} },
     { no: 17, name: "include_headers", kind: "enum", T: proto3.getEnumType(SIPHeaderOptions) },
@@ -819,6 +840,7 @@ export const TransferSIPParticipantRequest = /*@__PURE__*/ proto3.makeMessageTyp
     { no: 2, name: "room_name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 3, name: "transfer_to", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 4, name: "play_dialtone", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 7, name: "dialtone", kind: "enum", T: proto3.getEnumType(SIPDialtone) },
     { no: 5, name: "headers", kind: "map", K: 9 /* ScalarType.STRING */, V: {kind: "scalar", T: 9 /* ScalarType.STRING */} },
     { no: 6, name: "ringing_timeout", kind: "message", T: Duration },
   ],

package/src/gen/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '1.53.1';
+export const version = '1.53.2';