@superdoc/mcp 1.4.0-next.2 → 1.4.0-next.3

package/dist/index.js

@@ -31330,7 +31330,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.17.0-next.2";
+var SDK_VERSION = "2.17.0-next.3";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { chmodSync, existsSync } from "node:fs";
@@ -272984,6 +272984,13 @@ var init_source = __esm(() => {
     };
   }));
   V2_ONLY_ADAPTER_METHODS = Object.freeze([
+    {
+      method: "createDocumentApi(host.adapter).fields.contextAtPosition",
+      stability: "internal",
+      workerWired: true,
+      relatedV1Operation: null,
+      rationale: "Resolve a clicked field result to its canonical address and rebuild availability for the context menu."
+    },
     {
       method: "createDocumentApi(host.adapter).format.readEffectiveInlineUniformity",
       stability: "internal",
@@ -287507,6 +287514,17 @@ function readDescriptorXml(context, entry) {
     return null;
   return TD81.decode(bytes.subarray(entry.descriptor.byteStart, entry.descriptor.byteEnd));
 }
+function buildFieldTextResultXml(context, entry, text) {
+  if (!entry.descriptor.complete)
+    return null;
+  const bytes = readPartBytes2(context, entry.partUri);
+  if (!bytes)
+    return null;
+  const { byteStart, byteEnd, resultByteStart, resultByteEnd } = entry.descriptor;
+  if (resultByteStart < byteStart || resultByteEnd > byteEnd || resultByteStart > resultByteEnd)
+    return null;
+  return TD81.decode(bytes.subarray(byteStart, resultByteStart)) + buildTextRunXml(text) + TD81.decode(bytes.subarray(resultByteEnd, byteEnd));
+}
 function buildSimpleFieldXml(instruction, resultText) {
   return `<w:fldSimple w:instr="${xmlEscapeAttr(instruction)}">` + buildTextRunXml(resultText) + "</w:fldSimple>";
 }
@@ -342647,6 +342665,43 @@ class V2FieldsAdapter {
     this.context = context;
     this.scalarSnapshot = scalarSnapshot;
   }
+  contextAtPosition(input) {
+    throwProjectionReadFailure(this.context, "fields.contextAtPosition");
+    if (!input || !input.story || !Number.isInteger(input.offset) || input.offset < 0 || !input.blockId)
+      return null;
+    const story = this.context.resolveFullStoryLocator(input.story);
+    if ("error" in story)
+      return null;
+    const entries = listCanonicalFieldEntries(this.context).filter((entry2) => {
+      const bounds = story.storyByteRange;
+      return entry2.storyId === story.storyId && entry2.blockId === input.blockId && (!bounds || entry2.descriptor.byteStart >= bounds[0] && entry2.descriptor.byteEnd <= bounds[1]);
+    });
+    const reference = input.reference;
+    if (reference && (typeof reference.instruction !== "string" || typeof reference.empty !== "boolean"))
+      return null;
+    const candidates = entries.flatMap((entry2) => {
+      if (reference && (entry2.descriptor.instructionText.trim() !== reference.instruction.trim() || !["REF", "NOTEREF", "STYLEREF"].includes(instructionKeyword(entry2.descriptor.instructionText))))
+        return [];
+      const anchor = resolveCanonicalFieldResultAnchor(this.context, entry2);
+      if (!anchor)
+        return [];
+      const contains = reference?.empty ? anchor.start === anchor.end && input.offset === anchor.start : input.offset >= anchor.start && input.offset < anchor.end;
+      return contains ? [{ entry: entry2, width: anchor.end - anchor.start }] : [];
+    });
+    candidates.sort((a, b) => a.width - b.width);
+    if (reference?.empty && candidates.length !== 1)
+      return null;
+    const entry = candidates[0]?.entry;
+    if (!entry)
+      return null;
+    const keyword = instructionKeyword(entry.descriptor.instructionText);
+    if (keyword === "TOC")
+      return null;
+    return {
+      target: projectFieldAddress(entry),
+      canRebuild: entry.descriptor.complete && !entry.descriptor.locked && (isScalarField(keyword) || SIMPLE_RESULT_COMPLEX_FIELD_KEYWORDS.has(keyword) || entry.descriptor.kind === "simple" && ["INDEX", "TOA", "CITATION", "BIBLIOGRAPHY", "TC", "XE", "TA"].includes(keyword))
+    };
+  }
   list(query3) {
     throwProjectionReadFailure(this.context, "fields.list");
     const publicEntries = filterFields(listCanonicalFieldEntries(this.context), query3);
@@ -342883,7 +342938,7 @@ class V2FieldsAdapter {
     }
     if (options?.dryRun)
       return { success: true, field: input.target };
-    const committed = keyword === "TOC" ? replaceTocXml(this.context, entry, entry.descriptor.instructionText, "fields-rebuild") : replaceFieldXml(this.context, entry, scalarXml ?? buildComplexFieldTextXml(entry.descriptor.instructionText, nextResult, {
+    const committed = keyword === "TOC" ? replaceTocXml(this.context, entry, entry.descriptor.instructionText, "fields-rebuild") : replaceFieldXml(this.context, entry, scalarXml ?? (["REF", "NOTEREF", "STYLEREF"].includes(keyword) ? buildFieldTextResultXml(this.context, entry, nextResult) : null) ?? buildComplexFieldTextXml(entry.descriptor.instructionText, nextResult, {
       preserveSpace: PAGE_NUMBER_FIELD_KEYWORDS.has(keyword) || entry.descriptor.kind === "simple" && /\\r\b/i.test(entry.descriptor.instructionText) && !/\s/.test(nextResult)
     }), "fields-rebuild");
     if (!committed.ok)
@@ -432726,6 +432781,7 @@ var init_freshness = __esm(() => {
         "hyperlinks.get",
         "fields.list",
         "fields.get",
+        "fields.contextAtPosition",
         "images.list",
         "comments.list",
         "comments.get",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.4.0-next.2",
+  "version": "1.4.0-next.3",
   "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.17.0-next.2",
+    "@superdoc/sdk": "2.17.0-next.3",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.20.0-next.3",
-    "@superdoc/docx-engine": "0.19.0-next.3",
+    "superdoc": "2.20.0-next.4",
+    "@superdoc/docx-engine": "0.19.0-next.4",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",