@adeu/mcp-server 1.6.8 → 1.6.9

package/dist/index.js

@@ -3,7 +3,10 @@
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
 import { readFileSync } from "fs";
 import { basename as basename2, resolve as resolve2, extname, dirname } from "path";
 import {
@@ -12,7 +15,7 @@ import {
   DocumentObject as DocumentObject2,
   RedlineEngine,
   BatchValidationError,
-  create_unified_diff,
+  create_word_patch_diff,
   finalize_document
 } from "@adeu/core";
 
@@ -158,6 +161,16 @@ ${ui_markdown}`;
 }
 
 // src/index.ts
+function readFileBytesOrThrow(filePath) {
+  try {
+    return readFileSync(filePath);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    throw err;
+  }
+}
 var READ_DOCX_COMMON_DESC = "Reads a DOCX file. Returns text with inline CriticMarkup for Tracked Changes and Comments: {++inserted++}, {--deleted--}, {==highlighted==}{>>comment<<}. Set clean_view=True for the finalized 'Accepted' text without markup.\n\n";
 var READ_DOCX_TAIL = "Modes:\n- 'full' (default): paginated body content. Use page=N to navigate.\n- 'outline': heading map only \u2014 start here for large docs to plan targeted reads. Defaults to L1-L2 headings; pass outline_max_level=3-6 to see deeper structure.\n- 'appendix': defined terms, anchors, and cross-reference targets. Consult before editing legal/technical docs to avoid breaking references.";
 var PROCESS_BATCH_COMMON_DESC = "Applies a batch of edits and review actions to a DOCX.\n\nAll changes evaluate against the ORIGINAL document state \u2014 do not chain dependent edits within one batch (e.g. rename X to Y, then modify Y). Apply the rename first, then send a second batch.\n\n";
@@ -183,12 +196,36 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
-            file_path: { type: "string", description: "Absolute path to the DOCX file." },
-            clean_view: { type: "boolean", description: "If False (default), returns the 'Raw' text with inline CriticMarkup. If True, returns 'Accepted' text.", default: false },
-            mode: { type: "string", enum: ["full", "outline", "appendix"], description: "'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms.", default: "full" },
-            page: { type: "number", description: "Page number (1-indexed) for mode='full'. Defaults to 1.", default: 1 },
-            outline_max_level: { type: "number", description: "For mode='outline' only: cap on heading depth.", default: 2 },
-            outline_verbose: { type: "boolean", description: "For mode='outline' only: includes metadata.", default: false }
+            file_path: {
+              type: "string",
+              description: "Absolute path to the DOCX file."
+            },
+            clean_view: {
+              type: "boolean",
+              description: "If False (default), returns the 'Raw' text with inline CriticMarkup. If True, returns 'Accepted' text.",
+              default: false
+            },
+            mode: {
+              type: "string",
+              enum: ["full", "outline", "appendix"],
+              description: "'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms.",
+              default: "full"
+            },
+            page: {
+              type: "number",
+              description: "Page number (1-indexed) for mode='full'. Defaults to 1.",
+              default: 1
+            },
+            outline_max_level: {
+              type: "number",
+              description: "For mode='outline' only: cap on heading depth.",
+              default: 2
+            },
+            outline_verbose: {
+              type: "boolean",
+              description: "For mode='outline' only: includes metadata.",
+              default: false
+            }
           },
           required: ["file_path"]
         }
@@ -199,14 +236,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
-            original_docx_path: { type: "string", description: "Absolute path to the source file." },
-            author_name: { type: "string", description: "Name to appear in Track Changes (e.g., 'Reviewer AI')." },
+            original_docx_path: {
+              type: "string",
+              description: "Absolute path to the source file."
+            },
+            author_name: {
+              type: "string",
+              description: "Name to appear in Track Changes (e.g., 'Reviewer AI')."
+            },
             changes: {
               type: "array",
               description: "List of changes to apply. Each change must specify 'type'.",
               items: { type: "object" }
             },
-            output_path: { type: "string", description: "Optional output path." }
+            output_path: {
+              type: "string",
+              description: "Optional output path."
+            }
           },
           required: ["original_docx_path", "author_name", "changes"]
         }
@@ -217,8 +263,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
-            docx_path: { type: "string", description: "Absolute path to the DOCX file." },
-            output_path: { type: "string", description: "Optional output path." }
+            docx_path: {
+              type: "string",
+              description: "Absolute path to the DOCX file."
+            },
+            output_path: {
+              type: "string",
+              description: "Optional output path."
+            }
           },
           required: ["docx_path"]
         }
@@ -229,8 +281,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
-            original_path: { type: "string", description: "Absolute path to the baseline DOCX file." },
-            modified_path: { type: "string", description: "Absolute path to the modified DOCX file." }
+            original_path: {
+              type: "string",
+              description: "Absolute path to the baseline DOCX file."
+            },
+            modified_path: {
+              type: "string",
+              description: "Absolute path to the modified DOCX file."
+            },
+            compare_clean: {
+              type: "boolean",
+              description: "If True, compares 'Accepted' state. If False, compares raw text.",
+              default: true
+            }
           },
           required: ["original_path", "modified_path"]
         }
@@ -241,14 +304,40 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
-            file_path: { type: "string", description: "Absolute path to the DOCX file." },
-            output_path: { type: "string", description: "Optional output path." },
-            sanitize_mode: { type: "string", enum: ["full", "keep-markup"], description: "full removes all markup, keep-markup redacts metadata but keeps comments/redlines." },
-            accept_all: { type: "boolean", description: "If true, auto-accepts all unresolved track changes before finalizing." },
-            protection_mode: { type: "string", enum: ["read_only", "encrypt"], description: "Native OOXML document locking. encrypt falls back to read_only in this environment." },
-            password: { type: "string", description: "Ignored in this environment." },
-            author: { type: "string", description: "Replace all remaining markup authorship with this name." },
-            export_pdf: { type: "boolean", description: "Ignored in this environment." }
+            file_path: {
+              type: "string",
+              description: "Absolute path to the DOCX file."
+            },
+            output_path: {
+              type: "string",
+              description: "Optional output path."
+            },
+            sanitize_mode: {
+              type: "string",
+              enum: ["full", "keep-markup"],
+              description: "full removes all markup, keep-markup redacts metadata but keeps comments/redlines."
+            },
+            accept_all: {
+              type: "boolean",
+              description: "If true, auto-accepts all unresolved track changes before finalizing."
+            },
+            protection_mode: {
+              type: "string",
+              enum: ["read_only", "encrypt"],
+              description: "Native OOXML document locking. encrypt falls back to read_only in this environment."
+            },
+            password: {
+              type: "string",
+              description: "Ignored in this environment."
+            },
+            author: {
+              type: "string",
+              description: "Replace all remaining markup authorship with this name."
+            },
+            export_pdf: {
+              type: "boolean",
+              description: "Ignored in this environment."
+            }
           },
           required: ["file_path"]
         }
@@ -256,142 +345,191 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     ]
   };
 });
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-  try {
-    if (name === "read_docx") {
-      const filePath = args?.file_path;
-      const cleanView = args?.clean_view ?? false;
-      const mode = args?.mode ?? "full";
-      const page = args?.page ?? 1;
-      const outline_max_level = args?.outline_max_level ?? 2;
-      const outline_verbose = args?.outline_verbose ?? false;
-      const buf = readFileSync(filePath);
-      const text = await extractTextFromBuffer(buf, cleanView);
-      if (mode === "outline") {
-        const doc = await DocumentObject2.load(buf);
-        return build_outline_response(doc, text, filePath, outline_max_level, outline_verbose);
-      }
-      if (mode === "appendix") {
-        return build_appendix_response(text, page, filePath);
-      }
-      return build_paginated_response(text, page, filePath);
-    }
-    if (name === "process_document_batch") {
-      const origPath = args?.original_docx_path;
-      const authorName = args?.author_name;
-      const changes = args?.changes;
-      let outPath = args?.output_path;
-      if (!outPath) {
-        const ext = extname(origPath);
-        const base = basename2(origPath, ext);
-        const dir = dirname(origPath);
-        outPath = resolve2(dir, `${base}_processed${ext}`);
+server.setRequestHandler(
+  CallToolRequestSchema,
+  async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+      if (name === "read_docx") {
+        const filePath = args?.file_path;
+        const cleanView = args?.clean_view ?? false;
+        const mode = args?.mode ?? "full";
+        const page = args?.page ?? 1;
+        const outline_max_level = args?.outline_max_level ?? 2;
+        const outline_verbose = args?.outline_verbose ?? false;
+        const buf = readFileBytesOrThrow(filePath);
+        const text = await extractTextFromBuffer(buf, cleanView);
+        if (mode === "outline") {
+          const doc = await DocumentObject2.load(buf);
+          return build_outline_response(
+            doc,
+            text,
+            filePath,
+            outline_max_level,
+            outline_verbose
+          );
+        }
+        if (mode === "appendix") {
+          return build_appendix_response(text, page, filePath);
+        }
+        return build_paginated_response(text, page, filePath);
       }
-      const buf = readFileSync(origPath);
-      const doc = await DocumentObject2.load(buf);
-      const engine = new RedlineEngine(doc, authorName);
-      let stats;
-      try {
-        stats = engine.process_batch(changes);
-      } catch (e) {
-        if (e instanceof BatchValidationError) {
+      if (name === "process_document_batch") {
+        const origPath = args?.original_docx_path;
+        const authorName = args?.author_name;
+        const changes = args?.changes;
+        let outPath = args?.output_path;
+        if (!authorName || !authorName.trim()) {
           return {
-            content: [{ type: "text", text: `Batch rejected. Some edits failed validation:
-
-${e.errors.join("\n\n")}` }],
-            isError: true
+            content: [
+              { type: "text", text: "Error: author_name cannot be empty." }
+            ]
           };
         }
-        throw e;
-      }
-      const outBuf = await doc.save();
-      const fs = await import("fs");
-      fs.writeFileSync(outPath, outBuf);
-      let res = `Batch complete. Saved to: ${outPath}
+        if (!changes || changes.length === 0) {
+          return {
+            content: [{ type: "text", text: "Error: No changes provided." }]
+          };
+        }
+        if (!outPath) {
+          const ext = extname(origPath);
+          const base = basename2(origPath, ext);
+          const dir = dirname(origPath);
+          outPath = resolve2(dir, `${base}_processed${ext}`);
+        }
+        const buf = readFileBytesOrThrow(origPath);
+        const doc = await DocumentObject2.load(buf);
+        const engine = new RedlineEngine(doc, authorName);
+        let stats;
+        try {
+          stats = engine.process_batch(changes);
+        } catch (e) {
+          if (e instanceof BatchValidationError) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Batch rejected. Some edits failed validation:
+
+${e.errors.join("\n\n")}`
+                }
+              ],
+              isError: true
+            };
+          }
+          throw e;
+        }
+        const outBuf = await doc.save();
+        const fs = await import("fs");
+        fs.writeFileSync(outPath, outBuf);
+        let res = `Batch complete. Saved to: ${outPath}
 Actions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.
 Edits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.`;
-      if (stats.skipped_details?.length > 0) {
-        res += `
+        if (stats.skipped_details?.length > 0) {
+          res += `
 
 Skipped Details:
 ${stats.skipped_details.join("\n")}`;
+        }
+        return {
+          content: [{ type: "text", text: res }]
+        };
       }
-      return {
-        content: [{ type: "text", text: res }]
-      };
-    }
-    if (name === "accept_all_changes") {
-      const docxPath = args?.docx_path;
-      let outPath = args?.output_path;
-      if (!outPath) {
-        const ext = extname(docxPath);
-        const base = basename2(docxPath, ext);
-        const dir = dirname(docxPath);
-        outPath = resolve2(dir, `${base}_clean${ext}`);
+      if (name === "accept_all_changes") {
+        const docxPath = args?.docx_path;
+        let outPath = args?.output_path;
+        if (!outPath) {
+          const ext = extname(docxPath);
+          const base = basename2(docxPath, ext);
+          const dir = dirname(docxPath);
+          outPath = resolve2(dir, `${base}_clean${ext}`);
+        }
+        const buf = readFileBytesOrThrow(docxPath);
+        const doc = await DocumentObject2.load(buf);
+        const engine = new RedlineEngine(doc);
+        engine.accept_all_revisions();
+        const outBuf = await doc.save();
+        const fs = await import("fs");
+        fs.writeFileSync(outPath, outBuf);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Accepted all changes. Saved to: ${outPath}`
+            }
+          ]
+        };
       }
-      const buf = readFileSync(docxPath);
-      const doc = await DocumentObject2.load(buf);
-      const engine = new RedlineEngine(doc);
-      engine.accept_all_revisions();
-      const outBuf = await doc.save();
-      const fs = await import("fs");
-      fs.writeFileSync(outPath, outBuf);
-      return {
-        content: [{ type: "text", text: `Accepted all changes. Saved to: ${outPath}` }]
-      };
-    }
-    if (name === "diff_docx_files") {
-      const origPath = args?.original_path;
-      const modPath = args?.modified_path;
-      const origBuf = readFileSync(origPath);
-      const modBuf = readFileSync(modPath);
-      const origText = await extractTextFromBuffer(origBuf, true);
-      const modText = await extractTextFromBuffer(modBuf, true);
-      const diff = create_unified_diff(origText, modText);
-      return {
-        content: [{ type: "text", text: diff || "No differences found." }]
-      };
-    }
-    if (name === "finalize_document") {
-      const filePath = args?.file_path;
-      let outPath = args?.output_path;
-      if (!outPath) {
-        const ext = extname(filePath);
-        const base = basename2(filePath, ext);
-        const dir = dirname(filePath);
-        outPath = resolve2(dir, `${base}_final${ext}`);
+      if (name === "diff_docx_files") {
+        const origPath = args?.original_path;
+        const modPath = args?.modified_path;
+        const compareClean = args?.compare_clean ?? true;
+        const origBuf = readFileBytesOrThrow(origPath);
+        const modBuf = readFileBytesOrThrow(modPath);
+        const origText = await extractTextFromBuffer(origBuf, compareClean);
+        const modText = await extractTextFromBuffer(modBuf, compareClean);
+        const diff = create_word_patch_diff(
+          origText,
+          modText,
+          basename2(origPath),
+          basename2(modPath)
+        );
+        return {
+          content: [{ type: "text", text: diff || "No differences found." }]
+        };
       }
-      const buf = readFileSync(filePath);
-      const doc = await DocumentObject2.load(buf);
-      const result = await finalize_document(doc, {
-        filename: basename2(filePath),
-        sanitize_mode: args?.sanitize_mode || "full",
-        accept_all: args?.accept_all,
-        protection_mode: args?.protection_mode,
-        author: args?.author,
-        export_pdf: args?.export_pdf
-      });
-      const fs = await import("fs");
-      fs.writeFileSync(outPath, result.outBuffer);
-      return {
-        content: [{ type: "text", text: `Saved to: ${outPath}
+      if (name === "finalize_document") {
+        const filePath = args?.file_path;
+        let outPath = args?.output_path;
+        if (!outPath) {
+          const ext = extname(filePath);
+          const base = basename2(filePath, ext);
+          const dir = dirname(filePath);
+          outPath = resolve2(dir, `${base}_final${ext}`);
+        }
+        const buf = readFileBytesOrThrow(filePath);
+        const doc = await DocumentObject2.load(buf);
+        const result = await finalize_document(doc, {
+          filename: basename2(filePath),
+          sanitize_mode: args?.sanitize_mode || "full",
+          accept_all: args?.accept_all,
+          protection_mode: args?.protection_mode,
+          author: args?.author,
+          export_pdf: args?.export_pdf
+        });
+        const fs = await import("fs");
+        fs.writeFileSync(outPath, result.outBuffer);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Saved to: ${outPath}
 
-${result.reportText}` }]
+${result.reportText}`
+            }
+          ]
+        };
+      }
+      throw new Error(`Unknown tool: ${name}`);
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error executing tool ${name}: ${error.message}`
+          }
+        ],
+        isError: true
       };
     }
-    throw new Error(`Unknown tool: ${name}`);
-  } catch (error) {
-    return {
-      content: [{ type: "text", text: `Error executing tool ${name}: ${error.message}` }],
-      isError: true
-    };
   }
-});
+);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`);
+  console.error(
+    `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`
+  );
 }
 main().catch(console.error);
 //# sourceMappingURL=index.js.map