@superdoc/mcp 1.0.0-next.3 → 1.0.0-next.4

package/dist/index.js

@@ -31979,7 +31979,7 @@ var init_contract = __esm(() => {
           "Response envelopes include elapsed_ms for all operations.",
           "JSON output mode is the default and must always be supported."
         ],
-        operationCount: 465,
+        operationCount: 466,
         operations: [
           {
             id: "doc.get",
@@ -42888,6 +42888,25 @@ var init_contract = __esm(() => {
             ],
             errors: []
           },
+          {
+            id: "doc.discover",
+            command: [
+              "discover"
+            ],
+            description: "Find CLI operations from a natural-language intent. Returns an adaptive relevant set capped at ten results and expands the leading operation input shape.",
+            category: "session",
+            stability: "stable",
+            mutates: false,
+            requiresDocumentContext: false,
+            capabilities: [],
+            aliases: [],
+            examples: [
+              'superdoc discover "create a footnote"',
+              'superdoc discover "add an sdt" --limit 10',
+              'superdoc discover "change table cell padding" --pretty'
+            ],
+            errors: []
+          },
           {
             id: "doc.describe",
             command: [
@@ -43946,18 +43965,19 @@ var init_contract = __esm(() => {
         "doc.insertlinebreak": 437,
         "doc.executecode": 438,
         "doc.status": 439,
-        "doc.describe": 440,
-        "doc.describecommand": 441,
-        "doc.session.list": 442,
-        "doc.session.save": 443,
-        "doc.session.close": 444,
-        "doc.session.setdefault": 445,
-        "doc.preset.list": 446,
-        "doc.preset.getcatalog": 447,
-        "doc.preset.gettools": 448,
-        "doc.preset.getsystemprompt": 449,
-        "doc.preset.getmcpprompt": 450,
-        "doc.preset.dispatch": 451,
+        "doc.discover": 440,
+        "doc.describe": 441,
+        "doc.describecommand": 442,
+        "doc.session.list": 443,
+        "doc.session.save": 444,
+        "doc.session.close": 445,
+        "doc.session.setdefault": 446,
+        "doc.preset.list": 447,
+        "doc.preset.getcatalog": 448,
+        "doc.preset.gettools": 449,
+        "doc.preset.getsystemprompt": 450,
+        "doc.preset.getmcpprompt": 451,
+        "doc.preset.dispatch": 452,
         get: 0,
         find: 1,
         "get-node": 2,
@@ -44398,32 +44418,33 @@ var init_contract = __esm(() => {
         "insert line-break": 437,
         "execute code": 438,
         status: 439,
-        describe: 440,
-        "describe command": 441,
-        "session list": 442,
-        "session save": 443,
-        "session close": 444,
-        "session set-default": 445,
-        "preset list": 446,
-        "preset get-catalog": 447,
-        "preset get-tools": 448,
-        "preset get-system-prompt": 449,
-        "preset get-mcp-prompt": 450,
-        "preset dispatch": 451,
-        "lists exit": 452,
-        "format strikethrough": 453,
-        "track-changes accept": 454,
-        "track-changes reject": 455,
-        "track-changes accept-all": 456,
-        "track-changes reject-all": 457,
-        "comments add": 458,
-        "comments reply": 459,
-        "comments edit": 460,
-        "comments move": 461,
-        "comments resolve": 462,
-        "comments remove": 463,
-        "comments set-internal": 464,
-        "session use": 445,
+        discover: 440,
+        describe: 441,
+        "describe command": 442,
+        "session list": 443,
+        "session save": 444,
+        "session close": 445,
+        "session set-default": 446,
+        "preset list": 447,
+        "preset get-catalog": 448,
+        "preset get-tools": 449,
+        "preset get-system-prompt": 450,
+        "preset get-mcp-prompt": 451,
+        "preset dispatch": 452,
+        "lists exit": 453,
+        "format strikethrough": 454,
+        "track-changes accept": 455,
+        "track-changes reject": 456,
+        "track-changes accept-all": 457,
+        "track-changes reject-all": 458,
+        "comments add": 459,
+        "comments reply": 460,
+        "comments edit": 461,
+        "comments move": 462,
+        "comments resolve": 463,
+        "comments remove": 464,
+        "comments set-internal": 465,
+        "session use": 446,
         getnode: 2,
         getnodebyid: 3,
         gettext: 4,
@@ -44853,17 +44874,17 @@ var init_contract = __esm(() => {
         inserttab: 436,
         insertlinebreak: 437,
         executecode: 438,
-        describecommand: 441,
-        "session.list": 442,
-        "session.save": 443,
-        "session.close": 444,
-        "session.setdefault": 445,
-        "preset.list": 446,
-        "preset.getcatalog": 447,
-        "preset.gettools": 448,
-        "preset.getsystemprompt": 449,
-        "preset.getmcpprompt": 450,
-        "preset.dispatch": 451
+        describecommand: 442,
+        "session.list": 443,
+        "session.save": 444,
+        "session.close": 445,
+        "session.setdefault": 446,
+        "preset.list": 447,
+        "preset.getcatalog": 448,
+        "preset.gettools": 449,
+        "preset.getsystemprompt": 450,
+        "preset.getmcpprompt": 451,
+        "preset.dispatch": 452
       }
     },
     operations: {
@@ -346303,6 +346324,175 @@ var init_contract = __esm(() => {
           ]
         }
       },
+      "doc.discover": {
+        operationId: "doc.discover",
+        sdkSurface: "internal",
+        command: "discover",
+        commandTokens: [
+          "discover"
+        ],
+        category: "session",
+        description: "Find CLI operations from a natural-language intent. Returns an adaptive relevant set capped at ten results and expands the leading operation input shape.",
+        requiresDocumentContext: false,
+        docRequirement: "none",
+        responseEnvelopeKey: null,
+        params: [
+          {
+            name: "query",
+            kind: "doc",
+            type: "string",
+            required: true,
+            description: "Natural-language description of the operation to find."
+          },
+          {
+            name: "limit",
+            kind: "flag",
+            type: "number",
+            description: "Maximum results to return, from 1 through 10. Defaults to 10."
+          }
+        ],
+        constraints: null,
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Natural-language description of the operation to find."
+            },
+            limit: {
+              type: "number",
+              description: "Maximum results to return, from 1 through 10. Defaults to 10."
+            }
+          },
+          required: [
+            "query"
+          ],
+          additionalProperties: false
+        },
+        mutates: false,
+        idempotency: "idempotent",
+        supportsTrackedMode: false,
+        supportsDryRun: false,
+        outputSchema: {
+          type: "object",
+          properties: {
+            contractVersion: {
+              type: "string"
+            },
+            query: {
+              type: "string"
+            },
+            interpretation: {
+              type: "string",
+              enum: [
+                "clear",
+                "ambiguous",
+                "broad",
+                "no-match"
+              ]
+            },
+            resultCount: {
+              type: "number"
+            },
+            maxResults: {
+              type: "number"
+            },
+            capped: {
+              type: "boolean"
+            },
+            results: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  rank: {
+                    type: "number"
+                  },
+                  operationId: {
+                    type: "string"
+                  },
+                  command: {
+                    type: "string"
+                  },
+                  description: {
+                    type: "string"
+                  },
+                  referenceGroup: {
+                    type: "string"
+                  },
+                  relevance: {
+                    type: "string",
+                    enum: [
+                      "exact",
+                      "strong",
+                      "relevant",
+                      "related"
+                    ]
+                  },
+                  score: {
+                    type: "number",
+                    description: "Query-relative ranking score; not a probability."
+                  },
+                  matched: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    }
+                  },
+                  useWhen: {
+                    type: "string"
+                  },
+                  avoidWhen: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    }
+                  },
+                  defaults: {
+                    type: "object"
+                  },
+                  schemaCommand: {
+                    type: "string"
+                  },
+                  input: {
+                    type: "object"
+                  },
+                  relations: {
+                    type: "array",
+                    items: {
+                      type: "object"
+                    }
+                  }
+                },
+                required: [
+                  "rank",
+                  "operationId",
+                  "command",
+                  "description",
+                  "referenceGroup",
+                  "relevance",
+                  "score",
+                  "matched",
+                  "schemaCommand"
+                ]
+              }
+            },
+            guidance: {
+              type: "string"
+            }
+          },
+          required: [
+            "contractVersion",
+            "query",
+            "interpretation",
+            "resultCount",
+            "maxResults",
+            "capped",
+            "results"
+          ]
+        },
+        skipAsATool: true
+      },
       "doc.describe": {
         operationId: "doc.describe",
         sdkSurface: "client",
@@ -347730,6 +347920,7 @@ function createDocApi(runtime) {
     insertLineBreak: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.insertLineBreak"], params, options),
     executeCode: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.executeCode"], params, options),
     status: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.status"], params, options),
+    discover: (params, options) => runtime.invoke(CONTRACT.operations["doc.discover"], params, options),
     describe: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.describe"], params, options),
     describeCommand: (params, options) => runtime.invoke(CONTRACT.operations["doc.describeCommand"], params, options),
     session: {
@@ -349450,7 +349641,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.13.0-next.5";
+var SDK_VERSION = "2.13.0-next.6";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { chmodSync, existsSync } from "node:fs";
@@ -691062,6 +691253,9 @@ function isRunBackedAttributedBreak(segment) {
   return segment.atomKind === INLINE_ATOM_KIND.preserved && segment.visibleLength === 1 && segment.meta.tag === "br" && segment.meta.container === "run-child";
 }
 function parseDeletedTextRunXml(runXml) {
+  return parseDeletedTextRunSegmentsXml(runXml).filter((segment) => segment.kind === "run");
+}
+function parseDeletedTextRunSegmentsXml(runXml) {
   const out = [];
   let cursor = 0;
   while (cursor < runXml.length) {
@@ -691069,7 +691263,7 @@ function parseDeletedTextRunXml(runXml) {
     if (!next)
       break;
     if (localName2(next.openTagInner) === "r") {
-      out.push(...parseRun2(next.xml, "delText").filter((segment) => segment.kind === "run"));
+      out.push(...parseRun2(next.xml, "delText"));
     }
     cursor = next.end;
   }
@@ -708116,17 +708310,44 @@ function applyTrackedTextDecisionsToStory(input) {
           }
         }
         if (span.trackedKind === "del" && input.decision === "reject") {
+          const found = findBlockMap(input.doc, span.blockId)?.block;
+          if (!found)
+            throw new Error(`target block ${span.blockId} is not present in the story shard`);
           let offset = span.startOffset;
-          for (const run of span.deletedRuns) {
+          let restoredBreakXml = null;
+          let restoredBreakOrdinal = 0;
+          for (const segment of span.deletedSegments) {
+            if (segment.kind === "atom") {
+              restoredBreakXml = typeof segment.meta.sourceXml === "string" ? segment.meta.sourceXml : segment.xml;
+              continue;
+            }
             insertText2({
               doc: input.doc,
               blockId: span.blockId,
               offset,
-              text: run.text,
-              attributes: exactRunAttributes(run.attributes),
+              text: segment.text,
+              attributes: exactRunAttributes(segment.attributes),
               origin: STORY_SURFACE_BACKEND_ORIGIN
             });
-            offset += run.text.length;
+            if (restoredBreakXml) {
+              if (segment.text !== `
+`) {
+                throw new Error(`attributed break restoration in ${span.blockId} has no matching break character`);
+              }
+              restoredBreakOrdinal += 1;
+              getBlockAtoms(found).push([
+                createRestoredAttributedBreakAtom({
+                  id: `${span.startAtomId}:restored-break:${input.txId}:${restoredBreakOrdinal}`,
+                  offset,
+                  sourceXml: restoredBreakXml
+                })
+              ]);
+              restoredBreakXml = null;
+            }
+            offset += segment.text.length;
+          }
+          if (restoredBreakXml) {
+            throw new Error(`attributed break restoration in ${span.blockId} is incomplete`);
           }
         }
       }
@@ -708186,8 +708407,24 @@ function collectLiveTrackedTextSpansInBlock(block, rsid, trackedKind) {
     const end = ends[endIndex];
     usedEnds.add(endIndex);
     const contained = atoms.filter((atom) => atom.index > start.index && atom.index < end.index);
-    const preservedForSpan = trackedKind === "del" ? contained.filter((atom) => atom.atomKind === INLINE_ATOM_KIND.preserved && atom.meta.tag === "delTextRun" && String(atom.meta.rsid ?? "") === rsid) : [];
-    const deletedRuns = preservedForSpan.flatMap((atom) => parseDeletedTextRunXml(atom.xml));
+    const preservedWithSegments = trackedKind === "del" ? contained.flatMap((atom) => {
+      if (atom.atomKind !== INLINE_ATOM_KIND.preserved)
+        return [];
+      const isDeletedTextRun = atom.meta.tag === "delTextRun" && String(atom.meta.rsid ?? "") === rsid;
+      const isOpaqueDeletionRun = atom.meta.tag === "r" && atom.meta.container === "tracked-deletion";
+      if (!isDeletedTextRun && !isOpaqueDeletionRun)
+        return [];
+      const segments = parseDeletedTextRunSegmentsXml(atom.xml);
+      const isOpaquePlainBreakRun = segments.length > 0 && segments.every((segment) => segment.kind === "run" && segment.text.length > 0 && /^\n+$/.test(segment.text));
+      if (isOpaqueDeletionRun && !segments.some((segment) => segment.kind === "atom") && !isOpaquePlainBreakRun)
+        return [];
+      if (segments.some((segment) => segment.kind === "atom" && !(segment.meta.tag === "br" && segment.visibleLength === 1)))
+        return [];
+      return [{ atom, segments }];
+    }) : [];
+    const preservedForSpan = preservedWithSegments.map(({ atom }) => atom);
+    const deletedSegments = preservedWithSegments.flatMap(({ segments }) => segments);
+    const deletedRuns = deletedSegments.filter((segment) => segment.kind === "run");
     const deletedTextLength2 = deletedRuns.reduce((length3, run) => length3 + run.text.length, 0);
     spans.push({
       trackedKind,
@@ -708198,7 +708435,8 @@ function collectLiveTrackedTextSpansInBlock(block, rsid, trackedKind) {
       endAtomId: end.id,
       preservedAtomIds: preservedForSpan.map((atom) => atom.id),
       containedAtomIds: contained.map((atom) => atom.id),
-      deletedRuns
+      deletedRuns,
+      deletedSegments
     });
   }
   return spans;
@@ -709381,6 +709619,20 @@ function createPreservedAtom(input) {
   atom.set(ATOM_KEY.meta, input.meta);
   return atom;
 }
+function createRestoredAttributedBreakAtom(input) {
+  const atom = new YMap;
+  atom.set(ATOM_KEY.id, input.id);
+  atom.set(ATOM_KEY.kind, INLINE_ATOM_KIND.preserved);
+  atom.set(ATOM_KEY.visibleOffset, input.offset);
+  atom.set(ATOM_KEY.length, 1);
+  atom.set(ATOM_KEY.xml, "");
+  atom.set(ATOM_KEY.meta, {
+    tag: "br",
+    container: "run-child",
+    sourceXml: input.sourceXml
+  });
+  return atom;
+}
 function createTrackedAnchor(input) {
   const anchor = new YMap;
   anchor.set(ANCHOR_KEY.id, input.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.0.0-next.3",
+  "version": "1.0.0-next.4",
   "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,7 +24,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.13.0-next.5",
+    "@superdoc/sdk": "2.13.0-next.6",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },