@livekit/protocol 1.39.3 → 1.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/protocol",
-  "version": "1.39.3",
+  "version": "1.41.0",
   "description": "",
   "type": "module",
   "require": "dist/index.cjs",
@@ -28,7 +28,7 @@
   "devDependencies": {
     "@bufbuild/protoc-gen-es": "^1.10.0",
     "genversion": "^3.2.0",
-    "typescript": "5.8.3",
+    "typescript": "5.9.2",
     "unbuild": "^2.0.0"
   },
   "dependencies": {

package/src/gen/livekit_agent_pb.d.ts

@@ -185,6 +185,11 @@ export declare class JobState extends Message<JobState> {
    */
   workerId: string;
 
+  /**
+   * @generated from field: string agent_id = 8;
+   */
+  agentId: string;
+
   constructor(data?: PartialMessage<JobState>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_agent_pb.js

@@ -87,6 +87,7 @@ export const JobState = /*@__PURE__*/ proto3.makeMessageType(
     { no: 5, name: "updated_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
     { 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 */ },
   ],
 );
 

package/src/gen/livekit_analytics_pb.d.ts

@@ -64,6 +64,11 @@ export declare enum AnalyticsEventType {
    */
   PARTICIPANT_LEFT = 3,
 
+  /**
+   * @generated from enum value: PARTICIPANT_CONNECTION_ABORTED = 45;
+   */
+  PARTICIPANT_CONNECTION_ABORTED = 45,
+
   /**
    * @generated from enum value: TRACK_PUBLISHED = 4;
    */

package/src/gen/livekit_analytics_pb.js

@@ -45,6 +45,7 @@ export const AnalyticsEventType = /*@__PURE__*/ proto3.makeEnum(
     {no: 1, name: "ROOM_ENDED"},
     {no: 2, name: "PARTICIPANT_JOINED"},
     {no: 3, name: "PARTICIPANT_LEFT"},
+    {no: 45, name: "PARTICIPANT_CONNECTION_ABORTED"},
     {no: 4, name: "TRACK_PUBLISHED"},
     {no: 20, name: "TRACK_PUBLISH_REQUESTED"},
     {no: 5, name: "TRACK_UNPUBLISHED"},

package/src/gen/livekit_cloud_agent_pb.d.ts

@@ -356,6 +356,16 @@ export declare class AgentVersion extends Message<AgentVersion> {
    */
   createdAt?: Timestamp;
 
+  /**
+   * @generated from field: google.protobuf.Timestamp deployed_at = 4;
+   */
+  deployedAt?: Timestamp;
+
+  /**
+   * @generated from field: map<string, string> attributes = 5;
+   */
+  attributes: { [key: string]: string };
+
   constructor(data?: PartialMessage<AgentVersion>);
 
   static readonly runtime: typeof proto3;
@@ -511,6 +521,59 @@ export declare class UpdateAgentResponse extends Message<UpdateAgentResponse> {
   static equals(a: UpdateAgentResponse | PlainMessage<UpdateAgentResponse> | undefined, b: UpdateAgentResponse | PlainMessage<UpdateAgentResponse> | undefined): boolean;
 }
 
+/**
+ * @generated from message livekit.RestartAgentRequest
+ */
+export declare class RestartAgentRequest extends Message<RestartAgentRequest> {
+  /**
+   * @generated from field: string agent_id = 1;
+   */
+  agentId: string;
+
+  constructor(data?: PartialMessage<RestartAgentRequest>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.RestartAgentRequest";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RestartAgentRequest;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RestartAgentRequest;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RestartAgentRequest;
+
+  static equals(a: RestartAgentRequest | PlainMessage<RestartAgentRequest> | undefined, b: RestartAgentRequest | PlainMessage<RestartAgentRequest> | undefined): boolean;
+}
+
+/**
+ * @generated from message livekit.RestartAgentResponse
+ */
+export declare class RestartAgentResponse extends Message<RestartAgentResponse> {
+  /**
+   * @generated from field: bool success = 1;
+   */
+  success: boolean;
+
+  /**
+   * @generated from field: string message = 2;
+   */
+  message: string;
+
+  constructor(data?: PartialMessage<RestartAgentResponse>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.RestartAgentResponse";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): RestartAgentResponse;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): RestartAgentResponse;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RestartAgentResponse;
+
+  static equals(a: RestartAgentResponse | PlainMessage<RestartAgentResponse> | undefined, b: RestartAgentResponse | PlainMessage<RestartAgentResponse> | undefined): boolean;
+}
+
 /**
  * @generated from message livekit.DeployAgentRequest
  */

package/src/gen/livekit_cloud_agent_pb.js

@@ -127,6 +127,8 @@ export const AgentVersion = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "version", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 2, name: "current", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 3, name: "created_at", kind: "message", T: Timestamp },
+    { no: 4, name: "deployed_at", kind: "message", T: Timestamp },
+    { no: 5, name: "attributes", kind: "map", K: 9 /* ScalarType.STRING */, V: {kind: "scalar", T: 9 /* ScalarType.STRING */} },
   ],
 );
 
@@ -178,6 +180,27 @@ export const UpdateAgentResponse = /*@__PURE__*/ proto3.makeMessageType(
   ],
 );
 
+/**
+ * @generated from message livekit.RestartAgentRequest
+ */
+export const RestartAgentRequest = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.RestartAgentRequest",
+  () => [
+    { no: 1, name: "agent_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.RestartAgentResponse
+ */
+export const RestartAgentResponse = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.RestartAgentResponse",
+  () => [
+    { no: 1, name: "success", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 2, name: "message", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+);
+
 /**
  * @generated from message livekit.DeployAgentRequest
  */

package/src/gen/livekit_egress_pb.d.ts

@@ -1130,6 +1130,20 @@ export declare class S3Upload extends Message<S3Upload> {
    */
   sessionToken: string;
 
+  /**
+   * ARN of the role to assume for file upload. Egress will make an AssumeRole API call using the provided access_key and secret to assume that role. On LiveKit cloud, this is only available on accounts that have the feature enabled
+   *
+   * @generated from field: string assume_role_arn = 12;
+   */
+  assumeRoleArn: string;
+
+  /**
+   * ExternalID to use when assuming role for upload
+   *
+   * @generated from field: string assume_role_external_id = 13;
+   */
+  assumeRoleExternalId: string;
+
   /**
    * @generated from field: string region = 3;
    */

package/src/gen/livekit_egress_pb.js

@@ -329,6 +329,8 @@ export const S3Upload = /*@__PURE__*/ proto3.makeMessageType(
     { no: 1, name: "access_key", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 2, name: "secret", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 11, name: "session_token", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 12, name: "assume_role_arn", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 13, name: "assume_role_external_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 3, name: "region", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 4, name: "endpoint", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 5, name: "bucket", kind: "scalar", T: 9 /* ScalarType.STRING */ },

package/src/gen/livekit_internal_pb.d.ts

@@ -21,6 +21,7 @@ import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialM
 import { Message, proto3 } from "@bufbuild/protobuf";
 import type { ClientInfo, PlayoutDelay, ReconnectReason } from "./livekit_models_pb.js";
 import type { CreateRoomRequest } from "./livekit_room_pb.js";
+import type { AddTrackRequest, SessionDescription, SyncState } from "./livekit_rtc_pb.js";
 import type { AutoParticipantEgress, AutoTrackEgress } from "./livekit_egress_pb.js";
 import type { RoomAgentDispatch } from "./livekit_agent_dispatch_pb.js";
 
@@ -631,7 +632,8 @@ export declare class StartSession extends Message<StartSession> {
   autoSubscribe: boolean;
 
   /**
-   * @generated from field: bool hidden = 10;
+   * @generated from field: bool hidden = 10 [deprecated = true];
+   * @deprecated
    */
   hidden: boolean;
 
@@ -641,7 +643,8 @@ export declare class StartSession extends Message<StartSession> {
   client?: ClientInfo;
 
   /**
-   * @generated from field: bool recorder = 12;
+   * @generated from field: bool recorder = 12 [deprecated = true];
+   * @deprecated
    */
   recorder: boolean;
 
@@ -689,6 +692,26 @@ export declare class StartSession extends Message<StartSession> {
    */
   createRoom?: CreateRoomRequest;
 
+  /**
+   * @generated from field: repeated livekit.AddTrackRequest add_track_requests = 21;
+   */
+  addTrackRequests: AddTrackRequest[];
+
+  /**
+   * @generated from field: livekit.SessionDescription publisher_offer = 22;
+   */
+  publisherOffer?: SessionDescription;
+
+  /**
+   * @generated from field: livekit.SyncState sync_state = 23;
+   */
+  syncState?: SyncState;
+
+  /**
+   * @generated from field: bool use_single_peer_connection = 24;
+   */
+  useSinglePeerConnection: boolean;
+
   constructor(data?: PartialMessage<StartSession>);
 
   static readonly runtime: typeof proto3;

package/src/gen/livekit_internal_pb.js

@@ -20,6 +20,7 @@
 import { proto3 } from "@bufbuild/protobuf";
 import { ClientInfo, PlayoutDelay, ReconnectReason } from "./livekit_models_pb.js";
 import { CreateRoomRequest } from "./livekit_room_pb.js";
+import { AddTrackRequest, SessionDescription, SyncState } from "./livekit_rtc_pb.js";
 import { AutoParticipantEgress, AutoTrackEgress } from "./livekit_egress_pb.js";
 import { RoomAgentDispatch } from "./livekit_agent_dispatch_pb.js";
 
@@ -194,6 +195,10 @@ export const StartSession = /*@__PURE__*/ proto3.makeMessageType(
     { no: 18, name: "subscriber_allow_pause", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
     { no: 19, name: "disable_ice_lite", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 20, name: "create_room", kind: "message", T: CreateRoomRequest },
+    { no: 21, name: "add_track_requests", kind: "message", T: AddTrackRequest, repeated: true },
+    { no: 22, name: "publisher_offer", kind: "message", T: SessionDescription },
+    { no: 23, name: "sync_state", kind: "message", T: SyncState },
+    { no: 24, name: "use_single_peer_connection", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
   ],
 );
 

package/src/gen/livekit_models_pb.d.ts

@@ -473,6 +473,30 @@ export declare class Pagination extends Message<Pagination> {
   static equals(a: Pagination | PlainMessage<Pagination> | undefined, b: Pagination | PlainMessage<Pagination> | undefined): boolean;
 }
 
+/**
+ * @generated from message livekit.TokenPagination
+ */
+export declare class TokenPagination extends Message<TokenPagination> {
+  /**
+   * @generated from field: string token = 1;
+   */
+  token: string;
+
+  constructor(data?: PartialMessage<TokenPagination>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.TokenPagination";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): TokenPagination;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): TokenPagination;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): TokenPagination;
+
+  static equals(a: TokenPagination | PlainMessage<TokenPagination> | undefined, b: TokenPagination | PlainMessage<TokenPagination> | undefined): boolean;
+}
+
 /**
  * ListUpdate is used for updated APIs where 'repeated string' field is modified.
  *
@@ -486,6 +510,27 @@ export declare class ListUpdate extends Message<ListUpdate> {
    */
   set: string[];
 
+  /**
+   * append items to a list, avoiding duplicates
+   *
+   * @generated from field: repeated string add = 2;
+   */
+  add: string[];
+
+  /**
+   * delete items from a list
+   *
+   * @generated from field: repeated string del = 3;
+   */
+  del: string[];
+
+  /**
+   * sets the list to an empty list
+   *
+   * @generated from field: bool clear = 4;
+   */
+  clear: boolean;
+
   constructor(data?: PartialMessage<ListUpdate>);
 
   static readonly runtime: typeof proto3;
@@ -996,6 +1041,21 @@ export declare class SimulcastCodecInfo extends Message<SimulcastCodecInfo> {
    */
   layers: VideoLayer[];
 
+  /**
+   * @generated from field: livekit.VideoLayer.Mode video_layer_mode = 5;
+   */
+  videoLayerMode: VideoLayer_Mode;
+
+  /**
+   * cid (client side id for track) could be different between
+   * signalling (AddTrackRequest) and SDP offer. This field
+   * will be populated only if it is different to avoid
+   * duplication and keep the representation concise.
+   *
+   * @generated from field: string sdp_cid = 6;
+   */
+  sdpCid: string;
+
   constructor(data?: PartialMessage<SimulcastCodecInfo>);
 
   static readonly runtime: typeof proto3;
@@ -1039,28 +1099,36 @@ export declare class TrackInfo extends Message<TrackInfo> {
    * original width of video (unset for audio)
    * clients may receive a lower resolution version with simulcast
    *
-   * @generated from field: uint32 width = 5;
+   * @generated from field: uint32 width = 5 [deprecated = true];
+   * @deprecated
    */
   width: number;
 
   /**
    * original height of video (unset for audio)
    *
-   * @generated from field: uint32 height = 6;
+   * @generated from field: uint32 height = 6 [deprecated = true];
+   * @deprecated
    */
   height: number;
 
   /**
    * true if track is simulcasted
    *
-   * @generated from field: bool simulcast = 7;
+   * see `video_layer_mode` in `codecs`
+   *
+   * @generated from field: bool simulcast = 7 [deprecated = true];
+   * @deprecated
    */
   simulcast: boolean;
 
   /**
    * true if DTX (Discontinuous Transmission) is disabled for audio
    *
-   * @generated from field: bool disable_dtx = 8;
+   * deprecated in favor of `audio_features`
+   *
+   * @generated from field: bool disable_dtx = 8 [deprecated = true];
+   * @deprecated
    */
   disableDtx: boolean;
 
@@ -1072,7 +1140,10 @@ export declare class TrackInfo extends Message<TrackInfo> {
   source: TrackSource;
 
   /**
-   * @generated from field: repeated livekit.VideoLayer layers = 10;
+   * see `codecs` for layers of individual codec
+   *
+   * @generated from field: repeated livekit.VideoLayer layers = 10 [deprecated = true];
+   * @deprecated
    */
   layers: VideoLayer[];
 
@@ -1094,7 +1165,10 @@ export declare class TrackInfo extends Message<TrackInfo> {
   codecs: SimulcastCodecInfo[];
 
   /**
-   * @generated from field: bool stereo = 14;
+   * deprecated in favor of `audio_features`
+   *
+   * @generated from field: bool stereo = 14 [deprecated = true];
+   * @deprecated
    */
   stereo: boolean;
 
@@ -1205,6 +1279,26 @@ export declare class VideoLayer extends Message<VideoLayer> {
   static equals(a: VideoLayer | PlainMessage<VideoLayer> | undefined, b: VideoLayer | PlainMessage<VideoLayer> | undefined): boolean;
 }
 
+/**
+ * @generated from enum livekit.VideoLayer.Mode
+ */
+export declare enum VideoLayer_Mode {
+  /**
+   * @generated from enum value: MODE_UNUSED = 0;
+   */
+  MODE_UNUSED = 0,
+
+  /**
+   * @generated from enum value: ONE_SPATIAL_LAYER_PER_STREAM = 1;
+   */
+  ONE_SPATIAL_LAYER_PER_STREAM = 1,
+
+  /**
+   * @generated from enum value: MULTIPLE_SPATIAL_LAYERS_PER_STREAM = 2;
+   */
+  MULTIPLE_SPATIAL_LAYERS_PER_STREAM = 2,
+}
+
 /**
  * new DataPacket API
  *
@@ -1307,6 +1401,12 @@ export declare class DataPacket extends Message<DataPacket> {
      */
     value: DataStream_Trailer;
     case: "streamTrailer";
+  } | {
+    /**
+     * @generated from field: livekit.EncryptedPacket encrypted_packet = 18;
+     */
+    value: EncryptedPacket;
+    case: "encryptedPacket";
   } | { case: undefined; value?: undefined };
 
   /**
@@ -1353,8 +1453,122 @@ export declare enum DataPacket_Kind {
   LOSSY = 1,
 }
 
+/**
+ * @generated from message livekit.EncryptedPacket
+ */
+export declare class EncryptedPacket extends Message<EncryptedPacket> {
+  /**
+   * @generated from field: livekit.Encryption.Type encryption_type = 1;
+   */
+  encryptionType: Encryption_Type;
+
+  /**
+   * @generated from field: bytes iv = 2;
+   */
+  iv: Uint8Array;
+
+  /**
+   * @generated from field: uint32 key_index = 3;
+   */
+  keyIndex: number;
+
+  /**
+   * This is an encrypted EncryptedPacketPayload message representation 
+   *
+   * @generated from field: bytes encrypted_value = 4;
+   */
+  encryptedValue: Uint8Array;
+
+  constructor(data?: PartialMessage<EncryptedPacket>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.EncryptedPacket";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): EncryptedPacket;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): EncryptedPacket;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): EncryptedPacket;
+
+  static equals(a: EncryptedPacket | PlainMessage<EncryptedPacket> | undefined, b: EncryptedPacket | PlainMessage<EncryptedPacket> | undefined): boolean;
+}
+
+/**
+ * @generated from message livekit.EncryptedPacketPayload
+ */
+export declare class EncryptedPacketPayload extends Message<EncryptedPacketPayload> {
+  /**
+   * @generated from oneof livekit.EncryptedPacketPayload.value
+   */
+  value: {
+    /**
+     * @generated from field: livekit.UserPacket user = 1;
+     */
+    value: UserPacket;
+    case: "user";
+  } | {
+    /**
+     * @generated from field: livekit.ChatMessage chat_message = 3;
+     */
+    value: ChatMessage;
+    case: "chatMessage";
+  } | {
+    /**
+     * @generated from field: livekit.RpcRequest rpc_request = 4;
+     */
+    value: RpcRequest;
+    case: "rpcRequest";
+  } | {
+    /**
+     * @generated from field: livekit.RpcAck rpc_ack = 5;
+     */
+    value: RpcAck;
+    case: "rpcAck";
+  } | {
+    /**
+     * @generated from field: livekit.RpcResponse rpc_response = 6;
+     */
+    value: RpcResponse;
+    case: "rpcResponse";
+  } | {
+    /**
+     * @generated from field: livekit.DataStream.Header stream_header = 7;
+     */
+    value: DataStream_Header;
+    case: "streamHeader";
+  } | {
+    /**
+     * @generated from field: livekit.DataStream.Chunk stream_chunk = 8;
+     */
+    value: DataStream_Chunk;
+    case: "streamChunk";
+  } | {
+    /**
+     * @generated from field: livekit.DataStream.Trailer stream_trailer = 9;
+     */
+    value: DataStream_Trailer;
+    case: "streamTrailer";
+  } | { case: undefined; value?: undefined };
+
+  constructor(data?: PartialMessage<EncryptedPacketPayload>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.EncryptedPacketPayload";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): EncryptedPacketPayload;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): EncryptedPacketPayload;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): EncryptedPacketPayload;
+
+  static equals(a: EncryptedPacketPayload | PlainMessage<EncryptedPacketPayload> | undefined, b: EncryptedPacketPayload | PlainMessage<EncryptedPacketPayload> | undefined): boolean;
+}
+
 /**
  * @generated from message livekit.ActiveSpeakerUpdate
+ * @deprecated
  */
 export declare class ActiveSpeakerUpdate extends Message<ActiveSpeakerUpdate> {
   /**
@@ -1464,7 +1678,7 @@ export declare class UserPacket extends Message<UserPacket> {
   topic?: string;
 
   /**
-   * Unique ID to indentify the message
+   * Unique ID to identify the message
    *
    * @generated from field: optional string id = 8;
    */
@@ -2913,9 +3127,10 @@ export declare class DataStream_Header extends Message<DataStream_Header> {
   totalLength?: bigint;
 
   /**
-   * defaults to NONE
+   *  this is set on the DataPacket
    *
-   * @generated from field: livekit.Encryption.Type encryption_type = 7;
+   * @generated from field: livekit.Encryption.Type encryption_type = 7 [deprecated = true];
+   * @deprecated
    */
   encryptionType: Encryption_Type;
 
@@ -2991,9 +3206,10 @@ export declare class DataStream_Chunk extends Message<DataStream_Chunk> {
   version: number;
 
   /**
-   * optional, initialization vector for AES-GCM encryption
+   * this is set on the DataPacket
    *
-   * @generated from field: optional bytes iv = 5;
+   * @generated from field: optional bytes iv = 5 [deprecated = true];
+   * @deprecated
    */
   iv?: Uint8Array;