@webex/internal-plugin-llm 3.11.0 → 3.12.0-llmrefactor.1

package/README.md

@@ -23,22 +23,73 @@ npm install --save @webex/internal-plugin-llm
 
 ```js
 import '@webex/internal-plugin-llm';
-
 import WebexCore from '@webex/webex-core';
 
 const webex = new WebexCore();
-// locusUrl is got from meeting.locusInfo.url;
-// datachannelUrl is got from meeting.locusInfo.info.datachannelUrl;
-webex.internal.llm.registerAndConnect(locusUrl, datachannelUrl);
-
-// Checks if LLM is connected
-webex.internal.llm.isConnected();
-
-// Disconnect LLM connection
-webex.internal.llm.disconnectLLM();
 
-// Get Locus URL
-webex.internal.llm.getLocusUrl();
+// Create a new LLM channel (each meeting owns its own channel)
+const llmChannel = webex.internal.llm.createChannel();
+
+// locusUrl and datachannelUrl are from meeting.locusInfo
+const locusUrl = meeting.locusInfo.url;
+const datachannelUrl = meeting.locusInfo.info.datachannelUrl;
+
+// Optional: set up token refresh handler before connecting
+llmChannel.setRefreshHandler(async () => {
+  // Return shape must match plugin expectation
+  return {
+    body: {
+      datachannelToken: '<refreshed-jwt-token>',
+      datachannelTokenType: 'llm-default-session', // or 'llm-practice-session'
+    },
+  };
+});
+
+// Connect (with optional JWT token for data channel auth)
+const datachannelToken = '<jwt-token>';
+await llmChannel.registerAndConnect(locusUrl, datachannelUrl, datachannelToken);
+
+// Subscribe to events directly on the channel
+llmChannel.on('online', () => {
+  console.log('LLM connected');
+});
+
+llmChannel.on('event:relay.event', (envelope) => {
+  console.log('LLM event', envelope.data?.eventType);
+});
+
+// Channel status and metadata
+llmChannel.isConnected();
+llmChannel.isConnecting();
+llmChannel.getBinding();
+llmChannel.getLocusUrl();
+llmChannel.getDatachannelUrl();
+llmChannel.getSocket();
+
+// Token management
+llmChannel.setDatachannelToken(datachannelToken);
+llmChannel.getDatachannelToken();
+llmChannel.clearDatachannelToken();
+
+// Manually trigger token refresh (if needed by your flow)
+await llmChannel.refreshDataChannelToken();
+
+// Disconnect when done (owner is responsible for cleanup)
+await llmChannel.disconnect({code: 1000, reason: 'done'});
+
+// --- Plugin-level methods ---
+
+// Check if data channel token feature flag is enabled
+await webex.internal.llm.isDataChannelTokenEnabled();
+
+// Get all active channels (useful for diagnostics)
+webex.internal.llm.getAllChannels();
+
+// Find a channel by datachannel URL (used by interceptors)
+webex.internal.llm.getChannelByDatachannelUrl(datachannelUrl);
+
+// Disconnect all channels (useful for cleanup on logout)
+await webex.internal.llm.disconnectAllChannels({code: 1000, reason: 'shutdown'});
 ```
 
 ## Maintainers

package/dist/constants.js

@@ -4,7 +4,15 @@ var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/defi
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports.LLM = void 0;
+exports.SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM = exports.LLM_PRACTICE_SESSION = exports.LLM_DEFAULT_SESSION = exports.LLM = exports.DATA_CHNANEL_TYPE = exports.DATA_CHANNEL_WITH_JWT_TOKEN = exports.AWARE_DATA_CHANNEL = void 0;
 // eslint-disable-next-line import/prefer-default-export
 var LLM = exports.LLM = 'llm';
