@agent-native/core 0.85.7 → 0.86.0

package/dist/collab/agent-presence.js

@@ -5,41 +5,70 @@
  * collaborator — it "enters" a document, its edits are visible with
  * durable presence, and it "leaves" when done. Actions call these
  * instead of hand-rolling HTTP awareness calls.
+ *
+ * Presence lingers after the agent finishes editing (default 6s) so viewers
+ * get a moment to see who just changed what — the same way a human
+ * collaborator's cursor doesn't vanish the instant they stop typing. Recent
+ * edits are attributed in the awareness state (`recentEdits`, `lastEditAt`)
+ * so clients can render fading highlights over the edited regions.
+ *
+ * On serverless hosts the linger timer may never fire after the response is
+ * sent; the 30s awareness expiry then removes the entry, so presence degrades
+ * to "up to 30s" instead of leaking.
  */
 import { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY } from "./agent-identity.js";
-import { getDocAwareness } from "./awareness.js";
+import { deleteAwarenessRow, upsertAwarenessRow } from "./awareness-store.js";
+import { emitAwarenessChange, getDocAwareness, } from "./awareness.js";
+import { appendRecentEdit } from "./recent-edits.js";
 import { searchAndReplace } from "./ydoc-manager.js";
 const HEARTBEAT_INTERVAL = 10_000; // 10 seconds
+/** How long agent presence lingers after leave/last edit before clearing. */
+export const AGENT_PRESENCE_LINGER_MS = 6_000;
 // docId → heartbeat interval handle
 const _heartbeats = new Map();
 // docId → reference count (how many concurrent operations are using this doc)
 const _refCounts = new Map();
