@agent-native/core 0.4.5 → 0.6.1

package/dist/collab/routes.d.ts

@@ -0,0 +1,69 @@
+/**
+ * HTTP route handlers for collaborative editing.
+ *
+ * Mounted under /_agent-native/collab/ by the collab plugin.
+ */
+/**
+ * GET /_agent-native/collab/:docId/state
+ *
+ * Returns full Yjs document state as base64 for initial client load.
+ */
+export declare const getCollabState: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    error: string;
+    docId?: undefined;
+    state?: undefined;
+} | {
+    docId: string;
+    state: string;
+    error?: undefined;
+}>>;
+/**
+ * POST /_agent-native/collab/:docId/update
+ *
+ * Client sends a Yjs update (base64). Server applies it, persists, and
+ * emits a change event so other clients pick it up via polling.
+ *
+ * Body: { update: string (base64), requestSource?: string }
+ */
+export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    error: string;
+    ok?: undefined;
+} | {
+    ok: boolean;
+    error?: undefined;
+}>>;
+/**
+ * POST /_agent-native/collab/:docId/text
+ *
+ * Agent sends full text content. Server computes diff against current
+ * Yjs state and applies minimal operations.
+ *
+ * Body: { text: string, fieldName?: string, requestSource?: string }
+ */
+export declare const postCollabText: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    error: string;
+    ok?: undefined;
+    text?: undefined;
+} | {
+    ok: boolean;
+    text: string;
+    error?: undefined;
+}>>;
+/**
+ * POST /_agent-native/collab/:docId/search-replace
+ *
+ * Search-and-replace text in the Y.XmlFragment (ProseMirror tree).
+ * Produces minimal Yjs operations for cursor-preserving updates.
+ *
+ * Body: { find: string, replace: string, requestSource?: string }
+ */
+export declare const postCollabSearchReplace: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    error: string;
+    ok?: undefined;
+    found?: undefined;
+} | {
+    ok: boolean;
+    found: boolean;
+    error?: undefined;
+}>>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/collab/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;GAYzB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;GAsB3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;GA2BzB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;GA6BnC,CAAC"}

package/dist/collab/routes.js

@@ -0,0 +1,98 @@
+/**
+ * HTTP route handlers for collaborative editing.
+ *
+ * Mounted under /_agent-native/collab/ by the collab plugin.
+ */
+import { defineEventHandler, setResponseStatus, getRouterParam } from "h3";
+import * as manager from "./ydoc-manager.js";
+import { searchAndReplace as doSearchAndReplace } from "./ydoc-manager.js";
+import { uint8ArrayToBase64, base64ToUint8Array } from "./storage.js";
+import { readBody } from "../server/h3-helpers.js";
+/**
+ * GET /_agent-native/collab/:docId/state
+ *
+ * Returns full Yjs document state as base64 for initial client load.
+ */
+export const getCollabState = defineEventHandler(async (event) => {
+    const docId = getRouterParam(event, "docId");
+    if (!docId) {
+        setResponseStatus(event, 400);
+        return { error: "docId required" };
+    }
+    const state = await manager.getState(docId);
+    return {
+        docId,
+        state: uint8ArrayToBase64(state),
+    };
+});
+/**
+ * POST /_agent-native/collab/:docId/update
+ *
+ * Client sends a Yjs update (base64). Server applies it, persists, and
+ * emits a change event so other clients pick it up via polling.
+ *
+ * Body: { update: string (base64), requestSource?: string }
+ */
+export const postCollabUpdate = defineEventHandler(async (event) => {
+    const docId = getRouterParam(event, "docId");
+    if (!docId) {
+        setResponseStatus(event, 400);
+        return { error: "docId required" };
+    }
+    const body = await readBody(event);
+    const { update, requestSource } = body;
+    if (!update) {
+        setResponseStatus(event, 400);
+        return { error: "update (base64) required" };
+    }
+    const binary = base64ToUint8Array(update);
+    await manager.applyUpdate(docId, binary, requestSource);
+    return { ok: true };
+});
+/**
+ * POST /_agent-native/collab/:docId/text
+ *
+ * Agent sends full text content. Server computes diff against current
+ * Yjs state and applies minimal operations.
+ *
+ * Body: { text: string, fieldName?: string, requestSource?: string }
+ */
+export const postCollabText = defineEventHandler(async (event) => {
+    const docId = getRouterParam(event, "docId");
+    if (!docId) {
+        setResponseStatus(event, 400);
+        return { error: "docId required" };
+    }
+    const body = await readBody(event);
+    const { text, fieldName, requestSource } = body;
+    if (text === undefined) {
+        setResponseStatus(event, 400);
+        return { error: "text required" };
+    }
+    const result = await manager.applyText(docId, text, fieldName ?? "content", requestSource ?? "agent");
+    return { ok: true, text: result };
+});
+/**
+ * POST /_agent-native/collab/:docId/search-replace
+ *
+ * Search-and-replace text in the Y.XmlFragment (ProseMirror tree).
+ * Produces minimal Yjs operations for cursor-preserving updates.
+ *
+ * Body: { find: string, replace: string, requestSource?: string }
+ */
+export const postCollabSearchReplace = defineEventHandler(async (event) => {
+    const docId = getRouterParam(event, "docId");
+    if (!docId) {
+        setResponseStatus(event, 400);
+        return { error: "docId required" };
+    }
+    const body = await readBody(event);
+    const { find, replace, requestSource } = body;
+    if (!find) {
+        setResponseStatus(event, 400);
+        return { error: "find required" };
+    }
+    const result = await doSearchAndReplace(docId, find, replace ?? "", requestSource ?? "agent");
+    return { ok: true, found: result.found };
+});
+//# sourceMappingURL=routes.js.map

package/dist/collab/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/collab/routes.ts"],"names":[],"mappings":"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"}

package/dist/collab/storage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SQL storage for Yjs collaborative document state.
+ *
+ * Uses a framework-level `_collab_docs` table (TEXT columns with base64
+ * encoding for binary Yjs state) that works across SQLite and Postgres.
+ */
+/** Load Yjs state as Uint8Array, or null if not found. */
+export declare function loadYDocState(docId: string): Promise<Uint8Array | null>;
+/** Save Yjs state (Uint8Array) and a plain-text snapshot. */
+export declare function saveYDocState(docId: string, state: Uint8Array, textSnapshot: string): Promise<void>;
+/** Check if a document has collaborative state. */
+export declare function hasCollabState(docId: string): Promise<boolean>;
+/** Delete collaborative state for a document. */
+export declare function deleteCollabState(docId: string): Promise<void>;
+declare function uint8ArrayToBase64(arr: Uint8Array): string;
+declare function base64ToUint8Array(b64: string): Uint8Array;
+export { uint8ArrayToBase64, base64ToUint8Array };
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS7E;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;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

@@ -0,0 +1,94 @@
+/**
+ * SQL storage for Yjs collaborative document state.
+ *
+ * Uses a framework-level `_collab_docs` table (TEXT columns with base64
+ * encoding for binary Yjs state) that works across SQLite and Postgres.
+ */
+import { getDbExec, isPostgres } from "../db/client.js";
+let _initPromise;
+async function ensureTable() {
+    if (!_initPromise) {
+        _initPromise = (async () => {
+            const client = getDbExec();
+            const nowDefault = isPostgres() ? "NOW()::text" : "datetime('now')";
+            await client.execute(`
+        CREATE TABLE IF NOT EXISTS _collab_docs (
+          doc_id TEXT PRIMARY KEY,
+          yjs_state TEXT NOT NULL,
+          text_snapshot TEXT NOT NULL DEFAULT '',
+          updated_at TEXT NOT NULL DEFAULT (${nowDefault})
+        )
+      `);
+        })();
+    }
+    return _initPromise;
+}
+/** Load Yjs state as Uint8Array, or null if not found. */
+export async function loadYDocState(docId) {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT yjs_state FROM _collab_docs WHERE doc_id = ?`,
+        args: [docId],
+    });
+    if (rows.length === 0)
+        return null;
+    return base64ToUint8Array(rows[0].yjs_state);
+}
+/** Save Yjs state (Uint8Array) and a plain-text snapshot. */
+export async function saveYDocState(docId, state, textSnapshot) {
+    await ensureTable();
+    const client = getDbExec();
+    const b64 = uint8ArrayToBase64(state);
+    const nowExpr = isPostgres() ? "NOW()::text" : "datetime('now')";
+    await client.execute({
+        sql: isPostgres()
+            ? `INSERT INTO _collab_docs (doc_id, yjs_state, text_snapshot, updated_at) VALUES (?, ?, ?, ${nowExpr}) ON CONFLICT (doc_id) DO UPDATE SET yjs_state = EXCLUDED.yjs_state, text_snapshot = EXCLUDED.text_snapshot, updated_at = EXCLUDED.updated_at`
+            : `INSERT OR REPLACE INTO _collab_docs (doc_id, yjs_state, text_snapshot, updated_at) VALUES (?, ?, ?, ${nowExpr})`,
+        args: [docId, b64, textSnapshot],
+    });
+}
+/** Check if a document has collaborative state. */
+export async function hasCollabState(docId) {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT 1 FROM _collab_docs WHERE doc_id = ?`,
+        args: [docId],
+    });
+    return rows.length > 0;
+}
+/** Delete collaborative state for a document. */
+export async function deleteCollabState(docId) {
+    await ensureTable();
+    const client = getDbExec();
+    await client.execute({
+        sql: `DELETE FROM _collab_docs WHERE doc_id = ?`,
+        args: [docId],
+    });
+}
+// ─── Base64 helpers ──────────────────────────────────────────────────
+function uint8ArrayToBase64(arr) {
+    // Works in both Node.js and edge runtimes
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(arr).toString("base64");
+    }
+    let binary = "";
+    for (let i = 0; i < arr.length; i++) {
+        binary += String.fromCharCode(arr[i]);
+    }
+    return btoa(binary);
+}
+function base64ToUint8Array(b64) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(b64, "base64"));
+    }
+    const binary = atob(b64);
+    const arr = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        arr[i] = binary.charCodeAt(i);
+    }
+    return arr;
+}
+export { uint8ArrayToBase64, base64ToUint8Array };
+//# sourceMappingURL=storage.js.map

