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

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.13";
+var SDK_VERSION = "2.20.0-next.14";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -202834,6 +202834,18 @@ function commitTracked(input, view) {
     newText: op.newText,
     allocateWIdBlock: allocateLocalizedWIdBlock
   }, inlineContext, namespaceBindings);
+  const refinementStart = compileOp.on.coordinateSpace === "tracked" ? projectTrackedParagraphOffsetToVisible(paragraphXml, compileOp.on.startOffset) : compileOp.on.startOffset;
+  const refinementEnd = compileOp.on.coordinateSpace === "tracked" ? projectTrackedParagraphOffsetToVisible(paragraphXml, compileOp.on.endOffset) : compileOp.on.endOffset;
+  const ownLinkedRefinement = refinementStart !== null && refinementEnd !== null ? refineOwnLinkedInsertion(inlineModel, refinementStart, refinementEnd, op.newText, stamping.author, state) : null;
+  if (ownLinkedRefinement) {
+    localized = {
+      ok: true,
+      bytes: TE17.encode(ownLinkedRefinement.xml),
+      emittedBothSides: false,
+      foldedInsRsid: ownLinkedRefinement.rsid,
+      requiresCollaborationSessionSync: true
+    };
+  }
   const canSpanningDelete = compileOp.on.coordinateSpace !== "tracked" && op.newText.length === 0 && compileOp.on.startOffset < compileOp.on.endOffset;
   const spanningDeleteWIds = [];
   let usedSpanningDelete = false;
