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

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.12";
 
 // ../../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(() => {
@@ -167555,6 +167575,130 @@ function extractNamespaceClosedParagraphMarkRunPropertiesFromParagraph(paragraph
     return null;
   return namespaceClosedOpenTag + runPropertiesXml.slice(runPropertiesNode.openEnd);
 }
+function namespaceCloseParagraphPropertiesForRelocation(paragraphPropertiesXml, paragraphXml, inheritedNamespaceBindings, ancestorOpenTags = []) {
+  const paragraph = readValidatedXmlNodeAt(paragraphXml, 0);
+  if (!paragraph || paragraph.kind !== "element" || xmlLocalName(paragraph.qname) !== "p" || paragraph.selfClosing || paragraphXml.slice(paragraph.end).trim())
+    return null;
+  const paragraphOpenTag = paragraphXml.slice(0, paragraph.openEnd);
+  const ancestorPolicySources = readAncestorPolicySources(ancestorOpenTags);
+  if (ancestorPolicySources == null)
+    return null;
+  const { pPr } = splitLeadingParagraphPropertyBlock(paragraphXml.slice(paragraph.openEnd, paragraph.closeStart));
+  const sourcePropertiesStart = pPr.search(/<(?:[\w.-]+:)?pPr\b/);
+  const sourceProperties = sourcePropertiesStart >= 0 ? readValidatedXmlNodeAt(pPr, sourcePropertiesStart) : null;
+  if (sourceProperties && (sourceProperties.kind !== "element" || xmlLocalName(sourceProperties.qname) !== "pPr"))
+    return null;
+  const sourcePropertiesOpenTag = sourceProperties ? pPr.slice(sourcePropertiesStart, sourceProperties.openEnd) : "";
+  const paragraphDeclarations = readLocalNamespaceDeclarations(paragraphOpenTag);
+  if (paragraphDeclarations == null)
+    return null;
+  const sourceBindings = { ...inheritedNamespaceBindings };
+  for (const declaration of paragraphDeclarations)
+    sourceBindings[declaration.prefix] = declaration.namespaceUri;
+  const paragraphBindings = { ...sourceBindings };
+  const sourcePropertiesDeclarations = readLocalNamespaceDeclarations(sourcePropertiesOpenTag);
+  if (sourcePropertiesDeclarations == null)
+    return null;
+  for (const declaration of sourcePropertiesDeclarations)
+    sourceBindings[declaration.prefix] = declaration.namespaceUri;
+  return closePropertyFragmentWithCompatibilityPolicy(paragraphPropertiesXml, "pPr", sourceBindings, [
+    ...ancestorPolicySources,
+    [paragraphOpenTag, paragraphBindings],
+    [sourcePropertiesOpenTag, sourceBindings]
+  ]);
+}
+function namespaceCloseRunPropertiesWithAncestorPolicy(runPropertiesXml, paragraphOpenTag, inheritedNamespaceBindings, ancestorOpenTags) {
+  if (!runPropertiesXml)
+    return "";
+  const ancestorPolicySources = readAncestorPolicySources(ancestorOpenTags);
+  const declarations = readLocalNamespaceDeclarations(paragraphOpenTag);
+  if (ancestorPolicySources == null || declarations == null)
+    return null;
+  const bindings = { ...inheritedNamespaceBindings };
+  for (const declaration of declarations)
+    bindings[declaration.prefix] = declaration.namespaceUri;
+  return closePropertyFragmentWithCompatibilityPolicy(runPropertiesXml, "rPr", bindings, [
+    ...ancestorPolicySources,
+    [paragraphOpenTag, bindings]
+  ]);
+}
+function readAncestorPolicySources(ancestorOpenTags) {
+  const sources = [];
+  const bindings = {};
+  for (const openTag of ancestorOpenTags) {
+    const declarations = readLocalNamespaceDeclarations(openTag);
+    if (declarations == null)
+      return null;
+    for (const declaration of declarations)
+      bindings[declaration.prefix] = declaration.namespaceUri;
+    sources.push([openTag, { ...bindings }]);
+  }
+  return sources;
+}
+function closePropertyFragmentWithCompatibilityPolicy(propertiesXml, propertyName, inheritedNamespaceBindings, policySources) {
+  const node2 = readValidatedXmlNodeAt(propertiesXml, 0);
+  if (!node2 || node2.kind !== "element" || xmlLocalName(node2.qname) !== propertyName || node2.end !== propertiesXml.length)
+    return null;
+  let openTag = propertiesXml.slice(0, node2.openEnd);
+  const localDeclarations = readLocalNamespaceDeclarations(openTag);
+  if (localDeclarations == null)
+    return null;
+  const bindings = { ...inheritedNamespaceBindings };
+  for (const declaration of localDeclarations)
+    bindings[declaration.prefix] = declaration.namespaceUri;
+  const prefix = parseRawXmlElementTag(openTag)?.prefix;
+  if (prefix == null)
+    return null;
+  if (bindings[prefix] == null)
+    bindings[prefix] = NS_W;
+  if (bindings[prefix] !== NS_W)
+    return null;
+  for (const [sourceOpenTag, policyBindings] of policySources) {
+    const policyPrefixes = markupCompatibilityValuePrefixes(sourceOpenTag, new Map(Object.entries(policyBindings)));
+    if (policyPrefixes == null || [...policyPrefixes].some((key2) => policyBindings[key2] !== bindings[key2]))
+      return null;
+    for (const attribute of scanRawXmlAttributes(sourceOpenTag)) {
+      if (policyBindings[attribute.prefix] !== NS_MC)
+        continue;
+      if (bindings[attribute.prefix] !== NS_MC)
+        return null;
+      const existing = [...scanRawXmlAttributes(openTag)].find((candidate) => bindings[candidate.prefix] === NS_MC && candidate.localName === attribute.localName);
+      if (existing) {
+        const currentValue = decodeXmlText(existing.value);
+        const sourceValue = decodeXmlText(attribute.value);
+        if (currentValue !== sourceValue) {
+          if (!INHERITED_MC_LIST_ATTRIBUTES.has(attribute.localName))
+            return null;
+          const tokens = [...new Set([...currentValue.split(/\s+/), ...sourceValue.split(/\s+/)].filter(Boolean))];
+          openTag = openTag.slice(0, existing.valueStart) + escapeXmlAttribute(tokens.join(" ")) + openTag.slice(existing.valueEnd);
+        }
+      } else {
+        const sourceXml = sourceOpenTag.slice(attribute.sourceStart, attribute.sourceEnd);
+        openTag = openTag.replace(/\s*(\/?)>$/, (_match, slash) => ` ${sourceXml.trim()}${slash}>`);
+      }
+    }
+  }
+  const fragment3 = openTag + propertiesXml.slice(node2.openEnd);
+  const required2 = namespacePrefixesRequiredByFragment(fragment3);
+  const compatibilityPrefixes = markupCompatibilityValuePrefixes(openTag, new Map(Object.entries(bindings)));
+  if (required2 == null || compatibilityPrefixes == null)
+    return null;
+  const declarations = [];
+  for (const requiredPrefix of new Set([...required2, ...compatibilityPrefixes])) {
+    if (requiredPrefix === "xml")
+      continue;
+    const namespaceUri = bindings[requiredPrefix];
+    if (!namespaceUri || namespaceUri.startsWith("urn:superdoc:unresolved-namespace-prefix:"))
+      return null;
+    declarations.push({
+      prefix: requiredPrefix,
+      namespaceUri,
+      sourceXml: requiredPrefix ? ` xmlns:${requiredPrefix}="${escapeXmlAttribute(namespaceUri)}"` : ` xmlns="${escapeXmlAttribute(namespaceUri)}"`
+    });
+  }
+  const closed = addNamespaceDeclarations(openTag, declarations);
+  return closed == null ? null : closed + propertiesXml.slice(node2.openEnd);
+}
 function namespaceCloseRunPropertiesForRelocation(runPropertiesXml, namespaceSourceOpenTag, inheritedNamespaceBindings = {}) {
   const runPropertiesNode = readValidatedXmlNodeAt(runPropertiesXml, 0);
   if (!runPropertiesNode || runPropertiesNode.kind !== "element" || runPropertiesNode.selfClosing || xmlLocalName(runPropertiesNode.qname) !== "rPr" || runPropertiesNode.end !== runPropertiesXml.length) {
@@ -168097,11 +168241,12 @@ function addNamespaceDeclarations(openTag, sourceNamespaces, inheritedNamespaceB
   }
   return additions.length > 0 ? openTag.replace(/\s*(\/?)>$/, (_match, selfClosing) => `${additions}${selfClosing}>`) : openTag;
 }
-var PARAGRAPH_MARK_REVISION_CHILDREN;
+var PARAGRAPH_MARK_REVISION_CHILDREN, INHERITED_MC_LIST_ATTRIBUTES;
 var init_paragraph_property_block = __esm(() => {
   init_xml_text();
   init_xml_sax();
   PARAGRAPH_MARK_REVISION_CHILDREN = new Set(["ins", "del", "moveFrom", "moveTo", "rPrChange"]);
+  INHERITED_MC_LIST_ATTRIBUTES = new Set(["Ignorable", "PreserveAttributes", "PreserveElements", "ProcessContent"]);
 });
 
 // ../../../v2/editor-core/dist/document/transactions/collapsed-inline-insertion-site.js
@@ -187984,11 +188129,18 @@ var init_part_wml_scan_cache = __esm(() => {
 
 // ../../../v2/editor-core/dist/document/transactions/paragraph-para-id-attrs.js
 function namespaceBindingsAtPosition(bytes, byteOffset, localOpenTag = "") {
+  return namespaceContextAtPosition(bytes, byteOffset, localOpenTag).bindings;
+}
+function namespaceContextAtPosition(bytes, byteOffset, localOpenTag = "") {
+  const scopes = readNamespaceScopesBeforeByte(bytes, byteOffset);
   const bindings = {
-    ...readNamespacesBeforeByte(bytes, byteOffset),
+    ...scopes.reduce((acc, frame) => ({ ...acc, ...frame.namespaces }), {}),
     ...readNamespaceDeclarations2(localOpenTag)
   };
-  return Object.fromEntries(Object.entries(bindings).filter((entry) => entry[1] != null));
+  return {
+    bindings: Object.fromEntries(Object.entries(bindings).filter((entry) => entry[1] != null)),
+    ancestorOpenTags: scopes.map((frame) => frame.openTag)
+  };
 }
 function matchParagraphOpenTag(paragraphXml) {
   return paragraphXml.match(PARAGRAPH_OPEN_TAG_RE2)?.[0] ?? null;
@@ -188016,6 +188168,9 @@ function readPartRootNamespaces(bytes) {
   return readNamespaceDeclarations2(rootOpenTag);
 }
 function readNamespacesBeforeByte(bytes, byteOffset) {
+  return readNamespaceScopesBeforeByte(bytes, byteOffset).reduce((acc, frame) => ({ ...acc, ...frame.namespaces }), {});
+}
+function readNamespaceScopesBeforeByte(bytes, byteOffset) {
   ancestorNamespacePrefixScanCount += 1;
   const prefix = stripXmlCommentsAndCdata(TD33.decode(bytes.subarray(0, Math.max(0, byteOffset))));
   const stack = [];
@@ -188038,9 +188193,9 @@ function readNamespacesBeforeByte(bytes, byteOffset) {
     const namespaces = readNamespaceDeclarations2(match[0]);
     if (/\/\s*>$/.test(match[0]))
       continue;
-    stack.push({ name, namespaces });
+    stack.push({ name, namespaces, openTag: match[0] });
   }
-  return stack.reduce((acc, frame) => ({ ...acc, ...frame.namespaces }), {});
+  return stack;
 }
 function stripXmlCommentsAndCdata(xml) {
   let result = "";
@@ -219329,7 +219484,7 @@ function resolveInsertionFormattingContext(state, input) {
   const style = resolveInsertionStyle(state, paragraphXml, input.anchor, input.styleRef, inheritance, input.fallbackToDocumentDefaultStyle ?? false);
   if (!style.ok)
     return style;
-  const direct = inheritance === "anchor" && paragraphXml != null ? resolveDirectInsertionFormatting(paragraphXml, input.anchor.placement, readAnchorNamespaceBindings(state, input.anchor.entry)) : {
+  const direct = inheritance === "anchor" && paragraphXml != null ? resolveDirectInsertionFormatting(paragraphXml, input.anchor.placement, readAnchorNamespaceBindings(state, input.anchor.entry), input.includeRunProperties ?? true) : {
     paragraphPropertiesXml: null,
     paragraphMarkRunPropertiesXml: null,
     runPropertiesXml: null,
@@ -219492,10 +219647,10 @@ function lookupNextStyle(state, styleId) {
 function readWordAttribute2(tag, namespaceUri, localName2) {
   return readXmlAttribute(tag, namespaceUri, localName2)?.value;
 }
-function resolveDirectInsertionFormatting(paragraphXml, placement2, inheritedNamespaceBindings = {}) {
+function resolveDirectInsertionFormatting(paragraphXml, placement2, inheritedNamespaceBindings = {}, includeRunProperties = true) {
   const paragraphPropertiesXml = cloneDirectParagraphPropertiesForInsert(paragraphXml);
   const paragraphMarkRunPropertiesXml = cloneParagraphMarkRunPropertiesForInsert(paragraphXml);
-  const adjacentRunProperties = cloneAdjacentRunPropertiesForInsert(paragraphXml, placement2, paragraphMarkRunPropertiesXml, inheritedNamespaceBindings);
+  const adjacentRunProperties = includeRunProperties ? cloneAdjacentRunPropertiesForInsert(paragraphXml, placement2, paragraphMarkRunPropertiesXml, inheritedNamespaceBindings) : { ok: true, runPropertiesXml: null };
   if (!adjacentRunProperties.ok)
     return adjacentRunProperties;
   const runPropertiesXml = adjacentRunProperties.runPropertiesXml;
@@ -241404,31 +241559,32 @@ var init_compile_paste_lists = __esm(() => {
 });
 
 // ../../../v2/editor-core/dist/document/transactions/match-destination-paste.js
-function normalizeMatchDestinationBlocks(blocks) {
-  return blocks.map((block) => {
-    if (block.kind !== "paragraph")
-      return block;
-    return {
-      kind: "paragraph",
-      runs: block.runs.map((run) => ({ text: run.text, ...run.sourcePath ? { sourcePath: run.sourcePath } : {} })),
-      ...block.sourcePath ? { sourcePath: block.sourcePath } : {},
-      ...block.inlines ? {
-        inlines: block.inlines.map((inline) => inline.kind === "text" ? {
-          kind: "text",
-          text: inline.text,
-          ...inline.sourcePath ? { sourcePath: inline.sourcePath } : {}
-        } : inline.kind === "hyperlink" ? {
-          ...inline,
-          inlines: inline.inlines.map((child) => child.kind === "text" ? {
-            kind: "text",
-            text: child.text,
-            ...child.sourcePath ? { sourcePath: child.sourcePath } : {}
-          } : child)
-        } : inline)
-      } : {}
-    };
-  });
+function normalizeMatchDestinationBlocks(blocks, destinationTableParagraphPropertiesXml) {
+  return blocks.map((block) => block.kind === "table" ? mapPasteTableParagraphs(block, (paragraph) => ({
+    ...normalizeMatchDestinationParagraph(paragraph),
+    ...destinationTableParagraphPropertiesXml ? { pPrXml: destinationTableParagraphPropertiesXml, complete: true } : {}
+  })) : block.kind === "paragraph" ? normalizeMatchDestinationParagraph(block) : block);
+}
+function normalizeMatchDestinationParagraph(block) {
+  return {
+    kind: "paragraph",
+    runs: block.runs.map(withoutSourceMarks),
+    ...block.sourcePath ? { sourcePath: block.sourcePath } : {},
+    ...block.inlines ? {
+      inlines: block.inlines.map((inline) => inline.kind === "text" ? withoutSourceMarks(inline) : inline.kind === "hyperlink" ? {
+        ...inline,
+        inlines: inline.inlines.map((child) => child.kind === "text" ? withoutSourceMarks(child) : child)
+      } : inline)
+    } : {}
+  };
 }
+function withoutSourceMarks(run) {
+  const { marks: _sourceMarks, ...retained } = run;
+  return retained;
+}
+var init_match_destination_paste = __esm(() => {
+  init_paste_blocks();
+});
 
 // ../../../v2/editor-core/dist/document/transactions/image-catalog.js
 function buildImageCatalog(input) {
@@ -243912,7 +244068,32 @@ function preparePasteFragmentMutation(input) {
   if (!isMaterializablePasteBlocks(blocks)) {
     return rejected18(txId, "paste-structure-unsupported");
   }
-  const normalizedBlocks = isTextTarget2(pasteTarget) && op.formattingMode === "match-destination" ? normalizeMatchDestinationBlocks(blocks) : blocks;
+  let destinationTableParagraphPropertiesXml = null;
+  if (isTextTarget2(pasteTarget) && op.formattingMode === "match-destination" && blocks.some((block) => block.kind === "table")) {
+    const anchor = resolveParagraph3(state, pasteTarget.storyId, pasteTarget.paraId);
+    if (!anchor)
+      return rejected18(txId, "paste-target-unsupported");
+    const destination = resolveInsertionFormattingContext(state, {
+      anchor: { entry: anchor.entry, placement: "before" },
+      includeRunProperties: false
+    });
+    if (!destination.ok)
+      return rejected18(txId, destination.reason);
+    if (destination.context.paragraphPropertiesXml) {
+      const bytes = state.packageBytes.get(anchor.partUri);
+      if (!bytes)
+        return rejected18(txId, "paste-target-unsupported");
+      const paragraphXml = TD70.decode(bytes.subarray(anchor.byteStart, anchor.byteEnd));
+      const openTag = matchParagraphOpenTag(paragraphXml);
+      if (!openTag)
+        return rejected18(txId, "paste-target-unsupported");
+      const namespaceContext = namespaceContextAtPosition(bytes, anchor.byteStart, openTag);
+      destinationTableParagraphPropertiesXml = namespaceCloseParagraphPropertiesForRelocation(destination.context.paragraphPropertiesXml, paragraphXml, namespaceContext.bindings, namespaceContext.ancestorOpenTags);
+      if (destinationTableParagraphPropertiesXml == null)
+        return rejected18(txId, "paste-structure-unsupported");
+    }
+  }
+  const normalizedBlocks = isTextTarget2(pasteTarget) && op.formattingMode === "match-destination" ? normalizeMatchDestinationBlocks(blocks, destinationTableParagraphPropertiesXml) : blocks;
   const imageValidation = validateImageFragment(op.fragment);
   if (!imageValidation.ok)
     return rejected18(txId, imageValidation.reason);
@@ -244012,7 +244193,13 @@ function preparePasteFragmentMutation(input) {
         if (!anchor || !bytes)
           return rejected18(txId, "paste-target-unsupported");
         const anchorXml = TD70.decode(bytes.subarray(anchor.byteStart, anchor.byteEnd));
-        const destination = resolveCaretRunPropertiesForInsertion(anchorXml, target.start.charOffset, namespaceBindingsAtPosition(bytes, anchor.byteStart, matchParagraphOpenTag(anchorXml) ?? ""), anchor.entry.textLength);
+        const destination = resolveDestinationPasteRunProperties({
+          paragraphXml: anchorXml,
+          charOffset: target.start.charOffset,
+          partBytes: bytes,
+          paragraphStartByte: anchor.byteStart,
+          replaceToOffset: anchor.entry.textLength
+        });
         if (!destination.ok)
           return rejected18(txId, destination.reason);
         imageExtras.value = {
@@ -244925,6 +245112,24 @@ function tryRunTableRowPasteCommit(input, pasteTarget, pastedBlocks, additionalP
   const targetTableLocation = findContainingTableCell(tableCatalog, targetParagraph);
   if (!targetTableLocation)
     return null;
+  if (input.op.formattingMode === "match-destination" && storyPartBytes) {
+    const paragraphXml = TD70.decode(storyPartBytes.subarray(targetParagraph.byteStart, targetParagraph.byteEnd));
+    const destination = resolveDestinationPasteRunProperties({
+      paragraphXml,
+      charOffset: pasteTarget.charOffset,
+      partBytes: storyPartBytes,
+      paragraphStartByte: targetParagraph.byteStart,
+      replaceToOffset: pasteTarget.replaceToOffset,
+      collapsedInlineAffinity: pasteTarget.collapsedInlineAffinity,
+      collapsedObjectBoundary: pasteTarget.collapsedObjectBoundary
+    });
+    if (!destination.ok)
+      return rejected18(transactionId, destination.reason);
+    pastedImageExtras = {
+      ...pastedImageExtras,
+      inlineSpecs: inheritDestinationInlineSpecs(pastedImageExtras.inlineSpecs, pastedBlocks, destination.runPropertiesXml ?? "")
+    };
+  }
   if (targetTableLocation.table.hasVMerge) {
     return rejected18(transactionId, "paste-target-unsupported");
   }
@@ -245424,7 +245629,15 @@ function runPasteSpliceCommit(input, target, resolvedBlocks, listExtras, imageEx
   const anchorXml = TD70.decode(bytes.subarray(paragraphStartByte, paragraphEndByte));
   let inlineSpecs = imageExtras.inlineSpecs;
   if (input.op.formattingMode === "match-destination") {
-    const destination = resolveCaretRunPropertiesForInsertion(anchorXml, target.charOffset, namespaceBindingsAtPosition(bytes, paragraphStartByte, matchParagraphOpenTag(anchorXml) ?? ""), target.replaceToOffset, target.collapsedInlineAffinity, target.collapsedObjectBoundary);
+    const destination = resolveDestinationPasteRunProperties({
+      paragraphXml: anchorXml,
+      charOffset: target.charOffset,
+      partBytes: bytes,
+      paragraphStartByte,
+      replaceToOffset: target.replaceToOffset,
+      collapsedInlineAffinity: target.collapsedInlineAffinity,
+      collapsedObjectBoundary: target.collapsedObjectBoundary
+    });
     if (!destination.ok)
       return rejected18(txId, destination.reason);
     inlineSpecs = inheritDestinationInlineSpecs(inlineSpecs, resolvedBlocks, destination.runPropertiesXml ?? "");
@@ -245590,9 +245803,20 @@ function runPasteSpliceCommit(input, target, resolvedBlocks, listExtras, imageEx
     }
   });
 }
+function resolveDestinationPasteRunProperties(input) {
+  const openTag = matchParagraphOpenTag(input.paragraphXml);
+  if (!openTag)
+    return { ok: false, reason: "unsupported-context" };
+  const context = namespaceContextAtPosition(input.partBytes, input.paragraphStartByte, openTag);
+  const destination = resolveCaretRunPropertiesForInsertion(input.paragraphXml, input.charOffset, context.bindings, input.replaceToOffset, input.collapsedInlineAffinity, input.collapsedObjectBoundary);
+  if (!destination.ok)
+    return destination;
+  const runPropertiesXml = namespaceCloseRunPropertiesWithAncestorPolicy(destination.runPropertiesXml ?? "", openTag, context.bindings, context.ancestorOpenTags);
+  return runPropertiesXml == null ? { ok: false, reason: "unsupported-context" } : { ok: true, runPropertiesXml };
+}
 function inheritDestinationInlineSpecs(inlineSpecs, blocks, runPropertiesXml) {
   const inherited = new Map(inlineSpecs);
-  for (const block of blocks) {
+  for (const block of walkPasteBlocks(blocks)) {
     if (block.kind !== "paragraph")
       continue;
     inherited.set(block, (inlineSpecs.get(block) ?? block.runs.map(toPasteTextRunSpec)).map((run) => withDestinationRunProperties(run, runPropertiesXml)));
@@ -246849,8 +247073,10 @@ var init_compile_paste_fragment = __esm(() => {
   init_compile_paste_splice();
   init_compile_paste_lists();
   init_paste_blocks();
+  init_match_destination_paste();
   init_paragraph_para_id_attrs();
   init_insertion_formatting_context();
+  init_paragraph_property_block();
   init_table_catalog();
   init_comments_catalog();
   init_comment_package_profile();
@@ -301621,7 +301847,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 +330753,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 +331201,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 +331220,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 +333153,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 +333222,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 +333591,8 @@ class V2SelectionMutationAdapter {
           resolved: wholeStory.resolved,
           resolution: resolution2,
           effectiveStory: effectiveStory2,
-          expectedRevision: options?.expectedRevision
+          expectedRevision: options?.expectedRevision,
+          author: textMutationAuthor(options)
         });
       }
     }
@@ -333527,7 +333758,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 +333986,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 +334097,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 +334212,7 @@ class V2SelectionMutationAdapter {
       index: index2,
       historyLabel: "selection.delete.cross-paragraph",
       changeMode,
+      author: textMutationAuthor(options),
       preflightValidated: true,
       recordCommitDiagnostics(diagnostics) {
         commitDiagnosticsRef.current = diagnostics;
@@ -334037,6 +334272,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 +334338,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 +335138,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 +338048,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 +359159,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 +359984,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 +359995,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 +360019,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 +360029,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 +360244,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 +370174,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 +397945,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 +397966,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 +398445,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 +398463,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.12",
   "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.12",
     "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.12",
+    "@superdoc/docx-engine": "0.22.0-next.12",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",