+var LLM_DEFAULT_SESSION = exports.LLM_DEFAULT_SESSION = 'llm-default-session';
+var LLM_PRACTICE_SESSION = exports.LLM_PRACTICE_SESSION = 'llm-practice-session';
+var DATA_CHANNEL_WITH_JWT_TOKEN = exports.DATA_CHANNEL_WITH_JWT_TOKEN = 'data-channel-with-jwt-token';
+var SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM = exports.SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM = 'subscriptionAwareSubchannels';
+var DATA_CHNANEL_TYPE = exports.DATA_CHNANEL_TYPE = {
+  TRANSCRIPTION: 'transcription'
+};
+var AWARE_DATA_CHANNEL = exports.AWARE_DATA_CHANNEL = [DATA_CHNANEL_TYPE.TRANSCRIPTION];
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["LLM","exports"],"sources":["constants.ts"],"sourcesContent":["// eslint-disable-next-line import/prefer-default-export\nexport const LLM = 'llm';\n"],"mappings":";;;;;;;AAAA;AACO,IAAMA,GAAG,GAAAC,OAAA,CAAAD,GAAA,GAAG,KAAK","ignoreList":[]}
+{"version":3,"names":["LLM","exports","LLM_DEFAULT_SESSION","LLM_PRACTICE_SESSION","DATA_CHANNEL_WITH_JWT_TOKEN","SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM","DATA_CHNANEL_TYPE","TRANSCRIPTION","AWARE_DATA_CHANNEL"],"sources":["constants.ts"],"sourcesContent":["// eslint-disable-next-line import/prefer-default-export\nexport const LLM = 'llm';\n\nexport const LLM_DEFAULT_SESSION = 'llm-default-session';\nexport const LLM_PRACTICE_SESSION = 'llm-practice-session';\n\nexport const DATA_CHANNEL_WITH_JWT_TOKEN = 'data-channel-with-jwt-token';\n\nexport const SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM = 'subscriptionAwareSubchannels';\n\nexport const DATA_CHNANEL_TYPE = {\n  TRANSCRIPTION: 'transcription',\n};\n\nexport const AWARE_DATA_CHANNEL = [DATA_CHNANEL_TYPE.TRANSCRIPTION];\n"],"mappings":";;;;;;;AAAA;AACO,IAAMA,GAAG,GAAAC,OAAA,CAAAD,GAAA,GAAG,KAAK;AAEjB,IAAME,mBAAmB,GAAAD,OAAA,CAAAC,mBAAA,GAAG,qBAAqB;AACjD,IAAMC,oBAAoB,GAAAF,OAAA,CAAAE,oBAAA,GAAG,sBAAsB;AAEnD,IAAMC,2BAA2B,GAAAH,OAAA,CAAAG,2BAAA,GAAG,6BAA6B;AAEjE,IAAMC,oCAAoC,GAAAJ,OAAA,CAAAI,oCAAA,GAAG,8BAA8B;AAE3E,IAAMC,iBAAiB,GAAAL,OAAA,CAAAK,iBAAA,GAAG;EAC/BC,aAAa,EAAE;AACjB,CAAC;AAEM,IAAMC,kBAAkB,GAAAP,OAAA,CAAAO,kBAAA,GAAG,CAACF,iBAAiB,CAACC,aAAa,CAAC","ignoreList":[]}

package/dist/index.js

@@ -4,19 +4,50 @@ var _typeof = require("@babel/runtime-corejs2/helpers/typeof");
 var _WeakMap = require("@babel/runtime-corejs2/core-js/weak-map");
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
 var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
+_Object$defineProperty(exports, "DataChannelTokenType", {
+  enumerable: true,
+  get: function get() {
+    return _llm.DataChannelTokenType;
+  }
+});
+_Object$defineProperty(exports, "LLMPlugin", {
+  enumerable: true,
+  get: function get() {
+    return _llmPlugin.default;
+  }
+});
+_Object$defineProperty(exports, "LLM_DEFAULT_SESSION", {
+  enumerable: true,
+  get: function get() {
+    return _constants.LLM_DEFAULT_SESSION;
+  }
+});
+_Object$defineProperty(exports, "LLM_PRACTICE_SESSION", {
+  enumerable: true,
+  get: function get() {
+    return _constants.LLM_PRACTICE_SESSION;
+  }
+});
 _Object$defineProperty(exports, "default", {
   enumerable: true,
   get: function get() {
-    return _llm.default;
+    return _llm2.default;
   }
 });
 var WebexCore = _interopRequireWildcard(require("@webex/webex-core"));
