@voice-ai-labs/web-sdk 0.3.0 → 0.5.0

package/dist/index.esm.js

@@ -4130,6 +4130,12 @@ const ParticipantInfo = /* @__PURE__ */proto3.makeMessageType("livekit.Participa
   kind: "enum",
   T: proto3.getEnumType(ParticipantInfo_KindDetail),
   repeated: true
+}, {
+  no: 19,
+  name: "data_tracks",
+  kind: "message",
+  T: DataTrackInfo,
+  repeated: true
 }]);
 const ParticipantInfo_State = /* @__PURE__ */proto3.makeEnum("livekit.ParticipantInfo.State", [{
   no: 0,
@@ -4162,6 +4168,9 @@ const ParticipantInfo_Kind = /* @__PURE__ */proto3.makeEnum("livekit.Participant
 }, {
   no: 7,
   name: "CONNECTOR"
+}, {
+  no: 8,
+  name: "BRIDGE"
 }]);
 const ParticipantInfo_KindDetail = /* @__PURE__ */proto3.makeEnum("livekit.ParticipantInfo.KindDetail", [{
   no: 0,
@@ -4169,6 +4178,15 @@ const ParticipantInfo_KindDetail = /* @__PURE__ */proto3.makeEnum("livekit.Parti
 }, {
   no: 1,
   name: "FORWARDED"
+}, {
+  no: 2,
+  name: "CONNECTOR_WHATSAPP"
+}, {
+  no: 3,
+  name: "CONNECTOR_TWILIO"
+}, {
+  no: 4,
+  name: "BRIDGE_RTSP"
 }]);
 const Encryption_Type = /* @__PURE__ */proto3.makeEnum("livekit.Encryption.Type", [{
   no: 0,
@@ -4332,6 +4350,37 @@ const TrackInfo = /* @__PURE__ */proto3.makeMessageType("livekit.TrackInfo", ()
   kind: "enum",
   T: proto3.getEnumType(BackupCodecPolicy$1)
 }]);
+const DataTrackInfo = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackInfo", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}, {
+  no: 2,
+  name: "sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "name",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 4,
+  name: "encryption",
+  kind: "enum",
+  T: proto3.getEnumType(Encryption_Type)
+}]);
+const DataTrackSubscriptionOptions = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriptionOptions", () => [{
+  no: 1,
+  name: "target_fps",
+  kind: "scalar",
+  T: 13,
+  opt: true
+}]);
 const VideoLayer = /* @__PURE__ */proto3.makeMessageType("livekit.VideoLayer", () => [{
   no: 1,
   name: "quality",
@@ -4373,6 +4422,12 @@ const VideoLayer = /* @__PURE__ */proto3.makeMessageType("livekit.VideoLayer", (
   kind: "scalar",
   T: 9
   /* ScalarType.STRING */
+}, {
+  no: 8,
+  name: "repair_ssrc",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
 }]);
 const VideoLayer_Mode = /* @__PURE__ */proto3.makeEnum("livekit.VideoLayer.Mode", [{
   no: 0,
@@ -5387,6 +5442,24 @@ const SignalRequest = /* @__PURE__ */proto3.makeMessageType("livekit.SignalReque
   kind: "message",
   T: UpdateLocalVideoTrack,
   oneof: "message"
+}, {
+  no: 19,
+  name: "publish_data_track_request",
+  kind: "message",
+  T: PublishDataTrackRequest,
+  oneof: "message"
+}, {
+  no: 20,
+  name: "unpublish_data_track_request",
+  kind: "message",
+  T: UnpublishDataTrackRequest,
+  oneof: "message"
+}, {
+  no: 21,
+  name: "update_data_subscription",
+  kind: "message",
+  T: UpdateDataSubscription,
+  oneof: "message"
 }]);
 const SignalResponse = /* @__PURE__ */proto3.makeMessageType("livekit.SignalResponse", () => [{
   no: 1,
@@ -5538,6 +5611,24 @@ const SignalResponse = /* @__PURE__ */proto3.makeMessageType("livekit.SignalResp
   kind: "message",
   T: SubscribedAudioCodecUpdate,
   oneof: "message"
+}, {
+  no: 27,
+  name: "publish_data_track_response",
+  kind: "message",
+  T: PublishDataTrackResponse,
+  oneof: "message"
+}, {
+  no: 28,
+  name: "unpublish_data_track_response",
+  kind: "message",
+  T: UnpublishDataTrackResponse,
+  oneof: "message"
+}, {
+  no: 29,
+  name: "data_track_subscriber_handles",
+  kind: "message",
+  T: DataTrackSubscriberHandles,
+  oneof: "message"
 }]);
 const SimulcastCodec = /* @__PURE__ */proto3.makeMessageType("livekit.SimulcastCodec", () => [{
   no: 1,
@@ -5662,6 +5753,74 @@ const AddTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.AddTrackR
   T: proto3.getEnumType(AudioTrackFeature),
   repeated: true
 }]);
+const PublishDataTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.PublishDataTrackRequest", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}, {
+  no: 2,
+  name: "name",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "encryption",
+  kind: "enum",
+  T: proto3.getEnumType(Encryption_Type)
+}]);
+const PublishDataTrackResponse = /* @__PURE__ */proto3.makeMessageType("livekit.PublishDataTrackResponse", () => [{
+  no: 1,
+  name: "info",
+  kind: "message",
+  T: DataTrackInfo
+}]);
+const UnpublishDataTrackRequest = /* @__PURE__ */proto3.makeMessageType("livekit.UnpublishDataTrackRequest", () => [{
+  no: 1,
+  name: "pub_handle",
+  kind: "scalar",
+  T: 13
+  /* ScalarType.UINT32 */
+}]);
+const UnpublishDataTrackResponse = /* @__PURE__ */proto3.makeMessageType("livekit.UnpublishDataTrackResponse", () => [{
+  no: 1,
+  name: "info",
+  kind: "message",
+  T: DataTrackInfo
+}]);
+const DataTrackSubscriberHandles = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriberHandles", () => [{
+  no: 1,
+  name: "sub_handles",
+  kind: "map",
+  K: 13,
+  V: {
+    kind: "message",
+    T: DataTrackSubscriberHandles_PublishedDataTrack
+  }
+}]);
+const DataTrackSubscriberHandles_PublishedDataTrack = /* @__PURE__ */proto3.makeMessageType("livekit.DataTrackSubscriberHandles.PublishedDataTrack", () => [{
+  no: 1,
+  name: "publisher_identity",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 2,
+  name: "publisher_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 3,
+  name: "track_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}], {
+  localName: "DataTrackSubscriberHandles_PublishedDataTrack"
+});
 const TrickleRequest = /* @__PURE__ */proto3.makeMessageType("livekit.TrickleRequest", () => [{
   no: 1,
   name: "candidateInit",
@@ -5877,6 +6036,33 @@ const UpdateSubscription = /* @__PURE__ */proto3.makeMessageType("livekit.Update
   T: ParticipantTracks,
   repeated: true
 }]);
+const UpdateDataSubscription = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateDataSubscription", () => [{
+  no: 1,
+  name: "updates",
+  kind: "message",
+  T: UpdateDataSubscription_Update,
+  repeated: true
+}]);
+const UpdateDataSubscription_Update = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateDataSubscription.Update", () => [{
+  no: 1,
+  name: "track_sid",
+  kind: "scalar",
+  T: 9
+  /* ScalarType.STRING */
+}, {
+  no: 2,
+  name: "subscribe",
+  kind: "scalar",
+  T: 8
+  /* ScalarType.BOOL */
+}, {
+  no: 3,
+  name: "options",
+  kind: "message",
+  T: DataTrackSubscriptionOptions
+}], {
+  localName: "UpdateDataSubscription_Update"
+});
 const UpdateTrackSettings = /* @__PURE__ */proto3.makeMessageType("livekit.UpdateTrackSettings", () => [{
   no: 1,
   name: "track_sids",
@@ -6283,6 +6469,12 @@ const SyncState = /* @__PURE__ */proto3.makeMessageType("livekit.SyncState", ()
   kind: "message",
   T: DataChannelReceiveState,
   repeated: true
+}, {
+  no: 8,
+  name: "publish_data_tracks",
+  kind: "message",
+  T: PublishDataTrackResponse,
+  repeated: true
 }]);
 const DataChannelReceiveState = /* @__PURE__ */proto3.makeMessageType("livekit.DataChannelReceiveState", () => [{
   no: 1,
@@ -6487,6 +6679,18 @@ const RequestResponse = /* @__PURE__ */proto3.makeMessageType("livekit.RequestRe
   kind: "message",
   T: UpdateLocalVideoTrack,
   oneof: "request"
+}, {
+  no: 10,
+  name: "publish_data_track",
+  kind: "message",
+  T: PublishDataTrackRequest,
+  oneof: "request"
+}, {
+  no: 11,
+  name: "unpublish_data_track",
+  kind: "message",
+  T: UnpublishDataTrackRequest,
+  oneof: "request"
 }]);
 const RequestResponse_Reason = /* @__PURE__ */proto3.makeEnum("livekit.RequestResponse.Reason", [{
   no: 0,
@@ -6509,6 +6713,18 @@ const RequestResponse_Reason = /* @__PURE__ */proto3.makeEnum("livekit.RequestRe
 }, {
   no: 6,
   name: "UNCLASSIFIED_ERROR"
+}, {
+  no: 7,
+  name: "INVALID_HANDLE"
+}, {
+  no: 8,
+  name: "INVALID_NAME"
+}, {
+  no: 9,
+  name: "DUPLICATE_HANDLE"
+}, {
+  no: 10,
+  name: "DUPLICATE_NAME"
 }]);
 const TrackSubscribed = /* @__PURE__ */proto3.makeMessageType("livekit.TrackSubscribed", () => [{
   no: 1,
@@ -6541,6 +6757,12 @@ const ConnectionSettings = /* @__PURE__ */proto3.makeMessageType("livekit.Connec
   kind: "scalar",
   T: 8
   /* ScalarType.BOOL */
+}, {
+  no: 5,
+  name: "auto_subscribe_data_track",
+  kind: "scalar",
+  T: 8,
+  opt: true
 }]);
 const JoinRequest = /* @__PURE__ */proto3.makeMessageType("livekit.JoinRequest", () => [{
   no: 1,
@@ -10391,7 +10613,8 @@ function adapterFactory() {
 
 adapterFactory({
   window: typeof window === 'undefined' ? undefined : window
-});class TypedPromise extends Promise {
+});var _a, _b;
+class TypedPromise extends (_b = Promise) {
   // eslint-disable-next-line @typescript-eslint/no-useless-constructor
   constructor(executor) {
     super(executor);
@@ -10408,7 +10631,11 @@ adapterFactory({
   static race(values) {
     return super.race(values);
   }
-}// tiny, simplified version of https://github.com/lancedikson/bowser/blob/master/src/parser-browsers.js
+}
+_a = TypedPromise;
+TypedPromise.resolve = value => {
+  return Reflect.get(_b, "resolve", _a).call(_a, value);
+};// tiny, simplified version of https://github.com/lancedikson/bowser/blob/master/src/parser-browsers.js
 // reduced to only differentiate Chrome(ium) based browsers / Firefox / Safari
 const commonVersionIdentifier = /version\/(\d+(\.?_?\d+)+)/i;
 let browserDetails;
@@ -10474,14 +10701,23 @@ function getMatch(exp, ua) {
 }
 function getOSVersion(ua) {
   return ua.includes('mac os') ? getMatch(/\(.+?(\d+_\d+(:?_\d+)?)/, ua, 1).replace(/_/g, '.') : undefined;
-}var version$1 = "2.17.0";const version = version$1;
-const protocolVersion = 16;class LivekitError extends Error {
-  constructor(code, message) {
-    super(message || 'an error has occured');
+}var version$1 = "2.17.1";const version = version$1;
+const protocolVersion = 16;/** Base error that all LiveKit specific custom errors inherit from. */
+class LivekitError extends Error {
+  constructor(code, message, options) {
+    super(message || 'an error has occurred');
     this.name = 'LiveKitError';
     this.code = code;
+    if (typeof (options === null || options === void 0 ? void 0 : options.cause) !== 'undefined') {
+      this.cause = options === null || options === void 0 ? void 0 : options.cause;
+    }
   }
 }
+/**
+ * LiveKit specific error type representing an error with an associated set of reasons.
+ * Use this to represent an error with multiple different but contextually related variants.
+ * */
+class LivekitReasonedError extends LivekitError {}
 var ConnectionErrorReason;
 (function (ConnectionErrorReason) {
   ConnectionErrorReason[ConnectionErrorReason["NotAllowed"] = 0] = "NotAllowed";
@@ -10493,7 +10729,7 @@ var ConnectionErrorReason;
   ConnectionErrorReason[ConnectionErrorReason["WebSocket"] = 6] = "WebSocket";
   ConnectionErrorReason[ConnectionErrorReason["ServiceNotFound"] = 7] = "ServiceNotFound";
 })(ConnectionErrorReason || (ConnectionErrorReason = {}));
-class ConnectionError extends LivekitError {
+class ConnectionError extends LivekitReasonedError {
   constructor(message, reason, status, context) {
     super(1, message);
     this.name = 'ConnectionError';
@@ -10564,7 +10800,7 @@ class PublishTrackError extends LivekitError {
     this.status = status;
   }
 }
-class SignalRequestError extends LivekitError {
+class SignalRequestError extends LivekitReasonedError {
   constructor(message, reason) {
     super(15, message);
     this.name = 'SignalRequestError';
@@ -10590,7 +10826,7 @@ var DataStreamErrorReason;
   // Encryption type mismatch.
   DataStreamErrorReason[DataStreamErrorReason["EncryptionTypeMismatch"] = 8] = "EncryptionTypeMismatch";
 })(DataStreamErrorReason || (DataStreamErrorReason = {}));
-class DataStreamError extends LivekitError {
+class DataStreamError extends LivekitReasonedError {
   constructor(message, reason) {
     super(16, message);
     this.name = 'DataStreamError';
@@ -20117,7 +20353,8 @@ class TextStreamReader extends BaseStreamReader {
           topic: streamHeader.topic,
           timestamp: Number(streamHeader.timestamp),
           attributes: streamHeader.attributes,
-          encryptionType
+          encryptionType,
+          attachedStreamIds: streamHeader.contentHeader.value.attachedStreamIds
         };
         const stream = new ReadableStream({
           start: controller => {
@@ -20270,7 +20507,8 @@ class OutgoingDataStreamManager {
         topic: (_b = options === null || options === void 0 ? void 0 : options.topic) !== null && _b !== void 0 ? _b : '',
         size: options === null || options === void 0 ? void 0 : options.totalSize,
         attributes: options === null || options === void 0 ? void 0 : options.attributes,
-        encryptionType: ((_c = this.engine.e2eeManager) === null || _c === void 0 ? void 0 : _c.isDataChannelEncryptionEnabled) ? Encryption_Type.GCM : Encryption_Type.NONE
+        encryptionType: ((_c = this.engine.e2eeManager) === null || _c === void 0 ? void 0 : _c.isDataChannelEncryptionEnabled) ? Encryption_Type.GCM : Encryption_Type.NONE,
+        attachedStreamIds: options === null || options === void 0 ? void 0 : options.attachedStreamIds
       };
       const header = new DataStream_Header({
         streamId,
@@ -20283,7 +20521,7 @@ class OutgoingDataStreamManager {
           case: 'textHeader',
           value: new DataStream_TextHeader({
             version: options === null || options === void 0 ? void 0 : options.version,
-            attachedStreamIds: options === null || options === void 0 ? void 0 : options.attachedStreamIds,
+            attachedStreamIds: info.attachedStreamIds,
             replyToStreamId: options === null || options === void 0 ? void 0 : options.replyToStreamId,
             operationType: (options === null || options === void 0 ? void 0 : options.type) === 'update' ? DataStream_OperationType.UPDATE : DataStream_OperationType.CREATE
           })
@@ -26893,7 +27131,44 @@ class JWSSignatureVerificationFailed extends JOSEError {
     _defineProperty(this, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');
   }
 }
-_defineProperty(JWSSignatureVerificationFailed, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');
+_defineProperty(JWSSignatureVerificationFailed, "code", 'ERR_JWS_SIGNATURE_VERIFICATION_FAILED');var DataTrackHandleErrorReason;
+(function (DataTrackHandleErrorReason) {
+  DataTrackHandleErrorReason[DataTrackHandleErrorReason["Reserved"] = 0] = "Reserved";
+  DataTrackHandleErrorReason[DataTrackHandleErrorReason["TooLarge"] = 1] = "TooLarge";
+})(DataTrackHandleErrorReason || (DataTrackHandleErrorReason = {}));
+var DataTrackDeserializeErrorReason;
+(function (DataTrackDeserializeErrorReason) {
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["TooShort"] = 0] = "TooShort";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["HeaderOverrun"] = 1] = "HeaderOverrun";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["MissingExtWords"] = 2] = "MissingExtWords";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["UnsupportedVersion"] = 3] = "UnsupportedVersion";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["InvalidHandle"] = 4] = "InvalidHandle";
+  DataTrackDeserializeErrorReason[DataTrackDeserializeErrorReason["MalformedExt"] = 5] = "MalformedExt";
+})(DataTrackDeserializeErrorReason || (DataTrackDeserializeErrorReason = {}));
+var DataTrackSerializeErrorReason;
+(function (DataTrackSerializeErrorReason) {
+  DataTrackSerializeErrorReason[DataTrackSerializeErrorReason["TooSmallForHeader"] = 0] = "TooSmallForHeader";
+  DataTrackSerializeErrorReason[DataTrackSerializeErrorReason["TooSmallForPayload"] = 1] = "TooSmallForPayload";
+})(DataTrackSerializeErrorReason || (DataTrackSerializeErrorReason = {}));
+var DataTrackExtensionTag;
+(function (DataTrackExtensionTag) {
+  DataTrackExtensionTag[DataTrackExtensionTag["UserTimestamp"] = 2] = "UserTimestamp";
+  DataTrackExtensionTag[DataTrackExtensionTag["E2ee"] = 1] = "E2ee";
+})(DataTrackExtensionTag || (DataTrackExtensionTag = {}));
+DataTrackExtensionTag.UserTimestamp;
+DataTrackExtensionTag.E2ee;
+/** Marker indicating a packet's position in relation to a frame. */
+var FrameMarker;
+(function (FrameMarker) {
+  /** Packet is the first in a frame. */
+  FrameMarker[FrameMarker["Start"] = 0] = "Start";
+  /** Packet is within a frame. */
+  FrameMarker[FrameMarker["Inter"] = 1] = "Inter";
+  /** Packet is the last in a frame. */
+  FrameMarker[FrameMarker["Final"] = 2] = "Final";
+  /** Packet is the only one in a frame. */
+  FrameMarker[FrameMarker["Single"] = 3] = "Single";
+})(FrameMarker || (FrameMarker = {}));
 
 /**
  * Base HTTP Client for Voice.ai API
@@ -27052,7 +27327,7 @@ class BaseClient {
     /**
      * Perform DELETE request
      */
-    async delete(path) {
+    async httpDelete(path) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'DELETE',
             headers: this.getHeaders(),
@@ -27245,25 +27520,26 @@ class AgentClient extends BaseClient {
         return this.post(`/agent/${encodeURIComponent(agentId)}/pause`);
     }
     /**
-     * Delete/disable an agent
+     * Delete an agent
      *
      * An agent must be paused before being deleted.
-     * Disabled agents will be automatically deleted after a grace period.
      *
      * @param agentId - The agent ID to delete
      * @returns Delete response
      *
      * @example
      * ```typescript
-     * // First pause, then delete
      * await client.agents.pause('agent-123');
-     * const result = await client.agents.disable('agent-123');
-     * console.log('Deleted:', result.message);
+     * await client.agents.disable('agent-123');
      * ```
      */
     async disable(agentId) {
         return this.post(`/agent/${encodeURIComponent(agentId)}/disable`);
     }
+    /** Alias for {@link disable} */
+    async delete(agentId) {
+        return this.disable(agentId);
+    }
     /**
      * Initialize agent from template
      *
@@ -27333,7 +27609,7 @@ class AgentClient extends BaseClient {
      * ```
      */
     async unassignKnowledgeBase(agentId) {
-        await this.delete(`/agent/${encodeURIComponent(agentId)}/knowledge-base`);
+        await this.httpDelete(`/agent/${encodeURIComponent(agentId)}/knowledge-base`);
     }
 }
 
@@ -27552,7 +27828,7 @@ class KnowledgeBaseClient extends BaseClient {
      * ```
      */
     async remove(kbId) {
-        await super.delete(`/knowledge-base/${kbId}`);
+        await this.httpDelete(`/knowledge-base/${kbId}`);
     }
 }
 
@@ -27698,6 +27974,264 @@ class PhoneNumberClient extends BaseClient {
     }
 }
 
+/**
+ * Text-to-Speech (TTS) Client
+ *
+ * Provides methods for:
+ * - Generating speech from text (synchronous and streaming)
+ * - Listing available voices
+ * - Getting voice details
+ * - Cloning voices from audio samples
+ * - Updating and deleting voices
+ */
+/**
+ * Client for Text-to-Speech operations
+ *
+ * @example
+ * ```typescript
+ * // List available voices
+ * const voices = await client.tts.listVoices();
+ *
+ * // Generate speech
+ * const audio = await client.tts.synthesize({
+ *   text: 'Hello world!',
+ *   voice_id: 'voice-123',
+ *   language: 'en',
+ * });
+ *
+ * // Clone a voice
+ * const cloned = await client.tts.cloneVoice({
+ *   file: audioFile,
+ *   name: 'My Voice',
+ *   language: 'en',
+ * });
+ * ```
+ */
+class TTSClient extends BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    // ==========================================================================
+    // SPEECH GENERATION
+    // ==========================================================================
+    /**
+     * Generate speech from text (returns complete audio file)
+     *
+     * This is the synchronous endpoint - it blocks until generation completes
+     * and returns the entire audio file as a Blob. For lower latency with
+     * chunked streaming, use {@link synthesizeStream}.
+     *
+     * @param options - Speech generation options
+     * @returns Audio blob in the requested format
+     *
+     * @example
+     * ```typescript
+     * const audio = await client.tts.synthesize({
+     *   text: 'Hello, welcome to Voice AI!',
+     *   voice_id: 'voice-123',
+     *   language: 'en',
+     *   audio_format: 'mp3',
+     * });
+     *
+     * // Play in browser
+     * const url = URL.createObjectURL(audio);
+     * new Audio(url).play();
+     *
+     * // Or download
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'speech.mp3';
+     * a.click();
+     * ```
+     */
+    async synthesize(options) {
+        return this.postForBlob('/tts/speech', options);
+    }
+    /**
+     * Generate speech from text with HTTP chunked streaming
+     *
+     * Returns a Response object with a readable body stream. Audio chunks
+     * are sent to the client as they are generated, providing lower perceived
+     * latency than {@link synthesize}.
+     *
+     * @param options - Speech generation options
+     * @returns Fetch Response with streaming body
+     *
+     * @example
+     * ```typescript
+     * const response = await client.tts.synthesizeStream({
+     *   text: 'Hello, welcome to Voice AI!',
+     *   voice_id: 'voice-123',
+     *   language: 'en',
+     * });
+     *
+     * // Read chunks as they arrive
+     * const reader = response.body!.getReader();
+     * while (true) {
+     *   const { done, value } = await reader.read();
+     *   if (done) break;
+     *   // Process audio chunk (Uint8Array)
+     *   console.log('Received chunk:', value.length, 'bytes');
+     * }
+     *
+     * // Or collect all chunks and create a blob
+     * const response = await client.tts.synthesizeStream({ text: '...', voice_id: '...' });
+     * const blob = await response.blob();
+     * ```
+     */
+    async synthesizeStream(options) {
+        return this.postForStream('/tts/speech/stream', options);
+    }
+    // ==========================================================================
+    // VOICE MANAGEMENT
+    // ==========================================================================
+    /**
+     * List voices available to the current user
+     *
+     * Returns voices owned by the authenticated user plus default/public voices.
+     * Deleted voices are excluded.
+     *
+     * @returns Array of voice objects
+     *
+     * @example
+     * ```typescript
+     * const voices = await client.tts.listVoices();
+     *
+     * for (const voice of voices) {
+     *   console.log(`${voice.name} (${voice.voice_id}): ${voice.status}`);
+     * }
+     *
+     * // Filter to only available voices
+     * const available = voices.filter(v => v.status === 'AVAILABLE');
+     * ```
+     */
+    async listVoices() {
+        return this.get('/tts/voices');
+    }
+    /**
+     * Get voice details and status
+     *
+     * Useful for polling the status of a voice clone operation
+     * (PENDING -> PROCESSING -> AVAILABLE).
+     *
+     * Access control:
+     * - PUBLIC voices: readable by any authenticated user
+     * - PRIVATE voices: readable only by owner (returns 404 otherwise)
+     *
+     * @param voiceId - The voice ID
+     * @returns Voice details and status
+     *
+     * @example
+     * ```typescript
+     * const voice = await client.tts.getVoice('voice-123');
+     *
+     * if (voice.status === 'AVAILABLE') {
+     *   console.log('Voice is ready to use!');
+     * } else if (voice.status === 'PROCESSING') {
+     *   console.log('Voice is still being processed...');
+     * }
+     * ```
+     */
+    async getVoice(voiceId) {
+        return this.get(`/tts/voice/${encodeURIComponent(voiceId)}`);
+    }
+    /**
+     * Clone a voice from a reference audio file
+     *
+     * Accepts an audio file (MP3, WAV, or OGG, max 7.5MB) and creates
+     * a cloned voice. The voice starts in PENDING status and moves to
+     * PROCESSING, then AVAILABLE once ready.
+     *
+     * Use {@link getVoice} to poll the voice status.
+     *
+     * @param options - Clone voice options including audio file
+     * @returns Created voice with ID and initial status (PENDING)
+     *
+     * @example
+     * ```typescript
+     * // From a file input
+     * const fileInput = document.querySelector('input[type="file"]');
+     * const file = fileInput.files[0];
+     *
+     * const voice = await client.tts.cloneVoice({
+     *   file: file,
+     *   name: 'My Custom Voice',
+     *   language: 'en',
+     *   voice_visibility: 'PRIVATE',
+     * });
+     *
+     * console.log('Voice ID:', voice.voice_id);
+     * console.log('Status:', voice.status); // 'PENDING'
+     *
+     * // Poll until ready
+     * let status = voice.status;
+     * while (status !== 'AVAILABLE' && status !== 'FAILED') {
+     *   await new Promise(r => setTimeout(r, 2000));
+     *   const updated = await client.tts.getVoice(voice.voice_id);
+     *   status = updated.status;
+     *   console.log('Status:', status);
+     * }
+     * ```
+     */
+    async cloneVoice(options) {
+        const formData = new FormData();
+        formData.append('file', options.file);
+        if (options.name !== undefined) {
+            formData.append('name', options.name);
+        }
+        if (options.voice_visibility !== undefined) {
+            formData.append('voice_visibility', options.voice_visibility);
+        }
+        if (options.language !== undefined) {
+            formData.append('language', options.language);
+        }
+        return this.postFormData('/tts/clone-voice', formData);
+    }
+    /**
+     * Update voice metadata (name and/or visibility)
+     *
+     * Only the voice owner can update a voice.
+     *
+     * @param voiceId - The voice ID to update
+     * @param options - Fields to update
+     * @returns Updated voice details
+     *
+     * @example
+     * ```typescript
+     * // Rename a voice
+     * const updated = await client.tts.updateVoice('voice-123', {
+     *   name: 'New Voice Name',
+     * });
+     *
+     * // Make a voice private
+     * const updated = await client.tts.updateVoice('voice-123', {
+     *   voice_visibility: 'PRIVATE',
+     * });
+     * ```
+     */
+    async updateVoice(voiceId, options) {
+        return this.patch(`/tts/voice/${encodeURIComponent(voiceId)}`, options);
+    }
+    /**
+     * Delete a voice
+     *
+     * Only the voice owner can delete a voice. The voice will no longer
+     * appear in voice listings.
+     *
+     * @param voiceId - The voice ID to delete
+     * @returns Deletion confirmation
+     *
+     * @example
+     * ```typescript
+     * await client.tts.deleteVoice('voice-123');
+     * console.log('Voice deleted');
+     * ```
+     */
+    async deleteVoice(voiceId) {
+        return this.httpDelete(`/tts/voice/${encodeURIComponent(voiceId)}`);
+    }
+}
+
 /**
  * VoiceAgentWidget - UI widget for Voice.ai
  *
@@ -28154,14 +28688,47 @@ const DEFAULT_API_URL = 'https://dev.voice.ai/api/v1';
  * ```
  */
 class VoiceAI {
+    // ==========================================================================
+    // API CLIENTS (REST API)
+    // ==========================================================================
+    /** Agent management - create, update, deploy, pause, delete agents. */
+    get agents() {
+        if (!this._agents)
+            throw new VoiceAIError('API key required for agents API. Pass apiKey in the constructor.');
+        return this._agents;
+    }
+    /** Analytics - call history, transcripts, stats. */
+    get analytics() {
+        if (!this._analytics)
+            throw new VoiceAIError('API key required for analytics API. Pass apiKey in the constructor.');
+        return this._analytics;
+    }
+    /** Knowledge Base - manage RAG documents. */
+    get knowledgeBase() {
+        if (!this._knowledgeBase)
+            throw new VoiceAIError('API key required for knowledgeBase API. Pass apiKey in the constructor.');
+        return this._knowledgeBase;
+    }
+    /** Phone Numbers - search, select, release phone numbers. */
+    get phoneNumbers() {
+        if (!this._phoneNumbers)
+            throw new VoiceAIError('API key required for phoneNumbers API. Pass apiKey in the constructor.');
+        return this._phoneNumbers;
+    }
+    /** Text-to-Speech - generate speech, manage voices, clone voices. */
+    get tts() {
+        if (!this._tts)
+            throw new VoiceAIError('API key required for tts API. Pass apiKey in the constructor.');
+        return this._tts;
+    }
     /**
      * Create a new VoiceAI client
      *
-     * @param config - Configuration options
-     * @param config.apiKey - Your Voice.ai API key (required)
+     * @param config - Configuration options (optional for frontend-only usage)
+     * @param config.apiKey - Your Voice.ai API key (required for API operations and `getConnectionDetails`)
      * @param config.apiUrl - Custom API URL (optional, defaults to production)
      */
-    constructor(config) {
+    constructor(config = {}) {
         // ==========================================================================
         // PRIVATE STATE (Real-time voice)
         // ==========================================================================
@@ -28173,31 +28740,118 @@ class VoiceAI {
         this.agentStateHandlers = new Set();
         this.audioLevelHandlers = new Set();
         this.microphoneStateHandlers = new Set();
+        this.effectiveApiKey = '';
         this.cachedConnectionDetails = null;
         this.currentAgentState = 'disconnected';
         this.agentParticipantId = null;
         this.audioLevelInterval = null;
-        if (!config.apiKey) {
-            throw new Error('API key is required. Get one at https://voice.ai');
-        }
-        this.apiKey = config.apiKey;
+        this.apiKey = config.apiKey || '';
         this.apiUrl = config.apiUrl || DEFAULT_API_URL;
-        // Initialize API clients
-        const clientConfig = { apiKey: this.apiKey, apiUrl: this.apiUrl };
-        this.agents = new AgentClient(clientConfig);
-        this.analytics = new AnalyticsClient(clientConfig);
-        this.knowledgeBase = new KnowledgeBaseClient(clientConfig);
-        this.phoneNumbers = new PhoneNumberClient(clientConfig);
+        // Initialize API clients when apiKey is provided
+        if (this.apiKey) {
+            const clientConfig = { apiKey: this.apiKey, apiUrl: this.apiUrl };
+            this._agents = new AgentClient(clientConfig);
+            this._analytics = new AnalyticsClient(clientConfig);
+            this._knowledgeBase = new KnowledgeBaseClient(clientConfig);
+            this._phoneNumbers = new PhoneNumberClient(clientConfig);
+            this._tts = new TTSClient(clientConfig);
+        }
     }
     // ==========================================================================
     // REAL-TIME VOICE CONNECTION
     // ==========================================================================
     /**
-     * Connect to a voice agent for real-time conversation
+     * Get connection details for a voice agent.
+     *
+     * Requires an API key. Call this from your backend, then pass the result
+     * to `connectRoom()` on the frontend.
+     *
+     * @param options - Connection options (agentId, testMode, etc.)
+     * @returns Connection details (serverUrl, participantToken, callId)
+     *
+     * @example
+     * ```typescript
+     * // Server-side: get connection details
+     * const details = await voiceai.getConnectionDetails({ agentId: 'agent-123' });
+     * // Return details to frontend...
+     *
+     * // With test mode
+     * const details = await voiceai.getConnectionDetails({
+     *   agentId: 'agent-123',
+     *   testMode: true
+     * });
+     * ```
+     */
+    async getConnectionDetails(options) {
+        return this.fetchConnectionDetails(options);
+    }
+    /**
+     * Connect to a LiveKit room using pre-fetched connection details.
+     *
+     * This is the browser-safe method -- it only needs a room token,
+     * no API key required. Get the connection details from your backend
+     * using `getConnectionDetails()`.
+     *
+     * @param connectionDetails - Server URL, participant token, and call ID from your backend
+     * @param options - Audio/microphone options
+     *
+     * @example
+     * ```typescript
+     * // Frontend: connect using token from your backend
+     * const voiceai = new VoiceAI();
+     * await voiceai.connectRoom(
+     *   { serverUrl, participantToken, callId },
+     *   { autoPublishMic: true }
+     * );
+     * ```
+     */
+    async connectRoom(connectionDetails, options = {}) {
+        if (this.connectionStatus.connecting || this.connectionStatus.connected) {
+            throw new Error('Already connected or connecting');
+        }
+        this.updateStatus({ connecting: true, connected: false });
+        this.cachedConnectionDetails = connectionDetails;
+        try {
+            this.room = new Room();
+            this.setupRoomListeners();
+            this.room.prepareConnection(connectionDetails.serverUrl, connectionDetails.participantToken);
+            const preConnectBuffer = options.preConnectBuffer !== false;
+            let connected = false;
+            let lastError;
+            for (let attempt = 1; attempt <= 3; attempt++) {
+                try {
+                    await Promise.all([
+                        this.setupAudio(options, preConnectBuffer),
+                        this.room.connect(connectionDetails.serverUrl, connectionDetails.participantToken)
+                    ]);
+                    connected = true;
+                    break;
+                }
+                catch (error) {
+                    lastError = error;
+                    if (attempt < 3) {
+                        await new Promise(resolve => setTimeout(resolve, 1000 * attempt));
+                    }
+                }
+            }
+            if (!connected) {
+                throw lastError || new Error('Failed to connect after 3 attempts');
+            }
+            this.updateStatus({ connected: true, connecting: false, callId: connectionDetails.callId });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.updateStatus({ connected: false, connecting: false, error: err.message });
+            this.emitError(err);
+            throw err;
+        }
+    }
+    /**
+     * Connect to a voice agent for real-time conversation.
+     *
+     * Convenience method that combines `getConnectionDetails()` + `connectRoom()`.
      *
      * @param options - Connection options
-     * @param options.agentId - ID of the agent to connect to
-     * @param options.autoPublishMic - Auto-enable microphone (default: true)
      *
      * @example
      * ```typescript
@@ -28210,7 +28864,7 @@ class VoiceAI {
         }
         this.updateStatus({ connecting: true, connected: false });
         try {
-            // Get connection details from API
+            // Get connection details via the appropriate method
             const connectionDetails = await this.getOrRefreshConnectionDetails(options);
             // Create room instance
             this.room = new Room();
@@ -28250,11 +28904,17 @@ class VoiceAI {
         }
     }
     /**
-     * Disconnect from the voice agent and end the call
+     * Disconnect from the room and end the call.
+     *
+     * Signals the server to free the concurrency slot using endToken from
+     * connection details. Connection details always include end_token when
+     * fetched from the API; backends must pass it when using pre-fetched details.
+     * If no endToken, the server detects room disconnect as fallback.
      */
     async disconnect() {
         this.stopAudioLevelMonitoring();
         const callId = this.cachedConnectionDetails?.callId;
+        const endToken = this.cachedConnectionDetails?.endToken;
         if (this.room) {
             try {
                 await this.room.disconnect();
@@ -28264,22 +28924,29 @@ class VoiceAI {
             }
             this.room = null;
         }
-        // End call via API
-        if (callId) {
+        // Signal server to free concurrency slot (endToken only - API always returns it)
+        if (callId && endToken) {
             try {
-                await fetch(`${this.apiUrl}/calls/${encodeURIComponent(callId)}/end`, {
+                const response = await fetch(`${this.apiUrl}/calls/${encodeURIComponent(callId)}/end`, {
                     method: 'POST',
                     headers: {
                         'Content-Type': 'application/json',
-                        'Authorization': `Bearer ${this.apiKey}`
+                        'Authorization': `Bearer ${endToken}`
                     }
                 });
+                if (!response.ok) {
+                    console.warn(`[VoiceAI] Failed to end call ${callId}: ${response.status} ${response.statusText}`);
+                }
             }
-            catch {
-                // Non-critical
+            catch (err) {
+                console.warn(`[VoiceAI] Failed to end call ${callId}:`, err);
             }
         }
+        else if (callId && !endToken) {
+            console.warn(`[VoiceAI] No endToken in connection details - pass end_token from your backend to enable immediate teardown`);
+        }
         this.cachedConnectionDetails = null;
+        this.effectiveApiKey = '';
         this.agentParticipantId = null;
         this.updateAgentState('disconnected');
         this.updateStatus({ connected: false, connecting: false });
@@ -28418,16 +29085,52 @@ class VoiceAI {
         }
     }
     async getOrRefreshConnectionDetails(options) {
+        // Mode 1: Pre-fetched connection details provided directly
+        if (options.serverUrl && options.participantToken) {
+            const details = {
+                serverUrl: options.serverUrl,
+                participantToken: options.participantToken,
+                callId: options.callId || '',
+                endToken: options.endToken,
+            };
+            this.cachedConnectionDetails = details;
+            return details;
+        }
+        // Use cached details if still valid
         if (this.cachedConnectionDetails && !this.isTokenExpired(this.cachedConnectionDetails.participantToken)) {
             return this.cachedConnectionDetails;
         }
-        const connectionDetails = await this.getConnectionDetails(options);
+        // Mode 2: Direct API call with API key (constructor or per-call)
+        if (!this.apiKey && !options.apiKey) {
+            throw new Error('No authentication method configured. Use one of:\n' +
+                '1. connectRoom() with pre-fetched details from your backend\n' +
+                '2. API key: new VoiceAI({ apiKey: "vk_..." }) or connect({ apiKey: "vk_..." })');
+        }
+        const connectionDetails = await this.fetchConnectionDetails(options);
         this.cachedConnectionDetails = connectionDetails;
         return connectionDetails;
     }
-    async getConnectionDetails(options) {
+    /**
+     * Fetch connection details from the developer's backend endpoint.
+     * The backend holds the API key and calls the Voice.AI API server-side.
+     */
+    /**
+     * Fetch connection details using the API key directly.
+     * Used by the public getConnectionDetails() method.
+     */
+    async fetchConnectionDetails(options) {
+        if (!this.apiKey && !options.apiKey) {
+            throw new Error('API key is required for getConnectionDetails(). Pass { apiKey: "vk_..." } to the constructor or options.');
+        }
+        return this.fetchConnectionDetailsFromApi(options);
+    }
+    async fetchConnectionDetailsFromApi(options) {
         const url = options.apiUrl || this.apiUrl;
-        const endpoint = `${url}/connection/connection-details`;
+        // Use test-connection-details for testMode (allows testing paused/undeployed agents)
+        const endpointPath = options.testMode
+            ? '/connection/test-connection-details'
+            : '/connection/connection-details';
+        const endpoint = `${url}${endpointPath}`;
         const requestData = {};
         if (options.agentId)
             requestData.agent_id = options.agentId;
@@ -28443,6 +29146,7 @@ class VoiceAI {
                 : JSON.stringify(options.environment);
         }
         const apiKey = options.apiKey || this.apiKey;
+        this.effectiveApiKey = apiKey;
         const response = await fetch(endpoint, {
             method: 'POST',
             headers: {
@@ -28468,7 +29172,8 @@ class VoiceAI {
         return {
             serverUrl: data.server_url,
             participantToken: data.participant_token,
-            callId: data.call_id
+            callId: data.call_id,
+            endToken: data.end_token,
         };
     }
     async setupAudio(options, preConnectBuffer) {