package/dist/collab/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/collab/storage.ts"],"names":[],"mappings":"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"}

package/dist/collab/text-to-yjs.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bridge between plain text and Yjs CRDT operations.
+ *
+ * Converts text diffs into minimal Yjs Y.Text operations (insert/delete)
+ * so that agent text changes merge cleanly with concurrent editor edits.
+ */
+import * as Y from "yjs";
+/**
+ * Apply new text content to a Y.Text field, computing a minimal diff
+ * and translating it into Yjs insert/delete operations.
+ *
+ * Returns the binary Yjs update produced by the transaction.
+ */
+export declare function applyTextToYDoc(doc: Y.Doc, fieldName: string, newText: string, origin?: string): Uint8Array;
+/**
+ * Initialize a Y.Doc with text content (for seeding from existing data).
+ * Returns the full document state as a Uint8Array.
+ */
+export declare function initYDocWithText(fieldName: string, text: string): {
+    doc: Y.Doc;
+    state: Uint8Array;
+};
+//# sourceMappingURL=text-to-yjs.d.ts.map

package/dist/collab/text-to-yjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-yjs.d.ts","sourceRoot":"","sources":["../../src/collab/text-to-yjs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAKzB;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,UAAU,CAwCZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAMnC"}

package/dist/collab/text-to-yjs.js