-var _llm = _interopRequireWildcard(require("./llm"));
+var _llmPlugin = _interopRequireWildcard(require("./llm-plugin"));
+var _llm = require("./llm.types");
+var _constants = require("./constants");
+var _llm2 = _interopRequireDefault(require("./llm"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
-WebexCore.registerInternalPlugin('llm', _llm.default, {
-  config: _llm.config
+WebexCore.registerInternalPlugin('llm', _llmPlugin.default, {
+  config: _llmPlugin.config,
+  onBeforeLogout: function onBeforeLogout() {
+    return this.disconnectAllChannels();
+  }
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["WebexCore","_interopRequireWildcard","require","_llm","e","t","_WeakMap","r","n","__esModule","o","i","f","__proto__","default","_typeof","has","get","set","_t","hasOwnProperty","call","_Object$defineProperty","_Object$getOwnPropertyDescriptor","registerInternalPlugin","LLMChannel","config"],"sources":["index.ts"],"sourcesContent":["import * as WebexCore from '@webex/webex-core';\nimport LLMChannel, {config} from './llm';\n\nWebexCore.registerInternalPlugin('llm', LLMChannel, {\n  config,\n});\n\nexport {default} from './llm';\n"],"mappings":";;;;;;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,IAAA,GAAAF,uBAAA,CAAAC,OAAA;AAAyC,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,QAAA,MAAAC,CAAA,OAAAD,QAAA,IAAAE,CAAA,OAAAF,QAAA,YAAAL,uBAAA,YAAAA,wBAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,gBAAAW,OAAA,CAAAX,CAAA,0BAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAM,GAAA,CAAAZ,CAAA,UAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,GAAAM,CAAA,CAAAQ,GAAA,CAAAd,CAAA,EAAAQ,CAAA,cAAAO,EAAA,IAAAf,CAAA,gBAAAe,EAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAjB,CAAA,EAAAe,EAAA,OAAAR,CAAA,IAAAD,CAAA,GAAAY,sBAAA,KAAAC,gCAAA,CAAAnB,CAAA,EAAAe,EAAA,OAAAR,CAAA,CAAAM,GAAA,IAAAN,CAAA,CAAAO,GAAA,IAAAR,CAAA,CAAAE,CAAA,EAAAO,EAAA,EAAAR,CAAA,IAAAC,CAAA,CAAAO,EAAA,IAAAf,CAAA,CAAAe,EAAA,WAAAP,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAEzCL,SAAS,CAACwB,sBAAsB,CAAC,KAAK,EAAEC,YAAU,EAAE;EAClDC,MAAM,EAANA;AACF,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["WebexCore","_interopRequireWildcard","require","_llmPlugin","_llm","_constants","_llm2","_interopRequireDefault","e","t","_WeakMap","r","n","__esModule","o","i","f","__proto__","default","_typeof","has","get","set","_t","hasOwnProperty","call","_Object$defineProperty","_Object$getOwnPropertyDescriptor","registerInternalPlugin","LLMPlugin","config","onBeforeLogout","disconnectAllChannels"],"sources":["index.ts"],"sourcesContent":["import * as WebexCore from '@webex/webex-core';\nimport LLMPlugin, {config} from './llm-plugin';\nimport {DataChannelTokenType} from './llm.types';\n\nexport type {RegisterAndConnectTiming} from './llm.types';\n\nWebexCore.registerInternalPlugin('llm', LLMPlugin, {\n  config,\n  onBeforeLogout() {\n    return this.disconnectAllChannels();\n  },\n});\n\nexport {DataChannelTokenType};\nexport {LLM_DEFAULT_SESSION, LLM_PRACTICE_SESSION} from './constants';\nexport {default} from './llm';\nexport {default as LLMPlugin} from './llm-plugin';\nexport type {ILLMChannel, ILLMPlugin} from './llm.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,UAAA,GAAAF,uBAAA,CAAAC,OAAA;AACA,IAAAE,IAAA,GAAAF,OAAA;AAYA,IAAAG,UAAA,GAAAH,OAAA;AACA,IAAAI,KAAA,GAAAC,sBAAA,CAAAL,OAAA;AAA8B,SAAAD,wBAAAO,CAAA,EAAAC,CAAA,6BAAAC,QAAA,MAAAC,CAAA,OAAAD,QAAA,IAAAE,CAAA,OAAAF,QAAA,YAAAT,uBAAA,YAAAA,wBAAAO,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,gBAAAW,OAAA,CAAAX,CAAA,0BAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAM,GAAA,CAAAZ,CAAA,UAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,GAAAM,CAAA,CAAAQ,GAAA,CAAAd,CAAA,EAAAQ,CAAA,cAAAO,EAAA,IAAAf,CAAA,gBAAAe,EAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAjB,CAAA,EAAAe,EAAA,OAAAR,CAAA,IAAAD,CAAA,GAAAY,sBAAA,KAAAC,gCAAA,CAAAnB,CAAA,EAAAe,EAAA,OAAAR,CAAA,CAAAM,GAAA,IAAAN,CAAA,CAAAO,GAAA,IAAAR,CAAA,CAAAE,CAAA,EAAAO,EAAA,EAAAR,CAAA,IAAAC,CAAA,CAAAO,EAAA,IAAAf,CAAA,CAAAe,EAAA,WAAAP,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAT9BT,SAAS,CAAC4B,sBAAsB,CAAC,KAAK,EAAEC,kBAAS,EAAE;EACjDC,MAAM,EAANA,iBAAM;EACNC,cAAc,WAAdA,cAAcA,CAAA,EAAG;IACf,OAAO,IAAI,CAACC,qBAAqB,CAAC,CAAC;EACrC;AACF,CAAC,CAAC","ignoreList":[]}

package/dist/llm-plugin.js

@@ -0,0 +1,199 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs2/helpers/typeof");
+var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
+var _Array$from2 = require("@babel/runtime-corejs2/core-js/array/from");
+var _Symbol = require("@babel/runtime-corejs2/core-js/symbol");
+var _Symbol$iterator = require("@babel/runtime-corejs2/core-js/symbol/iterator");
+var _Array$isArray = require("@babel/runtime-corejs2/core-js/array/is-array");
+var _WeakMap = require("@babel/runtime-corejs2/core-js/weak-map");
+var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs2/core-js/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LLMPlugin = void 0;
+_Object$defineProperty(exports, "config", {
+  enumerable: true,
+  get: function get() {
+    return _llm.config;
+  }
+});
+exports.default = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
+var _set = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/set"));
+var _from = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/array/from"));
+var _promise = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/promise"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/asyncToGenerator"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
+var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
+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 _webexCore = require("@webex/webex-core");
+var _llm = _interopRequireWildcard(require("./llm"));
+var _constants = require("./constants");
+function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof _Symbol && r[_Symbol$iterator] || r["@@iterator"]; if (!t) { if (_Array$isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? _Array$from2(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+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 require-jsdoc */
+/**
+ * LLMPlugin — registered as `webex.internal.llm`.
+ *
+ * Factory for creating LLMChannel instances. Each Meeting creates and owns
+ * its own LLMChannel(s), allowing multiple independent connections without
+ * the need for session IDs or ownership tracking.
+ *
+ * This is a breaking API change from the previous design where the plugin
+ * maintained a Map of sessions and exposed session-keyed methods.
+ *
+ * Old usage (no longer supported):
+ *   webex.internal.llm.isConnected()
+ *   webex.internal.llm.registerAndConnect(url, dcUrl, token, sessionId)
+ *
+ * New usage:
+ *   const llm = webex.internal.llm.createChannel();
+ *   await llm.registerAndConnect(url, dcUrl, token);
+ *   llm.isConnected();
+ *   // When done:
+ *   await llm.disconnect();
+ */
+var LLMPlugin = exports.LLMPlugin = /*#__PURE__*/function (_ref) {
+  function LLMPlugin() {
+    var _this;
+    (0, _classCallCheck2.default)(this, LLMPlugin);
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    _this = _callSuper(this, LLMPlugin, [].concat(args));
+    (0, _defineProperty2.default)(_this, "namespace", 'llm');
+    /**
+     * Registry of active LLM channels for interceptor lookup.
+     * Channels are registered when created and unregistered on disconnect.
+     */
+    (0, _defineProperty2.default)(_this, "channels", new _set.default());
+    return _this;
+  }
+  (0, _inherits2.default)(LLMPlugin, _ref);
+  return (0, _createClass2.default)(LLMPlugin, [{
+    key: "createChannel",
+    value:
+    /**
+     * Creates a new LLMChannel instance. The caller owns the channel and is
+     * responsible for connecting, disconnecting, and cleaning it up.
+     *
+     * @example
+     * const llm = webex.internal.llm.createChannel();
+     * llm.setRefreshHandler(() => meeting.refreshDataChannelToken());
+     * await llm.registerAndConnect(locusUrl, datachannelUrl, token);
+     *
+     * // Subscribe to events directly on the channel
+     * llm.on('event:relay.event', handler);
+     * llm.on('online', onlineHandler);
+     *
+     * // When done
+     * await llm.disconnect();
+     *
+     * @returns {LLMChannel} A new LLM channel instance
+     */
+    function createChannel() {
+      var _this2 = this;
+      // @ts-ignore — WebexPlugin children require {parent: this.webex}
+      var channel = new _llm.default({
+        parent: this.webex
+      });
+      this.channels.add(channel);
+      channel.on('disconnected', function () {
+        return _this2.channels.delete(channel);
+      });
+      return channel;
+    }
+
+    /**
+     * Returns true if the data channel token feature flag is enabled.
+     * This is a global check, not per-connection.
+     * @returns {Promise<boolean>}
+     */
+  }, {
+    key: "isDataChannelTokenEnabled",
+    value: function isDataChannelTokenEnabled() {
+      // @ts-ignore
+      return this.webex.internal.feature.getFeature('developer', _constants.DATA_CHANNEL_WITH_JWT_TOKEN);
+    }
+
+    /**
+     * Find a channel by its datachannel URL. Used by the interceptor to
+     * route token refresh requests to the correct channel.
+     * @param {string} url - The request URL to match
+     * @returns {LLMChannel | undefined}
+     */
+  }, {
+    key: "getChannelByDatachannelUrl",
+    value: function getChannelByDatachannelUrl(url) {
+      var _iterator = _createForOfIteratorHelper(this.channels),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var channel = _step.value;
+          var datachannelUrl = channel.getDatachannelUrl();
+          if (datachannelUrl && _llm.default.matchesDatachannelRequestUrl(url, datachannelUrl)) {
+            return channel;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      return undefined;
+    }
+
+    /**
+     * Get all active channels. Useful for diagnostics/debugging.
+     * @returns {Set<LLMChannel>}
+     */
+  }, {
+    key: "getAllChannels",
+    value: function getAllChannels() {
+      return new _set.default(this.channels);
+    }
+
+    /**
+     * Disconnect all active channels. Useful for cleanup on logout.
+     * @param {object} [options] - Disconnect options
+     * @param {number} [options.code] - WebSocket close code
+     * @param {string} [options.reason] - WebSocket close reason
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "disconnectAllChannels",
+    value: (function () {
+      var _disconnectAllChannels = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee(options) {
+        var promises;
+        return _regenerator.default.wrap(function (_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              promises = (0, _from.default)(this.channels).map(function (channel) {
+                return channel.disconnect(options);
+              });
+              _context.next = 1;
+              return _promise.default.all(promises);
+            case 1:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function disconnectAllChannels(_x) {
+        return _disconnectAllChannels.apply(this, arguments);
+      }
+      return disconnectAllChannels;
+    }())
+  }]);
+}(_webexCore.WebexPlugin);
+var _default = exports.default = LLMPlugin;
+//# sourceMappingURL=llm-plugin.js.map

package/dist/llm-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_webexCore","require","_llm","_interopRequireWildcard","_constants","e","t","_WeakMap","r","n","__esModule","o","i","f","__proto__","default","_typeof","has","get","set","_t","hasOwnProperty","call","_Object$defineProperty","_Object$getOwnPropertyDescriptor","_createForOfIteratorHelper","_Symbol","_Symbol$iterator","_Array$isArray","_unsupportedIterableToArray","length","_n","F","s","done","value","TypeError","a","u","next","return","_arrayLikeToArray","toString","slice","constructor","name","_Array$from2","test","Array","_callSuper","_getPrototypeOf2","_possibleConstructorReturn2","_isNativeReflectConstruct","_Reflect$construct","apply","Boolean","prototype","valueOf","LLMPlugin","exports","_ref","_this","_classCallCheck2","_len","arguments","args","_key","concat","_defineProperty2","_set","_inherits2","_createClass2","key","createChannel","_this2","channel","LLMChannel","parent","webex","channels","add","on","delete","isDataChannelTokenEnabled","internal","feature","getFeature","DATA_CHANNEL_WITH_JWT_TOKEN","getChannelByDatachannelUrl","url","_iterator","_step","datachannelUrl","getDatachannelUrl","matchesDatachannelRequestUrl","err","undefined","getAllChannels","_disconnectAllChannels","_asyncToGenerator2","_regenerator","mark","_callee","options","promises","wrap","_context","prev","_from","map","disconnect","_promise","all","stop","disconnectAllChannels","_x","WebexPlugin","_default"],"sources":["llm-plugin.ts"],"sourcesContent":["/* eslint-disable require-jsdoc */\nimport {WebexPlugin} from '@webex/webex-core';\nimport LLMChannel, {config} from './llm';\nimport {DATA_CHANNEL_WITH_JWT_TOKEN} from './constants';\n\n/**\n * LLMPlugin — registered as `webex.internal.llm`.\n *\n * Factory for creating LLMChannel instances. Each Meeting creates and owns\n * its own LLMChannel(s), allowing multiple independent connections without\n * the need for session IDs or ownership tracking.\n *\n * This is a breaking API change from the previous design where the plugin\n * maintained a Map of sessions and exposed session-keyed methods.\n *\n * Old usage (no longer supported):\n *   webex.internal.llm.isConnected()\n *   webex.internal.llm.registerAndConnect(url, dcUrl, token, sessionId)\n *\n * New usage:\n *   const llm = webex.internal.llm.createChannel();\n *   await llm.registerAndConnect(url, dcUrl, token);\n *   llm.isConnected();\n *   // When done:\n *   await llm.disconnect();\n */\nexport class LLMPlugin extends (WebexPlugin as any) {\n  namespace = 'llm';\n\n  /**\n   * Registry of active LLM channels for interceptor lookup.\n   * Channels are registered when created and unregistered on disconnect.\n   */\n  private channels = new Set<LLMChannel>();\n\n  /**\n   * Creates a new LLMChannel instance. The caller owns the channel and is\n   * responsible for connecting, disconnecting, and cleaning it up.\n   *\n   * @example\n   * const llm = webex.internal.llm.createChannel();\n   * llm.setRefreshHandler(() => meeting.refreshDataChannelToken());\n   * await llm.registerAndConnect(locusUrl, datachannelUrl, token);\n   *\n   * // Subscribe to events directly on the channel\n   * llm.on('event:relay.event', handler);\n   * llm.on('online', onlineHandler);\n   *\n   * // When done\n   * await llm.disconnect();\n   *\n   * @returns {LLMChannel} A new LLM channel instance\n   */\n  public createChannel(): LLMChannel {\n    // @ts-ignore — WebexPlugin children require {parent: this.webex}\n    const channel = new LLMChannel({parent: this.webex});\n\n    this.channels.add(channel);\n    channel.on('disconnected', () => this.channels.delete(channel));\n\n    return channel;\n  }\n\n  /**\n   * Returns true if the data channel token feature flag is enabled.\n   * This is a global check, not per-connection.\n   * @returns {Promise<boolean>}\n   */\n  public isDataChannelTokenEnabled(): Promise<boolean> {\n    // @ts-ignore\n    return this.webex.internal.feature.getFeature('developer', DATA_CHANNEL_WITH_JWT_TOKEN);\n  }\n\n  /**\n   * Find a channel by its datachannel URL. Used by the interceptor to\n   * route token refresh requests to the correct channel.\n   * @param {string} url - The request URL to match\n   * @returns {LLMChannel | undefined}\n   */\n  public getChannelByDatachannelUrl(url: string): LLMChannel | undefined {\n    for (const channel of this.channels) {\n      const datachannelUrl = channel.getDatachannelUrl();\n\n      if (datachannelUrl && LLMChannel.matchesDatachannelRequestUrl(url, datachannelUrl)) {\n        return channel;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get all active channels. Useful for diagnostics/debugging.\n   * @returns {Set<LLMChannel>}\n   */\n  public getAllChannels(): Set<LLMChannel> {\n    return new Set(this.channels);\n  }\n\n  /**\n   * Disconnect all active channels. Useful for cleanup on logout.\n   * @param {object} [options] - Disconnect options\n   * @param {number} [options.code] - WebSocket close code\n   * @param {string} [options.reason] - WebSocket close reason\n   * @returns {Promise<void>}\n   */\n  public async disconnectAllChannels(options?: {code: number; reason: string}): Promise<void> {\n    const promises = Array.from(this.channels).map((channel) => channel.disconnect(options));\n\n    await Promise.all(promises);\n  }\n}\n\nexport {config};\nexport default LLMPlugin;\n"],"mappings":"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","ignoreList":[]}