livekit-server-sdk 2.15.2 → 2.15.3

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AcceptWhatsAppCallResponse,\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallResponse,\n  DataPacket_Kind,\n  DialWhatsAppCallResponse,\n  DirectFileOutput,\n  DisconnectWhatsAppCallResponse,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SessionDescription,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './ConnectorClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":"AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;AAC3B,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport {\n  AcceptWhatsAppCallResponse,\n  AliOSSUpload,\n  AgentDispatch,\n  AudioCodec,\n  AutoParticipantEgress,\n  AutoTrackEgress,\n  AzureBlobUpload,\n  ConnectTwilioCallRequest_TwilioCallDirection,\n  ConnectTwilioCallResponse,\n  ConnectWhatsAppCallResponse,\n  DataPacket_Kind,\n  DialWhatsAppCallResponse,\n  DirectFileOutput,\n  DisconnectWhatsAppCallRequest_DisconnectReason,\n  DisconnectWhatsAppCallResponse,\n  EgressInfo,\n  EgressStatus,\n  EncodedFileOutput,\n  EncodedFileType,\n  EncodingOptions,\n  EncodingOptionsPreset,\n  GCPUpload,\n  ImageCodec,\n  ImageFileSuffix,\n  ImageOutput,\n  IngressAudioEncodingOptions,\n  IngressAudioEncodingPreset,\n  IngressAudioOptions,\n  IngressInfo,\n  IngressInput,\n  IngressState,\n  IngressVideoEncodingOptions,\n  IngressVideoEncodingPreset,\n  IngressVideoOptions,\n  JobRestartPolicy,\n  ParticipantEgressRequest,\n  ParticipantInfo,\n  ParticipantInfo_State,\n  ParticipantPermission,\n  Room,\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n  S3Upload,\n  SessionDescription,\n  SIPDispatchRule,\n  SIPDispatchRuleInfo,\n  SIPDispatchRuleDirect,\n  SIPDispatchRuleIndividual,\n  SIPParticipantInfo,\n  SIPOutboundTrunkInfo,\n  SIPInboundTrunkInfo,\n  SIPTrunkInfo,\n  SIPCallStatus,\n  SegmentedFileOutput,\n  SegmentedFileProtocol,\n  StreamOutput,\n  StreamProtocol,\n  TrackCompositeEgressRequest,\n  TrackEgressRequest,\n  TrackInfo,\n  TrackSource,\n  TrackType,\n  WebEgressRequest,\n  VideoCodec,\n  WebhookConfig,\n} from '@livekit/protocol';\nexport * from './AccessToken.js';\nexport * from './AgentDispatchClient.js';\nexport * from './ConnectorClient.js';\nexport * from './EgressClient.js';\nexport * from './grants.js';\nexport * from './IngressClient.js';\nexport * from './RoomServiceClient.js';\nexport * from './SipClient.js';\nexport { TwirpError } from './TwirpRPC.js';\nexport * from './WebhookReceiver.js';\n"],"mappings":"AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;AAC3B,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livekit-server-sdk",
-  "version": "2.15.2",
+  "version": "2.15.3",
   "description": "Server-side SDK for LiveKit",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
@@ -31,7 +31,7 @@
   ],
   "dependencies": {
     "@bufbuild/protobuf": "^1.10.1",
-    "@livekit/protocol": "^1.43.1",
+    "@livekit/protocol": "^1.45.6",
     "camelcase-keys": "^9.0.0",
     "jose": "^5.1.2"
   },

package/src/AgentDispatchClient.ts

@@ -5,6 +5,7 @@ import {
   AgentDispatch,
   CreateAgentDispatchRequest,
   DeleteAgentDispatchRequest,
+  type JobRestartPolicy,
   ListAgentDispatchRequest,
   ListAgentDispatchResponse,
 } from '@livekit/protocol';
@@ -16,6 +17,8 @@ interface CreateDispatchOptions {
   // any custom data to send along with the job.
   // note: this is different from room and participant metadata
   metadata?: string;
+  // controls whether the job should be restarted when it fails (cloud only)
+  restartPolicy?: JobRestartPolicy;
 }
 
 const svc = 'AgentDispatchService';
