@atlaskit/collab-provider 21.0.28 → 21.1.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @atlaskit/collab-provider
 
+## 21.1.0
+
+### Minor Changes
+
+- [`895ac23f1a3be`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/895ac23f1a3be) -
+  Agent edit presence: surface agent-authored collaborative edits to other users.
+  - `collab-provider` detects agent-authored remote steps (`agentType`/`agentId`) and registers a
+    synthetic agent participant in the AI-provider (`agent:`) partition so the agent appears in
+    presence, with a 30s sliding inactivity window (CCI-18030). `editor-common` gains optional
+    `agentId`/`agentType` on the collab step types.
+  - `editor-plugin-collab-edit` + `editor-core` add the in-editor shimmer (CCI-18033): when an
+    agent-authored step lands, the top-level block(s) it touched are covered by a skeleton-loader
+    shimmer (grey skeleton with a moving highlight) with a Rovo agent telepointer/cursor — labelled
+    with the agent's type — at the end of the range, then removed on a timer to reveal the content.
+    Gated behind the default-OFF `platform_editor_agent_be_streaming` experiment; the `durationMs`
+    dynamic-config param controls how long the shimmer stays (0 disables it) and
+    `telepointerDisabled` hides the telepointer. `tmp-editor-statsig` registers the experiment.
+  - `ratcheting` excludes the new `agentShimmerStyles.ts` from the "No unsafe typography" rule (the
+    agent telepointer label mirrors the existing AI in-editor telepointer's sub-token 10px/9px
+    sizing, matching its already-excluded Compiled counterpart).
+
+### Patch Changes
+
+- Updated dependencies
+
+## 21.0.29
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 21.0.28
 
 ### Patch Changes

package/dist/cjs/document/document-service.js

@@ -27,6 +27,9 @@ var _customErrors = require("../errors/custom-errors");
 var _catchupv = require("./catchupv2");
 var _stepQueueState = require("./step-queue-state");
 var _getConflictChanges = require("./getConflictChanges");
+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; }
 // oxlint-disable-next-line @atlassian/no-restricted-imports
@@ -921,6 +924,9 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
           this.stepRejectCounter = 0;
           this.participantsService.emitTelepointersFromSteps(steps);
 
+          // Surface agent edit presence from agent-authored steps.
+          this.maybeAddAgentPresenceFromSteps(steps);
+
           // Resend local steps if none of the received steps originated with us!
           // Ignored via go/ees005
           // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
@@ -940,6 +946,52 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
         }
       }
     }
