@atlaskit/editor-plugin-mentions 14.2.3 → 14.4.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @atlaskit/editor-plugin-mentions
 
+## 14.4.0
+
+### Minor Changes
+
+- [`dbf22f118dd9e`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/dbf22f118dd9e) -
+  Rewrite Rovo Chat @-mention provider on a single Relay-native RovoChatMentionResource that fires
+  people + agents in parallel via Promise. People render as soon as URS resolves and agents pop in
+  below when ready. New aliased agentStudio_getAgents query consolidates 3 prefetch round trips into
+  1, drops over-fetched fields, and uses real abort plumbing. Adds opt-in subscribeToItemsUpdates
+  multi-emit contract to the editor mention typeahead so progressive emissions are no longer dropped
+  after the first frame.
+
+### Patch Changes
+
+- [`ddeae9a5f8bdf`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/ddeae9a5f8bdf) -
+  Prevent remote collaborative agent mention insertions from publishing local agent mention
+  insertion state.
+- Updated dependencies
+
+## 14.3.0
+
+### Minor Changes
+
+- [`cf7797df5ff1e`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/cf7797df5ff1e) -
+  [ux] Add a Labs lozenge to the agent mention typeahead section.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 14.2.3
 
 ### Patch Changes

package/dist/cjs/pm-plugins/main.js

@@ -39,7 +39,7 @@ var isAgentUserType = function isAgentUserType(userType) {
 var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var AGENT_MENTION_INACTIVITY_MS = 3000;
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "14.2.2";
+var PACKAGE_VERSION = "14.3.0";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -355,8 +355,7 @@ function createMentionPlugin(_ref2) {
           }
           (_insm$session2 = _insm.insm.session) === null || _insm$session2 === void 0 || _insm$session2.endFeature('mentionDeletionDetection');
         }
-        var isAIStreaming = Boolean(tr.getMeta(AI_STREAMING_TRANSFORMATION_META_KEY));
-        if (tr.docChanged && !tr.getMeta('replaceDocument') && !isAIStreaming && isAgentMentionsExperimentEnabled) {
+        if (isAgentMentionsExperimentEnabled && isQualifyingLocalUserDocChange(tr)) {
           var _mentionSchema = newState.schema.nodes.mention;
           var newDocRanges = [];
           var oldDocRanges = [];

package/dist/cjs/ui/type-ahead/index.js

@@ -16,6 +16,7 @@ var _messages = require("@atlaskit/editor-common/messages");
 var _typeAhead = require("@atlaskit/editor-common/type-ahead");
 var _model = require("@atlaskit/editor-prosemirror/model");
 var _utils = require("@atlaskit/editor-prosemirror/utils");
+var _lozenge = _interopRequireDefault(require("@atlaskit/lozenge"));
 var _item = require("@atlaskit/mention/item");
 var _resource = require("@atlaskit/mention/resource");
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
@@ -240,17 +241,77 @@ var buildNodesForTeamMention = function buildNodesForTeamMention(schema, selecte
   inlineNodes.push(closeBracketText);
   return _model.Fragment.fromArray(inlineNodes);
 };
-var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
-  var sanitizePrivateContent = _ref6.sanitizePrivateContent,
-    mentionInsertDisplayName = _ref6.mentionInsertDisplayName,
-    fireEvent = _ref6.fireEvent,
-    HighlightComponent = _ref6.HighlightComponent,
-    api = _ref6.api,
-    handleMentionsChanged = _ref6.handleMentionsChanged;
+/**
+ * Shared mentions → typeahead-items transformer used by both the
+ * single-shot `getItems` Promise path and the multi-emit
+ * `subscribeToItemsUpdates` path. Factoring this out avoids any
+ * chance the two paths drift in subtle item-shape behaviour (invite
+ * item injection, analytics emission, no-results bookkeeping).
+ *
+ * NOTE: `firstQueryWithoutResults` is captured by closure in
+ * `createTypeAheadConfig` and intentionally mutated here as a
+ * side-effect — preserves the existing single-shot semantics.
+ */
+var makeTransformMentionsToTypeAheadItems = function makeTransformMentionsToTypeAheadItems(_ref6) {
+  var fireEvent = _ref6.fireEvent,
+    getFirstQueryWithoutResults = _ref6.getFirstQueryWithoutResults,
+    setFirstQueryWithoutResults = _ref6.setFirstQueryWithoutResults;
+  return function (_ref7) {
+    var mentions = _ref7.mentions,
+      query = _ref7.query,
+      stats = _ref7.stats,
+      mentionProvider = _ref7.mentionProvider,
+      contextIdentifierProvider = _ref7.contextIdentifierProvider,
+      sessionId = _ref7.sessionId;
+    var mentionItems = mentions.map(function (mention) {
+      return memoizedToItem.call(mention);
+    });
+    buildAndSendElementsTypeAheadAnalytics(fireEvent)({
+      query: query,
+      mentions: mentions,
+      stats: stats
+    });
+    if (mentions.length === 0 && getFirstQueryWithoutResults() === null) {
+      setFirstQueryWithoutResults(query);
+    }
+    if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
+      return mentionItems;
+    }
+    var emailDomain = mentionProvider.userEmailDomain;
+    return withInviteItem({
+      mentionProvider: mentionProvider,
+      firstQueryWithoutResults: getFirstQueryWithoutResults() || '',
+      currentQuery: query,
+      onInviteItemMount: function onInviteItemMount() {
+        var _mentionProvider$getS2;
+        fireEvent((0, _analytics.buildTypeAheadInviteItemViewedPayload)(sessionId, contextIdentifierProvider, mentionProvider.userRole, (0, _platformFeatureFlags.fg)('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
+          isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
+        } : {}));
+      },
+      emailDomain: emailDomain
+    })(mentionItems);
+  };
+};
+var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeAheadConfig(_ref8) {
+  var sanitizePrivateContent = _ref8.sanitizePrivateContent,
+    mentionInsertDisplayName = _ref8.mentionInsertDisplayName,
+    fireEvent = _ref8.fireEvent,
+    HighlightComponent = _ref8.HighlightComponent,
+    api = _ref8.api,
+    handleMentionsChanged = _ref8.handleMentionsChanged;
   // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
   var sessionId = (0, _uuid.default)();
   var firstQueryWithoutResults = null;
   var subscriptionKeys = new Set();
+  var transformMentionsToTypeAheadItems = makeTransformMentionsToTypeAheadItems({
+    fireEvent: fireEvent,
+    getFirstQueryWithoutResults: function getFirstQueryWithoutResults() {
+      return firstQueryWithoutResults;
+    },
+    setFirstQueryWithoutResults: function setFirstQueryWithoutResults(query) {
+      firstQueryWithoutResults = query;
+    }
+  });
   var typeAhead = {
     id: _typeAhead.TypeAheadAvailableNodes.MENTION,
     trigger: '@',
@@ -264,17 +325,17 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
       }
       return null;
     },
-    getItems: function getItems(_ref7) {
+    getItems: function getItems(_ref9) {
       var _api$contextIdentifie, _api$contextIdentifie2;
-      var query = _ref7.query,
-        editorState = _ref7.editorState;
+      var query = _ref9.query,
+        editorState = _ref9.editorState;
       var pluginState = (0, _utils2.getMentionPluginState)(editorState);
       if (!(pluginState !== null && pluginState !== void 0 && pluginState.mentionProvider)) {
         return Promise.resolve([]);
       }
       var mentionProvider = pluginState.mentionProvider;
-      var _ref8 = (_api$contextIdentifie = api === null || api === void 0 || (_api$contextIdentifie2 = api.contextIdentifier) === null || _api$contextIdentifie2 === void 0 ? void 0 : _api$contextIdentifie2.sharedState.currentState()) !== null && _api$contextIdentifie !== void 0 ? _api$contextIdentifie : {},
-        contextIdentifierProvider = _ref8.contextIdentifierProvider;
+      var _ref0 = (_api$contextIdentifie = api === null || api === void 0 || (_api$contextIdentifie2 = api.contextIdentifier) === null || _api$contextIdentifie2 === void 0 ? void 0 : _api$contextIdentifie2.sharedState.currentState()) !== null && _api$contextIdentifie !== void 0 ? _api$contextIdentifie : {},
+        contextIdentifierProvider = _ref0.contextIdentifierProvider;
       return new Promise(function (resolve, reject) {
         // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
         var key = "loadingMentionsForTypeAhead_".concat((0, _uuid.default)());
@@ -286,35 +347,15 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
           }
           mentionProvider.unsubscribe(key);
           subscriptionKeys.delete(key);
-          var mentionItems = mentions.map(function (mention) {
-            return memoizedToItem.call(mention);
-          });
-          buildAndSendElementsTypeAheadAnalytics(fireEvent)({
-            query: query,
+          var items = transformMentionsToTypeAheadItems({
             mentions: mentions,
-            stats: stats
+            query: query,
+            stats: stats,
+            mentionProvider: mentionProvider,
+            contextIdentifierProvider: contextIdentifierProvider,
+            sessionId: sessionId
           });
-          if (mentions.length === 0 && firstQueryWithoutResults === null) {
-            firstQueryWithoutResults = query;
-          }
-          if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
-            resolve(mentionItems);
-          } else {
-            var emailDomain = mentionProvider.userEmailDomain;
-            var items = withInviteItem({
-              mentionProvider: mentionProvider,
-              firstQueryWithoutResults: firstQueryWithoutResults || '',
-              currentQuery: query,
-              onInviteItemMount: function onInviteItemMount() {
-                var _mentionProvider$getS2;
-                fireEvent((0, _analytics.buildTypeAheadInviteItemViewedPayload)(sessionId, contextIdentifierProvider, mentionProvider.userRole, (0, _platformFeatureFlags.fg)('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
-                  isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
-                } : {}));
-              },
-              emailDomain: emailDomain
-            })(mentionItems);
-            resolve(items);
-          }
+          resolve(items);
         };
         subscriptionKeys.add(key);
         mentionProvider.subscribe(key, mentionsSubscribeCallback, function () {
@@ -329,8 +370,8 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
         }));
       });
     },
