@superdoc/mcp 1.10.1-next.1 → 1.10.1-next.2

package/dist/index.js

@@ -31630,7 +31630,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.23.1-next.1";
+var SDK_VERSION = "2.23.1-next.2";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -102156,7 +102156,7 @@ function buildInlineRunPatchSchema() {
     minProperties: 1
   };
 }
-var schemaBooleanOrNull = () => ({
+var CLEAR_INLINE_FORMATTING_KEYS, schemaBooleanOrNull = () => ({
   oneOf: [{ type: "boolean" }, { type: "null" }]
 }), schemaStringOrNull = () => ({
   oneOf: [{ type: "string", minLength: 1 }, { type: "null" }]
@@ -102210,6 +102210,21 @@ var schemaBooleanOrNull = () => ({
 }), INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, INLINE_PROPERTY_KEYS_BY_STORAGE, UNDERLINE_OBJECT_ALLOWED_KEYS, SHADING_ALLOWED_KEYS, BORDER_ALLOWED_KEYS, FIT_TEXT_ALLOWED_KEYS, LANG_ALLOWED_KEYS, RFONTS_ALLOWED_KEYS, EAST_ASIAN_LAYOUT_ALLOWED_KEYS, STYLISTIC_SET_ALLOWED_KEYS, VERT_ALIGN_VALUES, PROPERTY_VALIDATOR_MAP;
 var init_inline_run_patch = __esm(() => {
   init_errors5();
+  CLEAR_INLINE_FORMATTING_KEYS = Object.freeze([
+    "bold",
+    "italic",
+    "underline",
+    "strike",
+    "color",
+    "highlight",
+    "fontFamily",
+    "fontSize",
+    "vertAlign",
+    "smallCaps",
+    "caps",
+    "letterSpacing",
+    "dstrike"
+  ]);
   UNDERLINE_OBJECT_SCHEMA = {
     type: "object",
     properties: {
@@ -214884,7 +214899,8 @@ function commitTracked(input, view) {
       bytes: TE19.encode(ownLinkedRefinement.xml),
       emittedBothSides: false,
       foldedInsRsid: ownLinkedRefinement.rsid,
-      requiresCollaborationSessionSync: true
+      requiresCollaborationSessionSync: true,
+      createdVisibleTextSpan: compileOp.on.coordinateSpace !== "tracked" ? ownLinkedRefinement.createdVisibleTextSpan : undefined
     };
   }
   const canSpanningDelete = compileOp.on.coordinateSpace !== "tracked" && op.newText.length === 0 && compileOp.on.startOffset < compileOp.on.endOffset;
@@ -215144,6 +215160,7 @@ function commitTracked(input, view) {
     author: stamping.author,
     date: stamping.date
   }, compiledCarrier("ins", wId)) : undefined;
+  const createdVisibleTextSpan = localized.createdVisibleTextSpan ?? (isPureTrackedInsert(compileOp) && compileOp.on.coordinateSpace !== "tracked" && (overlapEmittedRsids === null || emittedRsids.includes(insRsid)) ? resolveCreatedTrackedCarrierSpan(localized.bytes, compileOp, wId, insRsid, namespaceBindings) : undefined);
   const shiftParagraphXml = op.on.coordinateSpace === "tracked" ? TD45.decode(bytes.subarray(window2.byteStart, window2.byteEnd)) : null;
   const visibleStartOffset = shiftParagraphXml !== null ? projectTrackedParagraphOffsetToVisible(shiftParagraphXml, op.on.startOffset, inlineModel) : op.on.startOffset;
   const visibleEndOffset = shiftParagraphXml !== null ? projectTrackedParagraphOffsetToVisible(shiftParagraphXml, op.on.endOffset, inlineModel) : op.on.endOffset;
@@ -215255,7 +215272,7 @@ function commitTracked(input, view) {
     }))),
     resyncFromSession,
     requiresCollaborationSessionSync: localized.requiresCollaborationSessionSync,
-    createdVisibleTextSpan: localized.createdVisibleTextSpan,
+    createdVisibleTextSpan,
     pushHistory: input.pushHistory,
     paragraphWindow: counterpartPlan?.ownerParagraphWindow ?? {
       byteStart: byteBase + window2.byteStart,
@@ -216034,6 +216051,27 @@ function isPureTrackedInsert(op) {
 function isCollapsedInsert(op) {
   return op.on.startBlockId === op.on.endBlockId && op.on.startOffset === op.on.endOffset && op.newText.length > 0;
 }
+function resolveCreatedTrackedCarrierSpan(bytes, op, wId, rsid, namespaceBindings = { w: NS_W }) {
+  const model = parseParagraphInlineMap(TD45.decode(bytes), namespaceBindings);
+  const pending2 = [...model.pieces];
+  const carriers = [];
+  while (pending2.length > 0) {
+    const piece = pending2.pop();
+    if (piece.kind === "tracked" && piece.trackedKind === "ins" && piece.revisionId === String(wId) && piece.rsid === rsid)
+      carriers.push(piece);
+    if (piece.kind === "tracked" || piece.kind === "container")
+      pending2.push(...piece.children);
+  }
+  const carrier = carriers.length === 1 ? carriers[0] : undefined;
+  if (!carrier || carrier.visibleStart !== op.on.startOffset || carrier.visibleEnd - carrier.visibleStart !== op.newText.length || model.visibleText().slice(carrier.visibleStart, carrier.visibleEnd) !== op.newText)
+    return;
+  return {
+    startOffset: carrier.visibleStart,
+    endOffset: carrier.visibleEnd,
+    insertedTextLength: carrier.visibleEnd - carrier.visibleStart,
+    source: "new-tracked-carrier"
+  };
+}
 function createCompiledTrackedCarrierReader(bytes, namespaceBindings = { w: NS_W }) {
   let xml;
   let scan;
@@ -218504,7 +218542,9 @@ function refineOwnLinkedInsertion(model, start, end, newText, author, state) {
   if (start === end) {
     const ordinary = selected.find((piece) => !fieldFor(piece));
     const interior = selected.find((piece) => piece.visibleStart < start && piece.visibleEnd > start);
-    const chosen = ordinary ?? interior;
+    const boundaryField = selected.length > 1 ? fieldFor(selected[0]) : undefined;
+    const boundary = boundaryField && selected.every((piece) => fieldFor(piece) === boundaryField) && selected.some((piece) => piece.visibleStart === start && piece.visibleEnd > start) ? selected.find((piece) => piece.visibleStart < start && piece.visibleEnd === start) : undefined;
+    const chosen = ordinary ?? interior ?? boundary;
     if (!chosen)
       return null;
     selected.splice(0, selected.length, chosen);
@@ -218533,7 +218573,16 @@ function refineOwnLinkedInsertion(model, start, end, newText, author, state) {
   let rewritten = paragraphXml;
   for (const patch of patches.reverse())
     rewritten = rewritten.slice(0, patch.start) + patch.xml + rewritten.slice(patch.end);
-  return { xml: rewritten, rsid: wrapper.rsid };
+  return {
+    xml: rewritten,
+    rsid: wrapper.rsid,
+    ...start === end && newText.length > 0 ? { createdVisibleTextSpan: {
+      startOffset: start,
+      endOffset: start + newText.length,
+      insertedTextLength: newText.length,
+      source: "same-author-refinement"
+    } } : {}
+  };
 }
 function spliceWithinSameAuthorInsertion(paragraphXml, startOffset, endOffset, newText, author) {
   const createdVisibleTextSpan = startOffset === endOffset && newText.length > 0 ? {
@@ -283006,6 +283055,7 @@ function applySDDocumentSessionInternalPatchGroup(session, input) {
       internal.onMutationCommitted();
     return receipt3;
   }
+  const historyOwner = input.history ? captureHistoryTextOwner(internal.state, input.forwardPatchGroup) : null;
   const applyResult = applyPatchGroupAtomic(internal.state, input.forwardPatchGroup);
   if (applyResult.status !== "committed") {
     return {
@@ -283027,6 +283077,7 @@ function applySDDocumentSessionInternalPatchGroup(session, input) {
       forwardPatchGroup: applyResult.forwardPatchGroup,
       inversePatchGroup: applyResult.inversePatchGroup,
       semanticDelta: input.history.semanticDelta,
+      textReplayOwner: sealHistoryTextOwner(internal.state, historyOwner, applyResult.inversePatchGroup),
       revisionDeltas: {
         package: {
           previous: applyResult.previousPackageRevision,
@@ -283259,10 +283310,11 @@ function prepareSDDocumentSessionInternalAtomicReview(session, compile) {
     const retiredEntries = [...initialHistory].filter((id) => !state.history.entries.has(id)).map((id) => internal.state.history.entries.get(id)).filter((entry) => !!entry);
     if (entries2.length === 0 && retiredEntries.length === 0)
       return { value, prepared: null };
-    const touched = collectCapturedTouchedParts([...retiredEntries, ...entries2]);
-    const finalParts = snapshotCapturedParts(staging, touched);
-    const originals = snapshotCapturedParts(session, touched);
-    const group = buildCapturedCompositeForwardPatchGroup(session, [...retiredEntries, ...entries2], originals, finalParts);
+    const capturedEntries = [...retiredEntries, ...entries2];
+    const touched = collectCapturedTouchedParts(capturedEntries);
+    const finalParts = snapshotCapturedParts(staging, touched, capturedEntries, "after");
+    const originals = snapshotCapturedParts(session, touched, capturedEntries, "before");
+    const group = buildCapturedCompositeForwardPatchGroup(session, capturedEntries, originals, finalParts);
     if (Object.keys(group.perPart).length === 0)
       return { value, prepared: null };
     const storyIds = group.storiesTouched;
@@ -283332,11 +283384,15 @@ function composeSDDocumentSessionInternalCapturedHistory(session, input) {
     return null;
   const entries2 = requireCapturedHistoryEntries(session, input.txIds);
   const touchedParts = collectCapturedTouchedParts(entries2);
-  const finalParts = snapshotCapturedParts(session, touchedParts);
-  rollbackCapturedHistoryEntries(session, entries2);
-  const originalParts = snapshotCapturedParts(session, touchedParts);
-  for (const txId of input.txIds)
-    deleteSDDocumentSessionInternalHistoryEntry(session, txId);
+  let finalParts;
+  try {
+    finalParts = snapshotCapturedParts(session, touchedParts, entries2, "after");
+  } finally {
+    rollbackCapturedHistoryEntries(session, entries2);
+    for (const txId of input.txIds)
+      deleteSDDocumentSessionInternalHistoryEntry(session, txId);
+  }
+  const originalParts = snapshotCapturedParts(session, touchedParts, entries2, "before");
   const forwardPatchGroup = buildCapturedCompositeForwardPatchGroup(session, entries2, originalParts, finalParts);
   const internal = INTERNALS.get(session);
   const hasSessionChanges = composeSessionHyperlinkHistory(internal.state, entries2.map((entry) => entry.forwardPatchGroup), forwardPatchGroup);
@@ -283380,17 +283436,63 @@ function collectCapturedTouchedParts(entries2) {
   }
   return [...parts];
 }
-function snapshotCapturedParts(session, partUris) {
+function snapshotCapturedParts(session, partUris, entries2, phase) {
   const snapshots = new Map;
   for (const uri of partUris) {
     const bytes = getSDDocumentSessionInternalPartBytes(session, uri);
+    const descriptor = getSDDocumentSessionInternalPartDescriptor(session, uri);
+    if (!bytes && descriptor) {
+      const paragraph = capturedSourceParagraphWindow(entries2, uri, phase);
+      if (!paragraph)
+        throw new Error("Captured source history requires a bounded paragraph.");
+      const index = getStoryParagraphIndexFromState(INTERNALS.get(session).state, paragraph.storyId);
+      const current = index?.byParaId(paragraph.blockId);
+      if (!current || index.duplicateParaIds.has(paragraph.blockId) || current.partUri !== uri || current.byteStart !== paragraph.startByte || current.byteEnd !== paragraph.endByte) {
+        throw new Error("Captured source history requires a current bounded paragraph.");
+      }
+      const range = getSDDocumentSessionInternalPartRange(session, uri, paragraph.startByte, paragraph.endByte);
+      if (!range)
+        throw new Error("Captured source history requires readable bounded paragraph bytes.");
+      snapshots.set(uri, { bytes: range.slice(), contentType: descriptor.contentType, paragraph });
+      continue;
+    }
     snapshots.set(uri, {
       bytes: bytes ? new Uint8Array(bytes) : null,
-      contentType: getSDDocumentSessionInternalPartDescriptor(session, uri)?.contentType ?? null
+      contentType: descriptor?.contentType ?? null
     });
   }
   return snapshots;
 }
+function capturedSourceParagraphWindow(entries2, partUri, phase) {
+  const touching = entries2.filter((entry) => entry.forwardPatchGroup.perPart[partUri]);
+  const stories = uniqueCaptured(touching.flatMap((entry) => entry.forwardPatchGroup.storiesTouched));
+  const first = touching[0]?.forwardPatchGroup.indexRefreshScope?.perPart[partUri];
+  if (stories.length !== 1 || first?.kind !== "paragraph" || first.blockIds?.length !== 1)
+    return null;
+  const blockId = first.blockIds[0];
+  let window2 = first.beforeWindow;
+  for (const entry of touching) {
+    const forward = entry.forwardPatchGroup;
+    const inverse2 = entry.inversePatchGroup;
+    const before = forward.indexRefreshScope?.perPart[partUri];
+    const after = inverse2.indexRefreshScope?.perPart[partUri];
+    for (const [group, scope] of [[forward, before], [inverse2, after]]) {
+      const part2 = group.perPart[partUri];
+      if (scope?.kind !== "paragraph" || scope.blockIds?.length !== 1 || scope.blockIds[0] !== blockId || (scope.directBodyChildDelta ?? 0) !== 0 || (scope.nestedParagraphDelta ?? 0) !== 0 || !Number.isSafeInteger(scope.beforeWindow.startByte) || !Number.isSafeInteger(scope.beforeWindow.endByte) || scope.beforeWindow.startByte < 0 || scope.beforeWindow.endByte <= scope.beforeWindow.startByte || scope.beforeWindow.endByte - scope.beforeWindow.startByte > 512 * 1024 || part2?.kind !== "modify" || part2.patches.length === 0 || part2.patches.some((patch) => patch.kind === "insertBytes" ? patch.atByte < scope.beforeWindow.startByte || patch.atByte > scope.beforeWindow.endByte : patch.startByte < scope.beforeWindow.startByte || patch.endByte > scope.beforeWindow.endByte))
+        return null;
+    }
+    if (before.beforeWindow.startByte !== window2.startByte || before.beforeWindow.endByte !== window2.endByte)
+      return null;
+    const part = forward.perPart[partUri];
+    if (part.kind !== "modify")
+      return null;
+    const delta = part.patches.reduce((sum, patch) => sum + (patch.kind === "deleteBytes" ? 0 : patch.bytes.length) - (patch.kind === "insertBytes" ? 0 : patch.endByte - patch.startByte), 0);
+    if (after.beforeWindow.startByte !== window2.startByte || after.beforeWindow.endByte !== window2.endByte + delta)
+      return null;
+    window2 = after.beforeWindow;
+  }
+  return { storyId: stories[0], blockId, ...phase === "before" ? first.beforeWindow : window2 };
+}
 function rollbackCapturedHistoryEntries(session, entries2) {
   const receipts = [];
   for (let index = entries2.length - 1;index >= 0; index -= 1) {
@@ -283411,6 +283513,7 @@ function buildCapturedCompositeForwardPatchGroup(session, entries2, originalPart
   const preconditions = [];
   const patchMaps = {};
   const perPartBaseRevision = {};
+  const paragraphScopes = {};
   const touchedParts = new Set([...originalParts.keys(), ...finalParts.keys()]);
   for (const partUri of touchedParts) {
     const original = originalParts.get(partUri) ?? {
@@ -283418,12 +283521,32 @@ function buildCapturedCompositeForwardPatchGroup(session, entries2, originalPart
       contentType: null
     };
     const final = finalParts.get(partUri) ?? { bytes: null, contentType: null };
-    if (original.bytes && final.bytes) {
+    if (original.paragraph || final.paragraph) {
+      if (!original.bytes || !final.bytes || !original.paragraph || !final.paragraph || original.paragraph.blockId !== final.paragraph.blockId || original.paragraph.startByte !== final.paragraph.startByte) {
+        throw new Error("Captured source history requires matching bounded paragraph snapshots.");
+      }
+      if (capturedBytesEqual(original.bytes, final.bytes))
+        continue;
+      const { startByte, endByte, blockId } = original.paragraph;
+      perPart[partUri] = { kind: "modify", patches: [
+        { kind: "replaceBytes", order: 0, startByte, endByte, bytes: final.bytes }
+      ] };
+      paragraphScopes[partUri] = { kind: "paragraph", beforeWindow: { startByte, endByte }, blockIds: [blockId] };
+      preconditions.push({
+        kind: "byteWindow",
+        partUri,
+        startByte,
+        endByte,
+        algorithm: "sha256",
+        hash: sha256HexSync(original.bytes)
+      });
+    } else if (original.bytes && final.bytes) {
       if (capturedBytesEqual(original.bytes, final.bytes))
         continue;
+      const paragraph = capturedParagraphComposite(entries2, partUri, original.bytes, final.bytes);
       perPart[partUri] = {
         kind: "modify",
-        patches: [
+        patches: paragraph ? [paragraph.patch] : [
           {
             kind: "replaceBytes",
             order: 0,
@@ -283433,7 +283556,13 @@ function buildCapturedCompositeForwardPatchGroup(session, entries2, originalPart
           }
         ]
       };
-      preconditions.push(capturedByteWindowPrecondition(partUri, original.bytes));
+      if (paragraph)
+        paragraphScopes[partUri] = paragraph.scope;
+      preconditions.push(paragraph ? buildLocalizedByteWindowPrecondition({
+        partUri,
+        bytes: original.bytes,
+        patches: [paragraph.patch]
+      }) : capturedByteWindowPrecondition(partUri, original.bytes));
     } else if (!original.bytes && final.bytes) {
       perPart[partUri] = {
         kind: "create",
@@ -283465,7 +283594,28 @@ function buildCapturedCompositeForwardPatchGroup(session, entries2, originalPart
     perPart,
     patchMaps,
     storiesTouched: uniqueCaptured(entries2.flatMap((entry) => entry.forwardPatchGroup.storiesTouched)),
-    signalLanesToRebuild: uniqueCaptured(entries2.flatMap((entry) => entry.forwardPatchGroup.signalLanesToRebuild))
+    signalLanesToRebuild: uniqueCaptured(entries2.flatMap((entry) => entry.forwardPatchGroup.signalLanesToRebuild)),
+    ...Object.keys(paragraphScopes).length > 0 ? { indexRefreshScope: { perPart: paragraphScopes } } : {}
+  };
+}
+function capturedParagraphComposite(entries2, partUri, original, final) {
+  const touching = entries2.filter((entry) => entry.forwardPatchGroup.perPart[partUri]);
+  const first = touching[0]?.forwardPatchGroup.indexRefreshScope?.perPart[partUri];
+  if (!first || first.kind !== "paragraph" || first.blockIds?.length !== 1)
+    return null;
+  const blockId = first.blockIds[0];
+  if (touching.some((entry) => {
+    const scope = entry.forwardPatchGroup.indexRefreshScope?.perPart[partUri];
+    return entry.forwardPatchGroup.perPart[partUri]?.kind !== "modify" || scope?.kind !== "paragraph" || scope.blockIds?.length !== 1 || scope.blockIds[0] !== blockId || (scope.directBodyChildDelta ?? 0) !== 0 || (scope.nestedParagraphDelta ?? 0) !== 0;
+  }))
+    return null;
+  const { startByte, endByte } = first.beforeWindow;
+  const finalEndByte = endByte + final.length - original.length;
+  if (startByte < 0 || endByte < startByte || endByte > original.length || finalEndByte < startByte || finalEndByte > final.length || !capturedBytesEqual(original.subarray(0, startByte), final.subarray(0, startByte)) || !capturedBytesEqual(original.subarray(endByte), final.subarray(finalEndByte)))
+    return null;
+  return {
+    patch: { kind: "replaceBytes", order: 0, startByte, endByte, bytes: final.subarray(startByte, finalEndByte) },
+    scope: { kind: "paragraph", beforeWindow: { startByte, endByte }, blockIds: [blockId] }
   };
 }
 function invertCapturedSemanticDelta(delta) {
@@ -286161,6 +286311,7 @@ var init_sd_document_session = __esm(() => {
   init_section_margin_update();
   init_session_hyperlink_metadata();
   init_history_text_replay();
+  init_patch_substrate();
   init_history_part_rewrite();
   init_v2_open();
   init_package_open();
@@ -287828,9 +287979,21 @@ var init_address2 = __esm(() => {
 // ../../packages/document-api/src/types/track-changes.types.ts
 var TRACK_CHANGES_IN_ALL = "all";
 
+// ../../packages/document-api/src/inline-semantics/property-ids.ts
+var CORE_PROPERTY_IDS, CORE_PROPERTY_ID_SET, CORE_TOGGLE_PROPERTY_IDS, CORE_TOGGLE_PROPERTY_ID_SET;
+var init_property_ids = __esm(() => {
+  CORE_PROPERTY_IDS = ["bold", "italic", "underline", "strike"];
+  CORE_PROPERTY_ID_SET = new Set(CORE_PROPERTY_IDS);
+  CORE_TOGGLE_PROPERTY_IDS = ["bold", "italic", "strike"];
+  CORE_TOGGLE_PROPERTY_ID_SET = new Set(CORE_TOGGLE_PROPERTY_IDS);
+});
+
 // ../../packages/document-api/src/types/style-policy.types.ts
-var INLINE_DIRECTIVES2, INLINE_DIRECTIVE_SET2;
+var MARK_KEYS, MARK_KEY_SET, INLINE_DIRECTIVES2, INLINE_DIRECTIVE_SET2;
 var init_style_policy_types2 = __esm(() => {
+  init_property_ids();
+  MARK_KEYS = CORE_PROPERTY_IDS;
+  MARK_KEY_SET = CORE_PROPERTY_ID_SET;
   INLINE_DIRECTIVES2 = ["on", "off", "clear"];
   INLINE_DIRECTIVE_SET2 = new Set(INLINE_DIRECTIVES2);
 });
@@ -288326,7 +288489,7 @@ function buildInlineRunPatchSchema2() {
     minProperties: 1
   };
 }
-var schemaBooleanOrNull2 = () => ({
+var CLEAR_INLINE_FORMATTING_KEYS2, schemaBooleanOrNull2 = () => ({
   oneOf: [{ type: "boolean" }, { type: "null" }]
 }), schemaStringOrNull2 = () => ({
   oneOf: [{ type: "string", minLength: 1 }, { type: "null" }]
@@ -288380,6 +288543,21 @@ var schemaBooleanOrNull2 = () => ({
 }), INLINE_PROPERTY_REGISTRY2, INLINE_PROPERTY_KEY_SET2, INLINE_PROPERTY_BY_KEY2, INLINE_PROPERTY_KEYS_BY_STORAGE2, UNDERLINE_OBJECT_ALLOWED_KEYS2, SHADING_ALLOWED_KEYS2, BORDER_ALLOWED_KEYS2, FIT_TEXT_ALLOWED_KEYS2, LANG_ALLOWED_KEYS2, RFONTS_ALLOWED_KEYS2, EAST_ASIAN_LAYOUT_ALLOWED_KEYS2, STYLISTIC_SET_ALLOWED_KEYS2, VERT_ALIGN_VALUES2, PROPERTY_VALIDATOR_MAP2;
 var init_inline_run_patch2 = __esm(() => {
   init_errors6();
+  CLEAR_INLINE_FORMATTING_KEYS2 = Object.freeze([
+    "bold",
+    "italic",
+    "underline",
+    "strike",
+    "color",
+    "highlight",
+    "fontFamily",
+    "fontSize",
+    "vertAlign",
+    "smallCaps",
+    "caps",
+    "letterSpacing",
+    "dstrike"
+  ]);
   UNDERLINE_OBJECT_SCHEMA2 = {
     type: "object",
     properties: {
@@ -412654,7 +412832,7 @@ function isSupportedMutationPlanStepOp(op) {
 var MUTATION_PLAN_ENGINE_SUPPORT, MUTATION_PLAN_SUPPORTED_STEP_OPS, MUTATION_PLAN_MUTATING_STEP_OPS;
 var init_support_contract = __esm(() => {
   MUTATION_PLAN_ENGINE_SUPPORT = Object.freeze({
-    version: "4",
+    version: "5",
     supportedStepOps: Object.freeze([
       "text.rewrite",
       "text.delete",
@@ -412687,6 +412865,9 @@ var init_support_contract = __esm(() => {
     ]),
     unsupported: Object.freeze([
       { cell: "text.rewrite:args.style:custom-policy", reason: "only-native-preserve-style-policy-supported" },
+      { cell: "text.insert.args.style:after-tracked-format-boundary", reason: "projected-insertion-carrier-formatting-not-supported" },
+      { cell: "text.insert.args.style:tracked-formatting-carrier", reason: "direct-inserted-text-formatting-cannot-rewrite-rpr-change" },
+      { cell: "text.insert.args.style:tracked-coordinate-space", reason: "style-patch-requires-visible-inserted-text-selection" },
       { cell: "structural.insert", reason: "structural-slice-not-yet-proven" },
       { cell: "structural.replace:non-block-rich-text-sdt", reason: "only-paragraph-content-block-sdt-replacement-proven" },
       { cell: "structural.replace:tracked", reason: "structural-sdt-replacement-direct-only" },
@@ -427897,7 +428078,7 @@ var init_adapter24 = __esm(() => {
   init_adapter23();
   V2_SUPPORTED_STEP_OPS = MUTATION_PLAN_SUPPORTED_STEP_OPS;
   V2_SUPPORTED_NON_UNIFORM_STRATEGIES = Object.freeze([]);
-  V2_SUPPORTED_SET_MARKS = Object.freeze([]);
+  V2_SUPPORTED_SET_MARKS = MARK_KEYS;
   V2_REGEX_LIMITS = Object.freeze({
     maxPatternLength: SD_TEXT_SEARCH_MAX_REGEX_PATTERN_LENGTH,
     maxExecutionMs: 100
@@ -442935,7 +443116,7 @@ async function compilePlan(context, input) {
       throw error48;
     }
   }
-  detectTargetConflicts(context, steps, failures);
+  detectTargetConflicts(context, steps, failures, changeMode);
   detectUnsupportedRuntimeDrift(input.steps, failures);
   const exactProgram = failures.length === 0 ? compileDescendingExactTargets(context, steps) : undefined;
   if (exactProgram) {
@@ -443505,17 +443686,30 @@ function detectUnsupportedRuntimeDrift(steps, failures) {
     }
   }
 }
-function detectTargetConflicts(context, steps, failures) {
+function detectTargetConflicts(context, steps, failures, changeMode) {
   const claimedByKey = new Map;
   const conflicted = new Set;
   for (const step3 of steps) {
     const resolutions = step3.resolutions ?? (step3.resolution ? [step3.resolution] : []);
+    const requests = step3.requests ?? (step3.request ? [step3.request] : []);
     const currentClaims = [];
-    for (const resolution of resolutions) {
+    for (const [index2, resolution] of resolutions.entries()) {
       const target = resolution.target;
       const key3 = `${storyKeyForTarget(target)}::${target.blockId}`;
       const { from, to } = conflictRangeForResolution(context, step3, resolution);
+      const request = requests[index2];
+      const styledAnchor = request?.kind === "insert" && request.inline && request.text.length > 0 && request.target.start.kind === "text" ? request.target.start.offset : undefined;
       for (const prior of claimedByKey.get(key3) ?? []) {
+        if (prior.trackedInlineFormat && styledAnchor !== undefined && (styledAnchor === prior.to || styledAnchor === 0 && prior.from === 0)) {
+          failures.push({
+            code: "CAPABILITY_UNSUPPORTED",
+            stepId: step3.stepId,
+            phase: "compile",
+            message: "text.insert style changes cannot inherit a carrier formatted by an earlier tracked step."
+          });
+          conflicted.add(step3.stepId);
+          break;
+        }
         if (rangesOverlap12(from, to, prior.from, prior.to)) {
           failures.push({
             code: "PLAN_CONFLICT_OVERLAP",
@@ -443527,11 +443721,17 @@ function detectTargetConflicts(context, steps, failures) {
           break;
         }
       }
-      currentClaims.push({ key: key3, from, to, stepId: step3.stepId });
+      currentClaims.push({
+        key: key3,
+        from,
+        to,
+        stepId: step3.stepId,
+        trackedInlineFormat: changeMode === "tracked" && request?.kind === "format" && !!request.inline
+      });
     }
     for (const claim of currentClaims) {
       const prior = claimedByKey.get(claim.key) ?? [];
-      prior.push({ from: claim.from, to: claim.to, stepId: claim.stepId });
+      prior.push(claim);
       claimedByKey.set(claim.key, prior);
     }
   }
@@ -443673,7 +443873,7 @@ function resolveTargetWhereMutationStep(context, step3, where, story, changeMode
   }
   const selectionMutation = new V2SelectionMutationAdapter(context);
   if (step3.op === "text.insert") {
-    const { text: text4, position: position2 } = readInsertArgs(step3);
+    const { text: text4, position: position2, inline } = readInsertArgs(step3);
     const point3 = position2 === "before" ? target.start : target.end;
     const collapsed = {
       kind: "selection",
@@ -443682,8 +443882,9 @@ function resolveTargetWhereMutationStep(context, step3, where, story, changeMode
       ...target.story ? { story: target.story } : {},
       ...target.coordinateSpace ? { coordinateSpace: target.coordinateSpace } : {}
     };
-    const request = { kind: "insert", target: collapsed, text: text4, ...story ? { in: story } : {} };
-    const receipt3 = selectionMutation.execute({ kind: "insert", target: collapsed, text: text4, ...story ? { in: story } : {} }, { changeMode, dryRun: true });
+    const request = buildInsertCommitRequest(context, collapsed, text4, inline, story);
+    const { inline: _inline, ...dryRunRequest } = request;
+    const receipt3 = selectionMutation.execute(dryRunRequest, { changeMode, dryRun: true });
     if (!receipt3.success)
       throw new DocumentApiValidationError2(receipt3.failure.code, receipt3.failure.message);
     const resolution2 = {
@@ -443837,7 +444038,7 @@ function resolveRefMutationStep(context, step3, story, ref5, changeMode, cache,
     };
   }
   if (step3.op === "text.insert") {
-    const { text: text4, position: position2 } = readInsertArgs(step3);
+    const { text: text4, position: position2, inline } = readInsertArgs(step3);
     const offset = position2 === "before" ? outcome.resolved.startOffset : outcome.resolved.endOffset;
     const storyLocator = outcome.storyLocator;
     const point3 = {
@@ -443858,7 +444059,7 @@ function resolveRefMutationStep(context, step3, story, ref5, changeMode, cache,
       op: "text.insert",
       resolution,
       kernelRange: outcome.resolved,
-      request: { kind: "insert", target: collapsed, text: text4, ...story ? { in: story } : {} },
+      request: buildInsertCommitRequest(context, collapsed, text4, inline, story),
       noopEquivalentText: text4.length === 0 ? text4 : undefined,
       source: step3
     };
@@ -443971,6 +444172,7 @@ async function resolveAllSelectMutationStep(context, step3, where, story, change
     resolutions: coalescedEntries.map((entry) => entry.resolution),
     requests: coalescedEntries.map((entry) => entry.request),
     kernelRanges: coalescedEntries.flatMap((entry) => entry.kernelRange ? [entry.kernelRange] : []),
+    ...step3.op === "text.insert" ? { noopEquivalentText: resolved[0].noopEquivalentText } : {},
     ...step3.op === "text.rewrite" && step3.args.caseHandling !== "preserve-match" && step3.args.replacementMode !== "regex-template" ? { noopEquivalentText: normalizeReplacement(step3.args.replacement) } : {},
     source: step3
   };
@@ -444043,7 +444245,7 @@ function resolveBlockMutationStep(context, step3, where, story) {
     };
   }
   if (step3.op === "text.insert") {
-    const { text: text4, position: position2 } = readInsertArgs(step3);
+    const { text: text4, position: position2, inline } = readInsertArgs(step3);
     const offset = position2 === "before" ? 0 : raw.textLength;
     const point3 = {
       kind: "text",
@@ -444071,7 +444273,7 @@ function resolveBlockMutationStep(context, step3, where, story) {
       stepId: step3.id,
       op: "text.insert",
       resolution: collapsedResolution,
-      request: { kind: "insert", target: collapsed, text: text4, ...story ? { in: story } : {} },
+      request: buildInsertCommitRequest(context, collapsed, text4, inline, story),
       noopEquivalentText: text4.length === 0 ? text4 : undefined,
       source: step3
     };
@@ -444141,7 +444343,7 @@ function resolveRangeRefMutationStep(context, step3, story, ref5) {
     };
   }
   if (step3.op === "text.insert") {
-    const { text: text4, position: position2 } = readInsertArgs(step3);
+    const { text: text4, position: position2, inline } = readInsertArgs(step3);
     const offset = position2 === "before" ? target.range.start : target.range.end;
     const point3 = {
       kind: "text",
@@ -444160,7 +444362,7 @@ function resolveRangeRefMutationStep(context, step3, story, ref5) {
       stepId: step3.id,
       op: "text.insert",
       resolution,
-      request: { kind: "insert", target: collapsed, text: text4, ...story ? { in: story } : {} },
+      request: buildInsertCommitRequest(context, collapsed, text4, inline, story),
       noopEquivalentText: text4.length === 0 ? text4 : undefined,
       source: step3
     };
@@ -444362,12 +444564,36 @@ function commitRequest(selectionMutation, paragraphs2, controls, request, change
     };
   }
   if (request.kind === "insert") {
-    return selectionMutation.execute({
+    const receipt3 = selectionMutation.execute({
       kind: "replace",
       target: request.target,
       text: request.text,
       ...request.in ? { in: request.in } : {}
     }, { changeMode });
+    if (!receipt3.success || !request.inline)
+      return receipt3;
+    const insertedText = receipt3.effects?.insertedText;
+    if (!insertedText?.length || insertedText.some((effect) => !effect.selectionTarget)) {
+      return {
+        success: false,
+        failure: {
+          code: "CAPABILITY_UNSUPPORTED",
+          message: "text.insert style requires an exact inserted-text selection."
+        },
+        resolution: receipt3.resolution
+      };
+    }
+    for (const effect of insertedText) {
+      const formatted = selectionMutation.execute({
+        kind: "format",
+        target: effect.selectionTarget,
+        inline: request.inline,
+        ...request.in ? { in: request.in } : {}
+      }, { changeMode: "direct" });
+      if (!formatted.success && formatted.failure.code !== "NO_OP")
+        return formatted;
+    }
+    return receipt3;
   }
   if ("target" in request) {
     return selectionMutation.execute({
@@ -444534,14 +444760,64 @@ function readInsertArgs(step3) {
   if (position2 !== "before" && position2 !== "after") {
     throw new DocumentApiValidationError2("INVALID_INPUT", 'text.insert requires args.position to be "before" or "after".');
   }
-  if (step3.args?.style !== undefined) {
-    throw new DocumentApiValidationError2("CAPABILITY_UNSUPPORTED", "v2 text.insert plan steps do not yet support args.style.");
-  }
+  const inline = readInsertInlinePatch(step3.args?.style);
   const text4 = step3.args?.content?.text;
   if (typeof text4 !== "string") {
     throw new DocumentApiValidationError2("INVALID_INPUT", "text.insert requires args.content.text.");
   }
-  return { text: text4, position: position2 };
+  return { text: text4, position: position2, inline };
+}
+function readInsertInlinePatch(style) {
+  if (style === undefined)
+    return;
+  if (!style || typeof style !== "object" || Array.isArray(style) || Object.keys(style).some((key3) => key3 !== "inline")) {
+    throw new DocumentApiValidationError2("INVALID_INPUT", "text.insert args.style requires an inline policy.");
+  }
+  const inline = style.inline;
+  if (!inline || typeof inline !== "object" || Array.isArray(inline) || Object.keys(inline).some((key3) => key3 !== "mode" && key3 !== "setMarks")) {
+    throw new DocumentApiValidationError2("INVALID_INPUT", "text.insert args.style.inline requires mode and optional setMarks.");
+  }
+  const { mode, setMarks } = inline;
+  if (mode !== "inherit" && mode !== "set" && mode !== "clear") {
+    throw new DocumentApiValidationError2("INVALID_INPUT", 'text.insert args.style.inline.mode must be "inherit", "set", or "clear".');
+  }
+  const patch = mode === "clear" ? Object.fromEntries(CLEAR_INLINE_FORMATTING_KEYS2.map((key3) => [key3, null])) : {};
+  if (setMarks !== undefined) {
+    if (!setMarks || typeof setMarks !== "object" || Array.isArray(setMarks)) {
+      throw new DocumentApiValidationError2("INVALID_INPUT", "text.insert args.style.inline.setMarks must be an object.");
+    }
+    for (const [key3, directive] of Object.entries(setMarks)) {
+      if (!MARK_KEY_SET.has(key3) || typeof directive !== "string" || !INLINE_DIRECTIVE_SET2.has(directive)) {
+        throw new DocumentApiValidationError2("INVALID_INPUT", `Invalid text.insert setMarks directive for "${key3}".`);
+      }
+      patch[key3] = directive === "on" ? true : directive === "off" ? false : null;
+    }
+  }
+  return Object.keys(patch).length > 0 ? patch : undefined;
+}
+function buildInsertCommitRequest(context, target, text4, inline, story) {
+  if (text4.length > 0 && inline && target.coordinateSpace === "tracked") {
+    throw new DocumentApiValidationError2("CAPABILITY_UNSUPPORTED", "text.insert style changes require visible coordinates for an exact inserted-text selection.");
+  }
+  if (text4.length > 0 && inline && target.start.kind === "text") {
+    const index2 = paragraphIndexForRangeRef(context, target.story ?? story);
+    const entry = index2.byParaId(target.start.blockId);
+    const bytes = entry && getSDDocumentSessionInternalPartRange(context.session, entry.partUri, entry.byteStart, entry.byteEnd);
+    if (!bytes) {
+      throw new DocumentApiValidationError2("PRECONDITION_FAILED", "Insertion carrier bytes are unavailable.");
+    }
+    const paragraphXml = TD133.decode(bytes);
+    if (/<(?:[\w.-]+:)?rPrChange\b/.test(paragraphXml)) {
+      const namespaces = getSDDocumentSessionInternalMainStoryRootNamespaceBindings(context.session) ?? {};
+      const at = target.start.offset;
+      const planned = planDirectInlineEdit(bytes, at, at, text4, undefined, undefined, namespaces);
+      const properties2 = planned.ok && planned.runPropertiesXml !== undefined ? [planned.runPropertiesXml] : parseParagraphInlineMap(paragraphXml, namespaces).leaves().flatMap((piece) => (piece.kind === "text" && piece.textRole === "visible" || piece.kind === "control" && !piece.deleted) && piece.visibleStart <= at && at <= piece.visibleEnd ? [piece.runProperties ?? ""] : []);
+      if (properties2.some((value3) => /<(?:[\w.-]+:)?rPrChange\b/.test(value3))) {
+        throw new DocumentApiValidationError2("CAPABILITY_UNSUPPORTED", "text.insert style changes do not support insertion carriers with tracked formatting changes.");
+      }
+    }
+  }
+  return { kind: "insert", target, text: text4, ...inline ? { inline } : {}, ...story ? { in: story } : {} };
 }
 function normalizeReplacement(replacement2) {
   if (!replacement2 || typeof replacement2.text !== "string" && !Array.isArray(replacement2.blocks)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.10.1-next.1",
+  "version": "1.10.1-next.2",
   "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.23.1-next.1",
+    "@superdoc/sdk": "2.23.1-next.2",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.26.1-next.1",
-    "@superdoc/docx-engine": "0.25.1-next.1",
+    "superdoc": "2.26.1-next.2",
+    "@superdoc/docx-engine": "0.25.1-next.2",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",