@agent-native/core 0.85.7 → 0.86.0

package/dist/collab/client.js

@@ -28,6 +28,7 @@ import { useEffect, useRef, useState, useMemo } from "react";
 import { Awareness } from "y-protocols/awareness";
 import * as Y from "yjs";
 import { agentNativePath } from "../client/api-path.js";
+import { subscribeSyncEvents } from "../client/use-db-sync.js";
 import { AGENT_CLIENT_ID } from "./agent-identity.js";
 // Consistent color palette for user cursors
 const CURSOR_COLORS = [
@@ -412,75 +413,57 @@ export function useCollaborativeDoc(options) {
         let lastPolledVersion = pollVersionRef.current;
         // SSE connection state. When SSE is healthy, poll interval is relaxed.
         let sseActive = false;
-        let sseEventSource = null;
         // ── SSE fast-path ────────────────────────────────────────────────
-        // Wire into the framework /_agent-native/events SSE stream.
+        // Subscribe to the SHARED framework transport for /_agent-native/events
+        // instead of opening a dedicated EventSource per collab doc. A tab holds
+        // exactly one SSE connection regardless of how many docs are mounted —
+        // extra streams eat the browser's per-origin connection budget and can
+        // starve regular data fetches (worst on HTTP/1.1 dev servers).
         // Collab update events arrive push-style; we apply them immediately,
         // avoiding ~2s polling latency for peer edits.
         //
         // NOTE: SSE events are subject to the same server-side access scoping as
         // polling — the server only pushes events that canSeeChangeForUser allows.
         // The server tags collab events with owner/orgId (security commit).
-        function initSSE() {
-            if (typeof EventSource === "undefined")
-                return;
-            try {
-                const es = new EventSource(agentNativePath("/_agent-native/events"));
-                sseEventSource = es;
-                es.onopen = () => {
-                    sseActive = true;
-                    consecutiveErrors = 0;
-                };
-                es.onmessage = (ev) => {
-                    try {
-                        const change = JSON.parse(ev.data);
-                        if (change.source === "collab" &&
-                            change.docId === docId &&
-                            change.update) {
-                            if (requestSource && change.requestSource === requestSource)
-                                return;
-                            try {
-                                Y.applyUpdate(doc, base64ToUint8Array(change.update), "remote");
-                            }
-                            catch {
-                                // Malformed update — trigger state-vector fetch on next poll
-                            }
-                            if (change.requestSource === "agent") {
-                                setAgentActive(true);
-                                if (agentTimerRef.current)
-                                    clearTimeout(agentTimerRef.current);
-                                agentTimerRef.current = setTimeout(() => setAgentActive(false), 3000);
-                            }
-                        }
-                        // Keep pollVersionRef updated from SSE events so the poll loop
-                        // starts from the right version when SSE drops.
-                        if (typeof change.version === "number") {
-                            pollVersionRef.current = Math.max(pollVersionRef.current, change.version);
-                        }
-                    }
-                    catch {
-                        // Ignore malformed events
-                    }
-                };
-                es.onerror = () => {
-                    sseActive = false;
-                    es.close();
-                    sseEventSource = null;
-                    // Retry SSE after a short delay
-                    if (!stopped) {
-                        setTimeout(initSSE, 5_000 + Math.random() * 5_000);
-                    }
-                };
+        const handleSharedEvent = (change) => {
+            if (change.source === "collab" &&
+                change.docId === docId &&
+                typeof change.update === "string") {
+                if (requestSource && change.requestSource === requestSource)
+                    return;
+                try {
+                    Y.applyUpdate(doc, base64ToUint8Array(change.update), "remote");
+                }
+                catch {
+                    // Malformed update — trigger state-vector fetch on next poll
+                }
+                if (change.requestSource === "agent") {
+                    setAgentActive(true);
+                    if (agentTimerRef.current)
+                        clearTimeout(agentTimerRef.current);
+                    agentTimerRef.current = setTimeout(() => setAgentActive(false), 3000);
+                }
             }
-            catch {
-                // SSE not available (edge runtime, etc.) — fall back to polling only
-                sseActive = false;
+            // Keep pollVersionRef updated from shared-transport events so the poll
+            // loop starts from the right version when SSE drops.
+            if (typeof change.version === "number") {
+                pollVersionRef.current = Math.max(pollVersionRef.current, change.version);
             }
-        }
-        // Only set up SSE in browser environments that support it.
-        if (typeof EventSource !== "undefined") {
-            initSSE();
-        }
+        };
+        const unsubscribeSharedEvents = subscribeSyncEvents({
+            onEvents: (events) => {
+                if (stopped)
+                    return;
+                for (const change of events)
+                    handleSharedEvent(change);
+            },
+            onSseStateChange: (connected) => {
+                sseActive = connected;
+                if (connected)
+                    consecutiveErrors = 0;
+            },
+            pauseWhenHidden,
+        });
         // ── Poll loop ───────────────────────────────────────────────────
         function getActivePollInterval() {
             return sseActive ? pollIntervalWithSse : pollInterval;
@@ -665,10 +648,7 @@ export function useCollaborativeDoc(options) {
             stopped = true;
             if (timer)
                 clearTimeout(timer);
-            if (sseEventSource) {
-                sseEventSource.close();
-                sseEventSource = null;
-            }
+            unsubscribeSharedEvents();
             window.removeEventListener("focus", pollNow);
             document.removeEventListener("visibilitychange", handleVisibilityChange);
         };
@@ -683,78 +663,58 @@ export function useCollaborativeDoc(options) {
         baseUrl,
         docMissing,
     ]);
-    // SSE fast-path for awareness: subscribe to the framework events stream and
+    // SSE fast-path for awareness: listen on the SHARED framework transport and
     // apply any awareness-change events immediately so peers receive cursor
     // moves push-style without waiting for the next poll cycle.
-    // Polling fallback keeps working when SSE is unavailable.
+    // Polling fallback keeps working when SSE is unavailable. Reconnection and
+    // focus/visibility handling live inside the shared transport.
     useEffect(() => {
-        if (!ydoc || !docId || !awareness || typeof EventSource === "undefined") {
+        if (!ydoc || !docId || !awareness) {
             return;
         }
         // Non-null captures for closures: null branches returned early above.
         const capturedYdoc = ydoc;
         const capturedAwareness = awareness;
-        const sseUrl = agentNativePath("/_agent-native/events");
-        let source = null;
         let stopped = false;
-        function connect() {
-            if (stopped || source)
+        const applyAwarenessEvent = (data) => {
+            if (data.source !== "awareness" ||
+                data.type !== "awareness-change" ||
+                data.docId !== docId) {
                 return;
-            source = new EventSource(sseUrl);
-            source.onmessage = (msg) => {
-                if (stopped)
-                    return;
+            }
+            const states = Array.isArray(data.states)
+                ? data.states
+                : [];
+            const remoteStates = [];
+            for (const remote of states) {
                 try {
-                    const data = JSON.parse(msg.data);
-                    if (data.source !== "awareness" ||
-                        data.type !== "awareness-change" ||
-                        data.docId !== docId) {
-                        return;
-                    }
-                    const remoteStates = [];
-                    for (const remote of data.states ?? []) {
-                        try {
-                            remoteStates.push({
-                                clientId: Number(remote.clientId),
-                                state: JSON.parse(remote.state),
-                            });
-                        }
-                        catch {
-                            // Invalid state entry — skip
-                        }
-                    }
-                    const changes = reconcileRemoteAwarenessStates(capturedAwareness.getStates(), capturedYdoc.clientID, remoteStates);
-                    if (changes.added.length ||
-                        changes.updated.length ||
-                        changes.removed.length) {
-                        capturedAwareness.emit("change", [changes, "remote"]);
-                    }
+                    remoteStates.push({
+                        clientId: Number(remote.clientId),
+                        state: JSON.parse(remote.state),
+                    });
                 }
                 catch {
-                    // Ignore malformed SSE frames; poll cycle is the safety net.
+                    // Invalid state entry — skip
                 }
-            };
-            source.onerror = () => {
-                // On permanent close let go of the ref so re-focus can reconnect.
-                if (source && source.readyState === EventSource.CLOSED) {
-                    source = null;
-                }
-            };
-        }
-        connect();
-        function onFocus() {
-            if (!source || source.readyState === EventSource.CLOSED) {
-                source?.close();
-                source = null;
-                connect();
             }
-        }
-        window.addEventListener("focus", onFocus);
+            const changes = reconcileRemoteAwarenessStates(capturedAwareness.getStates(), capturedYdoc.clientID, remoteStates);
+            if (changes.added.length ||
+                changes.updated.length ||
+                changes.removed.length) {
+                capturedAwareness.emit("change", [changes, "remote"]);
+            }
+        };
+        const unsubscribe = subscribeSyncEvents({
+            onEvents: (events) => {
+                if (stopped)
+                    return;
+                for (const data of events)
+                    applyAwarenessEvent(data);
+            },
+        });
         return () => {
             stopped = true;
-            source?.close();
-            source = null;
-            window.removeEventListener("focus", onFocus);
+            unsubscribe();
         };
     }, [ydoc, docId, awareness]);
     return {

package/dist/collab/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side hook for collaborative document editing via Yjs.\n *\n * Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n *\n * Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n *\n * Transport improvements (vs previous version):\n * - Local update POSTs are debounced and coalesced with Y.mergeUpdates (~80ms)\n *   to avoid per-keystroke requests. The batch is flushed immediately on\n *   visibilitychange/pagehide and before each poll/awareness cycle.\n * - GET state?stateVector= is NOT fetched on every poll cycle. It is fetched:\n *   (a) on (re)connect / initial load, (b) when a poll response indicates a\n *   gap (version jump > ring-buffer size), (c) after applying an update fails,\n *   and (d) as a low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL\n *   poll cycles (~15×).\n * - Network errors use exponential backoff with jitter (cap ~15s), reset on\n *   success.\n * - SSE fast-path: collab events are received push-style from\n *   /_agent-native/events (the framework SSE stream). While SSE is\n *   healthy the poll loop relaxes to a slow cadence (10–15s). If SSE is\n *   unavailable the 2s poll resumes automatically.\n */\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport * as Y from \"yjs\";\n\nimport { agentNativePath } from \"../client/api-path.js\";\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\n\nexport interface CollabUser {\n  name: string;\n  email: string;\n  color: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n  /** Document ID to collaborate on. Pass null to disable. */\n  docId: string | null;\n  /** Poll interval in ms when SSE is unavailable. Default: 2000 */\n  pollInterval?: number;\n  /** Poll interval in ms while SSE is healthy. Default: 12000 */\n  pollIntervalWithSse?: number;\n  /** Pause remote update/presence polling while the tab is hidden. Default: true */\n  pauseWhenHidden?: boolean;\n  /** Base URL for collab endpoints. Default: \"/_agent-native/collab\" */\n  baseUrl?: string;\n  /** Request source ID for jitter prevention (e.g., tab ID). */\n  requestSource?: string;\n  /** Current user info for cursor labels. */\n  user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n  /** The Yjs document instance. Stable per docId — never changes identity. */\n  ydoc: Y.Doc | null;\n  /** Yjs Awareness instance for cursor/presence sync. */\n  awareness: Awareness | null;\n  /** Whether the initial state is still loading from the server. */\n  isLoading: boolean;\n  /** Whether the doc is synced with the server. */\n  isSynced: boolean;\n  /** Active users on this document (from awareness). */\n  activeUsers: CollabUser[];\n  /** True briefly when the AI agent makes an edit (for presence indicator). */\n  agentActive: boolean;\n  /** True when the AI agent has an active awareness entry (durable presence). */\n  agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n  \"#f87171\",\n  \"#fb923c\",\n  \"#fbbf24\",\n  \"#a3e635\",\n  \"#34d399\",\n  \"#22d3ee\",\n  \"#60a5fa\",\n  \"#14b8a6\",\n  \"#f472b6\",\n  \"#e879f9\",\n];\n\n/** Hash a string to a consistent color from the palette. */\nexport function emailToColor(email: string): string {\n  let hash = 0;\n  for (let i = 0; i < email.length; i++) {\n    hash = ((hash << 5) - hash + email.charCodeAt(i)) | 0;\n  }\n  return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/** Derive a display name from an email address. */\nexport function emailToName(email: string): string {\n  const local = email.split(\"@\")[0] || email;\n  return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n  const byEmail = new Map<string, CollabUser>();\n  for (const user of users) {\n    const email = normalizeCollabEmail(user.email);\n    if (!email || byEmail.has(email)) continue;\n    byEmail.set(email, {\n      name: user.name || emailToName(email),\n      email,\n      color: user.color || emailToColor(email),\n    });\n  }\n  return Array.from(byEmail.values());\n}\n\n/**\n * Leader election for applying authoritative external snapshots into a shared\n * collaborative document.\n *\n * When the agent (or a Notion pull, or any full-document rewrite) writes new\n * content to SQL, the open editor reconciles it into the live Y.Doc with\n * `setContent`. If EVERY connected client did that independently, each would\n * diff the same snapshot into the CRDT and the changed region would be inserted\n * N times (concurrent inserts at the same position → duplicated text). So only\n * ONE client — the \"lead\" — applies the snapshot; every other client receives\n * the result through normal Yjs sync.\n *\n * The lead is the present client with the lowest Yjs `clientID`. The agent's\n * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,\n * and a client editing alone is always the lead. This is deterministic across\n * clients with no coordination round-trip.\n */\nexport function isReconcileLeadClient(\n  awareness: Awareness | null | undefined,\n  localClientId: number | null | undefined,\n): boolean {\n  if (localClientId == null) return false;\n  if (!awareness) return true; // standalone / tests — act alone\n\n  let hasPeer = false;\n  let minVisible = localClientId;\n  awareness.getStates().forEach((state, clientId) => {\n    if (clientId === AGENT_CLIENT_ID) return; // agent never leads\n    if (clientId === localClientId) return;\n    const s = state as { user?: unknown; visible?: boolean };\n    if (!s || !s.user) return; // skip empty/stale entries\n    hasPeer = true;\n    // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)\n    // is skipped. A peer that hasn't published the field is treated as visible.\n    if (s.visible !== false && clientId < minVisible) minVisible = clientId;\n  });\n\n  // Sole client: always the applier — no other client can duplicate the edit,\n  // so single-user agent edits apply even if this tab reports hidden.\n  if (!hasPeer) return true;\n\n  // With peers present, exactly one VISIBLE client applies (the lowest clientId\n  // among visible ones). A backgrounded tab pauses its poll and can't reliably\n  // act, so it yields — otherwise an agent edit would never reach the tab the\n  // user is actually looking at. The caller re-elects on visibility change.\n  const localHidden =\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n  if (localHidden) return false;\n  return localClientId <= minVisible;\n}\n\nexport interface RemoteAwarenessSnapshot {\n  clientId: number;\n  state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n  states: Map<number, unknown>,\n  localClientId: number,\n  remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n  const incoming = new Set<number>();\n  const added: number[] = [];\n  const updated: number[] = [];\n  const removed: number[] = [];\n\n  for (const remote of remoteStates) {\n    if (\n      !Number.isFinite(remote.clientId) ||\n      remote.clientId === localClientId\n    ) {\n      continue;\n    }\n    incoming.add(remote.clientId);\n    const hadState = states.has(remote.clientId);\n    states.set(remote.clientId, remote.state);\n    (hadState ? updated : added).push(remote.clientId);\n  }\n\n  for (const clientId of Array.from(states.keys())) {\n    if (clientId === localClientId) continue;\n    if (incoming.has(clientId)) continue;\n    states.delete(clientId);\n    removed.push(clientId);\n  }\n\n  return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < arr.length; i++) {\n    binary += String.fromCharCode(arr[i]);\n  }\n  return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n  const binary = atob(b64);\n  const arr = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    arr[i] = binary.charCodeAt(i);\n  }\n  return arr;\n}\n\n/** Debounce delay for coalescing local Yjs update POSTs (ms). */\nconst UPDATE_DEBOUNCE_MS = 80;\n\n/** Fetch state-vector every N poll cycles as a low-frequency safety net. */\nconst STATE_VECTOR_FETCH_INTERVAL = 15;\n\n/** Poll ring-buffer size on the server (MAX_BUFFER in poll.ts). */\nconst POLL_RING_BUFFER_SIZE = 200;\n\n/** Exponential backoff: base delay (ms), multiplier, cap (ms). */\nconst BACKOFF_BASE_MS = 500;\nconst BACKOFF_MAX_MS = 15_000;\n\nfunction calcBackoff(consecutiveErrors: number): number {\n  const exp = Math.min(consecutiveErrors, 10);\n  const delay = BACKOFF_BASE_MS * Math.pow(2, exp);\n  // Add jitter: ±25%\n  const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n  return Math.min(delay + jitter, BACKOFF_MAX_MS);\n}\n\n// ---------------------------------------------------------------------------\n// Fast awareness helper — throttled per (docId, ydocId) pair so multiple\n// setLocalStateField calls within a 150ms window are coalesced into one POST.\n// ---------------------------------------------------------------------------\n\nconst _awarenessThrottleTimers = new Map<\n  string,\n  ReturnType<typeof setTimeout>\n>();\n\nfunction scheduleAwarenessPush(\n  baseUrl: string,\n  docId: string,\n  clientId: number,\n  getState: () => Record<string, unknown> | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  const key = `${docId}::${clientId}`;\n  if (_awarenessThrottleTimers.has(key)) return; // already scheduled\n\n  const timer = setTimeout(() => {\n    _awarenessThrottleTimers.delete(key);\n    const state = getState();\n    fetch(`${baseUrl}/${docId}/awareness`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        clientId,\n        state: state ? JSON.stringify(state) : null,\n      }),\n    }).catch(() => {}); // best-effort; poll cycle is the baseline fallback\n  }, 150);\n\n  _awarenessThrottleTimers.set(key, timer);\n}\n\nexport function useCollaborativeDoc(\n  options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n  const {\n    docId,\n    pollInterval = 2000,\n    pollIntervalWithSse = 12000,\n    pauseWhenHidden = true,\n    baseUrl = agentNativePath(\"/_agent-native/collab\"),\n    requestSource,\n    user,\n  } = options;\n\n  // Stable Y.Doc per docId\n  const ydoc = useMemo(() => {\n    if (!docId) return null;\n    return new Y.Doc();\n  }, [docId]);\n\n  // Stable Awareness per ydoc\n  const awareness = useMemo(() => {\n    if (!ydoc) return null;\n    return new Awareness(ydoc);\n  }, [ydoc]);\n\n  const [isLoading, setIsLoading] = useState(!!docId);\n  const [isSynced, setIsSynced] = useState(false);\n  const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n  const [agentActive, setAgentActive] = useState(false);\n  const [agentPresent, setAgentPresent] = useState(false);\n  // Set when the initial state fetch returns 404/403 — stops the awareness\n  // poll so we don't spam the console with errors against a doc that doesn't\n  // exist or isn't accessible.\n  const [docMissing, setDocMissing] = useState(false);\n  const agentTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pollVersionRef = useRef(0);\n\n  // Set local awareness state (user info for cursor labels). Also publish this\n  // tab's visibility so peers can elect a VISIBLE client to apply external\n  // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll\n  // and must not hold that role.\n  useEffect(() => {\n    if (!awareness || !user) return;\n    awareness.setLocalStateField(\"user\", {\n      name: user.name,\n      email: user.email,\n      color: user.color,\n    });\n    awareness.setLocalStateField(\"visible\", !isDocumentHidden());\n  }, [awareness, user?.name, user?.email, user?.color]);\n\n  // Fast awareness push: whenever local state changes (e.g. cursor moves,\n  // setPresence() calls), schedule a throttled POST so peers receive updates\n  // at ~150ms instead of waiting for the next 2s poll cycle. The poll cycle\n  // remains the authoritative baseline (cursors degrade gracefully without SSE).\n  useEffect(() => {\n    if (!awareness || !ydoc || !docId || !user) return;\n    const clientId = ydoc.clientID;\n\n    const onLocalStateChange = () => {\n      scheduleAwarenessPush(\n        baseUrl,\n        docId,\n        clientId,\n        () => awareness.getLocalState() as Record<string, unknown> | null,\n      );\n    };\n\n    // awareness emits \"change\" for local state changes too (when origin is \"local\").\n    awareness.on(\"change\", onLocalStateChange);\n    return () => {\n      awareness.off(\"change\", onLocalStateChange);\n    };\n  }, [awareness, ydoc, docId, baseUrl, user]);\n\n  // Track active users from awareness changes\n  useEffect(() => {\n    if (!awareness) return;\n\n    const updateUsers = () => {\n      const users: CollabUser[] = [];\n      let hasAgent = false;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc?.clientID) return; // Skip self\n        if (state.user) {\n          users.push(state.user as CollabUser);\n          if ((state.user as CollabUser).email === \"agent@system\") {\n            hasAgent = true;\n          }\n        }\n      });\n      setActiveUsers(dedupeCollabUsersByEmail(users));\n      setAgentPresent(hasAgent);\n    };\n\n    awareness.on(\"change\", updateUsers);\n    return () => {\n      awareness.off(\"change\", updateUsers);\n    };\n  }, [awareness, ydoc]);\n\n  // Clean up on unmount or docId change\n  useEffect(() => {\n    return () => {\n      awareness?.destroy();\n      ydoc?.destroy();\n    };\n  }, [ydoc, awareness]);\n\n  // Fetch server state and apply to existing doc\n  useEffect(() => {\n    if (!ydoc || !docId) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setIsSynced(false);\n    setDocMissing(false);\n\n    fetch(`${baseUrl}/${docId}/state`)\n      .then(async (res) => {\n        if (cancelled) return;\n        if (res.status === 404 || res.status === 403) {\n          setDocMissing(true);\n          setIsLoading(false);\n          setIsSynced(true);\n          return;\n        }\n        const data = (await res.json().catch(() => null)) as {\n          state?: string;\n        } | null;\n        if (data?.state) {\n          const binary = base64ToUint8Array(data.state);\n          if (binary.length > 4) {\n            Y.applyUpdate(ydoc, binary, \"remote\");\n          }\n        }\n        setIsLoading(false);\n        setIsSynced(true);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setIsLoading(false);\n        setIsSynced(true);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ydoc, docId, baseUrl]);\n\n  // Send local updates to server — debounced and coalesced with Y.mergeUpdates.\n  //\n  // Instead of firing one POST per Yjs update (one per keystroke), we accumulate\n  // updates in a buffer for UPDATE_DEBOUNCE_MS then merge them into a single\n  // request. The buffer is also flushed immediately on visibilitychange/pagehide\n  // and before each poll/awareness cycle so we don't hold stale local state.\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    let pendingUpdates: Uint8Array[] = [];\n    let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n    const flushPendingUpdates = (keepalive = false) => {\n      if (flushTimer) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      if (pendingUpdates.length === 0) return;\n      const toSend = pendingUpdates;\n      pendingUpdates = [];\n\n      const merged = toSend.length === 1 ? toSend[0] : Y.mergeUpdates(toSend);\n      fetch(`${baseUrl}/${docId}/update`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          update: uint8ArrayToBase64(merged),\n          requestSource,\n        }),\n        ...(keepalive ? { keepalive: true } : {}),\n      }).catch(() => {});\n    };\n\n    // Expose flush to the poll loop via a ref so it can flush before each cycle.\n    // We store the flusher in a closure-captured variable; the poll effect\n    // below reads it through the shared `pendingFlushRef`.\n    (ydoc as any).__collabFlush = flushPendingUpdates;\n\n    const handler = (update: Uint8Array, origin: unknown) => {\n      if (origin === \"remote\") return;\n      pendingUpdates.push(update);\n      if (flushTimer) clearTimeout(flushTimer);\n      flushTimer = setTimeout(flushPendingUpdates, UPDATE_DEBOUNCE_MS);\n    };\n\n    const handlePageHide = () => {\n      flushPendingUpdates(true /* keepalive */);\n    };\n\n    ydoc.on(\"update\", handler);\n    if (typeof window !== \"undefined\") {\n      window.addEventListener(\"pagehide\", handlePageHide);\n    }\n\n    return () => {\n      ydoc.off(\"update\", handler);\n      delete (ydoc as any).__collabFlush;\n      if (typeof window !== \"undefined\") {\n        window.removeEventListener(\"pagehide\", handlePageHide);\n      }\n      // Flush any remaining updates on teardown\n      flushPendingUpdates(true);\n    };\n  }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n  // Poll for remote doc updates + awareness sync, with SSE fast-path.\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n    // Non-null capture: null branch returned early above; async closures lose\n    // the narrowing on the outer ydoc variable.\n    const doc: Y.Doc = ydoc;\n\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let consecutiveErrors = 0;\n    let pollCycleCount = 0;\n    // Track the last version we successfully polled. Used to detect ring-buffer\n    // overflow (version gap larger than the ring buffer).\n    let lastPolledVersion = pollVersionRef.current;\n\n    // SSE connection state. When SSE is healthy, poll interval is relaxed.\n    let sseActive = false;\n    let sseEventSource: EventSource | null = null;\n\n    // ── SSE fast-path ────────────────────────────────────────────────\n    // Wire into the framework /_agent-native/events SSE stream.\n    // Collab update events arrive push-style; we apply them immediately,\n    // avoiding ~2s polling latency for peer edits.\n    //\n    // NOTE: SSE events are subject to the same server-side access scoping as\n    // polling — the server only pushes events that canSeeChangeForUser allows.\n    // The server tags collab events with owner/orgId (security commit).\n    function initSSE() {\n      if (typeof EventSource === \"undefined\") return;\n      try {\n        const es = new EventSource(agentNativePath(\"/_agent-native/events\"));\n        sseEventSource = es;\n\n        es.onopen = () => {\n          sseActive = true;\n          consecutiveErrors = 0;\n        };\n\n        es.onmessage = (ev) => {\n          try {\n            const change = JSON.parse(ev.data) as {\n              source?: string;\n              docId?: string;\n              update?: string;\n              requestSource?: string;\n              version?: number;\n            };\n\n            if (\n              change.source === \"collab\" &&\n              change.docId === docId &&\n              change.update\n            ) {\n              if (requestSource && change.requestSource === requestSource)\n                return;\n              try {\n                Y.applyUpdate(doc, base64ToUint8Array(change.update), \"remote\");\n              } catch {\n                // Malformed update — trigger state-vector fetch on next poll\n              }\n\n              if (change.requestSource === \"agent\") {\n                setAgentActive(true);\n                if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n                agentTimerRef.current = setTimeout(\n                  () => setAgentActive(false),\n                  3000,\n                );\n              }\n            }\n\n            // Keep pollVersionRef updated from SSE events so the poll loop\n            // starts from the right version when SSE drops.\n            if (typeof change.version === \"number\") {\n              pollVersionRef.current = Math.max(\n                pollVersionRef.current,\n                change.version,\n              );\n            }\n          } catch {\n            // Ignore malformed events\n          }\n        };\n\n        es.onerror = () => {\n          sseActive = false;\n          es.close();\n          sseEventSource = null;\n          // Retry SSE after a short delay\n          if (!stopped) {\n            setTimeout(initSSE, 5_000 + Math.random() * 5_000);\n          }\n        };\n      } catch {\n        // SSE not available (edge runtime, etc.) — fall back to polling only\n        sseActive = false;\n      }\n    }\n\n    // Only set up SSE in browser environments that support it.\n    if (typeof EventSource !== \"undefined\") {\n      initSSE();\n    }\n\n    // ── Poll loop ───────────────────────────────────────────────────\n    function getActivePollInterval(): number {\n      return sseActive ? pollIntervalWithSse : pollInterval;\n    }\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      timer = setTimeout(poll, getActivePollInterval());\n    }\n\n    async function fetchStateVector(): Promise<void> {\n      try {\n        const stateVector = uint8ArrayToBase64(Y.encodeStateVector(doc));\n        const stateRes = await fetch(\n          `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(stateVector)}`,\n        );\n        if (stateRes.ok) {\n          const stateData = (await stateRes.json().catch(() => null)) as {\n            state?: string;\n          } | null;\n          if (stateData?.state) {\n            const binary = base64ToUint8Array(stateData.state);\n            if (binary.length > 2) {\n              Y.applyUpdate(doc, binary, \"remote\");\n            }\n          }\n        }\n      } catch {\n        // Non-fatal; the next poll cycle will retry\n      }\n    }\n\n    async function poll() {\n      if (stopped) return;\n\n      // Flush any pending local updates before polling so the server has the\n      // latest state before we read remote changes.\n      const flush = (ydoc as any).__collabFlush as\n        | ((keepalive?: boolean) => void)\n        | undefined;\n      flush?.();\n\n      try {\n        const res = await fetch(\n          agentNativePath(\n            `/_agent-native/poll?since=${pollVersionRef.current}`,\n          ),\n        );\n        if (!res.ok) throw new Error(\"HTTP \" + res.status);\n\n        const data = await res.json();\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            docId?: string;\n            update?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        // Detect ring-buffer overflow: if the version jumped by more than the\n        // ring buffer size, some events were evicted and we need a state-vector\n        // fetch to reconcile the gap.\n        const versionGap = version - lastPolledVersion;\n        const hadGap = versionGap > POLL_RING_BUFFER_SIZE;\n\n        for (const evt of events) {\n          if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n            if (requestSource && evt.requestSource === requestSource) continue;\n            try {\n              Y.applyUpdate(doc, base64ToUint8Array(evt.update), \"remote\");\n            } catch {\n              // Failed to apply — fetch full state-vector below\n              await fetchStateVector();\n            }\n\n            if (evt.requestSource === \"agent\") {\n              setAgentActive(true);\n              if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n              agentTimerRef.current = setTimeout(\n                () => setAgentActive(false),\n                3000,\n              );\n            }\n          }\n        }\n\n        pollVersionRef.current = version;\n        lastPolledVersion = version;\n        pollCycleCount++;\n        consecutiveErrors = 0;\n\n        // Fetch state-vector only when needed:\n        //   1. Ring-buffer overflow detected (missed events).\n        //   2. Low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL cycles.\n        //   3. NOT on every cycle (the previous behavior causing 3 requests/cycle).\n        const shouldFetchStateVector =\n          hadGap || pollCycleCount % STATE_VECTOR_FETCH_INTERVAL === 0;\n\n        if (shouldFetchStateVector) {\n          await fetchStateVector();\n        }\n\n        // Sync awareness (cursor positions)\n        if (awareness) {\n          const localState = awareness.getLocalState();\n          if (localState) {\n            try {\n              const awarenessRes = await fetch(\n                `${baseUrl}/${docId}/awareness`,\n                {\n                  method: \"POST\",\n                  headers: { \"Content-Type\": \"application/json\" },\n                  body: JSON.stringify({\n                    clientId: doc.clientID,\n                    state: JSON.stringify(localState),\n                  }),\n                },\n              );\n              if (awarenessRes.ok) {\n                const awarenessData = await awarenessRes.json();\n                const remoteStates: RemoteAwarenessSnapshot[] = [];\n                for (const remote of awarenessData.states || []) {\n                  try {\n                    const remoteState = JSON.parse(remote.state);\n                    remoteStates.push({\n                      clientId: Number(remote.clientId),\n                      state: remoteState,\n                    });\n                  } catch {\n                    // Invalid state — skip\n                  }\n                }\n                const changes = reconcileRemoteAwarenessStates(\n                  awareness.getStates() as Map<number, unknown>,\n                  doc.clientID,\n                  remoteStates,\n                );\n                if (\n                  changes.added.length ||\n                  changes.updated.length ||\n                  changes.removed.length\n                ) {\n                  awareness.emit(\"change\", [changes, \"remote\"]);\n                }\n              }\n            } catch {\n              // Awareness sync failure is non-fatal\n            }\n          }\n        }\n      } catch {\n        // Network error — exponential backoff\n        consecutiveErrors++;\n        const backoff = calcBackoff(consecutiveErrors);\n        if (!stopped) {\n          timer = setTimeout(poll, backoff);\n          return;\n        }\n      }\n\n      schedulePoll();\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    // Publish this tab's visibility to peers. A hidden tab pauses its poll, so\n    // we push the state immediately (keepalive) instead of waiting for the next\n    // cycle — otherwise peers keep treating a backgrounded tab as the visible\n    // lead and an agent edit never lands on the tab the user is actually viewing.\n    function publishVisibility(visible: boolean) {\n      if (!awareness) return;\n      awareness.setLocalStateField(\"visible\", visible);\n      const localState = awareness.getLocalState();\n      if (!localState) return;\n      fetch(`${baseUrl}/${docId}/awareness`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          clientId: doc.clientID,\n          state: JSON.stringify(localState),\n        }),\n        keepalive: true,\n      }).catch(() => {});\n    }\n\n    function handleVisibilityChange() {\n      const visible = document.visibilityState === \"visible\";\n      publishVisibility(visible);\n      if (visible) {\n        // Also flush any pending updates when coming back into view\n        const flush = (ydoc as any).__collabFlush as\n          | ((keepalive?: boolean) => void)\n          | undefined;\n        flush?.();\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      if (sseEventSource) {\n        sseEventSource.close();\n        sseEventSource = null;\n      }\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    ydoc,\n    awareness,\n    docId,\n    pollInterval,\n    pollIntervalWithSse,\n    pauseWhenHidden,\n    requestSource,\n    baseUrl,\n    docMissing,\n  ]);\n\n  // SSE fast-path for awareness: subscribe to the framework events stream and\n  // apply any awareness-change events immediately so peers receive cursor\n  // moves push-style without waiting for the next poll cycle.\n  // Polling fallback keeps working when SSE is unavailable.\n  useEffect(() => {\n    if (!ydoc || !docId || !awareness || typeof EventSource === \"undefined\") {\n      return;\n    }\n    // Non-null captures for closures: null branches returned early above.\n    const capturedYdoc = ydoc;\n    const capturedAwareness = awareness;\n    const sseUrl = agentNativePath(\"/_agent-native/events\");\n    let source: EventSource | null = null;\n    let stopped = false;\n\n    function connect() {\n      if (stopped || source) return;\n      source = new EventSource(sseUrl);\n      source.onmessage = (msg) => {\n        if (stopped) return;\n        try {\n          const data = JSON.parse(msg.data as string) as {\n            source?: string;\n            type?: string;\n            docId?: string;\n            states?: Array<{ clientId: number; state: string }>;\n          };\n          if (\n            data.source !== \"awareness\" ||\n            data.type !== \"awareness-change\" ||\n            data.docId !== docId\n          ) {\n            return;\n          }\n          const remoteStates: RemoteAwarenessSnapshot[] = [];\n          for (const remote of data.states ?? []) {\n            try {\n              remoteStates.push({\n                clientId: Number(remote.clientId),\n                state: JSON.parse(remote.state),\n              });\n            } catch {\n              // Invalid state entry — skip\n            }\n          }\n          const changes = reconcileRemoteAwarenessStates(\n            capturedAwareness.getStates() as Map<number, unknown>,\n            capturedYdoc.clientID,\n            remoteStates,\n          );\n          if (\n            changes.added.length ||\n            changes.updated.length ||\n            changes.removed.length\n          ) {\n            capturedAwareness.emit(\"change\", [changes, \"remote\"]);\n          }\n        } catch {\n          // Ignore malformed SSE frames; poll cycle is the safety net.\n        }\n      };\n      source.onerror = () => {\n        // On permanent close let go of the ref so re-focus can reconnect.\n        if (source && source.readyState === EventSource.CLOSED) {\n          source = null;\n        }\n      };\n    }\n\n    connect();\n\n    function onFocus() {\n      if (!source || source.readyState === EventSource.CLOSED) {\n        source?.close();\n        source = null;\n        connect();\n      }\n    }\n\n    window.addEventListener(\"focus\", onFocus);\n    return () => {\n      stopped = true;\n      source?.close();\n      source = null;\n      window.removeEventListener(\"focus\", onFocus);\n    };\n  }, [ydoc, docId, awareness]);\n\n  return {\n    ydoc,\n    awareness,\n    isLoading,\n    isSynced,\n    activeUsers,\n    agentActive,\n    agentPresent,\n  };\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side hook for collaborative document editing via Yjs.\n *\n * Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n *\n * Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n *\n * Transport improvements (vs previous version):\n * - Local update POSTs are debounced and coalesced with Y.mergeUpdates (~80ms)\n *   to avoid per-keystroke requests. The batch is flushed immediately on\n *   visibilitychange/pagehide and before each poll/awareness cycle.\n * - GET state?stateVector= is NOT fetched on every poll cycle. It is fetched:\n *   (a) on (re)connect / initial load, (b) when a poll response indicates a\n *   gap (version jump > ring-buffer size), (c) after applying an update fails,\n *   and (d) as a low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL\n *   poll cycles (~15×).\n * - Network errors use exponential backoff with jitter (cap ~15s), reset on\n *   success.\n * - SSE fast-path: collab events are received push-style from\n *   /_agent-native/events (the framework SSE stream). While SSE is\n *   healthy the poll loop relaxes to a slow cadence (10–15s). If SSE is\n *   unavailable the 2s poll resumes automatically.\n */\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport * as Y from \"yjs\";\n\nimport { agentNativePath } from \"../client/api-path.js\";\nimport { subscribeSyncEvents, type SyncEvent } from \"../client/use-db-sync.js\";\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\n\nexport interface CollabUser {\n  name: string;\n  email: string;\n  color: string;\n  /** Profile image shown in presence avatars, cursor flags, and edit tags. */\n  avatarUrl?: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n  /** Document ID to collaborate on. Pass null to disable. */\n  docId: string | null;\n  /** Poll interval in ms when SSE is unavailable. Default: 2000 */\n  pollInterval?: number;\n  /** Poll interval in ms while SSE is healthy. Default: 12000 */\n  pollIntervalWithSse?: number;\n  /** Pause remote update/presence polling while the tab is hidden. Default: true */\n  pauseWhenHidden?: boolean;\n  /** Base URL for collab endpoints. Default: \"/_agent-native/collab\" */\n  baseUrl?: string;\n  /** Request source ID for jitter prevention (e.g., tab ID). */\n  requestSource?: string;\n  /** Current user info for cursor labels. */\n  user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n  /** The Yjs document instance. Stable per docId — never changes identity. */\n  ydoc: Y.Doc | null;\n  /** Yjs Awareness instance for cursor/presence sync. */\n  awareness: Awareness | null;\n  /** Whether the initial state is still loading from the server. */\n  isLoading: boolean;\n  /** Whether the doc is synced with the server. */\n  isSynced: boolean;\n  /** Active users on this document (from awareness). */\n  activeUsers: CollabUser[];\n  /** True briefly when the AI agent makes an edit (for presence indicator). */\n  agentActive: boolean;\n  /** True when the AI agent has an active awareness entry (durable presence). */\n  agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n  \"#f87171\",\n  \"#fb923c\",\n  \"#fbbf24\",\n  \"#a3e635\",\n  \"#34d399\",\n  \"#22d3ee\",\n  \"#60a5fa\",\n  \"#14b8a6\",\n  \"#f472b6\",\n  \"#e879f9\",\n];\n\n/** Hash a string to a consistent color from the palette. */\nexport function emailToColor(email: string): string {\n  let hash = 0;\n  for (let i = 0; i < email.length; i++) {\n    hash = ((hash << 5) - hash + email.charCodeAt(i)) | 0;\n  }\n  return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/** Derive a display name from an email address. */\nexport function emailToName(email: string): string {\n  const local = email.split(\"@\")[0] || email;\n  return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n  const byEmail = new Map<string, CollabUser>();\n  for (const user of users) {\n    const email = normalizeCollabEmail(user.email);\n    if (!email || byEmail.has(email)) continue;\n    byEmail.set(email, {\n      name: user.name || emailToName(email),\n      email,\n      color: user.color || emailToColor(email),\n    });\n  }\n  return Array.from(byEmail.values());\n}\n\n/**\n * Leader election for applying authoritative external snapshots into a shared\n * collaborative document.\n *\n * When the agent (or a Notion pull, or any full-document rewrite) writes new\n * content to SQL, the open editor reconciles it into the live Y.Doc with\n * `setContent`. If EVERY connected client did that independently, each would\n * diff the same snapshot into the CRDT and the changed region would be inserted\n * N times (concurrent inserts at the same position → duplicated text). So only\n * ONE client — the \"lead\" — applies the snapshot; every other client receives\n * the result through normal Yjs sync.\n *\n * The lead is the present client with the lowest Yjs `clientID`. The agent's\n * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,\n * and a client editing alone is always the lead. This is deterministic across\n * clients with no coordination round-trip.\n */\nexport function isReconcileLeadClient(\n  awareness: Awareness | null | undefined,\n  localClientId: number | null | undefined,\n): boolean {\n  if (localClientId == null) return false;\n  if (!awareness) return true; // standalone / tests — act alone\n\n  let hasPeer = false;\n  let minVisible = localClientId;\n  awareness.getStates().forEach((state, clientId) => {\n    if (clientId === AGENT_CLIENT_ID) return; // agent never leads\n    if (clientId === localClientId) return;\n    const s = state as { user?: unknown; visible?: boolean };\n    if (!s || !s.user) return; // skip empty/stale entries\n    hasPeer = true;\n    // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)\n    // is skipped. A peer that hasn't published the field is treated as visible.\n    if (s.visible !== false && clientId < minVisible) minVisible = clientId;\n  });\n\n  // Sole client: always the applier — no other client can duplicate the edit,\n  // so single-user agent edits apply even if this tab reports hidden.\n  if (!hasPeer) return true;\n\n  // With peers present, exactly one VISIBLE client applies (the lowest clientId\n  // among visible ones). A backgrounded tab pauses its poll and can't reliably\n  // act, so it yields — otherwise an agent edit would never reach the tab the\n  // user is actually looking at. The caller re-elects on visibility change.\n  const localHidden =\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n  if (localHidden) return false;\n  return localClientId <= minVisible;\n}\n\nexport interface RemoteAwarenessSnapshot {\n  clientId: number;\n  state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n  states: Map<number, unknown>,\n  localClientId: number,\n  remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n  const incoming = new Set<number>();\n  const added: number[] = [];\n  const updated: number[] = [];\n  const removed: number[] = [];\n\n  for (const remote of remoteStates) {\n    if (\n      !Number.isFinite(remote.clientId) ||\n      remote.clientId === localClientId\n    ) {\n      continue;\n    }\n    incoming.add(remote.clientId);\n    const hadState = states.has(remote.clientId);\n    states.set(remote.clientId, remote.state);\n    (hadState ? updated : added).push(remote.clientId);\n  }\n\n  for (const clientId of Array.from(states.keys())) {\n    if (clientId === localClientId) continue;\n    if (incoming.has(clientId)) continue;\n    states.delete(clientId);\n    removed.push(clientId);\n  }\n\n  return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < arr.length; i++) {\n    binary += String.fromCharCode(arr[i]);\n  }\n  return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n  const binary = atob(b64);\n  const arr = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    arr[i] = binary.charCodeAt(i);\n  }\n  return arr;\n}\n\n/** Debounce delay for coalescing local Yjs update POSTs (ms). */\nconst UPDATE_DEBOUNCE_MS = 80;\n\n/** Fetch state-vector every N poll cycles as a low-frequency safety net. */\nconst STATE_VECTOR_FETCH_INTERVAL = 15;\n\n/** Poll ring-buffer size on the server (MAX_BUFFER in poll.ts). */\nconst POLL_RING_BUFFER_SIZE = 200;\n\n/** Exponential backoff: base delay (ms), multiplier, cap (ms). */\nconst BACKOFF_BASE_MS = 500;\nconst BACKOFF_MAX_MS = 15_000;\n\nfunction calcBackoff(consecutiveErrors: number): number {\n  const exp = Math.min(consecutiveErrors, 10);\n  const delay = BACKOFF_BASE_MS * Math.pow(2, exp);\n  // Add jitter: ±25%\n  const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n  return Math.min(delay + jitter, BACKOFF_MAX_MS);\n}\n\n// ---------------------------------------------------------------------------\n// Fast awareness helper — throttled per (docId, ydocId) pair so multiple\n// setLocalStateField calls within a 150ms window are coalesced into one POST.\n// ---------------------------------------------------------------------------\n\nconst _awarenessThrottleTimers = new Map<\n  string,\n  ReturnType<typeof setTimeout>\n>();\n\nfunction scheduleAwarenessPush(\n  baseUrl: string,\n  docId: string,\n  clientId: number,\n  getState: () => Record<string, unknown> | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  const key = `${docId}::${clientId}`;\n  if (_awarenessThrottleTimers.has(key)) return; // already scheduled\n\n  const timer = setTimeout(() => {\n    _awarenessThrottleTimers.delete(key);\n    const state = getState();\n    fetch(`${baseUrl}/${docId}/awareness`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        clientId,\n        state: state ? JSON.stringify(state) : null,\n      }),\n    }).catch(() => {}); // best-effort; poll cycle is the baseline fallback\n  }, 150);\n\n  _awarenessThrottleTimers.set(key, timer);\n}\n\nexport function useCollaborativeDoc(\n  options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n  const {\n    docId,\n    pollInterval = 2000,\n    pollIntervalWithSse = 12000,\n    pauseWhenHidden = true,\n    baseUrl = agentNativePath(\"/_agent-native/collab\"),\n    requestSource,\n    user,\n  } = options;\n\n  // Stable Y.Doc per docId\n  const ydoc = useMemo(() => {\n    if (!docId) return null;\n    return new Y.Doc();\n  }, [docId]);\n\n  // Stable Awareness per ydoc\n  const awareness = useMemo(() => {\n    if (!ydoc) return null;\n    return new Awareness(ydoc);\n  }, [ydoc]);\n\n  const [isLoading, setIsLoading] = useState(!!docId);\n  const [isSynced, setIsSynced] = useState(false);\n  const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n  const [agentActive, setAgentActive] = useState(false);\n  const [agentPresent, setAgentPresent] = useState(false);\n  // Set when the initial state fetch returns 404/403 — stops the awareness\n  // poll so we don't spam the console with errors against a doc that doesn't\n  // exist or isn't accessible.\n  const [docMissing, setDocMissing] = useState(false);\n  const agentTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pollVersionRef = useRef(0);\n\n  // Set local awareness state (user info for cursor labels). Also publish this\n  // tab's visibility so peers can elect a VISIBLE client to apply external\n  // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll\n  // and must not hold that role.\n  useEffect(() => {\n    if (!awareness || !user) return;\n    awareness.setLocalStateField(\"user\", {\n      name: user.name,\n      email: user.email,\n      color: user.color,\n    });\n    awareness.setLocalStateField(\"visible\", !isDocumentHidden());\n  }, [awareness, user?.name, user?.email, user?.color]);\n\n  // Fast awareness push: whenever local state changes (e.g. cursor moves,\n  // setPresence() calls), schedule a throttled POST so peers receive updates\n  // at ~150ms instead of waiting for the next 2s poll cycle. The poll cycle\n  // remains the authoritative baseline (cursors degrade gracefully without SSE).\n  useEffect(() => {\n    if (!awareness || !ydoc || !docId || !user) return;\n    const clientId = ydoc.clientID;\n\n    const onLocalStateChange = () => {\n      scheduleAwarenessPush(\n        baseUrl,\n        docId,\n        clientId,\n        () => awareness.getLocalState() as Record<string, unknown> | null,\n      );\n    };\n\n    // awareness emits \"change\" for local state changes too (when origin is \"local\").\n    awareness.on(\"change\", onLocalStateChange);\n    return () => {\n      awareness.off(\"change\", onLocalStateChange);\n    };\n  }, [awareness, ydoc, docId, baseUrl, user]);\n\n  // Track active users from awareness changes\n  useEffect(() => {\n    if (!awareness) return;\n\n    const updateUsers = () => {\n      const users: CollabUser[] = [];\n      let hasAgent = false;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc?.clientID) return; // Skip self\n        if (state.user) {\n          users.push(state.user as CollabUser);\n          if ((state.user as CollabUser).email === \"agent@system\") {\n            hasAgent = true;\n          }\n        }\n      });\n      setActiveUsers(dedupeCollabUsersByEmail(users));\n      setAgentPresent(hasAgent);\n    };\n\n    awareness.on(\"change\", updateUsers);\n    return () => {\n      awareness.off(\"change\", updateUsers);\n    };\n  }, [awareness, ydoc]);\n\n  // Clean up on unmount or docId change\n  useEffect(() => {\n    return () => {\n      awareness?.destroy();\n      ydoc?.destroy();\n    };\n  }, [ydoc, awareness]);\n\n  // Fetch server state and apply to existing doc\n  useEffect(() => {\n    if (!ydoc || !docId) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setIsSynced(false);\n    setDocMissing(false);\n\n    fetch(`${baseUrl}/${docId}/state`)\n      .then(async (res) => {\n        if (cancelled) return;\n        if (res.status === 404 || res.status === 403) {\n          setDocMissing(true);\n          setIsLoading(false);\n          setIsSynced(true);\n          return;\n        }\n        const data = (await res.json().catch(() => null)) as {\n          state?: string;\n        } | null;\n        if (data?.state) {\n          const binary = base64ToUint8Array(data.state);\n          if (binary.length > 4) {\n            Y.applyUpdate(ydoc, binary, \"remote\");\n          }\n        }\n        setIsLoading(false);\n        setIsSynced(true);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setIsLoading(false);\n        setIsSynced(true);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ydoc, docId, baseUrl]);\n\n  // Send local updates to server — debounced and coalesced with Y.mergeUpdates.\n  //\n  // Instead of firing one POST per Yjs update (one per keystroke), we accumulate\n  // updates in a buffer for UPDATE_DEBOUNCE_MS then merge them into a single\n  // request. The buffer is also flushed immediately on visibilitychange/pagehide\n  // and before each poll/awareness cycle so we don't hold stale local state.\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    let pendingUpdates: Uint8Array[] = [];\n    let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n    const flushPendingUpdates = (keepalive = false) => {\n      if (flushTimer) {\n        clearTimeout(flushTimer);\n        flushTimer = null;\n      }\n      if (pendingUpdates.length === 0) return;\n      const toSend = pendingUpdates;\n      pendingUpdates = [];\n\n      const merged = toSend.length === 1 ? toSend[0] : Y.mergeUpdates(toSend);\n      fetch(`${baseUrl}/${docId}/update`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          update: uint8ArrayToBase64(merged),\n          requestSource,\n        }),\n        ...(keepalive ? { keepalive: true } : {}),\n      }).catch(() => {});\n    };\n\n    // Expose flush to the poll loop via a ref so it can flush before each cycle.\n    // We store the flusher in a closure-captured variable; the poll effect\n    // below reads it through the shared `pendingFlushRef`.\n    (ydoc as any).__collabFlush = flushPendingUpdates;\n\n    const handler = (update: Uint8Array, origin: unknown) => {\n      if (origin === \"remote\") return;\n      pendingUpdates.push(update);\n      if (flushTimer) clearTimeout(flushTimer);\n      flushTimer = setTimeout(flushPendingUpdates, UPDATE_DEBOUNCE_MS);\n    };\n\n    const handlePageHide = () => {\n      flushPendingUpdates(true /* keepalive */);\n    };\n\n    ydoc.on(\"update\", handler);\n    if (typeof window !== \"undefined\") {\n      window.addEventListener(\"pagehide\", handlePageHide);\n    }\n\n    return () => {\n      ydoc.off(\"update\", handler);\n      delete (ydoc as any).__collabFlush;\n      if (typeof window !== \"undefined\") {\n        window.removeEventListener(\"pagehide\", handlePageHide);\n      }\n      // Flush any remaining updates on teardown\n      flushPendingUpdates(true);\n    };\n  }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n  // Poll for remote doc updates + awareness sync, with SSE fast-path.\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n    // Non-null capture: null branch returned early above; async closures lose\n    // the narrowing on the outer ydoc variable.\n    const doc: Y.Doc = ydoc;\n\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let consecutiveErrors = 0;\n    let pollCycleCount = 0;\n    // Track the last version we successfully polled. Used to detect ring-buffer\n    // overflow (version gap larger than the ring buffer).\n    let lastPolledVersion = pollVersionRef.current;\n\n    // SSE connection state. When SSE is healthy, poll interval is relaxed.\n    let sseActive = false;\n\n    // ── SSE fast-path ────────────────────────────────────────────────\n    // Subscribe to the SHARED framework transport for /_agent-native/events\n    // instead of opening a dedicated EventSource per collab doc. A tab holds\n    // exactly one SSE connection regardless of how many docs are mounted —\n    // extra streams eat the browser's per-origin connection budget and can\n    // starve regular data fetches (worst on HTTP/1.1 dev servers).\n    // Collab update events arrive push-style; we apply them immediately,\n    // avoiding ~2s polling latency for peer edits.\n    //\n    // NOTE: SSE events are subject to the same server-side access scoping as\n    // polling — the server only pushes events that canSeeChangeForUser allows.\n    // The server tags collab events with owner/orgId (security commit).\n    const handleSharedEvent = (change: SyncEvent) => {\n      if (\n        change.source === \"collab\" &&\n        change.docId === docId &&\n        typeof change.update === \"string\"\n      ) {\n        if (requestSource && change.requestSource === requestSource) return;\n        try {\n          Y.applyUpdate(doc, base64ToUint8Array(change.update), \"remote\");\n        } catch {\n          // Malformed update — trigger state-vector fetch on next poll\n        }\n\n        if (change.requestSource === \"agent\") {\n          setAgentActive(true);\n          if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n          agentTimerRef.current = setTimeout(() => setAgentActive(false), 3000);\n        }\n      }\n\n      // Keep pollVersionRef updated from shared-transport events so the poll\n      // loop starts from the right version when SSE drops.\n      if (typeof change.version === \"number\") {\n        pollVersionRef.current = Math.max(\n          pollVersionRef.current,\n          change.version,\n        );\n      }\n    };\n\n    const unsubscribeSharedEvents = subscribeSyncEvents({\n      onEvents: (events) => {\n        if (stopped) return;\n        for (const change of events) handleSharedEvent(change);\n      },\n      onSseStateChange: (connected) => {\n        sseActive = connected;\n        if (connected) consecutiveErrors = 0;\n      },\n      pauseWhenHidden,\n    });\n\n    // ── Poll loop ───────────────────────────────────────────────────\n    function getActivePollInterval(): number {\n      return sseActive ? pollIntervalWithSse : pollInterval;\n    }\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      timer = setTimeout(poll, getActivePollInterval());\n    }\n\n    async function fetchStateVector(): Promise<void> {\n      try {\n        const stateVector = uint8ArrayToBase64(Y.encodeStateVector(doc));\n        const stateRes = await fetch(\n          `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(stateVector)}`,\n        );\n        if (stateRes.ok) {\n          const stateData = (await stateRes.json().catch(() => null)) as {\n            state?: string;\n          } | null;\n          if (stateData?.state) {\n            const binary = base64ToUint8Array(stateData.state);\n            if (binary.length > 2) {\n              Y.applyUpdate(doc, binary, \"remote\");\n            }\n          }\n        }\n      } catch {\n        // Non-fatal; the next poll cycle will retry\n      }\n    }\n\n    async function poll() {\n      if (stopped) return;\n\n      // Flush any pending local updates before polling so the server has the\n      // latest state before we read remote changes.\n      const flush = (ydoc as any).__collabFlush as\n        | ((keepalive?: boolean) => void)\n        | undefined;\n      flush?.();\n\n      try {\n        const res = await fetch(\n          agentNativePath(\n            `/_agent-native/poll?since=${pollVersionRef.current}`,\n          ),\n        );\n        if (!res.ok) throw new Error(\"HTTP \" + res.status);\n\n        const data = await res.json();\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            docId?: string;\n            update?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        // Detect ring-buffer overflow: if the version jumped by more than the\n        // ring buffer size, some events were evicted and we need a state-vector\n        // fetch to reconcile the gap.\n        const versionGap = version - lastPolledVersion;\n        const hadGap = versionGap > POLL_RING_BUFFER_SIZE;\n\n        for (const evt of events) {\n          if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n            if (requestSource && evt.requestSource === requestSource) continue;\n            try {\n              Y.applyUpdate(doc, base64ToUint8Array(evt.update), \"remote\");\n            } catch {\n              // Failed to apply — fetch full state-vector below\n              await fetchStateVector();\n            }\n\n            if (evt.requestSource === \"agent\") {\n              setAgentActive(true);\n              if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n              agentTimerRef.current = setTimeout(\n                () => setAgentActive(false),\n                3000,\n              );\n            }\n          }\n        }\n\n        pollVersionRef.current = version;\n        lastPolledVersion = version;\n        pollCycleCount++;\n        consecutiveErrors = 0;\n\n        // Fetch state-vector only when needed:\n        //   1. Ring-buffer overflow detected (missed events).\n        //   2. Low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL cycles.\n        //   3. NOT on every cycle (the previous behavior causing 3 requests/cycle).\n        const shouldFetchStateVector =\n          hadGap || pollCycleCount % STATE_VECTOR_FETCH_INTERVAL === 0;\n\n        if (shouldFetchStateVector) {\n          await fetchStateVector();\n        }\n\n        // Sync awareness (cursor positions)\n        if (awareness) {\n          const localState = awareness.getLocalState();\n          if (localState) {\n            try {\n              const awarenessRes = await fetch(\n                `${baseUrl}/${docId}/awareness`,\n                {\n                  method: \"POST\",\n                  headers: { \"Content-Type\": \"application/json\" },\n                  body: JSON.stringify({\n                    clientId: doc.clientID,\n                    state: JSON.stringify(localState),\n                  }),\n                },\n              );\n              if (awarenessRes.ok) {\n                const awarenessData = await awarenessRes.json();\n                const remoteStates: RemoteAwarenessSnapshot[] = [];\n                for (const remote of awarenessData.states || []) {\n                  try {\n                    const remoteState = JSON.parse(remote.state);\n                    remoteStates.push({\n                      clientId: Number(remote.clientId),\n                      state: remoteState,\n                    });\n                  } catch {\n                    // Invalid state — skip\n                  }\n                }\n                const changes = reconcileRemoteAwarenessStates(\n                  awareness.getStates() as Map<number, unknown>,\n                  doc.clientID,\n                  remoteStates,\n                );\n                if (\n                  changes.added.length ||\n                  changes.updated.length ||\n                  changes.removed.length\n                ) {\n                  awareness.emit(\"change\", [changes, \"remote\"]);\n                }\n              }\n            } catch {\n              // Awareness sync failure is non-fatal\n            }\n          }\n        }\n      } catch {\n        // Network error — exponential backoff\n        consecutiveErrors++;\n        const backoff = calcBackoff(consecutiveErrors);\n        if (!stopped) {\n          timer = setTimeout(poll, backoff);\n          return;\n        }\n      }\n\n      schedulePoll();\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    // Publish this tab's visibility to peers. A hidden tab pauses its poll, so\n    // we push the state immediately (keepalive) instead of waiting for the next\n    // cycle — otherwise peers keep treating a backgrounded tab as the visible\n    // lead and an agent edit never lands on the tab the user is actually viewing.\n    function publishVisibility(visible: boolean) {\n      if (!awareness) return;\n      awareness.setLocalStateField(\"visible\", visible);\n      const localState = awareness.getLocalState();\n      if (!localState) return;\n      fetch(`${baseUrl}/${docId}/awareness`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          clientId: doc.clientID,\n          state: JSON.stringify(localState),\n        }),\n        keepalive: true,\n      }).catch(() => {});\n    }\n\n    function handleVisibilityChange() {\n      const visible = document.visibilityState === \"visible\";\n      publishVisibility(visible);\n      if (visible) {\n        // Also flush any pending updates when coming back into view\n        const flush = (ydoc as any).__collabFlush as\n          | ((keepalive?: boolean) => void)\n          | undefined;\n        flush?.();\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      unsubscribeSharedEvents();\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    ydoc,\n    awareness,\n    docId,\n    pollInterval,\n    pollIntervalWithSse,\n    pauseWhenHidden,\n    requestSource,\n    baseUrl,\n    docMissing,\n  ]);\n\n  // SSE fast-path for awareness: listen on the SHARED framework transport and\n  // apply any awareness-change events immediately so peers receive cursor\n  // moves push-style without waiting for the next poll cycle.\n  // Polling fallback keeps working when SSE is unavailable. Reconnection and\n  // focus/visibility handling live inside the shared transport.\n  useEffect(() => {\n    if (!ydoc || !docId || !awareness) {\n      return;\n    }\n    // Non-null captures for closures: null branches returned early above.\n    const capturedYdoc = ydoc;\n    const capturedAwareness = awareness;\n    let stopped = false;\n\n    const applyAwarenessEvent = (data: SyncEvent) => {\n      if (\n        data.source !== \"awareness\" ||\n        data.type !== \"awareness-change\" ||\n        data.docId !== docId\n      ) {\n        return;\n      }\n      const states = Array.isArray(data.states)\n        ? (data.states as Array<{ clientId: number; state: string }>)\n        : [];\n      const remoteStates: RemoteAwarenessSnapshot[] = [];\n      for (const remote of states) {\n        try {\n          remoteStates.push({\n            clientId: Number(remote.clientId),\n            state: JSON.parse(remote.state),\n          });\n        } catch {\n          // Invalid state entry — skip\n        }\n      }\n      const changes = reconcileRemoteAwarenessStates(\n        capturedAwareness.getStates() as Map<number, unknown>,\n        capturedYdoc.clientID,\n        remoteStates,\n      );\n      if (\n        changes.added.length ||\n        changes.updated.length ||\n        changes.removed.length\n      ) {\n        capturedAwareness.emit(\"change\", [changes, \"remote\"]);\n      }\n    };\n\n    const unsubscribe = subscribeSyncEvents({\n      onEvents: (events) => {\n        if (stopped) return;\n        for (const data of events) applyAwarenessEvent(data);\n      },\n    });\n\n    return () => {\n      stopped = true;\n      unsubscribe();\n    };\n  }, [ydoc, docId, awareness]);\n\n  return {\n    ydoc,\n    awareness,\n    isLoading,\n    isSynced,\n    activeUsers,\n    agentActive,\n    agentPresent,\n  };\n}\n"]}

package/dist/collab/index.d.ts

@@ -7,7 +7,9 @@ export { getCollabState, postCollabUpdate, postCollabText, postCollabSearchRepla
 export { seedYDocFromJson, yMapToJson, yArrayToJson, yDocToJson, applyJsonDiff, applyJsonPatch, initYDocWithJson, type PatchOp, } from "./json-to-yjs.js";
 export { postCollabJson, getCollabJson, postCollabPatch, } from "./struct-routes.js";
 export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, type AgentIdentity, } from "./agent-identity.js";
-export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, } from "./agent-presence.js";
+export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentTouchDocument, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, AGENT_PRESENCE_LINGER_MS, type AgentLeaveOptions, type AgentTouchOptions, } from "./agent-presence.js";
+export { appendRecentEdit, collectRecentEdits, publishRecentEdit, useRecentEdits, RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, type RecentEdit, type RecentEditDescriptor, type AttributedRecentEdit, type UseRecentEditsOptions, } from "./recent-edits.js";
+export { useCollabUndo, useLocalOpUndo, createLocalOpUndoController, type UseCollabUndoOptions, type UseCollabUndoResult, type CollabUndoScope, type UseLocalOpUndoOptions, type UseLocalOpUndoResult, type LocalOpUndoEntry, type LocalOpUndoController, type CreateLocalOpUndoOptions, type UndoKeyboardOptions, } from "./undo.js";
 export { getDocAwareness, getAwarenessEmitter, emitAwarenessChange, AWARENESS_CHANGE_EVENT, type AwarenessEntry, type AwarenessChangeEvent, } from "./awareness.js";
 export { usePresence, toNormalized, fromNormalized, type OtherPresence, type PresencePayload, type UsePresenceResult, type NormalizedPoint, } from "./presence.js";
 export { useFollowUser, type UseFollowUserOptions, type UseFollowUserResult, type ViewportDescriptor, } from "./follow-mode.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/collab/index.js

@@ -18,7 +18,11 @@ export { postCollabJson, getCollabJson, postCollabPatch, } from "./struct-routes
 // Agent identity
 export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, } from "./agent-identity.js";
 // Agent presence lifecycle
-export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, } from "./agent-presence.js";
+export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentTouchDocument, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, AGENT_PRESENCE_LINGER_MS, } from "./agent-presence.js";
+// Recent-edit attribution (lingering highlights)
+export { appendRecentEdit, collectRecentEdits, publishRecentEdit, useRecentEdits, RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, } from "./recent-edits.js";
+// Per-user undo/redo
+export { useCollabUndo, useLocalOpUndo, createLocalOpUndoController, } from "./undo.js";
 // Awareness (re-export for agent-presence consumers)
 export { getDocAwareness, getAwarenessEmitter, emitAwarenessChange, AWARENESS_CHANGE_EVENT, } from "./awareness.js";
 // Presence kit