-    getSections: function getSections(_ref9) {
-      var intl = _ref9.intl;
+    getSections: function getSections(_ref1) {
+      var intl = _ref1.intl;
       return [_objectSpread({
         id: 'people',
         title: intl.formatMessage(_messages.mentionMessages.typeAheadSectionPeople),
@@ -343,7 +384,7 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
           showWhenQueryPresent: false,
           showWhenOnlySection: true
         }
-      } : {}), _objectSpread({
+      } : {}), _objectSpread(_objectSpread({
         id: 'agents',
         title: intl.formatMessage(_messages.mentionMessages.typeAheadSectionAgents),
         filter: function filter(item) {
@@ -355,17 +396,21 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
           showWhenQueryPresent: false,
           showWhenOnlySection: true
         }
+      } : {}), (0, _expVal.expVal)('platform_editor_agent_mentions', 'isEnabled', false) ? {
+        lozenge: /*#__PURE__*/_react.default.createElement(_lozenge.default, {
+          appearance: "new"
+        }, intl.formatMessage(_messages.mentionMessages.typeAheadSectionAgentsLabs))
       } : {})];
     },
     onOpen: function onOpen() {
       firstQueryWithoutResults = null;
     },
-    selectItem: function selectItem(state, item, insert, _ref0) {
+    selectItem: function selectItem(state, item, insert, _ref10) {
       var _api$contextIdentifie3, _api$contextIdentifie4;
-      var mode = _ref0.mode,
-        stats = _ref0.stats,
-        query = _ref0.query,
-        sourceListItem = _ref0.sourceListItem;
+      var mode = _ref10.mode,
+        stats = _ref10.stats,
+        query = _ref10.query,
+        sourceListItem = _ref10.sourceListItem;
       var schema = state.schema;
       var pluginState = (0, _utils2.getMentionPluginState)(state);
       var mentionProvider = pluginState.mentionProvider;
@@ -376,8 +421,8 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
         accessLevel = _item$mention.accessLevel,
         userType = _item$mention.userType,
         isXProductUser = _item$mention.isXProductUser;
-      var _ref1 = (_api$contextIdentifie3 = api === null || api === void 0 || (_api$contextIdentifie4 = api.contextIdentifier) === null || _api$contextIdentifie4 === void 0 ? void 0 : _api$contextIdentifie4.sharedState.currentState()) !== null && _api$contextIdentifie3 !== void 0 ? _api$contextIdentifie3 : {},
-        contextIdentifierProvider = _ref1.contextIdentifierProvider;
+      var _ref11 = (_api$contextIdentifie3 = api === null || api === void 0 || (_api$contextIdentifie4 = api.contextIdentifier) === null || _api$contextIdentifie4 === void 0 ? void 0 : _api$contextIdentifie4.sharedState.currentState()) !== null && _api$contextIdentifie3 !== void 0 ? _api$contextIdentifie3 : {},
+        contextIdentifierProvider = _ref11.contextIdentifierProvider;
       var mentionContext = _objectSpread(_objectSpread({}, contextIdentifierProvider), {}, {
         sessionId: sessionId
       });
@@ -490,11 +535,11 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
       }
       return tr;
     },
