@superdoc/mcp 1.7.0-next.10 → 1.7.0-next.11

package/dist/index.js

@@ -31600,7 +31600,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.20.0-next.10";
+var SDK_VERSION = "2.20.0-next.11";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -104422,7 +104422,20 @@ function validateChangeMode(value) {
     value
   });
 }
+function normalizeTextMutationOptions(options) {
+  const { author, ...mutationOptions } = options ?? {};
+  const normalized = normalizeMutationOptions(mutationOptions);
+  if (!options || !("author" in options))
+    return normalized;
+  if (options.changeMode !== "tracked" || !isRecord6(author) || Object.keys(author).some((key) => key !== "name") || typeof author.name !== "string" || author.name.trim().length === 0) {
+    throw new DocumentApiValidationError("INVALID_INPUT", 'author requires changeMode: "tracked" and an object containing only a non-empty name.');
+  }
+  return { ...normalized, changeMode: "tracked", author: { name: author.name } };
+}
 function normalizeMutationOptions(options, supportCheckOperation) {
+  if (options && typeof options === "object" && "author" in options) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "author is supported only for tracked plain-text doc.insert, doc.delete, and doc.replace calls.");
+  }
   validateChangeMode(options?.changeMode);
   const supportCheck = options?.supportCheck;
   if (supportCheck !== undefined) {
@@ -104461,7 +104474,7 @@ function validateSupportCheckGuard(value, operation) {
   }
 }
 function executeWrite(adapter, request, options) {
-  return adapter.write(request, normalizeMutationOptions(options));
+  return adapter.write(request, normalizeTextMutationOptions(options));
 }
 var CHANGE_MODE_VALUES;
 var init_write = __esm(() => {
@@ -106674,6 +106687,7 @@ function textReceiptToSDReceipt(receipt2, context = {}) {
     ...receipt2.failure.details != null ? { details: receipt2.failure.details } : {}
   };
   const CODE_MAP = {
+    INVALID_INPUT: "INVALID_INPUT",
     INVALID_TARGET: "INVALID_TARGET",
     TARGET_NOT_FOUND: "TARGET_NOT_FOUND",
     MATCH_NOT_FOUND: "TARGET_NOT_FOUND",
@@ -106792,6 +106806,9 @@ function validateStructuralInsertInput(input) {
 function executeInsert(selectionAdapter, writeAdapter, input, options) {
   assertOperationCanStart(options);
   validateInsertInput(input);
+  if (options && "author" in options && (isStructuralInsertInput(input) || input.type === "html" || input.type === "markdown")) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "author is supported only for tracked plain-text inserts.");
+  }
   if (isStructuralInsertInput(input)) {
     return writeAdapter.insertStructured(input, normalizeMutationOptions(options));
   }
@@ -106803,7 +106820,7 @@ function executeInsert(selectionAdapter, writeAdapter, input, options) {
   const { target, ref, in: storyIn } = input;
   if (target || ref) {
     const request2 = target ? { kind: "insert", target, text: value, ...storyIn ? { in: storyIn } : {} } : { kind: "insert", ref, text: value, ...storyIn ? { in: storyIn } : {} };
-    const textReceipt2 = selectionAdapter.execute(request2, normalizeMutationOptions(options));
+    const textReceipt2 = selectionAdapter.execute(request2, normalizeTextMutationOptions(options));
     return textReceiptToSDReceipt(textReceipt2);
   }
   const request = { kind: "insert", text: value, ...storyIn ? { in: storyIn } : {} };
@@ -106979,6 +106996,9 @@ function validateBodyReplaceShape(input) {
 }
 function executeReplace(selectionAdapter, writeAdapter, input, options) {
   validateReplaceInput(input);
+  if (options && "author" in options && (isStructuralReplaceInput(input) || isRichContentReplaceInput(input) || input.target && isBodyReplaceTarget(input.target))) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "author is supported only for tracked plain-text replacements.");
+  }
   if (isStructuralReplaceInput(input)) {
     return writeAdapter.replaceStructured(input, normalizeMutationOptions(options));
   }
@@ -106996,7 +107016,7 @@ function executeReplace(selectionAdapter, writeAdapter, input, options) {
     in: textInput.in,
     ...textInput.expectedText !== undefined ? { expectedText: textInput.expectedText } : {}
   } : { kind: "replace", ref: textInput.ref, text: textInput.text, in: textInput.in };
-  const textReceipt = selectionAdapter.execute(request, normalizeMutationOptions(options));
+  const textReceipt = selectionAdapter.execute(request, normalizeTextMutationOptions(options));
   return textReceiptToSDReceipt(textReceipt);
 }
 var TEXT_REPLACE_ALLOWED_KEYS, STRUCTURAL_REPLACE_ALLOWED_KEYS, RICH_REPLACE_ALLOWED_KEYS, RICH_REPLACE_TYPES;
@@ -117062,7 +117082,7 @@ function validateDeleteInput(input) {
 function executeDelete(adapter, input, options) {
   validateDeleteInput(input);
   const request = input.target ? { kind: "delete", target: input.target, behavior: input.behavior ?? "selection", in: input.in } : { kind: "delete", ref: input.ref, behavior: input.behavior ?? "selection", in: input.in };
-  return adapter.execute(request, normalizeMutationOptions(options));
+  return adapter.execute(request, normalizeTextMutationOptions(options));
 }
 var DELETE_INPUT_ALLOWED_KEYS, VALID_BEHAVIORS;
 var init_delete = __esm(() => {
@@ -301621,7 +301641,7 @@ var init_paragraph_ids = __esm(() => {
 
 // ../../../v2/document-api-v2-adapter/dist/story-surfaces/tracked-block-range.js
 function prepareTrackedBlockRangeReplacement(input) {
-  const author = input.context.readAuthor();
+  const author = input.author ?? input.context.readAuthor();
   if (!author?.name)
     return {
       ok: false,
@@ -330527,7 +330547,7 @@ function runRangeCollapse(deps, plan) {
 function runParagraphOp(deps, apply) {
   const { context } = deps;
   const beginMutationStartedAt = performanceNowMs();
-  const begun = context.beginMutation({});
+  const begun = context.beginMutation({ author: deps.author });
   if ("failure" in begun) {
     throw new RangePasteStepError({ code: begun.failure.code, message: begun.failure.message });
   }
@@ -330975,7 +330995,7 @@ var init_raw_block_ref = __esm(() => {
 
 // ../../../v2/document-api-v2-adapter/dist/story-surfaces/tracked-body-replacement.js
 function prepareTrackedBodyReplacement(input) {
-  if (!input.context.readAuthor()?.name)
+  if (!(input.author ?? input.context.readAuthor())?.name)
     return {
       ok: false,
       code: "PRECONDITION_FAILED",
@@ -330994,7 +331014,8 @@ function prepareTrackedBodyReplacement(input) {
     ...input,
     beforeXml: before.content,
     afterXml: after.content,
-    namespaceBindings: new Map(Object.entries(before.body.namespaceBindings))
+    namespaceBindings: new Map(Object.entries(before.body.namespaceBindings)),
+    author: input.author
   });
   if (!replacement.ok)
     return replacement;
@@ -332926,6 +332947,9 @@ var init_effective_inline_uniformity = __esm(() => {
 });
 
 // ../../../v2/document-api-v2-adapter/dist/selection-mutation/adapter.js
+function textMutationAuthor(options) {
+  return options?.author;
+}
 function selectionIsAllowedByDocumentProtection(context, target, index2, storyId) {
   const protection = new V2ProtectionAdapter(context).get().editingRestriction;
   if (!protection.runtimeEnforced)
@@ -332992,7 +333016,7 @@ class V2SelectionMutationAdapter {
         resolution: protectedEdit.resolution
       };
     }
-    const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision });
+    const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision, author: textMutationAuthor(options) });
     if ("failure" in begun) {
       return { success: false, failure: begun.failure, resolution: edits[0].resolution };
     }
@@ -333361,7 +333385,8 @@ class V2SelectionMutationAdapter {
           resolved: wholeStory.resolved,
           resolution: resolution2,
           effectiveStory: effectiveStory2,
-          expectedRevision: options?.expectedRevision
+          expectedRevision: options?.expectedRevision,
+          author: textMutationAuthor(options)
         });
       }
     }
@@ -333527,7 +333552,7 @@ class V2SelectionMutationAdapter {
       };
     }
     const beginMutationStartedAt = nowMs6();
-    const begun = this.context.beginMutation({});
+    const begun = this.context.beginMutation({ author: textMutationAuthor(options) });
     if ("failure" in begun) {
       return {
         success: false,
@@ -333755,6 +333780,9 @@ class V2SelectionMutationAdapter {
   }
   executeCrossParagraphReplace(input) {
     const { target, index: index2, story, storyLocator, text: text4, startedAt, storyResolveMs, offsetSpace, options, atomicFieldDelete } = input;
+    if (text4.length > 0 && textMutationAuthor(options)) {
+      return failureWithoutResolution("INVALID_INPUT", "Per-call author is not supported for structural cross-paragraph replacements.");
+    }
     if (target.coordinateSpace === "tracked") {
       return failureWithoutResolution("CAPABILITY_UNAVAILABLE", "text-range-cross-paragraph-tracked-coordinate-unsupported");
     }
@@ -333863,7 +333891,7 @@ class V2SelectionMutationAdapter {
       return { success: true, resolution };
     if (text4.length > 0) {
       const beginMutationStartedAt = nowMs6();
-      const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision });
+      const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision, author: textMutationAuthor(options) });
       if ("failure" in begun) {
         return { success: false, failure: begun.failure, resolution };
       }
@@ -333978,6 +334006,7 @@ class V2SelectionMutationAdapter {
       index: index2,
       historyLabel: "selection.delete.cross-paragraph",
       changeMode,
+      author: textMutationAuthor(options),
       preflightValidated: true,
       recordCommitDiagnostics(diagnostics) {
         commitDiagnosticsRef.current = diagnostics;
@@ -334037,6 +334066,9 @@ class V2SelectionMutationAdapter {
   }
   executeCrossCellDelete(input) {
     const { target, index: index2, story, storyLocator, offsetSpace, options } = input;
+    if (textMutationAuthor(options)) {
+      return failureWithoutResolution("INVALID_INPUT", "Per-call author is not supported for cross-cell deletion.");
+    }
     const plan = resolveCrossCellDeletePlan({
       context: this.context,
       buildOffsetMap: buildOffsetMapForCoordinateSpace3,
@@ -334100,7 +334132,7 @@ class V2SelectionMutationAdapter {
     };
   }
   executeTrackedWholeStoryDelete(input) {
-    const begun = this.context.beginMutation(input.expectedRevision ? { expectedRevision: input.expectedRevision } : undefined);
+    const begun = this.context.beginMutation({ expectedRevision: input.expectedRevision, author: input.author });
     if ("failure" in begun) {
       return {
         success: false,
@@ -334900,7 +334932,8 @@ class V2SelectionMutationAdapter {
         context: this.context,
         beforeXml: sourceXml,
         afterXml: nextXml,
-        dryRun: options?.dryRun
+        dryRun: options?.dryRun,
+        author: textMutationAuthor(options)
       });
       if (!replacement.ok) {
         return { success: false, failure: { code: replacement.code, message: replacement.message }, resolution };
@@ -337809,7 +337842,9 @@ class V2TablesAdapter {
     const model = parseTableXmlModel(resolved.tableXml);
     mutateTablePr(model, (children2) => {
       let next = children2;
-      next = setOrRemoveChild(next, "jc", input.alignment ? singleElement2(model.prefix, "jc", { val: input.alignment }) : null);
+      if (input.alignment !== undefined) {
+        next = setOrRemoveChild(next, "jc", input.alignment ? singleElement2(model.prefix, "jc", { val: input.alignment }) : null);
+      }
       if (input.autoFitMode) {
         if (input.autoFitMode === "fixedWidth") {
           next = setOrRemoveChild(next, "tblLayout", singleElement2(model.prefix, "tblLayout", { type: "fixed" }));
@@ -358918,8 +358953,9 @@ class V2TrackedChangesAdapter {
         if (entry.type !== "replacement")
           return;
         const rsid = side === "delete" || side === "deleted" ? entry.sides?.deleted?.rsid : entry.sides?.inserted?.rsid;
+        const kind = side === "delete" || side === "deleted" ? "del" : "ins";
         if (rsid)
-          addFragments(entry.fragments.filter((fragment4) => fragment4.rsid === rsid));
+          addFragments(entry.fragments.filter((fragment4) => fragment4.rsid === rsid && fragment4.kind === kind));
       } else {
         addFragments(entry.fragments);
         structural || (structural = entry.formattingFragments.length > 0 || entry.structuralFragments.length > 0);
@@ -359742,6 +359778,9 @@ class V2TrackedChangesAdapter {
       return this.decideByLogicalIds(decision, [entry.id], options);
     }
     if (target.overlap === "side-only" || target.overlap === "empties-one-side") {
+      const pairingFailure = replacementSidePairingFailure(entry);
+      if (pairingFailure)
+        return pairingFailure;
       const side = target.side === "delete" || target.side === "deleted" ? "deleted" : "inserted";
       const rsid = side === "deleted" ? entry.sides?.deleted?.rsid : entry.sides?.inserted?.rsid;
       if (!rsid) {
@@ -359750,7 +359789,11 @@ class V2TrackedChangesAdapter {
       const permissionFailure = this.checkTrackedChangePermissions(decision, [entry], logical);
       if (permissionFailure)
         return permissionFailure;
-      return this.runDecideWithTargets(decision, [{ rsid }], logical, options);
+      const fragments = textFragmentSelectorsForRsid(entry, rsid, side === "deleted" ? "del" : "ins");
+      if (fragments.length === 0) {
+        return failure7("TARGET_NOT_FOUND", `trackChanges.decide range: ${side} replacement side was not found.`);
+      }
+      return this.runDecideWithTargets(decision, [{ rsid, fragments }], logical, options);
     }
     const textTarget = this.buildTextTargetForLogicalRange(entry, raw, {
       overlap: target.overlap,
@@ -359770,6 +359813,9 @@ class V2TrackedChangesAdapter {
     if (entry.type !== "replacement") {
       return failure7("INVALID_TARGET", `trackChanges.decide: side selector requires a replacement change (id "${id}").`);
     }
+    const pairingFailure = replacementSidePairingFailure(entry);
+    if (pairingFailure)
+      return pairingFailure;
     const rsid = side === "deleted" ? entry.sides?.deleted?.rsid : entry.sides?.inserted?.rsid;
     if (!rsid) {
       return failure7("TARGET_NOT_FOUND", `trackChanges.decide: ${side} replacement side was not found.`);
@@ -359777,7 +359823,11 @@ class V2TrackedChangesAdapter {
     const permissionFailure = this.checkTrackedChangePermissions(decision, [entry], logical);
     if (permissionFailure)
       return permissionFailure;
-    return this.runDecideWithTargets(decision, [{ rsid }], logical, options);
+    const fragments = textFragmentSelectorsForRsid(entry, rsid, side === "deleted" ? "del" : "ins");
+    if (fragments.length === 0) {
+      return failure7("TARGET_NOT_FOUND", `trackChanges.decide: ${side} replacement side was not found.`);
+    }
+    return this.runDecideWithTargets(decision, [{ rsid, fragments }], logical, options);
   }
   buildTextTargetForLogicalRange(entry, raw, input) {
     const fragment4 = selectFragmentForLogicalRange(entry, input.side);
@@ -359988,8 +360038,13 @@ class V2TrackedChangesAdapter {
     return buildCachedTrackedChangeLogicalView(this.context);
   }
 }
-function textFragmentSelectorsForRsid(entry, rsid) {
-  return entry.fragments.filter((fragment4) => fragment4.rsid === rsid).map((fragment4) => ({
+function replacementSidePairingFailure(entry) {
+  if (!entry.textboxAlternateContentPairing)
+    return null;
+  return failure7("CAPABILITY_UNAVAILABLE", "trackChanges.decide: a mirrored text-box replacement cannot be decided by side without risking divergent representations.");
+}
+function textFragmentSelectorsForRsid(entry, rsid, kind) {
+  return entry.fragments.filter((fragment4) => fragment4.rsid === rsid && (!kind || fragment4.kind === kind)).map((fragment4) => ({
     partUri: fragment4.partUri,
     byteStart: fragment4.byteStart,
     byteEnd: fragment4.byteEnd
@@ -369913,7 +369968,8 @@ function createV2AdapterContext(session, options = {}) {
       return {
         tx: beginSDDocumentSessionInternalTransaction(session, {
           expectedPackageRevision: currentInternal,
-          actorTag: humanActorScope.current()
+          actorTag: humanActorScope.current(),
+          ...options2?.author ? { authorOverride: { name: options2.author.name } } : {}
         })
       };
     },
@@ -397683,6 +397739,14 @@ function buildAssertOutcome(compiled) {
   };
 }
 function validatePlanShape(input) {
+  if (Object.prototype.hasOwnProperty.call(input, "author")) {
+    throw new DocumentApiValidationError2("INVALID_INPUT", "Mutation plans do not support per-call author.");
+  }
+  for (const step3 of Array.isArray(input.steps) ? input.steps : []) {
+    if (hasPlanAuthor(step3)) {
+      throw new DocumentApiValidationError2("INVALID_INPUT", "Mutation plan steps do not support per-call author.");
+    }
+  }
   if ("dryRun" in input) {
     throw new DocumentApiValidationError2("INVALID_INPUT", "Mutation plans do not accept dryRun; use mutations.preview.");
   }
@@ -397696,6 +397760,23 @@ function validatePlanShape(input) {
     throw new DocumentApiValidationError2("INVALID_INPUT", 'changeMode must be "direct" or "tracked".');
   }
 }
+function hasPlanAuthor(value2) {
+  const pending = [value2];
+  const visited = new Set;
+  while (pending.length > 0) {
+    const current = pending.pop();
+    if (!current || typeof current !== "object" || visited.has(current))
+      continue;
+    visited.add(current);
+    if (Object.prototype.hasOwnProperty.call(current, "author"))
+      return true;
+    if (Array.isArray(current))
+      pending.push(...current);
+    else
+      pending.push(...Object.values(current));
+  }
+  return false;
+}
 function isSupportedMutationStoryScope(story) {
   return !story || story.kind === "story" && story.storyType === "body";
 }
@@ -398158,6 +398239,9 @@ class V2WriteAdapter {
     }
     const controlPayload = buildControlPayloadPlan(request.text);
     if (controlPayload) {
+      if (options && "author" in options) {
+        return failWithoutResolution("INVALID_INPUT", "Per-call author is not supported for structural control-payload inserts.");
+      }
       const committed = rewriteAnchorParagraphWithControlPayload(this.context, anchor.storyId, anchor.blockId, controlPayload, options?.expectedRevision);
       if (!committed.ok) {
         return {
@@ -398173,7 +398257,7 @@ class V2WriteAdapter {
         resolution
       };
     }
-    const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision });
+    const begun = this.context.beginMutation({ expectedRevision: options?.expectedRevision, author: "author" in (options ?? {}) ? options.author : undefined });
     if ("failure" in begun) {
       return {
         success: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.7.0-next.10",
+  "version": "1.7.0-next.11",
   "description": "Model Context Protocol server for SuperDoc, giving an AI agent tools to read and edit .docx files.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,13 +24,13 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.20.0-next.10",
+    "@superdoc/sdk": "2.20.0-next.11",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.23.0-next.10",
-    "@superdoc/docx-engine": "0.22.0-next.10",
+    "superdoc": "2.23.0-next.11",
+    "@superdoc/docx-engine": "0.22.0-next.11",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",