@atlaskit/editor-plugin-mentions 14.6.2 → 14.6.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atlaskit/editor-plugin-mentions
 
+## 14.6.4
+
+### Patch Changes
+
+- [`8634e07b0f9f5`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/8634e07b0f9f5) -
+  Fix agent name not showing in nudge on copy paste
+- Updated dependencies
+
+## 14.6.3
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 14.6.2
 
 ### Patch Changes

package/dist/cjs/mentionsPlugin.js

@@ -6,8 +6,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.mentionsPlugin = void 0;
-var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _react = _interopRequireWildcard(require("react"));
 var _reactIntl = require("react-intl");
@@ -27,9 +28,10 @@ var _mentionPlaceholder = require("./pm-plugins/mentionPlaceholder");
 var _InlineInviteRecaptchaContainer = require("./ui/InlineInviteRecaptchaContainer");
 var _SecondaryToolbarComponent = require("./ui/SecondaryToolbarComponent");
 var _typeAhead = require("./ui/type-ahead");
+var _excluded2 = ["pendingPastedAgentMention"]; // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 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; } // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
+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; }
 var processName = function processName(name, intl) {
   var unknownLabel = intl.formatMessage(_messages.mentionMessages.unknownLabel);
   if (name.status === _types.MentionNameStatus.OK) {
@@ -253,13 +255,19 @@ var mentionsPlugin = exports.mentionsPlugin = function mentionsPlugin(_ref3) {
         return undefined;
       }
       var mentionPluginState = _key.mentionPluginKey.getState(editorState);
-      return _objectSpread(_objectSpread({}, mentionPluginState), {}, {
+      // Exclude pendingPastedAgentMention — it is an @internal transient field and
+      // should not be part of the public shared state API. Exposing it would cause
+      // unnecessary re-renders in subscribers and leak implementation details.
+      var _ref8 = mentionPluginState !== null && mentionPluginState !== void 0 ? mentionPluginState : {},
+        _excluded = _ref8.pendingPastedAgentMention,
+        publicPluginState = (0, _objectWithoutProperties2.default)(_ref8, _excluded2);
+      return _objectSpread(_objectSpread({}, publicPluginState), {}, {
         typeAheadHandler: typeAhead
       });
     },
     pluginsOptions: {
-      quickInsert: function quickInsert(_ref8) {
-        var formatMessage = _ref8.formatMessage;
+      quickInsert: function quickInsert(_ref9) {
+        var formatMessage = _ref9.formatMessage;
         return [{
           id: 'mention',
           title: formatMessage(_messages.toolbarInsertBlockMessages.mention),

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.ACTIONS = void 0;
 exports.createMentionPlugin = createMentionPlugin;
+exports.resolveAndDispatchPastedAgentMentionName = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _analytics = require("@atlaskit/editor-common/analytics");
@@ -29,7 +30,19 @@ var ACTIONS = exports.ACTIONS = {
   COMMIT_PENDING_TYPED_AGENT_MENTION: 'COMMIT_PENDING_TYPED_AGENT_MENTION',
   DISCARD_PENDING_TYPED_AGENT_MENTION: 'DISCARD_PENDING_TYPED_AGENT_MENTION',
   SET_PENDING_TYPED_AGENT_MENTION: 'SET_PENDING_TYPED_AGENT_MENTION',
-  SET_PROVIDER: 'SET_PROVIDER'
+  SET_PROVIDER: 'SET_PROVIDER',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * for a pasted agent mention.
+   * Updates lastInsertedAgentMentionName so the nudge shows the correct name.
+   */
+  RESOLVE_PASTED_AGENT_MENTION_NAME: 'RESOLVE_PASTED_AGENT_MENTION_NAME',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * with a non-OK status for a pasted agent mention.
+   * Clears pendingPastedAgentMention so no retry loop occurs.
+   */
+  CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 
 // 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
@@ -53,7 +66,7 @@ var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var AGENT_MENTION_INACTIVITY_MS = 3000;
 var MAX_PENDING_TYPED_AGENT_MENTION_FOCUS_DEFERS = 20;
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "14.6.1";
+var PACKAGE_VERSION = "14.6.3";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -229,7 +242,7 @@ var commitPendingTypedAgentMention = function commitPendingTypedAgentMention(sta
   return commitResolvedPendingTypedAgentMention(pluginState, pendingMentionDetails);
 };
 var hasTrackedAgentMentionState = function hasTrackedAgentMentionState(pluginState) {
-  return Boolean(pluginState.pendingTypedAgentMention) || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
+  return Boolean(pluginState.pendingTypedAgentMention) || Boolean(pluginState.pendingPastedAgentMention) && (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes') || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
 };
 
 /**
@@ -238,8 +251,11 @@ var hasTrackedAgentMentionState = function hasTrackedAgentMentionState(pluginSta
  * lastInserted* details from the previous document must be cleared together.
  */
 var clearTrackedAgentMentionState = function clearTrackedAgentMentionState(pluginState) {
-  return _objectSpread(_objectSpread({}, pluginState), {}, {
-    pendingTypedAgentMention: null,
+  return _objectSpread(_objectSpread(_objectSpread({}, pluginState), {}, {
+    pendingTypedAgentMention: null
+  }, (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes') ? {
+    pendingPastedAgentMention: null
+  } : {}), {}, {
     lastInsertedAgentMentionId: null,
     lastInsertedAgentMentionLocalId: null,
     lastInsertedAgentMentionContext: null,
@@ -248,6 +264,88 @@ var clearTrackedAgentMentionState = function clearTrackedAgentMentionState(plugi
     lastInsertedAgentMentionParentNodeType: null
   });
 };
+
+/**
+ * Attempts to synchronously resolve an agent mention name from the mention
+ * provider's cache. Falls back to undefined if the provider doesn't support
+ * name resolution, the result is a Promise (async/cache miss), or the status
+ * is not OK.
+ */
+var resolveCachedAgentMentionName = function resolveCachedAgentMentionName(mentionProvider, params, id) {
+  if (params !== null && params !== void 0 && params.name || !(0, _resource.isResolvingMentionProvider)(mentionProvider)) {
+    var _params$name;
+    return (_params$name = params === null || params === void 0 ? void 0 : params.name) !== null && _params$name !== void 0 ? _params$name : undefined;
+  }
+  var result = mentionProvider.resolveMentionName(id);
+  if (!(result instanceof Promise) && result.status === _resource.MentionNameStatus.OK) {
+    return result.name || undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Resolves the name of a pasted agent mention via the mention provider and
+ * dispatches the appropriate action to update plugin state.
+ *
+ * Handles both async (Promise) and synchronous cache-hit results:
+ * - On OK resolution  → dispatches RESOLVE_PASTED_AGENT_MENTION_NAME so the nudge
+ *   shows the correct agent name.
+ * - On non-OK result  → dispatches CLEAR_PENDING_PASTED_AGENT_MENTION to prevent
+ *   an infinite retry loop on subsequent update() calls.
+ *
+ * Guards against duplicate in-flight requests via pendingResolveMentionIds.
+ */
+var resolveAndDispatchPastedAgentMentionName = exports.resolveAndDispatchPastedAgentMentionName = function resolveAndDispatchPastedAgentMentionName(agentId, mentionProvider, pendingResolveMentionIds, view) {
+  if (pendingResolveMentionIds.has(agentId)) {
+    return;
+  }
+  pendingResolveMentionIds.add(agentId);
+  var result = mentionProvider.resolveMentionName(agentId);
+  if (result instanceof Promise) {
+    result.then(function (nameDetails) {
+      pendingResolveMentionIds.delete(agentId);
+      if (nameDetails.status === _resource.MentionNameStatus.OK && nameDetails.name) {
+        view.dispatch(view.state.tr.setMeta(_key.mentionPluginKey, {
+          action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+          params: {
+            id: agentId,
+            name: nameDetails.name
+          }
+        }));
+      } else {
+        // Non-OK status — clear pendingPastedAgentMention to prevent
+        // an infinite retry loop on subsequent update() calls.
+        view.dispatch(view.state.tr.setMeta(_key.mentionPluginKey, {
+          action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+          params: {
+            id: agentId
+          }
+        }));
+      }
+    });
+  } else if (result.status === _resource.MentionNameStatus.OK && result.name) {
+    pendingResolveMentionIds.delete(agentId);
+    // Synchronous hit on a second update cycle (e.g. provider warmed up
+    // between the paste transaction and this view update).
+    view.dispatch(view.state.tr.setMeta(_key.mentionPluginKey, {
+      action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+      params: {
+        id: agentId,
+        name: result.name
+      }
+    }));
+  } else {
+    pendingResolveMentionIds.delete(agentId);
+    // Non-OK synchronous status — clear pendingPastedAgentMention to prevent
+    // an infinite retry loop on subsequent update() calls.
+    view.dispatch(view.state.tr.setMeta(_key.mentionPluginKey, {
+      action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+      params: {
+        id: agentId
+      }
+    }));
+  }
+};
 function createMentionPlugin(_ref2) {
   var pmPluginFactoryParams = _ref2.pmPluginFactoryParams,
     fireEvent = _ref2.fireEvent,
@@ -331,6 +429,37 @@ function createMentionPlugin(_ref2) {
             });
             hasPublicPluginStateChanged = true;
             break;
+          case ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME:
+            {
+              var _newPluginState$pendi, _newPluginState$pendi2, _newPluginState$pendi3, _newPluginState$pendi4, _newPluginState$pendi5, _newPluginState$pendi6;
+              // Guard: only apply if there is a matching pending pasted mention (staleness check).
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || !(params !== null && params !== void 0 && params.name) || ((_newPluginState$pendi = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi === void 0 ? void 0 : _newPluginState$pendi.id) !== params.id || !(0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                pendingPastedAgentMention: null,
+                lastInsertedAgentMentionId: (_newPluginState$pendi2 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi2 === void 0 ? void 0 : _newPluginState$pendi2.id,
+                lastInsertedAgentMentionLocalId: (_newPluginState$pendi3 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi3 === void 0 ? void 0 : _newPluginState$pendi3.localId,
+                lastInsertedAgentMentionContext: (_newPluginState$pendi4 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi4 === void 0 ? void 0 : _newPluginState$pendi4.context,
+                lastInsertedAgentMentionName: params.name,
+                lastInsertedAgentMentionPrompt: (_newPluginState$pendi5 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi5 === void 0 ? void 0 : _newPluginState$pendi5.prompt,
+                lastInsertedAgentMentionParentNodeType: (_newPluginState$pendi6 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi6 === void 0 ? void 0 : _newPluginState$pendi6.parentNodeType
+              });
+              hasPublicPluginStateChanged = true;
+              break;
+            }
+          case ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION:
+            {
+              var _newPluginState$pendi7;
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || ((_newPluginState$pendi7 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi7 === void 0 ? void 0 : _newPluginState$pendi7.id) !== params.id || !(0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              // resolveMentionName() returned a non-OK status — clear the pending state.
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                pendingPastedAgentMention: null
+              });
+              break;
+            }
         }
 
         // When the agent mentions experiment is off, dispatch immediately (original behaviour).
@@ -475,9 +604,12 @@ function createMentionPlugin(_ref2) {
                       }, params.name);
                     }
                     if (agentMentionLocalId === null && node.attrs.localId) {
+                      // Try to recover the name synchronously from the mention provider's
+                      // name cache (populated by cacheMentionName on typed insert).
+                      var cachedName = (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes') ? resolveCachedAgentMentionName(mentionProvider, params, node.attrs.id) : params === null || params === void 0 ? void 0 : params.name;
                       var agentMentionDetails = getAgentMentionDetailsAtPos(newState, pos, function (attrs) {
                         return attrs.localId === node.attrs.localId;
-                      }, params === null || params === void 0 ? void 0 : params.name);
+                      }, cachedName);
                       if (agentMentionDetails) {
                         agentMentionId = agentMentionDetails.id;
                         agentMentionLocalId = agentMentionDetails.localId;
@@ -595,6 +727,20 @@ function createMentionPlugin(_ref2) {
               if (!isTaskItemMentionForPaste && isNewInsertion && getIsRovoPanelOpen !== null && getIsRovoPanelOpen !== void 0 && getIsRovoPanelOpen()) {
                 // Rovo is already open — skip setting lastInsertedAgentMention* so the
                 // downstream nudge listener never fires.
+              } else if (agentMentionName === null && agentMentionId !== null && (0, _resource.isResolvingMentionProvider)(newPluginState.mentionProvider) && (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes')) {
+                // Store details in pendingPastedAgentMention (private, not broadcast), preventing a double-nudge.
+                newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                  pendingPastedAgentMention: {
+                    id: agentMentionId,
+                    localId: agentMentionLocalId,
+                    context: agentMentionContext,
+                    prompt: agentMentionPrompt,
+                    parentNodeType: agentMentionParentNodeType
+                  }
+                }, newInsertionCount !== undefined ? {
+                  lastAgentMentionInsertionCount: newInsertionCount
+                } : {});
+                // the nudge does not fire until the name is resolved.
               } else {
                 // Not suppressed — update state so the nudge fires normally.
                 newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
@@ -678,6 +824,9 @@ function createMentionPlugin(_ref2) {
       var pendingTypedAgentMentionTimer;
       var pendingTypedAgentMentionTimerKey = null;
       var pendingTypedAgentMentionFocusDeferCount = 0;
+      // Tracks agent IDs for which resolveMentionName() is already in-flight,
+      // preventing duplicate concurrent Promises for the same ID across update() cycles.
+      var pendingResolveMentionIds = new Set();
 
       /**
        * Clears the currently scheduled pending typed-agent-mention timer.
@@ -822,11 +971,19 @@ function createMentionPlugin(_ref2) {
       }
       return {
         update: function update(view, prevState) {
+          var _mentionPluginState$p;
           var mentionPluginState = _key.mentionPluginKey.getState(view.state);
           if (mentionPluginState === _key.mentionPluginKey.getState(prevState)) {
             return;
           }
           _schedulePendingTypedAgentMentionTimer(mentionPluginState);
+
+          // If a pasted agent mention has no name (cache miss), resolve it async
+          // via the mention provider and dispatch RESOLVE_PASTED_AGENT_MENTION_NAME
+          // so the nudge displays the correct name.
+          if ((0, _experiments.editorExperiment)('platform_editor_agent_mentions', true) && (mentionPluginState === null || mentionPluginState === void 0 || (_mentionPluginState$p = mentionPluginState.pendingPastedAgentMention) === null || _mentionPluginState$p === void 0 ? void 0 : _mentionPluginState$p.id) != null && mentionPluginState !== null && mentionPluginState !== void 0 && mentionPluginState.mentionProvider && (0, _resource.isResolvingMentionProvider)(mentionPluginState.mentionProvider) && (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes')) {
+            resolveAndDispatchPastedAgentMentionName(mentionPluginState.pendingPastedAgentMention.id, mentionPluginState.mentionProvider, pendingResolveMentionIds, view);
+          }
         },
         destroy: function destroy() {
           clearPendingTypedAgentMentionTimer();

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

@@ -545,6 +545,11 @@ var createTypeAheadConfig = exports.createTypeAheadConfig = function createTypeA
             name: name
           }
         });
+        // Cache the agent name so pasted mentions (where attrs.text is stripped)
+        // can recover it synchronously via resolveMentionName() cache hit.
+        if (name && mentionProvider && (0, _resource.isResolvingMentionProvider)(mentionProvider) && (0, _platformFeatureFlags.fg)('platform_editor_agent_mentions_drop_one_fixes')) {
+          mentionProvider.cacheMentionName(id, name);
+        }
       }
       return tr;
     },

package/dist/es2019/mentionsPlugin.js

@@ -226,8 +226,15 @@ const mentionsPlugin = ({
         return undefined;
       }
       const mentionPluginState = mentionPluginKey.getState(editorState);
+      // Exclude pendingPastedAgentMention — it is an @internal transient field and
+      // should not be part of the public shared state API. Exposing it would cause
+      // unnecessary re-renders in subscribers and leak implementation details.
+      const {
+        pendingPastedAgentMention: _excluded,
+        ...publicPluginState
+      } = mentionPluginState !== null && mentionPluginState !== void 0 ? mentionPluginState : {};
       return {
-        ...mentionPluginState,
+        ...publicPluginState,
         typeAheadHandler: typeAhead
       };
     },

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

@@ -1,7 +1,7 @@
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import { insm } from '@atlaskit/insm';
-import { SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/resource';
+import { isResolvingMentionProvider, MentionNameStatus, SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/resource';
 import { ComponentNames } from '@atlaskit/mention/types';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
@@ -14,7 +14,19 @@ export const ACTIONS = {
   COMMIT_PENDING_TYPED_AGENT_MENTION: 'COMMIT_PENDING_TYPED_AGENT_MENTION',
   DISCARD_PENDING_TYPED_AGENT_MENTION: 'DISCARD_PENDING_TYPED_AGENT_MENTION',
   SET_PENDING_TYPED_AGENT_MENTION: 'SET_PENDING_TYPED_AGENT_MENTION',
-  SET_PROVIDER: 'SET_PROVIDER'
+  SET_PROVIDER: 'SET_PROVIDER',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * for a pasted agent mention.
+   * Updates lastInsertedAgentMentionName so the nudge shows the correct name.
+   */
+  RESOLVE_PASTED_AGENT_MENTION_NAME: 'RESOLVE_PASTED_AGENT_MENTION_NAME',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * with a non-OK status for a pasted agent mention.
+   * Clears pendingPastedAgentMention so no retry loop occurs.
+   */
+  CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 
 // 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
@@ -38,7 +50,7 @@ const AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 const AGENT_MENTION_INACTIVITY_MS = 3000;
 const MAX_PENDING_TYPED_AGENT_MENTION_FOCUS_DEFERS = 20;
 const PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-const PACKAGE_VERSION = "14.6.1";
+const PACKAGE_VERSION = "14.6.3";
 const setProvider = provider => (state, dispatch) => {
   if (dispatch) {
     dispatch(state.tr.setMeta(mentionPluginKey, {
@@ -206,7 +218,7 @@ const commitPendingTypedAgentMention = (state, pluginState, pendingTypedAgentMen
   }
   return commitResolvedPendingTypedAgentMention(pluginState, pendingMentionDetails);
 };
-const hasTrackedAgentMentionState = pluginState => Boolean(pluginState.pendingTypedAgentMention) || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
+const hasTrackedAgentMentionState = pluginState => Boolean(pluginState.pendingTypedAgentMention) || Boolean(pluginState.pendingPastedAgentMention) && fg('platform_editor_agent_mentions_drop_one_fixes') || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
 
 /**
  * Clears agent mention state that points at a specific document snapshot.
@@ -217,6 +229,9 @@ const clearTrackedAgentMentionState = pluginState => {
   return {
     ...pluginState,
     pendingTypedAgentMention: null,
+    ...(fg('platform_editor_agent_mentions_drop_one_fixes') ? {
+      pendingPastedAgentMention: null
+    } : {}),
     lastInsertedAgentMentionId: null,
     lastInsertedAgentMentionLocalId: null,
     lastInsertedAgentMentionContext: null,
@@ -225,6 +240,88 @@ const clearTrackedAgentMentionState = pluginState => {
     lastInsertedAgentMentionParentNodeType: null
   };
 };
+
+/**
+ * Attempts to synchronously resolve an agent mention name from the mention
+ * provider's cache. Falls back to undefined if the provider doesn't support
+ * name resolution, the result is a Promise (async/cache miss), or the status
+ * is not OK.
+ */
+const resolveCachedAgentMentionName = (mentionProvider, params, id) => {
+  if (params !== null && params !== void 0 && params.name || !isResolvingMentionProvider(mentionProvider)) {
+    var _params$name;
+    return (_params$name = params === null || params === void 0 ? void 0 : params.name) !== null && _params$name !== void 0 ? _params$name : undefined;
+  }
+  const result = mentionProvider.resolveMentionName(id);
+  if (!(result instanceof Promise) && result.status === MentionNameStatus.OK) {
+    return result.name || undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Resolves the name of a pasted agent mention via the mention provider and
+ * dispatches the appropriate action to update plugin state.
+ *
+ * Handles both async (Promise) and synchronous cache-hit results:
+ * - On OK resolution  → dispatches RESOLVE_PASTED_AGENT_MENTION_NAME so the nudge
+ *   shows the correct agent name.
+ * - On non-OK result  → dispatches CLEAR_PENDING_PASTED_AGENT_MENTION to prevent
+ *   an infinite retry loop on subsequent update() calls.
+ *
+ * Guards against duplicate in-flight requests via pendingResolveMentionIds.
+ */
+export const resolveAndDispatchPastedAgentMentionName = (agentId, mentionProvider, pendingResolveMentionIds, view) => {
+  if (pendingResolveMentionIds.has(agentId)) {
+    return;
+  }
+  pendingResolveMentionIds.add(agentId);
+  const result = mentionProvider.resolveMentionName(agentId);
+  if (result instanceof Promise) {
+    result.then(nameDetails => {
+      pendingResolveMentionIds.delete(agentId);
+      if (nameDetails.status === MentionNameStatus.OK && nameDetails.name) {
+        view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+          action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+          params: {
+            id: agentId,
+            name: nameDetails.name
+          }
+        }));
+      } else {
+        // Non-OK status — clear pendingPastedAgentMention to prevent
+        // an infinite retry loop on subsequent update() calls.
+        view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+          action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+          params: {
+            id: agentId
+          }
+        }));
+      }
+    });
+  } else if (result.status === MentionNameStatus.OK && result.name) {
+    pendingResolveMentionIds.delete(agentId);
+    // Synchronous hit on a second update cycle (e.g. provider warmed up
+    // between the paste transaction and this view update).
+    view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+      action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+      params: {
+        id: agentId,
+        name: result.name
+      }
+    }));
+  } else {
+    pendingResolveMentionIds.delete(agentId);
+    // Non-OK synchronous status — clear pendingPastedAgentMention to prevent
+    // an infinite retry loop on subsequent update() calls.
+    view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+      action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+      params: {
+        id: agentId
+      }
+    }));
+  }
+};
 export function createMentionPlugin({
   pmPluginFactoryParams,
   fireEvent,
@@ -314,6 +411,39 @@ export function createMentionPlugin({
             };
             hasPublicPluginStateChanged = true;
             break;
+          case ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME:
+            {
+              var _newPluginState$pendi, _newPluginState$pendi2, _newPluginState$pendi3, _newPluginState$pendi4, _newPluginState$pendi5, _newPluginState$pendi6;
+              // Guard: only apply if there is a matching pending pasted mention (staleness check).
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || !(params !== null && params !== void 0 && params.name) || ((_newPluginState$pendi = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi === void 0 ? void 0 : _newPluginState$pendi.id) !== params.id || !fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              newPluginState = {
+                ...newPluginState,
+                pendingPastedAgentMention: null,
+                lastInsertedAgentMentionId: (_newPluginState$pendi2 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi2 === void 0 ? void 0 : _newPluginState$pendi2.id,
+                lastInsertedAgentMentionLocalId: (_newPluginState$pendi3 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi3 === void 0 ? void 0 : _newPluginState$pendi3.localId,
+                lastInsertedAgentMentionContext: (_newPluginState$pendi4 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi4 === void 0 ? void 0 : _newPluginState$pendi4.context,
+                lastInsertedAgentMentionName: params.name,
+                lastInsertedAgentMentionPrompt: (_newPluginState$pendi5 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi5 === void 0 ? void 0 : _newPluginState$pendi5.prompt,
+                lastInsertedAgentMentionParentNodeType: (_newPluginState$pendi6 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi6 === void 0 ? void 0 : _newPluginState$pendi6.parentNodeType
+              };
+              hasPublicPluginStateChanged = true;
+              break;
+            }
+          case ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION:
+            {
+              var _newPluginState$pendi7;
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || ((_newPluginState$pendi7 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi7 === void 0 ? void 0 : _newPluginState$pendi7.id) !== params.id || !fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              // resolveMentionName() returned a non-OK status — clear the pending state.
+              newPluginState = {
+                ...newPluginState,
+                pendingPastedAgentMention: null
+              };
+              break;
+            }
         }
 
         // When the agent mentions experiment is off, dispatch immediately (original behaviour).
@@ -448,7 +578,10 @@ export function createMentionPlugin({
                     pendingTypedAgentMentionDetails = getAgentMentionDetailsAtPos(newState, pos, attrs => attrs.localId === params.localId, params.name);
                   }
                   if (agentMentionLocalId === null && node.attrs.localId) {
-                    const agentMentionDetails = getAgentMentionDetailsAtPos(newState, pos, attrs => attrs.localId === node.attrs.localId, params === null || params === void 0 ? void 0 : params.name);
+                    // Try to recover the name synchronously from the mention provider's
+                    // name cache (populated by cacheMentionName on typed insert).
+                    const cachedName = fg('platform_editor_agent_mentions_drop_one_fixes') ? resolveCachedAgentMentionName(mentionProvider, params, node.attrs.id) : params === null || params === void 0 ? void 0 : params.name;
+                    const agentMentionDetails = getAgentMentionDetailsAtPos(newState, pos, attrs => attrs.localId === node.attrs.localId, cachedName);
                     if (agentMentionDetails) {
                       agentMentionId = agentMentionDetails.id;
                       agentMentionLocalId = agentMentionDetails.localId;
@@ -553,6 +686,22 @@ export function createMentionPlugin({
               if (!isTaskItemMentionForPaste && isNewInsertion && getIsRovoPanelOpen !== null && getIsRovoPanelOpen !== void 0 && getIsRovoPanelOpen()) {
                 // Rovo is already open — skip setting lastInsertedAgentMention* so the
                 // downstream nudge listener never fires.
+              } else if (agentMentionName === null && agentMentionId !== null && isResolvingMentionProvider(newPluginState.mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                // Store details in pendingPastedAgentMention (private, not broadcast), preventing a double-nudge.
+                newPluginState = {
+                  ...newPluginState,
+                  pendingPastedAgentMention: {
+                    id: agentMentionId,
+                    localId: agentMentionLocalId,
+                    context: agentMentionContext,
+                    prompt: agentMentionPrompt,
+                    parentNodeType: agentMentionParentNodeType
+                  },
+                  ...(newInsertionCount !== undefined ? {
+                    lastAgentMentionInsertionCount: newInsertionCount
+                  } : {})
+                };
+                // the nudge does not fire until the name is resolved.
               } else {
                 // Not suppressed — update state so the nudge fires normally.
                 newPluginState = {
@@ -639,6 +788,9 @@ export function createMentionPlugin({
       let pendingTypedAgentMentionTimer;
       let pendingTypedAgentMentionTimerKey = null;
       let pendingTypedAgentMentionFocusDeferCount = 0;
+      // Tracks agent IDs for which resolveMentionName() is already in-flight,
+      // preventing duplicate concurrent Promises for the same ID across update() cycles.
+      const pendingResolveMentionIds = new Set();
 
       /**
        * Clears the currently scheduled pending typed-agent-mention timer.
@@ -779,11 +931,19 @@ export function createMentionPlugin({
       }
       return {
         update(view, prevState) {
+          var _mentionPluginState$p;
           const mentionPluginState = mentionPluginKey.getState(view.state);
           if (mentionPluginState === mentionPluginKey.getState(prevState)) {
             return;
           }
           schedulePendingTypedAgentMentionTimer(mentionPluginState);
+
+          // If a pasted agent mention has no name (cache miss), resolve it async
+          // via the mention provider and dispatch RESOLVE_PASTED_AGENT_MENTION_NAME
+          // so the nudge displays the correct name.
+          if (editorExperiment('platform_editor_agent_mentions', true) && (mentionPluginState === null || mentionPluginState === void 0 ? void 0 : (_mentionPluginState$p = mentionPluginState.pendingPastedAgentMention) === null || _mentionPluginState$p === void 0 ? void 0 : _mentionPluginState$p.id) != null && mentionPluginState !== null && mentionPluginState !== void 0 && mentionPluginState.mentionProvider && isResolvingMentionProvider(mentionPluginState.mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+            resolveAndDispatchPastedAgentMentionName(mentionPluginState.pendingPastedAgentMention.id, mentionPluginState.mentionProvider, pendingResolveMentionIds, view);
+          }
         },
         destroy() {
           clearPendingTypedAgentMentionTimer();

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

@@ -522,6 +522,11 @@ export const createTypeAheadConfig = ({
             name
           }
         });
+        // Cache the agent name so pasted mentions (where attrs.text is stripped)
+        // can recover it synchronously via resolveMentionName() cache hit.
+        if (name && mentionProvider && isResolvingMentionProvider(mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+          mentionProvider.cacheMentionName(id, name);
+        }
       }
       return tr;
     },

package/dist/esm/mentionsPlugin.js

@@ -1,5 +1,7 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+var _excluded2 = ["pendingPastedAgentMention"];
 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; }
 import _regeneratorRuntime from "@babel/runtime/regenerator";
@@ -245,13 +247,19 @@ var mentionsPlugin = function mentionsPlugin(_ref3) {
         return undefined;
       }
       var mentionPluginState = mentionPluginKey.getState(editorState);
-      return _objectSpread(_objectSpread({}, mentionPluginState), {}, {
+      // Exclude pendingPastedAgentMention — it is an @internal transient field and
+      // should not be part of the public shared state API. Exposing it would cause
+      // unnecessary re-renders in subscribers and leak implementation details.
+      var _ref8 = mentionPluginState !== null && mentionPluginState !== void 0 ? mentionPluginState : {},
+        _excluded = _ref8.pendingPastedAgentMention,
+        publicPluginState = _objectWithoutProperties(_ref8, _excluded2);
+      return _objectSpread(_objectSpread({}, publicPluginState), {}, {
         typeAheadHandler: typeAhead
       });
     },
     pluginsOptions: {
-      quickInsert: function quickInsert(_ref8) {
-        var formatMessage = _ref8.formatMessage;
+      quickInsert: function quickInsert(_ref9) {
+        var formatMessage = _ref9.formatMessage;
         return [{
           id: 'mention',
           title: formatMessage(messages.mention),

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

@@ -8,7 +8,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import { insm } from '@atlaskit/insm';
-import { SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/resource';
+import { isResolvingMentionProvider, MentionNameStatus, SLI_EVENT_TYPE, SMART_EVENT_TYPE } from '@atlaskit/mention/resource';
 import { ComponentNames } from '@atlaskit/mention/types';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
@@ -21,7 +21,19 @@ export var ACTIONS = {
   COMMIT_PENDING_TYPED_AGENT_MENTION: 'COMMIT_PENDING_TYPED_AGENT_MENTION',
   DISCARD_PENDING_TYPED_AGENT_MENTION: 'DISCARD_PENDING_TYPED_AGENT_MENTION',
   SET_PENDING_TYPED_AGENT_MENTION: 'SET_PENDING_TYPED_AGENT_MENTION',
-  SET_PROVIDER: 'SET_PROVIDER'
+  SET_PROVIDER: 'SET_PROVIDER',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * for a pasted agent mention.
+   * Updates lastInsertedAgentMentionName so the nudge shows the correct name.
+   */
+  RESOLVE_PASTED_AGENT_MENTION_NAME: 'RESOLVE_PASTED_AGENT_MENTION_NAME',
+  /**
+   * Dispatched from view().update() when async resolveMentionName() resolves
+   * with a non-OK status for a pasted agent mention.
+   * Clears pendingPastedAgentMention so no retry loop occurs.
+   */
+  CLEAR_PENDING_PASTED_AGENT_MENTION: 'CLEAR_PENDING_PASTED_AGENT_MENTION'
 };
 
 // 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
@@ -45,7 +57,7 @@ var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var AGENT_MENTION_INACTIVITY_MS = 3000;
 var MAX_PENDING_TYPED_AGENT_MENTION_FOCUS_DEFERS = 20;
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "14.6.1";
+var PACKAGE_VERSION = "14.6.3";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -221,7 +233,7 @@ var commitPendingTypedAgentMention = function commitPendingTypedAgentMention(sta
   return commitResolvedPendingTypedAgentMention(pluginState, pendingMentionDetails);
 };
 var hasTrackedAgentMentionState = function hasTrackedAgentMentionState(pluginState) {
-  return Boolean(pluginState.pendingTypedAgentMention) || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
+  return Boolean(pluginState.pendingTypedAgentMention) || Boolean(pluginState.pendingPastedAgentMention) && fg('platform_editor_agent_mentions_drop_one_fixes') || pluginState.lastInsertedAgentMentionId != null || pluginState.lastInsertedAgentMentionLocalId != null || pluginState.lastInsertedAgentMentionContext != null || pluginState.lastInsertedAgentMentionName != null || pluginState.lastInsertedAgentMentionPrompt != null || pluginState.lastInsertedAgentMentionParentNodeType != null;
 };
 
 /**
@@ -230,8 +242,11 @@ var hasTrackedAgentMentionState = function hasTrackedAgentMentionState(pluginSta
  * lastInserted* details from the previous document must be cleared together.
  */
 var clearTrackedAgentMentionState = function clearTrackedAgentMentionState(pluginState) {
-  return _objectSpread(_objectSpread({}, pluginState), {}, {
-    pendingTypedAgentMention: null,
+  return _objectSpread(_objectSpread(_objectSpread({}, pluginState), {}, {
+    pendingTypedAgentMention: null
+  }, fg('platform_editor_agent_mentions_drop_one_fixes') ? {
+    pendingPastedAgentMention: null
+  } : {}), {}, {
     lastInsertedAgentMentionId: null,
     lastInsertedAgentMentionLocalId: null,
     lastInsertedAgentMentionContext: null,
@@ -240,6 +255,88 @@ var clearTrackedAgentMentionState = function clearTrackedAgentMentionState(plugi
     lastInsertedAgentMentionParentNodeType: null
   });
 };
+
+/**
+ * Attempts to synchronously resolve an agent mention name from the mention
+ * provider's cache. Falls back to undefined if the provider doesn't support
+ * name resolution, the result is a Promise (async/cache miss), or the status
+ * is not OK.
+ */
+var resolveCachedAgentMentionName = function resolveCachedAgentMentionName(mentionProvider, params, id) {
+  if (params !== null && params !== void 0 && params.name || !isResolvingMentionProvider(mentionProvider)) {
+    var _params$name;
+    return (_params$name = params === null || params === void 0 ? void 0 : params.name) !== null && _params$name !== void 0 ? _params$name : undefined;
+  }
+  var result = mentionProvider.resolveMentionName(id);
+  if (!(result instanceof Promise) && result.status === MentionNameStatus.OK) {
+    return result.name || undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Resolves the name of a pasted agent mention via the mention provider and
+ * dispatches the appropriate action to update plugin state.
+ *
+ * Handles both async (Promise) and synchronous cache-hit results:
+ * - On OK resolution  → dispatches RESOLVE_PASTED_AGENT_MENTION_NAME so the nudge
+ *   shows the correct agent name.
+ * - On non-OK result  → dispatches CLEAR_PENDING_PASTED_AGENT_MENTION to prevent
+ *   an infinite retry loop on subsequent update() calls.
+ *
+ * Guards against duplicate in-flight requests via pendingResolveMentionIds.
+ */
+export var resolveAndDispatchPastedAgentMentionName = function resolveAndDispatchPastedAgentMentionName(agentId, mentionProvider, pendingResolveMentionIds, view) {
+  if (pendingResolveMentionIds.has(agentId)) {
+    return;
+  }
+  pendingResolveMentionIds.add(agentId);
+  var result = mentionProvider.resolveMentionName(agentId);
+  if (result instanceof Promise) {
+    result.then(function (nameDetails) {
+      pendingResolveMentionIds.delete(agentId);
+      if (nameDetails.status === MentionNameStatus.OK && nameDetails.name) {
+        view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+          action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+          params: {
+            id: agentId,
+            name: nameDetails.name
+          }
+        }));
+      } else {
+        // Non-OK status — clear pendingPastedAgentMention to prevent
+        // an infinite retry loop on subsequent update() calls.
+        view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+          action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+          params: {
+            id: agentId
+          }
+        }));
+      }
+    });
+  } else if (result.status === MentionNameStatus.OK && result.name) {
+    pendingResolveMentionIds.delete(agentId);
+    // Synchronous hit on a second update cycle (e.g. provider warmed up
+    // between the paste transaction and this view update).
+    view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+      action: ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME,
+      params: {
+        id: agentId,
+        name: result.name
+      }
+    }));
+  } else {
+    pendingResolveMentionIds.delete(agentId);
+    // Non-OK synchronous status — clear pendingPastedAgentMention to prevent
+    // an infinite retry loop on subsequent update() calls.
+    view.dispatch(view.state.tr.setMeta(mentionPluginKey, {
+      action: ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION,
+      params: {
+        id: agentId
+      }
+    }));
+  }
+};
 export function createMentionPlugin(_ref2) {
   var pmPluginFactoryParams = _ref2.pmPluginFactoryParams,
     fireEvent = _ref2.fireEvent,
@@ -323,6 +420,37 @@ export function createMentionPlugin(_ref2) {
             });
             hasPublicPluginStateChanged = true;
             break;
+          case ACTIONS.RESOLVE_PASTED_AGENT_MENTION_NAME:
+            {
+              var _newPluginState$pendi, _newPluginState$pendi2, _newPluginState$pendi3, _newPluginState$pendi4, _newPluginState$pendi5, _newPluginState$pendi6;
+              // Guard: only apply if there is a matching pending pasted mention (staleness check).
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || !(params !== null && params !== void 0 && params.name) || ((_newPluginState$pendi = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi === void 0 ? void 0 : _newPluginState$pendi.id) !== params.id || !fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                pendingPastedAgentMention: null,
+                lastInsertedAgentMentionId: (_newPluginState$pendi2 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi2 === void 0 ? void 0 : _newPluginState$pendi2.id,
+                lastInsertedAgentMentionLocalId: (_newPluginState$pendi3 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi3 === void 0 ? void 0 : _newPluginState$pendi3.localId,
+                lastInsertedAgentMentionContext: (_newPluginState$pendi4 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi4 === void 0 ? void 0 : _newPluginState$pendi4.context,
+                lastInsertedAgentMentionName: params.name,
+                lastInsertedAgentMentionPrompt: (_newPluginState$pendi5 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi5 === void 0 ? void 0 : _newPluginState$pendi5.prompt,
+                lastInsertedAgentMentionParentNodeType: (_newPluginState$pendi6 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi6 === void 0 ? void 0 : _newPluginState$pendi6.parentNodeType
+              });
+              hasPublicPluginStateChanged = true;
+              break;
+            }
+          case ACTIONS.CLEAR_PENDING_PASTED_AGENT_MENTION:
+            {
+              var _newPluginState$pendi7;
+              if (!isAgentMentionsExperimentEnabled || !(params !== null && params !== void 0 && params.id) || ((_newPluginState$pendi7 = newPluginState.pendingPastedAgentMention) === null || _newPluginState$pendi7 === void 0 ? void 0 : _newPluginState$pendi7.id) !== params.id || !fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                break;
+              }
+              // resolveMentionName() returned a non-OK status — clear the pending state.
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                pendingPastedAgentMention: null
+              });
+              break;
+            }
         }
 
         // When the agent mentions experiment is off, dispatch immediately (original behaviour).
@@ -467,9 +595,12 @@ export function createMentionPlugin(_ref2) {
                       }, params.name);
                     }
                     if (agentMentionLocalId === null && node.attrs.localId) {
+                      // Try to recover the name synchronously from the mention provider's
+                      // name cache (populated by cacheMentionName on typed insert).
+                      var cachedName = fg('platform_editor_agent_mentions_drop_one_fixes') ? resolveCachedAgentMentionName(mentionProvider, params, node.attrs.id) : params === null || params === void 0 ? void 0 : params.name;
                       var agentMentionDetails = getAgentMentionDetailsAtPos(newState, pos, function (attrs) {
                         return attrs.localId === node.attrs.localId;
-                      }, params === null || params === void 0 ? void 0 : params.name);
+                      }, cachedName);
                       if (agentMentionDetails) {
                         agentMentionId = agentMentionDetails.id;
                         agentMentionLocalId = agentMentionDetails.localId;
@@ -587,6 +718,20 @@ export function createMentionPlugin(_ref2) {
               if (!isTaskItemMentionForPaste && isNewInsertion && getIsRovoPanelOpen !== null && getIsRovoPanelOpen !== void 0 && getIsRovoPanelOpen()) {
                 // Rovo is already open — skip setting lastInsertedAgentMention* so the
                 // downstream nudge listener never fires.
+              } else if (agentMentionName === null && agentMentionId !== null && isResolvingMentionProvider(newPluginState.mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+                // Store details in pendingPastedAgentMention (private, not broadcast), preventing a double-nudge.
+                newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                  pendingPastedAgentMention: {
+                    id: agentMentionId,
+                    localId: agentMentionLocalId,
+                    context: agentMentionContext,
+                    prompt: agentMentionPrompt,
+                    parentNodeType: agentMentionParentNodeType
+                  }
+                }, newInsertionCount !== undefined ? {
+                  lastAgentMentionInsertionCount: newInsertionCount
+                } : {});
+                // the nudge does not fire until the name is resolved.
               } else {
                 // Not suppressed — update state so the nudge fires normally.
                 newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
@@ -670,6 +815,9 @@ export function createMentionPlugin(_ref2) {
       var pendingTypedAgentMentionTimer;
       var pendingTypedAgentMentionTimerKey = null;
       var pendingTypedAgentMentionFocusDeferCount = 0;
+      // Tracks agent IDs for which resolveMentionName() is already in-flight,
+      // preventing duplicate concurrent Promises for the same ID across update() cycles.
+      var pendingResolveMentionIds = new Set();
 
       /**
        * Clears the currently scheduled pending typed-agent-mention timer.
@@ -814,11 +962,19 @@ export function createMentionPlugin(_ref2) {
       }
       return {
         update: function update(view, prevState) {
+          var _mentionPluginState$p;
           var mentionPluginState = mentionPluginKey.getState(view.state);
           if (mentionPluginState === mentionPluginKey.getState(prevState)) {
             return;
           }
           _schedulePendingTypedAgentMentionTimer(mentionPluginState);
+
+          // If a pasted agent mention has no name (cache miss), resolve it async
+          // via the mention provider and dispatch RESOLVE_PASTED_AGENT_MENTION_NAME
+          // so the nudge displays the correct name.
+          if (editorExperiment('platform_editor_agent_mentions', true) && (mentionPluginState === null || mentionPluginState === void 0 || (_mentionPluginState$p = mentionPluginState.pendingPastedAgentMention) === null || _mentionPluginState$p === void 0 ? void 0 : _mentionPluginState$p.id) != null && mentionPluginState !== null && mentionPluginState !== void 0 && mentionPluginState.mentionProvider && isResolvingMentionProvider(mentionPluginState.mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+            resolveAndDispatchPastedAgentMentionName(mentionPluginState.pendingPastedAgentMention.id, mentionPluginState.mentionProvider, pendingResolveMentionIds, view);
+          }
         },
         destroy: function destroy() {
           clearPendingTypedAgentMentionTimer();

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

@@ -536,6 +536,11 @@ export var createTypeAheadConfig = function createTypeAheadConfig(_ref8) {
             name: name
           }
         });
+        // Cache the agent name so pasted mentions (where attrs.text is stripped)
+        // can recover it synchronously via resolveMentionName() cache hit.
+        if (name && mentionProvider && isResolvingMentionProvider(mentionProvider) && fg('platform_editor_agent_mentions_drop_one_fixes')) {
+          mentionProvider.cacheMentionName(id, name);
+        }
       }
       return tr;
     },

package/dist/types/pm-plugins/main.d.ts

@@ -1,5 +1,7 @@
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import type { ExtractInjectionAPI, PMPluginFactoryParams } from '@atlaskit/editor-common/types';
+import type { EditorView } from '@atlaskit/editor-prosemirror/view';
+import type { ResolvingMentionProvider } from '@atlaskit/mention/resource';
 import type { MentionsPlugin } from '../mentionsPluginType';
 import type { FireElementsChannelEvent, MentionPluginOptions, MentionPluginState } from '../types';
 export declare const ACTIONS: {
@@ -7,7 +9,32 @@ export declare const ACTIONS: {
     DISCARD_PENDING_TYPED_AGENT_MENTION: string;
     SET_PENDING_TYPED_AGENT_MENTION: string;
     SET_PROVIDER: string;
+    /**
+     * Dispatched from view().update() when async resolveMentionName() resolves
+     * for a pasted agent mention.
+     * Updates lastInsertedAgentMentionName so the nudge shows the correct name.
+     */
+    RESOLVE_PASTED_AGENT_MENTION_NAME: string;
+    /**
+     * Dispatched from view().update() when async resolveMentionName() resolves
+     * with a non-OK status for a pasted agent mention.
+     * Clears pendingPastedAgentMention so no retry loop occurs.
+     */
+    CLEAR_PENDING_PASTED_AGENT_MENTION: string;
 };
+/**
+ * Resolves the name of a pasted agent mention via the mention provider and
+ * dispatches the appropriate action to update plugin state.
+ *
+ * Handles both async (Promise) and synchronous cache-hit results:
+ * - On OK resolution  → dispatches RESOLVE_PASTED_AGENT_MENTION_NAME so the nudge
+ *   shows the correct agent name.
+ * - On non-OK result  → dispatches CLEAR_PENDING_PASTED_AGENT_MENTION to prevent
+ *   an infinite retry loop on subsequent update() calls.
+ *
+ * Guards against duplicate in-flight requests via pendingResolveMentionIds.
+ */
+export declare const resolveAndDispatchPastedAgentMentionName: (agentId: string, mentionProvider: ResolvingMentionProvider, pendingResolveMentionIds: Set<string>, view: EditorView) => void;
 interface CreateMentionPlugin {
     api?: ExtractInjectionAPI<MentionsPlugin>;
     fireEvent: FireElementsChannelEvent;

package/dist/types/types/index.d.ts

@@ -114,6 +114,19 @@ export type MentionPluginState = {
     lastInsertedAgentMentionPrompt?: string | null;
     mentionProvider?: MentionProvider;
     mentions?: Array<MentionDescription>;
+    /**
+     * @internal Tracks a pasted agent mention pending name resolution (cache miss).
+     * view().update() calls resolveMentionName() silently until resolved, then
+     * RESOLVE_PASTED_AGENT_MENTION_NAME promotes it to lastInsertedAgentMention*
+     * and fires a public dispatch. Consumers should react only to lastInsertedAgentMention*.
+     */
+    pendingPastedAgentMention?: {
+        context: DocNode;
+        id: string;
+        localId: string;
+        parentNodeType: string | null;
+        prompt: string | null;
+    } | null;
     /**
      * @internal Tracks a typed agent mention while waiting for the platform-side
      * ready-to-fire trigger. Consumers should continue to react only to
@@ -140,6 +153,6 @@ export type MentionPluginState = {
     } | null;
 };
 export type FireElementsChannelEvent = (payload: AnalyticsEventPayload, channel?: string) => void;
-export type MentionSharedState = MentionPluginState & {
+export type MentionSharedState = Omit<MentionPluginState, 'pendingPastedAgentMention'> & {
     typeAheadHandler: TypeAheadHandler;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-mentions",
-	"version": "14.6.2",
+	"version": "14.6.4",
 	"description": "Mentions plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -37,11 +37,11 @@
 		"@atlaskit/platform-feature-flags": "^2.0.0",
 		"@atlaskit/popper": "^8.3.0",
 		"@atlaskit/portal": "^6.1.0",
-		"@atlaskit/primitives": "^20.6.0",
+		"@atlaskit/primitives": "^21.0.0",
 		"@atlaskit/profilecard": "^26.9.0",
 		"@atlaskit/teams-app-config": "^2.1.0",
 		"@atlaskit/theme": "^26.1.0",
-		"@atlaskit/tmp-editor-statsig": "^124.9.0",
+		"@atlaskit/tmp-editor-statsig": "^125.2.0",
 		"@atlaskit/tokens": "^15.8.0",
 		"@atlaskit/tooltip": "^23.1.0",
 		"@atlaskit/user-picker": "^13.4.0",