@@ -0,0 +1,63 @@
+/**
+ * Bridge between plain text and Yjs CRDT operations.
+ *
+ * Converts text diffs into minimal Yjs Y.Text operations (insert/delete)
+ * so that agent text changes merge cleanly with concurrent editor edits.
+ */
+import * as Y from "yjs";
+import DiffMatchPatch from "diff-match-patch";
+const dmp = new DiffMatchPatch();
+/**
+ * Apply new text content to a Y.Text field, computing a minimal diff
+ * and translating it into Yjs insert/delete operations.
+ *
+ * Returns the binary Yjs update produced by the transaction.
+ */
+export function applyTextToYDoc(doc, fieldName, newText, origin) {
+    const ytext = doc.getText(fieldName);
+    const currentText = ytext.toString();
+    if (currentText === newText) {
+        // No change — return empty update
+        return new Uint8Array(0);
+    }
+    // Compute character-level diff
+    const diffs = dmp.diff_main(currentText, newText);
+    dmp.diff_cleanupEfficiency(diffs);
+    // Capture the update produced by this transaction
+    let update = new Uint8Array(0);
+    const handler = (u) => {
+        update = u;
+    };
+    doc.on("update", handler);
+    doc.transact(() => {
+        let cursor = 0;
+        for (const [op, text] of diffs) {
+            switch (op) {
+                case DiffMatchPatch.DIFF_EQUAL:
+                    cursor += text.length;
+                    break;
+                case DiffMatchPatch.DIFF_DELETE:
+                    ytext.delete(cursor, text.length);
+                    break;
+                case DiffMatchPatch.DIFF_INSERT:
+                    ytext.insert(cursor, text);
+                    cursor += text.length;
+                    break;
+            }
+        }
+    }, origin);
+    doc.off("update", handler);
+    return update;
+}
+/**
+ * Initialize a Y.Doc with text content (for seeding from existing data).
+ * Returns the full document state as a Uint8Array.
+ */
+export function initYDocWithText(fieldName, text) {
+    const doc = new Y.Doc();
+    const ytext = doc.getText(fieldName);
+    ytext.insert(0, text);
+    const state = Y.encodeStateAsUpdate(doc);
+    return { doc, state };
+}
+//# sourceMappingURL=text-to-yjs.js.map

package/dist/collab/text-to-yjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-yjs.js","sourceRoot":"","sources":["../../src/collab/text-to-yjs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,GAAG,GAAG,IAAI,cAAc,EAAE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAU,EACV,SAAiB,EACjB,OAAe,EACf,MAAe;IAEf,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAErC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,kCAAkC;QAClC,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,+BAA+B;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAElC,kDAAkD;IAClD,IAAI,MAAM,GAAe,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;QAChC,MAAM,GAAG,CAAC,CAAC;IACb,CAAC,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1B,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE;QAChB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAC/B,QAAQ,EAAE,EAAE,CAAC;gBACX,KAAK,cAAc,CAAC,UAAU;oBAC5B,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;oBACtB,MAAM;gBACR,KAAK,cAAc,CAAC,WAAW;oBAC7B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBAClC,MAAM;gBACR,KAAK,cAAc,CAAC,WAAW;oBAC7B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBAC3B,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;oBACtB,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC,EAAE,MAAM,CAAC,CAAC;IAEX,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,IAAY;IAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/collab/xml-ops.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Operations on Y.XmlFragment for ProseMirror-based collaborative editing.
+ *
+ * These produce minimal Yjs operations so the client-side ySyncPlugin
+ * applies targeted ProseMirror transactions (preserving cursor/selection).
+ */
+import * as Y from "yjs";
+/**
+ * Walk a Y.XmlFragment tree and replace the first occurrence of `find`
+ * with `replace` in Y.XmlText nodes.
+ *
+ * Returns true if a replacement was made, false if text was not found.
+ */
+export declare function searchAndReplaceInYXml(element: Y.XmlFragment | Y.XmlElement, find: string, replace: string): boolean;
+/**
+ * Extract all plain text from a Y.XmlFragment tree.
+ * Joins block-level elements with newlines.
+ */
+export declare function extractTextFromYXml(element: Y.XmlFragment | Y.XmlElement): string;
+//# sourceMappingURL=xml-ops.d.ts.map

package/dist/collab/xml-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-ops.d.ts","sourceRoot":"","sources":["../../src/collab/xml-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CA2BT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,UAAU,GACpC,MAAM,CAaR"}

package/dist/collab/xml-ops.js

