@atlaskit/editor-plugin-mentions 12.3.0 → 12.3.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atlaskit/editor-plugin-mentions
 
+## 12.3.2
+
+### Patch Changes
+
+- [`fcf5961a91bce`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/fcf5961a91bce) -
+  EDITOR-7322 - mentions plugin agent detection and tracking
+- Updated dependencies
+
+## 12.3.1
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 12.3.0
 
 ### Minor Changes

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.ACTIONS = void 0;
 exports.createMentionPlugin = createMentionPlugin;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _analytics = require("@atlaskit/editor-common/analytics");
 var _safePlugin = require("@atlaskit/editor-common/safe-plugin");
@@ -13,17 +14,25 @@ var _insm = require("@atlaskit/insm");
 var _resource = require("@atlaskit/mention/resource");
 var _types = require("@atlaskit/mention/types");
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
+var _experiments = require("@atlaskit/tmp-editor-statsig/experiments");
 var _mentionNodeView = require("../nodeviews/mentionNodeView");
 var _types2 = require("../types");
 var _key = require("./key");
 var _utils = require("./utils");
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 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; }
 var ACTIONS = exports.ACTIONS = {
   SET_PROVIDER: 'SET_PROVIDER'
 };
+
+// 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
+var AGENT_USER_TYPES = new Set(['APP', 'AGENT']);
+var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "12.2.11";
+var PACKAGE_VERSION = "12.3.1";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -90,7 +99,11 @@ function createMentionPlugin(_ref) {
             hasNewPluginState = true;
             break;
         }
