@superdoc/mcp 1.3.0-next.13 → 1.3.0-next.14

package/dist/index.js

@@ -31318,7 +31318,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.16.0-next.13";
+var SDK_VERSION = "2.16.0-next.14";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { chmodSync, existsSync } from "node:fs";
@@ -134761,6 +134761,20 @@ function isValidRevisionDate(value) {
   const daysInMonth = [31, isLeapYear(year) ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
   return day <= daysInMonth[month - 1];
 }
+function parseRevisionMarkerAttributes(attributes) {
+  const idAttributes = attributes.filter((attribute) => attribute.local === "id");
+  const authorAttributes = attributes.filter((attribute) => attribute.local === "author");
+  const dateAttributes = attributes.filter((attribute) => attribute.local === "date");
+  const hasValidIdAttribute = idAttributes.length === 1 && idAttributes[0].uri === W_NS;
+  const id = hasValidIdAttribute ? parseRevisionWId(idAttributes[0].value) : null;
+  const hasValidAuthorAttribute = authorAttributes.length === 1 && authorAttributes[0].uri === W_NS;
+  const author = hasValidAuthorAttribute ? authorAttributes[0].value : "";
+  const hasValidDateAttributes = dateAttributes.every((attribute) => attribute.uri === W_NS && isValidRevisionDate(attribute.value));
+  if (!hasValidIdAttribute || !hasValidAuthorAttribute || id === null || !author || !hasValidDateAttributes) {
+    return null;
+  }
+  return { id, author, date: dateAttributes[0]?.value };
+}
 function parseDirectRunSequence(xml, allowRevisions) {
   const revisions = [];
   const stack = [];
@@ -134815,21 +134829,13 @@ function parseDirectRunSequence(xml, allowRevisions) {
         return;
       }
       if (allowRevisions && tag.uri === W_NS && (tag.local === "ins" || tag.local === "del") && !tag.isSelfClosing) {
-        const attributes = Object.values(tag.attributes);
-        const idAttributes = attributes.filter((attribute) => attribute.local === "id");
-        const authorAttributes = attributes.filter((attribute) => attribute.local === "author");
-        const dateAttributes = attributes.filter((attribute) => attribute.local === "date");
-        const hasValidIdAttribute = idAttributes.length === 1 && idAttributes[0].uri === W_NS;
-        const idValue = hasValidIdAttribute ? idAttributes[0].value : "";
-        const id = parseRevisionWId(idValue);
-        const hasValidAuthorAttribute = authorAttributes.length === 1 && authorAttributes[0].uri === W_NS;
-        const author = hasValidAuthorAttribute ? authorAttributes[0].value : "";
-        if (!hasValidIdAttribute || !hasValidAuthorAttribute || id === null || !author || dateAttributes.some((attribute) => attribute.uri !== W_NS || !isValidRevisionDate(attribute.value)))
+        const marker = parseRevisionMarkerAttributes(Object.values(tag.attributes));
+        if (!marker)
           valid = false;
         activeRevision = tag.local;
         activeRevisionRunCount = 0;
-        if (id !== null)
-          revisions.push({ kind: tag.local, wId: id, author });
+        if (marker)
+          revisions.push({ kind: tag.local, wId: marker.id, author: marker.author });
         stack.push("revision");
         return;
       }
@@ -134977,6 +134983,116 @@ function sameNoteMarkerRunXml(base2, target) {
 function inspectDirectParagraphRevisionRuns(xml) {
   return parseDirectRunSequence(xml, true);
 }
+function inspectDirectRunSequence(xml) {
+  return parseDirectRunSequence(xml, false);
+}
+function parseParagraphMarkRevisionMarker(pPrXml) {
+  if (pPrXml === "")
+    return null;
+  let valid = true;
+  const stack = [];
+  let hasSectPr = false;
+  let markerCount = 0;
+  let marker = null;
+  const parser = new import_saxes3.SaxesParser({
+    xmlns: true,
+    additionalNamespaces: replayAdditionalNamespaces(pPrXml)
+  });
+  parser.on("error", () => {
+    valid = false;
+  });
+  parser.on("opentag", (tag) => {
+    const parent = stack.at(-1);
+    const grandparent = stack.at(-2);
+    if (parent === undefined && (tag.local !== "pPr" || tag.uri !== W_NS))
+      valid = false;
+    if (tag.uri === W_NS && tag.local === "sectPr")
+      hasSectPr = true;
+    const parentIsLiveRPr = stack.length === 2 && parent !== undefined && parent.uri === W_NS && parent.local === "rPr" && grandparent !== undefined && grandparent.uri === W_NS && grandparent.local === "pPr";
+    if (parentIsLiveRPr && tag.uri === W_NS && (tag.local === "ins" || tag.local === "del")) {
+      markerCount += 1;
+      if (!tag.isSelfClosing) {
+        valid = false;
+      } else {
+        const attrs = parseRevisionMarkerAttributes(Object.values(tag.attributes));
+        if (!attrs || marker !== null) {
+          valid = false;
+        } else {
+          marker = { kind: tag.local, wId: attrs.id, author: attrs.author, date: attrs.date };
+        }
+      }
+    } else if (parentIsLiveRPr && tag.uri === W_NS && (tag.local === "moveFrom" || tag.local === "moveTo")) {
+      valid = false;
+    }
+    stack.push({ uri: tag.uri ?? "", local: tag.local ?? "" });
+  });
+  parser.on("closetag", () => {
+    stack.pop();
+  });
+  try {
+    parser.write(pPrXml).close();
+  } catch {
+    valid = false;
+  }
+  if (!valid || stack.length !== 0 || hasSectPr || markerCount !== 1 || marker === null)
+    return null;
+  return marker;
+}
+function removeProvenParagraphMarkMarker(xml, marker) {
+  const baseBindings = new Map([["w", W_NS]]);
+  const stack = [];
+  let removal = null;
+  let position = 0;
+  while (position < xml.length) {
+    const start = xml.indexOf("<", position);
+    if (start < 0)
+      break;
+    if (xml.startsWith("<!--", start) || xml.startsWith("<![CDATA[", start) || xml.startsWith("<?", start)) {
+      return null;
+    }
+    const end = findXmlTagEnd2(xml, start);
+    if (end < 0)
+      return null;
+    const rawTag = xml.slice(start, end + 1);
+    if (rawTag.startsWith("</")) {
+      const close = /^<\/\s*([A-Za-z_][\w.-]*(?::[A-Za-z_][\w.-]*)?)\s*>$/.exec(rawTag);
+      if (!close || stack.pop()?.qname !== close[1])
+        return null;
+      position = end + 1;
+      continue;
+    }
+    const parsed = parseXmlStartTag(rawTag);
+    if (!parsed)
+      return null;
+    const bindings = new Map(stack.at(-1)?.bindings ?? baseBindings);
+    for (const attribute of parsed.attributes) {
+      if (attribute.qname === "xmlns")
+        bindings.set("", attribute.value);
+      else if (attribute.prefix === "xmlns")
+        bindings.set(attribute.localName, attribute.value);
+    }
+    const namespaceUri = bindings.get(parsed.prefix) ?? "";
+    const parentEntry = stack.at(-1);
+    const grandparentEntry = stack.at(-2);
+    const isLiveRPrChild = stack.length === 2 && parentEntry?.localName === "rPr" && grandparentEntry?.localName === "pPr";
+    if (isLiveRPrChild && namespaceUri === W_NS && parsed.localName === marker.kind && parsed.selfClosing) {
+      const idValue = parsed.attributes.find((attribute) => attribute.localName === "id" && (bindings.get(attribute.prefix) ?? "") === W_NS)?.value;
+      const authorValue = parsed.attributes.find((attribute) => attribute.localName === "author" && (bindings.get(attribute.prefix) ?? "") === W_NS)?.value;
+      const dateValue = parsed.attributes.find((attribute) => attribute.localName === "date" && (bindings.get(attribute.prefix) ?? "") === W_NS)?.value;
+      if (parseRevisionWId(idValue ?? "") === marker.wId && authorValue === marker.author && dateValue === marker.date) {
+        if (removal !== null)
+          return null;
+        removal = { start, end: end + 1 };
+      }
+    }
+    if (!parsed.selfClosing)
+      stack.push({ qname: parsed.qname, localName: parsed.localName, bindings });
+    position = end + 1;
+  }
+  if (stack.length > 0 || removal === null)
+    return null;
+  return xml.slice(0, removal.start) + xml.slice(removal.end);
+}
 function trackedAnnotationEntries(annotations) {
   return annotations?.find((capture) => capture.family === "tracked-changes")?.entries ?? [];
 }
@@ -135367,9 +135483,27 @@ function validateCompareReplayPayload(payload, options = {}) {
   if (!dependencyResult.ok)
     return dependencyResult;
   if (payload.targetParagraphPropertiesXml !== undefined) {
-    const result = validateParagraphProperties(payload.targetParagraphPropertiesXml);
-    if (!result.ok)
-      return result;
+    if (payload.targetParagraphMarkRevisionReplay !== undefined) {
+      const proof = payload.targetParagraphMarkRevisionReplay;
+      if (proof.policy !== "preserve-target-paragraph-mark-revision") {
+        return { ok: false, reason: "target paragraph mark revision replay policy is incomplete" };
+      }
+      const marker = parseParagraphMarkRevisionMarker(payload.targetParagraphPropertiesXml);
+      if (!marker || marker.kind !== proof.kind || marker.wId !== proof.wId || marker.author !== proof.author || marker.date !== proof.date) {
+        return { ok: false, reason: "target paragraph mark revision replay proof does not match the target paragraph properties" };
+      }
+      const strippedXml = removeProvenParagraphMarkMarker(payload.targetParagraphPropertiesXml, marker);
+      if (strippedXml === null) {
+        return { ok: false, reason: "target paragraph mark revision replay proof could not be isolated from the target paragraph properties" };
+      }
+      const result = validateParagraphProperties(strippedXml);
+      if (!result.ok)
+        return result;
+    } else {
+      const result = validateParagraphProperties(payload.targetParagraphPropertiesXml);
+      if (!result.ok)
+        return result;
+    }
   }
   if (payload.targetRevisionReplay !== undefined) {
     if (payload.targetRevisionReplay.policy !== "preserve-target-revision-set" || payload.targetRunXml === undefined) {
@@ -136167,14 +136301,27 @@ function validateBodyOperation(operation, label, problems, replayOptions = {}) {
       }
     }
   }
-  const carriesReplayPayload = operation.targetParagraphPropertiesXml !== undefined || operation.targetRunXml !== undefined || operation.replayDependencies !== undefined || operation.replayDependencyProofFailed !== undefined;
-  if (carriesReplayPayload && hasValidReplayPayloadShape && hasValidReplayShape) {
+  let hasValidParagraphMarkReplayShape = operation.targetParagraphMarkRevisionReplay === undefined;
+  if (operation.targetParagraphMarkRevisionReplay !== undefined) {
+    const replay = operation.targetParagraphMarkRevisionReplay;
+    const hasValidShape = isRecord9(replay) && replay.policy === "preserve-target-paragraph-mark-revision" && (replay.kind === "ins" || replay.kind === "del") && typeof replay.wId === "number" && Number.isSafeInteger(replay.wId) && isNonEmptyString2(replay.author) && (replay.date === undefined || typeof replay.date === "string");
+    hasValidParagraphMarkReplayShape = hasValidShape;
+    if (!hasValidShape) {
+      problems.push(`${label}.targetParagraphMarkRevisionReplay: invalid target paragraph mark revision replay`);
+    }
+    if (operation.kind === "edit" || operation.kind === "formatEdit") {
+      problems.push(`${label}.targetParagraphMarkRevisionReplay: ${operation.kind} does not support paragraph mark revision replay`);
+      hasValidParagraphMarkReplayShape = false;
+    }
+  }
+  const carriesReplayPayload = operation.kind !== "delete" && (operation.targetParagraphPropertiesXml !== undefined || operation.targetRunXml !== undefined || operation.replayDependencies !== undefined || operation.replayDependencyProofFailed !== undefined || operation.targetParagraphMarkRevisionReplay !== undefined);
+  if (carriesReplayPayload && hasValidReplayPayloadShape && hasValidReplayShape && hasValidParagraphMarkReplayShape) {
     const proof = validateCompareReplayPayload(operation, {
       ...replayOptions,
       expectedCurrentText: operation.kind !== "delete" && typeof operation.text === "string" ? operation.text : undefined
     });
     if (!proof.ok) {
-      const field = operation.targetRevisionReplay === undefined ? "replayPayload" : "targetRevisionReplay";
+      const field = operation.targetRevisionReplay === undefined ? operation.targetParagraphMarkRevisionReplay === undefined ? "replayPayload" : "targetParagraphMarkRevisionReplay" : "targetRevisionReplay";
       problems.push(`${label}.${field}: ${proof.reason}`);
     }
   }
@@ -136940,8 +137087,8 @@ function validatePlanDispositions(value, steps, problems) {
       }
     });
   }
-  const bodyHasTargetRevisionReplay = Array.isArray(value.bodyOperations) && value.bodyOperations.some((operation) => isRecord9(operation) && operation.targetRevisionReplay !== undefined);
-  const storyHasTargetRevisionReplay = Array.isArray(value.storyOperations) && value.storyOperations.some((group) => isRecord9(group) && Array.isArray(group.operations) && group.operations.some((operation) => isRecord9(operation) && operation.targetRevisionReplay !== undefined));
+  const bodyHasTargetRevisionReplay = Array.isArray(value.bodyOperations) && value.bodyOperations.some((operation) => isRecord9(operation) && (operation.targetRevisionReplay !== undefined || operation.targetParagraphMarkRevisionReplay !== undefined));
+  const storyHasTargetRevisionReplay = Array.isArray(value.storyOperations) && value.storyOperations.some((group) => isRecord9(group) && Array.isArray(group.operations) && group.operations.some((operation) => isRecord9(operation) && (operation.targetRevisionReplay !== undefined || operation.targetParagraphMarkRevisionReplay !== undefined)));
   if ((bodyHasTargetRevisionReplay || storyHasTargetRevisionReplay) && dispositions.get("tracked-changes") !== "supported") {
     problems.push("target revision replay requires a supported tracked-changes step");
   }
@@ -139035,6 +139182,33 @@ function matchingRevisionAnnotationKeys(annotations, revisions, partUri, paragra
   }
   return keys;
 }
+function matchingParagraphMarkAnnotationKey(annotations, marker, structuralKind, paragraphStructuralAnnotationKeys) {
+  const entries = annotations?.find((capture) => capture.family === "tracked-changes")?.entries ?? [];
+  const exactKeys = paragraphStructuralAnnotationKeys === undefined ? null : new Set(paragraphStructuralAnnotationKeys);
+  const matches = entries.filter((entry) => entry.label === `structural revision ${structuralKind}` && (entry.semanticKey?.startsWith(`structural:${structuralKind}|`) ?? false) && entry.key.includes(`|${marker.wId}|`) && (exactKeys === null || exactKeys.has(entry.key)));
+  return matches.length === 1 ? matches[0].key : null;
+}
+function paragraphMarkTargetRevisionReplay(entry, annotations) {
+  if (!entry)
+    return null;
+  const marker = parseParagraphMarkRevisionMarker(entry.paragraphPropertiesXml ?? "");
+  if (!marker)
+    return null;
+  const structuralKind = marker.kind === "ins" ? "paragraph-mark-insertion" : "paragraph-mark-deletion";
+  const key2 = matchingParagraphMarkAnnotationKey(annotations, marker, structuralKind, entry.structuralChangeAnnotationKeys);
+  if (!key2)
+    return null;
+  return {
+    key: key2,
+    replay: {
+      policy: "preserve-target-paragraph-mark-revision",
+      kind: marker.kind,
+      wId: marker.wId,
+      author: marker.author,
+      date: marker.date
+    }
+  };
+}
 function attachExactTargetRevisionReplay(operations, baseEntries, targetEntries, entityMatch, baseAnnotations, targetAnnotations, basePartUri, targetPartUri, entityId = (blockId) => blockId) {
   if (!entityMatch) {
     return {
@@ -139053,51 +139227,69 @@ function attachExactTargetRevisionReplay(operations, baseEntries, targetEntries,
   const replayOperations = operations.map((operation) => {
     if (operation.kind === "insert" || operation.kind === "insertAtStart") {
       const targetEntry2 = targetById.get(entityId(operation.blockId));
-      if (!targetEntry2)
-        return operation;
-      const targetInspection2 = inspectDirectParagraphRevisionRuns(targetEntry2.runXml ?? "");
-      if (!targetInspection2 || targetInspection2.revisions.length === 0 || targetInspection2.currentText !== targetEntry2.text) {
-        return operation;
+      let targetRevisionReplayPatch;
+      let targetParagraphMarkRevisionReplayPatch;
+      if (targetEntry2) {
+        const targetInspection2 = inspectDirectParagraphRevisionRuns(targetEntry2.runXml ?? "");
+        if (targetInspection2 && targetInspection2.revisions.length > 0 && targetInspection2.currentText === targetEntry2.text) {
+          const targetAnnotationKeys2 = matchingRevisionAnnotationKeys(targetAnnotations, targetInspection2.revisions, targetPartUri, targetEntry2.trackedChangeAnnotationKeys);
+          if (targetAnnotationKeys2) {
+            for (const key2 of targetAnnotationKeys2)
+              coveredTargetAnnotations.add(key2);
+            changedTrackedXmlReplayed = true;
+            targetRevisionReplayPatch = {
+              targetRevisionReplay: {
+                policy: "preserve-target-revision-set",
+                structuralAction: "insert",
+                originalText: targetInspection2.originalText,
+                revisionWIds: targetInspection2.revisions.map((revision) => revision.wId)
+              }
+            };
+          }
+        }
+        const markResult = paragraphMarkTargetRevisionReplay(targetEntry2, targetAnnotations);
+        if (markResult) {
+          coveredTargetAnnotations.add(markResult.key);
+          changedTrackedXmlReplayed = true;
+          targetParagraphMarkRevisionReplayPatch = { targetParagraphMarkRevisionReplay: markResult.replay };
+        }
       }
-      const targetAnnotationKeys2 = matchingRevisionAnnotationKeys(targetAnnotations, targetInspection2.revisions, targetPartUri, targetEntry2.trackedChangeAnnotationKeys);
-      if (!targetAnnotationKeys2)
+      if (!targetRevisionReplayPatch && !targetParagraphMarkRevisionReplayPatch)
         return operation;
-      for (const key2 of targetAnnotationKeys2)
-        coveredTargetAnnotations.add(key2);
-      changedTrackedXmlReplayed = true;
-      return {
-        ...operation,
-        targetRevisionReplay: {
-          policy: "preserve-target-revision-set",
-          structuralAction: "insert",
-          originalText: targetInspection2.originalText,
-          revisionWIds: targetInspection2.revisions.map((revision) => revision.wId)
-        }
-      };
+      return { ...operation, ...targetRevisionReplayPatch, ...targetParagraphMarkRevisionReplayPatch };
     }
     if (operation.kind === "delete") {
       const baseEntry2 = baseById.get(entityId(operation.blockId));
-      if (!baseEntry2)
-        return operation;
-      const baseInspection2 = inspectDirectParagraphRevisionRuns(baseEntry2.runXml ?? "");
-      if (!baseInspection2 || baseInspection2.revisions.length === 0 || baseInspection2.currentText !== baseEntry2.text) {
-        return operation;
+      let targetRevisionReplayPatch;
+      let targetParagraphMarkRevisionReplayPatch;
+      if (baseEntry2) {
+        const baseInspection2 = inspectDirectParagraphRevisionRuns(baseEntry2.runXml ?? "");
+        if (baseInspection2 && baseInspection2.revisions.length > 0 && baseInspection2.currentText === baseEntry2.text) {
+          const baseAnnotationKeys2 = matchingRevisionAnnotationKeys(baseAnnotations, baseInspection2.revisions, basePartUri, baseEntry2.trackedChangeAnnotationKeys);
+          if (baseAnnotationKeys2) {
+            for (const key2 of baseAnnotationKeys2)
+              coveredBaseAnnotations.add(key2);
+            changedTrackedXmlReplayed = true;
+            targetRevisionReplayPatch = {
+              targetRevisionReplay: {
+                policy: "preserve-target-revision-set",
+                structuralAction: "delete",
+                originalText: baseInspection2.originalText,
+                revisionWIds: baseInspection2.revisions.map((revision) => revision.wId)
+              }
+            };
+          }
+        }
+        const markResult = paragraphMarkTargetRevisionReplay(baseEntry2, baseAnnotations);
+        if (markResult) {
+          coveredBaseAnnotations.add(markResult.key);
+          changedTrackedXmlReplayed = true;
+          targetParagraphMarkRevisionReplayPatch = { targetParagraphMarkRevisionReplay: markResult.replay };
+        }
       }
-      const baseAnnotationKeys2 = matchingRevisionAnnotationKeys(baseAnnotations, baseInspection2.revisions, basePartUri, baseEntry2.trackedChangeAnnotationKeys);
-      if (!baseAnnotationKeys2)
+      if (!targetRevisionReplayPatch && !targetParagraphMarkRevisionReplayPatch)
         return operation;
-      for (const key2 of baseAnnotationKeys2)
-        coveredBaseAnnotations.add(key2);
-      changedTrackedXmlReplayed = true;
-      return {
-        ...operation,
-        targetRevisionReplay: {
-          policy: "preserve-target-revision-set",
-          structuralAction: "delete",
-          originalText: baseInspection2.originalText,
-          revisionWIds: baseInspection2.revisions.map((revision) => revision.wId)
-        }
-      };
+      return { ...operation, ...targetRevisionReplayPatch, ...targetParagraphMarkRevisionReplayPatch };
     }
     const baseEntryId = entityId(operation.blockId);
     const baseEntry = baseById.get(baseEntryId);
@@ -222543,7 +222735,7 @@ function hasTerminalTrackedParagraphDeletion(state, groups, storyPackageOperatio
     if (!index)
       return false;
     return group.bodySteps.some((step2, stepIndex) => {
-      if (step2.kind !== "delete" || step2.targetRevisionReplay !== undefined)
+      if (step2.kind !== "delete" || step2.targetRevisionReplay !== undefined || step2.targetParagraphMarkRevisionReplay !== undefined)
         return false;
       if (isBodyReplayNoteReferenceRemoval(state, group.storyId, step2, storyPackageOperations))
         return false;
@@ -222667,7 +222859,8 @@ function normalizeCompareBodyStep(step2, sectionSteps, referenceSteps, allowedNo
     targetParagraphPropertiesXml,
     targetRunXml,
     replayDependencies: "replayDependencies" in step2 ? step2.replayDependencies : undefined,
-    targetRevisionReplay: "targetRevisionReplay" in step2 ? step2.targetRevisionReplay : undefined
+    targetRevisionReplay: "targetRevisionReplay" in step2 ? step2.targetRevisionReplay : undefined,
+    targetParagraphMarkRevisionReplay: "targetParagraphMarkRevisionReplay" in step2 ? step2.targetParagraphMarkRevisionReplay : undefined
   }, sectionSteps, referenceSteps, allowedNoteReferences, step2.text, baseRunXml, noteMarkerFamily) ? normalized : null;
 }
 function liveCompareBodyRunXml(state, storyId, blockId) {
@@ -223165,8 +223358,8 @@ function runBodyStep(input, storyId, noteId, step2, changeMode, options, pushHis
     if (!hasSuccessor)
       return rejected14(txId, "unsupported-context");
   }
-  if (step2.targetRevisionReplay !== undefined) {
-    if (step2.targetRevisionReplay.structuralAction !== "delete") {
+  if (step2.targetRevisionReplay !== undefined || step2.targetParagraphMarkRevisionReplay !== undefined) {
+    if (step2.targetRevisionReplay !== undefined && step2.targetRevisionReplay.structuralAction !== "delete") {
       return rejected14(txId, "unsupported-context");
     }
     const entry = getStoryParagraphIndexFromState(state, storyId)?.byParaId(step2.blockId);
@@ -223305,7 +223498,10 @@ function prepareTrackedTerminalParagraphDeleteAtState(input) {
 }
 function resolveExactStructuralRevisionDeletion(state, storyId, step2) {
   const replay = step2.targetRevisionReplay;
-  if (!replay || replay.structuralAction !== "delete")
+  const markReplay = step2.targetParagraphMarkRevisionReplay;
+  if (replay !== undefined && replay.structuralAction !== "delete")
+    return null;
+  if (replay === undefined && markReplay === undefined)
     return null;
   const entry = getStoryParagraphIndexFromState(state, storyId)?.byParaId(step2.blockId);
   const bytes = entry ? state.packageBytes.get(entry.partUri) : undefined;
@@ -223313,9 +223509,22 @@ function resolveExactStructuralRevisionDeletion(state, storyId, step2) {
     return null;
   const paraXml = TD59.decode(bytes.subarray(entry.byteStart, entry.byteEnd));
   const wrapper = readParagraphWrapper(paraXml, step2.blockId, bytes, entry.byteStart);
-  const inspection = inspectDirectParagraphRevisionRuns(stripElements(paraXml.slice(wrapper.contentStart, paraXml.lastIndexOf("</")), "pPr"));
-  if (!inspection || inspection.originalText !== replay.originalText || JSON.stringify(inspection.revisions.map((revision) => revision.wId)) !== JSON.stringify(replay.revisionWIds))
-    return null;
+  const runContent = stripElements(paraXml.slice(wrapper.contentStart, paraXml.lastIndexOf("</")), "pPr");
+  if (replay !== undefined && replay.structuralAction === "delete") {
+    const inspection = inspectDirectParagraphRevisionRuns(runContent);
+    if (!inspection || inspection.originalText !== replay.originalText || JSON.stringify(inspection.revisions.map((revision) => revision.wId)) !== JSON.stringify(replay.revisionWIds))
+      return null;
+  } else {
+    const inspection = inspectDirectRunSequence(runContent);
+    if (!inspection || inspection.revisions.length > 0)
+      return null;
+  }
+  if (markReplay !== undefined) {
+    const pPrXml = findFirstElement(paraXml, "pPr")?.xml ?? "";
+    const marker = parseParagraphMarkRevisionMarker(pPrXml);
+    if (!marker || marker.kind !== markReplay.kind || marker.wId !== markReplay.wId || marker.author !== markReplay.author || marker.date !== markReplay.date)
+      return null;
+  }
   const parsedPart = collectXmlElementRanges(TD59.decode(bytes));
   const paragraphCharStart = TD59.decode(bytes.subarray(0, entry.byteStart)).length;
   const paragraphRange = parsedPart.ranges.find((range) => range.start === paragraphCharStart && range.tag.namespaceUri === NS_W && range.tag.localName === "p");
@@ -223330,7 +223539,7 @@ function resolveExactStructuralRevisionDeletion(state, storyId, step2) {
     byteEnd: entry.byteEnd,
     charStart: paragraphRange.start,
     charEnd: paragraphRange.end,
-    revisionWIds: replay.revisionWIds
+    revisionWIds: [...replay?.revisionWIds ?? [], ...markReplay ? [markReplay.wId] : []]
   };
 }
 function runTargetRevisionReplayCommit(input, storyId, step2, options, pushHistory) {
@@ -223458,7 +223667,7 @@ function incomingRevisionIdsCollide(input, targetPartUri, targetStart, targetEnd
       return true;
     if (liveTargetRunXml) {
       const previousOwner = parseTargetRevisionReplayOwner(transferFrom);
-      const previousInspection = previousOwner ? inspectDirectParagraphRevisionRuns(previousOwner.targetRunXml) : null;
+      const previousInspection = previousOwner?.targetRunXml !== undefined ? inspectDirectParagraphRevisionRuns(previousOwner.targetRunXml) : null;
       if (!previousInspection)
         return true;
       for (const { wId } of previousInspection.revisions) {
@@ -223500,7 +223709,7 @@ function transferableInPlaceRevisionReplayOwner(input) {
     return null;
   const previousKey = parseTargetRevisionReplayOwner(previousOwner);
   const nextKey = parseTargetRevisionReplayOwner(input.replayOwner);
-  if (!previousKey || !nextKey || previousKey.partUri !== input.targetPartUri || nextKey.partUri !== input.targetPartUri || previousKey.blockId !== nextKey.blockId || previousKey.targetParagraphPropertiesXml !== nextKey.targetParagraphPropertiesXml || !sameTargetRevisionReplayProvenance(previousKey.targetRevisionReplay, nextKey.targetRevisionReplay))
+  if (!previousKey || !nextKey || previousKey.partUri !== input.targetPartUri || nextKey.partUri !== input.targetPartUri || previousKey.blockId !== nextKey.blockId || previousKey.targetParagraphPropertiesXml !== nextKey.targetParagraphPropertiesXml || !sameTargetRevisionReplayProvenance(previousKey.targetRevisionReplay, nextKey.targetRevisionReplay) || !sameTargetParagraphMarkRevisionReplay(previousKey.targetParagraphMarkRevisionReplay, nextKey.targetParagraphMarkRevisionReplay) || previousKey.targetRunXml === undefined || nextKey.targetRunXml === undefined)
     return null;
   const previousInspection = inspectDirectParagraphRevisionRuns(previousKey.targetRunXml);
   if (!previousInspection || !liveInspection || JSON.stringify(previousInspection) !== JSON.stringify(liveInspection)) {
@@ -223534,7 +223743,7 @@ function transferableRevisionReplayOwner(input) {
   const nextKey = parseTargetRevisionReplayOwner(input.replayOwner);
   if (!previousKey || !nextKey || previousKey.blockId !== nextKey.blockId)
     return null;
-  if (previousKey.targetParagraphPropertiesXml !== nextKey.targetParagraphPropertiesXml || previousKey.targetRunXml !== nextKey.targetRunXml || !sameTargetRevisionReplaySet(previousKey.targetRevisionReplay, nextKey.targetRevisionReplay))
+  if (previousKey.targetParagraphPropertiesXml !== nextKey.targetParagraphPropertiesXml || previousKey.targetRunXml !== nextKey.targetRunXml || !sameTargetRevisionReplaySet(previousKey.targetRevisionReplay, nextKey.targetRevisionReplay) || !sameTargetParagraphMarkRevisionReplay(previousKey.targetParagraphMarkRevisionReplay, nextKey.targetParagraphMarkRevisionReplay))
     return null;
   const previousDeletion = input.scheduledDeletions.find((deletion) => deletion.partUri === previousKey.partUri && deletion.blockId === previousKey.blockId && JSON.stringify(deletion.revisionWIds) === JSON.stringify(input.revisionWIds));
   return previousDeletion && input.revisionWIds.every((id) => previousDeletion.completeLiveCarrierWIds?.includes(id)) ? previousOwner : null;
@@ -223542,21 +223751,24 @@ function transferableRevisionReplayOwner(input) {
 function parseTargetRevisionReplayOwner(owner) {
   try {
     const key2 = JSON.parse(owner);
-    if (!Array.isArray(key2) || key2.length !== 5 || typeof key2[0] !== "string" || typeof key2[1] !== "string" || typeof key2[3] !== "string") {
+    if (!Array.isArray(key2) || key2.length !== 6 || typeof key2[0] !== "string" || typeof key2[1] !== "string" || key2[3] !== null && typeof key2[3] !== "string") {
       return null;
     }
     return {
       partUri: key2[0],
       blockId: key2[1],
       targetParagraphPropertiesXml: key2[2],
-      targetRunXml: key2[3],
-      targetRevisionReplay: key2[4]
+      targetRunXml: key2[3] === null ? undefined : key2[3],
+      targetRevisionReplay: key2[4] === null ? undefined : key2[4],
+      targetParagraphMarkRevisionReplay: key2[5] === null ? undefined : key2[5]
     };
   } catch {
     return null;
   }
 }
 function sameTargetRevisionReplayProvenance(left, right) {
+  if (left === undefined && right === undefined)
+    return true;
   if (!left || typeof left !== "object" || !right || typeof right !== "object")
     return false;
   const leftReplay = left;
@@ -223564,12 +223776,23 @@ function sameTargetRevisionReplayProvenance(left, right) {
   return leftReplay.policy === "preserve-target-revision-set" && rightReplay.policy === "preserve-target-revision-set" && leftReplay.originalText === rightReplay.originalText;
 }
 function sameTargetRevisionReplaySet(left, right) {
+  if (left === undefined && right === undefined)
+    return true;
   if (!sameTargetRevisionReplayProvenance(left, right))
     return false;
   const leftReplay = left;
   const rightReplay = right;
   return Array.isArray(leftReplay.revisionWIds) && Array.isArray(rightReplay.revisionWIds) && JSON.stringify(leftReplay.revisionWIds) === JSON.stringify(rightReplay.revisionWIds);
 }
+function sameTargetParagraphMarkRevisionReplay(left, right) {
+  if (left === undefined && right === undefined)
+    return true;
+  if (!left || typeof left !== "object" || !right || typeof right !== "object")
+    return false;
+  const leftReplay = left;
+  const rightReplay = right;
+  return leftReplay.policy === "preserve-target-paragraph-mark-revision" && rightReplay.policy === "preserve-target-paragraph-mark-revision" && leftReplay.kind === rightReplay.kind && leftReplay.wId === rightReplay.wId && leftReplay.author === rightReplay.author && leftReplay.date === rightReplay.date;
+}
 function applyRevisionReplayOwnershipTransfers(state, transfers) {
   const reservations = state.idReservations.revisionWIds.replayOwners;
   for (const transfer of transfers) {
@@ -223655,22 +223878,36 @@ function targetRevisionReplayOwner(partUri, step2, fallbackParagraphPropertiesXm
     step2.blockId,
     step2.targetParagraphPropertiesXml ?? fallbackParagraphPropertiesXml ?? null,
     step2.targetRunXml,
-    step2.targetRevisionReplay
+    step2.targetRevisionReplay,
+    "targetParagraphMarkRevisionReplay" in step2 ? step2.targetParagraphMarkRevisionReplay : undefined
   ]);
 }
 function prepareExactTargetRevisionInsert(input, partUri, insertByte, step2) {
   const replay = step2.targetRevisionReplay;
-  if (!replay)
+  const markReplay = step2.targetParagraphMarkRevisionReplay;
+  if (!replay && !markReplay)
     return null;
-  if (replay.structuralAction !== "insert" || !step2.targetRunXml)
-    return false;
+  const revisionWIds = [];
+  if (replay !== undefined) {
+    if (replay.structuralAction !== "insert" || !step2.targetRunXml)
+      return false;
+    const inspection = inspectDirectParagraphRevisionRuns(step2.targetRunXml);
+    if (!inspection || inspection.currentText !== step2.text || inspection.originalText !== replay.originalText || JSON.stringify(inspection.revisions.map((revision) => revision.wId)) !== JSON.stringify(replay.revisionWIds))
+      return false;
+    revisionWIds.push(...replay.revisionWIds);
+  }
+  if (markReplay !== undefined) {
+    const marker = parseParagraphMarkRevisionMarker(step2.targetParagraphPropertiesXml ?? "");
+    if (!marker || marker.kind !== markReplay.kind || marker.wId !== markReplay.wId || marker.author !== markReplay.author || marker.date !== markReplay.date)
+      return false;
+    revisionWIds.push(markReplay.wId);
+  }
   const replayOwner = targetRevisionReplayOwner(partUri, step2);
   const ownershipTransfers = [];
-  const inspection = inspectDirectParagraphRevisionRuns(step2.targetRunXml);
-  if (!inspection || inspection.currentText !== step2.text || inspection.originalText !== replay.originalText || JSON.stringify(inspection.revisions.map((revision) => revision.wId)) !== JSON.stringify(replay.revisionWIds) || incomingRevisionIdsCollide(input, partUri, insertByte, insertByte, replay.revisionWIds, replayOwner, ownershipTransfers))
+  if (incomingRevisionIdsCollide(input, partUri, insertByte, insertByte, revisionWIds, replayOwner, ownershipTransfers))
     return false;
   applyRevisionReplayOwnershipTransfers(input.state, ownershipTransfers);
-  for (const wId of replay.revisionWIds)
+  for (const wId of revisionWIds)
     reserveRevisionWIdForReplay(input.state, wId, replayOwner);
   return true;
 }
@@ -358885,6 +359122,10 @@ function trackedChangeAnnotationKeysForParagraph(context, paragraph4) {
   const fragments = getSDDocumentSessionInternalTrackedChangeCatalog(context.session).byPart.get(paragraph4.partUri) ?? [];
   return fragments.filter((fragment3) => fragment3.storyId === paragraph4.storyId && fragment3.sourceByteStart >= paragraph4.byteStart && fragment3.sourceByteEnd <= paragraph4.byteEnd).map(trackedChangeAnnotationKey);
 }
+function structuralChangeAnnotationKeysForParagraph(context, paragraph4) {
+  const fragments = getSDDocumentSessionInternalTrackedChangeCatalog(context.session).structuralByPart.get(paragraph4.partUri) ?? [];
+  return fragments.filter((fragment3) => fragment3.storyId === paragraph4.storyId && (fragment3.sourceByteStart ?? fragment3.byteStart) >= paragraph4.byteStart && (fragment3.sourceByteEnd ?? fragment3.byteEnd) <= paragraph4.byteEnd).map((fragment3) => fragment3.entityKey);
+}
 function projectFieldsReferences(context) {
   const entries = [];
   let ordinal = 0;
@@ -359830,6 +360071,7 @@ function projectStories(context, slots) {
         runSignature: runSignatureByOrdinal.get(p.ordinal),
         runXml,
         trackedChangeAnnotationKeys: trackedChangeAnnotationKeysForParagraph(context, p),
+        structuralChangeAnnotationKeys: structuralChangeAnnotationKeysForParagraph(context, p),
         paragraphPropertiesXml,
         paragraphPropertiesSignature: computeParagraphPropertiesSignature2(paragraphPropertiesXml)
       };
@@ -359915,6 +360157,7 @@ function projectBody(context) {
       runSignature: runSignatures[ordinal],
       runXml,
       trackedChangeAnnotationKeys: trackedChangeAnnotationKeysForParagraph(context, p),
+      structuralChangeAnnotationKeys: structuralChangeAnnotationKeysForParagraph(context, p),
       paragraphPropertiesXml,
       paragraphPropertiesSignature: computeParagraphPropertiesSignature2(paragraphPropertiesXml)
     };
@@ -360139,7 +360382,7 @@ function applyComparePlan(context, plan, options = {}) {
   const appliedFamilySet = new Set;
   if (plan.bodyOperations.length > 0)
     appliedFamilySet.add("body");
-  const appliedTargetRevisionReplay = plan.bodyOperations.some((operation) => ("targetRevisionReplay" in operation) && operation.targetRevisionReplay !== undefined) || storyGroups.some((group) => group.bodySteps.some((step3) => step3.targetRevisionReplay !== undefined));
+  const appliedTargetRevisionReplay = plan.bodyOperations.some((operation) => ("targetRevisionReplay" in operation) && operation.targetRevisionReplay !== undefined || ("targetParagraphMarkRevisionReplay" in operation) && operation.targetParagraphMarkRevisionReplay !== undefined) || storyGroups.some((group) => group.bodySteps.some((step3) => step3.targetRevisionReplay !== undefined || ("targetParagraphMarkRevisionReplay" in step3) && step3.targetParagraphMarkRevisionReplay !== undefined));
   if (appliedTargetRevisionReplay)
     appliedFamilySet.add("tracked-changes");
   for (const group of storyGroups) {
@@ -369817,16 +370060,19 @@ function validateFullDiffApplyConsistency(diff, payload, physicalPlan, canonical
   }
   return problems;
 }
+function hasAnyTargetRevisionReplay(operation) {
+  return "targetRevisionReplay" in operation && operation.targetRevisionReplay !== undefined || "targetParagraphMarkRevisionReplay" in operation && operation.targetParagraphMarkRevisionReplay !== undefined;
+}
 function buildApplyOperationCounts(applyPlan) {
   const counts = new Map;
   let revisionReplayCount = 0;
   if (applyPlan.bodyOperations.length > 0) {
     counts.set("body", applyPlan.bodyOperations.length);
-    revisionReplayCount += applyPlan.bodyOperations.filter((operation) => ("targetRevisionReplay" in operation) && operation.targetRevisionReplay !== undefined).length;
+    revisionReplayCount += applyPlan.bodyOperations.filter(hasAnyTargetRevisionReplay).length;
   }
   for (const group of applyPlan.storyOperations ?? []) {
     counts.set(group.family, (counts.get(group.family) ?? 0) + group.operations.length);
-    revisionReplayCount += group.operations.filter((operation) => ("targetRevisionReplay" in operation) && operation.targetRevisionReplay !== undefined).length;
+    revisionReplayCount += group.operations.filter(hasAnyTargetRevisionReplay).length;
   }
   if (revisionReplayCount > 0)
     counts.set("tracked-changes", revisionReplayCount);
@@ -369837,8 +370083,8 @@ function buildApplyOperationCounts(applyPlan) {
 }
 function setRuntimeBodyOperationCounts(counts, applyPlan, bodyOperations) {
   counts.set("body", bodyOperations.length);
-  const storyRevisionReplayCount = (applyPlan.storyOperations ?? []).reduce((total, group) => total + group.operations.filter((operation) => operation.targetRevisionReplay !== undefined).length, 0);
-  const bodyRevisionReplayCount = bodyOperations.filter((operation) => operation.targetRevisionReplay !== undefined).length;
+  const storyRevisionReplayCount = (applyPlan.storyOperations ?? []).reduce((total, group) => total + group.operations.filter(hasAnyTargetRevisionReplay).length, 0);
+  const bodyRevisionReplayCount = bodyOperations.filter(hasAnyTargetRevisionReplay).length;
   const revisionReplayCount = storyRevisionReplayCount + bodyRevisionReplayCount;
   if (revisionReplayCount > 0)
     counts.set("tracked-changes", revisionReplayCount);
@@ -369886,16 +370132,27 @@ function throwLocalizedBodyCorrespondenceError(sectionSteps, referenceSteps) {
     unsupportedReason: "section-reference-replay-unsafe"
   });
 }
+function paragraphMarkReplayOf(operation) {
+  return operation.kind === "insert" || operation.kind === "insertAtStart" || operation.kind === "delete" ? operation.targetParagraphMarkRevisionReplay : undefined;
+}
 function mergeCanonicalRevisionReplay(derivedOperations, canonicalOperations) {
   return derivedOperations.map((derived) => {
-    const candidates = canonicalOperations.filter((canonical) => sameBodyOperationIdentity(derived, canonical));
+    const candidates = canonicalOperations.filter((canonical2) => sameBodyOperationIdentity(derived, canonical2));
     if (candidates.length !== 1)
       return derived;
-    const replay = candidates[0].targetRevisionReplay;
-    if (replay === undefined || derived.targetRevisionReplay !== undefined)
+    const canonical = candidates[0];
+    const replay = canonical.targetRevisionReplay;
+    const markReplay = paragraphMarkReplayOf(canonical);
+    const wantsReplay = replay !== undefined && derived.targetRevisionReplay === undefined;
+    const wantsMarkReplay = markReplay !== undefined && paragraphMarkReplayOf(derived) === undefined;
+    if (!wantsReplay && !wantsMarkReplay)
       return derived;
-    const merged = { ...derived, targetRevisionReplay: replay };
-    if (derived.kind === "delete" && replay.structuralAction === "delete")
+    const merged = {
+      ...derived,
+      ...wantsReplay ? { targetRevisionReplay: replay } : {},
+      ...wantsMarkReplay ? { targetParagraphMarkRevisionReplay: markReplay } : {}
+    };
+    if (derived.kind === "delete" && (merged.targetRevisionReplay === undefined || merged.targetRevisionReplay.structuralAction === "delete"))
       return merged;
     return validateCompareReplayPayload(merged).ok ? merged : derived;
   });
@@ -370220,8 +370477,9 @@ function findStructurallyUnsupportedOperationFamilies(context, runtimeApplyPlan,
       return bodyStructuralIds.editDelete.has(op.blockId.toUpperCase()) && !localizedReferenceEditIsProtected(op.targetRunXml, referenceSteps) && !(referenceSteps.length === 0 && localizedRetainedFieldEditIsProtected(op.targetRunXml));
     }
     if (op.kind === "delete") {
-      if (op.targetRevisionReplay?.structuralAction === "delete")
+      if (op.targetRevisionReplay?.structuralAction === "delete" || op.targetParagraphMarkRevisionReplay !== undefined) {
         return false;
+      }
       return bodyStructuralIds.editDelete.has(op.blockId.toUpperCase());
     }
     if (op.kind === "formatEdit")
@@ -370251,8 +370509,9 @@ function findStructurallyUnsupportedOperationFamilies(context, runtimeApplyPlan,
         return storyStructuralIds.editDelete.has(op.blockId.toUpperCase());
       }
       if (op.kind === "delete") {
-        if (op.targetRevisionReplay?.structuralAction === "delete")
+        if (op.targetRevisionReplay?.structuralAction === "delete" || op.targetParagraphMarkRevisionReplay !== undefined) {
           return false;
+        }
         return storyStructuralIds.editDelete.has(op.blockId.toUpperCase());
       }
       if (op.kind === "formatEdit")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.3.0-next.13",
+  "version": "1.3.0-next.14",
   "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.16.0-next.13",
+    "@superdoc/sdk": "2.16.0-next.14",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.19.0-next.12",
-    "@superdoc/docx-engine": "0.18.0-next.12",
+    "superdoc": "2.19.0-next.13",
+    "@superdoc/docx-engine": "0.18.0-next.13",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",