+
+    /**
+     * Detect agent-authored steps in a received batch and register
+     * each distinct agent as a local participant so it appears in the presence facepile.
+     *
+     * Gated behind a default-OFF feature gate: `collab-provider` is shared platform infra (used by
+     * Jira JWM/JPD etc.), so this is a strict no-op everywhere unless the gate is explicitly enabled.
+     *
+     * Isolated in its own try/catch so a presence failure can never affect step persistence.
+     *
+     * Known limitation (PoC): steps replayed via catch-up/reconnect can briefly re-surface an agent
+     * whose activity is stale — a freshness guard is a follow-up.
+     * @example
+     */
+  }, {
+    key: "maybeAddAgentPresenceFromSteps",
+    value: function maybeAddAgentPresenceFromSteps(steps) {
+      var _this3 = this;
+      if (!(0, _expValEquals.expValEquals)('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+        return;
+      }
+      try {
+        var providerIds = new Set();
+        var _iterator = _createForOfIteratorHelper(steps),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var step = _step.value;
+            var providerId = (0, _utils.getAgentProviderId)(step);
+            if (providerId) {
+              providerIds.add(providerId);
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+        providerIds.forEach(function (providerId) {
+          return _this3.participantsService.upsertAIProviderParticipantLocally(providerId);
+        });
+      } catch (error) {
+        var _this$analyticsHelper34;
+        (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 || _this$analyticsHelper34.sendErrorEvent(error, 'Error while adding agent presence from steps');
+      }
+    }
   }, {
     key: "getIsNamespaceLocked",
     value:
@@ -987,8 +1039,8 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
       var _this$getState0;
       var state = (_this$getState0 = this.getState) === null || _this$getState0 === void 0 ? void 0 : _this$getState0.call(this);
       if (!state) {
-        var _this$analyticsHelper34;
-        (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 || _this$analyticsHelper34.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
+        var _this$analyticsHelper35;
+        (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 || _this$analyticsHelper35.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
         return;
       }
       this.send(null, null, state, sendAnalyticsEvent, reason);
@@ -1010,7 +1062,7 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
     ) {
       var _this$getState1,
         _this$getState10,
-        _this3 = this;
+        _this4 = this;
       var offlineEditingEnabled = (0, _experiments.editorExperiment)('platform_editor_offline_editing_web', true);
       var onlineStepMergingEnabled = (0, _expValEquals.expValEquals)('platform_editor_enable_single_player_step_merging', 'isEnabled', true);
       // We don't trust `_newState` not to be stale
@@ -1039,8 +1091,8 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
       // to ensure that analytics events with the number of unconfirmed steps is only
       // sent once on connection (as opposed to on every step)
       if (sendAnalyticsEvent) {
-        var _this$analyticsHelper35;
-        (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 || _this$analyticsHelper35.sendActionEvent(_const.EVENT_ACTION.HAS_UNCONFIRMED_STEPS, _const.EVENT_STATUS.INFO, {
+        var _this$analyticsHelper36;
+        (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 || _this$analyticsHelper36.sendActionEvent(_const.EVENT_ACTION.HAS_UNCONFIRMED_STEPS, _const.EVENT_STATUS.INFO, {
           numUnconfirmedSteps: (unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length) || 0
         });
       }
@@ -1049,12 +1101,12 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
       }
       var rebased = tr === null || tr === void 0 ? void 0 : tr.getMeta('rebasedData');
       if (rebased) {
-        var _this$analyticsHelper36;
+        var _this$analyticsHelper37;
         var obfuscatedUnconfirmedSteps = this.obfuscateStepsAndState(rebased.unconfirmedSteps).obfuscatedSteps;
         var obfuscatedRemoteSteps = this.obfuscateStepsAndState(rebased.remoteSteps);
         var obfuscatedRebasedSteps = this.obfuscateStepsAndState(unconfirmedSteps).obfuscatedSteps;
         // send analtyics on unconfirmed steps
-        (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 || _this$analyticsHelper36.sendActionEvent(_const.EVENT_ACTION.STEPS_REBASED, _const.EVENT_STATUS.INFO, {
+        (_this$analyticsHelper37 = this.analyticsHelper) === null || _this$analyticsHelper37 === void 0 || _this$analyticsHelper37.sendActionEvent(_const.EVENT_ACTION.STEPS_REBASED, _const.EVENT_STATUS.INFO, {
           obfuscatedUnconfirmedSteps: obfuscatedUnconfirmedSteps,
           obfuscatedRemoteSteps: obfuscatedRemoteSteps,
           obfuscatedRebasedSteps: obfuscatedRebasedSteps,
@@ -1075,8 +1127,8 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
             this.timeout = setTimeout(function () {
               // If the timer expires and we're still online, handle the offline steps.
               // Otherwise, clear the timer so it can restart when we're online again.
-              if (_this3.getConnected()) {
-                _this3.timeoutExceeded = true;
+              if (_this4.getConnected()) {
+                _this4.timeoutExceeded = true;
                 var updatedUnconfirmedStepsData = (0, _prosemirrorCollab.sendableSteps)(newState);
                 updatedUnconfirmedStepsData === null || updatedUnconfirmedStepsData === void 0 || updatedUnconfirmedStepsData.origins.forEach(function (origin) {
                   if (origin instanceof _state.Transaction && origin.getMeta('isOffline')) {
@@ -1084,7 +1136,7 @@ var DocumentService = exports.DocumentService = /*#__PURE__*/function () {
                   }
                 });
               } else {
-                _this3.timeout = undefined;
+                _this4.timeout = undefined;
               }
             }, 6000);
           }

package/dist/cjs/helpers/utils.js

@@ -4,9 +4,10 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isAIProviderID = exports.getSubProduct = exports.getStepsAdfWithObfuscation = exports.getStepUGCFreeDetails = exports.getStepTypes = exports.getStepPositions = exports.getProduct = exports.getObfuscatedSteps = exports.getDocAdfWithObfuscationFromJSON = exports.getDocAdfWithObfuscation = exports.createLogger = void 0;
+exports.isAIProviderID = exports.getSubProduct = exports.getStepsAdfWithObfuscation = exports.getStepUGCFreeDetails = exports.getStepTypes = exports.getStepPositions = exports.getProduct = exports.getObfuscatedSteps = exports.getDocAdfWithObfuscationFromJSON = exports.getDocAdfWithObfuscation = exports.getAgentProviderId = exports.createLogger = void 0;
 exports.isGCPtenant = isGCPtenant;
 exports.logObfuscatedSteps = logObfuscatedSteps;
+exports.normalizeAgentId = void 0;
 exports.sleep = sleep;
 exports.toObfuscatedSteps = toObfuscatedSteps;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
@@ -55,6 +56,32 @@ function sleep(ms) {
 var isAIProviderID = exports.isAIProviderID = function isAIProviderID(id) {
   return typeof id === 'string' && id.startsWith('agent:');
 };
+var IDENTITY_USER_ARI_PREFIX = 'ari:cloud:identity::user/';
+
+/**
+ * Normalises an agent identifier that may arrive as an identity ARI
+ * (`ari:cloud:identity::user/<aaid>`) down to the bare AAID. Any other value is
+ * returned unchanged.
+ */
+var normalizeAgentId = exports.normalizeAgentId = function normalizeAgentId(agentId) {
+  return agentId.startsWith(IDENTITY_USER_ARI_PREFIX) ? agentId.slice(IDENTITY_USER_ARI_PREFIX.length) : agentId;
+};
+
+/**
+ * Derives the synthetic AI-provider participant id (`agent:<id>`) for an
+ * agent-authored step, or `undefined` if the step is not agent-authored.
+ *
+ * `agentType` is the reliable "made by an agent" signal (present even when
+ * `agentId` is not). We key on the agent's AAID when available, otherwise the
+ * agent type (e.g. `mcp`/`twg`), otherwise a generic `agent`.
+ */
+var getAgentProviderId = exports.getAgentProviderId = function getAgentProviderId(step) {
+  if (!step.agentType) {
+    return undefined;
+  }
+  var id = step.agentId ? normalizeAgentId(step.agentId) : step.agentType;
+  return "agent:".concat(id || 'agent');
+};
 var getProduct = exports.getProduct = function getProduct(productInfo) {
   var _productInfo$product;
   return (_productInfo$product = productInfo === null || productInfo === void 0 ? void 0 : productInfo.product) !== null && _productInfo$product !== void 0 ? _productInfo$product : 'unknown';

package/dist/cjs/participants/participants-service.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SINGLE_COLLAB_MODE = exports.ParticipantsService = exports.MULTI_COLLAB_MODE = void 0;
+exports.SINGLE_COLLAB_MODE = exports.ParticipantsService = exports.MULTI_COLLAB_MODE = exports.AGENT_PRESENCE_TTL_MS = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
@@ -25,6 +25,11 @@ var UNIDENTIFIED = 'unidentified';
 var SINGLE_COLLAB_MODE = exports.SINGLE_COLLAB_MODE = 'single';
 var MULTI_COLLAB_MODE = exports.MULTI_COLLAB_MODE = 'collab';
 
+// Sliding inactivity window for agent (AI provider) participants that are added locally from
+// remote agent-authored steps. Reset on each new step for that agent.
+// NOTE: temporary/demonstration lifecycle — long-term expiry may move to NCS.
+var AGENT_PRESENCE_TTL_MS = exports.AGENT_PRESENCE_TTL_MS = 30 * 1000; // 30 seconds
+
 /**
  * This service is responsible for handling presence and participant events, as well as sending them on to the editor or NCS.
  * @param analyticsHelper Analytics helper instance
@@ -58,6 +63,8 @@ var ParticipantsService = exports.ParticipantsService = /*#__PURE__*/function ()
   function ParticipantsService(analyticsHelper, participantsState, emit, getUser, batchProps, channelBroadcast, sendPresenceJoined, getPresenceData, setUserId, getAIProviderActiveIds, fetchAnonymousAsset) {
     var _this = this;
     (0, _classCallCheck2.default)(this, ParticipantsService);
+    // Per-agent sliding inactivity timers, keyed by the agent participant sessionId.
+    (0, _defineProperty2.default)(this, "agentPresenceTimers", new Map());
     (0, _defineProperty2.default)(this, "currentlyPollingFetchUsers", true);
     (0, _defineProperty2.default)(this, "hasBatchFetchError", false);
     (0, _defineProperty2.default)(this, "sendPresenceActivityChanged", function () {
@@ -108,6 +115,93 @@ var ParticipantsService = exports.ParticipantsService = /*#__PURE__*/function ()
         });
       }
     });
+    /**
+     * Locally register — or refresh — an agent participant in the
+     * AI-provider (`agent:`) partition from a received agent-authored step, so the agent appears in
+     * the presence facepile.
+     *
+     * Local-only: mutates this client's participants-state and emits `presence` WITHOUT any socket
+     * broadcast. BE-originated agent steps are already fanned out to every client, so each client
+     * detects the same steps and adds the agent independently — no cross-client coordination needed.
+     *
+     * Deliberately does NOT go through the `getUser` hydration path: agents have no human profile,
+     * so `getUser('agent:<id>')` would 404/throw (and could drop the participant) or add latency;
+     * the agent's display identity is resolved downstream in the facepile.
+     *
+     * `presence` is emitted only on the FIRST add for an agent. Subsequent steps for the same agent
+     * refresh `lastActive` and reset the sliding inactivity timer silently, to avoid churning every
+     * presence consumer on each streamed step.
+     *
+     * @param providerId `agent:<aaid|type>` id of the agent
+     * @example
+     */
+    (0, _defineProperty2.default)(this, "upsertAIProviderParticipantLocally", function (providerId) {
+      var payload = _this.buildAIProviderPresencePayload(providerId);
+      var sessionId = payload.sessionId;
+      var existing = _this.participantsState.getBySessionId(sessionId);
+      var participant = _objectSpread(_objectSpread({}, payload), {}, {
+        // `payload.userId` is typed `string | undefined`; here it is always the (string)
+        // providerId, so pin it to satisfy ProviderParticipant.userId (string).
+        userId: providerId,
+        lastActive: payload.timestamp,
+        // name/avatar/email are intentionally empty: an agent has no human profile here. Its display
+        // identity (name + avatar) is resolved downstream in the facepile from the agent id, so the
+        // provider stays identity-free (no getUser/assistance lookup on this hot path).
+        name: '',
+        avatar: '',
+        email: ''
+      });
+      _this.participantsState.setBySessionId(sessionId, participant);
+
+      // Emit only on the first add; a refresh of an already-present agent shouldn't re-emit.
+      if (!existing) {
+        _this.emitPresence({
+          joined: [participant]
+        }, 'adding agent participant from remote step');
+      }
+      _this.resetAgentPresenceTimer(sessionId);
+    });
+    /**
+     * (Re)starts the sliding 30s inactivity timer for an agent participant. Called on every agent
+     * step so the window slides forward from the agent's most recent activity.
+     * @example
+     */
+    (0, _defineProperty2.default)(this, "resetAgentPresenceTimer", function (sessionId) {
+      var existingTimer = _this.agentPresenceTimers.get(sessionId);
+      if (existingTimer !== undefined) {
+        clearTimeout(existingTimer);
+      }
+      _this.agentPresenceTimers.set(sessionId, window.setTimeout(function () {
+        return _this.removeAgentParticipant(sessionId);
+      }, AGENT_PRESENCE_TTL_MS));
+    });
+    /**
+     * Removes an inactive agent participant once its sliding window elapses and emits the `presence`
+     * leave so the facepile drops it.
+     * @example
+     */
+    (0, _defineProperty2.default)(this, "removeAgentParticipant", function (sessionId) {
+      _this.agentPresenceTimers.delete(sessionId);
+      if (_this.participantsState.getBySessionId(sessionId)) {
+        _this.participantsState.removeBySessionId(sessionId);
+        _this.emitPresence({
+          left: [{
+            sessionId: sessionId
+          }]
+        }, 'removing inactive agent participant');
+      }
+    });
+    /**
+     * Clears all pending agent presence sliding timers (on disconnect/destroy) so they don't fire
+     * against cleared state.
+     * @example
+     */
+    (0, _defineProperty2.default)(this, "clearAgentPresenceTimers", function () {
+      _this.agentPresenceTimers.forEach(function (timer) {
+        return clearTimeout(timer);
+      });
+      _this.agentPresenceTimers.clear();
+    });
     (0, _defineProperty2.default)(this, "hasPresenceActivityChanged", function (previous, current) {
       return previous.presenceActivity !== current.presenceActivity;
     });
@@ -386,6 +480,8 @@ var ParticipantsService = exports.ParticipantsService = /*#__PURE__*/function ()
     (0, _defineProperty2.default)(this, "disconnect", function (reason, sessionId) {
       var left = _this.participantsState.getParticipants();
       _this.participantsState.clear();
+      // Stop any pending agent presence timers so they don't fire against cleared state.
+      _this.clearAgentPresenceTimers();
       try {
         _this.emit('disconnected', {
           reason: (0, _disconnectedReasonMapper.disconnectedReasonMapper)(reason),
@@ -654,6 +750,7 @@ var ParticipantsService = exports.ParticipantsService = /*#__PURE__*/function ()
     (0, _defineProperty2.default)(this, "clearTimers", function () {
       clearTimeout(_this.participantUpdateTimeout);
       clearTimeout(_this.presenceFetchTimeout);
+      _this.clearAgentPresenceTimers();
     });
     (0, _defineProperty2.default)(this, "sendPresence", function () {
       try {

package/dist/cjs/version-wrapper.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.version = exports.nextMajorVersion = exports.name = void 0;
 var name = exports.name = "@atlaskit/collab-provider";
-var version = exports.version = "21.0.27";
+var version = exports.version = "21.0.29";
 var nextMajorVersion = exports.nextMajorVersion = function nextMajorVersion() {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');
 };

package/dist/es2019/document/document-service.js

@@ -9,7 +9,7 @@ import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { ACK_MAX_TRY, EVENT_ACTION, EVENT_STATUS, CatchupEventReason } from '../helpers/const';
 import { MEASURE_NAME, startMeasure, stopMeasure } from '../analytics/performance';
 import { INTERNAL_ERROR_CODE } from '../errors/internal-errors';
-import { createLogger, getDocAdfWithObfuscationFromJSON, getObfuscatedSteps, getStepUGCFreeDetails, sleep } from '../helpers/utils';
+import { createLogger, getAgentProviderId, getDocAdfWithObfuscationFromJSON, getObfuscatedSteps, getStepUGCFreeDetails, sleep } from '../helpers/utils';
 import { MAX_STEP_REJECTED_ERROR, MAX_STEP_REJECTED_ERROR_AGGRESSIVE } from '../provider';
 import { CommitStepService } from '../provider/commit-step';
 import { CantSyncUpError, UpdateDocumentError } from '../errors/custom-errors';
@@ -805,6 +805,9 @@ export class DocumentService {
         this.stepRejectCounter = 0;
         this.participantsService.emitTelepointersFromSteps(steps);
 
+        // Surface agent edit presence from agent-authored steps.
+        this.maybeAddAgentPresenceFromSteps(steps);
+
         // Resend local steps if none of the received steps originated with us!
         // Ignored via go/ees005
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
@@ -822,6 +825,38 @@ export class DocumentService {
       }
     }
   }
+
+  /**
+   * Detect agent-authored steps in a received batch and register
+   * each distinct agent as a local participant so it appears in the presence facepile.
+   *
+   * Gated behind a default-OFF feature gate: `collab-provider` is shared platform infra (used by
+   * Jira JWM/JPD etc.), so this is a strict no-op everywhere unless the gate is explicitly enabled.
+   *
+   * Isolated in its own try/catch so a presence failure can never affect step persistence.
+   *
+   * Known limitation (PoC): steps replayed via catch-up/reconnect can briefly re-surface an agent
+   * whose activity is stale — a freshness guard is a follow-up.
+   * @example
+   */
+  maybeAddAgentPresenceFromSteps(steps) {
+    if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+      return;
+    }
+    try {
+      const providerIds = new Set();
+      for (const step of steps) {
+        const providerId = getAgentProviderId(step);
+        if (providerId) {
+          providerIds.add(providerId);
+        }
+      }
+      providerIds.forEach(providerId => this.participantsService.upsertAIProviderParticipantLocally(providerId));
+    } catch (error) {
+      var _this$analyticsHelper34;
+      (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 ? void 0 : _this$analyticsHelper34.sendErrorEvent(error, 'Error while adding agent presence from steps');
+    }
+  }
   /**
    *
    * @example
@@ -862,8 +897,8 @@ export class DocumentService {
     var _this$getState0;
     const state = (_this$getState0 = this.getState) === null || _this$getState0 === void 0 ? void 0 : _this$getState0.call(this);
     if (!state) {
-      var _this$analyticsHelper34;
-      (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 ? void 0 : _this$analyticsHelper34.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
+      var _this$analyticsHelper35;
+      (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 ? void 0 : _this$analyticsHelper35.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
       return;
     }
     this.send(null, null, state, sendAnalyticsEvent, reason);
@@ -909,8 +944,8 @@ export class DocumentService {
     // to ensure that analytics events with the number of unconfirmed steps is only
     // sent once on connection (as opposed to on every step)
     if (sendAnalyticsEvent) {
-      var _this$analyticsHelper35;
-      (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 ? void 0 : _this$analyticsHelper35.sendActionEvent(EVENT_ACTION.HAS_UNCONFIRMED_STEPS, EVENT_STATUS.INFO, {
+      var _this$analyticsHelper36;
+      (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 ? void 0 : _this$analyticsHelper36.sendActionEvent(EVENT_ACTION.HAS_UNCONFIRMED_STEPS, EVENT_STATUS.INFO, {
         numUnconfirmedSteps: (unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length) || 0
       });
     }
@@ -919,12 +954,12 @@ export class DocumentService {
     }
     const rebased = tr === null || tr === void 0 ? void 0 : tr.getMeta('rebasedData');
     if (rebased) {
-      var _this$analyticsHelper36;
+      var _this$analyticsHelper37;
       const obfuscatedUnconfirmedSteps = this.obfuscateStepsAndState(rebased.unconfirmedSteps).obfuscatedSteps;
       const obfuscatedRemoteSteps = this.obfuscateStepsAndState(rebased.remoteSteps);
       const obfuscatedRebasedSteps = this.obfuscateStepsAndState(unconfirmedSteps).obfuscatedSteps;
       // send analtyics on unconfirmed steps
-      (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 ? void 0 : _this$analyticsHelper36.sendActionEvent(EVENT_ACTION.STEPS_REBASED, EVENT_STATUS.INFO, {
+      (_this$analyticsHelper37 = this.analyticsHelper) === null || _this$analyticsHelper37 === void 0 ? void 0 : _this$analyticsHelper37.sendActionEvent(EVENT_ACTION.STEPS_REBASED, EVENT_STATUS.INFO, {
         obfuscatedUnconfirmedSteps,
         obfuscatedRemoteSteps,
         obfuscatedRebasedSteps,

package/dist/es2019/helpers/utils.js

@@ -33,6 +33,30 @@ export function sleep(ms) {
  * provider (e.g. immediate `presence` emission and agent-leave cleanup).
  */
 export const isAIProviderID = id => typeof id === 'string' && id.startsWith('agent:');
+const IDENTITY_USER_ARI_PREFIX = 'ari:cloud:identity::user/';
+
+/**
+ * Normalises an agent identifier that may arrive as an identity ARI
+ * (`ari:cloud:identity::user/<aaid>`) down to the bare AAID. Any other value is
+ * returned unchanged.
+ */
+export const normalizeAgentId = agentId => agentId.startsWith(IDENTITY_USER_ARI_PREFIX) ? agentId.slice(IDENTITY_USER_ARI_PREFIX.length) : agentId;
+
+/**
+ * Derives the synthetic AI-provider participant id (`agent:<id>`) for an
+ * agent-authored step, or `undefined` if the step is not agent-authored.
+ *
+ * `agentType` is the reliable "made by an agent" signal (present even when
+ * `agentId` is not). We key on the agent's AAID when available, otherwise the
+ * agent type (e.g. `mcp`/`twg`), otherwise a generic `agent`.
+ */
+export const getAgentProviderId = step => {
+  if (!step.agentType) {
+    return undefined;
+  }
+  const id = step.agentId ? normalizeAgentId(step.agentId) : step.agentType;
+  return `agent:${id || 'agent'}`;
+};
 export const getProduct = productInfo => {
   var _productInfo$product;
   return (_productInfo$product = productInfo === null || productInfo === void 0 ? void 0 : productInfo.product) !== null && _productInfo$product !== void 0 ? _productInfo$product : 'unknown';

package/dist/es2019/participants/participants-service.js

@@ -12,6 +12,11 @@ const UNIDENTIFIED = 'unidentified';
 export const SINGLE_COLLAB_MODE = 'single';
 export const MULTI_COLLAB_MODE = 'collab';
 
+// Sliding inactivity window for agent (AI provider) participants that are added locally from
+// remote agent-authored steps. Reset on each new step for that agent.
+// NOTE: temporary/demonstration lifecycle — long-term expiry may move to NCS.
+export const AGENT_PRESENCE_TTL_MS = 30 * 1000; // 30 seconds
+
 /**
  * This service is responsible for handling presence and participant events, as well as sending them on to the editor or NCS.
  * @param analyticsHelper Analytics helper instance
@@ -43,6 +48,8 @@ export class ParticipantsService {
    * @example
    */
   constructor(analyticsHelper, participantsState, emit, getUser, batchProps, channelBroadcast, sendPresenceJoined, getPresenceData, setUserId, getAIProviderActiveIds, fetchAnonymousAsset) {
+    // Per-agent sliding inactivity timers, keyed by the agent participant sessionId.
+    _defineProperty(this, "agentPresenceTimers", new Map());
     _defineProperty(this, "currentlyPollingFetchUsers", true);
     _defineProperty(this, "hasBatchFetchError", false);
     _defineProperty(this, "sendPresenceActivityChanged", () => {
@@ -93,6 +100,92 @@ export class ParticipantsService {
         });
       }
     });
+    /**
+     * Locally register — or refresh — an agent participant in the
+     * AI-provider (`agent:`) partition from a received agent-authored step, so the agent appears in
+     * the presence facepile.
+     *
+     * Local-only: mutates this client's participants-state and emits `presence` WITHOUT any socket
+     * broadcast. BE-originated agent steps are already fanned out to every client, so each client
+     * detects the same steps and adds the agent independently — no cross-client coordination needed.
+     *
+     * Deliberately does NOT go through the `getUser` hydration path: agents have no human profile,
+     * so `getUser('agent:<id>')` would 404/throw (and could drop the participant) or add latency;
+     * the agent's display identity is resolved downstream in the facepile.
+     *
+     * `presence` is emitted only on the FIRST add for an agent. Subsequent steps for the same agent
+     * refresh `lastActive` and reset the sliding inactivity timer silently, to avoid churning every
+     * presence consumer on each streamed step.
+     *
+     * @param providerId `agent:<aaid|type>` id of the agent
+     * @example
+     */
+    _defineProperty(this, "upsertAIProviderParticipantLocally", providerId => {
+      const payload = this.buildAIProviderPresencePayload(providerId);
+      const {
+        sessionId
+      } = payload;
+      const existing = this.participantsState.getBySessionId(sessionId);
+      const participant = {
+        ...payload,
+        // `payload.userId` is typed `string | undefined`; here it is always the (string)
+        // providerId, so pin it to satisfy ProviderParticipant.userId (string).
+        userId: providerId,
+        lastActive: payload.timestamp,
+        // name/avatar/email are intentionally empty: an agent has no human profile here. Its display
+        // identity (name + avatar) is resolved downstream in the facepile from the agent id, so the
+        // provider stays identity-free (no getUser/assistance lookup on this hot path).
+        name: '',
+        avatar: '',
+        email: ''
+      };
+      this.participantsState.setBySessionId(sessionId, participant);
+
+      // Emit only on the first add; a refresh of an already-present agent shouldn't re-emit.
+      if (!existing) {
+        this.emitPresence({
+          joined: [participant]
+        }, 'adding agent participant from remote step');
+      }
+      this.resetAgentPresenceTimer(sessionId);
+    });
+    /**
+     * (Re)starts the sliding 30s inactivity timer for an agent participant. Called on every agent
+     * step so the window slides forward from the agent's most recent activity.
+     * @example
+     */
+    _defineProperty(this, "resetAgentPresenceTimer", sessionId => {
+      const existingTimer = this.agentPresenceTimers.get(sessionId);
+      if (existingTimer !== undefined) {
+        clearTimeout(existingTimer);
+      }
+      this.agentPresenceTimers.set(sessionId, window.setTimeout(() => this.removeAgentParticipant(sessionId), AGENT_PRESENCE_TTL_MS));
+    });
+    /**
+     * Removes an inactive agent participant once its sliding window elapses and emits the `presence`
+     * leave so the facepile drops it.
+     * @example
+     */
+    _defineProperty(this, "removeAgentParticipant", sessionId => {
+      this.agentPresenceTimers.delete(sessionId);
+      if (this.participantsState.getBySessionId(sessionId)) {
+        this.participantsState.removeBySessionId(sessionId);
+        this.emitPresence({
+          left: [{
+            sessionId
+          }]
+        }, 'removing inactive agent participant');
+      }
+    });
+    /**
+     * Clears all pending agent presence sliding timers (on disconnect/destroy) so they don't fire
+     * against cleared state.
+     * @example
+     */
+    _defineProperty(this, "clearAgentPresenceTimers", () => {
+      this.agentPresenceTimers.forEach(timer => clearTimeout(timer));
+      this.agentPresenceTimers.clear();
+    });
     _defineProperty(this, "hasPresenceActivityChanged", (previous, current) => {
       return previous.presenceActivity !== current.presenceActivity;
     });
@@ -294,6 +387,8 @@ export class ParticipantsService {
     _defineProperty(this, "disconnect", (reason, sessionId) => {
       const left = this.participantsState.getParticipants();
       this.participantsState.clear();
+      // Stop any pending agent presence timers so they don't fire against cleared state.
+      this.clearAgentPresenceTimers();
       try {
         this.emit('disconnected', {
           reason: disconnectedReasonMapper(reason),
@@ -495,6 +590,7 @@ export class ParticipantsService {
     _defineProperty(this, "clearTimers", () => {
       clearTimeout(this.participantUpdateTimeout);
       clearTimeout(this.presenceFetchTimeout);
+      this.clearAgentPresenceTimers();
     });
     _defineProperty(this, "sendPresence", () => {
       try {

package/dist/es2019/version-wrapper.js

@@ -1,5 +1,5 @@
 export const name = "@atlaskit/collab-provider";
-export const version = "21.0.27";
+export const version = "21.0.29";
 export const nextMajorVersion = () => {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');
 };

package/dist/esm/document/document-service.js

@@ -2,6 +2,9 @@ import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 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; }
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -15,7 +18,7 @@ import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { ACK_MAX_TRY, EVENT_ACTION, EVENT_STATUS, CatchupEventReason } from '../helpers/const';
 import { MEASURE_NAME, startMeasure, stopMeasure } from '../analytics/performance';
 import { INTERNAL_ERROR_CODE } from '../errors/internal-errors';
-import { createLogger, getDocAdfWithObfuscationFromJSON, getObfuscatedSteps, getStepUGCFreeDetails, sleep } from '../helpers/utils';
+import { createLogger, getAgentProviderId, getDocAdfWithObfuscationFromJSON, getObfuscatedSteps, getStepUGCFreeDetails, sleep } from '../helpers/utils';
 import { MAX_STEP_REJECTED_ERROR, MAX_STEP_REJECTED_ERROR_AGGRESSIVE } from '../provider';
 import { CommitStepService } from '../provider/commit-step';
 import { CantSyncUpError, UpdateDocumentError } from '../errors/custom-errors';
@@ -915,6 +918,9 @@ export var DocumentService = /*#__PURE__*/function () {
           this.stepRejectCounter = 0;
           this.participantsService.emitTelepointersFromSteps(steps);
 
+          // Surface agent edit presence from agent-authored steps.
+          this.maybeAddAgentPresenceFromSteps(steps);
+
           // Resend local steps if none of the received steps originated with us!
           // Ignored via go/ees005
           // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
@@ -934,6 +940,52 @@ export var DocumentService = /*#__PURE__*/function () {
         }
       }
     }
+
+    /**
+     * Detect agent-authored steps in a received batch and register
+     * each distinct agent as a local participant so it appears in the presence facepile.
+     *
+     * Gated behind a default-OFF feature gate: `collab-provider` is shared platform infra (used by
+     * Jira JWM/JPD etc.), so this is a strict no-op everywhere unless the gate is explicitly enabled.
+     *
+     * Isolated in its own try/catch so a presence failure can never affect step persistence.
+     *
+     * Known limitation (PoC): steps replayed via catch-up/reconnect can briefly re-surface an agent
+     * whose activity is stale — a freshness guard is a follow-up.
+     * @example
+     */
+  }, {
+    key: "maybeAddAgentPresenceFromSteps",
+    value: function maybeAddAgentPresenceFromSteps(steps) {
+      var _this3 = this;
+      if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+        return;
+      }
+      try {
+        var providerIds = new Set();
+        var _iterator = _createForOfIteratorHelper(steps),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var step = _step.value;
+            var providerId = getAgentProviderId(step);
+            if (providerId) {
+              providerIds.add(providerId);
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+        providerIds.forEach(function (providerId) {
+          return _this3.participantsService.upsertAIProviderParticipantLocally(providerId);
+        });
+      } catch (error) {
+        var _this$analyticsHelper34;
+        (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 || _this$analyticsHelper34.sendErrorEvent(error, 'Error while adding agent presence from steps');
+      }
+    }
   }, {
     key: "getIsNamespaceLocked",
     value:
@@ -981,8 +1033,8 @@ export var DocumentService = /*#__PURE__*/function () {
       var _this$getState0;
       var state = (_this$getState0 = this.getState) === null || _this$getState0 === void 0 ? void 0 : _this$getState0.call(this);
       if (!state) {
-        var _this$analyticsHelper34;
-        (_this$analyticsHelper34 = this.analyticsHelper) === null || _this$analyticsHelper34 === void 0 || _this$analyticsHelper34.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
+        var _this$analyticsHelper35;
+        (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 || _this$analyticsHelper35.sendErrorEvent(new Error('Editor state is undefined'), 'sendStepsFromCurrentState called without state');
         return;
       }
       this.send(null, null, state, sendAnalyticsEvent, reason);
@@ -1004,7 +1056,7 @@ export var DocumentService = /*#__PURE__*/function () {
     ) {
       var _this$getState1,
         _this$getState10,
-        _this3 = this;
+        _this4 = this;
       var offlineEditingEnabled = editorExperiment('platform_editor_offline_editing_web', true);
       var onlineStepMergingEnabled = expValEquals('platform_editor_enable_single_player_step_merging', 'isEnabled', true);
       // We don't trust `_newState` not to be stale
@@ -1033,8 +1085,8 @@ export var DocumentService = /*#__PURE__*/function () {
       // to ensure that analytics events with the number of unconfirmed steps is only
       // sent once on connection (as opposed to on every step)
       if (sendAnalyticsEvent) {
-        var _this$analyticsHelper35;
-        (_this$analyticsHelper35 = this.analyticsHelper) === null || _this$analyticsHelper35 === void 0 || _this$analyticsHelper35.sendActionEvent(EVENT_ACTION.HAS_UNCONFIRMED_STEPS, EVENT_STATUS.INFO, {
+        var _this$analyticsHelper36;
+        (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 || _this$analyticsHelper36.sendActionEvent(EVENT_ACTION.HAS_UNCONFIRMED_STEPS, EVENT_STATUS.INFO, {
           numUnconfirmedSteps: (unconfirmedSteps === null || unconfirmedSteps === void 0 ? void 0 : unconfirmedSteps.length) || 0
         });
       }
@@ -1043,12 +1095,12 @@ export var DocumentService = /*#__PURE__*/function () {
       }
       var rebased = tr === null || tr === void 0 ? void 0 : tr.getMeta('rebasedData');
       if (rebased) {
-        var _this$analyticsHelper36;
+        var _this$analyticsHelper37;
         var obfuscatedUnconfirmedSteps = this.obfuscateStepsAndState(rebased.unconfirmedSteps).obfuscatedSteps;
         var obfuscatedRemoteSteps = this.obfuscateStepsAndState(rebased.remoteSteps);
         var obfuscatedRebasedSteps = this.obfuscateStepsAndState(unconfirmedSteps).obfuscatedSteps;
         // send analtyics on unconfirmed steps
-        (_this$analyticsHelper36 = this.analyticsHelper) === null || _this$analyticsHelper36 === void 0 || _this$analyticsHelper36.sendActionEvent(EVENT_ACTION.STEPS_REBASED, EVENT_STATUS.INFO, {
+        (_this$analyticsHelper37 = this.analyticsHelper) === null || _this$analyticsHelper37 === void 0 || _this$analyticsHelper37.sendActionEvent(EVENT_ACTION.STEPS_REBASED, EVENT_STATUS.INFO, {
           obfuscatedUnconfirmedSteps: obfuscatedUnconfirmedSteps,
           obfuscatedRemoteSteps: obfuscatedRemoteSteps,
           obfuscatedRebasedSteps: obfuscatedRebasedSteps,
@@ -1069,8 +1121,8 @@ export var DocumentService = /*#__PURE__*/function () {
             this.timeout = setTimeout(function () {
               // If the timer expires and we're still online, handle the offline steps.
               // Otherwise, clear the timer so it can restart when we're online again.
-              if (_this3.getConnected()) {
-                _this3.timeoutExceeded = true;
+              if (_this4.getConnected()) {
+                _this4.timeoutExceeded = true;
                 var updatedUnconfirmedStepsData = sendableSteps(newState);
                 updatedUnconfirmedStepsData === null || updatedUnconfirmedStepsData === void 0 || updatedUnconfirmedStepsData.origins.forEach(function (origin) {
                   if (origin instanceof Transaction && origin.getMeta('isOffline')) {
@@ -1078,7 +1130,7 @@ export var DocumentService = /*#__PURE__*/function () {
                   }
                 });
               } else {
-                _this3.timeout = undefined;
+                _this4.timeout = undefined;
               }
             }, 6000);
           }

package/dist/esm/helpers/utils.js

@@ -45,6 +45,32 @@ export function sleep(ms) {
 export var isAIProviderID = function isAIProviderID(id) {
   return typeof id === 'string' && id.startsWith('agent:');
 };
+var IDENTITY_USER_ARI_PREFIX = 'ari:cloud:identity::user/';
+
+/**
+ * Normalises an agent identifier that may arrive as an identity ARI
+ * (`ari:cloud:identity::user/<aaid>`) down to the bare AAID. Any other value is
+ * returned unchanged.
+ */
+export var normalizeAgentId = function normalizeAgentId(agentId) {
+  return agentId.startsWith(IDENTITY_USER_ARI_PREFIX) ? agentId.slice(IDENTITY_USER_ARI_PREFIX.length) : agentId;
+};
+
+/**
+ * Derives the synthetic AI-provider participant id (`agent:<id>`) for an
+ * agent-authored step, or `undefined` if the step is not agent-authored.
+ *
+ * `agentType` is the reliable "made by an agent" signal (present even when
+ * `agentId` is not). We key on the agent's AAID when available, otherwise the
+ * agent type (e.g. `mcp`/`twg`), otherwise a generic `agent`.
+ */
+export var getAgentProviderId = function getAgentProviderId(step) {
+  if (!step.agentType) {
+    return undefined;
+  }
+  var id = step.agentId ? normalizeAgentId(step.agentId) : step.agentType;
+  return "agent:".concat(id || 'agent');
+};
 export var getProduct = function getProduct(productInfo) {
   var _productInfo$product;
   return (_productInfo$product = productInfo === null || productInfo === void 0 ? void 0 : productInfo.product) !== null && _productInfo$product !== void 0 ? _productInfo$product : 'unknown';

package/dist/esm/participants/participants-service.js

@@ -18,6 +18,11 @@ var UNIDENTIFIED = 'unidentified';
 export var SINGLE_COLLAB_MODE = 'single';
 export var MULTI_COLLAB_MODE = 'collab';
 
+// Sliding inactivity window for agent (AI provider) participants that are added locally from
+// remote agent-authored steps. Reset on each new step for that agent.
+// NOTE: temporary/demonstration lifecycle — long-term expiry may move to NCS.
+export var AGENT_PRESENCE_TTL_MS = 30 * 1000; // 30 seconds
+
 /**
  * This service is responsible for handling presence and participant events, as well as sending them on to the editor or NCS.
  * @param analyticsHelper Analytics helper instance
@@ -51,6 +56,8 @@ export var ParticipantsService = /*#__PURE__*/function () {
   function ParticipantsService(analyticsHelper, participantsState, emit, getUser, batchProps, channelBroadcast, sendPresenceJoined, getPresenceData, setUserId, getAIProviderActiveIds, fetchAnonymousAsset) {
     var _this = this;
     _classCallCheck(this, ParticipantsService);
+    // Per-agent sliding inactivity timers, keyed by the agent participant sessionId.
+    _defineProperty(this, "agentPresenceTimers", new Map());
     _defineProperty(this, "currentlyPollingFetchUsers", true);
     _defineProperty(this, "hasBatchFetchError", false);
     _defineProperty(this, "sendPresenceActivityChanged", function () {
@@ -101,6 +108,93 @@ export var ParticipantsService = /*#__PURE__*/function () {
         });
       }
     });
+    /**
+     * Locally register — or refresh — an agent participant in the
+     * AI-provider (`agent:`) partition from a received agent-authored step, so the agent appears in
+     * the presence facepile.
+     *
+     * Local-only: mutates this client's participants-state and emits `presence` WITHOUT any socket
+     * broadcast. BE-originated agent steps are already fanned out to every client, so each client
+     * detects the same steps and adds the agent independently — no cross-client coordination needed.
+     *
+     * Deliberately does NOT go through the `getUser` hydration path: agents have no human profile,
+     * so `getUser('agent:<id>')` would 404/throw (and could drop the participant) or add latency;
+     * the agent's display identity is resolved downstream in the facepile.
+     *
+     * `presence` is emitted only on the FIRST add for an agent. Subsequent steps for the same agent
+     * refresh `lastActive` and reset the sliding inactivity timer silently, to avoid churning every
+     * presence consumer on each streamed step.
+     *
+     * @param providerId `agent:<aaid|type>` id of the agent
+     * @example
+     */
+    _defineProperty(this, "upsertAIProviderParticipantLocally", function (providerId) {
+      var payload = _this.buildAIProviderPresencePayload(providerId);
+      var sessionId = payload.sessionId;
+      var existing = _this.participantsState.getBySessionId(sessionId);
+      var participant = _objectSpread(_objectSpread({}, payload), {}, {
+        // `payload.userId` is typed `string | undefined`; here it is always the (string)
+        // providerId, so pin it to satisfy ProviderParticipant.userId (string).
+        userId: providerId,
+        lastActive: payload.timestamp,
+        // name/avatar/email are intentionally empty: an agent has no human profile here. Its display
+        // identity (name + avatar) is resolved downstream in the facepile from the agent id, so the
+        // provider stays identity-free (no getUser/assistance lookup on this hot path).
+        name: '',
+        avatar: '',
+        email: ''
+      });
+      _this.participantsState.setBySessionId(sessionId, participant);
+
+      // Emit only on the first add; a refresh of an already-present agent shouldn't re-emit.
+      if (!existing) {
+        _this.emitPresence({
+          joined: [participant]
+        }, 'adding agent participant from remote step');
+      }
+      _this.resetAgentPresenceTimer(sessionId);
+    });
+    /**
+     * (Re)starts the sliding 30s inactivity timer for an agent participant. Called on every agent
+     * step so the window slides forward from the agent's most recent activity.
+     * @example
+     */
+    _defineProperty(this, "resetAgentPresenceTimer", function (sessionId) {
+      var existingTimer = _this.agentPresenceTimers.get(sessionId);
+      if (existingTimer !== undefined) {
+        clearTimeout(existingTimer);
+      }
+      _this.agentPresenceTimers.set(sessionId, window.setTimeout(function () {
+        return _this.removeAgentParticipant(sessionId);
+      }, AGENT_PRESENCE_TTL_MS));
+    });
+    /**
+     * Removes an inactive agent participant once its sliding window elapses and emits the `presence`
+     * leave so the facepile drops it.
+     * @example
+     */
+    _defineProperty(this, "removeAgentParticipant", function (sessionId) {
+      _this.agentPresenceTimers.delete(sessionId);
+      if (_this.participantsState.getBySessionId(sessionId)) {
+        _this.participantsState.removeBySessionId(sessionId);
+        _this.emitPresence({
+          left: [{
+            sessionId: sessionId
+          }]
+        }, 'removing inactive agent participant');
+      }
+    });
+    /**
+     * Clears all pending agent presence sliding timers (on disconnect/destroy) so they don't fire
+     * against cleared state.
+     * @example
+     */
+    _defineProperty(this, "clearAgentPresenceTimers", function () {
+      _this.agentPresenceTimers.forEach(function (timer) {
+        return clearTimeout(timer);
+      });
+      _this.agentPresenceTimers.clear();
+    });
     _defineProperty(this, "hasPresenceActivityChanged", function (previous, current) {
       return previous.presenceActivity !== current.presenceActivity;
     });
@@ -379,6 +473,8 @@ export var ParticipantsService = /*#__PURE__*/function () {
     _defineProperty(this, "disconnect", function (reason, sessionId) {
       var left = _this.participantsState.getParticipants();
       _this.participantsState.clear();
+      // Stop any pending agent presence timers so they don't fire against cleared state.
+      _this.clearAgentPresenceTimers();
       try {
         _this.emit('disconnected', {
           reason: disconnectedReasonMapper(reason),
@@ -647,6 +743,7 @@ export var ParticipantsService = /*#__PURE__*/function () {
     _defineProperty(this, "clearTimers", function () {
       clearTimeout(_this.participantUpdateTimeout);
       clearTimeout(_this.presenceFetchTimeout);
+      _this.clearAgentPresenceTimers();
     });
     _defineProperty(this, "sendPresence", function () {
       try {

package/dist/esm/version-wrapper.js

@@ -1,5 +1,5 @@
 export var name = "@atlaskit/collab-provider";
-export var version = "21.0.27";
+export var version = "21.0.29";
 export var nextMajorVersion = function nextMajorVersion() {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');
 };

package/dist/types/document/document-service.d.ts

@@ -94,6 +94,20 @@ export declare class DocumentService implements DocumentServiceInterface {
     getCurrentState: () => Promise<ResolvedEditorState>;
     private isStepsFromNewClientIdForSameUserId;
     private processSteps;
+    /**
+     * Detect agent-authored steps in a received batch and register
+     * each distinct agent as a local participant so it appears in the presence facepile.
+     *
+     * Gated behind a default-OFF feature gate: `collab-provider` is shared platform infra (used by
+     * Jira JWM/JPD etc.), so this is a strict no-op everywhere unless the gate is explicitly enabled.
+     *
+     * Isolated in its own try/catch so a presence failure can never affect step persistence.
+     *
+     * Known limitation (PoC): steps replayed via catch-up/reconnect can briefly re-surface an agent
+     * whose activity is stale — a freshness guard is a follow-up.
+     * @example
+     */
+    private maybeAddAgentPresenceFromSteps;
     getUnconfirmedStepsOrigins: () => readonly Transaction[] | undefined;
     getUnconfirmedSteps: () => readonly ProseMirrorStep[] | undefined;
     private applyLocalSteps;
@@ -104,20 +118,9 @@ export declare class DocumentService implements DocumentServiceInterface {
      */
     onStepsAdded: (data: StepsPayload) => void;
     obfuscateStepsAndState: (unconfirmedSteps: readonly ProseMirrorStep[] | undefined, currentState?: ResolvedEditorState<JSONDocNode>) => {
+        obfuscatedDoc: string | ADFEntity | null | undefined;
         obfuscatedSteps: string | {
-            stepType: {
-                type: string;
-                contentTypes: string | null;
-            };
             stepContent: ADFEntity[] | null;
-            stepPositions: {
-                pos?: number | undefined;
-                insert?: number | undefined;
-                gapFrom?: number | undefined;
-                gapTo?: number | undefined;
-                from?: number | undefined;
-                to?: number | undefined;
-            };
             stepMetadata: {
                 createdOffline?: boolean;
                 prevStepId?: string;
@@ -129,8 +132,19 @@ export declare class DocumentService implements DocumentServiceInterface {
                 traceId?: string;
                 unconfirmedStepAfterRecovery?: boolean;
             } | undefined;
+            stepPositions: {
+                from?: number | undefined;
+                gapFrom?: number | undefined;
+                gapTo?: number | undefined;
+                insert?: number | undefined;
+                pos?: number | undefined;
+                to?: number | undefined;
+            };
+            stepType: {
+                contentTypes: string | null;
+                type: string;
+            };
         }[];
-        obfuscatedDoc: string | ADFEntity | null | undefined;
     };
     onRestore: ({ doc, version, metadata, targetClientId, }: CollabInitPayload) => Promise<void>;
     getFinalAcknowledgedState: (reason: GetResolvedEditorStateReason) => Promise<ResolvedEditorState>;

package/dist/types/helpers/utils.d.ts

@@ -18,6 +18,24 @@ export declare function sleep(ms: number): Promise<any>;
  * provider (e.g. immediate `presence` emission and agent-leave cleanup).
  */
 export declare const isAIProviderID: (id: string) => boolean;
+/**
+ * Normalises an agent identifier that may arrive as an identity ARI
+ * (`ari:cloud:identity::user/<aaid>`) down to the bare AAID. Any other value is
+ * returned unchanged.
+ */
+export declare const normalizeAgentId: (agentId: string) => string;
+/**
+ * Derives the synthetic AI-provider participant id (`agent:<id>`) for an
+ * agent-authored step, or `undefined` if the step is not agent-authored.
+ *
+ * `agentType` is the reliable "made by an agent" signal (present even when
+ * `agentId` is not). We key on the agent's AAID when available, otherwise the
+ * agent type (e.g. `mcp`/`twg`), otherwise a generic `agent`.
+ */
+export declare const getAgentProviderId: (step: {
+    agentId?: string;
+    agentType?: string;
+}) => string | undefined;
 export declare const getProduct: (productInfo?: ProductInformation) => string;
 export declare const getSubProduct: (productInfo?: ProductInformation) => string;
 export type UGCFreeStepDetails = {

package/dist/types/participants/participants-service.d.ts

@@ -6,6 +6,7 @@ import { ParticipantsState } from './participants-state';
 import type { ParticipantFilter } from './participants-state';
 export declare const SINGLE_COLLAB_MODE = "single";
 export declare const MULTI_COLLAB_MODE = "collab";
+export declare const AGENT_PRESENCE_TTL_MS: number;
 /**
  * This service is responsible for handling presence and participant events, as well as sending them on to the editor or NCS.
  * @param analyticsHelper Analytics helper instance
@@ -29,6 +30,7 @@ export declare class ParticipantsService {
     private participantUpdateTimeout;
     private presenceUpdateTimeout;
     private presenceFetchTimeout;
+    private agentPresenceTimers;
     private currentlyPollingFetchUsers;
     private hasBatchFetchError;
     private participantsState;
@@ -62,6 +64,45 @@ export declare class ParticipantsService {
     private sendAIProviderParticipantUpdated;
     private sendAIProviderParticipantLeft;
     private sendAIProvidersPresence;
+    /**
+     * Locally register — or refresh — an agent participant in the
+     * AI-provider (`agent:`) partition from a received agent-authored step, so the agent appears in
+     * the presence facepile.
+     *
+     * Local-only: mutates this client's participants-state and emits `presence` WITHOUT any socket
+     * broadcast. BE-originated agent steps are already fanned out to every client, so each client
+     * detects the same steps and adds the agent independently — no cross-client coordination needed.
+     *
+     * Deliberately does NOT go through the `getUser` hydration path: agents have no human profile,
+     * so `getUser('agent:<id>')` would 404/throw (and could drop the participant) or add latency;
+     * the agent's display identity is resolved downstream in the facepile.
+     *
+     * `presence` is emitted only on the FIRST add for an agent. Subsequent steps for the same agent
+     * refresh `lastActive` and reset the sliding inactivity timer silently, to avoid churning every
+     * presence consumer on each streamed step.
+     *
+     * @param providerId `agent:<aaid|type>` id of the agent
+     * @example
+     */
+    upsertAIProviderParticipantLocally: (providerId: string) => void;
+    /**
+     * (Re)starts the sliding 30s inactivity timer for an agent participant. Called on every agent
+     * step so the window slides forward from the agent's most recent activity.
+     * @example
+     */
+    private resetAgentPresenceTimer;
+    /**
+     * Removes an inactive agent participant once its sliding window elapses and emits the `presence`
+     * leave so the facepile drops it.
+     * @example
+     */
+    private removeAgentParticipant;
+    /**
+     * Clears all pending agent presence sliding timers (on disconnect/destroy) so they don't fire
+     * against cleared state.
+     * @example
+     */
+    private clearAgentPresenceTimers;
     private hasPresenceActivityChanged;
     private handleAnonymousUser;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/collab-provider",
-	"version": "21.0.28",
+	"version": "21.1.0",
 	"description": "A provider for collaborative editing.",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -29,7 +29,7 @@
 		"@atlaskit/platform-feature-flags": "^2.1.0",
 		"@atlaskit/prosemirror-collab": "^1.0.0",
 		"@atlaskit/react-ufo": "^7.3.0",
-		"@atlaskit/tmp-editor-statsig": "^131.0.0",
+		"@atlaskit/tmp-editor-statsig": "^132.3.0",
 		"@atlaskit/ufo": "^1.0.0",
 		"@atlaskit/util-service-support": "^7.2.0",
 		"@babel/runtime": "^7.0.0",
@@ -65,9 +65,12 @@
 		},
 		"collab_edit_via_websocket_only_for_gcp": {
 			"type": "boolean"
+		},
+		"platform_editor_agent_be_streaming": {
+			"type": "experiment"
 		}
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^116.35.0"
+		"@atlaskit/editor-common": "^116.36.0"
 	}
 }