@atlaskit/editor-plugin-autocomplete 4.1.0 → 4.1.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @atlaskit/editor-plugin-autocomplete
 
+## 4.1.1
+
+### Patch Changes
+
+- [`18ab4e3c6ed23`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/18ab4e3c6ed23) -
+  Include asset files in the published package so they render correctly for consumers.
+- [`96ceccb98c3b9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/96ceccb98c3b9) -
+  Add a `surface` attribute to editor autocomplete analytics and UFO experience metadata, and wire
+  it through the plugin lifecycle.
+
+  Host integrations now pass explicit surface values:
+  - Confluence comments uses `confluence-comments`
+  - Rovo chat uses `rovo-chat`
+
+  This improves cross-surface tracking clarity while keeping surface values consumer-defined.
+
+- Updated dependencies
+
 ## 4.1.0
 
 ### Minor Changes

package/dist/cjs/pm-plugins/autocomplete-plugin.js

@@ -242,7 +242,8 @@ var isEnglishLocale = function isEnglishLocale(locale) {
   return locale.toLowerCase().startsWith('en');
 };
 var createAutocompletePlugin = exports.createAutocompletePlugin = function createAutocompletePlugin(options, api) {
-  var _options$locale;
+  var _options$surface, _options$locale;
+  var surface = (_options$surface = options === null || options === void 0 ? void 0 : options.surface) !== null && _options$surface !== void 0 ? _options$surface : 'editor';
   var locale = (_options$locale = options === null || options === void 0 ? void 0 : options.locale) !== null && _options$locale !== void 0 ? _options$locale : typeof navigator !== 'undefined' ? navigator.language : undefined;
   var isAutocompleteEnabled = isEnglishLocale(locale);
   var debounceTimer = null;
@@ -290,7 +291,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
       eventType: _analytics.EVENT_TYPE.TRACK,
       attributes: {
         completionSource: getCompletionSource(),
-        reason: reason
+        reason: reason,
+        surface: surface
       }
     });
   };
@@ -305,7 +307,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
         embeddingModelId: info.embeddingModelId,
         loadDurationMs: info.loadDurationMs,
         gpuVendor: info.capabilities.vendor,
-        gpuArchitecture: info.capabilities.architecture
+        gpuArchitecture: info.capabilities.architecture,
+        surface: surface
       }
     });
   };
@@ -327,7 +330,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
         maxBufferSizeMB: capabilities.maxBufferSizeMB,
         maxStorageBufferBindingSizeMB: capabilities.maxStorageBufferBindingSizeMB,
         gpuVendor: capabilities.vendor,
-        gpuArchitecture: capabilities.architecture
+        gpuArchitecture: capabilities.architecture,
+        surface: surface
       }
     });
   };
@@ -344,17 +348,20 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
         completionSource: getCompletionSource(),
         suggestionLength: suggestionLength,
         typedLength: typedLength,
-        kssDelta: kssDelta
+        kssDelta: kssDelta,
+        surface: surface
       }
     });
   };
   var slowLaneClient = options !== null && options !== void 0 && options.useLocalModel ? (0, _localSlowLaneClient.createLocalSlowLaneClient)({
     debounceMs: LOCAL_SLOW_LANE_DEBOUNCE_MS,
     onLoadSuccess: fireLocalModelLoadedAnalytics,
-    onLoadError: fireLocalModelLoadFailedAnalytics
+    onLoadError: fireLocalModelLoadFailedAnalytics,
+    surface: surface
   }) : (0, _slowLaneClient.createSlowLaneClient)({
     baseUrl: '',
-    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS
+    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS,
+    surface: surface
   });
   (0, _slowLaneClient.setDefaultSlowLaneClient)(slowLaneClient);
   var contextRequestInFlight = false;
@@ -525,7 +532,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
               actionSubject: _analytics.ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
               eventType: _analytics.EVENT_TYPE.TRACK,
               attributes: {
-                completionSource: getCompletionSource()
+                completionSource: getCompletionSource(),
+                surface: surface
               }
             });
           }
@@ -649,7 +657,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
             return false;
           }
           (0, _textPredictor.loadDefaultVocabulary)({
-            isLocalLLM: (_options$useLocalMode = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode !== void 0 ? _options$useLocalMode : false
+            isLocalLLM: (_options$useLocalMode = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode !== void 0 ? _options$useLocalMode : false,
+            surface: surface
           }).catch(function (error) {
             (0, _monitoring.logException)(error, {
               location: 'editor-plugin-autocomplete/loadDefaultVocabulary'
@@ -657,7 +666,8 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
           });
           (0, _textPredictor.loadVectorsAsync)({
             getBinaryUrl: options === null || options === void 0 ? void 0 : options.getVectorsBinaryUrl,
-            isLocalLLM: (_options$useLocalMode2 = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode2 !== void 0 ? _options$useLocalMode2 : false
+            isLocalLLM: (_options$useLocalMode2 = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode2 !== void 0 ? _options$useLocalMode2 : false,
+            surface: surface
           }).catch(function (error) {
             (0, _monitoring.logException)(error, {
               location: 'editor-plugin-autocomplete/loadVectorsAsync'

package/dist/cjs/pm-plugins/local-slow-lane-client.js

@@ -631,7 +631,8 @@ var createLocalSlowLaneClient = exports.createLocalSlowLaneClient = function cre
     onLoadSuccess = config.onLoadSuccess,
     _config$modelId = config.modelId,
     modelId = _config$modelId === void 0 ? LOCAL_MLC_CAUSAL_MODEL_ID : _config$modelId,
-    customModelConfig = config.customModelConfig;
+    customModelConfig = config.customModelConfig,
+    surface = config.surface;
 
   // ── State ──────────────────────────────────────────────────────────────
   var storedContextVector = null;
@@ -1002,10 +1003,12 @@ var createLocalSlowLaneClient = exports.createLocalSlowLaneClient = function cre
             // the try — post engine-init (parity with the network fetch, which
             // excludes the one-time model load) and so the catch below always
             // terminates the experience, even on a synchronous throw.
-            (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, _objectSpread({
               textLength: text.length,
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             tStart = performance.now();
             tLmDone = 0;
             tEmbDone = 0;
@@ -1038,9 +1041,11 @@ var createLocalSlowLaneClient = exports.createLocalSlowLaneClient = function cre
               _context4.next = 4;
               break;
             }
-            (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
+            (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', _objectSpread({
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             return _context4.abrupt("return");
           case 4:
             // ── LM logits: whole-word BE-parity payload ──────────────────
@@ -1092,12 +1097,14 @@ var createLocalSlowLaneClient = exports.createLocalSlowLaneClient = function cre
               // eslint-disable-next-line no-console
               console.groupEnd();
             }
-            (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, _objectSpread({
               textLength: text.length,
               hasVector: storedContextVector !== null,
               hasLmLogits: storedLmLogits !== null,
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             onUpdate === null || onUpdate === void 0 || onUpdate({
               textLength: text.length,
               hasVector: storedContextVector !== null,
@@ -1112,17 +1119,21 @@ var createLocalSlowLaneClient = exports.createLocalSlowLaneClient = function cre
               _context4.next = 6;
               break;
             }
-            (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
+            (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', _objectSpread({
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             return _context4.abrupt("return");
           case 6:
             storedContextVector = null;
             storedLmLogits = null;
-            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, _objectSpread({
               errorType: 'inference',
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             onUpdate === null || onUpdate === void 0 || onUpdate({
               textLength: text.length,
               hasVector: false,

package/dist/cjs/pm-plugins/slow-lane-client.js

@@ -7,10 +7,12 @@ Object.defineProperty(exports, "__esModule", {
 exports.setDefaultSlowLaneClient = exports.isWordBoundary = exports.getStoredLmLogits = exports.getStoredContextVector = exports.createSlowLaneClient = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _ufo = require("../analytics/ufo");
 var _debugMode = require("./debug-mode");
-/**
+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; } /**
  * Slow Lane Client: Backend context encoding for autocomplete.
  *
  * Fires a BE request on word boundaries to encode document context.
@@ -18,7 +20,6 @@ var _debugMode = require("./debug-mode");
  *   Request:  { text, session_id }
  *   Response: { semantic_vector: number[], lm_logits: Record<string, number> }
  */
-
 // ─── Types ───────────────────────────────────────────────────────────────────
 
 /** Request payload for typeahead-encodings endpoint. */
@@ -51,6 +52,7 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
     configSessionId = config.sessionId,
     _config$productKey = config.productKey,
     productKey = _config$productKey === void 0 ? 'confluence' : _config$productKey,
+    surface = config.surface,
     _config$endpoint = config.endpoint,
     endpoint = _config$endpoint === void 0 ? '/gateway/api/v1/autocomplete/typeahead-encodings' : _config$endpoint,
     _config$debounceMs = config.debounceMs,
@@ -87,10 +89,12 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
               text: text,
               session_id: sessionId
             };
-            (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               textLength: text.length,
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if ((0, _debugMode.isAutocompleteDebugEnabled)()) {
               // eslint-disable-next-line no-console
               console.groupCollapsed("%c[SlowLane] %c\uD83D\uDCE4 Sending context | ".concat(text.length, " chars"), 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
@@ -116,11 +120,13 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
             }
             storedContextVector = null;
             storedLmLogits = null;
-            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               status: res.status,
               errorType: 'http_error',
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if ((0, _debugMode.isAutocompleteDebugEnabled)()) {
               // eslint-disable-next-line no-console
               console.log("%c[SlowLane] %c\u274C Request failed (".concat(res.status, ")"), 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
@@ -151,12 +157,14 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
               // eslint-disable-next-line no-console
               console.groupEnd();
             }
-            (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               textLength: text.length,
               hasVector: storedContextVector !== null,
               hasLmLogits: storedLmLogits !== null,
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             onUpdate === null || onUpdate === void 0 || onUpdate({
               textLength: text.length,
               hasVector: storedContextVector !== null,
@@ -170,10 +178,12 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
             _t = _context["catch"](2);
             storedContextVector = null;
             storedLmLogits = null;
-            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               errorType: 'network',
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if ((0, _debugMode.isAutocompleteDebugEnabled)()) {
               // eslint-disable-next-line no-console
               console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
@@ -202,9 +212,11 @@ var createSlowLaneClient = exports.createSlowLaneClient = function createSlowLan
     debounceTimer = setTimeout(function () {
       debounceTimer = null;
       if (inflightRequestId !== null) {
-        (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, inflightRequestId, 'superseded', {
+        (0, _ufo.abortExp)(_ufo.EXPERIENCE_NAME.SLOW_LANE_FETCH, inflightRequestId, 'superseded', _objectSpread({
           isLocalLLM: false
-        });
+        }, surface ? {
+          surface: surface
+        } : {}));
       }
       var requestId = String(++requestSeq);
       inflightRequestId = requestId;

package/dist/cjs/pm-plugins/text-predictor.js

@@ -18,6 +18,8 @@ var _debugMode = require("./debug-mode");
 var _scoringPipeline = require("./scoring-pipeline");
 var _slowLaneClient = require("./slow-lane-client");
 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" != _typeof3(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 _t4 in e) "default" !== _t4 && {}.hasOwnProperty.call(e, _t4) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t4)) && (i.get || i.set) ? o(f, _t4, i) : f[_t4] = e[_t4]); return f; })(e, t); }
+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 _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; } /**
@@ -736,7 +738,7 @@ function unwrapJsonModule(mod, shape) {
 var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
   var _ref6 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(options) {
     var _options$isLocalLLM;
-    var isLocalLLM, url, _wordIndexOuter$index, res, buffer, float32, wordIndexModule, wordIndexOuter, wordIndex, nWords, dim, _t, _t2;
+    var isLocalLLM, surface, url, _wordIndexOuter$index, res, buffer, float32, wordIndexModule, wordIndexOuter, wordIndex, nWords, dim, _t, _t2;
     return _regenerator.default.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -755,10 +757,13 @@ var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
           return _context.abrupt("return");
         case 2:
           isLocalLLM = (_options$isLocalLLM = options === null || options === void 0 ? void 0 : options.isLocalLLM) !== null && _options$isLocalLLM !== void 0 ? _options$isLocalLLM : false;
+          surface = options === null || options === void 0 ? void 0 : options.surface;
           vectorsLoadStarted = true;
-          (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           _context.prev = 3;
           _context.next = 4;
           return options.getBinaryUrl();
@@ -770,10 +775,12 @@ var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
           _context.prev = 5;
           _t = _context["catch"](3);
           vectorsLoadStarted = false;
-          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             errorType: 'resolve_url'
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           // eslint-disable-next-line no-console
           console.warn('[text-predictor] Failed to resolve vectors URL:', _t);
           return _context.abrupt("return");
@@ -788,11 +795,13 @@ var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
             break;
           }
           vectorsLoadStarted = false;
-          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             status: res.status,
             errorType: 'http_error'
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           // eslint-disable-next-line no-console
           console.warn("[text-predictor] Failed to load vectors: ".concat(res.status));
           return _context.abrupt("return");
@@ -823,12 +832,14 @@ var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
             wordIndex: wordIndex,
             dim: dim
           };
-          (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             wordCount: nWords,
             dim: dim,
             sizeBytes: float32.byteLength
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           if ((0, _debugMode.isAutocompleteDebugEnabled)()) {
             // eslint-disable-next-line no-console
             console.log('[text-predictor] Vectors loaded:', {
@@ -843,10 +854,12 @@ var loadVectorsAsync = exports.loadVectorsAsync = /*#__PURE__*/function () {
           _context.prev = 11;
           _t2 = _context["catch"](6);
           vectorsLoadStarted = false;
-          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             errorType: 'network'
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           // eslint-disable-next-line no-console
           console.warn('[text-predictor] Failed to load vectors:', _t2);
         case 12:
@@ -872,14 +885,17 @@ var loadDefaultVocabulary = exports.loadDefaultVocabulary = function loadDefault
     return vocabularyLoadPromise;
   }
   var isLocalLLM = (_options$isLocalLLM2 = options === null || options === void 0 ? void 0 : options.isLocalLLM) !== null && _options$isLocalLLM2 !== void 0 ? _options$isLocalLLM2 : false;
+  var surface = options === null || options === void 0 ? void 0 : options.surface;
   vocabularyLoadPromise = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2() {
     var _yield$Promise$all, _yield$Promise$all2, vocabularyModule, l3VocabularyModule, vocabularyData, l3VocabularyData, terms, _t3;
     return _regenerator.default.wrap(function (_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
-          (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          (0, _ufo.startExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           _context2.prev = 1;
           _context2.next = 2;
           return Promise.all([Promise.resolve().then(function () {
@@ -917,20 +933,24 @@ var loadDefaultVocabulary = exports.loadDefaultVocabulary = function loadDefault
           initVocabulary({
             terms: terms
           });
-          (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          (0, _ufo.succeedExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             l2WordCount: terms.length,
             l3WordCount: l3VocabularyData.length
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           _context2.next = 5;
           break;
         case 4:
           _context2.prev = 4;
           _t3 = _context2["catch"](1);
-          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          (0, _ufo.failExp)(_ufo.EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             errorType: 'parse_error'
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           // Allow a later call to retry the load rather than caching the failure.
           vocabularyLoadPromise = undefined;
           throw _t3;

package/dist/es2019/pm-plugins/autocomplete-plugin.js

@@ -230,7 +230,8 @@ const isEnglishLocale = locale => {
   return locale.toLowerCase().startsWith('en');
 };
 export const createAutocompletePlugin = (options, api) => {
-  var _options$locale;
+  var _options$surface, _options$locale;
+  const surface = (_options$surface = options === null || options === void 0 ? void 0 : options.surface) !== null && _options$surface !== void 0 ? _options$surface : 'editor';
   const locale = (_options$locale = options === null || options === void 0 ? void 0 : options.locale) !== null && _options$locale !== void 0 ? _options$locale : typeof navigator !== 'undefined' ? navigator.language : undefined;
   const isAutocompleteEnabled = isEnglishLocale(locale);
   let debounceTimer = null;
@@ -278,7 +279,8 @@ export const createAutocompletePlugin = (options, api) => {
       eventType: EVENT_TYPE.TRACK,
       attributes: {
         completionSource: getCompletionSource(),
-        reason
+        reason,
+        surface
       }
     });
   };
@@ -293,7 +295,8 @@ export const createAutocompletePlugin = (options, api) => {
         embeddingModelId: info.embeddingModelId,
         loadDurationMs: info.loadDurationMs,
         gpuVendor: info.capabilities.vendor,
-        gpuArchitecture: info.capabilities.architecture
+        gpuArchitecture: info.capabilities.architecture,
+        surface
       }
     });
   };
@@ -317,7 +320,8 @@ export const createAutocompletePlugin = (options, api) => {
         maxBufferSizeMB: capabilities.maxBufferSizeMB,
         maxStorageBufferBindingSizeMB: capabilities.maxStorageBufferBindingSizeMB,
         gpuVendor: capabilities.vendor,
-        gpuArchitecture: capabilities.architecture
+        gpuArchitecture: capabilities.architecture,
+        surface
       }
     });
   };
@@ -334,17 +338,20 @@ export const createAutocompletePlugin = (options, api) => {
         completionSource: getCompletionSource(),
         suggestionLength,
         typedLength,
-        kssDelta
+        kssDelta,
+        surface
       }
     });
   };
   const slowLaneClient = options !== null && options !== void 0 && options.useLocalModel ? createLocalSlowLaneClient({
     debounceMs: LOCAL_SLOW_LANE_DEBOUNCE_MS,
     onLoadSuccess: fireLocalModelLoadedAnalytics,
-    onLoadError: fireLocalModelLoadFailedAnalytics
+    onLoadError: fireLocalModelLoadFailedAnalytics,
+    surface
   }) : createSlowLaneClient({
     baseUrl: '',
-    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS
+    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS,
+    surface
   });
   setDefaultSlowLaneClient(slowLaneClient);
   let contextRequestInFlight = false;
@@ -509,7 +516,8 @@ export const createAutocompletePlugin = (options, api) => {
               actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
               eventType: EVENT_TYPE.TRACK,
               attributes: {
-                completionSource: getCompletionSource()
+                completionSource: getCompletionSource(),
+                surface
               }
             });
           }
@@ -636,7 +644,8 @@ export const createAutocompletePlugin = (options, api) => {
             return false;
           }
           loadDefaultVocabulary({
-            isLocalLLM: (_options$useLocalMode = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode !== void 0 ? _options$useLocalMode : false
+            isLocalLLM: (_options$useLocalMode = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode !== void 0 ? _options$useLocalMode : false,
+            surface
           }).catch(error => {
             logException(error, {
               location: 'editor-plugin-autocomplete/loadDefaultVocabulary'
@@ -644,7 +653,8 @@ export const createAutocompletePlugin = (options, api) => {
           });
           loadVectorsAsync({
             getBinaryUrl: options === null || options === void 0 ? void 0 : options.getVectorsBinaryUrl,
-            isLocalLLM: (_options$useLocalMode2 = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode2 !== void 0 ? _options$useLocalMode2 : false
+            isLocalLLM: (_options$useLocalMode2 = options === null || options === void 0 ? void 0 : options.useLocalModel) !== null && _options$useLocalMode2 !== void 0 ? _options$useLocalMode2 : false,
+            surface
           }).catch(error => {
             logException(error, {
               location: 'editor-plugin-autocomplete/loadVectorsAsync'

package/dist/es2019/pm-plugins/local-slow-lane-client.js

@@ -489,7 +489,8 @@ export const createLocalSlowLaneClient = (config = {}) => {
     onLoadError,
     onLoadSuccess,
     modelId = LOCAL_MLC_CAUSAL_MODEL_ID,
-    customModelConfig
+    customModelConfig,
+    surface
   } = config;
 
   // ── State ──────────────────────────────────────────────────────────────
@@ -786,7 +787,10 @@ export const createLocalSlowLaneClient = (config = {}) => {
       // terminates the experience, even on a synchronous throw.
       startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
         textLength: text.length,
-        isLocalLLM: true
+        isLocalLLM: true,
+        ...(surface ? {
+          surface
+        } : {})
       });
       const tStart = performance.now();
       let tLmDone = 0;
@@ -813,7 +817,10 @@ export const createLocalSlowLaneClient = (config = {}) => {
       // Discard stale results
       if (requestId < latestRequestId || destroyed) {
         abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
-          isLocalLLM: true
+          isLocalLLM: true,
+          ...(surface ? {
+            surface
+          } : {})
         });
         return;
       }
@@ -861,7 +868,10 @@ export const createLocalSlowLaneClient = (config = {}) => {
         textLength: text.length,
         hasVector: storedContextVector !== null,
         hasLmLogits: storedLmLogits !== null,
-        isLocalLLM: true
+        isLocalLLM: true,
+        ...(surface ? {
+          surface
+        } : {})
       });
       onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
         textLength: text.length,
@@ -872,7 +882,10 @@ export const createLocalSlowLaneClient = (config = {}) => {
       // Discard errors for stale requests or after teardown
       if (requestId < latestRequestId || destroyed) {
         abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
-          isLocalLLM: true
+          isLocalLLM: true,
+          ...(surface ? {
+            surface
+          } : {})
         });
         return;
       }
@@ -880,7 +893,10 @@ export const createLocalSlowLaneClient = (config = {}) => {
       storedLmLogits = null;
       failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
         errorType: 'inference',
-        isLocalLLM: true
+        isLocalLLM: true,
+        ...(surface ? {
+          surface
+        } : {})
       });
       onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
         textLength: text.length,