@haklex/rich-collab-loro 0.62.1 → 0.63.0

package/dist/binding.d.ts

@@ -1,6 +1,7 @@
 import { LexicalEditor, NodeKey } from 'lexical';
 import { LoroDoc, TreeID } from 'loro-crdt';
 export declare const COLLAB_TAG = "collab";
+export declare const AGENT_WRITE_TAG = "agent-write";
 export declare const TREE_NAME = "lexical";
 export interface LoroBinding {
     dispose: () => void;
@@ -9,6 +10,7 @@ export interface LoroBinding {
     keyOf: (id: TreeID) => NodeKey | undefined;
 }
 export interface LoroBindingOptions {
+    agentLiveWindowSeconds?: number;
     commitMessage?: string;
 }
 export declare function createLoroBinding(editor: LexicalEditor, doc: LoroDoc, options?: LoroBindingOptions): LoroBinding;

package/dist/binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,aAAa,EAElB,KAAK,OAAO,EAGb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAMnF,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,SAAS,YAAY,CAAC;AAGnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmBD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CA4Nb"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,aAAa,EAElB,KAAK,OAAO,EAGb,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,OAAO,EAGZ,KAAK,MAAM,EACZ,MAAM,WAAW,CAAC;AAMnB,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAG7C,eAAO,MAAM,SAAS,YAAY,CAAC;AAGnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmBD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAiOb"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { COLLAB_TAG, createLoroBinding, type LoroBinding, type LoroBindingOptions, TREE_NAME, } from './binding';
+export { AGENT_WRITE_TAG, COLLAB_TAG, createLoroBinding, type LoroBinding, type LoroBindingOptions, TREE_NAME, } from './binding';
 export { $reconcileRoot, editAtVersion } from './reconcile';
 export { type Frame, type FrameFocus, planFrames, streamAtVersion, type StreamStep, } from './stream';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,KAAK,KAAK,EACV,KAAK,UAAU,EACf,UAAU,EACV,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,KAAK,KAAK,EACV,KAAK,UAAU,EACf,UAAU,EACV,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC"}

package/dist/index.mjs

@@ -140,6 +140,9 @@ function editAtVersion(doc, frontiers, createEditor, target, commitMessage) {
 //#endregion
 //#region src/binding.ts
 var COLLAB_TAG = "collab";
+var AGENT_WRITE_TAG = "agent-write";
+var AGENT_MESSAGE_PREFIX = "agent:";
+var AGENT_LIVE_WINDOW_SECONDS = 15;
 var TREE_NAME = "lexical";
 var TEXT_KEY = "#text";
 function sameValue(a, b) {
@@ -306,7 +309,7 @@ function createLoroBinding(editor, doc, options = {}) {
 			if ($isElementNode(child)) $collectDescendants(child, out);
 		}
 	};
-	const pullFromDoc = () => {
+	const pullFromDoc = (agent = false) => {
 		editor.update(() => {
 			const rootTreeNode = tree.roots()[0];
 			if (!rootTreeNode) return;
@@ -321,7 +324,7 @@ function createLoroBinding(editor, doc, options = {}) {
 			for (const node of all) if (!visited.has(node.getKey()) && node.isAttached()) node.remove();
 		}, {
 			discrete: true,
-			tag: COLLAB_TAG
+			tag: agent ? [COLLAB_TAG, AGENT_WRITE_TAG] : COLLAB_TAG
 		});
 	};
 	if (tree.roots().length > 0) pullFromDoc();
@@ -334,14 +337,28 @@ function createLoroBinding(editor, doc, options = {}) {
 		idOf: (key) => keyToId.get(key),
 		keyOf: (id) => idToKey.get(id),
 		import: (bytes) => {
-			doc.import(bytes);
-			pullFromDoc();
+			pullFromDoc(hasLiveAgentChange(doc, doc.import(bytes), options.agentLiveWindowSeconds ?? AGENT_LIVE_WINDOW_SECONDS));
 		}
 	};
 }
 function $isTextLike(props) {
 	return typeof props.format === "number" && typeof props.detail === "number" && "mode" in props;
 }
+function hasLiveAgentChange(doc, status, windowSeconds) {
+	const oldest = Date.now() / 1e3 - windowSeconds;
+	for (const [peer, span] of status.success) {
+		let counter = span.start;
+		while (counter < span.end) {
+			const change = doc.getChangeAt({
+				peer,
+				counter
+			});
+			if (change.message?.startsWith(AGENT_MESSAGE_PREFIX) && change.timestamp >= oldest) return true;
+			counter = change.counter + change.length;
+		}
+	}
+	return false;
+}
 //#endregion
 //#region src/stream.ts
 var TYPING_FRAME_BUDGET = 120;
@@ -390,6 +407,7 @@ function pairGap(dels, adds) {
 		};
 	});
 }
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 function planFrames(base, target) {
 	const before = base.children ?? [];
 	const after = target.children ?? [];
@@ -482,6 +500,7 @@ function $locate(focus) {
 		offset: 0
 	};
 }
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 function streamAtVersion(doc, frontiers, createEditor, base, target, commitMessage) {
 	const fork = doc.forkAt(frontiers);
 	const editor = createEditor();
@@ -512,4 +531,4 @@ function streamAtVersion(doc, frontiers, createEditor, base, target, commitMessa
 	};
 }
 //#endregion
-export { $reconcileRoot, COLLAB_TAG, TREE_NAME, createLoroBinding, editAtVersion, planFrames, streamAtVersion };
+export { $reconcileRoot, AGENT_WRITE_TAG, COLLAB_TAG, TREE_NAME, createLoroBinding, editAtVersion, planFrames, streamAtVersion };