@@ -202971,6 +202983,17 @@ function commitTracked(input, view) {
     },
     primaryBytes: localized.bytes,
     rewrite: (paragraphBytes2, paragraphWindow) => {
+      if (ownLinkedRefinement) {
+        const counterpartXml = TD42.decode(paragraphBytes2.subarray(paragraphWindow.byteStart, paragraphWindow.byteEnd));
+        const refinement = refineOwnLinkedInsertion(parseParagraphInlineMap(counterpartXml, namespaceBindings), refinementStart, refinementEnd, op.newText, stamping.author, state);
+        return refinement ? {
+          ok: true,
+          bytes: TE17.encode(refinement.xml),
+          emittedBothSides: false,
+          foldedInsRsid: refinement.rsid,
+          requiresCollaborationSessionSync: true
+        } : { ok: false, reason: "textbox-counterpart-ambiguous" };
+      }
       let additionalWIdIndex = 0;
       const base2 = rewriteLocalizedTracked(paragraphBytes2, paragraphWindow, compileOp, {
         rsid: op.rsid,
@@ -206222,6 +206245,80 @@ function containsOnlyTrackedWrappersAndZeroWidth(xml) {
     return false;
   return containsOnlyZeroWidthParagraphTail(withoutWrappers);
 }
+function refineOwnLinkedInsertion(model, start, end, newText, author, state) {
+  if (newText.includes("\t"))
+    return null;
+  const wrapper = model.pieces.find((piece) => piece.kind === "tracked" && piece.trackedKind === "ins" && piece.visibleStart <= start && piece.visibleEnd >= end);
+  if (!wrapper || wrapper.kind !== "tracked" || !wrapper.children.some((piece) => piece.kind === "container" && piece.containerKind === "complexField") || !wrapper.rsid || !collectSessionCreatedTrackedChangeRsids(state).has(wrapper.rsid) || wrapper.revisionId === null || !collectSessionCreatedTrackedChangeWIds(state).has(Number(wrapper.revisionId)) || classifyInsertionAuthoringOwnership(buildReviewIdentity(author), buildReviewIdentity({
+    name: wrapper.author,
+    email: wrapper.email,
+    initials: wrapper.initials
+  })) !== "same-user")
+    return null;
+  const fields = [];
+  const texts = [];
+  for (const child of wrapper.children) {
+    if (child.kind === "text" && child.textRole === "visible")
+      texts.push(child);
+    else if (child.kind === "container" && child.containerKind === "complexField" && child.resultCharStart !== undefined) {
+      const instructions = child.children.filter((piece) => piece.kind === "text" && piece.textRole === "instruction");
+      if (!/^HYPERLINK\s/i.test(instructions.map((piece) => piece.kind === "text" ? piece.decodedText : "").join("").trim()))
+        return null;
+      for (const piece of child.children) {
+        if (piece.kind === "text") {
+          if (piece.textRole === "visible")
+            texts.push(piece);
+          else if (piece.textRole !== "instruction")
+            return null;
+        } else if (piece.kind !== "marker" || piece.role !== "field")
+          return null;
+      }
+      fields.push(child);
+    } else
+      return null;
+  }
+  if (!fields.length)
+    return null;
+  const paragraphXml = model.paragraphXml;
+  if (start === wrapper.visibleStart && end === wrapper.visibleEnd && newText === "") {
+    return { xml: paragraphXml.slice(0, wrapper.charStart) + paragraphXml.slice(wrapper.charEnd), rsid: wrapper.rsid };
+  }
+  const selected = start === end ? texts.filter((piece) => piece.visibleStart <= start && piece.visibleEnd >= start) : texts.filter((piece) => piece.visibleStart < end && piece.visibleEnd > start);
+  const fieldFor = (piece) => fields.find((field2) => piece.charStart >= field2.resultCharStart && piece.charEnd <= field2.resultCharEnd);
+  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;
+    if (!chosen)
+      return null;
+    selected.splice(0, selected.length, chosen);
+  }
+  const first = selected[0];
+  const last = selected.at(-1);
+  if (!first || !last || first.visibleStart > start || last.visibleEnd < end)
+    return null;
+  const field = fieldFor(first);
+  if (selected.some((piece) => fieldFor(piece) !== field))
+    return null;
+  const patches = [];
+  for (const [index, piece] of selected.entries()) {
+    const tag = /^<([\w.-]+):t\b([^>]*)>[\s\S]*?<\/\1:t>$/.exec(piece.rawXml);
+    if (!tag)
+      return null;
+    const localStart = Math.max(0, start - piece.visibleStart);
+    const localEnd = Math.min(piece.decodedText.length, end - piece.visibleStart);
+    const text = piece.decodedText.slice(0, localStart) + (index === 0 ? newText : "") + piece.decodedText.slice(localEnd);
+    patches.push({
+      start: piece.charStart,
+      end: piece.charEnd,
+      xml: `<${tag[1]}:t${preserveTextElementAttributes(tag[2], text)}>${escapeXmlText(text)}</${tag[1]}:t>`
+    });
+  }
+  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 };
+}
 function spliceWithinSameAuthorInsertion(paragraphXml, startOffset, endOffset, newText, author) {
   const createdVisibleTextSpan = startOffset === endOffset && newText.length > 0 ? {
     startOffset,
@@ -207290,7 +207387,7 @@ function isolateSimpleTextRangeInParagraphXml(input) {
   if (input.rangeStart < 0 || input.rangeEnd <= input.rangeStart) {
     return { ok: false, reason: "invalid-range" };
   }
-  const contextualRejection = rejectSimpleTextRangeContext(input.paragraphXml, input.rangeStart, input.rangeEnd, input.allowDisjointTracked ?? false);
+  const contextualRejection = rejectSimpleTextRangeContext(input.paragraphXml, input.rangeStart, input.rangeEnd, input.allowDisjointTracked ?? false, input.allowDisjointFields ?? false);
   if (contextualRejection)
     return { ok: false, reason: contextualRejection };
   const paragraphOpen = /^<([\w.-]+):p\b[^>]*>/.exec(input.paragraphXml);
@@ -207303,7 +207400,7 @@ function isolateSimpleTextRangeInParagraphXml(input) {
   }
   const runs = [];
   const runRe = /<([\w.-]+):r\b[^>]*>[\s\S]*?<\/\1:r>/g;
-  const ordinaryRunStarts = input.allowDisjointTracked ? new Map : null;
+  const ordinaryRunStarts = input.allowDisjointTracked || input.allowDisjointFields ? new Map : null;
   if (ordinaryRunStarts) {
     for (const piece of parseParagraphInlineMap(input.paragraphXml).leaves()) {
       if (piece.kind === "text" && piece.textRole === "visible" && piece.containerStack.length === 0 && !ordinaryRunStarts.has(piece.runCharStart)) {
@@ -207378,9 +207475,11 @@ function renderSimpleTextRunSlice(slice, options = {}) {
   }).join("");
   return `${slice.runOpenTag}${options.rPrXml ?? slice.rPrXml}${textXml}${slice.runCloseTag}`;
 }
-function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowDisjointTracked) {
-  if (/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(paragraphXml))
-    return "field";
+function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowDisjointTracked, allowDisjointFields) {
+  if (/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(paragraphXml)) {
+    if (!allowDisjointFields || !hasOnlyDisjointFields(paragraphXml, rangeStart, rangeEnd))
+      return "field";
+  }
   if (/<[\w.-]+:(?:commentRangeStart|commentRangeEnd|commentReference)\b/.test(paragraphXml)) {
     return "comment";
   }
@@ -207402,6 +207501,34 @@ function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowD
     return "drawing";
   return null;
 }
+function hasOnlyDisjointFields(paragraphXml, rangeStart, rangeEnd) {
+  const fields = [];
+  function visit(pieces) {
+    for (const piece of pieces) {
+      if (piece.kind !== "container")
+        continue;
+      if (piece.containerKind === "complexField" || piece.containerKind === "fldSimple") {
+        if (rangeStart < piece.visibleEnd && rangeEnd > piece.visibleStart)
+          return false;
+        if (piece.containerKind === "complexField" && piece.resultCharStart === undefined)
+          return false;
+        fields.push({ start: piece.charStart, end: piece.charEnd });
+      } else if (!visit(piece.children))
+        return false;
+    }
+    return true;
+  }
+  if (!visit(parseParagraphInlineMap(paragraphXml).pieces))
+    return false;
+  let outsideFields = "";
+  let cursor = 0;
+  for (const field of fields) {
+    outsideFields += paragraphXml.slice(cursor, field.start);
+    cursor = field.end;
+  }
+  outsideFields += paragraphXml.slice(cursor);
+  return !/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(outsideFields);
+}
 function hasTrackedOverlap(pieces, rangeStart, rangeEnd) {
   for (const piece of pieces) {
     if (piece.kind === "tracked" && rangeStart < piece.visibleEnd && rangeEnd > piece.visibleStart) {
@@ -247417,6 +247544,80 @@ function runHyperlinkWrapCommit(input) {
   if (!bytes)
     return rejected19(input.txId, "hyperlink-target-not-found");
   const paraXml = TD71.decode(bytes.subarray(paragraph.byteStart, paragraph.byteEnd));
+  const overlappingInsertions = parseParagraphInlineMap(paraXml).pieces.filter((piece) => piece.kind === "tracked" && piece.trackedKind === "ins" && piece.visibleStart < op.on.endOffset && piece.visibleEnd > op.on.startOffset);
+  if (overlappingInsertions.length > 0) {
+    if (overlappingInsertions.length !== 1)
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    const insertion = overlappingInsertions[0];
+    const revisionId = Number(insertion.revisionId);
+    if (insertion.visibleStart > op.on.startOffset || insertion.visibleEnd < op.on.endOffset || !Number.isSafeInteger(revisionId) || !collectSessionCreatedTrackedChangeWIds(input.state).has(revisionId) || !insertion.rsid || !collectSessionCreatedTrackedChangeRsids(input.state).has(insertion.rsid) || classifyInsertionAuthoringOwnership(buildReviewIdentity(stamping.author), buildReviewIdentity({ name: insertion.author, email: insertion.email, initials: insertion.initials })) !== "same-user")
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    const textbox = input.state.textboxRegistry.byStoryId.get(op.on.storyId);
+    if (textbox && textbox.alternateContentCounterparts.length > 1) {
+      return rejected19(input.txId, "hyperlink-text-range-unsupported");
+    }
+    const openingEnd = paraXml.indexOf(">", insertion.charStart) + 1;
+    const closingStart = paraXml.lastIndexOf("</", insertion.charEnd);
+    if (openingEnd <= insertion.charStart || closingStart < openingEnd) {
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    }
+    const innerXml = paraXml.slice(openingEnd, closingStart);
+    const isolatedInner = isolateSimpleTextRangeInParagraphXml({
+      paragraphXml: `<w:p>${innerXml}</w:p>`,
+      rangeStart: op.on.startOffset - insertion.visibleStart,
+      rangeEnd: op.on.endOffset - insertion.visibleStart,
+      allowDisjointFields: true
+    });
+    if (!isolatedInner.ok)
+      return rejected19(input.txId, mapSimpleTextRangeIsolationReason(isolatedInner.reason));
+    const selectedRuns = isolatedInner.value.selectedRuns.map((run) => renderSimpleTextRunSlice(run, { rPrXml: ensureHyperlinkRunStyle(run, characterStyleId) })).join("");
+    const generatedReplacementXml = isolatedInner.value.beforeRunXml + buildHyperlinkFieldRunsXml({ target: op.target, metadata: op.metadata, resultRunsXml: selectedRuns }) + isolatedInner.value.afterRunXml;
+    const replacementStart = openingEnd + isolatedInner.value.replaceStart - "<w:p>".length;
+    const replacementEnd = openingEnd + isolatedInner.value.replaceEnd - "<w:p>".length;
+    const replacementByteStart = paragraph.byteStart + utf8ByteLength6(paraXml, replacementStart);
+    const replacementXml2 = closeNamespaceScope(generatedReplacementXml, {
+      w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+      r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+    }, namespaceBindingsAtPosition(bytes, replacementByteStart), { referencedOnly: true });
+    if (replacementXml2 === null)
+      return rejected19(input.txId, "hyperlink-text-range-unsupported");
+    const documentPatches2 = [{
+      kind: "replaceBytes",
+      order: 0,
+      startByte: replacementByteStart,
+      endByte: paragraph.byteStart + utf8ByteLength6(paraXml, replacementEnd),
+      bytes: TE38.encode(replacementXml2)
+    }];
+    const perPart2 = {
+      [paragraph.partUri]: { kind: "modify", patches: documentPatches2 },
+      ...styleDependencies.value.perPart
+    };
+    return finalize6({
+      input,
+      storyId: op.on.storyId,
+      storyPartUri: paragraph.partUri,
+      sessionEffects: [{ after: compilerHyperlinkCarrier(paragraph.partUri, replacementByteStart, replacementXml2, true) }],
+      perPart: perPart2,
+      preconditions: [
+        buildLocalizedByteWindowPrecondition({ partUri: paragraph.partUri, bytes, patches: documentPatches2 }),
+        ...styleDependencies.value.preconditions
+      ],
+      extraPatchMaps: {},
+      createdRefs: [],
+      updatedRefs: [
+        { kind: "trackedChange", entityId: insertion.rsid, storyId: op.on.storyId },
+        { kind: "block", nodeId: op.on.paraId, storyId: op.on.storyId },
+        { kind: "text", storyId: op.on.storyId, blockId: op.on.paraId, range: { start: op.on.startOffset, end: op.on.endOffset } }
+      ],
+      indexRefreshScope: {
+        perPart: { [paragraph.partUri]: {
+          beforeWindow: { startByte: paragraph.byteStart, endByte: paragraph.byteEnd },
+          kind: "paragraph",
+          blockIds: [op.on.paraId]
+        } }
+      }
+    });
+  }
   const isolated = isolateSimpleTextRangeInParagraphXml({
     paragraphXml: paraXml,
     rangeStart: op.on.startOffset,
@@ -247970,6 +248171,9 @@ function buildHyperlinkRunXml(input) {
   return `<w:hyperlink${attrSegment}>` + runXml + `</w:hyperlink>`;
 }
 function buildTrackedHyperlinkFieldXml(input) {
+  return buildInsOpenTag2(input.stamp) + buildHyperlinkFieldRunsXml(input) + "</w:ins>";
+}
+function buildHyperlinkFieldRunsXml(input) {
   const instruction = buildHyperlinkFieldInstruction({
     href: input.target.kind === "external" ? input.target.url : undefined,
     anchor: input.target.kind === "anchor" ? input.target.anchor : undefined,
@@ -247977,7 +248181,7 @@ function buildTrackedHyperlinkFieldXml(input) {
     tooltip: input.metadata?.tooltip,
     targetFrame: input.metadata?.targetFrame
   });
-  return buildInsOpenTag2(input.stamp) + '<w:r><w:fldChar w:fldCharType="begin"/></w:r>' + `<w:r><w:instrText>${escapeText(instruction)}</w:instrText></w:r>` + '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' + input.resultRunsXml + '<w:r><w:fldChar w:fldCharType="end"/></w:r>' + "</w:ins>";
+  return '<w:r><w:fldChar w:fldCharType="begin"/></w:r>' + `<w:r><w:instrText>${escapeText(instruction)}</w:instrText></w:r>` + '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' + input.resultRunsXml + '<w:r><w:fldChar w:fldCharType="end"/></w:r>';
 }
 function buildDefaultHyperlinkResultRunXml(text, characterStyleId) {
   return `<w:r><w:rPr><w:rStyle w:val="${escapeAttr7(characterStyleId)}"/></w:rPr><w:t xml:space="preserve">${escapeText(text)}</w:t></w:r>`;
@@ -248120,7 +248324,7 @@ function finalize6(args) {
     backendExtensions: {
       storySurface: {
         family: "storyHyperlink",
-        storyLocal: opFromInput.kind === "hyperlinkWrap",
+        storyLocal: opFromInput.kind === "hyperlinkWrap" && Object.keys(args.perPart).every((partUri) => partUri === args.storyPartUri),
         changeMode: opFromInput.kind === "hyperlinkInsert" || opFromInput.kind === "hyperlinkWrap" ? opFromInput.changeMode ?? "direct" : "direct",
         targetBlockIds: args.updatedRefs.flatMap((ref3) => ref3.kind === "block" ? [ref3.nodeId] : []),
         atomCarrierContract: SD_DEFAULT_ATOM_CARRIER_CONTRACT
@@ -248178,8 +248382,10 @@ var init_compile_hyperlink_ops = __esm(() => {
   init_tracked_hyperlink_target();
   init_tracked_hyperlink_removal();
   init_xml_namespace_scope();
+  init_paragraph_inline_model();
   init_paragraph_para_id_attrs();
   init_revision_wid_allocator();
+  init_export_projection();
   init_semantic_style_dependencies();
   init_simple_text_run_split();
   TD71 = new TextDecoder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.7.0-next.13",
+  "version": "1.7.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.20.0-next.13",
+    "@superdoc/sdk": "2.20.0-next.14",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.23.0-next.13",
-    "@superdoc/docx-engine": "0.22.0-next.13",
+    "superdoc": "2.23.0-next.14",
+    "@superdoc/docx-engine": "0.22.0-next.14",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",