@atlaskit/editor-plugin-autocomplete 4.1.0 → 4.1.1

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

@@ -42,6 +42,7 @@ export const createSlowLaneClient = config => {
     baseUrl,
     sessionId: configSessionId,
     productKey = 'confluence',
+    surface,
     endpoint = '/gateway/api/v1/autocomplete/typeahead-encodings',
     debounceMs = DEFAULT_DEBOUNCE_MS,
     fetchFn = fetch,
@@ -70,7 +71,10 @@ export const createSlowLaneClient = config => {
     };
     startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
       textLength: text.length,
-      isLocalLLM: false
+      isLocalLLM: false,
+      ...(surface ? {
+        surface
+      } : {})
     });
     if (isAutocompleteDebugEnabled()) {
       // eslint-disable-next-line no-console
@@ -94,7 +98,10 @@ export const createSlowLaneClient = config => {
         failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
           status: res.status,
           errorType: 'http_error',
-          isLocalLLM: false
+          isLocalLLM: false,
+          ...(surface ? {
+            surface
+          } : {})
         });
         if (isAutocompleteDebugEnabled()) {
           // eslint-disable-next-line no-console
@@ -127,7 +134,10 @@ export const createSlowLaneClient = config => {
         textLength: text.length,
         hasVector: storedContextVector !== null,
         hasLmLogits: storedLmLogits !== null,
-        isLocalLLM: false
+        isLocalLLM: false,
+        ...(surface ? {
+          surface
+        } : {})
       });
       onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
         textLength: text.length,
@@ -140,7 +150,10 @@ export const createSlowLaneClient = config => {
       storedLmLogits = null;
       failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
         errorType: 'network',
-        isLocalLLM: false
+        isLocalLLM: false,
+        ...(surface ? {
+          surface
+        } : {})
       });
       if (isAutocompleteDebugEnabled()) {
         // eslint-disable-next-line no-console
@@ -161,7 +174,10 @@ export const createSlowLaneClient = config => {
       debounceTimer = null;
       if (inflightRequestId !== null) {
         abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, inflightRequestId, 'superseded', {
-          isLocalLLM: false
+          isLocalLLM: false,
+          ...(surface ? {
+            surface
+          } : {})
         });
       }
       const requestId = String(++requestSeq);

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

@@ -599,9 +599,13 @@ export const loadVectorsAsync = async options => {
     return;
   }
   const isLocalLLM = (_options$isLocalLLM = options === null || options === void 0 ? void 0 : options.isLocalLLM) !== null && _options$isLocalLLM !== void 0 ? _options$isLocalLLM : false;
+  const surface = options === null || options === void 0 ? void 0 : options.surface;
   vectorsLoadStarted = true;
   startExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
-    isLocalLLM
+    isLocalLLM,
+    ...(surface ? {
+      surface
+    } : {})
   });
   let url;
   try {
@@ -610,7 +614,10 @@ export const loadVectorsAsync = async options => {
     vectorsLoadStarted = false;
     failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
       isLocalLLM,
-      errorType: 'resolve_url'
+      errorType: 'resolve_url',
+      ...(surface ? {
+        surface
+      } : {})
     });
     // eslint-disable-next-line no-console
     console.warn('[text-predictor] Failed to resolve vectors URL:', e);
@@ -624,7 +631,10 @@ export const loadVectorsAsync = async options => {
       failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
         isLocalLLM,
         status: res.status,
-        errorType: 'http_error'
+        errorType: 'http_error',
+        ...(surface ? {
+          surface
+        } : {})
       });
       // eslint-disable-next-line no-console
       console.warn(`[text-predictor] Failed to load vectors: ${res.status}`);
@@ -654,7 +664,10 @@ export const loadVectorsAsync = async options => {
       isLocalLLM,
       wordCount: nWords,
       dim,
-      sizeBytes: float32.byteLength
+      sizeBytes: float32.byteLength,
+      ...(surface ? {
+        surface
+      } : {})
     });
     if (isAutocompleteDebugEnabled()) {
       // eslint-disable-next-line no-console
@@ -668,7 +681,10 @@ export const loadVectorsAsync = async options => {
     vectorsLoadStarted = false;
     failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
       isLocalLLM,
-      errorType: 'network'
+      errorType: 'network',
+      ...(surface ? {
+        surface
+      } : {})
     });
     // eslint-disable-next-line no-console
     console.warn('[text-predictor] Failed to load vectors:', e);