-/**
- * Mark the agent as present on a document.
- *
- * Sets an awareness entry for the agent and starts a heartbeat that
- * keeps it alive. If the agent is already present on this doc, just
- * refreshes `lastSeen` without creating a second interval.
- */
-export function agentEnterDocument(docId, metadata) {
+// docId → pending linger-removal timer
+const _lingerTimers = new Map();
+function cancelLinger(docId) {
+    const timer = _lingerTimers.get(docId);
+    if (timer) {
+        clearTimeout(timer);
+        _lingerTimers.delete(docId);
+    }
+}
+function removeAgentPresence(docId) {
+    cancelLinger(docId);
     const map = getDocAwareness(docId);
-    const state = JSON.stringify({
-        user: {
-            name: DEFAULT_AGENT_IDENTITY.name,
-            email: DEFAULT_AGENT_IDENTITY.email,
-            color: DEFAULT_AGENT_IDENTITY.color,
-        },
-        ...metadata,
-    });
-    const entry = {
-        clientId: AGENT_CLIENT_ID,
-        state,
-        lastSeen: Date.now(),
-    };
-    map.set(AGENT_CLIENT_ID, entry);
-    // Increment reference count
-    _refCounts.set(docId, (_refCounts.get(docId) ?? 0) + 1);
-    // Don't create another interval if one already exists
+    map.delete(AGENT_CLIENT_ID);
+    emitAwarenessChange(docId, currentAwarenessStates(map));
+    // Cross-instance removal (serverless) — best-effort, never blocks.
+    void deleteAwarenessRow(docId, AGENT_CLIENT_ID);
+    const interval = _heartbeats.get(docId);
+    if (interval) {
+        clearInterval(interval);
+        _heartbeats.delete(docId);
+    }
+}
+function scheduleLingerRemoval(docId, lingerMs) {
+    cancelLinger(docId);
+    if (lingerMs <= 0) {
+        removeAgentPresence(docId);
+        return;
+    }
+    const timer = setTimeout(() => {
+        _lingerTimers.delete(docId);
+        // A new operation may have re-entered while we waited.
+        if ((_refCounts.get(docId) ?? 0) > 0)
+            return;
+        removeAgentPresence(docId);
+    }, lingerMs);
+    if (typeof timer === "object" && "unref" in timer) {
+        timer.unref();
+    }
+    _lingerTimers.set(docId, timer);
+}
+function ensureHeartbeat(docId) {
     if (_heartbeats.has(docId))
         return;
     const interval = setInterval(() => {
@@ -47,6 +76,9 @@ export function agentEnterDocument(docId, metadata) {
         const existing = m.get(AGENT_CLIENT_ID);
         if (existing) {
             existing.lastSeen = Date.now();
+            // Keep the SQL mirror fresh too, or remote-instance pollers would see
+            // the agent expire mid-operation (store throttles unchanged writes).
+            void upsertAwarenessRow(docId, AGENT_CLIENT_ID, existing.state, existing.lastSeen);
         }
     }, HEARTBEAT_INTERVAL);
     // Don't block Node from exiting if this is the only timer left
@@ -55,54 +87,108 @@ export function agentEnterDocument(docId, metadata) {
     }
     _heartbeats.set(docId, interval);
 }
+function currentAwarenessStates(map) {
+    return Array.from(map, ([clientId, entry]) => ({
+        clientId,
+        state: entry.state,
+    }));
+}
+function readAgentState(docId) {
+    const existing = getDocAwareness(docId).get(AGENT_CLIENT_ID);
+    if (existing) {
+        try {
+            return JSON.parse(existing.state);
+        }
+        catch {
+            // Invalid state — fall through to defaults
+        }
+    }
+    return {
+        user: {
+            name: DEFAULT_AGENT_IDENTITY.name,
+            email: DEFAULT_AGENT_IDENTITY.email,
+            color: DEFAULT_AGENT_IDENTITY.color,
+        },
+    };
+}
+function writeAgentState(docId, state) {
+    const entry = {
+        clientId: AGENT_CLIENT_ID,
+        state: JSON.stringify(state),
+        lastSeen: Date.now(),
+    };
+    const map = getDocAwareness(docId);
+    map.set(AGENT_CLIENT_ID, entry);
+    emitAwarenessChange(docId, currentAwarenessStates(map));
+    // Mirror to SQL so pollers on other instances see the agent — an action
+    // often runs in a different serverless invocation than the poll route.
+    void upsertAwarenessRow(docId, AGENT_CLIENT_ID, entry.state, entry.lastSeen);
+}
+/**
+ * Mark the agent as present on a document.
+ *
+ * Sets an awareness entry for the agent and starts a heartbeat that
+ * keeps it alive. If the agent is already present on this doc (including
+ * lingering after a previous edit), refreshes state without creating a
+ * second interval.
+ */
+export function agentEnterDocument(docId, metadata) {
+    cancelLinger(docId);
+    const state = { ...readAgentState(docId), ...metadata };
+    writeAgentState(docId, state);
+    // Increment reference count
+    _refCounts.set(docId, (_refCounts.get(docId) ?? 0) + 1);
+    ensureHeartbeat(docId);
+}
 /**
- * Remove the agent's presence from a document.
+ * Release the agent's presence on a document.
  *
- * Clears the awareness entry and stops the heartbeat.
+ * Decrements the reference count; when it reaches zero the awareness entry
+ * lingers for `lingerMs` (default 6s) and is then removed. Viewers see the
+ * agent avatar/highlights for a beat after the edit completes instead of an
+ * instant disappearance.
  */
-export function agentLeaveDocument(docId) {
+export function agentLeaveDocument(docId, options) {
     const count = (_refCounts.get(docId) ?? 1) - 1;
     if (count > 0) {
         _refCounts.set(docId, count);
         return;
     }
     _refCounts.delete(docId);
-    const map = getDocAwareness(docId);
-    map.delete(AGENT_CLIENT_ID);
-    const interval = _heartbeats.get(docId);
-    if (interval) {
-        clearInterval(interval);
-        _heartbeats.delete(docId);
-    }
+    scheduleLingerRemoval(docId, options?.lingerMs ?? AGENT_PRESENCE_LINGER_MS);
 }
 /**
  * Update the agent's awareness state to include selection info
  * (e.g., which track, panel, or element the agent is working on).
  */
 export function agentUpdateSelection(docId, selection) {
-    const map = getDocAwareness(docId);
-    const existing = map.get(AGENT_CLIENT_ID);
-    let parsed = {
-        user: {
-            name: DEFAULT_AGENT_IDENTITY.name,
-            email: DEFAULT_AGENT_IDENTITY.email,
-            color: DEFAULT_AGENT_IDENTITY.color,
-        },
-    };
-    if (existing) {
-        try {
-            parsed = JSON.parse(existing.state);
-        }
-        catch {
-            // Invalid state — use defaults
-        }
+    const state = { ...readAgentState(docId), ...selection };
+    writeAgentState(docId, state);
+}
+/**
+ * Record an agent edit on a document without requiring an explicit
+ * enter/leave pair. Used by the collab write paths so ANY agent edit
+ * produces visible presence + lingering attribution automatically.
+ *
+ * - Upserts the agent awareness entry (identity preserved/merged).
+ * - Appends to the `recentEdits` ring and bumps `lastEditAt`.
+ * - When no explicit operation is in flight (refcount 0), (re)schedules a
+ *   linger removal so presence fades out on its own.
+ */
+export function agentTouchDocument(docId, options) {
+    cancelLinger(docId);
+    const state = { ...readAgentState(docId), ...(options?.metadata ?? {}) };
+    const now = Date.now();
+    if (options?.edit) {
+        const { at, ...rest } = options.edit;
+        state.recentEdits = appendRecentEdit(state.recentEdits, { ...rest, at: at ?? now });
+    }
+    state.lastEditAt = now;
+    writeAgentState(docId, state);
+    ensureHeartbeat(docId);
+    if ((_refCounts.get(docId) ?? 0) === 0) {
+        scheduleLingerRemoval(docId, options?.lingerMs ?? AGENT_PRESENCE_LINGER_MS);
     }
-    const state = JSON.stringify({ ...parsed, ...selection });
-    map.set(AGENT_CLIENT_ID, {
-        clientId: AGENT_CLIENT_ID,
-        state,
-        lastSeen: Date.now(),
-    });
 }
 /**
  * Apply search-and-replace edits incrementally so each one appears

package/dist/collab/agent-presence.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-presence.js","sourceRoot":"","sources":["../../src/collab/agent-presence.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Server-side agent presence lifecycle for collaborative editing.\n *\n * Provides enter/leave semantics so the agent behaves like a real\n * collaborator — it \"enters\" a document, its edits are visible with\n * durable presence, and it \"leaves\" when done. Actions call these\n * instead of hand-rolling HTTP awareness calls.\n */\n\nimport { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY } from \"./agent-identity.js\";\nimport { getDocAwareness, type AwarenessEntry } from \"./awareness.js\";\nimport { searchAndReplace } from \"./ydoc-manager.js\";\n\nconst HEARTBEAT_INTERVAL = 10_000; // 10 seconds\n\n// docId → heartbeat interval handle\nconst _heartbeats = new Map<string, NodeJS.Timeout>();\n// docId → reference count (how many concurrent operations are using this doc)\nconst _refCounts = new Map<string, number>();\n\n/**\n * Mark the agent as present on a document.\n *\n * Sets an awareness entry for the agent and starts a heartbeat that\n * keeps it alive. If the agent is already present on this doc, just\n * refreshes `lastSeen` without creating a second interval.\n */\nexport function agentEnterDocument(\n  docId: string,\n  metadata?: Record<string, unknown>,\n): void {\n  const map = getDocAwareness(docId);\n\n  const state = JSON.stringify({\n    user: {\n      name: DEFAULT_AGENT_IDENTITY.name,\n      email: DEFAULT_AGENT_IDENTITY.email,\n      color: DEFAULT_AGENT_IDENTITY.color,\n    },\n    ...metadata,\n  });\n\n  const entry: AwarenessEntry = {\n    clientId: AGENT_CLIENT_ID,\n    state,\n    lastSeen: Date.now(),\n  };\n  map.set(AGENT_CLIENT_ID, entry);\n\n  // Increment reference count\n  _refCounts.set(docId, (_refCounts.get(docId) ?? 0) + 1);\n\n  // Don't create another interval if one already exists\n  if (_heartbeats.has(docId)) return;\n\n  const interval = setInterval(() => {\n    const m = getDocAwareness(docId);\n    const existing = m.get(AGENT_CLIENT_ID);\n    if (existing) {\n      existing.lastSeen = Date.now();\n    }\n  }, HEARTBEAT_INTERVAL);\n\n  // Don't block Node from exiting if this is the only timer left\n  if (typeof interval === \"object\" && \"unref\" in interval) {\n    interval.unref();\n  }\n\n  _heartbeats.set(docId, interval);\n}\n\n/**\n * Remove the agent's presence from a document.\n *\n * Clears the awareness entry and stops the heartbeat.\n */\nexport function agentLeaveDocument(docId: string): void {\n  const count = (_refCounts.get(docId) ?? 1) - 1;\n  if (count > 0) {\n    _refCounts.set(docId, count);\n    return;\n  }\n  _refCounts.delete(docId);\n\n  const map = getDocAwareness(docId);\n  map.delete(AGENT_CLIENT_ID);\n\n  const interval = _heartbeats.get(docId);\n  if (interval) {\n    clearInterval(interval);\n    _heartbeats.delete(docId);\n  }\n}\n\n/**\n * Update the agent's awareness state to include selection info\n * (e.g., which track, panel, or element the agent is working on).\n */\nexport function agentUpdateSelection(\n  docId: string,\n  selection: Record<string, unknown>,\n): void {\n  const map = getDocAwareness(docId);\n  const existing = map.get(AGENT_CLIENT_ID);\n\n  let parsed: Record<string, unknown> = {\n    user: {\n      name: DEFAULT_AGENT_IDENTITY.name,\n      email: DEFAULT_AGENT_IDENTITY.email,\n      color: DEFAULT_AGENT_IDENTITY.color,\n    },\n  };\n\n  if (existing) {\n    try {\n      parsed = JSON.parse(existing.state) as Record<string, unknown>;\n    } catch {\n      // Invalid state — use defaults\n    }\n  }\n\n  const state = JSON.stringify({ ...parsed, ...selection });\n  map.set(AGENT_CLIENT_ID, {\n    clientId: AGENT_CLIENT_ID,\n    state,\n    lastSeen: Date.now(),\n  });\n}\n\n/**\n * Apply search-and-replace edits incrementally so each one appears\n * as a separate poll event to connected clients.\n *\n * Enters the document before editing and leaves in a finally block.\n */\nexport async function agentApplyEditsIncrementally(\n  docId: string,\n  edits: Array<{ find: string; replace: string }>,\n  options?: { delayMs?: number },\n): Promise<void> {\n  const delayMs = options?.delayMs ?? 150;\n  agentEnterDocument(docId);\n\n  try {\n    for (const edit of edits) {\n      await searchAndReplace(docId, edit.find, edit.replace, \"agent\");\n      if (delayMs > 0) {\n        await new Promise((r) => setTimeout(r, delayMs));\n      }\n    }\n  } finally {\n    agentLeaveDocument(docId);\n  }\n}\n\n/**\n * Apply structured data patches incrementally so each one appears\n * as a separate poll event to connected clients.\n *\n * Enters the document before patching and leaves in a finally block.\n */\nexport async function agentApplyPatchesIncrementally(\n  docId: string,\n  fieldName: string,\n  patches: Array<{\n    op: string;\n    path: string;\n    value?: unknown;\n    index?: number;\n    from?: number;\n    to?: number;\n  }>,\n  options?: { delayMs?: number },\n): Promise<void> {\n  const delayMs = options?.delayMs ?? 150;\n  agentEnterDocument(docId);\n\n  try {\n    // Resolve applyPatchOps dynamically so a build that strips it (or a partial\n    // upgrade) fails loudly here rather than at module load time.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let applyPatchOps: any;\n    try {\n      const mod = await import(\"./ydoc-manager.js\");\n      applyPatchOps = (mod as Record<string, unknown>).applyPatchOps;\n    } catch {\n      throw new Error(\n        \"applyPatchOps is not available yet — Phase 1 must complete first\",\n      );\n    }\n\n    if (typeof applyPatchOps !== \"function\") {\n      throw new Error(\n        \"applyPatchOps is not available yet — Phase 1 must complete first\",\n      );\n    }\n\n    for (const patch of patches) {\n      await applyPatchOps(docId, [patch], fieldName, \"agent\");\n      if (delayMs > 0) {\n        await new Promise((r) => setTimeout(r, delayMs));\n      }\n    }\n  } finally {\n    agentLeaveDocument(docId);\n  }\n}\n"]}
+{"version":3,"file":"agent-presence.js","sourceRoot":"","sources":["../../src/collab/agent-presence.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Server-side agent presence lifecycle for collaborative editing.\n *\n * Provides enter/leave semantics so the agent behaves like a real\n * collaborator — it \"enters\" a document, its edits are visible with\n * durable presence, and it \"leaves\" when done. Actions call these\n * instead of hand-rolling HTTP awareness calls.\n *\n * Presence lingers after the agent finishes editing (default 6s) so viewers\n * get a moment to see who just changed what — the same way a human\n * collaborator's cursor doesn't vanish the instant they stop typing. Recent\n * edits are attributed in the awareness state (`recentEdits`, `lastEditAt`)\n * so clients can render fading highlights over the edited regions.\n *\n * On serverless hosts the linger timer may never fire after the response is\n * sent; the 30s awareness expiry then removes the entry, so presence degrades\n * to \"up to 30s\" instead of leaking.\n */\n\nimport { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY } from \"./agent-identity.js\";\nimport { deleteAwarenessRow, upsertAwarenessRow } from \"./awareness-store.js\";\nimport {\n  emitAwarenessChange,\n  getDocAwareness,\n  type AwarenessEntry,\n} from \"./awareness.js\";\nimport { appendRecentEdit, type RecentEdit } from \"./recent-edits.js\";\nimport { searchAndReplace } from \"./ydoc-manager.js\";\n\nconst HEARTBEAT_INTERVAL = 10_000; // 10 seconds\n\n/** How long agent presence lingers after leave/last edit before clearing. */\nexport const AGENT_PRESENCE_LINGER_MS = 6_000;\n\n// docId → heartbeat interval handle\nconst _heartbeats = new Map<string, NodeJS.Timeout>();\n// docId → reference count (how many concurrent operations are using this doc)\nconst _refCounts = new Map<string, number>();\n// docId → pending linger-removal timer\nconst _lingerTimers = new Map<string, NodeJS.Timeout>();\n\nfunction cancelLinger(docId: string): void {\n  const timer = _lingerTimers.get(docId);\n  if (timer) {\n    clearTimeout(timer);\n    _lingerTimers.delete(docId);\n  }\n}\n\nfunction removeAgentPresence(docId: string): void {\n  cancelLinger(docId);\n  const map = getDocAwareness(docId);\n  map.delete(AGENT_CLIENT_ID);\n  emitAwarenessChange(docId, currentAwarenessStates(map));\n  // Cross-instance removal (serverless) — best-effort, never blocks.\n  void deleteAwarenessRow(docId, AGENT_CLIENT_ID);\n\n  const interval = _heartbeats.get(docId);\n  if (interval) {\n    clearInterval(interval);\n    _heartbeats.delete(docId);\n  }\n}\n\nfunction scheduleLingerRemoval(docId: string, lingerMs: number): void {\n  cancelLinger(docId);\n  if (lingerMs <= 0) {\n    removeAgentPresence(docId);\n    return;\n  }\n  const timer = setTimeout(() => {\n    _lingerTimers.delete(docId);\n    // A new operation may have re-entered while we waited.\n    if ((_refCounts.get(docId) ?? 0) > 0) return;\n    removeAgentPresence(docId);\n  }, lingerMs);\n  if (typeof timer === \"object\" && \"unref\" in timer) {\n    timer.unref();\n  }\n  _lingerTimers.set(docId, timer);\n}\n\nfunction ensureHeartbeat(docId: string): void {\n  if (_heartbeats.has(docId)) return;\n\n  const interval = setInterval(() => {\n    const m = getDocAwareness(docId);\n    const existing = m.get(AGENT_CLIENT_ID);\n    if (existing) {\n      existing.lastSeen = Date.now();\n      // Keep the SQL mirror fresh too, or remote-instance pollers would see\n      // the agent expire mid-operation (store throttles unchanged writes).\n      void upsertAwarenessRow(\n        docId,\n        AGENT_CLIENT_ID,\n        existing.state,\n        existing.lastSeen,\n      );\n    }\n  }, HEARTBEAT_INTERVAL);\n\n  // Don't block Node from exiting if this is the only timer left\n  if (typeof interval === \"object\" && \"unref\" in interval) {\n    interval.unref();\n  }\n\n  _heartbeats.set(docId, interval);\n}\n\nfunction currentAwarenessStates(map: Map<number, AwarenessEntry>) {\n  return Array.from(map, ([clientId, entry]) => ({\n    clientId,\n    state: entry.state,\n  }));\n}\n\nfunction readAgentState(docId: string): Record<string, unknown> {\n  const existing = getDocAwareness(docId).get(AGENT_CLIENT_ID);\n  if (existing) {\n    try {\n      return JSON.parse(existing.state) as Record<string, unknown>;\n    } catch {\n      // Invalid state — fall through to defaults\n    }\n  }\n  return {\n    user: {\n      name: DEFAULT_AGENT_IDENTITY.name,\n      email: DEFAULT_AGENT_IDENTITY.email,\n      color: DEFAULT_AGENT_IDENTITY.color,\n    },\n  };\n}\n\nfunction writeAgentState(docId: string, state: Record<string, unknown>): void {\n  const entry: AwarenessEntry = {\n    clientId: AGENT_CLIENT_ID,\n    state: JSON.stringify(state),\n    lastSeen: Date.now(),\n  };\n  const map = getDocAwareness(docId);\n  map.set(AGENT_CLIENT_ID, entry);\n  emitAwarenessChange(docId, currentAwarenessStates(map));\n  // Mirror to SQL so pollers on other instances see the agent — an action\n  // often runs in a different serverless invocation than the poll route.\n  void upsertAwarenessRow(docId, AGENT_CLIENT_ID, entry.state, entry.lastSeen);\n}\n\n/**\n * Mark the agent as present on a document.\n *\n * Sets an awareness entry for the agent and starts a heartbeat that\n * keeps it alive. If the agent is already present on this doc (including\n * lingering after a previous edit), refreshes state without creating a\n * second interval.\n */\nexport function agentEnterDocument(\n  docId: string,\n  metadata?: Record<string, unknown>,\n): void {\n  cancelLinger(docId);\n\n  const state = { ...readAgentState(docId), ...metadata };\n  writeAgentState(docId, state);\n\n  // Increment reference count\n  _refCounts.set(docId, (_refCounts.get(docId) ?? 0) + 1);\n\n  ensureHeartbeat(docId);\n}\n\nexport interface AgentLeaveOptions {\n  /**\n   * How long presence lingers before the awareness entry clears.\n   * Defaults to {@link AGENT_PRESENCE_LINGER_MS}. Pass 0 to clear\n   * immediately (e.g. when an operation failed before editing anything).\n   */\n  lingerMs?: number;\n}\n\n/**\n * Release the agent's presence on a document.\n *\n * Decrements the reference count; when it reaches zero the awareness entry\n * lingers for `lingerMs` (default 6s) and is then removed. Viewers see the\n * agent avatar/highlights for a beat after the edit completes instead of an\n * instant disappearance.\n */\nexport function agentLeaveDocument(\n  docId: string,\n  options?: AgentLeaveOptions,\n): void {\n  const count = (_refCounts.get(docId) ?? 1) - 1;\n  if (count > 0) {\n    _refCounts.set(docId, count);\n    return;\n  }\n  _refCounts.delete(docId);\n\n  scheduleLingerRemoval(docId, options?.lingerMs ?? AGENT_PRESENCE_LINGER_MS);\n}\n\n/**\n * Update the agent's awareness state to include selection info\n * (e.g., which track, panel, or element the agent is working on).\n */\nexport function agentUpdateSelection(\n  docId: string,\n  selection: Record<string, unknown>,\n): void {\n  const state = { ...readAgentState(docId), ...selection };\n  writeAgentState(docId, state);\n}\n\nexport interface AgentTouchOptions {\n  /** Region descriptor + label recorded in the agent's recentEdits ring. */\n  edit?: Omit<RecentEdit, \"at\"> & { at?: number };\n  /** Extra awareness fields to merge (e.g. `selection`). */\n  metadata?: Record<string, unknown>;\n  /** Linger before auto-clearing when no enter/leave pair is active. */\n  lingerMs?: number;\n}\n\n/**\n * Record an agent edit on a document without requiring an explicit\n * enter/leave pair. Used by the collab write paths so ANY agent edit\n * produces visible presence + lingering attribution automatically.\n *\n * - Upserts the agent awareness entry (identity preserved/merged).\n * - Appends to the `recentEdits` ring and bumps `lastEditAt`.\n * - When no explicit operation is in flight (refcount 0), (re)schedules a\n *   linger removal so presence fades out on its own.\n */\nexport function agentTouchDocument(\n  docId: string,\n  options?: AgentTouchOptions,\n): void {\n  cancelLinger(docId);\n\n  const state = { ...readAgentState(docId), ...(options?.metadata ?? {}) };\n  const now = Date.now();\n  if (options?.edit) {\n    const { at, ...rest } = options.edit;\n    state.recentEdits = appendRecentEdit(\n      state.recentEdits as RecentEdit[] | undefined,\n      { ...rest, at: at ?? now },\n    );\n  }\n  state.lastEditAt = now;\n  writeAgentState(docId, state);\n\n  ensureHeartbeat(docId);\n\n  if ((_refCounts.get(docId) ?? 0) === 0) {\n    scheduleLingerRemoval(docId, options?.lingerMs ?? AGENT_PRESENCE_LINGER_MS);\n  }\n}\n\n/**\n * Apply search-and-replace edits incrementally so each one appears\n * as a separate poll event to connected clients.\n *\n * Enters the document before editing and leaves in a finally block.\n */\nexport async function agentApplyEditsIncrementally(\n  docId: string,\n  edits: Array<{ find: string; replace: string }>,\n  options?: { delayMs?: number },\n): Promise<void> {\n  const delayMs = options?.delayMs ?? 150;\n  agentEnterDocument(docId);\n\n  try {\n    for (const edit of edits) {\n      await searchAndReplace(docId, edit.find, edit.replace, \"agent\");\n      if (delayMs > 0) {\n        await new Promise((r) => setTimeout(r, delayMs));\n      }\n    }\n  } finally {\n    agentLeaveDocument(docId);\n  }\n}\n\n/**\n * Apply structured data patches incrementally so each one appears\n * as a separate poll event to connected clients.\n *\n * Enters the document before patching and leaves in a finally block.\n */\nexport async function agentApplyPatchesIncrementally(\n  docId: string,\n  fieldName: string,\n  patches: Array<{\n    op: string;\n    path: string;\n    value?: unknown;\n    index?: number;\n    from?: number;\n    to?: number;\n  }>,\n  options?: { delayMs?: number },\n): Promise<void> {\n  const delayMs = options?.delayMs ?? 150;\n  agentEnterDocument(docId);\n\n  try {\n    // Resolve applyPatchOps dynamically so a build that strips it (or a partial\n    // upgrade) fails loudly here rather than at module load time.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let applyPatchOps: any;\n    try {\n      const mod = await import(\"./ydoc-manager.js\");\n      applyPatchOps = (mod as Record<string, unknown>).applyPatchOps;\n    } catch {\n      throw new Error(\n        \"applyPatchOps is not available yet — Phase 1 must complete first\",\n      );\n    }\n\n    if (typeof applyPatchOps !== \"function\") {\n      throw new Error(\n        \"applyPatchOps is not available yet — Phase 1 must complete first\",\n      );\n    }\n\n    for (const patch of patches) {\n      await applyPatchOps(docId, [patch], fieldName, \"agent\");\n      if (delayMs > 0) {\n        await new Promise((r) => setTimeout(r, delayMs));\n      }\n    }\n  } finally {\n    agentLeaveDocument(docId);\n  }\n}\n"]}

package/dist/collab/awareness-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SQL-backed awareness store — makes presence work across serverless
+ * instances.
+ *
+ * The in-memory awareness map in `awareness.ts` is per-process: on a
+ * multi-instance/serverless deployment, a cursor published to instance A is
+ * invisible to a client polling instance B, and an agent action running in
+ * its own invocation can't reach the SSE instance's memory at all. This
+ * store mirrors awareness rows into a `_collab_awareness` table (SQLite +
+ * Postgres portable) so every instance serves the same participant set.
+ *
+ * Everything here is best-effort: presence must never fail or slow down an
+ * edit. Writes are throttled per (docId, clientId) and skipped when the
+ * state hasn't changed; expired rows are purged opportunistically.
+ */
+import type { AwarenessEntry } from "./awareness.js";
+/**
+ * Mirror a client's awareness state to SQL. Throttled: unchanged state is
+ * rewritten at most every {@link WRITE_THROTTLE_MS} (to refresh last_seen).
+ * Never throws.
+ */
+export declare function upsertAwarenessRow(docId: string, clientId: number, state: string, lastSeen: number): Promise<void>;
+/** Remove a client's row (participant left). Never throws. */
+export declare function deleteAwarenessRow(docId: string, clientId: number): Promise<void>;
+/**
+ * Load non-expired awareness rows for a document. Returns [] on any
+ * failure (memory-only degradation).
+ */
+export declare function loadAwarenessRows(docId: string, now?: number): Promise<AwarenessEntry[]>;
+/** Test hook: reset module-level throttles. */
+export declare function _resetAwarenessStoreForTests(): void;
+//# sourceMappingURL=awareness-store.d.ts.map

package/dist/collab/awareness-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awareness-store.d.ts","sourceRoot":"","sources":["../../src/collab/awareness-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkDrD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,8DAA8D;AAC9D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B;AAaD,+CAA+C;AAC/C,wBAAgB,4BAA4B,IAAI,IAAI,CAInD"}

package/dist/collab/awareness-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awareness-store.js","sourceRoot":"","sources":["../../src/collab/awareness-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL-backed awareness store — makes presence work across serverless\n * instances.\n *\n * The in-memory awareness map in `awareness.ts` is per-process: on a\n * multi-instance/serverless deployment, a cursor published to instance A is\n * invisible to a client polling instance B, and an agent action running in\n * its own invocation can't reach the SSE instance's memory at all. This\n * store mirrors awareness rows into a `_collab_awareness` table (SQLite +\n * Postgres portable) so every instance serves the same participant set.\n *\n * Everything here is best-effort: presence must never fail or slow down an\n * edit. Writes are throttled per (docId, clientId) and skipped when the\n * state hasn't changed; expired rows are purged opportunistically.\n */\n\nimport { getDbExec, isPostgres } from \"../db/client.js\";\nimport { ensureTableExists } from \"../db/ddl-guard.js\";\nimport type { AwarenessEntry } from \"./awareness.js\";\n\n/** Rows older than this are treated as expired (matches AWARENESS_TIMEOUT). */\nconst ROW_TTL_MS = 30_000;\n\n/** Minimum interval between DB writes for an unchanged (docId, clientId). */\nconst WRITE_THROTTLE_MS = 2_000;\n\n/** Minimum interval between opportunistic purges per document. */\nconst PURGE_INTERVAL_MS = 30_000;\n\nlet _initPromise: Promise<void> | undefined;\n\nasync function ensureTable(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      // client_id is a Yjs uint32 (can exceed int32 max) and last_seen is\n      // epoch milliseconds — both need BIGINT-range columns.\n      const createSql = `\n        CREATE TABLE IF NOT EXISTS _collab_awareness (\n          doc_id TEXT NOT NULL,\n          client_id BIGINT NOT NULL,\n          state TEXT NOT NULL,\n          last_seen BIGINT NOT NULL,\n          PRIMARY KEY (doc_id, client_id)\n        )\n      `;\n      if (isPostgres()) {\n        await ensureTableExists(\"_collab_awareness\", createSql);\n        return;\n      }\n      await client.execute(createSql);\n    })().catch((err) => {\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\n// (docId\u0000clientId) → { state, writtenAt } for write throttling.\nconst _lastWrites = new Map<string, { state: string; writtenAt: number }>();\n// docId → last purge time.\nconst _lastPurges = new Map<string, number>();\n\nfunction writeKey(docId: string, clientId: number): string {\n  return `${docId}\u0000${clientId}`;\n}\n\n/**\n * Mirror a client's awareness state to SQL. Throttled: unchanged state is\n * rewritten at most every {@link WRITE_THROTTLE_MS} (to refresh last_seen).\n * Never throws.\n */\nexport async function upsertAwarenessRow(\n  docId: string,\n  clientId: number,\n  state: string,\n  lastSeen: number,\n): Promise<void> {\n  try {\n    const key = writeKey(docId, clientId);\n    const prev = _lastWrites.get(key);\n    if (\n      prev &&\n      prev.state === state &&\n      lastSeen - prev.writtenAt < WRITE_THROTTLE_MS\n    ) {\n      return;\n    }\n\n    await ensureTable();\n    const client = getDbExec();\n    if (isPostgres()) {\n      await client.execute({\n        sql: `INSERT INTO _collab_awareness (doc_id, client_id, state, last_seen)\n              VALUES (?, ?, ?, ?)\n              ON CONFLICT (doc_id, client_id)\n              DO UPDATE SET state = EXCLUDED.state, last_seen = EXCLUDED.last_seen`,\n        args: [docId, clientId, state, lastSeen],\n      });\n    } else {\n      await client.execute({\n        sql: `INSERT OR REPLACE INTO _collab_awareness (doc_id, client_id, state, last_seen)\n              VALUES (?, ?, ?, ?)`,\n        args: [docId, clientId, state, lastSeen],\n      });\n    }\n    _lastWrites.set(key, { state, writtenAt: lastSeen });\n\n    await maybePurge(docId, lastSeen);\n  } catch {\n    // Best-effort — presence never fails a request.\n  }\n}\n\n/** Remove a client's row (participant left). Never throws. */\nexport async function deleteAwarenessRow(\n  docId: string,\n  clientId: number,\n): Promise<void> {\n  try {\n    await ensureTable();\n    const client = getDbExec();\n    await client.execute({\n      sql: `DELETE FROM _collab_awareness WHERE doc_id = ? AND client_id = ?`,\n      args: [docId, clientId],\n    });\n    _lastWrites.delete(writeKey(docId, clientId));\n  } catch {\n    // Best-effort.\n  }\n}\n\n/**\n * Load non-expired awareness rows for a document. Returns [] on any\n * failure (memory-only degradation).\n */\nexport async function loadAwarenessRows(\n  docId: string,\n  now: number = Date.now(),\n): Promise<AwarenessEntry[]> {\n  try {\n    await ensureTable();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT client_id, state, last_seen FROM _collab_awareness\n            WHERE doc_id = ? AND last_seen >= ?`,\n      args: [docId, now - ROW_TTL_MS],\n    });\n    return rows.map((row: any) => ({\n      clientId: Number(row.client_id),\n      state: String(row.state),\n      lastSeen: Number(row.last_seen),\n    }));\n  } catch {\n    return [];\n  }\n}\n\nasync function maybePurge(docId: string, now: number): Promise<void> {\n  const last = _lastPurges.get(docId) ?? 0;\n  if (now - last < PURGE_INTERVAL_MS) return;\n  _lastPurges.set(docId, now);\n  const client = getDbExec();\n  await client.execute({\n    sql: `DELETE FROM _collab_awareness WHERE doc_id = ? AND last_seen < ?`,\n    args: [docId, now - ROW_TTL_MS * 2],\n  });\n}\n\n/** Test hook: reset module-level throttles. */\nexport function _resetAwarenessStoreForTests(): void {\n  _lastWrites.clear();\n  _lastPurges.clear();\n  _initPromise = undefined;\n}\n"]}

package/dist/collab/awareness.d.ts

@@ -29,12 +29,23 @@ export interface AwarenessChangeEvent {
     owner?: string;
     /** Org ID for org-scoped delivery. */
     orgId?: string;
+    /** Shareable resource type this awareness event belongs to, when known. */
+    resourceType?: string;
+    /** Shareable resource id this awareness event belongs to, when known. */
+    resourceId?: string;
+}
+export interface AwarenessScope {
+    owner?: string;
+    orgId?: string;
+    resourceType?: string;
+    resourceId?: string;
 }
 export declare function getAwarenessEmitter(): EventEmitter;
+export declare function rememberAwarenessScope(docId: string, scope: AwarenessScope | undefined): void;
 export declare function emitAwarenessChange(docId: string, states: Array<{
     clientId: number;
     state: string;
-}>, owner?: string, orgId?: string): void;
+}>, scope?: AwarenessScope): void;
 export declare function getDocAwareness(docId: string): Map<number, AwarenessEntry>;
 export declare function cleanExpired(map: Map<number, AwarenessEntry>): void;
 /**

package/dist/collab/awareness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAuCa,MAAM;eAAS,MAAM;;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAWM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAe3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GAAG,SAAS,GAChC,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAgBN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AA6BD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAqDa,MAAM;eAAS,MAAM;;;GAoB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAYM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}

package/dist/collab/awareness.js

@@ -11,7 +11,9 @@
  */
 import { EventEmitter } from "node:events";
 import { defineEventHandler, setResponseStatus, getRouterParam } from "h3";
+import { getSession } from "../server/auth.js";
 import { readBody } from "../server/h3-helpers.js";
+import { deleteAwarenessRow, loadAwarenessRows, upsertAwarenessRow, } from "./awareness-store.js";
 const AWARENESS_TIMEOUT = 30_000; // 30 seconds
 // ---------------------------------------------------------------------------
 // Awareness event emitter — fast-path for push delivery to SSE-connected peers.
@@ -20,17 +22,33 @@ const AWARENESS_TIMEOUT = 30_000; // 30 seconds
 export const AWARENESS_CHANGE_EVENT = "awareness-change";
 const _awarenessEmitter = new EventEmitter();
 _awarenessEmitter.setMaxListeners(0);
+const _awarenessScopes = new Map();
 export function getAwarenessEmitter() {
     return _awarenessEmitter;
 }
-export function emitAwarenessChange(docId, states, owner, orgId) {
+export function rememberAwarenessScope(docId, scope) {
+    if (!scope)
+        return;
+    const next = { ...(_awarenessScopes.get(docId) ?? {}), ...scope };
+    if (!next.owner && !next.orgId && !next.resourceType && !next.resourceId) {
+        return;
+    }
+    _awarenessScopes.set(docId, next);
+}
+export function emitAwarenessChange(docId, states, scope) {
+    rememberAwarenessScope(docId, scope);
+    const resolvedScope = _awarenessScopes.get(docId) ?? {};
     const event = {
         source: "awareness",
         type: "awareness-change",
         docId,
         states,
-        ...(owner && { owner }),
-        ...(orgId && { orgId }),
+        ...(resolvedScope.owner && { owner: resolvedScope.owner }),
+        ...(resolvedScope.orgId && { orgId: resolvedScope.orgId }),
+        ...(resolvedScope.resourceType && {
+            resourceType: resolvedScope.resourceType,
+        }),
+        ...(resolvedScope.resourceId && { resourceId: resolvedScope.resourceId }),
     };
     _awarenessEmitter.emit(AWARENESS_CHANGE_EVENT, event);
 }
@@ -59,6 +77,21 @@ function pruneIfEmpty(docId, map) {
         _awarenessMap.delete(docId);
     }
 }
+/**
+ * Merge SQL-mirrored awareness rows (written by other server instances —
+ * or by an agent action running in its own serverless invocation) into the
+ * in-memory map, newest lastSeen wins. Degrades to memory-only when the DB
+ * is unavailable.
+ */
+async function mergeStoredAwareness(docId, map) {
+    const rows = await loadAwarenessRows(docId);
+    for (const row of rows) {
+        const existing = map.get(row.clientId);
+        if (!existing || row.lastSeen > existing.lastSeen) {
+            map.set(row.clientId, row);
+        }
+    }
+}
 /**
  * POST /_agent-native/collab/:docId/awareness
  *
@@ -73,6 +106,8 @@ export const postAwareness = defineEventHandler(async (event) => {
         setResponseStatus(event, 400);
         return { error: "docId required" };
     }
+    const session = await getSession(event).catch(() => null);
+    const contextScope = event.context?._collabAwarenessScope;
     const body = await readBody(event);
     const { clientId, state } = body;
     if (clientId == null || state === undefined) {
@@ -84,11 +119,20 @@ export const postAwareness = defineEventHandler(async (event) => {
     const map = getDocAwareness(docId);
     if (state === null) {
         map.delete(clientId);
+        // Best-effort cross-instance removal (never blocks the response).
+        void deleteAwarenessRow(docId, clientId);
     }
     else {
         // Store this client's state
-        map.set(clientId, { clientId, state, lastSeen: Date.now() });
+        const entry = { clientId, state, lastSeen: Date.now() };
+        map.set(clientId, entry);
+        // Mirror to SQL so other instances (and serverless action invocations)
+        // see this participant. Throttled internally; never throws.
+        void upsertAwarenessRow(docId, clientId, state, entry.lastSeen);
     }
+    // Pull in participants known to other instances (multi-instance serverless)
+    // before building the response, so every poller sees the full set.
+    await mergeStoredAwareness(docId, map);
     // Clean expired entries, then prune the outer-map entry if it becomes empty.
     // Without pruning, a deployment with many transient docIds (e.g. one per
     // session) would grow _awarenessMap without bound.
@@ -107,7 +151,10 @@ export const postAwareness = defineEventHandler(async (event) => {
     }
     // Fast-path: push the updated state set to SSE-connected peers so they
     // don't have to wait for the next poll cycle for cursor/selection updates.
-    emitAwarenessChange(docId, allStates);
+    emitAwarenessChange(docId, allStates, contextScope ?? {
+        ...(session?.email ? { owner: session.email } : {}),
+        ...(session?.orgId ? { orgId: session.orgId } : {}),
+    });
     return { states: otherStates };
 });
 /**
@@ -122,6 +169,7 @@ export const getActiveUsers = defineEventHandler(async (event) => {
         return { error: "docId required" };
     }
     const map = getDocAwareness(docId);
+    await mergeStoredAwareness(docId, map);
     cleanExpired(map);
     pruneIfEmpty(docId, map);
     const users = [];

package/dist/collab/awareness.js.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.js","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Server-side awareness state management for collaborative editing.\n *\n * Stores per-client awareness state (cursor positions, user info) in memory.\n * Clients POST their state and receive other clients' states via polling.\n * States expire after 30 seconds of no updates.\n *\n * Fast-path: when a client POSTs new awareness state, the server emits an\n * event on the awareness emitter so SSE-connected peers receive cursor moves\n * push-style instead of waiting for the next poll cycle.\n */\n\nimport { EventEmitter } from \"node:events\";\n\nimport { defineEventHandler, setResponseStatus, getRouterParam } from \"h3\";\nimport type { H3Event } from \"h3\";\n\nimport { readBody } from \"../server/h3-helpers.js\";\n\nconst AWARENESS_TIMEOUT = 30_000; // 30 seconds\n\nexport interface AwarenessEntry {\n  clientId: number;\n  state: string; // JSON-encoded awareness state object\n  lastSeen: number;\n}\n\n// ---------------------------------------------------------------------------\n// Awareness event emitter — fast-path for push delivery to SSE-connected peers.\n// The SSE handler (poll-events) subscribes and forwards events to its stream.\n// ---------------------------------------------------------------------------\n\nexport const AWARENESS_CHANGE_EVENT = \"awareness-change\" as const;\n\nexport interface AwarenessChangeEvent {\n  source: \"awareness\";\n  type: \"awareness-change\";\n  docId: string;\n  /** Array of updated states for this document (all non-expired clients). */\n  states: Array<{ clientId: number; state: string }>;\n  /** Owner email for access-scoped delivery (taken from session if available). */\n  owner?: string;\n  /** Org ID for org-scoped delivery. */\n  orgId?: string;\n}\n\nconst _awarenessEmitter = new EventEmitter();\n_awarenessEmitter.setMaxListeners(0);\n\nexport function getAwarenessEmitter(): EventEmitter {\n  return _awarenessEmitter;\n}\n\nexport function emitAwarenessChange(\n  docId: string,\n  states: Array<{ clientId: number; state: string }>,\n  owner?: string,\n  orgId?: string,\n): void {\n  const event: AwarenessChangeEvent = {\n    source: \"awareness\",\n    type: \"awareness-change\",\n    docId,\n    states,\n    ...(owner && { owner }),\n    ...(orgId && { orgId }),\n  };\n  _awarenessEmitter.emit(AWARENESS_CHANGE_EVENT, event);\n}\n\n// docId → Map<clientId, AwarenessEntry>\nconst _awarenessMap = new Map<string, Map<number, AwarenessEntry>>();\n\nexport function getDocAwareness(docId: string): Map<number, AwarenessEntry> {\n  let map = _awarenessMap.get(docId);\n  if (!map) {\n    map = new Map();\n    _awarenessMap.set(docId, map);\n  }\n  return map;\n}\n\nexport function cleanExpired(map: Map<number, AwarenessEntry>): void {\n  const now = Date.now();\n  for (const [clientId, entry] of map) {\n    if (now - entry.lastSeen > AWARENESS_TIMEOUT) {\n      map.delete(clientId);\n    }\n  }\n}\n\n// Drop the per-document map from the registry once it has no entries left,\n// so the outer map does not grow unbounded with every docId ever touched.\nfunction pruneIfEmpty(docId: string, map: Map<number, AwarenessEntry>): void {\n  if (map.size === 0) {\n    _awarenessMap.delete(docId);\n  }\n}\n\n/**\n * POST /_agent-native/collab/:docId/awareness\n *\n * Client sends its awareness state and receives other clients' states.\n *\n * Body: { clientId: number, state: string | null (JSON-encoded awareness state, or null to clear) }\n * Response: { states: Array<{ clientId: number, state: string }> }\n */\nexport const postAwareness = defineEventHandler(async (event: H3Event) => {\n  const docId = getRouterParam(event, \"docId\");\n  if (!docId) {\n    setResponseStatus(event, 400);\n    return { error: \"docId required\" };\n  }\n\n  const body = await readBody(event);\n  const { clientId, state } = body as {\n    clientId?: number;\n    state?: string | null;\n  };\n\n  if (clientId == null || state === undefined) {\n    // `!clientId` would wrongly reject clientId === 0, which is a valid\n    // (if rare) Yjs client id. A null state is valid: it clears this client.\n    setResponseStatus(event, 400);\n    return { error: \"clientId and state required\" };\n  }\n\n  const map = getDocAwareness(docId);\n\n  if (state === null) {\n    map.delete(clientId);\n  } else {\n    // Store this client's state\n    map.set(clientId, { clientId, state, lastSeen: Date.now() });\n  }\n\n  // Clean expired entries, then prune the outer-map entry if it becomes empty.\n  // Without pruning, a deployment with many transient docIds (e.g. one per\n  // session) would grow _awarenessMap without bound.\n  cleanExpired(map);\n  // Null-state clears and expiry can empty the map; prune the outer entry so\n  // transient document ids do not accumulate.\n  pruneIfEmpty(docId, map);\n\n  // Build the full list of current states (all clients including sender).\n  const allStates: Array<{ clientId: number; state: string }> = [];\n  const otherStates: Array<{ clientId: number; state: string }> = [];\n  for (const [id, entry] of map) {\n    allStates.push({ clientId: id, state: entry.state });\n    if (id !== clientId) {\n      otherStates.push({ clientId: id, state: entry.state });\n    }\n  }\n\n  // Fast-path: push the updated state set to SSE-connected peers so they\n  // don't have to wait for the next poll cycle for cursor/selection updates.\n  emitAwarenessChange(docId, allStates);\n\n  return { states: otherStates };\n});\n\n/**\n * GET /_agent-native/collab/:docId/users\n *\n * Returns the list of active users for a document (for presence bar).\n */\nexport const getActiveUsers = defineEventHandler(async (event: H3Event) => {\n  const docId = getRouterParam(event, \"docId\");\n  if (!docId) {\n    setResponseStatus(event, 400);\n    return { error: \"docId required\" };\n  }\n\n  const map = getDocAwareness(docId);\n  cleanExpired(map);\n  pruneIfEmpty(docId, map);\n\n  const users: Array<{ clientId: number; lastSeen: number }> = [];\n  for (const [, entry] of map) {\n    users.push({ clientId: entry.clientId, lastSeen: entry.lastSeen });\n  }\n\n  return { users };\n});\n"]}
+{"version":3,"file":"awareness.js","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Server-side awareness state management for collaborative editing.\n *\n * Stores per-client awareness state (cursor positions, user info) in memory.\n * Clients POST their state and receive other clients' states via polling.\n * States expire after 30 seconds of no updates.\n *\n * Fast-path: when a client POSTs new awareness state, the server emits an\n * event on the awareness emitter so SSE-connected peers receive cursor moves\n * push-style instead of waiting for the next poll cycle.\n */\n\nimport { EventEmitter } from \"node:events\";\n\nimport { defineEventHandler, setResponseStatus, getRouterParam } from \"h3\";\nimport type { H3Event } from \"h3\";\n\nimport { getSession } from \"../server/auth.js\";\nimport { readBody } from \"../server/h3-helpers.js\";\nimport {\n  deleteAwarenessRow,\n  loadAwarenessRows,\n  upsertAwarenessRow,\n} from \"./awareness-store.js\";\n\nconst AWARENESS_TIMEOUT = 30_000; // 30 seconds\n\nexport interface AwarenessEntry {\n  clientId: number;\n  state: string; // JSON-encoded awareness state object\n  lastSeen: number;\n}\n\n// ---------------------------------------------------------------------------\n// Awareness event emitter — fast-path for push delivery to SSE-connected peers.\n// The SSE handler (poll-events) subscribes and forwards events to its stream.\n// ---------------------------------------------------------------------------\n\nexport const AWARENESS_CHANGE_EVENT = \"awareness-change\" as const;\n\nexport interface AwarenessChangeEvent {\n  source: \"awareness\";\n  type: \"awareness-change\";\n  docId: string;\n  /** Array of updated states for this document (all non-expired clients). */\n  states: Array<{ clientId: number; state: string }>;\n  /** Owner email for access-scoped delivery (taken from session if available). */\n  owner?: string;\n  /** Org ID for org-scoped delivery. */\n  orgId?: string;\n  /** Shareable resource type this awareness event belongs to, when known. */\n  resourceType?: string;\n  /** Shareable resource id this awareness event belongs to, when known. */\n  resourceId?: string;\n}\n\nexport interface AwarenessScope {\n  owner?: string;\n  orgId?: string;\n  resourceType?: string;\n  resourceId?: string;\n}\n\nconst _awarenessEmitter = new EventEmitter();\n_awarenessEmitter.setMaxListeners(0);\n\nconst _awarenessScopes = new Map<string, AwarenessScope>();\n\nexport function getAwarenessEmitter(): EventEmitter {\n  return _awarenessEmitter;\n}\n\nexport function rememberAwarenessScope(\n  docId: string,\n  scope: AwarenessScope | undefined,\n): void {\n  if (!scope) return;\n  const next = { ...(_awarenessScopes.get(docId) ?? {}), ...scope };\n  if (!next.owner && !next.orgId && !next.resourceType && !next.resourceId) {\n    return;\n  }\n  _awarenessScopes.set(docId, next);\n}\n\nexport function emitAwarenessChange(\n  docId: string,\n  states: Array<{ clientId: number; state: string }>,\n  scope?: AwarenessScope,\n): void {\n  rememberAwarenessScope(docId, scope);\n  const resolvedScope = _awarenessScopes.get(docId) ?? {};\n  const event: AwarenessChangeEvent = {\n    source: \"awareness\",\n    type: \"awareness-change\",\n    docId,\n    states,\n    ...(resolvedScope.owner && { owner: resolvedScope.owner }),\n    ...(resolvedScope.orgId && { orgId: resolvedScope.orgId }),\n    ...(resolvedScope.resourceType && {\n      resourceType: resolvedScope.resourceType,\n    }),\n    ...(resolvedScope.resourceId && { resourceId: resolvedScope.resourceId }),\n  };\n  _awarenessEmitter.emit(AWARENESS_CHANGE_EVENT, event);\n}\n\n// docId → Map<clientId, AwarenessEntry>\nconst _awarenessMap = new Map<string, Map<number, AwarenessEntry>>();\n\nexport function getDocAwareness(docId: string): Map<number, AwarenessEntry> {\n  let map = _awarenessMap.get(docId);\n  if (!map) {\n    map = new Map();\n    _awarenessMap.set(docId, map);\n  }\n  return map;\n}\n\nexport function cleanExpired(map: Map<number, AwarenessEntry>): void {\n  const now = Date.now();\n  for (const [clientId, entry] of map) {\n    if (now - entry.lastSeen > AWARENESS_TIMEOUT) {\n      map.delete(clientId);\n    }\n  }\n}\n\n// Drop the per-document map from the registry once it has no entries left,\n// so the outer map does not grow unbounded with every docId ever touched.\nfunction pruneIfEmpty(docId: string, map: Map<number, AwarenessEntry>): void {\n  if (map.size === 0) {\n    _awarenessMap.delete(docId);\n  }\n}\n\n/**\n * Merge SQL-mirrored awareness rows (written by other server instances —\n * or by an agent action running in its own serverless invocation) into the\n * in-memory map, newest lastSeen wins. Degrades to memory-only when the DB\n * is unavailable.\n */\nasync function mergeStoredAwareness(\n  docId: string,\n  map: Map<number, AwarenessEntry>,\n): Promise<void> {\n  const rows = await loadAwarenessRows(docId);\n  for (const row of rows) {\n    const existing = map.get(row.clientId);\n    if (!existing || row.lastSeen > existing.lastSeen) {\n      map.set(row.clientId, row);\n    }\n  }\n}\n\n/**\n * POST /_agent-native/collab/:docId/awareness\n *\n * Client sends its awareness state and receives other clients' states.\n *\n * Body: { clientId: number, state: string | null (JSON-encoded awareness state, or null to clear) }\n * Response: { states: Array<{ clientId: number, state: string }> }\n */\nexport const postAwareness = defineEventHandler(async (event: H3Event) => {\n  const docId = getRouterParam(event, \"docId\");\n  if (!docId) {\n    setResponseStatus(event, 400);\n    return { error: \"docId required\" };\n  }\n  const session = await getSession(event).catch(() => null);\n  const contextScope = (\n    event.context as { _collabAwarenessScope?: AwarenessScope } | undefined\n  )?._collabAwarenessScope;\n\n  const body = await readBody(event);\n  const { clientId, state } = body as {\n    clientId?: number;\n    state?: string | null;\n  };\n\n  if (clientId == null || state === undefined) {\n    // `!clientId` would wrongly reject clientId === 0, which is a valid\n    // (if rare) Yjs client id. A null state is valid: it clears this client.\n    setResponseStatus(event, 400);\n    return { error: \"clientId and state required\" };\n  }\n\n  const map = getDocAwareness(docId);\n\n  if (state === null) {\n    map.delete(clientId);\n    // Best-effort cross-instance removal (never blocks the response).\n    void deleteAwarenessRow(docId, clientId);\n  } else {\n    // Store this client's state\n    const entry = { clientId, state, lastSeen: Date.now() };\n    map.set(clientId, entry);\n    // Mirror to SQL so other instances (and serverless action invocations)\n    // see this participant. Throttled internally; never throws.\n    void upsertAwarenessRow(docId, clientId, state, entry.lastSeen);\n  }\n\n  // Pull in participants known to other instances (multi-instance serverless)\n  // before building the response, so every poller sees the full set.\n  await mergeStoredAwareness(docId, map);\n\n  // Clean expired entries, then prune the outer-map entry if it becomes empty.\n  // Without pruning, a deployment with many transient docIds (e.g. one per\n  // session) would grow _awarenessMap without bound.\n  cleanExpired(map);\n  // Null-state clears and expiry can empty the map; prune the outer entry so\n  // transient document ids do not accumulate.\n  pruneIfEmpty(docId, map);\n\n  // Build the full list of current states (all clients including sender).\n  const allStates: Array<{ clientId: number; state: string }> = [];\n  const otherStates: Array<{ clientId: number; state: string }> = [];\n  for (const [id, entry] of map) {\n    allStates.push({ clientId: id, state: entry.state });\n    if (id !== clientId) {\n      otherStates.push({ clientId: id, state: entry.state });\n    }\n  }\n\n  // Fast-path: push the updated state set to SSE-connected peers so they\n  // don't have to wait for the next poll cycle for cursor/selection updates.\n  emitAwarenessChange(\n    docId,\n    allStates,\n    contextScope ?? {\n      ...(session?.email ? { owner: session.email } : {}),\n      ...(session?.orgId ? { orgId: session.orgId } : {}),\n    },\n  );\n\n  return { states: otherStates };\n});\n\n/**\n * GET /_agent-native/collab/:docId/users\n *\n * Returns the list of active users for a document (for presence bar).\n */\nexport const getActiveUsers = defineEventHandler(async (event: H3Event) => {\n  const docId = getRouterParam(event, \"docId\");\n  if (!docId) {\n    setResponseStatus(event, 400);\n    return { error: \"docId required\" };\n  }\n\n  const map = getDocAwareness(docId);\n  await mergeStoredAwareness(docId, map);\n  cleanExpired(map);\n  pruneIfEmpty(docId, map);\n\n  const users: Array<{ clientId: number; lastSeen: number }> = [];\n  for (const [, entry] of map) {\n    users.push({ clientId: entry.clientId, lastSeen: entry.lastSeen });\n  }\n\n  return { users };\n});\n"]}

package/dist/collab/client.d.ts

@@ -30,6 +30,8 @@ export interface CollabUser {
     name: string;
     email: string;
     color: string;
+    /** Profile image shown in presence avatars, cursor flags, and edit tags. */
+    avatarUrl?: string;
 }
 export interface UseCollaborativeDocOptions {
     /** Document ID to collaborate on. Pass null to disable. */

package/dist/collab/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;CACvB;AAgBD,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAYD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAY1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CA6BT;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,uBAAuB,EAAE,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B3D;AA6ED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAgpB3B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAMzB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;CACvB;AAgBD,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAYD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAY1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CA6BT;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,uBAAuB,EAAE,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B3D;AA6ED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAolB3B"}