@voice-ai-labs/web-sdk 0.9.1 → 1.0.0

package/dist/index.js

@@ -10706,7 +10706,7 @@ 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.3";const version = version$1;
+}var version$1 = "2.18.0";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) {
@@ -18659,6 +18659,9 @@ class RTCEngine extends eventsExports.EventEmitter {
   get isClosed() {
     return this._isClosed;
   }
+  get isNewlyCreated() {
+    return this._isNewlyCreated;
+  }
   get pendingReconnect() {
     return !!this.reconnectTimeout;
   }
@@ -18676,6 +18679,7 @@ class RTCEngine extends eventsExports.EventEmitter {
     this.subscriberPrimary = false;
     this.pcState = PCState.New;
     this._isClosed = true;
+    this._isNewlyCreated = true;
     this.pendingTrackResolvers = {};
     this.reconnectAttempts = 0;
     this.reconnectStart = 0;
@@ -18933,7 +18937,7 @@ class RTCEngine extends eventsExports.EventEmitter {
       room: (_b = (_a = this.latestJoinResponse) === null || _a === void 0 ? void 0 : _a.room) === null || _b === void 0 ? void 0 : _b.name,
       roomID: (_d = (_c = this.latestJoinResponse) === null || _c === void 0 ? void 0 : _c.room) === null || _d === void 0 ? void 0 : _d.sid,
       participant: (_f = (_e = this.latestJoinResponse) === null || _e === void 0 ? void 0 : _e.participant) === null || _f === void 0 ? void 0 : _f.identity,
-      pID: this.participantSid
+      participantID: this.participantSid
     };
   }
   join(url_1, token_1, opts_1, abortSignal_1) {
@@ -18941,6 +18945,7 @@ class RTCEngine extends eventsExports.EventEmitter {
       var _this2 = this;
       let useV0Path = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : false;
       return function* () {
+        _this2._isNewlyCreated = false;
         _this2.url = url;
         _this2.token = token;
         _this2.signalOpts = opts;
@@ -20596,7 +20601,7 @@ class OutgoingDataStreamManager {
         mimeType: info.mimeType,
         topic: info.topic,
         timestamp: numberToBigInt(info.timestamp),
-        totalLength: numberToBigInt(options === null || options === void 0 ? void 0 : options.totalSize),
+        totalLength: numberToBigInt(info.size),
         attributes: info.attributes,
         contentHeader: {
           case: 'textHeader',
@@ -20706,7 +20711,7 @@ class OutgoingDataStreamManager {
   }
   streamBytes(options) {
     return __awaiter(this, void 0, void 0, function* () {
-      var _a, _b, _c, _d, _e, _f;
+      var _a, _b, _c, _d, _e;
       const streamId = (_a = options === null || options === void 0 ? void 0 : options.streamId) !== null && _a !== void 0 ? _a : crypto.randomUUID();
       const destinationIdentities = options === null || options === void 0 ? void 0 : options.destinationIdentities;
       const info = {
@@ -20720,7 +20725,7 @@ class OutgoingDataStreamManager {
         encryptionType: ((_e = this.engine.e2eeManager) === null || _e === void 0 ? void 0 : _e.isDataChannelEncryptionEnabled) ? Encryption_Type.GCM : Encryption_Type.NONE
       };
       const header = new DataStream_Header({
-        totalLength: numberToBigInt((_f = info.size) !== null && _f !== void 0 ? _f : 0),
+        totalLength: numberToBigInt(info.size),
         mimeType: info.mimeType,
         streamId,
         topic: info.topic,
@@ -24093,7 +24098,7 @@ class Participant extends eventsExports.EventEmitter {
   }
   get logContext() {
     return Object.assign(Object.assign({}, super.logContext), {
-      rpID: this.sid,
+      remoteParticipantID: this.sid,
       remoteParticipant: this.identity
     });
   }
@@ -25249,7 +25254,7 @@ class Room extends eventsExports.EventEmitter {
       room: this.name,
       roomID: (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.sid,
       participant: this.localParticipant.identity,
-      pID: this.localParticipant.sid
+      participantID: this.localParticipant.sid
     };
   }
   /**
@@ -25303,7 +25308,7 @@ class Room extends eventsExports.EventEmitter {
     return (_b = (_a = this.roomInfo) === null || _a === void 0 ? void 0 : _a.numPublishers) !== null && _b !== void 0 ? _b : 0;
   }
   maybeCreateEngine() {
-    if (this.engine && !this.engine.isClosed) {
+    if (this.engine && (this.engine.isNewlyCreated || !this.engine.isClosed)) {
       return;
     }
     this.engine = new RTCEngine(this.options);
@@ -25756,7 +25761,7 @@ class Room extends eventsExports.EventEmitter {
     }
     if (!trackId.startsWith('TR')) {
       this.log.warn("Tried to add a track whose 'sid' could not be determined for a participant, that's not present. Sid: ".concat(participantSid, ", streamId: ").concat(streamId, ", trackId: ").concat(trackId), Object.assign(Object.assign({}, this.logContext), {
-        rpID: participantSid,
+        remoteParticipantID: participantSid,
         streamId,
         trackId
       }));
@@ -26299,6 +26304,11 @@ function mapArgs(args) {
     return arg;
   });
 }// This file was generated from JSON Schema using quicktype, do not modify it directly.
+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";
@@ -26320,11 +26330,6 @@ var DataTrackExtensionTag;
 })(DataTrackExtensionTag || (DataTrackExtensionTag = {}));
 DataTrackExtensionTag.UserTimestamp;
 DataTrackExtensionTag.E2ee;
-var DataTrackHandleErrorReason;
-(function (DataTrackHandleErrorReason) {
-  DataTrackHandleErrorReason[DataTrackHandleErrorReason["Reserved"] = 0] = "Reserved";
-  DataTrackHandleErrorReason[DataTrackHandleErrorReason["TooLarge"] = 1] = "TooLarge";
-})(DataTrackHandleErrorReason || (DataTrackHandleErrorReason = {}));
 /** Marker indicating a packet's position in relation to a frame. */
 var FrameMarker;
 (function (FrameMarker) {
@@ -26348,7 +26353,17 @@ var DataTrackDepacketizerDropReason;
   DataTrackDepacketizerDropReason[DataTrackDepacketizerDropReason["UnknownFrame"] = 1] = "UnknownFrame";
   DataTrackDepacketizerDropReason[DataTrackDepacketizerDropReason["BufferFull"] = 2] = "BufferFull";
   DataTrackDepacketizerDropReason[DataTrackDepacketizerDropReason["Incomplete"] = 3] = "Incomplete";
-})(DataTrackDepacketizerDropReason || (DataTrackDepacketizerDropReason = {}));var DataTrackPublishErrorReason;
+})(DataTrackDepacketizerDropReason || (DataTrackDepacketizerDropReason = {}));var DataTrackSubscribeErrorReason;
+(function (DataTrackSubscribeErrorReason) {
+  /** The track has been unpublished and is no longer available */
+  DataTrackSubscribeErrorReason[DataTrackSubscribeErrorReason["Unpublished"] = 0] = "Unpublished";
+  /** Request to subscribe to data track timed-out */
+  DataTrackSubscribeErrorReason[DataTrackSubscribeErrorReason["Timeout"] = 1] = "Timeout";
+  /** Cannot subscribe to data track when disconnected */
+  DataTrackSubscribeErrorReason[DataTrackSubscribeErrorReason["Disconnected"] = 2] = "Disconnected";
+  /** Subscription to data track cancelled by caller */
+  DataTrackSubscribeErrorReason[DataTrackSubscribeErrorReason["Cancelled"] = 4] = "Cancelled";
+})(DataTrackSubscribeErrorReason || (DataTrackSubscribeErrorReason = {}));getLogger(LoggerNames.DataTracks);getLogger(LoggerNames.DataTracks);var DataTrackPublishErrorReason;
 (function (DataTrackPublishErrorReason) {
   /**
    * Local participant does not have permission to publish data tracks.
@@ -27324,15 +27339,33 @@ class VoiceAIError extends Error {
  */
 class BaseClient {
     constructor(config) {
-        this.apiKey = config.apiKey;
+        this.apiKey = config.apiKey || '';
+        this.authToken = config.authToken;
+        this.getAuthToken = config.getAuthToken;
         this.apiUrl = config.apiUrl;
     }
+    async resolveBearerToken() {
+        if (this.apiKey) {
+            return this.apiKey;
+        }
+        if (this.authToken) {
+            return this.authToken;
+        }
+        if (this.getAuthToken) {
+            const resolvedToken = await this.getAuthToken();
+            if (typeof resolvedToken === 'string' && resolvedToken.trim()) {
+                return resolvedToken;
+            }
+        }
+        throw new VoiceAIError('Authentication required. Configure apiKey, authToken, or getAuthToken.', 401, 'UNAUTHORIZED');
+    }
     /**
      * Build headers with authentication
      */
-    getHeaders(contentType = 'application/json') {
+    async getHeaders(contentType = 'application/json') {
+        const bearerToken = await this.resolveBearerToken();
         const headers = {
-            'Authorization': `Bearer ${this.apiKey}`,
+            'Authorization': `Bearer ${bearerToken}`,
         };
         if (contentType) {
             headers['Content-Type'] = contentType;
@@ -27362,7 +27395,7 @@ class BaseClient {
         }
         // Handle specific error codes
         if (response.status === 401) {
-            throw new VoiceAIError('Authentication failed. Please check your API key.', 401, 'UNAUTHORIZED');
+            throw new VoiceAIError('Authentication failed. Please check your API key or auth token.', 401, 'UNAUTHORIZED');
         }
         if (response.status === 403) {
             const detail = errorData?.detail || errorData?.error;
@@ -27403,7 +27436,7 @@ class BaseClient {
         }
         const response = await fetch(url.toString(), {
             method: 'GET',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
         });
         return this.handleResponse(response);
     }
@@ -27426,7 +27459,7 @@ class BaseClient {
         }
         const response = await fetch(url.toString(), {
             method: 'GET',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
         });
         if (!response.ok) {
             let errorData = null;
@@ -27446,7 +27479,7 @@ class BaseClient {
     async post(path, body) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'POST',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
         return this.handleResponse(response);
@@ -27457,7 +27490,7 @@ class BaseClient {
     async postFormData(path, formData) {
         // Don't set Content-Type header - browser will set it with boundary
         const headers = {
-            'Authorization': `Bearer ${this.apiKey}`,
+            'Authorization': `Bearer ${await this.resolveBearerToken()}`,
         };
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'POST',
@@ -27472,7 +27505,7 @@ class BaseClient {
     async put(path, body) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'PUT',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
         return this.handleResponse(response);
@@ -27483,7 +27516,7 @@ class BaseClient {
     async patch(path, body) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'PATCH',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
         return this.handleResponse(response);
@@ -27494,7 +27527,7 @@ class BaseClient {
     async httpDelete(path) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'DELETE',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
         });
         return this.handleResponse(response);
     }
@@ -27504,7 +27537,7 @@ class BaseClient {
     async postForBlob(path, body) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'POST',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
         if (!response.ok) {
@@ -27526,7 +27559,7 @@ class BaseClient {
     async postForStream(path, body) {
         const response = await fetch(`${this.apiUrl}${path}`, {
             method: 'POST',
-            headers: this.getHeaders(),
+            headers: await this.getHeaders(),
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
         if (!response.ok) {
@@ -27791,6 +27824,7 @@ class AgentClient extends BaseClient {
  * Provides methods for:
  * - Getting call history with filters
  * - Getting transcript URLs
+ * - Getting recording status and URLs
  * - Getting agent stats summary
  */
 /**
@@ -27841,6 +27875,12 @@ class AnalyticsClient extends BaseClient {
             params.end_date = options.end_date;
         if (options?.agent_ids)
             params.agent_ids = options.agent_ids;
+        if (options?.agent_name)
+            params.agent_name = options.agent_name;
+        if (options?.sort_by)
+            params.sort_by = options.sort_by;
+        if (options?.sort_dir)
+            params.sort_dir = options.sort_dir;
         return this.get('/agent/call-history', params);
     }
     /**
@@ -27860,6 +27900,24 @@ class AnalyticsClient extends BaseClient {
     async getTranscriptUrl(callId) {
         return this.get(`/agent/call-history/${callId}/transcript`);
     }
+    /**
+     * Get recording status or download URL for a call
+     *
+     * @param callId - The call identifier
+     * @returns Object with recording status and optional URL
+     *
+     * @example
+     * ```typescript
+     * const recording = await client.analytics.getRecordingUrl("call_12345");
+     *
+     * if (recording.status === 'ready' && recording.url) {
+     *   window.open(recording.url, '_blank');
+     * }
+     * ```
+     */
+    async getRecordingUrl(callId) {
+        return this.get(`/agent/call-history/${callId}/recording`);
+    }
     /**
      * Get agent stats summary
      *
@@ -28004,6 +28062,29 @@ class KnowledgeBaseClient extends BaseClient {
     }
 }
 
+class GoogleManagedToolsClient extends BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    async startOAuth(agentId, options = {}) {
+        return this.post(`/google/${encodeURIComponent(agentId)}/oauth/start`, {
+            return_path: options.returnUrl,
+            managed_tools: options.managedTools,
+        });
+    }
+    async getStatus(agentId) {
+        return this.get(`/google/${encodeURIComponent(agentId)}/status`);
+    }
+    async disconnect(agentId) {
+        return this.httpDelete(`/google/${encodeURIComponent(agentId)}/disconnect`);
+    }
+}
+class ManagedToolsClient {
+    constructor(config) {
+        this.google = new GoogleManagedToolsClient(config);
+    }
+}
+
 /**
  * Phone Number Management Client
  *
@@ -28310,7 +28391,7 @@ class TTSClient extends BaseClient {
     /**
      * Clone a voice from a reference audio file
      *
-     * Accepts an audio file (MP3, WAV, or OGG, max 7.5MB) and creates
+     * Accepts an audio file (MP3, WAV, or M4A, max 7.5MB) and creates
      * a cloned voice. The voice starts in PENDING status and moves to
      * PROCESSING, then AVAILABLE once ready.
      *
@@ -28443,6 +28524,648 @@ class TTSClient extends BaseClient {
     }
 }
 
+const IANA_TIMEZONE_IDS = Object.freeze([
+    "Africa/Abidjan",
+    "Africa/Accra",
+    "Africa/Addis_Ababa",
+    "Africa/Algiers",
+    "Africa/Asmera",
+    "Africa/Bamako",
+    "Africa/Bangui",
+    "Africa/Banjul",
+    "Africa/Bissau",
+    "Africa/Blantyre",
+    "Africa/Brazzaville",
+    "Africa/Bujumbura",
+    "Africa/Cairo",
+    "Africa/Casablanca",
+    "Africa/Ceuta",
+    "Africa/Conakry",
+    "Africa/Dakar",
+    "Africa/Dar_es_Salaam",
+    "Africa/Djibouti",
+    "Africa/Douala",
+    "Africa/El_Aaiun",
+    "Africa/Freetown",
+    "Africa/Gaborone",
+    "Africa/Harare",
+    "Africa/Johannesburg",
+    "Africa/Juba",
+    "Africa/Kampala",
+    "Africa/Khartoum",
+    "Africa/Kigali",
+    "Africa/Kinshasa",
+    "Africa/Lagos",
+    "Africa/Libreville",
+    "Africa/Lome",
+    "Africa/Luanda",
+    "Africa/Lubumbashi",
+    "Africa/Lusaka",
+    "Africa/Malabo",
+    "Africa/Maputo",
+    "Africa/Maseru",
+    "Africa/Mbabane",
+    "Africa/Mogadishu",
+    "Africa/Monrovia",
+    "Africa/Nairobi",
+    "Africa/Ndjamena",
+    "Africa/Niamey",
+    "Africa/Nouakchott",
+    "Africa/Ouagadougou",
+    "Africa/Porto-Novo",
+    "Africa/Sao_Tome",
+    "Africa/Tripoli",
+    "Africa/Tunis",
+    "Africa/Windhoek",
+    "America/Adak",
+    "America/Anchorage",
+    "America/Anguilla",
+    "America/Antigua",
+    "America/Araguaina",
+    "America/Argentina/La_Rioja",
+    "America/Argentina/Rio_Gallegos",
+    "America/Argentina/Salta",
+    "America/Argentina/San_Juan",
+    "America/Argentina/San_Luis",
+    "America/Argentina/Tucuman",
+    "America/Argentina/Ushuaia",
+    "America/Aruba",
+    "America/Asuncion",
+    "America/Bahia",
+    "America/Bahia_Banderas",
+    "America/Barbados",
+    "America/Belem",
+    "America/Belize",
+    "America/Blanc-Sablon",
+    "America/Boa_Vista",
+    "America/Bogota",
+    "America/Boise",
+    "America/Buenos_Aires",
+    "America/Cambridge_Bay",
+    "America/Campo_Grande",
+    "America/Cancun",
+    "America/Caracas",
+    "America/Catamarca",
+    "America/Cayenne",
+    "America/Cayman",
+    "America/Chicago",
+    "America/Chihuahua",
+    "America/Ciudad_Juarez",
+    "America/Coral_Harbour",
+    "America/Cordoba",
+    "America/Costa_Rica",
+    "America/Creston",
+    "America/Cuiaba",
+    "America/Curacao",
+    "America/Danmarkshavn",
+    "America/Dawson",
+    "America/Dawson_Creek",
+    "America/Denver",
+    "America/Detroit",
+    "America/Dominica",
+    "America/Edmonton",
+    "America/Eirunepe",
+    "America/El_Salvador",
+    "America/Fort_Nelson",
+    "America/Fortaleza",
+    "America/Glace_Bay",
+    "America/Godthab",
+    "America/Goose_Bay",
+    "America/Grand_Turk",
+    "America/Grenada",
+    "America/Guadeloupe",
+    "America/Guatemala",
+    "America/Guayaquil",
+    "America/Guyana",
+    "America/Halifax",
+    "America/Havana",
+    "America/Hermosillo",
+    "America/Indiana/Knox",
+    "America/Indiana/Marengo",
+    "America/Indiana/Petersburg",
+    "America/Indiana/Tell_City",
+    "America/Indiana/Vevay",
+    "America/Indiana/Vincennes",
+    "America/Indiana/Winamac",
+    "America/Indianapolis",
+    "America/Inuvik",
+    "America/Iqaluit",
+    "America/Jamaica",
+    "America/Jujuy",
+    "America/Juneau",
+    "America/Kentucky/Monticello",
+    "America/Kralendijk",
+    "America/La_Paz",
+    "America/Lima",
+    "America/Los_Angeles",
+    "America/Louisville",
+    "America/Lower_Princes",
+    "America/Maceio",
+    "America/Managua",
+    "America/Manaus",
+    "America/Marigot",
+    "America/Martinique",
+    "America/Matamoros",
+    "America/Mazatlan",
+    "America/Mendoza",
+    "America/Menominee",
+    "America/Merida",
+    "America/Metlakatla",
+    "America/Mexico_City",
+    "America/Miquelon",
+    "America/Moncton",
+    "America/Monterrey",
+    "America/Montevideo",
+    "America/Montserrat",
+    "America/Nassau",
+    "America/New_York",
+    "America/Nome",
+    "America/Noronha",
+    "America/North_Dakota/Beulah",
+    "America/North_Dakota/Center",
+    "America/North_Dakota/New_Salem",
+    "America/Ojinaga",
+    "America/Panama",
+    "America/Paramaribo",
+    "America/Phoenix",
+    "America/Port-au-Prince",
+    "America/Port_of_Spain",
+    "America/Porto_Velho",
+    "America/Puerto_Rico",
+    "America/Punta_Arenas",
+    "America/Rankin_Inlet",
+    "America/Recife",
+    "America/Regina",
+    "America/Resolute",
+    "America/Rio_Branco",
+    "America/Santarem",
+    "America/Santiago",
+    "America/Santo_Domingo",
+    "America/Sao_Paulo",
+    "America/Scoresbysund",
+    "America/Sitka",
+    "America/St_Barthelemy",
+    "America/St_Johns",
+    "America/St_Kitts",
+    "America/St_Lucia",
+    "America/St_Thomas",
+    "America/St_Vincent",
+    "America/Swift_Current",
+    "America/Tegucigalpa",
+    "America/Thule",
+    "America/Tijuana",
+    "America/Toronto",
+    "America/Tortola",
+    "America/Vancouver",
+    "America/Whitehorse",
+    "America/Winnipeg",
+    "America/Yakutat",
+    "Antarctica/Casey",
+    "Antarctica/Davis",
+    "Antarctica/DumontDUrville",
+    "Antarctica/Macquarie",
+    "Antarctica/Mawson",
+    "Antarctica/McMurdo",
+    "Antarctica/Palmer",
+    "Antarctica/Rothera",
+    "Antarctica/Syowa",
+    "Antarctica/Troll",
+    "Antarctica/Vostok",
+    "Arctic/Longyearbyen",
+    "Asia/Aden",
+    "Asia/Almaty",
+    "Asia/Amman",
+    "Asia/Anadyr",
+    "Asia/Aqtau",
+    "Asia/Aqtobe",
+    "Asia/Ashgabat",
+    "Asia/Atyrau",
+    "Asia/Baghdad",
+    "Asia/Bahrain",
+    "Asia/Baku",
+    "Asia/Bangkok",
+    "Asia/Barnaul",
+    "Asia/Beirut",
+    "Asia/Bishkek",
+    "Asia/Brunei",
+    "Asia/Calcutta",
+    "Asia/Chita",
+    "Asia/Colombo",
+    "Asia/Damascus",
+    "Asia/Dhaka",
+    "Asia/Dili",
+    "Asia/Dubai",
+    "Asia/Dushanbe",
+    "Asia/Famagusta",
+    "Asia/Gaza",
+    "Asia/Hebron",
+    "Asia/Hong_Kong",
+    "Asia/Hovd",
+    "Asia/Irkutsk",
+    "Asia/Jakarta",
+    "Asia/Jayapura",
+    "Asia/Jerusalem",
+    "Asia/Kabul",
+    "Asia/Kamchatka",
+    "Asia/Karachi",
+    "Asia/Katmandu",
+    "Asia/Khandyga",
+    "Asia/Krasnoyarsk",
+    "Asia/Kuala_Lumpur",
+    "Asia/Kuching",
+    "Asia/Kuwait",
+    "Asia/Macau",
+    "Asia/Magadan",
+    "Asia/Makassar",
+    "Asia/Manila",
+    "Asia/Muscat",
+    "Asia/Nicosia",
+    "Asia/Novokuznetsk",
+    "Asia/Novosibirsk",
+    "Asia/Omsk",
+    "Asia/Oral",
+    "Asia/Phnom_Penh",
+    "Asia/Pontianak",
+    "Asia/Pyongyang",
+    "Asia/Qatar",
+    "Asia/Qostanay",
+    "Asia/Qyzylorda",
+    "Asia/Rangoon",
+    "Asia/Riyadh",
+    "Asia/Saigon",
+    "Asia/Sakhalin",
+    "Asia/Samarkand",
+    "Asia/Seoul",
+    "Asia/Shanghai",
+    "Asia/Singapore",
+    "Asia/Srednekolymsk",
+    "Asia/Taipei",
+    "Asia/Tashkent",
+    "Asia/Tbilisi",
+    "Asia/Tehran",
+    "Asia/Thimphu",
+    "Asia/Tokyo",
+    "Asia/Tomsk",
+    "Asia/Ulaanbaatar",
+    "Asia/Urumqi",
+    "Asia/Ust-Nera",
+    "Asia/Vientiane",
+    "Asia/Vladivostok",
+    "Asia/Yakutsk",
+    "Asia/Yekaterinburg",
+    "Asia/Yerevan",
+    "Atlantic/Azores",
+    "Atlantic/Bermuda",
+    "Atlantic/Canary",
+    "Atlantic/Cape_Verde",
+    "Atlantic/Faeroe",
+    "Atlantic/Madeira",
+    "Atlantic/Reykjavik",
+    "Atlantic/South_Georgia",
+    "Atlantic/St_Helena",
+    "Atlantic/Stanley",
+    "Australia/Adelaide",
+    "Australia/Brisbane",
+    "Australia/Broken_Hill",
+    "Australia/Darwin",
+    "Australia/Eucla",
+    "Australia/Hobart",
+    "Australia/Lindeman",
+    "Australia/Lord_Howe",
+    "Australia/Melbourne",
+    "Australia/Perth",
+    "Australia/Sydney",
+    "Europe/Amsterdam",
+    "Europe/Andorra",
+    "Europe/Astrakhan",
+    "Europe/Athens",
+    "Europe/Belgrade",
+    "Europe/Berlin",
+    "Europe/Bratislava",
+    "Europe/Brussels",
+    "Europe/Bucharest",
+    "Europe/Budapest",
+    "Europe/Busingen",
+    "Europe/Chisinau",
+    "Europe/Copenhagen",
+    "Europe/Dublin",
+    "Europe/Gibraltar",
+    "Europe/Guernsey",
+    "Europe/Helsinki",
+    "Europe/Isle_of_Man",
+    "Europe/Istanbul",
+    "Europe/Jersey",
+    "Europe/Kaliningrad",
+    "Europe/Kiev",
+    "Europe/Kirov",
+    "Europe/Lisbon",
+    "Europe/Ljubljana",
+    "Europe/London",
+    "Europe/Luxembourg",
+    "Europe/Madrid",
+    "Europe/Malta",
+    "Europe/Mariehamn",
+    "Europe/Minsk",
+    "Europe/Monaco",
+    "Europe/Moscow",
+    "Europe/Oslo",
+    "Europe/Paris",
+    "Europe/Podgorica",
+    "Europe/Prague",
+    "Europe/Riga",
+    "Europe/Rome",
+    "Europe/Samara",
+    "Europe/San_Marino",
+    "Europe/Sarajevo",
+    "Europe/Saratov",
+    "Europe/Simferopol",
+    "Europe/Skopje",
+    "Europe/Sofia",
+    "Europe/Stockholm",
+    "Europe/Tallinn",
+    "Europe/Tirane",
+    "Europe/Ulyanovsk",
+    "Europe/Vaduz",
+    "Europe/Vatican",
+    "Europe/Vienna",
+    "Europe/Vilnius",
+    "Europe/Volgograd",
+    "Europe/Warsaw",
+    "Europe/Zagreb",
+    "Europe/Zurich",
+    "Indian/Antananarivo",
+    "Indian/Chagos",
+    "Indian/Christmas",
+    "Indian/Cocos",
+    "Indian/Comoro",
+    "Indian/Kerguelen",
+    "Indian/Mahe",
+    "Indian/Maldives",
+    "Indian/Mauritius",
+    "Indian/Mayotte",
+    "Indian/Reunion",
+    "Pacific/Apia",
+    "Pacific/Auckland",
+    "Pacific/Bougainville",
+    "Pacific/Chatham",
+    "Pacific/Easter",
+    "Pacific/Efate",
+    "Pacific/Enderbury",
+    "Pacific/Fakaofo",
+    "Pacific/Fiji",
+    "Pacific/Funafuti",
+    "Pacific/Galapagos",
+    "Pacific/Gambier",
+    "Pacific/Guadalcanal",
+    "Pacific/Guam",
+    "Pacific/Honolulu",
+    "Pacific/Kiritimati",
+    "Pacific/Kosrae",
+    "Pacific/Kwajalein",
+    "Pacific/Majuro",
+    "Pacific/Marquesas",
+    "Pacific/Midway",
+    "Pacific/Nauru",
+    "Pacific/Niue",
+    "Pacific/Norfolk",
+    "Pacific/Noumea",
+    "Pacific/Pago_Pago",
+    "Pacific/Palau",
+    "Pacific/Pitcairn",
+    "Pacific/Ponape",
+    "Pacific/Port_Moresby",
+    "Pacific/Rarotonga",
+    "Pacific/Saipan",
+    "Pacific/Tahiti",
+    "Pacific/Tarawa",
+    "Pacific/Tongatapu",
+    "Pacific/Truk",
+    "Pacific/Wake",
+    "Pacific/Wallis",
+]);
+function parseOffsetMinutes(rawOffset) {
+    if (rawOffset === "GMT" || rawOffset === "UTC") {
+        return 0;
+    }
+    const match = rawOffset.match(/^(?:GMT|UTC)([+-])(\d{1,2})(?::?(\d{2}))?$/);
+    if (!match) {
+        return 0;
+    }
+    const sign = match[1] === "-" ? -1 : 1;
+    const hours = Number.parseInt(match[2] || "0", 10);
+    const minutes = Number.parseInt(match[3] || "0", 10);
+    return sign * (hours * 60 + minutes);
+}
+function getTimezoneOffsetMinutes(timezoneId, date = new Date()) {
+    try {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone: timezoneId,
+            timeZoneName: "shortOffset",
+            hour: "2-digit",
+            minute: "2-digit",
+            hourCycle: "h23",
+        }).formatToParts(date);
+        const offsetPart = parts.find((part) => part.type === "timeZoneName")?.value;
+        return offsetPart ? parseOffsetMinutes(offsetPart) : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function formatUtcOffset(offsetMinutes) {
+    const sign = offsetMinutes >= 0 ? "+" : "-";
+    const absoluteMinutes = Math.abs(offsetMinutes);
+    const hours = String(Math.floor(absoluteMinutes / 60)).padStart(2, "0");
+    const minutes = String(absoluteMinutes % 60).padStart(2, "0");
+    return `UTC${sign}${hours}:${minutes}`;
+}
+const IANA_TIMEZONE_OPTIONS = Object.freeze([...IANA_TIMEZONE_IDS]
+    .map((timezoneId) => {
+    const offsetMinutes = getTimezoneOffsetMinutes(timezoneId);
+    return {
+        value: timezoneId,
+        label: `${formatUtcOffset(offsetMinutes)} • ${timezoneId}`,
+        offsetMinutes,
+    };
+})
+    .sort((left, right) => left.offsetMinutes - right.offsetMinutes || left.value.localeCompare(right.value)));
+
+const GOOGLE_IDENTITY_SCOPES = [
+    'openid',
+    'https://www.googleapis.com/auth/userinfo.email',
+    'https://www.googleapis.com/auth/userinfo.profile',
+];
+const GOOGLE_CALENDAR_SCOPE = 'https://www.googleapis.com/auth/calendar';
+const GOOGLE_SHEETS_SCOPE = 'https://www.googleapis.com/auth/spreadsheets';
+const GOOGLE_GMAIL_READ_SCOPE = 'https://www.googleapis.com/auth/gmail.readonly';
+const GOOGLE_GMAIL_SEND_SCOPE = 'https://www.googleapis.com/auth/gmail.send';
+const GOOGLE_CALENDAR_OPERATION_OPTIONS = [
+    {
+        value: 'google_calendar_check_availability',
+        label: 'Check availability',
+        description: 'Check whether a calendar is free during a time window.',
+    },
+    {
+        value: 'google_calendar_list_upcoming_events',
+        label: 'List upcoming',
+        description: 'Read the next upcoming events from the calendar.',
+    },
+    {
+        value: 'google_calendar_create_event',
+        label: 'Create event',
+        description: 'Create a new calendar event.',
+    },
+    {
+        value: 'google_calendar_update_event',
+        label: 'Update event',
+        description: 'Modify an existing calendar event.',
+    },
+    {
+        value: 'google_calendar_cancel_event',
+        label: 'Cancel event',
+        description: 'Cancel or delete an existing calendar event.',
+    },
+];
+const GOOGLE_SHEETS_OPERATION_OPTIONS = [
+    {
+        value: 'google_sheets_append_row',
+        label: 'Append row',
+        description: 'Write a new row into a spreadsheet.',
+    },
+    {
+        value: 'google_sheets_list_sheets',
+        label: 'List sheets',
+        description: 'List worksheet tabs and spreadsheet metadata.',
+    },
+    {
+        value: 'google_sheets_read_rows',
+        label: 'Read rows',
+        description: 'Read rows from a worksheet range.',
+    },
+];
+const GOOGLE_GMAIL_OPERATION_OPTIONS = [
+    {
+        value: 'google_gmail_search_messages',
+        label: 'Search messages',
+        description: 'Search Gmail and return readable message summaries.',
+    },
+    {
+        value: 'google_gmail_get_message',
+        label: 'Get message',
+        description: 'Fetch a specific Gmail message by ID.',
+    },
+    {
+        value: 'google_gmail_send_email',
+        label: 'Send email',
+        description: 'Send an email from the connected Gmail account.',
+    },
+];
+const GOOGLE_MANAGED_OPERATION_OPTIONS = {
+    google_calendar: GOOGLE_CALENDAR_OPERATION_OPTIONS,
+    google_sheets: GOOGLE_SHEETS_OPERATION_OPTIONS,
+    google_gmail: GOOGLE_GMAIL_OPERATION_OPTIONS,
+};
+const GOOGLE_GMAIL_REQUIRED_SCOPES_BY_OPERATION = {
+    google_gmail_search_messages: [GOOGLE_GMAIL_READ_SCOPE],
+    google_gmail_get_message: [GOOGLE_GMAIL_READ_SCOPE],
+    google_gmail_send_email: [GOOGLE_GMAIL_SEND_SCOPE],
+};
+const GOOGLE_CALENDAR_REQUIRED_SCOPES_BY_OPERATION = {
+    google_calendar_check_availability: [GOOGLE_CALENDAR_SCOPE],
+    google_calendar_list_upcoming_events: [GOOGLE_CALENDAR_SCOPE],
+    google_calendar_create_event: [GOOGLE_CALENDAR_SCOPE],
+    google_calendar_update_event: [GOOGLE_CALENDAR_SCOPE],
+    google_calendar_cancel_event: [GOOGLE_CALENDAR_SCOPE],
+};
+const GOOGLE_SHEETS_REQUIRED_SCOPES_BY_OPERATION = {
+    google_sheets_append_row: [GOOGLE_SHEETS_SCOPE],
+    google_sheets_list_sheets: [GOOGLE_SHEETS_SCOPE],
+    google_sheets_read_rows: [GOOGLE_SHEETS_SCOPE],
+};
+function uniqueStrings(values) {
+    const orderedValues = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (typeof value !== 'string' || !value.trim() || seen.has(value)) {
+            continue;
+        }
+        seen.add(value);
+        orderedValues.push(value);
+    }
+    return orderedValues;
+}
+function getManagedToolSelectedOperations(selectedOperations, options) {
+    const orderedValues = options.map((option) => option.value);
+    if (!Array.isArray(selectedOperations)) {
+        return orderedValues;
+    }
+    const allowed = new Set(orderedValues);
+    const selected = new Set();
+    for (const operation of selectedOperations) {
+        if (typeof operation === 'string' && allowed.has(operation)) {
+            selected.add(operation);
+        }
+    }
+    return orderedValues.filter((operation) => selected.has(operation));
+}
+function toggleManagedToolOperation(selectedOperations, options, operation, checked) {
+    const nextSelected = new Set(getManagedToolSelectedOperations(selectedOperations, options));
+    if (checked) {
+        nextSelected.add(operation);
+    }
+    else {
+        nextSelected.delete(operation);
+    }
+    return options
+        .map((option) => option.value)
+        .filter((value) => nextSelected.has(value));
+}
+function getRequiredGoogleScopes(managedTools) {
+    const requiredScopes = [...GOOGLE_IDENTITY_SCOPES];
+    if (managedTools?.google_calendar?.enabled) {
+        for (const operation of getManagedToolSelectedOperations(managedTools.google_calendar.selected_operations, GOOGLE_CALENDAR_OPERATION_OPTIONS)) {
+            requiredScopes.push(...(GOOGLE_CALENDAR_REQUIRED_SCOPES_BY_OPERATION[operation] || []));
+        }
+    }
+    if (managedTools?.google_sheets?.enabled) {
+        for (const operation of getManagedToolSelectedOperations(managedTools.google_sheets.selected_operations, GOOGLE_SHEETS_OPERATION_OPTIONS)) {
+            requiredScopes.push(...(GOOGLE_SHEETS_REQUIRED_SCOPES_BY_OPERATION[operation] || []));
+        }
+    }
+    if (managedTools?.google_gmail?.enabled) {
+        for (const operation of getManagedToolSelectedOperations(managedTools.google_gmail.selected_operations, GOOGLE_GMAIL_OPERATION_OPTIONS)) {
+            requiredScopes.push(...(GOOGLE_GMAIL_REQUIRED_SCOPES_BY_OPERATION[operation] || []));
+        }
+    }
+    return uniqueStrings(requiredScopes);
+}
+function getMissingGoogleScopes(requiredScopes, grantedScopes) {
+    const grantedScopeSet = new Set(uniqueStrings(grantedScopes || []));
+    return uniqueStrings(requiredScopes || []).filter((scope) => !grantedScopeSet.has(scope));
+}
+function getMissingGoogleScopesForManagedTools(managedTools, grantedScopes) {
+    return getMissingGoogleScopes(getRequiredGoogleScopes(managedTools), grantedScopes);
+}
+function isGoogleReconnectRequired(managedTools, grantedScopes, connected) {
+    return connected && getMissingGoogleScopesForManagedTools(managedTools, grantedScopes).length > 0;
+}
+function getGoogleReconnectState(managedTools, status) {
+    const required_scopes = getRequiredGoogleScopes(managedTools);
+    const granted_scopes = status?.granted_scopes || [];
+    const missing_scopes = getMissingGoogleScopes(required_scopes, granted_scopes);
+    return {
+        required_scopes,
+        missing_scopes,
+        reconnect_required: (Boolean(status?.connected) && missing_scopes.length > 0) ||
+            Boolean(status?.reconnect_required),
+    };
+}
+function hasEnabledGoogleManagedTools(managedTools) {
+    return Boolean(managedTools?.google_calendar?.enabled ||
+        managedTools?.google_sheets?.enabled ||
+        managedTools?.google_gmail?.enabled);
+}
+
 /**
  * VoiceAgentWidget - UI widget for Voice.ai
  *
@@ -28905,33 +29628,39 @@ class VoiceAI {
     /** 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.');
+            throw new VoiceAIError('API key required for agents API, or pass authToken/getAuthToken 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.');
+            throw new VoiceAIError('API key required for analytics API, or pass authToken/getAuthToken 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.');
+            throw new VoiceAIError('API key required for knowledgeBase API, or pass authToken/getAuthToken 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.');
+            throw new VoiceAIError('API key required for phoneNumbers API, or pass authToken/getAuthToken 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.');
+            throw new VoiceAIError('API key required for tts API, or pass authToken/getAuthToken in the constructor.');
         return this._tts;
     }
+    /** Managed tools - provider-specific OAuth/status/disconnect helpers. */
+    get managedTools() {
+        if (!this._managedTools)
+            throw new VoiceAIError('API key required for managedTools API, or pass authToken/getAuthToken in the constructor.');
+        return this._managedTools;
+    }
     /**
      * Create a new VoiceAI client
      *
@@ -28957,15 +29686,23 @@ class VoiceAI {
         this.agentParticipantId = null;
         this.audioLevelInterval = null;
         this.apiKey = config.apiKey || '';
+        this.authToken = config.authToken;
+        this.getAuthToken = config.getAuthToken;
         this.apiUrl = config.apiUrl || DEFAULT_API_URL;
-        // Initialize API clients when apiKey is provided
-        if (this.apiKey) {
-            const clientConfig = { apiKey: this.apiKey, apiUrl: this.apiUrl };
+        // Initialize API clients when auth is provided
+        if (this.apiKey || this.authToken || this.getAuthToken) {
+            const clientConfig = {
+                apiKey: this.apiKey,
+                authToken: this.authToken,
+                getAuthToken: this.getAuthToken,
+                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);
+            this._managedTools = new ManagedToolsClient(clientConfig);
         }
     }
     // ==========================================================================
@@ -29311,11 +30048,11 @@ class VoiceAI {
         if (this.cachedConnectionDetails && !this.isTokenExpired(this.cachedConnectionDetails.participantToken)) {
             return this.cachedConnectionDetails;
         }
-        // Mode 2: Direct API call with API key (constructor or per-call)
-        if (!this.apiKey && !options.apiKey) {
+        // Mode 2: Direct API call with API key or bearer auth (constructor or per-call)
+        if (!(await this.resolveAuthToken(options))) {
             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_..." })');
+                '2. API key or auth token: new VoiceAI({ apiKey: "vk_..." }) / new VoiceAI({ authToken: "..." })');
         }
         const connectionDetails = await this.fetchConnectionDetails(options);
         this.cachedConnectionDetails = connectionDetails;
@@ -29330,11 +30067,28 @@ class VoiceAI {
      * 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.');
+        if (!(await this.resolveAuthToken(options))) {
+            throw new Error('API key is required for getConnectionDetails(), or pass authToken/getAuthToken to the constructor.');
         }
         return this.fetchConnectionDetailsFromApi(options);
     }
+    async resolveAuthToken(options = {}) {
+        if (options.apiKey)
+            return options.apiKey;
+        if (options.authToken)
+            return options.authToken;
+        if (this.apiKey)
+            return this.apiKey;
+        if (this.authToken)
+            return this.authToken;
+        if (this.getAuthToken) {
+            const resolvedToken = await this.getAuthToken();
+            if (typeof resolvedToken === 'string' && resolvedToken.trim()) {
+                return resolvedToken;
+            }
+        }
+        return '';
+    }
     async fetchConnectionDetailsFromApi(options) {
         const url = options.apiUrl || this.apiUrl;
         // Use test-connection-details for testMode (allows testing paused/undeployed agents)
@@ -29351,13 +30105,13 @@ class VoiceAI {
         if (options.dynamicVariables) {
             requestData.dynamic_variables = options.dynamicVariables;
         }
-        const apiKey = options.apiKey || this.apiKey;
-        this.effectiveApiKey = apiKey;
+        const authToken = await this.resolveAuthToken(options);
+        this.effectiveApiKey = authToken;
         const response = await fetch(endpoint, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
-                'Authorization': `Bearer ${apiKey}`
+                'Authorization': `Bearer ${authToken}`
             },
             body: JSON.stringify(requestData)
         });
@@ -29631,9 +30385,27 @@ function generateOptimalAudioOptions(options) {
     return { ...optimalOptions, ...options };
 }
 
+exports.GOOGLE_CALENDAR_OPERATION_OPTIONS = GOOGLE_CALENDAR_OPERATION_OPTIONS;
+exports.GOOGLE_CALENDAR_SCOPE = GOOGLE_CALENDAR_SCOPE;
+exports.GOOGLE_GMAIL_OPERATION_OPTIONS = GOOGLE_GMAIL_OPERATION_OPTIONS;
+exports.GOOGLE_GMAIL_READ_SCOPE = GOOGLE_GMAIL_READ_SCOPE;
+exports.GOOGLE_GMAIL_SEND_SCOPE = GOOGLE_GMAIL_SEND_SCOPE;
+exports.GOOGLE_IDENTITY_SCOPES = GOOGLE_IDENTITY_SCOPES;
+exports.GOOGLE_MANAGED_OPERATION_OPTIONS = GOOGLE_MANAGED_OPERATION_OPTIONS;
+exports.GOOGLE_SHEETS_OPERATION_OPTIONS = GOOGLE_SHEETS_OPERATION_OPTIONS;
+exports.GOOGLE_SHEETS_SCOPE = GOOGLE_SHEETS_SCOPE;
+exports.IANA_TIMEZONE_OPTIONS = IANA_TIMEZONE_OPTIONS;
 exports.VoiceAI = VoiceAI;
 exports.VoiceAIError = VoiceAIError;
 exports.VoiceAgentWidget = VoiceAgentWidget;
 exports.default = VoiceAI;
 exports.generateOptimalAudioOptions = generateOptimalAudioOptions;
+exports.getGoogleReconnectState = getGoogleReconnectState;
+exports.getManagedToolSelectedOperations = getManagedToolSelectedOperations;
+exports.getMissingGoogleScopes = getMissingGoogleScopes;
+exports.getMissingGoogleScopesForManagedTools = getMissingGoogleScopesForManagedTools;
+exports.getRequiredGoogleScopes = getRequiredGoogleScopes;
+exports.hasEnabledGoogleManagedTools = hasEnabledGoogleManagedTools;
+exports.isGoogleReconnectRequired = isGoogleReconnectRequired;
+exports.toggleManagedToolOperation = toggleManagedToolOperation;
 //# sourceMappingURL=index.js.map