@@ -687,9 +703,13 @@ export const loadDefaultVocabulary = options => {
     return vocabularyLoadPromise;
   }
   const isLocalLLM = (_options$isLocalLLM2 = options === null || options === void 0 ? void 0 : options.isLocalLLM) !== null && _options$isLocalLLM2 !== void 0 ? _options$isLocalLLM2 : false;
+  const surface = options === null || options === void 0 ? void 0 : options.surface;
   vocabularyLoadPromise = (async () => {
     startExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
-      isLocalLLM
+      isLocalLLM,
+      ...(surface ? {
+        surface
+      } : {})
     });
     try {
       // The L2 vocabulary and L3 word list are code-split into their own async
@@ -717,12 +737,18 @@ export const loadDefaultVocabulary = options => {
       succeedExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
         isLocalLLM,
         l2WordCount: terms.length,
-        l3WordCount: l3VocabularyData.length
+        l3WordCount: l3VocabularyData.length,
+        ...(surface ? {
+          surface
+        } : {})
       });
     } catch (e) {
       failExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
         isLocalLLM,
-        errorType: 'parse_error'
+        errorType: 'parse_error',
+        ...(surface ? {
+          surface
+        } : {})
       });
       // Allow a later call to retry the load rather than caching the failure.
       vocabularyLoadPromise = undefined;

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

@@ -235,7 +235,8 @@ var isEnglishLocale = function isEnglishLocale(locale) {
   return locale.toLowerCase().startsWith('en');
 };
 export var 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;
@@ -283,7 +284,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
       eventType: EVENT_TYPE.TRACK,
       attributes: {
         completionSource: getCompletionSource(),
-        reason: reason
+        reason: reason,
+        surface: surface
       }
     });
   };
@@ -298,7 +300,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
         embeddingModelId: info.embeddingModelId,
         loadDurationMs: info.loadDurationMs,
         gpuVendor: info.capabilities.vendor,
-        gpuArchitecture: info.capabilities.architecture
+        gpuArchitecture: info.capabilities.architecture,
+        surface: surface
       }
     });
   };
@@ -320,7 +323,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
         maxBufferSizeMB: capabilities.maxBufferSizeMB,
         maxStorageBufferBindingSizeMB: capabilities.maxStorageBufferBindingSizeMB,
         gpuVendor: capabilities.vendor,
-        gpuArchitecture: capabilities.architecture
+        gpuArchitecture: capabilities.architecture,
+        surface: surface
       }
     });
   };
@@ -337,17 +341,20 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
         completionSource: getCompletionSource(),
         suggestionLength: suggestionLength,
         typedLength: typedLength,
-        kssDelta: kssDelta
+        kssDelta: kssDelta,
+        surface: surface
       }
     });
   };
   var slowLaneClient = options !== null && options !== void 0 && options.useLocalModel ? createLocalSlowLaneClient({
     debounceMs: LOCAL_SLOW_LANE_DEBOUNCE_MS,
     onLoadSuccess: fireLocalModelLoadedAnalytics,
-    onLoadError: fireLocalModelLoadFailedAnalytics
+    onLoadError: fireLocalModelLoadFailedAnalytics,
+    surface: surface
   }) : createSlowLaneClient({
     baseUrl: '',
-    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS
+    debounceMs: NETWORK_SLOW_LANE_DEBOUNCE_MS,
+    surface: surface
   });
   setDefaultSlowLaneClient(slowLaneClient);
   var contextRequestInFlight = false;
@@ -518,7 +525,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
               actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
               eventType: EVENT_TYPE.TRACK,
               attributes: {
-                completionSource: getCompletionSource()
+                completionSource: getCompletionSource(),
+                surface: surface
               }
             });
           }
