@webex/internal-plugin-voicea 3.11.0 → 3.12.0-llmrefactor.2

package/dist/voicea.js

@@ -20,6 +20,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,38 +28,42 @@ 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 bound to the given LLMChannel
+   * @param {LLMChannel} llmChannel - The LLM channel to use
+   * @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);
     (0, _defineProperty2.default)(_this, "captionServiceId", void 0);
     (0, _defineProperty2.default)(_this, "announceStatus", void 0);
     (0, _defineProperty2.default)(_this, "captionStatus", void 0);
+    (0, _defineProperty2.default)(_this, "keepTranscriptionSubscribed", void 0);
     (0, _defineProperty2.default)(_this, "toggleManualCaptionStatus", void 0);
     (0, _defineProperty2.default)(_this, "currentSpokenLanguage", void 0);
     (0, _defineProperty2.default)(_this, "spokenLanguages", []);
     (0, _defineProperty2.default)(_this, "currentCaptionLanguage", void 0);
     /**
-     * @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;
@@ -93,8 +98,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,
@@ -109,48 +113,44 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @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;
@@ -158,8 +158,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
               });
             }
@@ -176,13 +175,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
         });
@@ -202,8 +199,17 @@ 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 LLM channel is connected.
+     * @returns {boolean}
+     */
+    (0, _defineProperty2.default)(_this, "isLLMConnected", function () {
+      return _this.llmChannel.isConnected();
+    });
+    (0, _defineProperty2.default)(_this, "getKeepTranscriptionSubscribed", function () {
+      return _this.keepTranscriptionSubscribed;
     });
     /**
      * Sends Announcement to add voicea to the meeting
@@ -211,15 +217,14 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      */
     (0, _defineProperty2.default)(_this, "sendAnnouncement", function () {
       _this.announceStatus = _constants.ANNOUNCE_STATUS.JOINING;
-      _this.listenToEvents();
-      // @ts-ignore
-      _this.webex.internal.llm.socket.send({
+      var socket = _this.llmChannel.getSocket();
+      var binding = _this.llmChannel.getBinding();
+      var payload = {
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
-        recipients: {
-          // @ts-ignore
-          route: _this.webex.internal.llm.getBinding()
-        },
+        recipients: [{
+          route: binding
+        }],
         // If captionServiceId exists, send it as the 'to' header; otherwise keep headers empty.
         headers: _this.captionServiceId ? {
           to: _this.captionServiceId
@@ -232,7 +237,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;
     });
     /**
@@ -242,26 +248,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.llmChannel.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
@@ -269,16 +270,17 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "requestLanguage", function (languageCode) {
-      // @ts-ignore
-      if (!_this.webex.internal.llm.isConnected()) return;
-      // @ts-ignore
-      _this.webex.internal.llm.socket.send({
+      if (!_this.isLLMConnected()) {
+        return;
+      }
+      var socket = _this.llmChannel.getSocket();
+      var binding = _this.llmChannel.getBinding();
+      socket.send({
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
-        recipients: {
-          // @ts-ignore
-          route: _this.webex.internal.llm.getBinding()
-        },
+        recipients: [{
+          route: binding
+        }],
         headers: {
           to: _this.captionServiceId
         },
@@ -304,17 +306,17 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "sendManualClosedCaption", function (text, timeStamp, csis, isFinal) {
-      // @ts-ignore
-      if (!_this.webex.internal.llm.isConnected()) return;
-
-      // @ts-ignore
-      _this.webex.internal.llm.socket.send({
+      if (!_this.isLLMConnected()) {
+        return;
+      }
+      var socket = _this.llmChannel.getSocket();
+      var binding = _this.llmChannel.getBinding();
+      socket === null || socket === void 0 ? void 0 : socket.send({
         id: "".concat(_this.seqNum),
         type: 'publishRequest',
-        recipients: {
-          // @ts-ignore
-          route: _this.webex.internal.llm.getBinding()
-        },
+        recipients: [{
+          route: binding
+        }],
         headers: {},
         data: {
           eventType: 'relay.event',
@@ -337,34 +339,31 @@ 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.llmChannel.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();
-      }).catch(function () {
+        _this.updateSubchannelSubscriptionsAndSyncCaptionState({
+          subscribe: ['transcription']
+        }, true);
+      }).catch(function (error) {
         _this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
         throw new Error('turn on captions fail');
       });
@@ -377,13 +376,21 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
       return [_constants.ANNOUNCE_STATUS.JOINING, _constants.ANNOUNCE_STATUS.JOINED].includes(_this.announceStatus);
     });
     /**
-     * announce to voicea data chanel
+     * is announce processed
+     * @returns {boolean}
+     */
+    (0, _defineProperty2.default)(_this, "isAnnounceProcessed", function () {
+      return _this.announceStatus === _constants.ANNOUNCE_STATUS.JOINED;
+    });
+    /**
+     * announce to voicea data channel
      * @returns {void}
      */
     (0, _defineProperty2.default)(_this, "announce", function () {
-      if (_this.isAnnounceProcessing()) return;
-      // @ts-ignore
-      if (!_this.webex.internal.llm.isConnected()) {
+      if (_this.isAnnounceProcessed()) {
+        return;
+      }
+      if (!_this.isLLMConnected()) {
         throw new Error('voicea can not announce before llm connected');
       }
       _this.sendAnnouncement();
@@ -411,7 +418,7 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
               }
               return _context.abrupt("return", undefined);
             case 1:
-              if (_this.webex.internal.llm.isConnected()) {
+              if (_this.isLLMConnected()) {
                 _context.next = 2;
                 break;
               }
@@ -435,11 +442,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.llmChannel.getLocusUrl(), "/controls/"),
         body: {
           transcribe: {
             transcribing: activate
@@ -461,12 +466,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.llmChannel.getLocusUrl(), "/controls/"),
         body: {
           manualCaption: {
             enable: enable
@@ -487,8 +489,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
       });
@@ -505,7 +506,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);
         }
@@ -525,6 +525,82 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     (0, _defineProperty2.default)(_this, "getAnnounceStatus", function () {
       return _this.announceStatus;
     });
+    /**
+     * update LLM sub‑channel subscriptions.
+     *
+     * @param {string[]} options.subscribe   Sub‑channels to subscribe to.
+     * @param {string[]} options.unsubscribe Sub‑channels to unsubscribe from.
+     * @returns {Promise}
+     */
+    (0, _defineProperty2.default)(_this, "updateSubchannelSubscriptions", /*#__PURE__*/(0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
+      var _ref3,
+        _ref3$subscribe,
+        subscribe,
+        _ref3$unsubscribe,
+        unsubscribe,
+        isDataChannelTokenEnabled,
+        socket,
+        datachannelUrl,
+        _args2 = arguments;
+      return _regenerator.default.wrap(function (_context2) {
+        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;
+            if (_this.isLLMConnected()) {
+              _context2.next = 1;
+              break;
+            }
+            return _context2.abrupt("return");
+          case 1:
+            _context2.next = 2;
+            return _this.llmChannel.isDataChannelTokenEnabled();
+          case 2:
+            isDataChannelTokenEnabled = _context2.sent;
+            if (isDataChannelTokenEnabled) {
+              _context2.next = 3;
+              break;
+            }
+            return _context2.abrupt("return");
+          case 3:
+            socket = _this.llmChannel.getSocket();
+            datachannelUrl = _this.llmChannel.getDatachannelUrl();
+            socket.send({
+              id: "".concat(_this.seqNum),
+              type: 'subchannelSubscriptionRequest',
+              data: {
+                datachannelUri: datachannelUrl,
+                subscribe: subscribe,
+                unsubscribe: unsubscribe
+              },
+              trackingId: "".concat(_webexCore.config.trackingIdPrefix, "_").concat(_uuid.default.v4().toString())
+            });
+            _this.seqNum += 1;
+          case 4:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2);
+    })));
+    /**
+     * Updates transcription subchannel subscriptions and records whether the
+     * transcription subscription should be kept (and restored on reconnect).
+     *
+     * @param {Object} [options] - Subscription options.
+     * @param {string[]} [options.subscribe] - Subchannels to subscribe to.
+     * @param {string[]} [options.unsubscribe] - Subchannels to unsubscribe from.
+     * @param {boolean} [keepSubscribed=false] - Whether the transcription
+     * subscription should be kept and restored on reconnect.
+     *
+     * @returns {Promise<void>}
+     */
+    (0, _defineProperty2.default)(_this, "updateSubchannelSubscriptionsAndSyncCaptionState", function () {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var keepSubscribed = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+      _this.keepTranscriptionSubscribed = keepSubscribed;
+      return _this.updateSubchannelSubscriptions(options);
+    });
+    _this.llmChannel = llmChannel;
+    _this.request = request;
     _this.seqNum = 1;
     _this.areCaptionsEnabled = false;
     _this.captionServiceId = undefined;
@@ -533,43 +609,93 @@ var VoiceaChannel = exports.VoiceaChannel = /*#__PURE__*/function (_WebexPlugin)
     _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
+    _this.llmChannel.on('event:relay.event', _this.eventProcessor);
+    _this.hasSubscribedToEvents = true;
     return _this;
   }
-  (0, _inherits2.default)(VoiceaChannel, _WebexPlugin);
+  (0, _inherits2.default)(VoiceaChannel, _EventEmitter);
   return (0, _createClass2.default)(VoiceaChannel, [{
-    key: "listenToEvents",
+    key: "deregisterEvents",
     value:
     /**
-     * Listen to websocket messages
-     * @returns {undefined}
-     */
-    function listenToEvents() {
-      if (!this.hasSubscribedToEvents) {
-        // @ts-ignore
-        this.webex.internal.llm.on('event:relay.event', this.eventProcessor);
-        this.hasSubscribedToEvents = true;
-      }
-    }
-
-    /**
-     * 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);
-      this.hasSubscribedToEvents = false;
+      if (this.hasSubscribedToEvents) {
+        this.llmChannel.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;
     }
+
+    /**
+     * Switch to a different LLM channel while preserving caption state.
+     * Used when transitioning between main meeting and practice session.
+     * - Preserves keepTranscriptionSubscribed and spokenLanguage state
+     * - Unsubscribes from old channel, subscribes to new channel
+     * - Re-announces and re-enables captions if they were on
+     * @param {LLMChannel} newLLMChannel - The new LLM channel to switch to
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "switchLLMChannel",
+    value: (function () {
+      var _switchLLMChannel = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3(newLLMChannel) {
+        var captionsWereOn, spokenLanguage;
+        return _regenerator.default.wrap(function (_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              // Save current state
+              captionsWereOn = this.keepTranscriptionSubscribed;
+              spokenLanguage = this.currentSpokenLanguage; // Unsubscribe from old channel
+              if (this.hasSubscribedToEvents && this.llmChannel) {
+                this.llmChannel.off('event:relay.event', this.eventProcessor);
+                this.hasSubscribedToEvents = false;
+              }
+
+              // Switch to new channel
+              this.llmChannel = newLLMChannel;
+
+              // Subscribe to new channel
+              this.llmChannel.on('event:relay.event', this.eventProcessor);
+              this.hasSubscribedToEvents = true;
+
+              // Reset announcement state for new connection
+              this.announceStatus = _constants.ANNOUNCE_STATUS.IDLE;
+              this.captionStatus = _constants.TURN_ON_CAPTION_STATUS.IDLE;
+              this.captionServiceId = undefined;
+              this.areCaptionsEnabled = false;
+
+              // Re-announce and re-enable captions if they were on
+              if (!captionsWereOn) {
+                _context3.next = 1;
+                break;
+              }
+              _context3.next = 1;
+              return this.turnOnCaptions(spokenLanguage);
+            case 1:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function switchLLMChannel(_x2) {
+        return _switchLLMChannel.apply(this, arguments);
+      }
+      return switchLLMChannel;
+    }())
   }]);
-}(_webexCore.WebexPlugin);
+}(_events.default);
 var _default = exports.default = VoiceaChannel;
 //# sourceMappingURL=voicea.js.map