@webex/internal-plugin-voicea 3.12.0-auth-prejoin-fetch.1 → 3.12.0-llmrefactor.10

package/dist/voicea.js

@@ -12,6 +12,7 @@ _Object$defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = exports.VoiceaChannel = void 0;
+var _promise = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/promise"));
 var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/asyncToGenerator"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
@@ -20,6 +21,7 @@ var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
 var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
+var _events = _interopRequireDefault(require("events"));
 var _uuid = _interopRequireDefault(require("uuid"));
 var _webexCore = require("@webex/webex-core");
 var _constants = require("./constants");
@@ -27,25 +29,28 @@ var _utils = require("./utils");
 function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return _Object$getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? _Reflect$construct(o, e || [], (0, _getPrototypeOf2.default)(t).constructor) : o.apply(t, e)); }
-function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); } // eslint-disable-next-line no-unused-vars
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); } // @ts-ignore - webex-core types
+// @ts-ignore - internal-plugin-llm types
 /**
- * @description VoiceaChannel to hold single instance of LLM
+ * @description VoiceaChannel — handles voicea/transcription functionality for a single LLM connection.
+ * Created via `webex.internal.voicea.createChannel(llmChannel)`. The caller owns the
+ * channel and is responsible for its lifecycle.
  * @export
  * @class VoiceaChannel
  */