-        if (hasNewPluginState) {
+
+        // When the agent mentions experiment is off, dispatch immediately (original behaviour).
+        // When it's on, defer dispatch to after the agent tracking block below so that
+        // agent-mention state changes are included in the notification.
+        if (hasNewPluginState && !(0, _experiments.editorExperiment)('platform_editor_agent_mentions', true)) {
           pmPluginFactoryParams.dispatch(_key.mentionPluginKey, newPluginState);
         }
         if (options !== null && options !== void 0 && options.handleMentionsChanged && tr.docChanged) {
@@ -152,6 +165,161 @@ function createMentionPlugin(_ref) {
           }
           (_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 && (0, _experiments.editorExperiment)('platform_editor_agent_mentions', true)) {
+          var _mentionSchema = newState.schema.nodes.mention;
+          var newDocRanges = [];
+          var oldDocRanges = [];
+          var stepsTouchMentions = false;
+          tr.steps.forEach(function (step) {
+            var found = false;
+            // Only merge a step's ranges if it actually touched an agent mention,
+            // so unrelated steps (e.g. mark-only changes) don't inflate the scan area.
+            var stepNewRanges = [];
+            var stepOldRanges = [];
+            step.getMap().forEach(function (oldFrom, oldTo, newFrom, newTo) {
+              stepOldRanges.push([oldFrom, oldTo]);
+              stepNewRanges.push([newFrom, newTo]);
+              if (!found) {
+                // Clamp positions: delete-only steps can produce newTo > doc.content.size.
+                var clampedNewFrom = Math.min(newFrom, newState.doc.content.size);
+                var clampedNewTo = Math.min(newTo, newState.doc.content.size);
+                if (clampedNewFrom < clampedNewTo) {
+                  newState.doc.nodesBetween(clampedNewFrom, clampedNewTo, function (node) {
+                    if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      found = true;
+                    }
+                    return !found;
+                  });
+                }
+                if (!found) {
+                  var clampedOldFrom = Math.min(oldFrom, oldState.doc.content.size);
+                  var clampedOldTo = Math.min(oldTo, oldState.doc.content.size);
+                  if (clampedOldFrom < clampedOldTo) {
+                    oldState.doc.nodesBetween(clampedOldFrom, clampedOldTo, function (node) {
+                      if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                        found = true;
+                      }
+                      return !found;
+                    });
+                  }
+                }
+              }
+            });
+            if (found) {
+              stepsTouchMentions = true;
+              newDocRanges.push.apply(newDocRanges, stepNewRanges);
+              oldDocRanges.push.apply(oldDocRanges, stepOldRanges);
+            }
+          });
+          if (stepsTouchMentions || newPluginState.lastInsertedAgentMentionId) {
+            var _newPluginState$lastA, _newPluginState$lastI, _newPluginState$lastI2, _newPluginState$lastI3;
+            var agentMentionId = null;
+            var agentMentionContext = null;
+            var agentMentionParentNodeType = null;
+            var newCount = 0;
+            var oldAgentMentionId = null;
+            var oldCount = 0;
+            if (stepsTouchMentions) {
+              var _iterator = _createForOfIteratorHelper(newDocRanges),
+                _step;
+              try {
+                for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                  var _step$value = (0, _slicedToArray2.default)(_step.value, 2),
+                    from = _step$value[0],
+                    to = _step$value[1];
+                  var clampedTo = Math.min(to, newState.doc.content.size);
+                  if (from >= clampedTo) continue;
+                  newState.doc.nodesBetween(from, clampedTo, function (node, _pos, parent) {
+                    if (node.type !== _mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      return true;
+                    }
+                    newCount++;
+                    if (agentMentionId === null && node.attrs.id) {
+                      var _parent$type$name;
+                      agentMentionId = node.attrs.id;
+                      agentMentionParentNodeType = (_parent$type$name = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name !== void 0 ? _parent$type$name : null;
+                      agentMentionContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                    }
+                    return true;
+                  });
+                }
+              } catch (err) {
+                _iterator.e(err);
+              } finally {
+                _iterator.f();
+              }
+              var _iterator2 = _createForOfIteratorHelper(oldDocRanges),
+                _step2;
+              try {
+                for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+                  var _step2$value = (0, _slicedToArray2.default)(_step2.value, 2),
+                    _from = _step2$value[0],
+                    _to = _step2$value[1];
+                  var clampedOldTo = Math.min(_to, oldState.doc.content.size);
+                  if (_from >= clampedOldTo) continue;
+                  oldState.doc.nodesBetween(_from, clampedOldTo, function (node) {
+                    if (node.type !== _mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      return true;
+                    }
+                    oldCount++;
+                    if (oldAgentMentionId === null && node.attrs.id) {
+                      oldAgentMentionId = node.attrs.id;
+                    }
+                    return true;
+                  });
+                }
+              } catch (err) {
+                _iterator2.e(err);
+              } finally {
+                _iterator2.f();
+              }
+            }
+
+            // When a deletion collapses the new-doc range to a zero-width point, or when
+            // the doc changed but no step covered the tracked mention, the new-doc scan
+            // above finds nothing. Check whether any agent mention survived in the document.
+            var resolvedFromSurvivor = false;
+            if (agentMentionId === null && newPluginState.lastInsertedAgentMentionId) {
+              var prevId = newPluginState.lastInsertedAgentMentionId;
+              var survivorId = null;
+              var survivorContext = null;
+              var survivorParentNodeType = null;
+              newState.doc.descendants(function (node, _pos, parent) {
+                if (survivorId === prevId) return false;
+                if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                  var _parent$type$name2;
+                  // Prefer the previously tracked ID; otherwise keep the first found.
+                  survivorId = node.attrs.id;
+                  survivorParentNodeType = (_parent$type$name2 = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name2 !== void 0 ? _parent$type$name2 : null;
+                  survivorContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                }
+                return survivorId !== prevId;
+              });
+              if (survivorId !== null) {
+                agentMentionId = survivorId;
+                agentMentionContext = survivorContext;
+                agentMentionParentNodeType = survivorParentNodeType;
+                resolvedFromSurvivor = true;
+              }
+            }
+            var isNewInsertion = agentMentionId !== null && !resolvedFromSurvivor && (oldAgentMentionId !== agentMentionId || newCount > oldCount);
+            var newInsertionCount = isNewInsertion ? ((_newPluginState$lastA = newPluginState.lastAgentMentionInsertionCount) !== null && _newPluginState$lastA !== void 0 ? _newPluginState$lastA : 0) + 1 : undefined;
+            if (agentMentionId !== ((_newPluginState$lastI = newPluginState.lastInsertedAgentMentionId) !== null && _newPluginState$lastI !== void 0 ? _newPluginState$lastI : null) || agentMentionContext !== ((_newPluginState$lastI2 = newPluginState.lastInsertedAgentMentionContext) !== null && _newPluginState$lastI2 !== void 0 ? _newPluginState$lastI2 : null) || agentMentionParentNodeType !== ((_newPluginState$lastI3 = newPluginState.lastInsertedAgentMentionParentNodeType) !== null && _newPluginState$lastI3 !== void 0 ? _newPluginState$lastI3 : null) || newInsertionCount !== undefined) {
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                lastInsertedAgentMentionId: agentMentionId,
+                lastInsertedAgentMentionContext: agentMentionContext,
+                lastInsertedAgentMentionParentNodeType: agentMentionParentNodeType
+              }, newInsertionCount !== undefined ? {
+                lastAgentMentionInsertionCount: newInsertionCount
+              } : {});
+              hasNewPluginState = true;
+            }
+          }
+        }
+        if (hasNewPluginState && (0, _experiments.editorExperiment)('platform_editor_agent_mentions', true)) {
+          pmPluginFactoryParams.dispatch(_key.mentionPluginKey, newPluginState);
+        }
         return newPluginState;
       }
     },

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