-    dismiss: function dismiss(_ref10) {
-      var editorState = _ref10.editorState,
-        query = _ref10.query,
-        stats = _ref10.stats,
-        wasItemInserted = _ref10.wasItemInserted;
+    dismiss: function dismiss(_ref12) {
+      var editorState = _ref12.editorState,
+        query = _ref12.query,
+        stats = _ref12.stats,
+        wasItemInserted = _ref12.wasItemInserted;
       firstQueryWithoutResults = null;
       var pickerElapsedTime = stats.startedAt ? performance.now() - stats.startedAt : 0;
       if (!wasItemInserted) {
@@ -522,5 +567,122 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
       sessionId = (0, _uuid.default)();
     }
   };
+
+  /**
+   * Opt-in multi-emit path. Subscribes to the provider's stream of
+   * results for the lifetime of the type-ahead session — does NOT
+   * unsubscribe after the first emission. Lets providers like
+   * `RovoChatMentionResource` deliver people-first then merged
+   * people + agents to the dropdown without the typeahead dropping
+   * the second emission on the floor.
+   *
+   * Gated behind `rovo_chat_agent_selection` (the same gate that drives
+   * agent mentions in the Rovo chat input). The generic type-ahead hook
+   * opts a handler into streaming purely by the presence of this method,
+   * so we only attach it when the gate is on — otherwise the proven
+   * single-shot `getItems` path continues to drive every consumer.
+   */
+  var subscribeToItemsUpdates = function subscribeToItemsUpdates(_ref13) {
+    var _api$contextIdentifie5, _api$contextIdentifie6;
+    var query = _ref13.query,
+      editorState = _ref13.editorState;
+    var pluginState = (0, _utils2.getMentionPluginState)(editorState);
+    if (!(pluginState !== null && pluginState !== void 0 && pluginState.mentionProvider)) {
+      return {
+        initial: Promise.resolve([]),
+        subscribe: function subscribe() {
+          return function () {};
+        }
+      };
+    }
+    var mentionProvider = pluginState.mentionProvider;
+    var _ref14 = (_api$contextIdentifie5 = api === null || api === void 0 || (_api$contextIdentifie6 = api.contextIdentifier) === null || _api$contextIdentifie6 === void 0 ? void 0 : _api$contextIdentifie6.sharedState.currentState()) !== null && _api$contextIdentifie5 !== void 0 ? _api$contextIdentifie5 : {},
+      contextIdentifierProvider = _ref14.contextIdentifierProvider;
+
+    // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
+    var key = "loadingMentionsForTypeAhead_".concat((0, _uuid.default)());
+    var initialResolve = null;
+    var initialReject = null;
+    var initialResolved = false;
+    var updateCallback = null;
+    var unsubscribed = false;
+    var initial = new Promise(function (resolve, reject) {
+      initialResolve = resolve;
+      initialReject = reject;
+    });
+    var mentionsSubscribeCallback = function mentionsSubscribeCallback(mentions) {
+      var resultQuery = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+      var stats = arguments.length > 2 ? arguments[2] : undefined;
+      // Drop emissions tagged with a query that has moved on.
+      // Mirrors the same guard in the single-shot `getItems`.
+      if (query !== resultQuery) {
+        return;
+      }
+      if (unsubscribed) {
+        return;
+      }
+      var items = transformMentionsToTypeAheadItems({
+        mentions: mentions,
+        query: query,
+        stats: stats,
+        mentionProvider: mentionProvider,
+        contextIdentifierProvider: contextIdentifierProvider,
+        sessionId: sessionId
+      });
+      if (!initialResolved) {
+        var _initialResolve;
+        initialResolved = true;
+        (_initialResolve = initialResolve) === null || _initialResolve === void 0 || _initialResolve(items);
+      } else {
+        var _updateCallback;
+        (_updateCallback = updateCallback) === null || _updateCallback === void 0 || _updateCallback(items);
+      }
+    };
+    subscriptionKeys.add(key);
+    mentionProvider.subscribe(key, mentionsSubscribeCallback, function () {
+      if ((0, _experiments.editorExperiment)('platform_editor_offline_editing_web', true)) {
+        mentionProvider.unsubscribe(key);
+        subscriptionKeys.delete(key);
+        if (!initialResolved) {
+          var _initialReject;
+          initialResolved = true;
+          (_initialReject = initialReject) === null || _initialReject === void 0 || _initialReject('FETCH_ERROR');
+        }
+      }
+    });
+    mentionProvider.filter(query || '', _objectSpread(_objectSpread({}, contextIdentifierProvider), {}, {
+      sessionId: sessionId
+    }));
+    return {
+      initial: initial,
+      subscribe: function subscribe(update) {
+        if (updateCallback) {
+          throw new Error('TypeAhead mention updates support only one subscriber');
+        }
+        updateCallback = update;
+        return function () {
+          unsubscribed = true;
+          updateCallback = null;
+          mentionProvider.unsubscribe(key);
+          subscriptionKeys.delete(key);
+          // If cleanup runs before the first emission, settle the initial
+          // promise so its `.then` chain (and the closures it holds) is
+          // released instead of pending forever.
+          if (!initialResolved) {
+            var _initialResolve2;
+            initialResolved = true;
+            (_initialResolve2 = initialResolve) === null || _initialResolve2 === void 0 || _initialResolve2([]);
+          }
+        };
+      }
+    };
+  };
+
+  // Presence of `subscribeToItemsUpdates` is how the type-ahead hook
+  // opts a handler into the multi-emit path, so only expose it when the
+  // agent-selection gate is on.
+  if ((0, _platformFeatureFlags.fg)('rovo_chat_agent_selection')) {
+    typeAhead.subscribeToItemsUpdates = subscribeToItemsUpdates;
+  }
   return typeAhead;
 };