@@ -642,7 +650,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
             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: surface
           }).catch(function (error) {
             logException(error, {
               location: 'editor-plugin-autocomplete/loadDefaultVocabulary'
@@ -650,7 +659,8 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
           });
           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) {
             logException(error, {
               location: 'editor-plugin-autocomplete/loadVectorsAsync'

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

@@ -621,7 +621,8 @@ export var createLocalSlowLaneClient = function createLocalSlowLaneClient() {
     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;
@@ -990,10 +991,12 @@ export var createLocalSlowLaneClient = function createLocalSlowLaneClient() {
             // 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.
-            startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, _objectSpread({
               textLength: text.length,
               isLocalLLM: true
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             tStart = performance.now();
             tLmDone = 0;
             tEmbDone = 0;
@@ -1026,9 +1029,11 @@ export var createLocalSlowLaneClient = function createLocalSlowLaneClient() {
               _context4.next = 4;
               break;
             }
-            abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
+            abortExp(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 ──────────────────
@@ -1080,12 +1085,14 @@ export var createLocalSlowLaneClient = function createLocalSlowLaneClient() {
               // eslint-disable-next-line no-console
               console.groupEnd();
             }
-            succeedExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            succeedExp(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,
@@ -1100,17 +1107,21 @@ export var createLocalSlowLaneClient = function createLocalSlowLaneClient() {
               _context4.next = 6;
               break;
             }
-            abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, destroyed ? 'destroyed' : 'superseded', {
+            abortExp(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;
-            failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, experienceId, {
+            failExp(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/esm/pm-plugins/slow-lane-client.js

@@ -1,6 +1,9 @@
 import _typeof from "@babel/runtime/helpers/typeof";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
+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) { _defineProperty(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.
  *
@@ -45,6 +48,7 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
     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,
@@ -81,10 +85,12 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
               text: text,
               session_id: sessionId
             };
-            startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            startExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               textLength: text.length,
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if (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;');
@@ -110,11 +116,13 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
             }
             storedContextVector = null;
             storedLmLogits = null;
-            failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               status: res.status,
               errorType: 'http_error',
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if (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;');
@@ -145,12 +153,14 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
               // eslint-disable-next-line no-console
               console.groupEnd();
             }
-            succeedExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            succeedExp(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,
@@ -164,10 +174,12 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
             _t = _context["catch"](2);
             storedContextVector = null;
             storedLmLogits = null;
-            failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, {
+            failExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, requestId, _objectSpread({
               errorType: 'network',
               isLocalLLM: false
-            });
+            }, surface ? {
+              surface: surface
+            } : {}));
             if (isAutocompleteDebugEnabled()) {
               // eslint-disable-next-line no-console
               console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
@@ -196,9 +208,11 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
     debounceTimer = setTimeout(function () {
       debounceTimer = null;
       if (inflightRequestId !== null) {
-        abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, inflightRequestId, 'superseded', {
+        abortExp(EXPERIENCE_NAME.SLOW_LANE_FETCH, inflightRequestId, 'superseded', _objectSpread({
           isLocalLLM: false
-        });
+        }, surface ? {
+          surface: surface
+        } : {}));
       }
       var requestId = String(++requestSeq);
       inflightRequestId = requestId;

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

@@ -5,6 +5,8 @@ import _createClass from "@babel/runtime/helpers/createClass";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
+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) { _defineProperty(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; }
@@ -732,7 +734,7 @@ function unwrapJsonModule(mod, shape) {
 export var loadVectorsAsync = /*#__PURE__*/function () {
   var _ref6 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.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 _regeneratorRuntime.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -751,10 +753,13 @@ export var 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;
-          startExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          startExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           _context.prev = 3;
           _context.next = 4;
           return options.getBinaryUrl();
@@ -766,10 +771,12 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
           _context.prev = 5;
           _t = _context["catch"](3);
           vectorsLoadStarted = false;
-          failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          failExp(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");
@@ -784,11 +791,13 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
             break;
           }
           vectorsLoadStarted = false;
-          failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          failExp(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");
@@ -817,12 +826,14 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
             wordIndex: wordIndex,
             dim: dim
           };
-          succeedExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          succeedExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM,
             wordCount: nWords,
             dim: dim,
             sizeBytes: float32.byteLength
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           if (isAutocompleteDebugEnabled()) {
             // eslint-disable-next-line no-console
             console.log('[text-predictor] Vectors loaded:', {
@@ -837,10 +848,12 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
           _context.prev = 11;
           _t2 = _context["catch"](6);
           vectorsLoadStarted = false;
-          failExp(EXPERIENCE_NAME.LOAD_VECTORS, 'singleton', {
+          failExp(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:
@@ -866,14 +879,17 @@ export var loadDefaultVocabulary = function loadDefaultVocabulary(options) {
     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 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
     var _yield$Promise$all, _yield$Promise$all2, vocabularyModule, l3VocabularyModule, vocabularyData, l3VocabularyData, terms, _t3;
     return _regeneratorRuntime.wrap(function (_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
-          startExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          startExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', _objectSpread({
             isLocalLLM: isLocalLLM
-          });
+          }, surface ? {
+            surface: surface
+          } : {}));
           _context2.prev = 1;
           _context2.next = 2;
           return Promise.all([import( /* webpackChunkName: "@atlaskit-internal_editor-plugin-autocomplete-vocabulary-10k" */'./data/vocabulary_10k.json'), import( /* webpackChunkName: "@atlaskit-internal_editor-plugin-autocomplete-l3-vocabulary" */'./data/l3_vocabulary.json')]);
@@ -907,20 +923,24 @@ export var loadDefaultVocabulary = function loadDefaultVocabulary(options) {
           initVocabulary({
             terms: terms
           });
-          succeedExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          succeedExp(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);
-          failExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+          failExp(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/types/pm-plugins/autocomplete-plugin.d.ts

@@ -29,6 +29,11 @@ export interface AutocompleteContext {
     siblingCommentsContents?: string[];
 }
 export interface AutocompletePluginOptions {
+    /**
+     * Product/editor surface where autocomplete runs (e.g. "comment", "chat").
+     * Added to analytics and UFO metadata for cross-surface reporting.
+     */
+    surface?: string;
     /**
      * Async function called once on first editor focus to retrieve context for
      * word-frequency boosting. Called lazily so the preset can remain synchronous.

package/dist/types/pm-plugins/local-slow-lane-client.d.ts

@@ -72,6 +72,8 @@ export interface LocalSlowLaneClientConfig {
         hasVector: boolean;
         textLength: number;
     }) => void;
+    /** Product/editor surface where autocomplete runs. */
+    surface?: string;
 }
 export interface LocalSlowLaneClient {
     /** Clean up resources. */

package/dist/types/pm-plugins/slow-lane-client.d.ts

@@ -32,6 +32,7 @@ export interface SlowLaneClientConfig {
     }) => void;
     productKey?: string;
     sessionId?: string;
+    surface?: string;
 }
 export declare const createSlowLaneClient: (config: SlowLaneClientConfig) => {
     getContextVector: () => Float32Array | null;

package/dist/types/pm-plugins/text-predictor.d.ts

@@ -83,9 +83,11 @@ export declare const predict: (textBefore: string) => string | null;
 export declare const loadVectorsAsync: (options?: {
     getBinaryUrl?: () => Promise<string>;
     isLocalLLM?: boolean;
+    surface?: string;
 }) => Promise<void>;
 export declare const initVectors: (store: VectorStore) => void;
 export declare const loadDefaultVocabulary: (options?: {
     isLocalLLM?: boolean;
+    surface?: string;
 }) => Promise<void>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-autocomplete",
-	"version": "4.1.0",
+	"version": "4.1.1",
 	"description": "Client-side text autocomplete plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -8,7 +8,7 @@
 		"registry": "https://registry.npmjs.org/"
 	},
 	"scripts": {
-		"ak-postbuild": "ls -d dist/* | grep -v dist/types | xargs -n 1 copyfiles -u 1 -V 'src/pm-plugins/data/*.json'"
+		"ak-postbuild": "ls -d dist/* | xargs -n 1 copyfiles -u 1 -V src/pm-plugins/data/*.json"
 	},
 	"atlassian": {
 		"team": "Editor: AI",
@@ -36,9 +36,15 @@
 	},
 	"techstack": {
 		"@atlassian/frontend": {
-			"code-structure": ["editor-plugin"],
-			"import-structure": ["atlassian-conventions"],
-			"circular-dependencies": ["file-and-folder-level"]
+			"code-structure": [
+				"editor-plugin"
+			],
+			"import-structure": [
+				"atlassian-conventions"
+			],
+			"circular-dependencies": [
+				"file-and-folder-level"
+			]
 		}
 	},
 	"devDependencies": {