@superdoc-dev/cli 0.2.0-next.78 → 0.2.0-next.79

package/dist/index.js

@@ -117095,9 +117095,9 @@ var init_remark_gfm_CjV8kaUy_es = __esm(() => {
   init_remark_gfm_z_sDF4ss_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-DWn-KD3r.es.js
-var exports_src_DWn_KD3r_es = {};
-__export(exports_src_DWn_KD3r_es, {
+// ../../packages/superdoc/dist/chunks/src-B8Sjis_q.es.js
+var exports_src_B8Sjis_q_es = {};
+__export(exports_src_B8Sjis_q_es, {
   zt: () => defineMark,
   z: () => cM,
   yt: () => removeAwarenessStates,
@@ -127066,9 +127066,9 @@ function decodeTextRefPayload(encoded, stepId) {
     throw planError("INVALID_INPUT", "invalid text ref encoding", stepId);
   }
 }
-function resolveV3TextRef(editor, index2, step3, refData, options) {
+function resolveV3TextRef(editor, index2, step3, refData) {
   const currentRevision = getRevision(editor);
-  if ((options?.enforceRefRevision ?? true) && refData.rev !== currentRevision)
+  if (refData.rev !== currentRevision)
     throw planError("REVISION_MISMATCH", `Text ref is ephemeral and revision-scoped. Re-run query.match to obtain a fresh handle.ref for revision ${currentRevision}.`, step3.id, {
       refRevision: refData.rev,
       currentRevision,
@@ -127103,11 +127103,11 @@ function resolveV3TextRef(editor, index2, step3, refData, options) {
   }
   return [buildSpanTarget(editor, index2, step3, segments, refData.matchId)];
 }
-function resolveTextRef(editor, index2, step3, ref$1, options) {
+function resolveTextRef(editor, index2, step3, ref$1) {
   const payload = decodeTextRefPayload(ref$1.slice(5), step3.id);
   if (!isV3Ref(payload))
     throw planError("INVALID_INPUT", "only V3 text refs are supported", step3.id);
-  return resolveV3TextRef(editor, index2, step3, payload, options);
+  return resolveV3TextRef(editor, index2, step3, payload);
 }
 function resolveBlockRef(editor, index2, step3, ref$1) {
   const candidate = index2.candidates.find((c$3) => c$3.nodeId === ref$1);
@@ -127123,22 +127123,22 @@ function resolveBlockRef(editor, index2, step3, ref$1) {
     blockPos: candidate.pos
   }, candidate)];
 }
-function dispatchRefHandler(editor, index2, step3, ref$1, options) {
+function dispatchRefHandler(editor, index2, step3, ref$1) {
   for (const entry of REF_HANDLERS)
     if (entry.prefix === "" || ref$1.startsWith(entry.prefix))
-      return entry.handler(editor, index2, step3, ref$1, options);
+      return entry.handler(editor, index2, step3, ref$1);
   return resolveBlockRef(editor, index2, step3, ref$1);
 }
-function resolveRefTargets(editor, index2, step3, where, options) {
-  return dispatchRefHandler(editor, index2, step3, where.ref, options);
+function resolveRefTargets(editor, index2, step3, where) {
+  return dispatchRefHandler(editor, index2, step3, where.ref);
 }
-function resolveStepTargets(editor, index2, step3, options) {
+function resolveStepTargets(editor, index2, step3) {
   const where = step3.where;
   const refWhere = isRefWhere(where) ? where : undefined;
   const selectWhere = isSelectWhere(where) ? where : undefined;
   let targets;
   if (refWhere)
-    targets = resolveRefTargets(editor, index2, step3, refWhere, options);
+    targets = resolveRefTargets(editor, index2, step3, refWhere);
   else if (selectWhere)
     targets = resolveTextSelector(editor, index2, selectWhere.select, selectWhere.within, step3.id).addresses.map((addr) => {
       const candidate = index2.candidates.find((c$3) => c$3.nodeId === addr.blockId);
@@ -127320,7 +127320,7 @@ function assertNoDuplicateBlockIds(index2) {
       remediation: "Re-import the document or call document.repair() to assign unique identities."
     });
 }
-function compilePlan(editor, steps, options) {
+function compilePlan(editor, steps) {
   if (steps.length > 200)
     throw planError("INVALID_INPUT", `plan contains ${steps.length} steps, maximum is 200`);
   const compiledRevision = getRevision(editor);
@@ -127350,7 +127350,7 @@ function compilePlan(editor, steps, options) {
       throw planError("INVALID_INPUT", `unknown step op "${step3.op}"`, step3.id);
     if (isCreateOp(step3.op))
       validateCreateStepPosition(step3);
-    const targets = resolveStepTargets(editor, index2, step3, options);
+    const targets = resolveStepTargets(editor, index2, step3);
     if (isCreateOp(step3.op) && targets.length > 0) {
       const position4 = step3.args.position ?? "after";
       const anchorBlockId = resolveCreateAnchorFromTargets(targets, position4, step3.id);
@@ -128297,7 +128297,7 @@ function executeCompiledPlan(editor, compiled, options = {}) {
 function executePlan(editor, input2) {
   if (!input2.steps?.length)
     throw planError("INVALID_INPUT", "plan must contain at least one step");
-  return executeCompiledPlan(editor, compilePlan(editor, input2.steps, { enforceRefRevision: input2.expectedRevision !== undefined }), {
+  return executeCompiledPlan(editor, compilePlan(editor, input2.steps), {
     changeMode: input2.changeMode ?? "direct",
     expectedRevision: input2.expectedRevision
   });
@@ -131692,7 +131692,7 @@ function previewPlan(editor, input2) {
   let currentPhase = "compile";
   let evaluatedRevision = getRevision(editor);
   try {
-    const compiled = compilePlan(editor, input2.steps, { enforceRefRevision: input2.expectedRevision !== undefined });
+    const compiled = compilePlan(editor, input2.steps);
     evaluatedRevision = compiled.compiledRevision;
     currentPhase = "execute";
     const tr = editor.state.tr;
@@ -191873,7 +191873,7 @@ var Node$13 = class Node$14 {
     trackedChanges: context.trackedChanges ?? []
   });
 }, _hoisted_1$6, _hoisted_2$2, _hoisted_3, _hoisted_4, ContextMenu_default, _hoisted_1$5, BasicUpload_default, _hoisted_1$4, MIN_WIDTH = 200, PPI = 96, alignment = "flex-end", Ruler_default, GenericPopover_default, _hoisted_1$3, _hoisted_2$1, RESIZE_HANDLE_WIDTH_PX = 9, RESIZE_HANDLE_HEIGHT_PX = 9, RESIZE_HANDLE_OFFSET_PX = 4, DRAG_OVERLAY_EXTENSION_PX = 1000, MIN_DRAG_OVERLAY_WIDTH_PX = 2000, THROTTLE_INTERVAL_MS = 16, MIN_RESIZE_DELTA_PX = 1, TableResizeOverlay_default, _hoisted_1$2, OVERLAY_EXPANSION_PX = 2000, RESIZE_HANDLE_SIZE_PX = 12, MOUSE_MOVE_THROTTLE_MS = 16, DIMENSION_CHANGE_THRESHOLD_PX = 1, Z_INDEX_OVERLAY = 10, Z_INDEX_HANDLE = 15, Z_INDEX_GUIDELINE = 20, ImageResizeOverlay_default, LINK_CLICK_DEBOUNCE_MS = 300, CURSOR_UPDATE_TIMEOUT_MS = 10, POPOVER_VERTICAL_OFFSET_PX = 15, LinkClickHandler_default, _hoisted_1$1, _hoisted_2, DOCX2 = "application/vnd.openxmlformats-officedocument.wordprocessingml.document", TABLE_RESIZE_HOVER_THRESHOLD = 8, TABLE_RESIZE_THROTTLE_MS = 16, SuperEditor_default, _hoisted_1, SuperInput_default, SlashMenu, Extensions;
-var init_src_DWn_KD3r_es = __esm(() => {
+var init_src_B8Sjis_q_es = __esm(() => {
   init_rolldown_runtime_B2q5OVn9_es();
   init_SuperConverter_txXmDgaI_es();
   init_jszip_ChlR43oI_es();
@@ -223403,8 +223403,8 @@ function print() { __p += __j.call(arguments, '') }
     return isObjectLike_default(value) && hasOwnProperty$8.call(value, "callee") && !propertyIsEnumerable$1.call(value, "callee");
   };
   stubFalse_default = stubFalse;
-  freeExports$2 = typeof exports_src_DWn_KD3r_es == "object" && exports_src_DWn_KD3r_es && !exports_src_DWn_KD3r_es.nodeType && exports_src_DWn_KD3r_es;
-  freeModule$2 = freeExports$2 && typeof module_src_DWn_KD3r_es == "object" && module_src_DWn_KD3r_es && !module_src_DWn_KD3r_es.nodeType && module_src_DWn_KD3r_es;
+  freeExports$2 = typeof exports_src_B8Sjis_q_es == "object" && exports_src_B8Sjis_q_es && !exports_src_B8Sjis_q_es.nodeType && exports_src_B8Sjis_q_es;
+  freeModule$2 = freeExports$2 && typeof module_src_B8Sjis_q_es == "object" && module_src_B8Sjis_q_es && !module_src_B8Sjis_q_es.nodeType && module_src_B8Sjis_q_es;
   Buffer$1 = freeModule$2 && freeModule$2.exports === freeExports$2 ? _root_default.Buffer : undefined;
   isBuffer_default = (Buffer$1 ? Buffer$1.isBuffer : undefined) || stubFalse_default;
   typedArrayTags = {};
@@ -223412,8 +223412,8 @@ function print() { __p += __j.call(arguments, '') }
   typedArrayTags[argsTag$1] = typedArrayTags[arrayTag$1] = typedArrayTags[arrayBufferTag$1] = typedArrayTags[boolTag$1] = typedArrayTags[dataViewTag$2] = typedArrayTags[dateTag$1] = typedArrayTags[errorTag$1] = typedArrayTags[funcTag] = typedArrayTags[mapTag$2] = typedArrayTags[numberTag$1] = typedArrayTags[objectTag$3] = typedArrayTags[regexpTag$1] = typedArrayTags[setTag$2] = typedArrayTags[stringTag$1] = typedArrayTags[weakMapTag$1] = false;
   _baseIsTypedArray_default = baseIsTypedArray;
   _baseUnary_default = baseUnary;
-  freeExports$1 = typeof exports_src_DWn_KD3r_es == "object" && exports_src_DWn_KD3r_es && !exports_src_DWn_KD3r_es.nodeType && exports_src_DWn_KD3r_es;
-  freeModule$1 = freeExports$1 && typeof module_src_DWn_KD3r_es == "object" && module_src_DWn_KD3r_es && !module_src_DWn_KD3r_es.nodeType && module_src_DWn_KD3r_es;
+  freeExports$1 = typeof exports_src_B8Sjis_q_es == "object" && exports_src_B8Sjis_q_es && !exports_src_B8Sjis_q_es.nodeType && exports_src_B8Sjis_q_es;
+  freeModule$1 = freeExports$1 && typeof module_src_B8Sjis_q_es == "object" && module_src_B8Sjis_q_es && !module_src_B8Sjis_q_es.nodeType && module_src_B8Sjis_q_es;
   freeProcess = freeModule$1 && freeModule$1.exports === freeExports$1 && _freeGlobal_default.process;
   _nodeUtil_default = function() {
     try {
@@ -223518,8 +223518,8 @@ function print() { __p += __j.call(arguments, '') }
   Stack.prototype.has = _stackHas_default;
   Stack.prototype.set = _stackSet_default;
   _Stack_default = Stack;
-  freeExports = typeof exports_src_DWn_KD3r_es == "object" && exports_src_DWn_KD3r_es && !exports_src_DWn_KD3r_es.nodeType && exports_src_DWn_KD3r_es;
-  freeModule = freeExports && typeof module_src_DWn_KD3r_es == "object" && module_src_DWn_KD3r_es && !module_src_DWn_KD3r_es.nodeType && module_src_DWn_KD3r_es;
+  freeExports = typeof exports_src_B8Sjis_q_es == "object" && exports_src_B8Sjis_q_es && !exports_src_B8Sjis_q_es.nodeType && exports_src_B8Sjis_q_es;
+  freeModule = freeExports && typeof module_src_B8Sjis_q_es == "object" && module_src_B8Sjis_q_es && !module_src_B8Sjis_q_es.nodeType && module_src_B8Sjis_q_es;
   Buffer4 = freeModule && freeModule.exports === freeExports ? _root_default.Buffer : undefined;
   allocUnsafe = Buffer4 ? Buffer4.allocUnsafe : undefined;
   _cloneBuffer_default = cloneBuffer;
@@ -231599,7 +231599,7 @@ var init_zipper_DqXT7uTa_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_DWn_KD3r_es();
+  init_src_B8Sjis_q_es();
   init_SuperConverter_txXmDgaI_es();
   init_jszip_ChlR43oI_es();
   init_xml_js_DLE8mr0n_es();
@@ -294677,10 +294677,9 @@ function decodeTextRefPayload2(encoded, stepId) {
     throw planError2("INVALID_INPUT", "invalid text ref encoding", stepId);
   }
 }
-function resolveV3TextRef2(editor, index3, step3, refData, options) {
+function resolveV3TextRef2(editor, index3, step3, refData) {
   const currentRevision = getRevision2(editor);
-  const enforceRefRevision = options?.enforceRefRevision ?? true;
-  if (enforceRefRevision && refData.rev !== currentRevision) {
+  if (refData.rev !== currentRevision) {
     throw planError2("REVISION_MISMATCH", `Text ref is ephemeral and revision-scoped. Re-run query.match to obtain a fresh handle.ref for revision ${currentRevision}.`, step3.id, {
       refRevision: refData.rev,
       currentRevision,
@@ -294714,13 +294713,13 @@ function resolveV3TextRef2(editor, index3, step3, refData, options) {
   }
   return [buildSpanTarget2(editor, index3, step3, segments, refData.matchId)];
 }
-function resolveTextRef2(editor, index3, step3, ref4, options) {
+function resolveTextRef2(editor, index3, step3, ref4) {
   const encoded = ref4.slice(5);
   const payload = decodeTextRefPayload2(encoded, step3.id);
   if (!isV3Ref2(payload)) {
     throw planError2("INVALID_INPUT", "only V3 text refs are supported", step3.id);
   }
-  return resolveV3TextRef2(editor, index3, step3, payload, options);
+  return resolveV3TextRef2(editor, index3, step3, payload);
 }
 function resolveBlockRef2(editor, index3, step3, ref4) {
   const candidate = index3.candidates.find((c2) => c2.nodeId === ref4);
@@ -294737,24 +294736,24 @@ function resolveBlockRef2(editor, index3, step3, ref4) {
   };
   return [buildRangeTarget2(editor, step3, addr, candidate)];
 }
-function dispatchRefHandler2(editor, index3, step3, ref4, options) {
+function dispatchRefHandler2(editor, index3, step3, ref4) {
   for (const entry of REF_HANDLERS2) {
     if (entry.prefix === "" || ref4.startsWith(entry.prefix)) {
-      return entry.handler(editor, index3, step3, ref4, options);
+      return entry.handler(editor, index3, step3, ref4);
     }
   }
   return resolveBlockRef2(editor, index3, step3, ref4);
 }
-function resolveRefTargets2(editor, index3, step3, where, options) {
-  return dispatchRefHandler2(editor, index3, step3, where.ref, options);
+function resolveRefTargets2(editor, index3, step3, where) {
+  return dispatchRefHandler2(editor, index3, step3, where.ref);
 }
-function resolveStepTargets2(editor, index3, step3, options) {
+function resolveStepTargets2(editor, index3, step3) {
   const where = step3.where;
   const refWhere = isRefWhere2(where) ? where : undefined;
   const selectWhere = isSelectWhere2(where) ? where : undefined;
   let targets;
   if (refWhere) {
-    targets = resolveRefTargets2(editor, index3, step3, refWhere, options);
+    targets = resolveRefTargets2(editor, index3, step3, refWhere);
   } else if (selectWhere) {
     const resolved = resolveTextSelector2(editor, index3, selectWhere.select, selectWhere.within, step3.id);
     targets = resolved.addresses.map((addr) => {
@@ -294948,7 +294947,7 @@ function assertNoDuplicateBlockIds2(index3) {
     });
   }
 }
-function compilePlan2(editor, steps, options) {
+function compilePlan2(editor, steps) {
   if (steps.length > MAX_PLAN_STEPS) {
     throw planError2("INVALID_INPUT", `plan contains ${steps.length} steps, maximum is ${MAX_PLAN_STEPS}`);
   }
@@ -294984,7 +294983,7 @@ function compilePlan2(editor, steps, options) {
     if (isCreateOp2(step3.op)) {
       validateCreateStepPosition2(step3);
     }
-    const targets = resolveStepTargets2(editor, index3, step3, options);
+    const targets = resolveStepTargets2(editor, index3, step3);
     if (isCreateOp2(step3.op) && targets.length > 0) {
       const position5 = step3.args.position ?? "after";
       const anchorBlockId = resolveCreateAnchorFromTargets2(targets, position5, step3.id);
@@ -296014,9 +296013,7 @@ function executePlan2(editor, input2) {
   if (!input2.steps?.length) {
     throw planError2("INVALID_INPUT", "plan must contain at least one step");
   }
-  const compiled = compilePlan2(editor, input2.steps, {
-    enforceRefRevision: input2.expectedRevision !== undefined
-  });
+  const compiled = compilePlan2(editor, input2.steps);
   return executeCompiledPlan2(editor, compiled, {
     changeMode: input2.changeMode ?? "direct",
     expectedRevision: input2.expectedRevision
@@ -299535,9 +299532,7 @@ function previewPlan2(editor, input2) {
   let currentPhase = "compile";
   let evaluatedRevision = getRevision2(editor);
   try {
-    const compiled = compilePlan2(editor, input2.steps, {
-      enforceRefRevision: input2.expectedRevision !== undefined
-    });
+    const compiled = compilePlan2(editor, input2.steps);
     evaluatedRevision = compiled.compiledRevision;
     currentPhase = "execute";
     const tr = editor.state.tr;
@@ -361076,28 +361071,24 @@ async function openCollaborativeDocument(doc4, io, profile, options2 = {}) {
   }
 }
 async function openSessionDocument(doc4, io, metadata, options2 = {}) {
-  if (metadata.sessionType !== "collab") {
-    return openDocument(doc4, io, { user: metadata.user });
-  }
-  if (!metadata.collaboration) {
-    throw new CliError("COMMAND_FAILED", "Session is marked as collaborative but has no collaboration profile.");
+  const { executionMode, sessionPool, sessionId } = options2;
+  if (executionMode === "host" && sessionPool) {
+    const resolvedSessionId = sessionId ?? metadata.contextId;
+    return sessionPool.acquire(resolvedSessionId, {
+      sessionType: metadata.sessionType,
+      workingDocPath: metadata.workingDocPath ?? doc4,
+      metadataRevision: metadata.revision,
+      user: metadata.user,
+      collaboration: metadata.collaboration
+    }, io);
   }
-  if (options2.executionMode === "host" && options2.collabSessionPool) {
-    const sessionId = options2.sessionId ?? metadata.contextId;
-    if (!sessionId) {
-      throw new CliError("COMMAND_FAILED", "Session id is required for host-mode collaboration operations.");
+  if (metadata.sessionType === "collab") {
+    if (!metadata.collaboration) {
+      throw new CliError("COMMAND_FAILED", "Session is marked as collaborative but has no collaboration profile.");
     }
-    const metadataForPool = {
-      contextId: sessionId,
-      sessionType: metadata.sessionType,
-      collaboration: metadata.collaboration,
-      sourcePath: metadata.sourcePath,
-      workingDocPath: metadata.workingDocPath,
-      user: metadata.user
-    };
-    return options2.collabSessionPool.acquire(sessionId, doc4, metadataForPool, io);
+    return openCollaborativeDocument(doc4, io, metadata.collaboration, { user: metadata.user });
   }
-  return openCollaborativeDocument(doc4, io, metadata.collaboration, { user: metadata.user });
+  return openDocument(doc4, io, { user: metadata.user });
 }
 async function getFileChecksum(path3) {
   let bytes;
@@ -362546,16 +362537,17 @@ async function executeReadOperation(request) {
     }
   }
   return withActiveContext(context.io, commandName, async ({ metadata, paths }) => {
-    if (metadata.sessionType === "collab") {
-      const opened2 = await openSessionDocument(paths.workingDocPath, context.io, metadata, {
-        sessionId: context.sessionId ?? metadata.contextId,
-        executionMode: context.executionMode,
-        collabSessionPool: context.collabSessionPool
-      });
-      try {
-        const result2 = invokeOperation(opened2.editor, operationId, input2);
-        const synced = await syncCollaborativeSessionSnapshot(context.io, metadata, paths, opened2.editor);
-        const document4 = {
+    const opened = await openSessionDocument(paths.workingDocPath, context.io, metadata, {
+      sessionId: context.sessionId ?? metadata.contextId,
+      executionMode: context.executionMode,
+      sessionPool: context.sessionPool
+    });
+    try {
+      const result2 = invokeOperation(opened.editor, operationId, input2);
+      const isHostMode = context.executionMode === "host" && context.sessionPool != null;
+      if (!isHostMode && metadata.sessionType === "collab") {
+        const synced = await syncCollaborativeSessionSnapshot(context.io, metadata, paths, opened.editor);
+        const document5 = {
           path: synced.updatedMetadata.sourcePath,
           source: synced.updatedMetadata.source,
           byteLength: synced.output.byteLength,
@@ -362563,16 +362555,10 @@ async function executeReadOperation(request) {
         };
         return {
           command: commandName,
-          data: buildEnvelopeData(operationId, document4, result2, input2),
-          pretty: buildPrettyOutput(operationId, document4, result2)
+          data: buildEnvelopeData(operationId, document5, result2, input2),
+          pretty: buildPrettyOutput(operationId, document5, result2)
         };
-      } finally {
-        opened2.dispose();
       }
-    }
-    const opened = await openDocument(paths.workingDocPath, context.io, { user: metadata.user });
-    try {
-      const result2 = invokeOperation(opened.editor, operationId, input2);
       const document4 = {
         path: metadata.sourcePath,
         source: metadata.source,
@@ -362719,89 +362705,71 @@ async function executeMutationOperation(request) {
   }
   return withActiveContext(context.io, commandName, async ({ metadata, paths }) => {
     assertExpectedRevision(metadata, expectedRevision);
-    if (metadata.sessionType === "collab") {
-      const opened2 = await openSessionDocument(paths.workingDocPath, context.io, metadata, {
-        sessionId: context.sessionId ?? metadata.contextId,
-        executionMode: context.executionMode,
-        collabSessionPool: context.collabSessionPool
-      });
-      try {
-        const result2 = invokeOperation2(opened2.editor, operationId, input2, invokeOptions);
-        const synced = await syncCollaborativeSessionSnapshot(context.io, metadata, paths, opened2.editor);
-        const document4 = {
-          path: synced.updatedMetadata.sourcePath,
-          source: synced.updatedMetadata.source,
-          byteLength: synced.output.byteLength,
-          revision: synced.updatedMetadata.revision
-        };
-        if (dryRun) {
-          return {
-            command: commandName,
-            data: {
-              ...buildEnvelopeData2(operationId, document4, result2, { changeMode, dryRun: true }),
-              context: { dirty: synced.updatedMetadata.dirty, revision: synced.updatedMetadata.revision },
-              output: outPath ? { path: outPath, skippedWrite: true } : undefined
-            },
-            pretty: `Revision ${synced.updatedMetadata.revision}: dry run`
-          };
-        }
-        const externalOutput = await exportOptionalSessionOutput(opened2.editor, outPath, force);
-        return {
-          command: commandName,
-          data: buildEnvelopeData2(operationId, document4, result2, {
-            changeMode,
-            dryRun: false,
-            context: { dirty: synced.updatedMetadata.dirty, revision: synced.updatedMetadata.revision },
-            output: externalOutput
-          }),
-          pretty: buildPrettyOutput2(operationId, document4, result2, externalOutput?.path)
-        };
-      } finally {
-        opened2.dispose();
-      }
-    }
-    const opened = await openDocument(paths.workingDocPath, context.io, { user: metadata.user });
+    const isHostMode = context.executionMode === "host" && context.sessionPool != null;
+    const opened = await openSessionDocument(paths.workingDocPath, context.io, metadata, {
+      sessionId: context.sessionId ?? metadata.contextId,
+      executionMode: context.executionMode,
+      sessionPool: context.sessionPool
+    });
     try {
       const result2 = invokeOperation2(opened.editor, operationId, input2, invokeOptions);
-      const document4 = {
-        path: metadata.sourcePath,
-        source: metadata.source,
-        byteLength: opened.meta.byteLength,
-        revision: metadata.revision
-      };
       if (dryRun) {
+        const document5 = {
+          path: metadata.sourcePath,
+          source: metadata.source,
+          byteLength: opened.meta.byteLength,
+          revision: metadata.revision
+        };
         return {
           command: commandName,
           data: {
-            ...buildEnvelopeData2(operationId, document4, result2, { changeMode, dryRun: true }),
+            ...buildEnvelopeData2(operationId, document5, result2, { changeMode, dryRun: true }),
             context: { dirty: metadata.dirty, revision: metadata.revision },
             output: outPath ? { path: outPath, skippedWrite: true } : undefined
           },
           pretty: `Revision ${metadata.revision}: dry run`
         };
       }
-      const workingOutput = await exportToPath(opened.editor, paths.workingDocPath, true);
+      let updatedMetadata;
+      let byteLength3;
+      if (isHostMode) {
+        context.sessionPool.markDirty(metadata.contextId);
+        updatedMetadata = markContextUpdated(context.io, metadata, {
+          dirty: true,
+          revision: metadata.revision + 1
+        });
+        await writeContextMetadata(paths, updatedMetadata);
+        context.sessionPool.updateMetadataRevision(metadata.contextId, updatedMetadata.revision);
+        byteLength3 = opened.meta.byteLength;
+      } else if (metadata.sessionType === "collab") {
+        const synced = await syncCollaborativeSessionSnapshot(context.io, metadata, paths, opened.editor);
+        updatedMetadata = synced.updatedMetadata;
+        byteLength3 = synced.output.byteLength;
+      } else {
+        const workingOutput = await exportToPath(opened.editor, paths.workingDocPath, true);
+        updatedMetadata = markContextUpdated(context.io, metadata, {
+          dirty: true,
+          revision: metadata.revision + 1
+        });
+        await writeContextMetadata(paths, updatedMetadata);
+        byteLength3 = workingOutput.byteLength;
+      }
       const externalOutput = await exportOptionalSessionOutput(opened.editor, outPath, force);
-      const updatedMetadata = markContextUpdated(context.io, metadata, {
-        dirty: true,
-        revision: metadata.revision + 1
-      });
-      await writeContextMetadata(paths, updatedMetadata);
-      const updatedDocument = {
+      const document4 = {
         path: updatedMetadata.sourcePath,
         source: updatedMetadata.source,
-        byteLength: workingOutput.byteLength,
+        byteLength: byteLength3,
         revision: updatedMetadata.revision
       };
       return {
         command: commandName,
-        data: buildEnvelopeData2(operationId, updatedDocument, result2, {
+        data: buildEnvelopeData2(operationId, document4, result2, {
           changeMode,
           dryRun: false,
           context: { dirty: updatedMetadata.dirty, revision: updatedMetadata.revision },
           output: externalOutput
         }),
-        pretty: buildPrettyOutput2(operationId, updatedDocument, result2, externalOutput?.path)
+        pretty: buildPrettyOutput2(operationId, document4, result2, externalOutput?.path)
       };
     } finally {
       opened.dispose();
@@ -364925,8 +364893,8 @@ async function runClose(tokens, context) {
       },
       pretty: mode2.discard ? "Closed context (discarded unsaved changes)" : "Closed context"
     };
-    if (context.executionMode === "host" && context.collabSessionPool) {
-      await context.collabSessionPool.disposeSession(effectiveMetadata.contextId);
+    if (context.executionMode === "host" && context.sessionPool) {
+      await context.sessionPool.disposeSession(effectiveMetadata.contextId, { discard: mode2.discard });
     }
     await clearContext(paths);
     if (wasDefaultSession) {
@@ -365066,8 +365034,13 @@ async function runOpen(tokens, context) {
       });
       await writeContextMetadata(paths, metadata);
       await setActiveSessionId(metadata.contextId);
-      if (collaboration && context.executionMode === "host" && context.collabSessionPool) {
-        await context.collabSessionPool.adoptFromOpen(sessionId, opened, metadata, context.io);
+      if (context.executionMode === "host" && context.sessionPool) {
+        context.sessionPool.adoptFromOpen(sessionId, opened, {
+          sessionType: metadata.sessionType,
+          workingDocPath: paths.workingDocPath,
+          metadataRevision: metadata.revision,
+          collaboration: metadata.collaboration
+        });
         adoptedToHostPool = true;
       }
       return {
@@ -365136,11 +365109,13 @@ async function runSave(tokens, context) {
   const mode2 = validateSaveMode(getBooleanOption(parsed, "in-place"), getStringOption(parsed, "out"), getBooleanOption(parsed, "force"));
   return withActiveContext(context.io, "save", async ({ metadata, paths }) => {
     let effectiveMetadata = metadata;
-    if (metadata.sessionType === "collab") {
+    if (context.executionMode === "host" && context.sessionPool) {
+      await context.sessionPool.checkpoint(metadata.contextId);
+    } else if (metadata.sessionType === "collab") {
       const opened = await openSessionDocument(paths.workingDocPath, context.io, metadata, {
         sessionId: context.sessionId ?? metadata.contextId,
         executionMode: context.executionMode,
-        collabSessionPool: context.collabSessionPool
+        sessionPool: context.sessionPool
       });
       try {
         const synced = await syncCollaborativeSessionSnapshot(context.io, metadata, paths, opened.editor);
@@ -371563,8 +371538,8 @@ var init_uninstall = __esm(() => {
   ];
 });
 
-// src/host/collab-session-pool.ts
-function profileToKey(profile) {
+// src/host/session-pool.ts
+function profileToFingerprint(profile) {
   return JSON.stringify({
     providerType: profile.providerType,
     url: profile.url,
@@ -371575,90 +371550,217 @@ function profileToKey(profile) {
     bootstrapSettlingMs: profile.bootstrapSettlingMs ?? null
   });
 }
-function buildFingerprint(metadata) {
-  if (metadata.sessionType !== "collab") {
-    throw new CliError("COMMAND_FAILED", "Session is not collaborative.", {
-      contextId: metadata.contextId,
-      sessionType: metadata.sessionType
-    });
-  }
-  if (!metadata.collaboration) {
-    throw new CliError("COMMAND_FAILED", "Collaborative session metadata is missing collaboration profile.", {
-      contextId: metadata.contextId
+function createSessionLocks() {
+  const locks = new Map;
+  function withLock(sessionId, fn2) {
+    const entry = locks.get(sessionId) ?? { chain: Promise.resolve() };
+    locks.set(sessionId, entry);
+    const result2 = entry.chain.then(fn2, fn2);
+    entry.chain = result2.then(() => {
+      return;
+    }, () => {
+      return;
     });
+    return result2;
   }
-  return {
-    profileKey: profileToKey(metadata.collaboration),
-    workingDocPath: metadata.workingDocPath
-  };
-}
-function sameFingerprint(left2, right2) {
-  return left2.profileKey === right2.profileKey && left2.workingDocPath === right2.workingDocPath;
+  return { withLock };
 }
 
-class InMemoryCollaborationSessionPool {
-  handles = new Map;
+class InMemorySessionPool {
+  sessions = new Map;
+  sessionLocks = createSessionLocks();
+  openLocal;
   openCollaborative;
+  exportToPathFn;
   now;
-  constructor(options2 = {}) {
-    this.openCollaborative = options2.openCollaborative ?? openCollaborativeDocument;
-    this.now = options2.now ?? Date.now;
+  createTimer;
+  clearTimer;
+  constructor(deps = {}) {
+    this.openLocal = deps.openLocal ?? openDocument;
+    this.openCollaborative = deps.openCollaborative ?? openCollaborativeDocument;
+    this.exportToPathFn = deps.exportToPath ?? exportToPath;
+    this.now = deps.now ?? Date.now;
+    this.createTimer = deps.createTimer ?? setTimeout;
+    this.clearTimer = deps.clearTimer ?? clearTimeout;
+  }
+  async acquire(sessionId, metadata, io) {
+    return this.sessionLocks.withLock(sessionId, async () => {
+      const existing = this.sessions.get(sessionId);
+      if (existing) {
+        if (this.isSessionValid(existing, metadata)) {
+          existing.leased = true;
+          existing.lastUsedAtMs = this.now();
+          existing.io = io;
+          return this.createLease(sessionId, existing);
+        }
+        await this.destroySession(existing);
+        this.sessions.delete(sessionId);
+      }
+      const session = await this.openFreshSession(metadata, io);
+      this.sessions.set(sessionId, session);
+      return this.createLease(sessionId, session);
+    });
   }
-  async acquire(sessionId, docPath, metadata, io) {
-    const fingerprint = buildFingerprint(metadata);
-    const existing = this.handles.get(sessionId);
+  adoptFromOpen(sessionId, opened, metadata) {
+    const existing = this.sessions.get(sessionId);
     if (existing) {
-      if (sameFingerprint(existing.fingerprint, fingerprint)) {
-        existing.lastUsedAtMs = this.now();
-        return this.createLease(existing);
-      }
-      await this.disposeSession(sessionId);
+      this.clearAutosaveTimer(existing);
+      existing.opened.dispose();
     }
-    const profile = metadata.collaboration;
-    const opened = await this.openCollaborative(docPath, io, profile, { user: metadata.user });
-    const created = {
+    this.sessions.set(sessionId, {
       opened,
-      fingerprint,
-      lastUsedAtMs: this.now()
-    };
-    this.handles.set(sessionId, created);
-    return this.createLease(created);
-  }
-  async adoptFromOpen(sessionId, opened, metadata, _io) {
-    const fingerprint = buildFingerprint(metadata);
-    await this.disposeSession(sessionId);
-    this.handles.set(sessionId, {
-      opened,
-      fingerprint,
-      lastUsedAtMs: this.now()
+      sessionType: metadata.sessionType,
+      dirty: false,
+      leased: false,
+      workingDocPath: metadata.workingDocPath,
+      io: { stdout() {}, stderr() {}, readStdinBytes: async () => new Uint8Array, now: this.now },
+      metadataRevision: metadata.metadataRevision,
+      lastUsedAtMs: this.now(),
+      autosaveTimer: null,
+      collaboration: metadata.collaboration,
+      fingerprint: metadata.collaboration ? profileToFingerprint(metadata.collaboration) : undefined
     });
   }
-  async disposeSession(sessionId) {
-    const existing = this.handles.get(sessionId);
-    if (!existing)
+  async checkpoint(sessionId) {
+    return this.sessionLocks.withLock(sessionId, () => this.checkpointUnsafe(sessionId));
+  }
+  async checkpointAll() {
+    const ids = Array.from(this.sessions.keys());
+    for (const id3 of ids) {
+      await this.checkpoint(id3);
+    }
+  }
+  markDirty(sessionId) {
+    const session = this.sessions.get(sessionId);
+    if (!session)
+      return;
+    session.dirty = true;
+    this.resetAutosaveTimer(sessionId, session);
+  }
+  updateMetadataRevision(sessionId, revision) {
+    const session = this.sessions.get(sessionId);
+    if (!session)
       return;
-    this.handles.delete(sessionId);
-    existing.opened.dispose();
+    session.metadataRevision = revision;
+  }
+  isDirty(sessionId) {
+    return this.sessions.get(sessionId)?.dirty ?? false;
+  }
+  async disposeSession(sessionId, options2) {
+    return this.sessionLocks.withLock(sessionId, async () => {
+      const session = this.sessions.get(sessionId);
+      if (!session)
+        return;
+      this.clearAutosaveTimer(session);
+      if (session.dirty && !options2?.discard) {
+        await this.checkpointUnsafe(sessionId);
+      }
+      await this.destroySession(session);
+      this.sessions.delete(sessionId);
+    });
   }
   async disposeAll() {
-    const sessionIds = Array.from(this.handles.keys());
-    for (const sessionId of sessionIds) {
-      await this.disposeSession(sessionId);
+    const ids = Array.from(this.sessions.keys());
+    for (const id3 of ids) {
+      await this.disposeSession(id3);
+    }
+  }
+  async flushPendingCheckpoints() {
+    const ids = Array.from(this.sessions.keys());
+    for (const id3 of ids) {
+      const session = this.sessions.get(id3);
+      if (session?.autosaveTimer != null) {
+        this.clearAutosaveTimer(session);
+        await this.checkpoint(id3);
+      }
     }
   }
-  createLease(handle4) {
+  isSessionValid(session, metadata) {
+    if (session.sessionType === "collab") {
+      const incomingFingerprint = metadata.collaboration ? profileToFingerprint(metadata.collaboration) : undefined;
+      return session.fingerprint === incomingFingerprint && session.workingDocPath === metadata.workingDocPath;
+    }
+    return session.workingDocPath === metadata.workingDocPath && session.metadataRevision === metadata.metadataRevision;
+  }
+  async openFreshSession(metadata, io) {
+    const opened = metadata.sessionType === "collab" && metadata.collaboration ? await this.openCollaborative(metadata.workingDocPath, io, metadata.collaboration, {
+      user: metadata.user
+    }) : await this.openLocal(metadata.workingDocPath, io, { user: metadata.user });
+    return {
+      opened,
+      sessionType: metadata.sessionType,
+      dirty: false,
+      leased: true,
+      workingDocPath: metadata.workingDocPath,
+      io,
+      metadataRevision: metadata.metadataRevision,
+      lastUsedAtMs: this.now(),
+      autosaveTimer: null,
+      collaboration: metadata.collaboration,
+      fingerprint: metadata.collaboration ? profileToFingerprint(metadata.collaboration) : undefined
+    };
+  }
+  createLease(sessionId, session) {
     return {
-      editor: handle4.opened.editor,
-      meta: handle4.opened.meta,
+      editor: session.opened.editor,
+      meta: session.opened.meta,
       dispose: () => {
-        handle4.lastUsedAtMs = this.now();
+        session.leased = false;
+        session.lastUsedAtMs = this.now();
       }
     };
   }
+  async checkpointUnsafe(sessionId) {
+    const session = this.sessions.get(sessionId);
+    if (!session?.dirty)
+      return;
+    if (session.sessionType === "collab") {
+      await this.checkpointCollabSession(session);
+    } else {
+      await this.checkpointLocalSession(session);
+    }
+    session.dirty = false;
+    this.clearAutosaveTimer(session);
+  }
+  async checkpointLocalSession(session) {
+    await this.exportToPathFn(session.opened.editor, session.workingDocPath, true);
+  }
+  async checkpointCollabSession(session) {
+    await this.exportToPathFn(session.opened.editor, session.workingDocPath, true);
+  }
+  async destroySession(session) {
+    this.clearAutosaveTimer(session);
+    session.opened.dispose();
+  }
+  resetAutosaveTimer(sessionId, session) {
+    this.clearAutosaveTimer(session);
+    session.autosaveTimer = this.createTimer(() => {
+      this.onAutosaveTimerFired(sessionId).catch(() => {});
+    }, AUTOSAVE_DEBOUNCE_MS);
+  }
+  clearAutosaveTimer(session) {
+    if (session.autosaveTimer != null) {
+      this.clearTimer(session.autosaveTimer);
+      session.autosaveTimer = null;
+    }
+  }
+  async onAutosaveTimerFired(sessionId) {
+    await this.sessionLocks.withLock(sessionId, async () => {
+      const session = this.sessions.get(sessionId);
+      if (!session)
+        return;
+      session.autosaveTimer = null;
+      if (session.leased) {
+        this.resetAutosaveTimer(sessionId, session);
+        return;
+      }
+      await this.checkpointUnsafe(sessionId);
+    });
+  }
 }
-var init_collab_session_pool = __esm(() => {
+var AUTOSAVE_DEBOUNCE_MS = 3000;
+var init_session_pool = __esm(() => {
   init_document2();
-  init_errors();
 });
 
 // src/host/invoke.ts
@@ -371725,7 +371827,7 @@ async function invokeCliFromHost(rawParams, options2 = {}) {
   const invocation = await invokeCommand(params4.argv, {
     ioOverrides: io,
     executionMode: "host",
-    collabSessionPool: options2.collabSessionPool
+    sessionPool: options2.sessionPool
   });
   if (invocation.helpText) {
     return {
@@ -371822,7 +371924,7 @@ class HostServer {
   io;
   requestTimeoutMs;
   maxStdinBytes;
-  collabSessionPool;
+  sessionPool;
   ownsPool;
   queue = Promise.resolve();
   shutdownRequested = false;
@@ -371830,11 +371932,11 @@ class HostServer {
     this.io = options2.io;
     this.requestTimeoutMs = options2.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.maxStdinBytes = options2.maxStdinBytes ?? DEFAULT_MAX_STDIN_BYTES;
-    if (options2.collabSessionPool) {
-      this.collabSessionPool = options2.collabSessionPool;
+    if (options2.sessionPool) {
+      this.sessionPool = options2.sessionPool;
       this.ownsPool = false;
     } else {
-      this.collabSessionPool = new InMemoryCollaborationSessionPool;
+      this.sessionPool = new InMemorySessionPool;
       this.ownsPool = true;
     }
   }
@@ -371866,7 +371968,7 @@ class HostServer {
   }
   async dispose() {
     if (this.ownsPool) {
-      await this.collabSessionPool.disposeAll();
+      await this.sessionPool.disposeAll();
     }
   }
   writeFrame(frame) {
@@ -371941,7 +372043,7 @@ class HostServer {
     }
     const outcome = await settleWithTimeout(invokeCliFromHost(request.params, {
       ioNow: this.io.now,
-      collabSessionPool: this.collabSessionPool,
+      sessionPool: this.sessionPool,
       maxStdinBytes: this.maxStdinBytes
     }), this.requestTimeoutMs);
     if (outcome.kind === "timeout") {
@@ -372006,7 +372108,7 @@ var init_server = __esm(async () => {
   init_errors();
   init_guards();
   init_contract2();
-  init_collab_session_pool();
+  init_session_pool();
   init_protocol();
   await init_invoke2();
 });
@@ -372118,7 +372220,7 @@ function parseInvocation(argv) {
   const { globals, rest } = parseGlobalArgs(argv);
   return { globals, rest };
 }
-async function executeParsedInvocation(parsed, io, executionMode, collabSessionPool) {
+async function executeParsedInvocation(parsed, io, executionMode, sessionPool) {
   if (parsed.globals.help || parsed.rest.length === 0) {
     return { helpText: HELP };
   }
@@ -372128,7 +372230,7 @@ async function executeParsedInvocation(parsed, io, executionMode, collabSessionP
     timeoutMs: parsed.globals.timeoutMs,
     sessionId: parsed.globals.sessionId,
     executionMode,
-    collabSessionPool
+    sessionPool
   };
   const execution = await executeWithTimeout(async () => {
     if (MANUAL_COMMAND_KEY_SET.has(key2)) {
@@ -372159,7 +372261,7 @@ async function invokeCommand(argv, options2 = {}) {
   const startedAt = io.now();
   const { parsed, output } = await withStateDirOverride(options2.stateDir, async () => {
     const parsedInvocation = parseInvocation(argv);
-    const commandOutput = await executeParsedInvocation(parsedInvocation, io, options2.executionMode ?? "oneshot", options2.collabSessionPool);
+    const commandOutput = await executeParsedInvocation(parsedInvocation, io, options2.executionMode ?? "oneshot", options2.sessionPool);
     return { parsed: parsedInvocation, output: commandOutput };
   });
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.2.0-next.78",
+  "version": "0.2.0-next.79",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -22,19 +22,19 @@
     "typescript": "^5.9.2",
     "@superdoc/document-api": "0.0.1",
     "@superdoc/pm-adapter": "0.0.0",
-    "superdoc": "1.17.0",
-    "@superdoc/super-editor": "0.0.1"
+    "@superdoc/super-editor": "0.0.1",
+    "superdoc": "1.17.0"
   },
   "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.2.0-next.78",
-    "@superdoc-dev/cli-linux-x64": "0.2.0-next.78",
-    "@superdoc-dev/cli-darwin-x64": "0.2.0-next.78",
-    "@superdoc-dev/cli-linux-arm64": "0.2.0-next.78",
-    "@superdoc-dev/cli-windows-x64": "0.2.0-next.78"
+    "@superdoc-dev/cli-darwin-arm64": "0.2.0-next.79",
+    "@superdoc-dev/cli-darwin-x64": "0.2.0-next.79",
+    "@superdoc-dev/cli-linux-x64": "0.2.0-next.79",
+    "@superdoc-dev/cli-windows-x64": "0.2.0-next.79",
+    "@superdoc-dev/cli-linux-arm64": "0.2.0-next.79"
   },
   "scripts": {
     "dev": "bun run src/index.ts",