-var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin) {
+var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_EventEmitter) {
   /**
-   * Initializes Voicea plugin
-   * @param {any} args
+   * Creates a VoiceaChannel, optionally bound to an LLMChannel.
+   * If no llmChannel is provided, call switchLLMChannel() later to attach one.
+   * @param {LLMChannel} [llmChannel] - The LLM channel to use (optional)
+   * @param {Function} request - The request function for making API calls (typically webex.request bound to webex)
    */
-  function VoiceaChannel() {
+  function VoiceaChannel(llmChannel, request) {
     var _this;
     (0, _classCallCheck2.default)(this, VoiceaChannel);
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
-    }
-    _this = _callSuper(this, VoiceaChannel, [].concat(args));
-    (0, _defineProperty2.default)(_this, "namespace", _constants.VOICEA);
+    _this = _callSuper(this, VoiceaChannel);
+    (0, _defineProperty2.default)(_this, "request", void 0);
+    (0, _defineProperty2.default)(_this, "llmChannel", void 0);
     (0, _defineProperty2.default)(_this, "seqNum", void 0);
     (0, _defineProperty2.default)(_this, "areCaptionsEnabled", void 0);
     (0, _defineProperty2.default)(_this, "hasSubscribedToEvents", false);
@@ -57,9 +62,16 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     (0, _defineProperty2.default)(_this, "currentSpokenLanguage", void 0);
     (0, _defineProperty2.default)(_this, "spokenLanguages", []);
     (0, _defineProperty2.default)(_this, "currentCaptionLanguage", void 0);
+    // Target channel for reconciler pattern - the channel voicea WANTS to be bound to
+    (0, _defineProperty2.default)(_this, "targetLLMChannel", void 0);
+    // Single pending 'online' listener for deferred reconciliation
+    (0, _defineProperty2.default)(_this, "_pendingOnlineListener", void 0);
+    // Tracks whether caption restoration is pending (set on switch, cleared on restore)
+    (0, _defineProperty2.default)(_this, "_pendingCaptionRestore", false);
     /**
-     * @param {Object} e
-     * @returns {undefined}
+     * Process events from LLM channel
+     * @param {Object} e - Event data
+     * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "eventProcessor", function (e) {
       var _e$headers;
@@ -76,6 +88,9 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         case _constants.AIBRIDGE_RELAY_TYPES.VOICEA.TRANSCRIPTION:
           _this.processTranscription(e.data.voiceaPayload);
           break;
+        case _constants.AIBRIDGE_RELAY_TYPES.VOICEA.SPEAKER_NAME_UPDATE:
+          _this.processSpeakerNameUpdate(e.data.voiceaPayload);
+          break;
         case _constants.AIBRIDGE_RELAY_TYPES.MANUAL.TRANSCRIPTION:
         case _constants.AIBRIDGE_RELAY_TYPES.MANUAL.CAPTIONER:
           _this.processManualTranscription(_objectSpread(_objectSpread({}, e.data.transcriptPayload), {}, {
@@ -94,8 +109,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      */
     (0, _defineProperty2.default)(_this, "processManualTranscription", function (transcriptPayload) {
       if (transcriptPayload.type === _constants.TRANSCRIPTION_TYPE.MANUAL_CAPTION_FINAL_RESULT || transcriptPayload.type === _constants.TRANSCRIPTION_TYPE.MANUAL_CAPTION_INTERIM_RESULT) {
-        // @ts-ignore
-        _this.trigger(_constants.EVENT_TRIGGERS.NEW_MANUAL_CAPTION, {
+        _this.emit(_constants.EVENT_TRIGGERS.NEW_MANUAL_CAPTION, {
           isFinal: transcriptPayload.type === _constants.TRANSCRIPTION_TYPE.MANUAL_CAPTION_FINAL_RESULT,
           transcriptId: transcriptPayload.id,
           transcripts: transcriptPayload.transcripts,
@@ -104,54 +118,59 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         });
       }
     });
+    /**
+     * Process speaker name update and send alert
+     * @param {SpeakerNameUpdatePayload} voiceaPayload
+     * @returns {void}
+     */
+    (0, _defineProperty2.default)(_this, "processSpeakerNameUpdate", function (voiceaPayload) {
+      // @ts-ignore
+      _this.emit(_constants.EVENT_TRIGGERS.SPEAKER_NAME_UPDATED, voiceaPayload);
+    });
     /**
      * Process Transcript and send alert
      * @param {TranscriptionResponse} voiceaPayload
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "processTranscription", function (voiceaPayload) {
+      var _voiceaPayload$transc, _voiceaPayload$highli, _voiceaPayload$highli2, _voiceaPayload$highli3, _voiceaPayload$highli4, _voiceaPayload$highli5, _voiceaPayload$highli6, _voiceaPayload$highli7;
       switch (voiceaPayload.type) {
         case _constants.TRANSCRIPTION_TYPE.TRANSCRIPT_INTERIM_RESULTS:
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.NEW_CAPTION, {
+          _this.emit(_constants.EVENT_TRIGGERS.NEW_CAPTION, {
             isFinal: false,
             transcriptId: voiceaPayload.transcript_id,
             transcripts: voiceaPayload.transcripts
           });
           break;
         case _constants.TRANSCRIPTION_TYPE.TRANSCRIPT_FINAL_RESULT:
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.NEW_CAPTION, {
+          _this.emit(_constants.EVENT_TRIGGERS.NEW_CAPTION, {
             isFinal: true,
             transcriptId: voiceaPayload.transcript_id,
-            transcripts: voiceaPayload.transcripts.map(function (transcript) {
+            transcripts: (_voiceaPayload$transc = voiceaPayload.transcripts) === null || _voiceaPayload$transc === void 0 ? void 0 : _voiceaPayload$transc.map(function (transcript) {
               transcript.timestamp = (0, _utils.millisToMinutesAndSeconds)(transcript.end_millis);
               return transcript;
             })
           });
           break;
         case _constants.TRANSCRIPTION_TYPE.HIGHLIGHT_CREATED:
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.HIGHLIGHT_CREATED, {
-            csis: voiceaPayload.highlight.csis,
-            highlightId: voiceaPayload.highlight.highlight_id,
-            text: voiceaPayload.highlight.transcript,
-            highlightLabel: voiceaPayload.highlight.highlight_label,
-            highlightSource: voiceaPayload.highlight.highlight_source,
-            timestamp: (0, _utils.millisToMinutesAndSeconds)(voiceaPayload.highlight.end_millis)
+          _this.emit(_constants.EVENT_TRIGGERS.HIGHLIGHT_CREATED, {
+            csis: (_voiceaPayload$highli = voiceaPayload.highlight) === null || _voiceaPayload$highli === void 0 ? void 0 : _voiceaPayload$highli.csis,
+            highlightId: (_voiceaPayload$highli2 = voiceaPayload.highlight) === null || _voiceaPayload$highli2 === void 0 ? void 0 : _voiceaPayload$highli2.highlight_id,
+            text: (_voiceaPayload$highli3 = voiceaPayload.highlight) === null || _voiceaPayload$highli3 === void 0 ? void 0 : _voiceaPayload$highli3.transcript,
+            highlightLabel: (_voiceaPayload$highli4 = voiceaPayload.highlight) === null || _voiceaPayload$highli4 === void 0 ? void 0 : _voiceaPayload$highli4.highlight_label,
+            highlightSource: (_voiceaPayload$highli5 = voiceaPayload.highlight) === null || _voiceaPayload$highli5 === void 0 ? void 0 : _voiceaPayload$highli5.highlight_source,
+            timestamp: (0, _utils.millisToMinutesAndSeconds)((_voiceaPayload$highli6 = (_voiceaPayload$highli7 = voiceaPayload.highlight) === null || _voiceaPayload$highli7 === void 0 ? void 0 : _voiceaPayload$highli7.end_millis) !== null && _voiceaPayload$highli6 !== void 0 ? _voiceaPayload$highli6 : 0)
           });
           break;
         case _constants.TRANSCRIPTION_TYPE.EVA_THANKS:
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.EVA_COMMAND, {
+          _this.emit(_constants.EVENT_TRIGGERS.EVA_COMMAND, {
             isListening: false,
             text: voiceaPayload.command_response
           });
           break;
         case _constants.TRANSCRIPTION_TYPE.EVA_WAKE:
         case _constants.TRANSCRIPTION_TYPE.EVA_CANCEL:
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.EVA_COMMAND, {
+          _this.emit(_constants.EVENT_TRIGGERS.EVA_COMMAND, {
             isListening: voiceaPayload.type === _constants.TRANSCRIPTION_TYPE.EVA_WAKE
           });
           break;
@@ -159,8 +178,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
           {
             var isInSpokenLanguages = _this.spokenLanguages.includes(voiceaPayload.language);
             if (isInSpokenLanguages) {
-              // @ts-ignore
-              _this.trigger(_constants.EVENT_TRIGGERS.LANGUAGE_DETECTED, {
+              _this.emit(_constants.EVENT_TRIGGERS.LANGUAGE_DETECTED, {
                 languageCode: voiceaPayload.language
               });
             }
@@ -177,13 +195,11 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      */
     (0, _defineProperty2.default)(_this, "processCaptionLanguageResponse", function (voiceaPayload) {
       if (voiceaPayload.statusCode === 200) {
-        // @ts-ignore
-        _this.trigger(_constants.EVENT_TRIGGERS.CAPTION_LANGUAGE_UPDATE, {
+        _this.emit(_constants.EVENT_TRIGGERS.CAPTION_LANGUAGE_UPDATE, {
           statusCode: 200
         });
       } else {
-        // @ts-ignore
-        _this.trigger(_constants.EVENT_TRIGGERS.CAPTION_LANGUAGE_UPDATE, {
+        _this.emit(_constants.EVENT_TRIGGERS.CAPTION_LANGUAGE_UPDATE, {
           statusCode: voiceaPayload.errorCode,
           errorMessage: voiceaPayload.message
         });
@@ -203,50 +219,29 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         currentSpokenLanguage: _this.currentSpokenLanguage
       };
       _this.spokenLanguages = (_voiceaPayload$ASR$sp2 = voiceaPayload === null || voiceaPayload === void 0 ? void 0 : (_voiceaPayload$ASR2 = voiceaPayload.ASR) === null || _voiceaPayload$ASR2 === void 0 ? void 0 : _voiceaPayload$ASR2.spoken_languages) !== null && _voiceaPayload$ASR$sp2 !== void 0 ? _voiceaPayload$ASR$sp2 : [];
-      // @ts-ignore
-      _this.trigger(_constants.EVENT_TRIGGERS.VOICEA_ANNOUNCEMENT, voiceaLanguageOptions);
+      _this.emit(_constants.EVENT_TRIGGERS.VOICEA_ANNOUNCEMENT, voiceaLanguageOptions);
     });
     /**
-     * Indicates whether the default or practice-session LLM connection is active.
+     * Indicates whether the LLM channel is connected.
      * @returns {boolean}
      */
     (0, _defineProperty2.default)(_this, "isLLMConnected", function () {
-      return (
-        // @ts-ignore
-        _this.webex.internal.llm.isConnected() ||
-        // @ts-ignore
-        _this.webex.internal.llm.isConnected(_constants.LLM_PRACTICE_SESSION)
-      );
+      var _this$llmChannel$isCo, _this$llmChannel;
+      return (_this$llmChannel$isCo = (_this$llmChannel = _this.llmChannel) === null || _this$llmChannel === void 0 ? void 0 : _this$llmChannel.isConnected()) !== null && _this$llmChannel$isCo !== void 0 ? _this$llmChannel$isCo : false;
     });
     (0, _defineProperty2.default)(_this, "getKeepTranscriptionSubscribed", function () {
       return _this.keepTranscriptionSubscribed;
     });
-    /**
-     * Resolves the active LLM publish transport, preferring the practice-session
-     * connection only when that session is fully connected.
-     * @returns {Object}
-     */
-    (0, _defineProperty2.default)(_this, "getPublishTransport", function () {
-      // @ts-ignore
-      var llm = _this.webex.internal.llm;
-      var isPracticeSessionConnected = llm.isConnected(_constants.LLM_PRACTICE_SESSION);
-      return {
-        socket: isPracticeSessionConnected && llm.getSocket(_constants.LLM_PRACTICE_SESSION) || llm.socket,
-        binding: isPracticeSessionConnected && llm.getBinding(_constants.LLM_PRACTICE_SESSION) || llm.getBinding(),
-        datachannelUrl: isPracticeSessionConnected && llm.getDatachannelUrl(_constants.LLM_PRACTICE_SESSION) || llm.getDatachannelUrl()
-      };
-    });
     /**
      * Sends Announcement to add voicea to the meeting
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "sendAnnouncement", function () {
+      var llm = _this.requireLLMChannel();
       _this.announceStatus = _constants.ANNOUNCE_STATUS.JOINING;
-      _this.listenToEvents();
-      var _this$getPublishTrans = _this.getPublishTransport(),
-        socket = _this$getPublishTrans.socket,
-        binding = _this$getPublishTrans.binding;
-      socket.send({
+      var socket = llm.getSocket();
+      var binding = llm.getBinding();
+      var payload = {
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
         recipients: [{
@@ -264,7 +259,8 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
           relayType: _constants.AIBRIDGE_RELAY_TYPES.VOICEA.CLIENT_ANNOUNCEMENT
         },
         trackingId: "".concat(_webexCore.config.trackingIdPrefix, "_").concat(_uuid.default.v4().toString())
-      });
+      };
+      socket.send(payload);
       _this.seqNum += 1;
     });
     /**
@@ -274,26 +270,21 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @returns {Promise}
      */
     (0, _defineProperty2.default)(_this, "setSpokenLanguage", function (languageCode, languageAssignment) {
-      return (
-        // @ts-ignore
-        _this.request({
-          method: 'PUT',
-          // @ts-ignore
-          url: "".concat(_this.webex.internal.llm.getLocusUrl(), "/controls/"),
-          body: {
-            transcribe: _objectSpread({
-              spokenLanguage: languageCode
-            }, languageAssignment && {
-              languageAssignment: languageAssignment
-            })
-          }
-        }).then(function () {
-          // @ts-ignore
-          _this.trigger(_constants.EVENT_TRIGGERS.SPOKEN_LANGUAGE_UPDATE, {
-            languageCode: languageCode
-          });
-        })
-      );
+      return _this.request({
+        method: 'PUT',
+        url: "".concat(_this.requireLLMChannel().getLocusUrl(), "/controls/"),
+        body: {
+          transcribe: _objectSpread({
+            spokenLanguage: languageCode
+          }, languageAssignment && {
+            languageAssignment: languageAssignment
+          })
+        }
+      }).then(function () {
+        _this.emit(_constants.EVENT_TRIGGERS.SPOKEN_LANGUAGE_UPDATE, {
+          languageCode: languageCode
+        });
+      });
     });
     /**
      * Request Language translation
@@ -304,9 +295,9 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       if (!_this.isLLMConnected()) {
         return;
       }
-      var _this$getPublishTrans2 = _this.getPublishTransport(),
-        socket = _this$getPublishTrans2.socket,
-        binding = _this$getPublishTrans2.binding;
+      var llm = _this.requireLLMChannel();
+      var socket = llm.getSocket();
+      var binding = llm.getBinding();
       socket.send({
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
@@ -341,9 +332,9 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       if (!_this.isLLMConnected()) {
         return;
       }
-      var _this$getPublishTrans3 = _this.getPublishTransport(),
-        socket = _this$getPublishTrans3.socket,
-        binding = _this$getPublishTrans3.binding;
+      var llm = _this.requireLLMChannel();
+      var socket = llm.getSocket();
+      var binding = llm.getBinding();
       socket === null || socket === void 0 ? void 0 : socket.send({
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
@@ -372,39 +363,35 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     });
     /**
      * request turn on Captions
-     * @param {string} [languageCode] - Optional Parameter for spoken language code. Defaults to English
+     * @param {string} [languageCode] - Optional Parameter for spoken language code
      * @returns {Promise}
      */
     (0, _defineProperty2.default)(_this, "requestTurnOnCaptions", function (languageCode) {
       _this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.SENDING;
-
-      // only set the spoken language if it is provided
+      var locusUrl = _this.requireLLMChannel().getLocusUrl();
       var body = {
         transcribe: {
           caption: true
         },
         languageCode: languageCode
       };
-
-      // @ts-ignore
-      // eslint-disable-next-line newline-before-return
       return _this.request({
         method: 'PUT',
-        // @ts-ignore
-        url: "".concat(_this.webex.internal.llm.getLocusUrl(), "/controls/"),
+        url: "".concat(locusUrl, "/controls/"),
         body: body
       }).then(function () {
-        // @ts-ignore
-        _this.trigger(_constants.EVENT_TRIGGERS.CAPTIONS_TURNED_ON);
+        _this.emit(_constants.EVENT_TRIGGERS.CAPTIONS_TURNED_ON);
         _this.areCaptionsEnabled = true;
         _this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.ENABLED;
         _this.announce();
         _this.updateSubchannelSubscriptionsAndSyncCaptionState({
           subscribe: ['transcription']
         }, true);
-      }).catch(function () {
+      }).catch(function (error) {
         _this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
-        throw new Error('turn on captions fail');
+        throw new Error('turn on captions fail', {
+          cause: error
+        });
       });
     });
     /**
@@ -422,7 +409,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       return _this.announceStatus === _constants.ANNOUNCE_STATUS.JOINED;
     });
     /**
-     * announce to voicea data chanel
+     * announce to voicea data channel
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "announce", function () {
@@ -451,7 +438,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         return _regenerator.default.wrap(function (_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              if (!(_this.captionStatus === _constants.TURN_ON_CAPTION_STATUS.SENDING)) {
+              if (!_this.isCaptionProcessing()) {
                 _context.next = 1;
                 break;
               }
@@ -481,11 +468,9 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @returns {Promise}
      */
     (0, _defineProperty2.default)(_this, "toggleTranscribing", function (activate, spokenLanguage) {
-      // @ts-ignore
       return _this.request({
         method: 'PUT',
-        // @ts-ignore
-        url: "".concat(_this.webex.internal.llm.getLocusUrl(), "/controls/"),
+        url: "".concat(_this.requireLLMChannel().getLocusUrl(), "/controls/"),
         body: {
           transcribe: {
             transcribing: activate
@@ -507,12 +492,9 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     (0, _defineProperty2.default)(_this, "toggleManualCaption", function (enable) {
       if (_this.toggleManualCaptionStatus === _constants.TOGGLE_MANUAL_CAPTION_STATUS.SENDING) return undefined;
       _this.toggleManualCaptionStatus = _constants.TOGGLE_MANUAL_CAPTION_STATUS.SENDING;
-
-      // @ts-ignore
       return _this.request({
         method: 'PUT',
-        // @ts-ignore
-        url: "".concat(_this.webex.internal.llm.getLocusUrl(), "/controls/"),
+        url: "".concat(_this.requireLLMChannel().getLocusUrl(), "/controls/"),
         body: {
           manualCaption: {
             enable: enable
@@ -533,8 +515,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "onSpokenLanguageUpdate", function (languageCode, meetingId) {
-      // @ts-ignore
-      _this.trigger(_constants.EVENT_TRIGGERS.SPOKEN_LANGUAGE_UPDATE, {
+      _this.emit(_constants.EVENT_TRIGGERS.SPOKEN_LANGUAGE_UPDATE, {
         languageCode: languageCode,
         meetingId: meetingId
       });
@@ -551,7 +532,6 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       }
       if (_this.captionServiceId !== serviceId) {
         _this.captionServiceId = serviceId;
-        // if service id value has changed and the translation language has been set, client needs to resend the translator language message to the LLM.
         if (_this.currentCaptionLanguage) {
           _this.requestLanguage(_this.currentCaptionLanguage);
         }
@@ -574,9 +554,6 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     /**
      * update LLM sub‑channel subscriptions.
      *
-     * sends a single `subchannelSubscriptionRequest` to LLM,
-     * allowing subscribe and unsubscribe subchannel.
-     *
      * @param {string[]} options.subscribe   Sub‑channels to subscribe to.
      * @param {string[]} options.unsubscribe Sub‑channels to unsubscribe from.
      * @returns {Promise}
@@ -587,8 +564,8 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         subscribe,
         _ref3$unsubscribe,
         unsubscribe,
+        llm,
         isDataChannelTokenEnabled,
-        _this$getPublishTrans4,
         socket,
         datachannelUrl,
         _args2 = arguments;
@@ -596,22 +573,29 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             _ref3 = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {}, _ref3$subscribe = _ref3.subscribe, subscribe = _ref3$subscribe === void 0 ? [] : _ref3$subscribe, _ref3$unsubscribe = _ref3.unsubscribe, unsubscribe = _ref3$unsubscribe === void 0 ? [] : _ref3$unsubscribe;
-            _context2.next = 1;
-            return _this.webex.internal.llm.isDataChannelTokenEnabled();
+            if (_this.isLLMConnected()) {
+              _context2.next = 1;
+              break;
+            }
+            return _context2.abrupt("return");
           case 1:
+            llm = _this.requireLLMChannel();
+            _context2.next = 2;
+            return llm.isDataChannelTokenEnabled();
+          case 2:
             isDataChannelTokenEnabled = _context2.sent;
-            if (!(!_this.isLLMConnected() || !isDataChannelTokenEnabled)) {
-              _context2.next = 2;
+            if (isDataChannelTokenEnabled) {
+              _context2.next = 3;
               break;
             }
             return _context2.abrupt("return");
-          case 2:
-            _this$getPublishTrans4 = _this.getPublishTransport(), socket = _this$getPublishTrans4.socket, datachannelUrl = _this$getPublishTrans4.datachannelUrl; // @ts-ignore
+          case 3:
+            socket = llm.getSocket();
+            datachannelUrl = llm.getDatachannelUrl();
             socket.send({
               id: "".concat(_this.seqNum),
               type: 'subchannelSubscriptionRequest',
               data: {
-                // @ts-ignore
                 datachannelUri: datachannelUrl,
                 subscribe: subscribe,
                 unsubscribe: unsubscribe
@@ -619,7 +603,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
               trackingId: "".concat(_webexCore.config.trackingIdPrefix, "_").concat(_uuid.default.v4().toString())
             });
             _this.seqNum += 1;
-          case 3:
+          case 4:
           case "end":
             return _context2.stop();
         }
@@ -643,57 +627,174 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       _this.keepTranscriptionSubscribed = keepSubscribed;
       return _this.updateSubchannelSubscriptions(options);
     });
+    _this.llmChannel = llmChannel;
+    _this.request = request;
     _this.seqNum = 1;
     _this.areCaptionsEnabled = false;
-    _this.keepTranscriptionSubscribed = false;
     _this.captionServiceId = undefined;
     _this.announceStatus = _constants.ANNOUNCE_STATUS.IDLE;
     _this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
     _this.toggleManualCaptionStatus = _constants.TOGGLE_MANUAL_CAPTION_STATUS.IDLE;
     _this.currentSpokenLanguage = _constants.DEFAULT_SPOKEN_LANGUAGE;
     _this.currentCaptionLanguage = undefined;
+    _this.keepTranscriptionSubscribed = false;
+
+    // Subscribe to relay events from the LLM channel if provided
+    if (_this.llmChannel) {
+      _this.llmChannel.on('event:relay.event', _this.eventProcessor);
+      _this.hasSubscribedToEvents = true;
+    }
     return _this;
   }
-  (0, _inherits2.default)(VoiceaChannel, _WebexPlugin);
+
+  /**
+   * Returns the LLM channel, throwing if not available.
+   * @private
+   * @returns {LLMChannel}
+   * @throws {Error} If LLM channel is not available
+   */
+  (0, _inherits2.default)(VoiceaChannel, _EventEmitter);
   return (0, _createClass2.default)(VoiceaChannel, [{
-    key: "listenToEvents",
-    value:
-    /**
-     * Listen to websocket messages
-     * @returns {undefined}
-     */
-    function listenToEvents() {
-      if (!this.hasSubscribedToEvents) {
-        // @ts-ignore
-        this.webex.internal.llm.on('event:relay.event', this.eventProcessor);
-        // @ts-ignore
-        this.webex.internal.llm.on("event:relay.event:".concat(_constants.LLM_PRACTICE_SESSION), this.eventProcessor);
-        this.hasSubscribedToEvents = true;
+    key: "requireLLMChannel",
+    value: function requireLLMChannel() {
+      if (!this.llmChannel) {
+        throw new Error('VoiceaChannel: LLM channel not available');
       }
+      return this.llmChannel;
     }
-
+  }, {
+    key: "deregisterEvents",
+    value:
     /**
-     * Listen to websocket messages
+     * Deregister events and clean up
      * @returns {void}
      */
-  }, {
-    key: "deregisterEvents",
-    value: function deregisterEvents() {
+    function deregisterEvents() {
       this.areCaptionsEnabled = false;
       this.keepTranscriptionSubscribed = false;
       this.captionServiceId = undefined;
-      // @ts-ignore
-      this.webex.internal.llm.off('event:relay.event', this.eventProcessor);
-      // @ts-ignore
-      this.webex.internal.llm.off("event:relay.event:".concat(_constants.LLM_PRACTICE_SESSION), this.eventProcessor);
-      this.hasSubscribedToEvents = false;
+      this.targetLLMChannel = undefined;
+      this._pendingCaptionRestore = false;
+
+      // Remove any pending online listener
+      this.detachPendingOnline();
+      if (this.hasSubscribedToEvents) {
+        var _this$llmChannel2;
+        (_this$llmChannel2 = this.llmChannel) === null || _this$llmChannel2 === void 0 ? void 0 : _this$llmChannel2.off('event:relay.event', this.eventProcessor);
+        this.hasSubscribedToEvents = false;
+      }
       this.announceStatus = _constants.ANNOUNCE_STATUS.IDLE;
       this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
       this.toggleManualCaptionStatus = _constants.TOGGLE_MANUAL_CAPTION_STATUS.IDLE;
       this.currentSpokenLanguage = undefined;
       this.currentCaptionLanguage = undefined;
     }
+
+    /**
+     * Attach a pending 'online' listener to a channel for deferred reconciliation.
+     * Detaches any existing listener first.
+     * @param {LLMChannel} channel - The channel to attach to
+     * @param {Function} callback - The callback to run when 'online' fires
+     * @private
+     * @returns {void}
+     */
+  }, {
+    key: "attachPendingOnline",
+    value: function attachPendingOnline(channel, callback) {
+      this.detachPendingOnline();
+      this._pendingOnlineListener = callback;
+      channel.once('online', this._pendingOnlineListener);
+    }
+
+    /**
+     * Detach any pending 'online' listener.
+     * @private
+     * @returns {void}
+     */
+  }, {
+    key: "detachPendingOnline",
+    value: function detachPendingOnline() {
+      if (this._pendingOnlineListener && this.llmChannel) {
+        this.llmChannel.off('online', this._pendingOnlineListener);
+      }
+      this._pendingOnlineListener = undefined;
+    }
+
+    /**
+     * Reset announcement state for a new connection.
+     * @private
+     * @returns {void}
+     */
+  }, {
+    key: "resetAnnounceState",
+    value: function resetAnnounceState() {
+      this.announceStatus = _constants.ANNOUNCE_STATUS.IDLE;
+      this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
+      this.captionServiceId = undefined;
+      this.areCaptionsEnabled = false;
+    }
+
+    /**
+     * Reconcile voicea binding and caption state to match the desired target.
+     * This is idempotent - always re-reads targetLLMChannel and current state.
+     * A deferred 'online' callback that fires late self-corrects automatically.
+     * @private
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "reconcile",
+    value: function reconcile() {
+      var _this2 = this;
+      var target = this.targetLLMChannel;
+      if (!target) return _promise.default.resolve();
+
+      // 1. Rebind relay-event subscription if actual != desired
+      if (this.llmChannel !== target) {
+        if (this.hasSubscribedToEvents && this.llmChannel) {
+          this.llmChannel.off('event:relay.event', this.eventProcessor);
+        }
+        this.detachPendingOnline();
+        this.llmChannel = target;
+        this.llmChannel.on('event:relay.event', this.eventProcessor);
+        this.hasSubscribedToEvents = true;
+        this.resetAnnounceState();
+        // Mark caption restoration as pending if captions were subscribed
+        this._pendingCaptionRestore = this.keepTranscriptionSubscribed;
+      }
+
+      // 2. Restore captions if pending
+      if (!this._pendingCaptionRestore) return _promise.default.resolve();
+      if (this.isLLMConnected()) {
+        // Channel is connected, restore captions immediately
+        this._pendingCaptionRestore = false;
+        return this.turnOnCaptions(this.currentSpokenLanguage).then(function () {
+          return undefined;
+        }).catch(function () {
+          // Best-effort restoration
+        });
+      }
+      // Channel not yet connected - defer until 'online' then re-reconcile.
+      // If target changes meanwhile, reconcile() self-corrects.
+      this.attachPendingOnline(target, function () {
+        _this2.reconcile();
+      });
+      return _promise.default.resolve();
+    }
+
+    /**
+     * Switch to a different LLM channel while preserving caption state.
+     * Used when transitioning between main meeting and practice session.
+     * This is a thin intent-setter - actual binding happens in reconcile().
+     * @param {LLMChannel} newLLMChannel - The new LLM channel to switch to
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "switchLLMChannel",
+    value: function switchLLMChannel(newLLMChannel) {
+      this.targetLLMChannel = newLLMChannel;
+      return this.reconcile();
+    }
   }]);
-}(_webexCore.WebexPlugin);
+}(_events.default);
 var _default = exports.default = VoiceaChannel;
 //# sourceMappingURL=voicea.js.map