package/dist/stream.d.ts

@@ -16,7 +16,9 @@ export interface StreamStep {
     } | null;
     update: Uint8Array;
 }
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 export declare function planFrames(base: Json, target: Json): Frame[];
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 export declare function streamAtVersion(doc: LoroDoc, frontiers: Frontiers, createEditor: () => LexicalEditor, base: SerializedEditorState, target: SerializedEditorState, commitMessage?: string): {
     frontiers: Frontiers;
     steps: StreamStep[];

package/dist/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,qBAAqB,EAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,IAAI,EAAiB,MAAM,aAAa,CAAC;AAGvF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,MAAM,EAAE,UAAU,CAAC;CACpB;AA6DD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,CA6E5D;AAoBD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,aAAa,EACjC,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,qBAAqB,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAgB/C"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,qBAAqB,EAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,IAAI,EAAiB,MAAM,aAAa,CAAC;AAGvF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,MAAM,EAAE,UAAU,CAAC;CACpB;AA6DD,kIAAkI;AAClI,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,CA6E5D;AAoBD,kIAAkI;AAClI,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,aAAa,EACjC,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,qBAAqB,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAgB/C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haklex/rich-collab-loro",
-  "version": "0.62.1",
+  "version": "0.63.0",
   "description": "Loro CRDT binding for Lexical — bidirectional LoroTree sync for real-time collaboration and history",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
     "src"
   ],
   "devDependencies": {
-    "@haklex/rich-headless": "0.62.1",
-    "@haklex/rich-litexml": "0.62.1",
+    "@haklex/rich-headless": "0.63.0",
+    "@haklex/rich-litexml": "0.63.0",
     "@lexical/headless": "^0.53.0",
     "lexical": "^0.53.0",
     "loro-crdt": "^1.16.4",

package/src/binding.ts

@@ -13,13 +13,22 @@ import {
   type SerializedLexicalNode,
   type TextNode,
 } from 'lexical';
-import { type LoroDoc, LoroText, type LoroTreeNode, type TreeID } from 'loro-crdt';
+import {
+  type ImportStatus,
+  type LoroDoc,
+  LoroText,
+  type LoroTreeNode,
+  type TreeID,
+} from 'loro-crdt';
 
 import { transformOffset } from './offset';
 import { $updateInPlace } from './reconcile';
 import { stable } from './stable';
 
 export const COLLAB_TAG = 'collab';
+export const AGENT_WRITE_TAG = 'agent-write';
+const AGENT_MESSAGE_PREFIX = 'agent:';
+const AGENT_LIVE_WINDOW_SECONDS = 15;
 export const TREE_NAME = 'lexical';
 const TEXT_KEY = '#text';
 
@@ -31,6 +40,7 @@ export interface LoroBinding {
 }
 
 export interface LoroBindingOptions {
+  agentLiveWindowSeconds?: number;
   commitMessage?: string;
 }
 
@@ -235,7 +245,7 @@ export function createLoroBinding(
     }
   };
 
-  const pullFromDoc = () => {
+  const pullFromDoc = (agent = false) => {
     editor.update(
       () => {
         const rootTreeNode = tree.roots()[0];
@@ -254,7 +264,7 @@ export function createLoroBinding(
           if (!visited.has(node.getKey()) && node.isAttached()) node.remove();
         }
       },
-      { discrete: true, tag: COLLAB_TAG },
+      { discrete: true, tag: agent ? [COLLAB_TAG, AGENT_WRITE_TAG] : COLLAB_TAG },
     );
   };
 
@@ -271,8 +281,13 @@ export function createLoroBinding(
     idOf: (key) => keyToId.get(key),
     keyOf: (id) => idToKey.get(id),
     import: (bytes) => {
-      doc.import(bytes);
-      pullFromDoc();
+      pullFromDoc(
+        hasLiveAgentChange(
+          doc,
+          doc.import(bytes),
+          options.agentLiveWindowSeconds ?? AGENT_LIVE_WINDOW_SECONDS,
+        ),
+      );
     },
   };
 }
@@ -280,3 +295,18 @@ export function createLoroBinding(
 function $isTextLike(props: Props): boolean {
   return typeof props.format === 'number' && typeof props.detail === 'number' && 'mode' in props;
 }
+
+function hasLiveAgentChange(doc: LoroDoc, status: ImportStatus, windowSeconds: number): boolean {
+  const oldest = Date.now() / 1000 - windowSeconds;
+  for (const [peer, span] of status.success) {
+    let counter = span.start;
+    while (counter < span.end) {
+      const change = doc.getChangeAt({ peer, counter });
+      if (change.message?.startsWith(AGENT_MESSAGE_PREFIX) && change.timestamp >= oldest) {
+        return true;
+      }
+      counter = change.counter + change.length;
+    }
+  }
+  return false;
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 export {
+  AGENT_WRITE_TAG,
   COLLAB_TAG,
   createLoroBinding,
   type LoroBinding,

package/src/stream.ts

@@ -86,6 +86,7 @@ function pairGap(dels: Json[], adds: Json[]): Item[] {
   });
 }
 
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 export function planFrames(base: Json, target: Json): Frame[] {
   const before = base.children ?? [];
   const after = target.children ?? [];
@@ -183,6 +184,7 @@ function $locate(focus: FrameFocus | null): { key: NodeKey; offset: number } | n
     : { key: block.getKey(), offset: 0 };
 }
 
+/** @deprecated Agent writes are now played client-side by `@haklex/rich-plugin-agent-stream`; write once with `editAtVersion`. */
 export function streamAtVersion(
   doc: LoroDoc,
   frontiers: Frontiers,