@@ -57,6 +60,7 @@ export class AgentDispatchClient extends ServiceBase {
       room: roomName,
       agentName,
       metadata: options?.metadata,
+      restartPolicy: options?.restartPolicy,
     }).toJson();
     const data = await this.rpc.request(
       svc,

package/src/ConnectorClient.ts

@@ -1,8 +1,10 @@
 // SPDX-FileCopyrightText: 2025 LiveKit, Inc.
 //
 // SPDX-License-Identifier: Apache-2.0
+import { Duration } from '@bufbuild/protobuf';
 import type {
   ConnectTwilioCallRequest_TwilioCallDirection,
+  DisconnectWhatsAppCallRequest_DisconnectReason,
   RoomAgentDispatch,
   SessionDescription,
 } from '@livekit/protocol';
@@ -50,6 +52,8 @@ export interface DialWhatsAppCallOptions {
   participantAttributes?: { [key: string]: string };
   /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
   destinationCountry?: string;
+  /** Optional - Max time in seconds for the callee to answer the call */
+  ringingTimeout?: number;
 }
 
 export interface AcceptWhatsAppCallOptions {
@@ -79,6 +83,10 @@ export interface AcceptWhatsAppCallOptions {
   participantAttributes?: { [key: string]: string };
   /** Optional - Country where the call terminates as ISO 3166-1 alpha-2 */
   destinationCountry?: string;
+  /** Optional - Max time in seconds for the callee to answer the call */
+  ringingTimeout?: number;
+  /** Optional - Wait for the call to be answered before returning */
+  waitUntilAnswered?: boolean;
 }
 
 // Twilio types
@@ -148,6 +156,9 @@ export class ConnectorClient extends ServiceBase {
       participantMetadata,
       participantAttributes: options.participantAttributes,
       destinationCountry,
+      ringingTimeout: options.ringingTimeout
+        ? new Duration({ seconds: BigInt(options.ringingTimeout) })
+        : undefined,
     }).toJson();
 
     const data = await this.rpc.request(
@@ -189,6 +200,10 @@ export class ConnectorClient extends ServiceBase {
       participantMetadata,
       participantAttributes: options.participantAttributes,
       destinationCountry,
+      ringingTimeout: options.ringingTimeout
+        ? new Duration({ seconds: BigInt(options.ringingTimeout) })
+        : undefined,
+      waitUntilAnswered: options.waitUntilAnswered,
     }).toJson();
 
     const data = await this.rpc.request(
@@ -228,15 +243,19 @@ export class ConnectorClient extends ServiceBase {
    * Disconnect an active WhatsApp call
    *
    * @param whatsappCallId - Call ID sent by Meta
-   * @param whatsappApiKey - The API key of the business that is disconnecting the call
+   * @param whatsappApiKey - The API key of the business that is disconnecting the call.
+   *   Required when `disconnectReason` is BUSINESS_INITIATED, optional for USER_INITIATED.
+   * @param disconnectReason - Optional reason for disconnecting the call. Defaults to BUSINESS_INITIATED.
    */
   async disconnectWhatsAppCall(
     whatsappCallId: string,
     whatsappApiKey: string,
+    disconnectReason?: DisconnectWhatsAppCallRequest_DisconnectReason,
   ): Promise<DisconnectWhatsAppCallResponse> {
     const req = new DisconnectWhatsAppCallRequest({
       whatsappCallId,
       whatsappApiKey,
+      disconnectReason,
     }).toJson();
 
     const data = await this.rpc.request(

package/src/SipClient.ts

@@ -7,6 +7,8 @@ import type {
   Pagination,
   RoomConfiguration,
   SIPHeaderOptions,
+  SIPMediaEncryption,
+  SIPOutboundConfig,
 } from '@livekit/protocol';
 import {
   CreateSIPDispatchRuleRequest,
@@ -29,8 +31,6 @@ import {
   SIPDispatchRuleIndividual,
   SIPDispatchRuleInfo,
   SIPInboundTrunkInfo,
-  SIPMediaEncryption,
-  SIPOutboundConfig,
   SIPOutboundTrunkInfo,
   SIPParticipantInfo,
   SIPTransport,

package/src/grants.ts

@@ -91,6 +91,9 @@ export interface VideoGrant {
   /** allow participant to subscribe to metrics */
   canSubscribeMetrics?: boolean;
 
+  /** allow participant to manage an agent session via RemoteSession */
+  canManageAgentSession?: boolean;
+
   /** destination room which this participant can forward to */
   destinationRoom?: string;
 }

package/src/index.ts

@@ -16,6 +16,7 @@ export {
   DataPacket_Kind,
   DialWhatsAppCallResponse,
   DirectFileOutput,
+  DisconnectWhatsAppCallRequest_DisconnectReason,
   DisconnectWhatsAppCallResponse,
   EgressInfo,
   EgressStatus,
@@ -36,6 +37,7 @@ export {
   IngressVideoEncodingOptions,
   IngressVideoEncodingPreset,
   IngressVideoOptions,
+  JobRestartPolicy,
   ParticipantEgressRequest,
   ParticipantInfo,
   ParticipantInfo_State,