@webex/internal-plugin-llm 3.12.0-next.4 → 3.12.0-next.40

package/README.md

@@ -91,7 +91,7 @@ webex.internal.llm.setRefreshHandler(async () => {
       datachannelTokenType: 'llm-default-session',
     },
   };
-});
+}, 'llm-default-session');
 
 // Optional: manually trigger refresh (if needed by your flow)
 await webex.internal.llm.refreshDataChannelToken();
@@ -106,7 +106,7 @@ webex.internal.llm.getDatachannelUrl('session-a');
 webex.internal.llm.getAllConnections();
 
 // Disconnect one session
-await webex.internal.llm.disconnectLLM({code: 1000, reason: 'done'}, 'session-a');
+await webex.internal.llm.disconnectLLM({code: 1000, reason: 'done'}, 'session-a', 'meeting-id');
 
 // Disconnect all sessions
 await webex.internal.llm.disconnectAllLLM({code: 1000, reason: 'shutdown'});

package/dist/constants.js

@@ -4,10 +4,11 @@ var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/defi
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SUBSCRIPTION_AWARE_SUBCHANNELS_PARAM = exports.LLM_DEFAULT_SESSION = exports.LLM = exports.DATA_CHNANEL_TYPE = exports.DATA_CHANNEL_WITH_JWT_TOKEN = exports.AWARE_DATA_CHANNEL = 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 = {

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["LLM","exports","LLM_DEFAULT_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';\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;AAEjD,IAAMC,2BAA2B,GAAAF,OAAA,CAAAE,2BAAA,GAAG,6BAA6B;AAEjE,IAAMC,oCAAoC,GAAAH,OAAA,CAAAG,oCAAA,GAAG,8BAA8B;AAE3E,IAAMC,iBAAiB,GAAAJ,OAAA,CAAAI,iBAAA,GAAG;EAC/BC,aAAa,EAAE;AACjB,CAAC;AAEM,IAAMC,kBAAkB,GAAAN,OAAA,CAAAM,kBAAA,GAAG,CAACF,iBAAiB,CAACC,aAAa,CAAC","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

@@ -13,6 +13,18 @@ _Object$defineProperty(exports, "DataChannelTokenType", {
     return _llm2.DataChannelTokenType;
   }
 });
+_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() {
@@ -22,6 +34,7 @@ _Object$defineProperty(exports, "default", {
 var WebexCore = _interopRequireWildcard(require("@webex/webex-core"));
 var _llm = _interopRequireWildcard(require("./llm"));
 var _llm2 = require("./llm.types");
+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); }
 WebexCore.registerInternalPlugin('llm', _llm.default, {
   config: _llm.config

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["WebexCore","_interopRequireWildcard","require","_llm","_llm2","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';\nimport {DataChannelTokenType} from './llm.types';\n\nWebexCore.registerInternalPlugin('llm', LLMChannel, {\n  config,\n});\n\nexport {DataChannelTokenType};\nexport {default} from './llm';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,IAAA,GAAAF,uBAAA,CAAAC,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AAAiD,SAAAD,wBAAAI,CAAA,EAAAC,CAAA,6BAAAC,QAAA,MAAAC,CAAA,OAAAD,QAAA,IAAAE,CAAA,OAAAF,QAAA,YAAAN,uBAAA,YAAAA,wBAAAI,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;AAEjDN,SAAS,CAACyB,sBAAsB,CAAC,KAAK,EAAEC,YAAU,EAAE;EAClDC,MAAM,EAANA;AACF,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["WebexCore","_interopRequireWildcard","require","_llm","_llm2","_constants","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';\nimport {DataChannelTokenType} from './llm.types';\n\nexport type {RegisterAndConnectTiming} from './llm.types';\n\nWebexCore.registerInternalPlugin('llm', LLMChannel, {\n  config,\n});\n\nexport {DataChannelTokenType};\nexport {LLM_DEFAULT_SESSION, LLM_PRACTICE_SESSION} from './constants';\nexport {default} from './llm';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,IAAA,GAAAF,uBAAA,CAAAC,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AASA,IAAAG,UAAA,GAAAH,OAAA;AAAsE,SAAAD,wBAAAK,CAAA,EAAAC,CAAA,6BAAAC,QAAA,MAAAC,CAAA,OAAAD,QAAA,IAAAE,CAAA,OAAAF,QAAA,YAAAP,uBAAA,YAAAA,wBAAAK,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;AALtEP,SAAS,CAAC0B,sBAAsB,CAAC,KAAK,EAAEC,YAAU,EAAE;EAClDC,MAAM,EAANA;AACF,CAAC,CAAC","ignoreList":[]}

package/dist/llm.js

@@ -1,6 +1,10 @@
 "use strict";
 
 var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
+var _Array$from = 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 _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
 _Object$defineProperty(exports, "__esModule", {
@@ -9,6 +13,8 @@ _Object$defineProperty(exports, "__esModule", {
 exports.default = exports.config = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime-corejs2/regenerator"));
 var _map = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/map"));
+var _promise = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/promise"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/slicedToArray"));
 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"));
@@ -19,6 +25,9 @@ var _defineProperty3 = _interopRequireDefault(require("@babel/runtime-corejs2/he
 var _internalPluginMercury = _interopRequireDefault(require("@webex/internal-plugin-mercury"));
 var _constants = require("./constants");
 var _llm = require("./llm.types");
+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$from(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 consistent-return */ // eslint-disable-next-line no-unused-vars
 var config = exports.config = {
@@ -67,12 +76,14 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
     (0, _defineProperty3.default)(_this, "defaultSessionId", _constants.LLM_DEFAULT_SESSION);
     /**
      * Map to store connection-specific data for multiple LLM connections
+     * Key: sessionId
      * @private
      * @type {Map<string, {webSocketUrl?: string; binding?: string; locusUrl?: string; datachannelUrl?: string}>}
      */
     (0, _defineProperty3.default)(_this, "connections", new _map.default());
+    // Session-keyed token cache is intentionally decoupled from connection state.
+    // Disconnecting a socket session must not implicitly wipe token cache.
     (0, _defineProperty3.default)(_this, "datachannelTokens", (0, _defineProperty3.default)((0, _defineProperty3.default)({}, _llm.DataChannelTokenType.Default, undefined), _llm.DataChannelTokenType.PracticeSession, undefined));
-    (0, _defineProperty3.default)(_this, "refreshHandler", void 0);
     /**
      * Register to the websocket
      * @param {string} llmSocketUrl
@@ -132,8 +143,19 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
      */
     (0, _defineProperty3.default)(_this, "registerAndConnect", function (locusUrl, datachannelUrl, datachannelToken) {
       var sessionId = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : _constants.LLM_DEFAULT_SESSION;
+      var registerStart = performance.now();
+
+      // Pre-populate locusUrl and datachannelUrl before register() fires the
+      // HTTP POST, so that any token refresh triggered during registration can
+      // be routed via connections without falling back to a locusInfo URL scan.
+      if (locusUrl && datachannelUrl) {
+        var sessionData = _this.connections.get(sessionId) || {};
+        sessionData.locusUrl = locusUrl;
+        sessionData.datachannelUrl = datachannelUrl;
+        _this.connections.set(sessionId, sessionData);
+      }
       return _this.register(datachannelUrl, datachannelToken, sessionId).then(/*#__PURE__*/(0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2() {
-        var sessionData, isDataChannelTokenEnabled, connectUrl;
+        var clientLLMDatachannelResponseTime, sessionData, error, isDataChannelTokenEnabled, connectUrl, connectStart, clientLLMWebSocketConnectTime, _t;
         return _regenerator.default.wrap(function (_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -143,23 +165,55 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
               }
               return _context2.abrupt("return", undefined);
             case 1:
-              // Get or create connection data
+              clientLLMDatachannelResponseTime = Math.round(performance.now() - registerStart); // locusUrl and datachannelUrl were pre-populated before register(); here
+              // we only need to read the existing session data to get webSocketUrl/binding
+              // that register() filled in.
               sessionData = _this.connections.get(sessionId) || {};
-              sessionData.locusUrl = locusUrl;
-              sessionData.datachannelUrl = datachannelUrl;
-              sessionData.datachannelToken = datachannelToken;
-              _this.connections.set(sessionId, sessionData);
-              _context2.next = 2;
-              return _this.isDataChannelTokenEnabled();
+              if (sessionData.webSocketUrl) {
+                _context2.next = 2;
+                break;
+              }
+              // register() succeeded but the response carried no websocket URL. Attach the measured
+              // datachannel time so callers don't misreport a registration that completed as time 0.
+              error = new Error("LLM registration for ".concat(sessionId, " returned no websocket URL"));
+              error.timing = {
+                clientLLMDatachannelResponseTime: clientLLMDatachannelResponseTime
+              };
+              throw error;
             case 2:
+              _context2.next = 3;
+              return _this.isDataChannelTokenEnabled();
+            case 3:
               isDataChannelTokenEnabled = _context2.sent;
               connectUrl = isDataChannelTokenEnabled ? LLMChannel.buildUrlWithAwareSubchannels(sessionData.webSocketUrl, _constants.AWARE_DATA_CHANNEL) : sessionData.webSocketUrl;
-              return _context2.abrupt("return", _this.connect(connectUrl, sessionId));
-            case 3:
+              connectStart = performance.now();
+              _context2.prev = 4;
+              _context2.next = 5;
+              return _this.connect(connectUrl, sessionId);
+            case 5:
+              _context2.next = 7;
+              break;
+            case 6:
+              _context2.prev = 6;
+              _t = _context2["catch"](4);
+              // register() succeeded; only connect() failed. Attach the measured datachannel time so
+              // callers don't misreport a websocket failure as a registration that never completed.
+              // @ts-ignore
+              _t.timing = {
+                clientLLMDatachannelResponseTime: clientLLMDatachannelResponseTime
+              };
+              throw _t;
+            case 7:
+              clientLLMWebSocketConnectTime = Math.round(performance.now() - connectStart);
+              return _context2.abrupt("return", {
+                clientLLMDatachannelResponseTime: clientLLMDatachannelResponseTime,
+                clientLLMWebSocketConnectTime: clientLLMWebSocketConnectTime
+              });
+            case 8:
             case "end":
               return _context2.stop();
           }
-        }, _callee2);
+        }, _callee2, null, [[4, 6]]);
       })));
     });
     /**
@@ -202,36 +256,159 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
       var sessionData = _this.connections.get(sessionId);
       return sessionData === null || sessionData === void 0 ? void 0 : sessionData.datachannelUrl;
     });
+    /**
+     * Get WebSocket URL for the connection
+     * @param {string} sessionId - Connection identifier
+     * @returns {string | undefined} WebSocket URL
+     */
+    (0, _defineProperty3.default)(_this, "getWebSocketUrl", function () {
+      var sessionId = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _constants.LLM_DEFAULT_SESSION;
+      var sessionData = _this.connections.get(sessionId);
+      return sessionData === null || sessionData === void 0 ? void 0 : sessionData.webSocketUrl;
+    });
+    /**
+     * Set the owner meeting ID for a given LLM session. Used by the meetings
+     * plugin to tag which Meeting instance currently owns the (default) LLM
+     * connection so that other Meeting instances can avoid disconnecting or
+     * re-initializing a connection they do not own.
+     *
+     * Does NOT create a connections entry if one does not already exist — this
+     * method is a no-op when there is no active session data. Callers should
+     * invoke it after a successful `registerAndConnect` or during an explicit
+     * ownership handoff.
+     *
+     * @param {string | undefined} ownerMeetingId - Meeting ID (or undefined to clear)
+     * @param {string} sessionId - Connection identifier (defaults to default session)
+     * @returns {void}
+     */
+    (0, _defineProperty3.default)(_this, "setOwnerMeetingId", function (ownerMeetingId) {
+      var sessionId = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _constants.LLM_DEFAULT_SESSION;
+      var sessionData = _this.connections.get(sessionId);
+      if (!sessionData) {
+        return;
+      }
+      sessionData.ownerMeetingId = ownerMeetingId;
+      _this.connections.set(sessionId, sessionData);
+    });
+    /**
+     * Get the owner meeting ID currently associated with an LLM session.
+     * Returns undefined when no owner has been assigned (e.g. before the
+     * first successful `registerAndConnect`, or after `disconnectLLM`).
+     *
+     * @param {string} sessionId - Connection identifier (defaults to default session)
+     * @returns {string | undefined} ownerMeetingId
+     */
+    (0, _defineProperty3.default)(_this, "getOwnerMeetingId", function () {
+      var sessionId = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _constants.LLM_DEFAULT_SESSION;
+      var sessionData = _this.connections.get(sessionId);
+      return sessionData === null || sessionData === void 0 ? void 0 : sessionData.ownerMeetingId;
+    });
+    /**
+     * Resolve ownership information for an LLM session.
+     *
+     * Rules:
+     * - no current owner => caller may proceed
+     * - caller has no identity to assert => treat as owner
+     * - otherwise caller must match current owner
+     *
+     * @param {string | undefined} ownerMeetingId - Candidate owner to evaluate
+     * @param {string} sessionId - Connection identifier (defaults to default session)
+     * @returns {{currentOwner: (string|undefined), isOwner: boolean}}
+     */
+    (0, _defineProperty3.default)(_this, "resolveSessionOwnership", function (ownerMeetingId) {
+      var sessionId = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _constants.LLM_DEFAULT_SESSION;
+      var currentOwner = _this.getOwnerMeetingId(sessionId);
+      var isOwner = !currentOwner || !ownerMeetingId || currentOwner === ownerMeetingId;
+      return {
+        currentOwner: currentOwner,
+        isOwner: isOwner
+      };
+    });
     /**
      * Get data channel token for the connection
-     * @param {DataChannelTokenType} dataChannelTokenType
-     * @returns {string} data channel token
+     * @param {DataChannelTokenType|string} tokenKey
+     * @param {string | undefined} ownerMeetingId - Meeting id asserting read ownership
+     * @returns {string | undefined} data channel token
      */
-    (0, _defineProperty3.default)(_this, "getDatachannelToken", function () {
-      var dataChannelTokenType = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _llm.DataChannelTokenType.Default;
-      return _this.datachannelTokens[dataChannelTokenType];
+    (0, _defineProperty3.default)(_this, "getDatachannelToken", function (tokenKey, ownerMeetingId) {
+      var resolvedTokenKey = tokenKey !== null && tokenKey !== void 0 ? tokenKey : _llm.DataChannelTokenType.Default;
+      var _this$resolveSessionO = _this.resolveSessionOwnership(ownerMeetingId, resolvedTokenKey),
+        currentOwner = _this$resolveSessionO.currentOwner,
+        isOwner = _this$resolveSessionO.isOwner;
+      if (!isOwner) {
+        _this.logger.info("llm#getDatachannelToken --> skip read for session ".concat(resolvedTokenKey, "; owned by ").concat(currentOwner, ", candidate ").concat(ownerMeetingId));
+        return undefined;
+      }
+      return _this.datachannelTokens[resolvedTokenKey];
     });
     /**
      * Set data channel token for the connection
      * @param {string} datachannelToken - data channel token
-     * @param {DataChannelTokenType} dataChannelTokenType
+     * @param {DataChannelTokenType|string} [tokenKey]
+     * @param {string | undefined} ownerMeetingId - Meeting id asserting write ownership
+     * @returns {void}
+     */
+    (0, _defineProperty3.default)(_this, "setDatachannelToken", function (datachannelToken, tokenKey, ownerMeetingId) {
+      var resolvedTokenKey = tokenKey !== null && tokenKey !== void 0 ? tokenKey : _llm.DataChannelTokenType.Default;
+      var _this$resolveSessionO2 = _this.resolveSessionOwnership(ownerMeetingId, resolvedTokenKey),
+        currentOwner = _this$resolveSessionO2.currentOwner,
+        isOwner = _this$resolveSessionO2.isOwner;
+      if (!isOwner) {
+        _this.logger.info("llm#setDatachannelToken --> skip write for session ".concat(resolvedTokenKey, "; owned by ").concat(currentOwner, ", candidate ").concat(ownerMeetingId));
+        return;
+      }
+      _this.datachannelTokens[resolvedTokenKey] = datachannelToken;
+    });
+    /**
+     * Clears a single session's data channel token.
+     * @param {DataChannelTokenType|string} tokenKey
+     * @param {string} ownerMeetingId - Meeting id asserting delete ownership
      * @returns {void}
      */
-    (0, _defineProperty3.default)(_this, "setDatachannelToken", function (datachannelToken) {
-      var dataChannelTokenType = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _llm.DataChannelTokenType.Default;
-      _this.datachannelTokens[dataChannelTokenType] = datachannelToken;
+    (0, _defineProperty3.default)(_this, "clearDatachannelToken", function (tokenKey, ownerMeetingId) {
+      var resolvedTokenKey = tokenKey;
+      var _this$resolveSessionO3 = _this.resolveSessionOwnership(ownerMeetingId, resolvedTokenKey),
+        currentOwner = _this$resolveSessionO3.currentOwner,
+        isOwner = _this$resolveSessionO3.isOwner;
+      if (!isOwner) {
+        _this.logger.info("llm#clearDatachannelToken --> skip clear for session ".concat(resolvedTokenKey, "; owned by ").concat(currentOwner, ", candidate ").concat(ownerMeetingId));
+        return;
+      }
+      _this.datachannelTokens[resolvedTokenKey] = undefined;
+      delete _this.datachannelTokens[resolvedTokenKey];
     });
     /**
      * Disconnects websocket connection
      * @param {{code: number, reason: string}} options - The disconnect option object with code and reason
      * @param {string} sessionId - Connection identifier
-     * @returns {Promise<void>}
+     * @param {string} ownerMeetingId - Meeting id asserting disconnect ownership
+     * @returns {Promise<boolean>} True when disconnect was performed, false when skipped
      */
-    (0, _defineProperty3.default)(_this, "disconnectLLM", function (options) {
-      var sessionId = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _constants.LLM_DEFAULT_SESSION;
-      return _this.disconnect(options, sessionId).then(function () {
+    (0, _defineProperty3.default)(_this, "disconnectLLM", function (options, sessionId, ownerMeetingId) {
+      var resolvedSessionId = sessionId !== null && sessionId !== void 0 ? sessionId : _constants.LLM_DEFAULT_SESSION;
+
+      // Backward-compat path: historically callers could omit ownerMeetingId
+      // (and sometimes sessionId). Reuse current owner when available so legacy
+      // calls remain best-effort without throwing at teardown time.
+      var resolvedOwnerMeetingId = ownerMeetingId || _this.getOwnerMeetingId(resolvedSessionId);
+      if (!ownerMeetingId) {
+        _this.logger.warn("llm#disconnectLLM --> ownerMeetingId is omitted for session ".concat(resolvedSessionId, "; using legacy compatibility path"));
+      }
+      var _this$resolveSessionO4 = _this.resolveSessionOwnership(resolvedOwnerMeetingId, resolvedSessionId),
+        currentOwner = _this$resolveSessionO4.currentOwner,
+        isOwner = _this$resolveSessionO4.isOwner;
+      if (!isOwner) {
+        _this.logger.info("llm#disconnectLLM --> skip disconnect for session ".concat(resolvedSessionId, "; owned by ").concat(currentOwner, ", candidate ").concat(resolvedOwnerMeetingId));
+        return _promise.default.resolve(false);
+      }
+      return _this.disconnect(options, resolvedSessionId).then(function () {
+        // Clear owner tag before cleanup to ensure it's not lingering
+        // if another meeting claimed it during disconnect
+        _this.setOwnerMeetingId(undefined, resolvedSessionId);
+
         // Clean up sessions data
-        _this.connections.delete(sessionId);
+        _this.connections.delete(resolvedSessionId);
+        return true;
       });
     });
     /**
@@ -256,60 +433,83 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
   }
   (0, _inherits2.default)(LLMChannel, _ref);
   return (0, _createClass2.default)(LLMChannel, [{
-    key: "resetDatachannelTokens",
+    key: "setRefreshHandler",
     value:
-    /**
-     * Resets all data‑channel tokens to their initial undefined values.
-     * Used when leaving or disconnecting from a meeting.
-     * @returns {void}
-     */
-    function resetDatachannelTokens() {
-      this.datachannelTokens = (0, _defineProperty3.default)((0, _defineProperty3.default)({}, _llm.DataChannelTokenType.Default, undefined), _llm.DataChannelTokenType.PracticeSession, undefined);
-    }
-
     /**
      * Set the handler used to refresh the DataChannel token
      *
      * @param {function} handler - Function that returns a refreshed token
+     * @param {string} [sessionId] - Connection identifier
+     * @param {string | undefined} ownerMeetingId - Meeting id asserting refresh-handler ownership
      * @returns {void}
      */
-  }, {
-    key: "setRefreshHandler",
-    value: function setRefreshHandler(handler) {
-      this.refreshHandler = handler;
+    function setRefreshHandler(handler, sessionId, ownerMeetingId) {
+      var resolvedSessionId = sessionId !== null && sessionId !== void 0 ? sessionId : _constants.LLM_DEFAULT_SESSION;
+      var _this$resolveSessionO5 = this.resolveSessionOwnership(ownerMeetingId, resolvedSessionId),
+        currentOwner = _this$resolveSessionO5.currentOwner,
+        isOwner = _this$resolveSessionO5.isOwner;
+      if (!isOwner) {
+        this.logger.info("llm#setRefreshHandler --> skip write for session ".concat(resolvedSessionId, "; owned by ").concat(currentOwner, ", candidate ").concat(ownerMeetingId));
+        return;
+      }
+      var sessionData = this.connections.get(resolvedSessionId);
+      if (sessionData) {
+        sessionData.refreshHandler = handler;
+        if (ownerMeetingId) {
+          sessionData.ownerMeetingId = ownerMeetingId;
+        }
+        return;
+      }
+
+      // Intentionally allow a pre-connection session shape here.
+      // Some flows inject refreshHandler before register/connect so token refresh
+      // is already wired when the socket lifecycle starts. register()/
+      // registerAndConnect() will later fill webSocketUrl/binding/locusUrl/
+      // datachannelUrl into this same session entry.
+      this.connections.set(resolvedSessionId, {
+        refreshHandler: handler,
+        ownerMeetingId: ownerMeetingId
+      });
     }
 
     /**
      * Refresh the data channel token using the injected handler.
      * Logs a descriptive error if the handler is missing or fails.
-     *
+     * @param {string} sessionId - Connection identifier (defaults to default session)
      * @returns {Promise<string>} The refreshed token.
      */
   }, {
     key: "refreshDataChannelToken",
     value: (function () {
       var _refreshDataChannelToken = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee3() {
-        var res, _t;
+        var _this$connections$get;
+        var sessionId,
+          refreshHandler,
+          res,
+          _args3 = arguments,
+          _t2;
         return _regenerator.default.wrap(function (_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
-              if (this.refreshHandler) {
+              sessionId = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : _constants.LLM_DEFAULT_SESSION;
+              refreshHandler = (_this$connections$get = this.connections.get(sessionId)) === null || _this$connections$get === void 0 ? void 0 : _this$connections$get.refreshHandler;
+              if (refreshHandler) {
                 _context3.next = 1;
                 break;
               }
-              this.logger.warn('llm#refreshDataChannelToken --> LLM refreshHandler is not set, skipping token refresh');
+              this.logger.warn("llm#refreshDataChannelToken --> LLM refreshHandler is not set for session ".concat(sessionId, ", skipping token refresh"));
               return _context3.abrupt("return", null);
             case 1:
               _context3.prev = 1;
               _context3.next = 2;
-              return this.refreshHandler();
+              return refreshHandler();
             case 2:
               res = _context3.sent;
               return _context3.abrupt("return", res);
             case 3:
               _context3.prev = 3;
-              _t = _context3["catch"](1);
-              this.logger.warn("llm#refreshDataChannelToken --> DataChannel token refresh failed (likely locus changed or participant left): ".concat((_t === null || _t === void 0 ? void 0 : _t.message) || _t));
+              _t2 = _context3["catch"](1);
+              this.logger.warn("llm#refreshDataChannelToken --> DataChannel token refresh failed (likely locus changed or participant left): ".concat((_t2 === null || _t2 === void 0 ? void 0 : _t2.message) || _t2));
               return _context3.abrupt("return", null);
             case 4:
             case "end":
@@ -322,6 +522,74 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
       }
       return refreshDataChannelToken;
     }())
+  }, {
+    key: "getLocusUrlByDatachannelUrl",
+    value:
+    /**
+     * Look up the locusUrl associated with a datachannel request URL.
+     * Iterates all active LLM sessions and returns the locusUrl of the
+     * session whose stored datachannelUrl is a prefix of the given request URL.
+     *
+     * @param {string} requestUrl - The in-flight request URL to match
+     * @returns {string | undefined} The matching locusUrl, or undefined if not found
+     */
+    function getLocusUrlByDatachannelUrl(requestUrl) {
+      var _iterator = _createForOfIteratorHelper(this.connections),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var _step$value = (0, _slicedToArray2.default)(_step.value, 2),
+            connection = _step$value[1];
+          if (connection.datachannelUrl && LLMChannel.matchesDatachannelRequestUrl(requestUrl, connection.datachannelUrl)) {
+            return connection.locusUrl;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      return undefined;
+    }
+
+    /**
+     * Look up the sessionId associated with a datachannel request URL.
+     * Iterates all active LLM sessions and returns the sessionId whose
+     * stored datachannelUrl is a prefix of the given request URL.
+     *
+     * @param {string} requestUrl - The in-flight request URL to match
+     * @returns {string | undefined} The matching sessionId, or undefined if not found
+     */
+  }, {
+    key: "getSessionIdByDatachannelUrl",
+    value: function getSessionIdByDatachannelUrl(requestUrl) {
+      var _iterator2 = _createForOfIteratorHelper(this.connections),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _step2$value = (0, _slicedToArray2.default)(_step2.value, 2),
+            sessionId = _step2$value[0],
+            connection = _step2$value[1];
+          if (connection.datachannelUrl && LLMChannel.matchesDatachannelRequestUrl(requestUrl, connection.datachannelUrl)) {
+            return sessionId;
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return undefined;
+    }
+
+    /**
+     * Matches a request URL to a stored datachannel registration URL.
+     * Host can differ (e.g. rewritten by hostmap interceptor), so we first
+     * try full URL prefix and then fall back to pathname prefix.
+     * @param {string} requestUrl
+     * @param {string} registrationUrl
+     * @returns {boolean}
+     */
   }, {
     key: "isDataChannelTokenEnabled",
     value:
@@ -341,6 +609,23 @@ var LLMChannel = exports.default = /*#__PURE__*/function (_ref) {
      * @param {string[]} subchannels - List of subchannels to declare as subscription-aware.
      * @returns {string} The final URL with updated query parameters.
      */
+  }], [{
+    key: "matchesDatachannelRequestUrl",
+    value: function matchesDatachannelRequestUrl(requestUrl, registrationUrl) {
+      if (!requestUrl || !registrationUrl) {
+        return false;
+      }
+      if (requestUrl.startsWith(registrationUrl)) {
+        return true;
+      }
+      try {
+        var request = new URL(requestUrl);
+        var registration = new URL(registrationUrl);
+        return request.pathname.startsWith(registration.pathname);
+      } catch (error) {
+        return false;
+      }
+    }
   }]);
 }(_internalPluginMercury.default);
 (0, _defineProperty3.default)(LLMChannel, "buildUrlWithAwareSubchannels", function (baseUrl, subchannels) {