@@ -4,6 +4,7 @@ import { insm } from '@atlaskit/insm';
 import { 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';
 import { MentionNodeView } from '../nodeviews/mentionNodeView';
 import { MENTION_PROVIDER_REJECTED, MENTION_PROVIDER_UNDEFINED } from '../types';
 import { mentionPluginKey } from './key';
@@ -11,8 +12,12 @@ import { canMentionBeCreatedInRange } from './utils';
 export const ACTIONS = {
   SET_PROVIDER: 'SET_PROVIDER'
 };
+
+// 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
+const AGENT_USER_TYPES = new Set(['APP', 'AGENT']);
+const AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 const PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-const PACKAGE_VERSION = "12.2.11";
+const PACKAGE_VERSION = "12.3.1";
 const setProvider = provider => (state, dispatch) => {
   if (dispatch) {
     dispatch(state.tr.setMeta(mentionPluginKey, {
@@ -82,7 +87,11 @@ export function createMentionPlugin({
             hasNewPluginState = true;
             break;
         }
-        if (hasNewPluginState) {
+
+        // When the agent mentions experiment is off, dispatch immediately (original behaviour).
+        // When it's on, defer dispatch to after the agent tracking block below so that
+        // agent-mention state changes are included in the notification.
+        if (hasNewPluginState && !editorExperiment('platform_editor_agent_mentions', true)) {
           pmPluginFactoryParams.dispatch(mentionPluginKey, newPluginState);
         }
         if (options !== null && options !== void 0 && options.handleMentionsChanged && tr.docChanged) {
@@ -142,6 +151,141 @@ 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 && editorExperiment('platform_editor_agent_mentions', true)) {
+          const mentionSchema = newState.schema.nodes.mention;
+          const newDocRanges = [];
+          const oldDocRanges = [];
+          let stepsTouchMentions = false;
+          tr.steps.forEach(step => {
+            let found = false;
+            // Only merge a step's ranges if it actually touched an agent mention,
+            // so unrelated steps (e.g. mark-only changes) don't inflate the scan area.
+            const stepNewRanges = [];
+            const stepOldRanges = [];
+            step.getMap().forEach((oldFrom, oldTo, newFrom, newTo) => {
+              stepOldRanges.push([oldFrom, oldTo]);
+              stepNewRanges.push([newFrom, newTo]);
+              if (!found) {
+                // Clamp positions: delete-only steps can produce newTo > doc.content.size.
+                const clampedNewFrom = Math.min(newFrom, newState.doc.content.size);
+                const clampedNewTo = Math.min(newTo, newState.doc.content.size);
+                if (clampedNewFrom < clampedNewTo) {
+                  newState.doc.nodesBetween(clampedNewFrom, clampedNewTo, node => {
+                    if (node.type === mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      found = true;
+                    }
+                    return !found;
+                  });
+                }
+                if (!found) {
+                  const clampedOldFrom = Math.min(oldFrom, oldState.doc.content.size);
+                  const clampedOldTo = Math.min(oldTo, oldState.doc.content.size);
+                  if (clampedOldFrom < clampedOldTo) {
+                    oldState.doc.nodesBetween(clampedOldFrom, clampedOldTo, node => {
+                      if (node.type === mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                        found = true;
+                      }
+                      return !found;
+                    });
+                  }
+                }
+              }
+            });
+            if (found) {
+              stepsTouchMentions = true;
+              newDocRanges.push(...stepNewRanges);
+              oldDocRanges.push(...stepOldRanges);
+            }
+          });
+          if (stepsTouchMentions || newPluginState.lastInsertedAgentMentionId) {
+            var _newPluginState$lastA, _newPluginState$lastI, _newPluginState$lastI2, _newPluginState$lastI3;
+            let agentMentionId = null;
+            let agentMentionContext = null;
+            let agentMentionParentNodeType = null;
+            let newCount = 0;
+            let oldAgentMentionId = null;
+            let oldCount = 0;
+            if (stepsTouchMentions) {
+              for (const [from, to] of newDocRanges) {
+                const clampedTo = Math.min(to, newState.doc.content.size);
+                if (from >= clampedTo) continue;
+                newState.doc.nodesBetween(from, clampedTo, (node, _pos, parent) => {
+                  if (node.type !== mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                    return true;
+                  }
+                  newCount++;
+                  if (agentMentionId === null && node.attrs.id) {
+                    var _parent$type$name;
+                    agentMentionId = node.attrs.id;
+                    agentMentionParentNodeType = (_parent$type$name = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name !== void 0 ? _parent$type$name : null;
+                    agentMentionContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                  }
+                  return true;
+                });
+              }
+              for (const [from, to] of oldDocRanges) {
+                const clampedOldTo = Math.min(to, oldState.doc.content.size);
+                if (from >= clampedOldTo) continue;
+                oldState.doc.nodesBetween(from, clampedOldTo, node => {
+                  if (node.type !== mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                    return true;
+                  }
+                  oldCount++;
+                  if (oldAgentMentionId === null && node.attrs.id) {
+                    oldAgentMentionId = node.attrs.id;
+                  }
+                  return true;
+                });
+              }
+            }
+
+            // When a deletion collapses the new-doc range to a zero-width point, or when
+            // the doc changed but no step covered the tracked mention, the new-doc scan
+            // above finds nothing. Check whether any agent mention survived in the document.
+            let resolvedFromSurvivor = false;
+            if (agentMentionId === null && newPluginState.lastInsertedAgentMentionId) {
+              const prevId = newPluginState.lastInsertedAgentMentionId;
+              let survivorId = null;
+              let survivorContext = null;
+              let survivorParentNodeType = null;
+              newState.doc.descendants((node, _pos, parent) => {
+                if (survivorId === prevId) return false;
+                if (node.type === mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                  var _parent$type$name2;
+                  // Prefer the previously tracked ID; otherwise keep the first found.
+                  survivorId = node.attrs.id;
+                  survivorParentNodeType = (_parent$type$name2 = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name2 !== void 0 ? _parent$type$name2 : null;
+                  survivorContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                }
+                return survivorId !== prevId;
+              });
+              if (survivorId !== null) {
+                agentMentionId = survivorId;
+                agentMentionContext = survivorContext;
+                agentMentionParentNodeType = survivorParentNodeType;
+                resolvedFromSurvivor = true;
+              }
+            }
+            const isNewInsertion = agentMentionId !== null && !resolvedFromSurvivor && (oldAgentMentionId !== agentMentionId || newCount > oldCount);
+            const newInsertionCount = isNewInsertion ? ((_newPluginState$lastA = newPluginState.lastAgentMentionInsertionCount) !== null && _newPluginState$lastA !== void 0 ? _newPluginState$lastA : 0) + 1 : undefined;
+            if (agentMentionId !== ((_newPluginState$lastI = newPluginState.lastInsertedAgentMentionId) !== null && _newPluginState$lastI !== void 0 ? _newPluginState$lastI : null) || agentMentionContext !== ((_newPluginState$lastI2 = newPluginState.lastInsertedAgentMentionContext) !== null && _newPluginState$lastI2 !== void 0 ? _newPluginState$lastI2 : null) || agentMentionParentNodeType !== ((_newPluginState$lastI3 = newPluginState.lastInsertedAgentMentionParentNodeType) !== null && _newPluginState$lastI3 !== void 0 ? _newPluginState$lastI3 : null) || newInsertionCount !== undefined) {
+              newPluginState = {
+                ...newPluginState,
+                lastInsertedAgentMentionId: agentMentionId,
+                lastInsertedAgentMentionContext: agentMentionContext,
+                lastInsertedAgentMentionParentNodeType: agentMentionParentNodeType,
+                ...(newInsertionCount !== undefined ? {
+                  lastAgentMentionInsertionCount: newInsertionCount
+                } : {})
+              };
+              hasNewPluginState = true;
+            }
+          }
+        }
+        if (hasNewPluginState && editorExperiment('platform_editor_agent_mentions', true)) {
+          pmPluginFactoryParams.dispatch(mentionPluginKey, newPluginState);
+        }
         return newPluginState;
       }
     },

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

@@ -1,4 +1,8 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 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 { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
@@ -7,6 +11,7 @@ import { insm } from '@atlaskit/insm';
 import { 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';
 import { MentionNodeView } from '../nodeviews/mentionNodeView';
 import { MENTION_PROVIDER_REJECTED, MENTION_PROVIDER_UNDEFINED } from '../types';
 import { mentionPluginKey } from './key';
@@ -14,8 +19,12 @@ import { canMentionBeCreatedInRange } from './utils';
 export var ACTIONS = {
   SET_PROVIDER: 'SET_PROVIDER'
 };
+
+// 'AGENT' is not in the ADF schema UserType enum but is used at runtime.
+var AGENT_USER_TYPES = new Set(['APP', 'AGENT']);
+var AI_STREAMING_TRANSFORMATION_META_KEY = 'isAIStreamingTransformation';
 var PACKAGE_NAME = "@atlaskit/editor-plugin-mentions";
-var PACKAGE_VERSION = "12.2.11";
+var PACKAGE_VERSION = "12.3.1";
 var setProvider = function setProvider(provider) {
   return function (state, dispatch) {
     if (dispatch) {
@@ -82,7 +91,11 @@ export function createMentionPlugin(_ref) {
             hasNewPluginState = true;
             break;
         }
-        if (hasNewPluginState) {
+
+        // When the agent mentions experiment is off, dispatch immediately (original behaviour).
+        // When it's on, defer dispatch to after the agent tracking block below so that
+        // agent-mention state changes are included in the notification.
+        if (hasNewPluginState && !editorExperiment('platform_editor_agent_mentions', true)) {
           pmPluginFactoryParams.dispatch(mentionPluginKey, newPluginState);
         }
         if (options !== null && options !== void 0 && options.handleMentionsChanged && tr.docChanged) {
@@ -144,6 +157,161 @@ export function createMentionPlugin(_ref) {
           }
           (_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 && editorExperiment('platform_editor_agent_mentions', true)) {
+          var _mentionSchema = newState.schema.nodes.mention;
+          var newDocRanges = [];
+          var oldDocRanges = [];
+          var stepsTouchMentions = false;
+          tr.steps.forEach(function (step) {
+            var found = false;
+            // Only merge a step's ranges if it actually touched an agent mention,
+            // so unrelated steps (e.g. mark-only changes) don't inflate the scan area.
+            var stepNewRanges = [];
+            var stepOldRanges = [];
+            step.getMap().forEach(function (oldFrom, oldTo, newFrom, newTo) {
+              stepOldRanges.push([oldFrom, oldTo]);
+              stepNewRanges.push([newFrom, newTo]);
+              if (!found) {
+                // Clamp positions: delete-only steps can produce newTo > doc.content.size.
+                var clampedNewFrom = Math.min(newFrom, newState.doc.content.size);
+                var clampedNewTo = Math.min(newTo, newState.doc.content.size);
+                if (clampedNewFrom < clampedNewTo) {
+                  newState.doc.nodesBetween(clampedNewFrom, clampedNewTo, function (node) {
+                    if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      found = true;
+                    }
+                    return !found;
+                  });
+                }
+                if (!found) {
+                  var clampedOldFrom = Math.min(oldFrom, oldState.doc.content.size);
+                  var clampedOldTo = Math.min(oldTo, oldState.doc.content.size);
+                  if (clampedOldFrom < clampedOldTo) {
+                    oldState.doc.nodesBetween(clampedOldFrom, clampedOldTo, function (node) {
+                      if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                        found = true;
+                      }
+                      return !found;
+                    });
+                  }
+                }
+              }
+            });
+            if (found) {
+              stepsTouchMentions = true;
+              newDocRanges.push.apply(newDocRanges, stepNewRanges);
+              oldDocRanges.push.apply(oldDocRanges, stepOldRanges);
+            }
+          });
+          if (stepsTouchMentions || newPluginState.lastInsertedAgentMentionId) {
+            var _newPluginState$lastA, _newPluginState$lastI, _newPluginState$lastI2, _newPluginState$lastI3;
+            var agentMentionId = null;
+            var agentMentionContext = null;
+            var agentMentionParentNodeType = null;
+            var newCount = 0;
+            var oldAgentMentionId = null;
+            var oldCount = 0;
+            if (stepsTouchMentions) {
+              var _iterator = _createForOfIteratorHelper(newDocRanges),
+                _step;
+              try {
+                for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                  var _step$value = _slicedToArray(_step.value, 2),
+                    from = _step$value[0],
+                    to = _step$value[1];
+                  var clampedTo = Math.min(to, newState.doc.content.size);
+                  if (from >= clampedTo) continue;
+                  newState.doc.nodesBetween(from, clampedTo, function (node, _pos, parent) {
+                    if (node.type !== _mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      return true;
+                    }
+                    newCount++;
+                    if (agentMentionId === null && node.attrs.id) {
+                      var _parent$type$name;
+                      agentMentionId = node.attrs.id;
+                      agentMentionParentNodeType = (_parent$type$name = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name !== void 0 ? _parent$type$name : null;
+                      agentMentionContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                    }
+                    return true;
+                  });
+                }
+              } catch (err) {
+                _iterator.e(err);
+              } finally {
+                _iterator.f();
+              }
+              var _iterator2 = _createForOfIteratorHelper(oldDocRanges),
+                _step2;
+              try {
+                for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+                  var _step2$value = _slicedToArray(_step2.value, 2),
+                    _from = _step2$value[0],
+                    _to = _step2$value[1];
+                  var clampedOldTo = Math.min(_to, oldState.doc.content.size);
+                  if (_from >= clampedOldTo) continue;
+                  oldState.doc.nodesBetween(_from, clampedOldTo, function (node) {
+                    if (node.type !== _mentionSchema || !AGENT_USER_TYPES.has(node.attrs.userType)) {
+                      return true;
+                    }
+                    oldCount++;
+                    if (oldAgentMentionId === null && node.attrs.id) {
+                      oldAgentMentionId = node.attrs.id;
+                    }
+                    return true;
+                  });
+                }
+              } catch (err) {
+                _iterator2.e(err);
+              } finally {
+                _iterator2.f();
+              }
+            }
+
+            // When a deletion collapses the new-doc range to a zero-width point, or when
+            // the doc changed but no step covered the tracked mention, the new-doc scan
+            // above finds nothing. Check whether any agent mention survived in the document.
+            var resolvedFromSurvivor = false;
+            if (agentMentionId === null && newPluginState.lastInsertedAgentMentionId) {
+              var prevId = newPluginState.lastInsertedAgentMentionId;
+              var survivorId = null;
+              var survivorContext = null;
+              var survivorParentNodeType = null;
+              newState.doc.descendants(function (node, _pos, parent) {
+                if (survivorId === prevId) return false;
+                if (node.type === _mentionSchema && AGENT_USER_TYPES.has(node.attrs.userType)) {
+                  var _parent$type$name2;
+                  // Prefer the previously tracked ID; otherwise keep the first found.
+                  survivorId = node.attrs.id;
+                  survivorParentNodeType = (_parent$type$name2 = parent === null || parent === void 0 ? void 0 : parent.type.name) !== null && _parent$type$name2 !== void 0 ? _parent$type$name2 : null;
+                  survivorContext = (parent === null || parent === void 0 ? void 0 : parent.textContent.trim()) || null;
+                }
+                return survivorId !== prevId;
+              });
+              if (survivorId !== null) {
+                agentMentionId = survivorId;
+                agentMentionContext = survivorContext;
+                agentMentionParentNodeType = survivorParentNodeType;
+                resolvedFromSurvivor = true;
+              }
+            }
+            var isNewInsertion = agentMentionId !== null && !resolvedFromSurvivor && (oldAgentMentionId !== agentMentionId || newCount > oldCount);
+            var newInsertionCount = isNewInsertion ? ((_newPluginState$lastA = newPluginState.lastAgentMentionInsertionCount) !== null && _newPluginState$lastA !== void 0 ? _newPluginState$lastA : 0) + 1 : undefined;
+            if (agentMentionId !== ((_newPluginState$lastI = newPluginState.lastInsertedAgentMentionId) !== null && _newPluginState$lastI !== void 0 ? _newPluginState$lastI : null) || agentMentionContext !== ((_newPluginState$lastI2 = newPluginState.lastInsertedAgentMentionContext) !== null && _newPluginState$lastI2 !== void 0 ? _newPluginState$lastI2 : null) || agentMentionParentNodeType !== ((_newPluginState$lastI3 = newPluginState.lastInsertedAgentMentionParentNodeType) !== null && _newPluginState$lastI3 !== void 0 ? _newPluginState$lastI3 : null) || newInsertionCount !== undefined) {
+              newPluginState = _objectSpread(_objectSpread({}, newPluginState), {}, {
+                lastInsertedAgentMentionId: agentMentionId,
+                lastInsertedAgentMentionContext: agentMentionContext,
+                lastInsertedAgentMentionParentNodeType: agentMentionParentNodeType
+              }, newInsertionCount !== undefined ? {
+                lastAgentMentionInsertionCount: newInsertionCount
+              } : {});
+              hasNewPluginState = true;
+            }
+          }
+        }
+        if (hasNewPluginState && editorExperiment('platform_editor_agent_mentions', true)) {
+          pmPluginFactoryParams.dispatch(mentionPluginKey, newPluginState);
+        }
         return newPluginState;
       }
     },

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

@@ -17,7 +17,6 @@ export interface MentionPluginConfig {
 export type MentionsChangedHandler = (changes: {
     id: string;
     localId: string;
-    shouldSuppressMentionNotification?: boolean;
     taskLocalId?: string;
     type: 'added' | 'deleted';
 }[]) => void;
@@ -43,6 +42,26 @@ export interface MentionsPluginOptions extends MentionPluginConfig {
 export type MentionPluginOptions = MentionsPluginOptions;
 export type MentionPluginState = {
     canInsertMention?: boolean;
+    /**
+     * Increments on each new agent mention insertion (including re-mentions of the same agent).
+     * Used to trigger re-renders when the same agent is mentioned again.
+     */
+    lastAgentMentionInsertionCount?: number;
+    /**
+     * Plain-text content of the block node containing the agent mention.
+     * Used as a prompt context for Rovo chat.
+     */
+    lastInsertedAgentMentionContext?: string | null;
+    /**
+     * The ID of the most recently inserted agent (APP | AGENT userType) mention.
+     * Null when no agent mention is present in the document.
+     */
+    lastInsertedAgentMentionId?: string | null;
+    /**
+     * ProseMirror node type of the direct parent of the agent mention
+     * (e.g. 'taskItem', 'paragraph'). Determines auto-send vs. draft behaviour.
+     */
+    lastInsertedAgentMentionParentNodeType?: string | null;
     mentionProvider?: MentionProvider;
     mentions?: Array<MentionDescription>;
 };

package/dist/types-ts4.5/types/index.d.ts

@@ -17,7 +17,6 @@ export interface MentionPluginConfig {
 export type MentionsChangedHandler = (changes: {
     id: string;
     localId: string;
-    shouldSuppressMentionNotification?: boolean;
     taskLocalId?: string;
     type: 'added' | 'deleted';
 }[]) => void;
@@ -43,6 +42,26 @@ export interface MentionsPluginOptions extends MentionPluginConfig {
 export type MentionPluginOptions = MentionsPluginOptions;
 export type MentionPluginState = {
     canInsertMention?: boolean;
+    /**
+     * Increments on each new agent mention insertion (including re-mentions of the same agent).
+     * Used to trigger re-renders when the same agent is mentioned again.
+     */
+    lastAgentMentionInsertionCount?: number;
+    /**
+     * Plain-text content of the block node containing the agent mention.
+     * Used as a prompt context for Rovo chat.
+     */
+    lastInsertedAgentMentionContext?: string | null;
+    /**
+     * The ID of the most recently inserted agent (APP | AGENT userType) mention.
+     * Null when no agent mention is present in the document.
+     */
+    lastInsertedAgentMentionId?: string | null;
+    /**
+     * ProseMirror node type of the direct parent of the agent mention
+     * (e.g. 'taskItem', 'paragraph'). Determines auto-send vs. draft behaviour.
+     */
+    lastInsertedAgentMentionParentNodeType?: string | null;
     mentionProvider?: MentionProvider;
     mentions?: Array<MentionDescription>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-mentions",
-	"version": "12.3.0",
+	"version": "12.3.2",
 	"description": "Mentions plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -48,7 +48,7 @@
 		"@atlaskit/profilecard": "^25.7.0",
 		"@atlaskit/teams-app-config": "^1.12.0",
 		"@atlaskit/theme": "^25.0.0",
-		"@atlaskit/tmp-editor-statsig": "^85.0.0",
+		"@atlaskit/tmp-editor-statsig": "^87.0.0",
 		"@atlaskit/tokens": "^13.1.0",
 		"@atlaskit/user-picker": "^12.1.0",
 		"@babel/runtime": "^7.0.0",
@@ -59,7 +59,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^114.54.0",
+		"@atlaskit/editor-common": "^114.55.0",
 		"react": "^18.2.0",
 		"react-dom": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"