@@ -0,0 +1,59 @@
+/**
+ * Operations on Y.XmlFragment for ProseMirror-based collaborative editing.
+ *
+ * These produce minimal Yjs operations so the client-side ySyncPlugin
+ * applies targeted ProseMirror transactions (preserving cursor/selection).
+ */
+/**
+ * Walk a Y.XmlFragment tree and replace the first occurrence of `find`
+ * with `replace` in Y.XmlText nodes.
+ *
+ * Returns true if a replacement was made, false if text was not found.
+ */
+export function searchAndReplaceInYXml(element, find, replace) {
+    for (let i = 0; i < element.length; i++) {
+        const child = element.get(i);
+        if (child &&
+            typeof child.toString === "function" &&
+            typeof child.delete === "function" &&
+            typeof child.insert === "function" &&
+            child.length !== undefined &&
+            typeof child.get !== "function") {
+            // Y.XmlText — has delete/insert but no get (not a container)
+            const text = child.toString();
+            const idx = text.indexOf(find);
+            if (idx !== -1) {
+                child.delete(idx, find.length);
+                child.insert(idx, replace);
+                return true;
+            }
+        }
+        else if (child && typeof child.get === "function") {
+            // Y.XmlElement or Y.XmlFragment — has get() for children
+            if (searchAndReplaceInYXml(child, find, replace)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Extract all plain text from a Y.XmlFragment tree.
+ * Joins block-level elements with newlines.
+ */
+export function extractTextFromYXml(element) {
+    const parts = [];
+    for (let i = 0; i < element.length; i++) {
+        const child = element.get(i);
+        if (child && typeof child.get === "function") {
+            // Container node (XmlElement/XmlFragment)
+            parts.push(extractTextFromYXml(child));
+        }
+        else if (child) {
+            // Text node
+            parts.push(child.toString());
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=xml-ops.js.map

package/dist/collab/xml-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-ops.js","sourceRoot":"","sources":["../../src/collab/xml-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAqC,EACrC,IAAY,EACZ,OAAe;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAQ,CAAC;QACpC,IACE,KAAK;YACL,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;YACpC,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;YAClC,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;YAClC,KAAK,CAAC,MAAM,KAAK,SAAS;YAC1B,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAC/B,CAAC;YACD,6DAA6D;YAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC/B,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACpD,yDAAyD;YACzD,IAAI,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBACjD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAqC;IAErC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAQ,CAAC;QACpC,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YAC7C,0CAA0C;YAC1C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,YAAY;YACZ,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/collab/ydoc-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Server-side Yjs document manager with LRU caching and SQL persistence.
+ */
+import * as Y from "yjs";
+/**
+ * Get or load a Yjs document by ID. Creates a new empty doc if none exists.
+ */
+export declare function getDoc(docId: string): Promise<Y.Doc>;
+/**
+ * Apply a binary Yjs update (from a client) to a document.
+ * Persists the result and emits a change event.
+ */
+export declare function applyUpdate(docId: string, update: Uint8Array, requestSource?: string): Promise<void>;
+/**
+ * Apply a text change to a document. Computes the minimal diff and
+ * converts it to Yjs operations.
+ *
+ * Returns the text snapshot after the update.
+ */
+export declare function applyText(docId: string, newText: string, fieldName?: string, requestSource?: string): Promise<string>;
+/**
+ * Search-and-replace text within a Y.XmlFragment (ProseMirror tree).
+ * Produces minimal Yjs operations for cursor-preserving updates.
+ *
+ * Returns whether the text was found and the binary update.
+ */
+export declare function searchAndReplace(docId: string, find: string, replace: string, requestSource?: string): Promise<{
+    found: boolean;
+    update: Uint8Array;
+}>;
+/**
+ * Get the current text content of a document field.
+ */
+export declare function getText(docId: string, fieldName?: string): Promise<string>;
+/**
+ * Get the full document state as a Uint8Array.
+ */
+export declare function getState(docId: string): Promise<Uint8Array>;
+/**
+ * Get an incremental update relative to a client's state vector.
+ */
+export declare function getIncUpdate(docId: string, clientStateVector: Uint8Array): Promise<Uint8Array>;
+/**
+ * Seed a document from existing text content (for migration).
+ * Only seeds if no collab state exists yet.
+ */
+export declare function seedFromText(docId: string, text: string, fieldName?: string): Promise<void>;
+/**
+ * Release a document from the in-memory cache.
+ */
+export declare function releaseDoc(docId: string): void;
+//# sourceMappingURL=ydoc-manager.d.ts.map

package/dist/collab/ydoc-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ydoc-manager.d.ts","sourceRoot":"","sources":["../../src/collab/ydoc-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAmCzB;;GAEG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAgB1D;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAsB,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CA6BjD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,UAAU,GAC5B,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM9C"}