package/dist/collab/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,UAAU;AACV,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE3E,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAE7B,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAE7B,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EACL,aAAa,GAId,MAAM,kBAAkB,CAAC","sourcesContent":["// Public API for @agent-native/core/collab\n\n// Storage\nexport {\n  loadYDocState,\n  saveYDocState,\n  hasCollabState,\n  deleteCollabState,\n  uint8ArrayToBase64,\n  base64ToUint8Array,\n} from \"./storage.js\";\n\n// YDoc manager\nexport {\n  getDoc,\n  applyUpdate,\n  applyText,\n  getText,\n  getState,\n  getIncUpdate,\n  seedFromText,\n  releaseDoc,\n  searchAndReplace,\n  applyJson,\n  applyPatchOps,\n  getJson,\n  seedFromJson,\n} from \"./ydoc-manager.js\";\n\n// XmlFragment operations\nexport { searchAndReplaceInYXml, extractTextFromYXml } from \"./xml-ops.js\";\n\n// Text-to-Yjs bridge\nexport { applyTextToYDoc, initYDocWithText } from \"./text-to-yjs.js\";\n\n// Emitter\nexport {\n  getCollabEmitter,\n  emitCollabUpdate,\n  type CollabEvent,\n} from \"./emitter.js\";\n\n// Route handlers\nexport {\n  getCollabState,\n  postCollabUpdate,\n  postCollabText,\n  postCollabSearchReplace,\n} from \"./routes.js\";\n\n// JSON-to-Yjs bridge (structured data)\nexport {\n  seedYDocFromJson,\n  yMapToJson,\n  yArrayToJson,\n  yDocToJson,\n  applyJsonDiff,\n  applyJsonPatch,\n  initYDocWithJson,\n  type PatchOp,\n} from \"./json-to-yjs.js\";\n\n// Structured data route handlers\nexport {\n  postCollabJson,\n  getCollabJson,\n  postCollabPatch,\n} from \"./struct-routes.js\";\n\n// Agent identity\nexport {\n  AGENT_CLIENT_ID,\n  DEFAULT_AGENT_IDENTITY,\n  type AgentIdentity,\n} from \"./agent-identity.js\";\n\n// Agent presence lifecycle\nexport {\n  agentEnterDocument,\n  agentLeaveDocument,\n  agentUpdateSelection,\n  agentApplyEditsIncrementally,\n  agentApplyPatchesIncrementally,\n} from \"./agent-presence.js\";\n\n// Awareness (re-export for agent-presence consumers)\nexport {\n  getDocAwareness,\n  getAwarenessEmitter,\n  emitAwarenessChange,\n  AWARENESS_CHANGE_EVENT,\n  type AwarenessEntry,\n  type AwarenessChangeEvent,\n} from \"./awareness.js\";\n\n// Presence kit\nexport {\n  usePresence,\n  toNormalized,\n  fromNormalized,\n  type OtherPresence,\n  type PresencePayload,\n  type UsePresenceResult,\n  type NormalizedPoint,\n} from \"./presence.js\";\n\n// Follow mode\nexport {\n  useFollowUser,\n  type UseFollowUserOptions,\n  type UseFollowUserResult,\n  type ViewportDescriptor,\n} from \"./follow-mode.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,UAAU;AACV,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE3E,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAE7B,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAE7B,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,cAAc,EACd,2BAA2B,GAU5B,MAAM,WAAW,CAAC;AAEnB,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EACL,aAAa,GAId,MAAM,kBAAkB,CAAC","sourcesContent":["// Public API for @agent-native/core/collab\n\n// Storage\nexport {\n  loadYDocState,\n  saveYDocState,\n  hasCollabState,\n  deleteCollabState,\n  uint8ArrayToBase64,\n  base64ToUint8Array,\n} from \"./storage.js\";\n\n// YDoc manager\nexport {\n  getDoc,\n  applyUpdate,\n  applyText,\n  getText,\n  getState,\n  getIncUpdate,\n  seedFromText,\n  releaseDoc,\n  searchAndReplace,\n  applyJson,\n  applyPatchOps,\n  getJson,\n  seedFromJson,\n} from \"./ydoc-manager.js\";\n\n// XmlFragment operations\nexport { searchAndReplaceInYXml, extractTextFromYXml } from \"./xml-ops.js\";\n\n// Text-to-Yjs bridge\nexport { applyTextToYDoc, initYDocWithText } from \"./text-to-yjs.js\";\n\n// Emitter\nexport {\n  getCollabEmitter,\n  emitCollabUpdate,\n  type CollabEvent,\n} from \"./emitter.js\";\n\n// Route handlers\nexport {\n  getCollabState,\n  postCollabUpdate,\n  postCollabText,\n  postCollabSearchReplace,\n} from \"./routes.js\";\n\n// JSON-to-Yjs bridge (structured data)\nexport {\n  seedYDocFromJson,\n  yMapToJson,\n  yArrayToJson,\n  yDocToJson,\n  applyJsonDiff,\n  applyJsonPatch,\n  initYDocWithJson,\n  type PatchOp,\n} from \"./json-to-yjs.js\";\n\n// Structured data route handlers\nexport {\n  postCollabJson,\n  getCollabJson,\n  postCollabPatch,\n} from \"./struct-routes.js\";\n\n// Agent identity\nexport {\n  AGENT_CLIENT_ID,\n  DEFAULT_AGENT_IDENTITY,\n  type AgentIdentity,\n} from \"./agent-identity.js\";\n\n// Agent presence lifecycle\nexport {\n  agentEnterDocument,\n  agentLeaveDocument,\n  agentUpdateSelection,\n  agentTouchDocument,\n  agentApplyEditsIncrementally,\n  agentApplyPatchesIncrementally,\n  AGENT_PRESENCE_LINGER_MS,\n  type AgentLeaveOptions,\n  type AgentTouchOptions,\n} from \"./agent-presence.js\";\n\n// Recent-edit attribution (lingering highlights)\nexport {\n  appendRecentEdit,\n  collectRecentEdits,\n  publishRecentEdit,\n  useRecentEdits,\n  RECENT_EDITS_MAX,\n  RECENT_EDIT_TTL_MS,\n  type RecentEdit,\n  type RecentEditDescriptor,\n  type AttributedRecentEdit,\n  type UseRecentEditsOptions,\n} from \"./recent-edits.js\";\n\n// Per-user undo/redo\nexport {\n  useCollabUndo,\n  useLocalOpUndo,\n  createLocalOpUndoController,\n  type UseCollabUndoOptions,\n  type UseCollabUndoResult,\n  type CollabUndoScope,\n  type UseLocalOpUndoOptions,\n  type UseLocalOpUndoResult,\n  type LocalOpUndoEntry,\n  type LocalOpUndoController,\n  type CreateLocalOpUndoOptions,\n  type UndoKeyboardOptions,\n} from \"./undo.js\";\n\n// Awareness (re-export for agent-presence consumers)\nexport {\n  getDocAwareness,\n  getAwarenessEmitter,\n  emitAwarenessChange,\n  AWARENESS_CHANGE_EVENT,\n  type AwarenessEntry,\n  type AwarenessChangeEvent,\n} from \"./awareness.js\";\n\n// Presence kit\nexport {\n  usePresence,\n  toNormalized,\n  fromNormalized,\n  type OtherPresence,\n  type PresencePayload,\n  type UsePresenceResult,\n  type NormalizedPoint,\n} from \"./presence.js\";\n\n// Follow mode\nexport {\n  useFollowUser,\n  type UseFollowUserOptions,\n  type UseFollowUserResult,\n  type ViewportDescriptor,\n} from \"./follow-mode.js\";\n"]}