@webex/internal-plugin-llm 3.12.0-task-refactor.1 → 3.12.0-webex-services-ready.1

package/README.md

@@ -23,22 +23,93 @@ npm install --save @webex/internal-plugin-llm
 
 ```js
 import '@webex/internal-plugin-llm';
-
 import WebexCore from '@webex/webex-core';
+// Optional: import enum from package internals if needed in your app setup
+// import {DataChannelTokenType} from '@webex/internal-plugin-llm/src/llm.types';
 
 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();
+// locusUrl and datachannelUrl are from meeting.locusInfo
+const locusUrl = meeting.locusInfo.url;
+const datachannelUrl = meeting.locusInfo.info.datachannelUrl;
+
+// Optional JWT token for data channel auth
+const datachannelToken = '<jwt-token>';
+
+// Default session (no token)
+await webex.internal.llm.registerAndConnect(locusUrl, datachannelUrl);
+
+// Default session (with JWT token)
+await webex.internal.llm.registerAndConnect(locusUrl, datachannelUrl, datachannelToken);
+
+// Multiple named sessions
+await webex.internal.llm.registerAndConnect(locusUrlA, datachannelUrlA, undefined, 'session-a');
+await webex.internal.llm.registerAndConnect(
+  locusUrlB,
+  datachannelUrlB,
+  datachannelToken,
+  'session-b'
+);
+
+// Listen across multiple connections
+const llm = webex.internal.llm;
+const sessionA = 'session-a';
+const sessionB = 'session-b';
+
+// Default session events use the base event name.
+llm.on('online', () => {
+  console.log('[default] connected');
+});
+
+llm.on('event', (envelope) => {
+  console.log('[default] event', envelope.data?.eventType, envelope.sessionId);
+});
+
+// Non-default sessions emit events with :<sessionId> suffix.
+llm.on(`online:${sessionA}`, () => {
+  console.log(`[${sessionA}] connected`);
+});
+
+llm.on(`event:${sessionA}`, (envelope) => {
+  console.log(`[${sessionA}] event`, envelope.data?.eventType, envelope.sessionId);
+});
+
+llm.on(`event:${sessionB}`, (envelope) => {
+  console.log(`[${sessionB}] event`, envelope.data?.eventType, envelope.sessionId);
+});
+
+// Optional: store/retrieve token by token type
+webex.internal.llm.setDatachannelToken(datachannelToken, 'llm-default-session');
+webex.internal.llm.getDatachannelToken('llm-default-session');
+
+// Optional: inject token refresh handler
+webex.internal.llm.setRefreshHandler(async () => {
+  // Return shape must match plugin expectation
+  return {
+    body: {
+      datachannelToken: '<refreshed-jwt-token>',
+      datachannelTokenType: 'llm-default-session',
+    },
+  };
+}, 'llm-default-session');
+
+// Optional: manually trigger refresh (if needed by your flow)
+await webex.internal.llm.refreshDataChannelToken();
+
+// Per-session status and metadata
+webex.internal.llm.isConnected('session-a');
+webex.internal.llm.getBinding('session-a');
+webex.internal.llm.getLocusUrl('session-a');
+webex.internal.llm.getDatachannelUrl('session-a');
+
+// All active sessions
+webex.internal.llm.getAllConnections();
+
+// Disconnect one session
+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'});
 ```
 
 ## 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

@@ -7,6 +7,24 @@ var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs2/core-js/o
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
+_Object$defineProperty(exports, "DataChannelTokenType", {
+  enumerable: true,
+  get: function get() {
+    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() {
@@ -15,6 +33,8 @@ _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","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","_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\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;AAOA,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":[]}