@agent-native/core 0.77.8 → 0.77.11

package/dist/collab/awareness.d.ts

@@ -42,7 +42,7 @@ export declare function cleanExpired(map: Map<number, AwarenessEntry>): void;
  *
  * Client sends its awareness state and receives other clients' states.
  *
- * Body: { clientId: number, state: string (base64) }
+ * Body: { clientId: number, state: string | null (JSON-encoded awareness state, or null to clear) }
  * Response: { states: Array<{ clientId: number, state: string }> }
  */
 export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{

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;;;;;;kBAoCa,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;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"}

package/dist/collab/awareness.js

@@ -64,7 +64,7 @@ function pruneIfEmpty(docId, map) {
  *
  * Client sends its awareness state and receives other clients' states.
  *
- * Body: { clientId: number, state: string (base64) }
+ * Body: { clientId: number, state: string | null (JSON-encoded awareness state, or null to clear) }
  * Response: { states: Array<{ clientId: number, state: string }> }
  */
 export const postAwareness = defineEventHandler(async (event) => {
@@ -75,22 +75,26 @@ export const postAwareness = defineEventHandler(async (event) => {
     }
     const body = await readBody(event);
     const { clientId, state } = body;
-    if (clientId == null || !state) {
+    if (clientId == null || state === undefined) {
         // `!clientId` would wrongly reject clientId === 0, which is a valid
-        // (if rare) Yjs client id. Only reject missing/null ids here.
+        // (if rare) Yjs client id. A null state is valid: it clears this client.
         setResponseStatus(event, 400);
         return { error: "clientId and state required" };
     }
     const map = getDocAwareness(docId);
-    // Store this client's state
-    map.set(clientId, { clientId, state, lastSeen: Date.now() });
+    if (state === null) {
+        map.delete(clientId);
+    }
+    else {
+        // Store this client's state
+        map.set(clientId, { clientId, state, lastSeen: Date.now() });
+    }
     // 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.
     cleanExpired(map);
-    // map has at least the sender's entry so size >= 1 here; pruneIfEmpty is a
-    // no-op in the normal path but guards against edge cases (e.g. clientId 0
-    // that was immediately evicted by a concurrent cleanExpired run).
+    // Null-state clears and expiry can empty the map; prune the outer entry so
+    // transient document ids do not accumulate.
     pruneIfEmpty(docId, map);
     // Build the full list of current states (all clients including sender).
     const allStates = [];

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 (base64) }\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;\n  };\n\n  if (clientId == null || !state) {\n    // `!clientId` would wrongly reject clientId === 0, which is a valid\n    // (if rare) Yjs client id. Only reject missing/null ids here.\n    setResponseStatus(event, 400);\n    return { error: \"clientId and state required\" };\n  }\n\n  const map = getDocAwareness(docId);\n\n  // Store this client's state\n  map.set(clientId, { clientId, state, lastSeen: Date.now() });\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  // map has at least the sender's entry so size >= 1 here; pruneIfEmpty is a\n  // no-op in the normal path but guards against edge cases (e.g. clientId 0\n  // that was immediately evicted by a concurrent cleanExpired run).\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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAG3E,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,aAAa;AAQ/C,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAA2B,CAAC;AAclE,MAAM,iBAAiB,GAAG,IAAI,YAAY,EAAE,CAAC;AAC7C,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAErC,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,MAAkD,EAClD,KAAc,EACd,KAAc;IAEd,MAAM,KAAK,GAAyB;QAClC,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,kBAAkB;QACxB,KAAK;QACL,MAAM;QACN,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;KACxB,CAAC;IACF,iBAAiB,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,wCAAwC;AACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuC,CAAC;AAErE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAgC;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,GAAG,iBAAiB,EAAE,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,0EAA0E;AAC1E,SAAS,YAAY,CAAC,KAAa,EAAE,GAAgC;IACnE,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACnB,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IACvE,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAG3B,CAAC;IAEF,IAAI,QAAQ,IAAI,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5C,oEAAoE;QACpE,yEAAyE;QACzE,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,6EAA6E;IAC7E,yEAAyE;IACzE,mDAAmD;IACnD,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,2EAA2E;IAC3E,4CAA4C;IAC5C,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEzB,wEAAwE;IACxE,MAAM,SAAS,GAA+C,EAAE,CAAC;IACjE,MAAM,WAAW,GAA+C,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,2EAA2E;IAC3E,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAEtC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IACxE,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEzB,MAAM,KAAK,GAAkD,EAAE,CAAC;IAChE,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC","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"]}

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;AA2ED,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;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"}

package/dist/collab/client.js

@@ -197,12 +197,13 @@ function scheduleAwarenessPush(baseUrl, docId, clientId, getState) {
     const timer = setTimeout(() => {
         _awarenessThrottleTimers.delete(key);
         const state = getState();
-        if (!state)
-            return;
         fetch(`${baseUrl}/${docId}/awareness`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ clientId, state: JSON.stringify(state) }),
+            body: JSON.stringify({
+                clientId,
+                state: state ? JSON.stringify(state) : null,
+            }),
         }).catch(() => { }); // best-effort; poll cycle is the baseline fallback
     }, 150);
     _awarenessThrottleTimers.set(key, timer);

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    if (!state) return;\n    fetch(`${baseUrl}/${docId}/awareness`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ clientId, state: JSON.stringify(state) }),\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 { 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"]}

package/dist/collab/routes.d.ts

@@ -42,8 +42,8 @@ export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import
  */
 export declare const postCollabText: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     ok?: undefined;
-    text?: undefined;
     error: string;
+    text?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAYjC;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAG7E;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpE;AAED,iDAAiD;AACjD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAID,iBAAS,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAUnD;AAED,iBAAS,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAUnD;AAED,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsDH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAYjC;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAG7E;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpE;AAED,iDAAiD;AACjD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAID,iBAAS,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAUnD;AAED,iBAAS,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAUnD;AAED,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/collab/storage.js

@@ -5,13 +5,14 @@
  * encoding for binary Yjs state) that works across SQLite and Postgres.
  */
 import { getDbExec, isPostgres } from "../db/client.js";
+import { ensureTableExists, ensureColumnExists } from "../db/ddl-guard.js";
 let _initPromise;
 async function ensureTable() {
     if (!_initPromise) {
         _initPromise = (async () => {
             const client = getDbExec();
             const nowDefault = isPostgres() ? "NOW()::text" : "datetime('now')";
-            await client.execute(`
+            const createSql = `
         CREATE TABLE IF NOT EXISTS _collab_docs (
           doc_id TEXT PRIMARY KEY,
           yjs_state TEXT NOT NULL,
@@ -19,7 +20,18 @@ async function ensureTable() {
           version INTEGER NOT NULL DEFAULT 0,
           updated_at TEXT NOT NULL DEFAULT (${nowDefault})
         )
-      `);
+      `;
+            if (isPostgres()) {
+                // PG-guard: probe information_schema first (no lock) and only issue
+                // DDL when the table/column is actually missing, wrapped in a
+                // transaction-scoped lock_timeout so a contended lock fails fast.
+                await ensureTableExists("_collab_docs", createSql);
+                await ensureColumnExists("_collab_docs", "version", `ALTER TABLE _collab_docs ADD COLUMN IF NOT EXISTS version INTEGER NOT NULL DEFAULT 0`);
+                return;
+            }
+            // SQLite (local dev): no ACCESS EXCLUSIVE lock problem — keep existing
+            // create-then-additive-alter behaviour.
+            await client.execute(createSql);
             try {
                 await client.execute(`ALTER TABLE _collab_docs ADD COLUMN version INTEGER NOT NULL DEFAULT 0`);
             }

package/dist/collab/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL storage for Yjs collaborative document state.\n *\n * Uses a framework-level `_collab_docs` table (TEXT columns with base64\n * encoding for binary Yjs state) that works across SQLite and Postgres.\n */\n\nimport { getDbExec, isPostgres } from \"../db/client.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\nasync function ensureTable(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      const nowDefault = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS _collab_docs (\n          doc_id TEXT PRIMARY KEY,\n          yjs_state TEXT NOT NULL,\n          text_snapshot TEXT NOT NULL DEFAULT '',\n          version INTEGER NOT NULL DEFAULT 0,\n          updated_at TEXT NOT NULL DEFAULT (${nowDefault})\n        )\n      `);\n      try {\n        await client.execute(\n          `ALTER TABLE _collab_docs ADD COLUMN version INTEGER NOT NULL DEFAULT 0`,\n        );\n      } catch {\n        // Existing deployments already have the column after the first run.\n      }\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\nexport interface YDocStateRecord {\n  state: Uint8Array;\n  version: number;\n}\n\n/** Load Yjs state plus optimistic concurrency version. */\nexport async function loadYDocRecord(\n  docId: string,\n): Promise<YDocStateRecord | null> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT yjs_state, version FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n  if (rows.length === 0) return null;\n  return {\n    state: base64ToUint8Array(rows[0].yjs_state as string),\n    version: Number(rows[0].version ?? 0),\n  };\n}\n\n/** Load Yjs state as Uint8Array, or null if not found. */\nexport async function loadYDocState(docId: string): Promise<Uint8Array | null> {\n  const record = await loadYDocRecord(docId);\n  return record?.state ?? null;\n}\n\n/** Save only if the stored row still has the version the caller merged from. */\nexport async function trySaveYDocState(\n  docId: string,\n  state: Uint8Array,\n  textSnapshot: string,\n  expectedVersion: number | null,\n): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const b64 = uint8ArrayToBase64(state);\n  const nowExpr = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n  if (expectedVersion === null) {\n    const result = await client.execute({\n      sql: isPostgres()\n        ? `INSERT INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr}) ON CONFLICT (doc_id) DO NOTHING`\n        : `INSERT OR IGNORE INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr})`,\n      args: [docId, b64, textSnapshot],\n    });\n    return result.rowsAffected > 0;\n  }\n\n  const result = await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ? AND version = ?`,\n    args: [b64, textSnapshot, docId, expectedVersion],\n  });\n  return result.rowsAffected > 0;\n}\n\n/** Save Yjs state (Uint8Array) and a plain-text snapshot. */\nexport async function saveYDocState(\n  docId: string,\n  state: Uint8Array,\n  textSnapshot: string,\n): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  const b64 = uint8ArrayToBase64(state);\n  const nowExpr = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n  const updated = await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ?`,\n    args: [b64, textSnapshot, docId],\n  });\n  if (updated.rowsAffected > 0) return;\n\n  const inserted = await client.execute({\n    sql: isPostgres()\n      ? `INSERT INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr}) ON CONFLICT (doc_id) DO NOTHING`\n      : `INSERT OR IGNORE INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr})`,\n    args: [docId, b64, textSnapshot],\n  });\n  if (inserted.rowsAffected > 0) return;\n\n  await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ?`,\n    args: [b64, textSnapshot, docId],\n  });\n}\n\n/** Check if a document has collaborative state. */\nexport async function hasCollabState(docId: string): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT 1 FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n  return rows.length > 0;\n}\n\n/** Delete collaborative state for a document. */\nexport async function deleteCollabState(docId: string): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  await client.execute({\n    sql: `DELETE FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n}\n\n// ─── Base64 helpers ──────────────────────────────────────────────────\n\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  // Works in both Node.js and edge runtimes\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(arr).toString(\"base64\");\n  }\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  if (typeof Buffer !== \"undefined\") {\n    return new Uint8Array(Buffer.from(b64, \"base64\"));\n  }\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\nexport { uint8ArrayToBase64, base64ToUint8Array };\n"]}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL storage for Yjs collaborative document state.\n *\n * Uses a framework-level `_collab_docs` table (TEXT columns with base64\n * encoding for binary Yjs state) that works across SQLite and Postgres.\n */\n\nimport { getDbExec, isPostgres } from \"../db/client.js\";\nimport { ensureTableExists, ensureColumnExists } from \"../db/ddl-guard.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\nasync function ensureTable(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      const nowDefault = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n      const createSql = `\n        CREATE TABLE IF NOT EXISTS _collab_docs (\n          doc_id TEXT PRIMARY KEY,\n          yjs_state TEXT NOT NULL,\n          text_snapshot TEXT NOT NULL DEFAULT '',\n          version INTEGER NOT NULL DEFAULT 0,\n          updated_at TEXT NOT NULL DEFAULT (${nowDefault})\n        )\n      `;\n\n      if (isPostgres()) {\n        // PG-guard: probe information_schema first (no lock) and only issue\n        // DDL when the table/column is actually missing, wrapped in a\n        // transaction-scoped lock_timeout so a contended lock fails fast.\n        await ensureTableExists(\"_collab_docs\", createSql);\n        await ensureColumnExists(\n          \"_collab_docs\",\n          \"version\",\n          `ALTER TABLE _collab_docs ADD COLUMN IF NOT EXISTS version INTEGER NOT NULL DEFAULT 0`,\n        );\n        return;\n      }\n\n      // SQLite (local dev): no ACCESS EXCLUSIVE lock problem — keep existing\n      // create-then-additive-alter behaviour.\n      await client.execute(createSql);\n      try {\n        await client.execute(\n          `ALTER TABLE _collab_docs ADD COLUMN version INTEGER NOT NULL DEFAULT 0`,\n        );\n      } catch {\n        // Existing deployments already have the column after the first run.\n      }\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\nexport interface YDocStateRecord {\n  state: Uint8Array;\n  version: number;\n}\n\n/** Load Yjs state plus optimistic concurrency version. */\nexport async function loadYDocRecord(\n  docId: string,\n): Promise<YDocStateRecord | null> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT yjs_state, version FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n  if (rows.length === 0) return null;\n  return {\n    state: base64ToUint8Array(rows[0].yjs_state as string),\n    version: Number(rows[0].version ?? 0),\n  };\n}\n\n/** Load Yjs state as Uint8Array, or null if not found. */\nexport async function loadYDocState(docId: string): Promise<Uint8Array | null> {\n  const record = await loadYDocRecord(docId);\n  return record?.state ?? null;\n}\n\n/** Save only if the stored row still has the version the caller merged from. */\nexport async function trySaveYDocState(\n  docId: string,\n  state: Uint8Array,\n  textSnapshot: string,\n  expectedVersion: number | null,\n): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const b64 = uint8ArrayToBase64(state);\n  const nowExpr = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n  if (expectedVersion === null) {\n    const result = await client.execute({\n      sql: isPostgres()\n        ? `INSERT INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr}) ON CONFLICT (doc_id) DO NOTHING`\n        : `INSERT OR IGNORE INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr})`,\n      args: [docId, b64, textSnapshot],\n    });\n    return result.rowsAffected > 0;\n  }\n\n  const result = await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ? AND version = ?`,\n    args: [b64, textSnapshot, docId, expectedVersion],\n  });\n  return result.rowsAffected > 0;\n}\n\n/** Save Yjs state (Uint8Array) and a plain-text snapshot. */\nexport async function saveYDocState(\n  docId: string,\n  state: Uint8Array,\n  textSnapshot: string,\n): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  const b64 = uint8ArrayToBase64(state);\n  const nowExpr = isPostgres() ? \"NOW()::text\" : \"datetime('now')\";\n  const updated = await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ?`,\n    args: [b64, textSnapshot, docId],\n  });\n  if (updated.rowsAffected > 0) return;\n\n  const inserted = await client.execute({\n    sql: isPostgres()\n      ? `INSERT INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr}) ON CONFLICT (doc_id) DO NOTHING`\n      : `INSERT OR IGNORE INTO _collab_docs (doc_id, yjs_state, text_snapshot, version, updated_at) VALUES (?, ?, ?, 0, ${nowExpr})`,\n    args: [docId, b64, textSnapshot],\n  });\n  if (inserted.rowsAffected > 0) return;\n\n  await client.execute({\n    sql: `UPDATE _collab_docs SET yjs_state = ?, text_snapshot = ?, version = version + 1, updated_at = ${nowExpr} WHERE doc_id = ?`,\n    args: [b64, textSnapshot, docId],\n  });\n}\n\n/** Check if a document has collaborative state. */\nexport async function hasCollabState(docId: string): Promise<boolean> {\n  await ensureTable();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT 1 FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n  return rows.length > 0;\n}\n\n/** Delete collaborative state for a document. */\nexport async function deleteCollabState(docId: string): Promise<void> {\n  await ensureTable();\n  const client = getDbExec();\n  await client.execute({\n    sql: `DELETE FROM _collab_docs WHERE doc_id = ?`,\n    args: [docId],\n  });\n}\n\n// ─── Base64 helpers ──────────────────────────────────────────────────\n\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  // Works in both Node.js and edge runtimes\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(arr).toString(\"base64\");\n  }\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  if (typeof Buffer !== \"undefined\") {\n    return new Uint8Array(Buffer.from(b64, \"base64\"));\n  }\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\nexport { uint8ArrayToBase64, base64ToUint8Array };\n"]}

package/dist/db/ddl-guard.d.ts

@@ -59,6 +59,69 @@ export declare function pgColumnExists(table: string, column: string, injectedCl
  * skips the lock on the already-migrated hot path.
  */
 export declare function pgIndexExists(indexName: string, injectedClient?: DbExec): Promise<boolean>;
+/**
+ * Probe → guarded-DDL → re-probe sequence for one piece of on-demand schema.
+ *
+ * This is the single safe primitive every `ensureTable()` should use so a
+ * swallowed `lock_timeout` can NEVER poison a store's init memo with missing
+ * schema. The flow:
+ *
+ *   1. `probe()` — cheap, lock-free existence check (pgTableExists / etc.).
+ *      Already present → return `false` (nothing to do; the hot path takes NO
+ *      lock).
+ *   2. Missing → run `ddl` through `runGuardedDdl` (bounded `lock_timeout`).
+ *      - DDL completed → return `true`.
+ *      - DDL was swallowed by a lock-timeout (`runGuardedDdl` returned `false`)
+ *        → RE-PROBE. A concurrent connection virtually always created the
+ *        object meanwhile, so the re-probe usually now reports it present →
+ *        return `true`. But if it is STILL missing, the required schema does
+ *        NOT exist and we must NOT let the caller memoize success — so THROW.
+ *        The caller's `_initPromise` rejects and the next call retries instead
+ *        of running forever against absent schema.
+ *
+ * On SQLite the probe is always `false` (helpers no-op there) and the SQLite
+ * branch of each store keeps its own create-then-catch behaviour, so this is a
+ * Postgres-path primitive in practice. Returns `true` when the object exists
+ * after this call (either pre-existing-after-timeout-race or freshly created),
+ * `false` only when it already existed up front (no DDL issued).
+ */
+export declare function ensureSchemaObject(options: {
+    /** Lock-free existence check; `true` ⇒ already present, skip DDL. */
+    probe: () => Promise<boolean>;
+    /** DDL to run only when `probe()` reports the object missing. */
+    ddl: string;
+    /** Human-readable name of what's being ensured, for the error message. */
+    label: string;
+    /** Forwarded to `runGuardedDdl`. */
+    lockTimeout?: string;
+    /** Injectable client for tests. */
+    injectedClient?: DbExec;
+}): Promise<boolean>;
+/**
+ * Convenience wrapper: ensure a TABLE exists (probe via `pgTableExists`).
+ * No-op-returns `false` on SQLite (probe is always false there) — callers run
+ * the SQLite create on their own branch, so this is used on the Postgres path.
+ */
+export declare function ensureTableExists(table: string, createSql: string, options?: {
+    lockTimeout?: string;
+    injectedClient?: DbExec;
+}): Promise<boolean>;
+/**
+ * Convenience wrapper: ensure a COLUMN exists (probe via `pgColumnExists`).
+ * `addColumnSql` should be the full `ALTER TABLE … ADD COLUMN IF NOT EXISTS …`.
+ */
+export declare function ensureColumnExists(table: string, column: string, addColumnSql: string, options?: {
+    lockTimeout?: string;
+    injectedClient?: DbExec;
+}): Promise<boolean>;
+/**
+ * Convenience wrapper: ensure an INDEX exists (probe via `pgIndexExists`).
+ * `createIndexSql` should be the full `CREATE INDEX IF NOT EXISTS <name> …`.
+ */
+export declare function ensureIndexExists(indexName: string, createIndexSql: string, options?: {
+    lockTimeout?: string;
+    injectedClient?: DbExec;
+}): Promise<boolean>;
 /** True when an error looks like a Postgres `lock_timeout` (SQLSTATE 55P03). */
 export declare function isLockTimeoutError(err: unknown): boolean;
 /**