package/dist/es2019/pm-plugins/main.js

@@ -24,7 +24,7 @@ const isAgentUserType = userType => {
 const AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 const AGENT_MENTION_INACTIVITY_MS = 3000;
 const PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-const PACKAGE_VERSION = "14.2.2";
+const PACKAGE_VERSION = "14.3.0";
 const setProvider = provider => (state, dispatch) => {
   if (dispatch) {
     dispatch(state.tr.setMeta(mentionPluginKey, {
@@ -333,8 +333,7 @@ export function createMentionPlugin({
           }
           (_insm$session2 = insm.session) === null || _insm$session2 === void 0 ? void 0 : _insm$session2.endFeature('mentionDeletionDetection');
         }
-        const isAIStreaming = Boolean(tr.getMeta(AI_STREAMING_TRANSFORMATION_META_KEY));
-        if (tr.docChanged && !tr.getMeta('replaceDocument') && !isAIStreaming && isAgentMentionsExperimentEnabled) {
+        if (isAgentMentionsExperimentEnabled && isQualifyingLocalUserDocChange(tr)) {
           const mentionSchema = newState.schema.nodes.mention;
           const newDocRanges = [];
           const oldDocRanges = [];

package/dist/es2019/ui/type-ahead/index.js

@@ -6,6 +6,7 @@ import { mentionMessages } from '@atlaskit/editor-common/messages';
 import { TypeAheadAvailableNodes } from '@atlaskit/editor-common/type-ahead';
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
 import { findParentNodeOfType } from '@atlaskit/editor-prosemirror/utils';
+import Lozenge from '@atlaskit/lozenge';
 import { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED, MentionItem } from '@atlaskit/mention/item';
 import { isResolvingMentionProvider } from '@atlaskit/mention/resource';
 import { fg } from '@atlaskit/platform-feature-flags';
@@ -213,6 +214,57 @@ const buildNodesForTeamMention = (schema, selectedMention, mentionProvider, sani
   inlineNodes.push(closeBracketText);
   return Fragment.fromArray(inlineNodes);
 };
+/**
+ * Shared mentions → typeahead-items transformer used by both the
+ * single-shot `getItems` Promise path and the multi-emit
+ * `subscribeToItemsUpdates` path. Factoring this out avoids any
+ * chance the two paths drift in subtle item-shape behaviour (invite
+ * item injection, analytics emission, no-results bookkeeping).
+ *
+ * NOTE: `firstQueryWithoutResults` is captured by closure in
+ * `createTypeAheadConfig` and intentionally mutated here as a
+ * side-effect — preserves the existing single-shot semantics.
+ */
+const makeTransformMentionsToTypeAheadItems = ({
+  fireEvent,
+  getFirstQueryWithoutResults,
+  setFirstQueryWithoutResults
+}) => {
+  return ({
+    mentions,
+    query,
+    stats,
+    mentionProvider,
+    contextIdentifierProvider,
+    sessionId
+  }) => {
+    const mentionItems = mentions.map(mention => memoizedToItem.call(mention));
+    buildAndSendElementsTypeAheadAnalytics(fireEvent)({
+      query,
+      mentions,
+      stats
+    });
+    if (mentions.length === 0 && getFirstQueryWithoutResults() === null) {
+      setFirstQueryWithoutResults(query);
+    }
+    if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
+      return mentionItems;
+    }
+    const emailDomain = mentionProvider.userEmailDomain;
+    return withInviteItem({
+      mentionProvider,
+      firstQueryWithoutResults: getFirstQueryWithoutResults() || '',
+      currentQuery: query,
+      onInviteItemMount: () => {
+        var _mentionProvider$getS2;
+        fireEvent(buildTypeAheadInviteItemViewedPayload(sessionId, contextIdentifierProvider, mentionProvider.userRole, fg('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
+          isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
+        } : {}));
+      },
+      emailDomain
+    })(mentionItems);
+  };
+};
 export const createTypeAheadConfig = ({
   sanitizePrivateContent,
   mentionInsertDisplayName,
@@ -225,6 +277,13 @@ export const createTypeAheadConfig = ({
   let sessionId = uuid();
   let firstQueryWithoutResults = null;
   const subscriptionKeys = new Set();
+  const transformMentionsToTypeAheadItems = makeTransformMentionsToTypeAheadItems({
+    fireEvent,
+    getFirstQueryWithoutResults: () => firstQueryWithoutResults,
+    setFirstQueryWithoutResults: query => {
+      firstQueryWithoutResults = query;
+    }
+  });
   const typeAhead = {
     id: TypeAheadAvailableNodes.MENTION,
     trigger: '@',
@@ -262,33 +321,15 @@ export const createTypeAheadConfig = ({
           }
           mentionProvider.unsubscribe(key);
           subscriptionKeys.delete(key);
-          const mentionItems = mentions.map(mention => memoizedToItem.call(mention));
-          buildAndSendElementsTypeAheadAnalytics(fireEvent)({
-            query,
+          const items = transformMentionsToTypeAheadItems({
             mentions,
-            stats
+            query,
+            stats,
+            mentionProvider,
+            contextIdentifierProvider,
+            sessionId
           });
-          if (mentions.length === 0 && firstQueryWithoutResults === null) {
-            firstQueryWithoutResults = query;
-          }
-          if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
-            resolve(mentionItems);
-          } else {
-            const emailDomain = mentionProvider.userEmailDomain;
-            const items = withInviteItem({
-              mentionProvider,
-              firstQueryWithoutResults: firstQueryWithoutResults || '',
-              currentQuery: query,
-              onInviteItemMount: () => {
-                var _mentionProvider$getS2;
-                fireEvent(buildTypeAheadInviteItemViewedPayload(sessionId, contextIdentifierProvider, mentionProvider.userRole, fg('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
-                  isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
-                } : {}));
-              },
-              emailDomain
-            })(mentionItems);
-            resolve(items);
-          }
+          resolve(items);
         };
         subscriptionKeys.add(key);
         mentionProvider.subscribe(key, mentionsSubscribeCallback, () => {
@@ -328,6 +369,11 @@ export const createTypeAheadConfig = ({
             showWhenQueryPresent: false,
             showWhenOnlySection: true
           }
+        } : {}),
+        ...(expVal('platform_editor_agent_mentions', 'isEnabled', false) ? {
+          lozenge: /*#__PURE__*/React.createElement(Lozenge, {
+            appearance: "new"
+          }, intl.formatMessage(mentionMessages.typeAheadSectionAgentsLabs))
         } : {})
       }];
     },
@@ -498,5 +544,123 @@ export const createTypeAheadConfig = ({
       sessionId = uuid();
     }
   };
+
+  /**
+   * Opt-in multi-emit path. Subscribes to the provider's stream of
+   * results for the lifetime of the type-ahead session — does NOT
+   * unsubscribe after the first emission. Lets providers like
+   * `RovoChatMentionResource` deliver people-first then merged
+   * people + agents to the dropdown without the typeahead dropping
+   * the second emission on the floor.
+   *
+   * Gated behind `rovo_chat_agent_selection` (the same gate that drives
+   * agent mentions in the Rovo chat input). The generic type-ahead hook
+   * opts a handler into streaming purely by the presence of this method,
+   * so we only attach it when the gate is on — otherwise the proven
+   * single-shot `getItems` path continues to drive every consumer.
+   */
+  const subscribeToItemsUpdates = ({
+    query,
+    editorState
+  }) => {
+    var _api$contextIdentifie5, _api$contextIdentifie6;
+    const pluginState = getMentionPluginState(editorState);
+    if (!(pluginState !== null && pluginState !== void 0 && pluginState.mentionProvider)) {
+      return {
+        initial: Promise.resolve([]),
+        subscribe: () => () => {}
+      };
+    }
+    const {
+      mentionProvider
+    } = pluginState;
+    const {
+      contextIdentifierProvider
+    } = (_api$contextIdentifie5 = api === null || api === void 0 ? void 0 : (_api$contextIdentifie6 = api.contextIdentifier) === null || _api$contextIdentifie6 === void 0 ? void 0 : _api$contextIdentifie6.sharedState.currentState()) !== null && _api$contextIdentifie5 !== void 0 ? _api$contextIdentifie5 : {};
+
+    // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
+    const key = `loadingMentionsForTypeAhead_${uuid()}`;
+    let initialResolve = null;
+    let initialReject = null;
+    let initialResolved = false;
+    let updateCallback = null;
+    let unsubscribed = false;
+    const initial = new Promise((resolve, reject) => {
+      initialResolve = resolve;
+      initialReject = reject;
+    });
+    const mentionsSubscribeCallback = (mentions, resultQuery = '', stats) => {
+      // Drop emissions tagged with a query that has moved on.
+      // Mirrors the same guard in the single-shot `getItems`.
+      if (query !== resultQuery) {
+        return;
+      }
+      if (unsubscribed) {
+        return;
+      }
+      const items = transformMentionsToTypeAheadItems({
+        mentions,
+        query,
+        stats,
+        mentionProvider,
+        contextIdentifierProvider,
+        sessionId
+      });
+      if (!initialResolved) {
+        var _initialResolve;
+        initialResolved = true;
+        (_initialResolve = initialResolve) === null || _initialResolve === void 0 ? void 0 : _initialResolve(items);
+      } else {
+        var _updateCallback;
+        (_updateCallback = updateCallback) === null || _updateCallback === void 0 ? void 0 : _updateCallback(items);
+      }
+    };
+    subscriptionKeys.add(key);
+    mentionProvider.subscribe(key, mentionsSubscribeCallback, () => {
+      if (editorExperiment('platform_editor_offline_editing_web', true)) {
+        mentionProvider.unsubscribe(key);
+        subscriptionKeys.delete(key);
+        if (!initialResolved) {
+          var _initialReject;
+          initialResolved = true;
+          (_initialReject = initialReject) === null || _initialReject === void 0 ? void 0 : _initialReject('FETCH_ERROR');
+        }
+      }
+    });
+    mentionProvider.filter(query || '', {
+      ...contextIdentifierProvider,
+      sessionId
+    });
+    return {
+      initial,
+      subscribe: update => {
+        if (updateCallback) {
+          throw new Error('TypeAhead mention updates support only one subscriber');
+        }
+        updateCallback = update;
+        return () => {
+          unsubscribed = true;
+          updateCallback = null;
+          mentionProvider.unsubscribe(key);
+          subscriptionKeys.delete(key);
+          // If cleanup runs before the first emission, settle the initial
+          // promise so its `.then` chain (and the closures it holds) is
+          // released instead of pending forever.
+          if (!initialResolved) {
+            var _initialResolve2;
+            initialResolved = true;
+            (_initialResolve2 = initialResolve) === null || _initialResolve2 === void 0 ? void 0 : _initialResolve2([]);
+          }
+        };
+      }
+    };
+  };
+
+  // Presence of `subscribeToItemsUpdates` is how the type-ahead hook
+  // opts a handler into the multi-emit path, so only expose it when the
+  // agent-selection gate is on.
+  if (fg('rovo_chat_agent_selection')) {
+    typeAhead.subscribeToItemsUpdates = subscribeToItemsUpdates;
+  }
   return typeAhead;
 };

package/dist/esm/pm-plugins/main.js

@@ -31,7 +31,7 @@ var isAgentUserType = function isAgentUserType(userType) {
 var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var AGENT_MENTION_INACTIVITY_MS = 3000;
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "14.2.2";
+var PACKAGE_VERSION = "14.3.0";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -347,8 +347,7 @@ export function createMentionPlugin(_ref2) {
           }
           (_insm$session2 = insm.session) === null || _insm$session2 === void 0 || _insm$session2.endFeature('mentionDeletionDetection');
         }
-        var isAIStreaming = Boolean(tr.getMeta(AI_STREAMING_TRANSFORMATION_META_KEY));
-        if (tr.docChanged && !tr.getMeta('replaceDocument') && !isAIStreaming && isAgentMentionsExperimentEnabled) {
+        if (isAgentMentionsExperimentEnabled && isQualifyingLocalUserDocChange(tr)) {
           var _mentionSchema = newState.schema.nodes.mention;
           var newDocRanges = [];
           var oldDocRanges = [];

package/dist/esm/ui/type-ahead/index.js

@@ -13,6 +13,7 @@ import { mentionMessages } from '@atlaskit/editor-common/messages';
 import { TypeAheadAvailableNodes } from '@atlaskit/editor-common/type-ahead';
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
 import { findParentNodeOfType } from '@atlaskit/editor-prosemirror/utils';
+import Lozenge from '@atlaskit/lozenge';
 import { MENTION_ITEM_HEIGHT, MENTION_ITEM_HEIGHT_REFRESHED, MentionItem } from '@atlaskit/mention/item';
 import { isResolvingMentionProvider } from '@atlaskit/mention/resource';
 import { fg } from '@atlaskit/platform-feature-flags';
@@ -231,17 +232,77 @@ var buildNodesForTeamMention = function buildNodesForTeamMention(schema, selecte
   inlineNodes.push(closeBracketText);
   return Fragment.fromArray(inlineNodes);
 };
-export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
-  var sanitizePrivateContent = _ref6.sanitizePrivateContent,
-    mentionInsertDisplayName = _ref6.mentionInsertDisplayName,
-    fireEvent = _ref6.fireEvent,
-    HighlightComponent = _ref6.HighlightComponent,
-    api = _ref6.api,
-    handleMentionsChanged = _ref6.handleMentionsChanged;
+/**
+ * Shared mentions → typeahead-items transformer used by both the
+ * single-shot `getItems` Promise path and the multi-emit
+ * `subscribeToItemsUpdates` path. Factoring this out avoids any
+ * chance the two paths drift in subtle item-shape behaviour (invite
+ * item injection, analytics emission, no-results bookkeeping).
+ *
+ * NOTE: `firstQueryWithoutResults` is captured by closure in
+ * `createTypeAheadConfig` and intentionally mutated here as a
+ * side-effect — preserves the existing single-shot semantics.
+ */
+var makeTransformMentionsToTypeAheadItems = function makeTransformMentionsToTypeAheadItems(_ref6) {
+  var fireEvent = _ref6.fireEvent,
+    getFirstQueryWithoutResults = _ref6.getFirstQueryWithoutResults,
+    setFirstQueryWithoutResults = _ref6.setFirstQueryWithoutResults;
+  return function (_ref7) {
+    var mentions = _ref7.mentions,
+      query = _ref7.query,
+      stats = _ref7.stats,
+      mentionProvider = _ref7.mentionProvider,
+      contextIdentifierProvider = _ref7.contextIdentifierProvider,
+      sessionId = _ref7.sessionId;
+    var mentionItems = mentions.map(function (mention) {
+      return memoizedToItem.call(mention);
+    });
+    buildAndSendElementsTypeAheadAnalytics(fireEvent)({
+      query: query,
+      mentions: mentions,
+      stats: stats
+    });
+    if (mentions.length === 0 && getFirstQueryWithoutResults() === null) {
+      setFirstQueryWithoutResults(query);
+    }
+    if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
+      return mentionItems;
+    }
+    var emailDomain = mentionProvider.userEmailDomain;
+    return withInviteItem({
+      mentionProvider: mentionProvider,
+      firstQueryWithoutResults: getFirstQueryWithoutResults() || '',
+      currentQuery: query,
+      onInviteItemMount: function onInviteItemMount() {
+        var _mentionProvider$getS2;
+        fireEvent(buildTypeAheadInviteItemViewedPayload(sessionId, contextIdentifierProvider, mentionProvider.userRole, fg('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
+          isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
+        } : {}));
+      },
+      emailDomain: emailDomain
+    })(mentionItems);
+  };
+};
+export var createTypeAheadConfig = function createTypeAheadConfig(_ref8) {
+  var sanitizePrivateContent = _ref8.sanitizePrivateContent,
+    mentionInsertDisplayName = _ref8.mentionInsertDisplayName,
+    fireEvent = _ref8.fireEvent,
+    HighlightComponent = _ref8.HighlightComponent,
+    api = _ref8.api,
+    handleMentionsChanged = _ref8.handleMentionsChanged;
   // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
   var sessionId = uuid();
   var firstQueryWithoutResults = null;
   var subscriptionKeys = new Set();
+  var transformMentionsToTypeAheadItems = makeTransformMentionsToTypeAheadItems({
+    fireEvent: fireEvent,
+    getFirstQueryWithoutResults: function getFirstQueryWithoutResults() {
+      return firstQueryWithoutResults;
+    },
+    setFirstQueryWithoutResults: function setFirstQueryWithoutResults(query) {
+      firstQueryWithoutResults = query;
+    }
+  });
   var typeAhead = {
     id: TypeAheadAvailableNodes.MENTION,
     trigger: '@',
@@ -255,17 +316,17 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
       }
       return null;
     },
-    getItems: function getItems(_ref7) {
+    getItems: function getItems(_ref9) {
       var _api$contextIdentifie, _api$contextIdentifie2;
-      var query = _ref7.query,
-        editorState = _ref7.editorState;
+      var query = _ref9.query,
+        editorState = _ref9.editorState;
       var pluginState = getMentionPluginState(editorState);
       if (!(pluginState !== null && pluginState !== void 0 && pluginState.mentionProvider)) {
         return Promise.resolve([]);
       }
       var mentionProvider = pluginState.mentionProvider;
-      var _ref8 = (_api$contextIdentifie = api === null || api === void 0 || (_api$contextIdentifie2 = api.contextIdentifier) === null || _api$contextIdentifie2 === void 0 ? void 0 : _api$contextIdentifie2.sharedState.currentState()) !== null && _api$contextIdentifie !== void 0 ? _api$contextIdentifie : {},
-        contextIdentifierProvider = _ref8.contextIdentifierProvider;
+      var _ref0 = (_api$contextIdentifie = api === null || api === void 0 || (_api$contextIdentifie2 = api.contextIdentifier) === null || _api$contextIdentifie2 === void 0 ? void 0 : _api$contextIdentifie2.sharedState.currentState()) !== null && _api$contextIdentifie !== void 0 ? _api$contextIdentifie : {},
+        contextIdentifierProvider = _ref0.contextIdentifierProvider;
       return new Promise(function (resolve, reject) {
         // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
         var key = "loadingMentionsForTypeAhead_".concat(uuid());
@@ -277,35 +338,15 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
           }
           mentionProvider.unsubscribe(key);
           subscriptionKeys.delete(key);
-          var mentionItems = mentions.map(function (mention) {
-            return memoizedToItem.call(mention);
-          });
-          buildAndSendElementsTypeAheadAnalytics(fireEvent)({
-            query: query,
+          var items = transformMentionsToTypeAheadItems({
             mentions: mentions,
-            stats: stats
+            query: query,
+            stats: stats,
+            mentionProvider: mentionProvider,
+            contextIdentifierProvider: contextIdentifierProvider,
+            sessionId: sessionId
           });
-          if (mentions.length === 0 && firstQueryWithoutResults === null) {
-            firstQueryWithoutResults = query;
-          }
-          if (!mentionProvider.shouldEnableInvite || mentionItems.length > 2) {
-            resolve(mentionItems);
-          } else {
-            var emailDomain = mentionProvider.userEmailDomain;
-            var items = withInviteItem({
-              mentionProvider: mentionProvider,
-              firstQueryWithoutResults: firstQueryWithoutResults || '',
-              currentQuery: query,
-              onInviteItemMount: function onInviteItemMount() {
-                var _mentionProvider$getS2;
-                fireEvent(buildTypeAheadInviteItemViewedPayload(sessionId, contextIdentifierProvider, mentionProvider.userRole, fg('jira_invites_auto_tag_new_user_in_mentions_fg') ? {
-                  isInlineInviteMentionsEnabled: (_mentionProvider$getS2 = mentionProvider.getShouldEnableInlineInvite) === null || _mentionProvider$getS2 === void 0 ? void 0 : _mentionProvider$getS2.call(mentionProvider)
-                } : {}));
-              },
-              emailDomain: emailDomain
-            })(mentionItems);
-            resolve(items);
-          }
+          resolve(items);
         };
         subscriptionKeys.add(key);
         mentionProvider.subscribe(key, mentionsSubscribeCallback, function () {
@@ -320,8 +361,8 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
         }));
       });
     },
-    getSections: function getSections(_ref9) {
-      var intl = _ref9.intl;
+    getSections: function getSections(_ref1) {
+      var intl = _ref1.intl;
       return [_objectSpread({
         id: 'people',
         title: intl.formatMessage(mentionMessages.typeAheadSectionPeople),
@@ -334,7 +375,7 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
           showWhenQueryPresent: false,
           showWhenOnlySection: true
         }
-      } : {}), _objectSpread({
+      } : {}), _objectSpread(_objectSpread({
         id: 'agents',
         title: intl.formatMessage(mentionMessages.typeAheadSectionAgents),
         filter: function filter(item) {
@@ -346,17 +387,21 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
           showWhenQueryPresent: false,
           showWhenOnlySection: true
         }
+      } : {}), expVal('platform_editor_agent_mentions', 'isEnabled', false) ? {
+        lozenge: /*#__PURE__*/React.createElement(Lozenge, {
+          appearance: "new"
+        }, intl.formatMessage(mentionMessages.typeAheadSectionAgentsLabs))
       } : {})];
     },
     onOpen: function onOpen() {
       firstQueryWithoutResults = null;
     },
-    selectItem: function selectItem(state, item, insert, _ref0) {
+    selectItem: function selectItem(state, item, insert, _ref10) {
       var _api$contextIdentifie3, _api$contextIdentifie4;
-      var mode = _ref0.mode,
-        stats = _ref0.stats,
-        query = _ref0.query,
-        sourceListItem = _ref0.sourceListItem;
+      var mode = _ref10.mode,
+        stats = _ref10.stats,
+        query = _ref10.query,
+        sourceListItem = _ref10.sourceListItem;
       var schema = state.schema;
       var pluginState = getMentionPluginState(state);
       var mentionProvider = pluginState.mentionProvider;
@@ -367,8 +412,8 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
         accessLevel = _item$mention.accessLevel,
         userType = _item$mention.userType,
         isXProductUser = _item$mention.isXProductUser;
-      var _ref1 = (_api$contextIdentifie3 = api === null || api === void 0 || (_api$contextIdentifie4 = api.contextIdentifier) === null || _api$contextIdentifie4 === void 0 ? void 0 : _api$contextIdentifie4.sharedState.currentState()) !== null && _api$contextIdentifie3 !== void 0 ? _api$contextIdentifie3 : {},
-        contextIdentifierProvider = _ref1.contextIdentifierProvider;
+      var _ref11 = (_api$contextIdentifie3 = api === null || api === void 0 || (_api$contextIdentifie4 = api.contextIdentifier) === null || _api$contextIdentifie4 === void 0 ? void 0 : _api$contextIdentifie4.sharedState.currentState()) !== null && _api$contextIdentifie3 !== void 0 ? _api$contextIdentifie3 : {},
+        contextIdentifierProvider = _ref11.contextIdentifierProvider;
       var mentionContext = _objectSpread(_objectSpread({}, contextIdentifierProvider), {}, {
         sessionId: sessionId
       });
@@ -481,11 +526,11 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
       }
       return tr;
     },
-    dismiss: function dismiss(_ref10) {
-      var editorState = _ref10.editorState,
-        query = _ref10.query,
-        stats = _ref10.stats,
-        wasItemInserted = _ref10.wasItemInserted;
+    dismiss: function dismiss(_ref12) {
+      var editorState = _ref12.editorState,
+        query = _ref12.query,
+        stats = _ref12.stats,
+        wasItemInserted = _ref12.wasItemInserted;
       firstQueryWithoutResults = null;
       var pickerElapsedTime = stats.startedAt ? performance.now() - stats.startedAt : 0;
       if (!wasItemInserted) {
@@ -513,5 +558,122 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref6) {
       sessionId = uuid();
     }
   };
+
+  /**
+   * Opt-in multi-emit path. Subscribes to the provider's stream of
+   * results for the lifetime of the type-ahead session — does NOT
+   * unsubscribe after the first emission. Lets providers like
+   * `RovoChatMentionResource` deliver people-first then merged
+   * people + agents to the dropdown without the typeahead dropping
+   * the second emission on the floor.
+   *
+   * Gated behind `rovo_chat_agent_selection` (the same gate that drives
+   * agent mentions in the Rovo chat input). The generic type-ahead hook
+   * opts a handler into streaming purely by the presence of this method,
+   * so we only attach it when the gate is on — otherwise the proven
+   * single-shot `getItems` path continues to drive every consumer.
+   */
+  var subscribeToItemsUpdates = function subscribeToItemsUpdates(_ref13) {
+    var _api$contextIdentifie5, _api$contextIdentifie6;
+    var query = _ref13.query,
+      editorState = _ref13.editorState;
+    var pluginState = getMentionPluginState(editorState);
+    if (!(pluginState !== null && pluginState !== void 0 && pluginState.mentionProvider)) {
+      return {
+        initial: Promise.resolve([]),
+        subscribe: function subscribe() {
+          return function () {};
+        }
+      };
+    }
+    var mentionProvider = pluginState.mentionProvider;
+    var _ref14 = (_api$contextIdentifie5 = api === null || api === void 0 || (_api$contextIdentifie6 = api.contextIdentifier) === null || _api$contextIdentifie6 === void 0 ? void 0 : _api$contextIdentifie6.sharedState.currentState()) !== null && _api$contextIdentifie5 !== void 0 ? _api$contextIdentifie5 : {},
+      contextIdentifierProvider = _ref14.contextIdentifierProvider;
+
+    // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
+    var key = "loadingMentionsForTypeAhead_".concat(uuid());
+    var initialResolve = null;
+    var initialReject = null;
+    var initialResolved = false;
+    var updateCallback = null;
+    var unsubscribed = false;
+    var initial = new Promise(function (resolve, reject) {
+      initialResolve = resolve;
+      initialReject = reject;
+    });
+    var mentionsSubscribeCallback = function mentionsSubscribeCallback(mentions) {
+      var resultQuery = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+      var stats = arguments.length > 2 ? arguments[2] : undefined;
+      // Drop emissions tagged with a query that has moved on.
+      // Mirrors the same guard in the single-shot `getItems`.
+      if (query !== resultQuery) {
+        return;
+      }
+      if (unsubscribed) {
+        return;
+      }
+      var items = transformMentionsToTypeAheadItems({
+        mentions: mentions,
+        query: query,
+        stats: stats,
+        mentionProvider: mentionProvider,
+        contextIdentifierProvider: contextIdentifierProvider,
+        sessionId: sessionId
+      });
+      if (!initialResolved) {
+        var _initialResolve;
+        initialResolved = true;
+        (_initialResolve = initialResolve) === null || _initialResolve === void 0 || _initialResolve(items);
+      } else {
+        var _updateCallback;
+        (_updateCallback = updateCallback) === null || _updateCallback === void 0 || _updateCallback(items);
+      }
+    };
+    subscriptionKeys.add(key);
+    mentionProvider.subscribe(key, mentionsSubscribeCallback, function () {
+      if (editorExperiment('platform_editor_offline_editing_web', true)) {
+        mentionProvider.unsubscribe(key);
+        subscriptionKeys.delete(key);
+        if (!initialResolved) {
+          var _initialReject;
+          initialResolved = true;
+          (_initialReject = initialReject) === null || _initialReject === void 0 || _initialReject('FETCH_ERROR');
+        }
+      }
+    });
+    mentionProvider.filter(query || '', _objectSpread(_objectSpread({}, contextIdentifierProvider), {}, {
+      sessionId: sessionId
+    }));
+    return {
+      initial: initial,
+      subscribe: function subscribe(update) {
+        if (updateCallback) {
+          throw new Error('TypeAhead mention updates support only one subscriber');
+        }
+        updateCallback = update;
+        return function () {
+          unsubscribed = true;
+          updateCallback = null;
+          mentionProvider.unsubscribe(key);
+          subscriptionKeys.delete(key);
+          // If cleanup runs before the first emission, settle the initial
+          // promise so its `.then` chain (and the closures it holds) is
+          // released instead of pending forever.
+          if (!initialResolved) {
+            var _initialResolve2;
+            initialResolved = true;
+            (_initialResolve2 = initialResolve) === null || _initialResolve2 === void 0 || _initialResolve2([]);
+          }
+        };
+      }
+    };
+  };
+
+  // Presence of `subscribeToItemsUpdates` is how the type-ahead hook
+  // opts a handler into the multi-emit path, so only expose it when the
+  // agent-selection gate is on.
+  if (fg('rovo_chat_agent_selection')) {
+    typeAhead.subscribeToItemsUpdates = subscribeToItemsUpdates;
+  }
   return typeAhead;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-mentions",
-	"version": "14.2.3",
+	"version": "14.4.0",
 	"description": "Mentions plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -27,12 +27,13 @@
 		"@atlaskit/editor-plugin-base": "^13.0.0",
 		"@atlaskit/editor-plugin-context-identifier": "^12.0.0",
 		"@atlaskit/editor-plugin-selection": "^12.0.0",
-		"@atlaskit/editor-plugin-type-ahead": "^12.0.0",
+		"@atlaskit/editor-plugin-type-ahead": "^12.1.0",
 		"@atlaskit/editor-prosemirror": "^8.0.0",
 		"@atlaskit/icon": "^36.0.0",
 		"@atlaskit/insm": "^1.0.0",
 		"@atlaskit/link": "^4.0.0",
-		"@atlaskit/mention": "^27.1.0",
+		"@atlaskit/lozenge": "^14.0.0",
+		"@atlaskit/mention": "^27.2.0",
 		"@atlaskit/platform-feature-flags": "^2.0.0",
 		"@atlaskit/popper": "^8.0.0",
 		"@atlaskit/portal": "^6.0.0",
@@ -40,10 +41,10 @@
 		"@atlaskit/profilecard": "^26.1.0",
 		"@atlaskit/teams-app-config": "^2.0.0",
 		"@atlaskit/theme": "^26.0.0",
-		"@atlaskit/tmp-editor-statsig": "^109.0.0",
-		"@atlaskit/tokens": "^14.0.0",
+		"@atlaskit/tmp-editor-statsig": "^110.0.0",
+		"@atlaskit/tokens": "^15.0.0",
 		"@atlaskit/tooltip": "^23.0.0",
-		"@atlaskit/user-picker": "^13.1.0",
+		"@atlaskit/user-picker": "^13.2.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
 		"bind-event-listener": "^3.0.0",
@@ -52,7 +53,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^116.6.0",
+		"@atlaskit/editor-common": "^116.11.0",
 		"react": "^18.2.0",
 		"react-dom": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"
@@ -61,7 +62,7 @@
 		"@testing-library/react": "^16.3.0",
 		"react": "^18.2.0",
 		"react-dom": "^18.2.0",
-		"react-intl": "^6.6.2",
+		"react-intl": "^7.0.0",
 		"wait-for-expect": "^1.2.0"
 	},
 	"techstack": {
@@ -119,6 +120,9 @@
 		},
 		"platform_editor_agent_mentions": {
 			"type": "boolean"
+		},
+		"rovo_chat_agent_selection": {
+			"type": "boolean"
 		}
 	}
 }