npm - @adeu/mcp-server - Versions diffs - 1.6.8 → 1.7.1 - Mend

@adeu/mcp-server 1.6.8 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/index.js CHANGED Viewed

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
 // src/index.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { Server as Server2 } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync } from "fs";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync as readFileSync3 } from "fs";
 import { basename as basename2, resolve as resolve2, extname, dirname } from "path";
 import {
   identifyEngine,
@@ -12,7 +15,7 @@ import {
   DocumentObject as DocumentObject2,
   RedlineEngine,
   BatchValidationError,
-  create_unified_diff,
+  create_word_patch_diff,
   finalize_document
 } from "@adeu/core";
@@ -157,13 +160,457 @@ ${ui_markdown}`;
   };
 }
+// src/desktop-auth.ts
+import { createServer } from "http";
+import { exec } from "child_process";
+import { homedir, platform } from "os";
+import { join } from "path";
+import {
+  writeFileSync,
+  readFileSync,
+  mkdirSync,
+  existsSync,
+  rmSync,
+  chmodSync
+} from "fs";
+// src/shared.ts
+var FRONTEND_URL = process.env.ADEU_FRONTEND_URL || "https://app.adeu.ai";
+var BACKEND_URL = process.env.ADEU_BACKEND_URL || "https://app.adeu.ai";
+// src/desktop-auth.ts
+var ADEU_DIR = join(homedir(), ".adeu");
+var CRED_PATH = join(ADEU_DIR, "credentials.json");
+function openBrowser(url) {
+  if (platform() === "darwin") exec(`open "${url}"`);
+  else if (platform() === "win32") exec(`start "" "${url}"`);
+  else exec(`xdg-open "${url}"`);
+}
+var DesktopAuthManager = class {
+  static getApiKey() {
+    if (!existsSync(CRED_PATH)) return null;
+    try {
+      const data = JSON.parse(readFileSync(CRED_PATH, "utf-8"));
+      return data.api_key || null;
+    } catch {
+      return null;
+    }
+  }
+  static setApiKey(apiKey) {
+    if (!existsSync(ADEU_DIR)) {
+      mkdirSync(ADEU_DIR, { recursive: true });
+    }
+    writeFileSync(CRED_PATH, JSON.stringify({ api_key: apiKey }));
+    chmodSync(CRED_PATH, 384);
+  }
+  static clearApiKey() {
+    if (existsSync(CRED_PATH)) {
+      rmSync(CRED_PATH);
+    }
+  }
+  static async authenticateInteractive() {
+    return new Promise((resolve3, reject) => {
+      let server2;
+      const timeout = setTimeout(
+        () => {
+          if (server2) server2.close();
+          reject(new Error("Authentication timed out after 5 minutes."));
+        },
+        5 * 60 * 1e3
+      );
+      server2 = createServer((req, res) => {
+        const url = new URL(req.url || "", `http://${req.headers.host}`);
+        if (url.pathname === "/callback") {
+          const apiKey = url.searchParams.get("api_key");
+          res.writeHead(apiKey ? 200 : 400, { "Content-Type": "text/html" });
+          const title = apiKey ? "Authentication Successful!" : "Authentication Failed";
+          const text = apiKey ? "Your Adeu MCP server has been successfully authenticated. You can safely close this window and return to Claude." : "No API key received. Please try again.";
+          const color = apiKey ? "#107c10" : "#d83b01";
+          res.end(`
+            <!DOCTYPE html><html><head><title>${title}</title>
+            <style>body{font-family:sans-serif;text-align:center;padding:50px;background:#f3f2f1;}.container{background:white;padding:40px;border-radius:8px;box-shadow:0 2px 4px rgba(0,0,0,0.1);max-width:500px;margin:0 auto;}h1{color:${color};}p{color:#605e5c;line-height:1.5;}</style>
+            </head><body><div class="container"><h1>${title}</h1><p>${text}</p>
+            <script>setTimeout(()=>window.close(), 3000);</script>
+            </div></body></html>
+          `);
+          clearTimeout(timeout);
+          setTimeout(() => server2.close(), 100);
+          if (apiKey) {
+            this.setApiKey(apiKey);
+            resolve3(apiKey);
+          } else {
+            reject(new Error("No API key received in callback."));
+          }
+        } else {
+          res.writeHead(404);
+          res.end();
+        }
+      });
+      server2.listen(0, "127.0.0.1", () => {
+        const address = server2.address();
+        if (address && typeof address !== "string") {
+          const authUrl = `${FRONTEND_URL}/login?desktop_port=${address.port}`;
+          openBrowser(authUrl);
+        }
+      });
+    });
+  }
+  static async ensureAuthenticated() {
+    const key = this.getApiKey();
+    if (key) return key;
+    return this.authenticateInteractive();
+  }
+};
+async function getCloudAuthToken() {
+  const key = DesktopAuthManager.getApiKey();
+  if (!key) {
+    throw new Error(
+      "Authentication Required: You are not logged in. Please call the `login_to_adeu_cloud` tool first to authenticate, then try this task again."
+    );
+  }
+  return key;
+}
+// src/tools/auth.ts
+async function login_to_adeu_cloud() {
+  try {
+    const apiKey = await DesktopAuthManager.ensureAuthenticated();
+    const res = await fetch(`${BACKEND_URL}/api/v1/auth/me`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        Accept: "application/json"
+      }
+    });
+    if (res.status === 401) {
+      DesktopAuthManager.clearApiKey();
+      throw new Error(
+        "Your previous session expired. The stale key has been cleared. Please call `login_to_adeu_cloud` ONE MORE TIME to log in fresh."
+      );
+    }
+    if (!res.ok) throw new Error(`HTTP Error: ${res.status}`);
+    const data = await res.json();
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Login successful! Connected to Adeu Cloud as: ${data.email || "Unknown Email"}.`
+        }
+      ]
+    };
+  } catch (err) {
+    return { isError: true, content: [{ type: "text", text: err.message }] };
+  }
+}
+async function logout_of_adeu_cloud() {
+  DesktopAuthManager.clearApiKey();
+  return {
+    content: [
+      {
+        type: "text",
+        text: "Successfully logged out. The local API key has been removed."
+      }
+    ]
+  };
+}
+// src/tools/email.ts
+import { homedir as homedir2, tmpdir } from "os";
+import { join as join2 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, existsSync as existsSync2 } from "fs";
+import { createHash } from "crypto";
+var CACHE_FILE = join2(homedir2(), ".adeu", "mcp_id_cache.json");
+var MAX_CACHE_SIZE = 1e3;
+function loadIdCache() {
+  if (existsSync2(CACHE_FILE)) {
+    try {
+      return JSON.parse(readFileSync2(CACHE_FILE, "utf-8"));
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+function saveIdCache(cache) {
+  try {
+    mkdirSync2(join2(homedir2(), ".adeu"), { recursive: true });
+    const keys = Object.keys(cache);
+    if (keys.length > MAX_CACHE_SIZE) {
+      const trimmed = {};
+      keys.slice(-MAX_CACHE_SIZE).forEach((k) => trimmed[k] = cache[k]);
+      cache = trimmed;
+    }
+    writeFileSync2(CACHE_FILE, JSON.stringify(cache));
+  } catch {
+  }
+}
+function minifyEmailId(realId, cache) {
+  if (!realId) return realId;
+  const hash = createHash("md5").update(realId).digest("hex").slice(0, 6);
+  const shortId = `msg_${hash}`;
+  cache[shortId] = realId;
+  return shortId;
+}
+function resolveEmailId(shortId) {
+  if (!shortId) return shortId;
+  const cache = loadIdCache();
+  return cache[shortId] || shortId;
+}
+function stripTags(html) {
+  if (!html) return "";
+  let text = html.replace(/<(style|script|head)[^>]*>[\s\S]*?<\/\1>/gi, "");
+  text = text.replace(
+    /<\/?(p|div|br|hr|tr|li|h[1-6]|blockquote)\b[^>]*>/gi,
+    "\n"
+  );
+  text = text.replace(/<[^>]+>/g, "");
+  return text.replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
+}
+function removeNestedQuotes(text) {
+  if (!text) return "";
+  const patterns = [
+    /_{10,}/m,
+    /^From:\s.*?\n(?:.*\n){0,5}?Sent:\s/m,
+    /-----Original Message-----/m,
+    /On .{1,200}? wrote:/m,
+    /^Original Message$/m
+  ];
+  let earliestCut = text.length;
+  for (const pattern of patterns) {
+    const match = pattern.exec(text);
+    if (match && match.index < earliestCut) {
+      earliestCut = match.index;
+    }
+  }
+  return text.substring(0, earliestCut).trim();
+}
+function getUniqueFilepath(saveDir, filename) {
+  let filepath = join2(saveDir, filename);
+  let counter = 1;
+  const parts = filename.split(".");
+  const ext = parts.length > 1 ? `.${parts.pop()}` : "";
+  const stem = parts.join(".");
+  while (existsSync2(filepath)) {
+    filepath = join2(saveDir, `${stem}_${counter}${ext}`);
+    counter++;
+  }
+  return filepath;
+}
+async function search_and_fetch_emails(args) {
+  const apiKey = await getCloudAuthToken();
+  const realEmailId = args.email_id ? resolveEmailId(args.email_id) : void 0;
+  const payload = {
+    email_id: realEmailId,
+    sender: args.sender,
+    subject: args.subject,
+    has_attachments: args.has_attachments,
+    attachment_name: args.attachment_name,
+    is_unread: args.is_unread,
+    days_ago: args.days_ago,
+    folder: args.folder,
+    limit: args.limit ?? 10,
+    offset: args.offset ?? 0
+  };
+  Object.keys(payload).forEach(
+    (k) => payload[k] === void 0 && delete payload[k]
+  );
+  const res = await fetch(`${BACKEND_URL}/api/v1/emails/search`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(payload)
+  });
+  if (res.status === 401) {
+    DesktopAuthManager.clearApiKey();
+    throw new Error(
+      "Authentication expired. Please call `login_to_adeu_cloud` to re-authenticate."
+    );
+  }
+  if (!res.ok) throw new Error(`Cloud search failed: ${await res.text()}`);
+  const data = await res.json();
+  const cache = loadIdCache();
+  if (data.type === "previews") {
+    const previews = data.previews || [];
+    if (!previews.length)
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No emails found matching your search criteria."
+          }
+        ]
+      };
+    const lines = [
+      `Found ${previews.length} email(s). Here are the previews:`,
+      ""
+    ];
+    for (const p of previews) {
+      const shortId = minifyEmailId(p.id, cache);
+      const attFlag = p.has_attachments ? "\u{1F4CE} (Has Attachments)" : "";
+      const unreadFlag = p.is_read === false ? "\u{1F7E2} [UNREAD]" : "";
+      lines.push(
+        `- **ID**: \`${shortId}\`
+  **Subject**: ${p.subject} ${attFlag} ${unreadFlag}
+  **From**: ${p.sender_name} <${p.sender_email}>
+  **Date**: ${p.received_datetime}
+  **Preview**: ${p.preview_text}
+`
+      );
+    }
+    saveIdCache(cache);
+    lines.push(
+      "\u26A0\uFE0F **ACTION REQUIRED**: To read the full body of an email and download its attachments, call this tool again and provide the exact `email_id`."
+    );
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+  if (data.type === "full_email") {
+    const full = data.full_email || {};
+    const shortTargetId = minifyEmailId(full.id || "unknown_id", cache);
+    saveIdCache(cache);
+    const baseDir = args.working_directory && existsSync2(args.working_directory) ? args.working_directory : tmpdir();
+    const saveDir = join2(
+      baseDir,
+      args.working_directory ? "adeu_attachments" : "adeu_downloads",
+      shortTargetId
+    );
+    mkdirSync2(saveDir, { recursive: true });
+    async function processAttachments(msg) {
+      const localFiles = [];
+      for (const att of msg.attachments || []) {
+        if (att.base64_data) {
+          try {
+            const filepath = getUniqueFilepath(
+              saveDir,
+              att.filename || "unnamed_file"
+            );
+            writeFileSync2(filepath, Buffer.from(att.base64_data, "base64"));
+            localFiles.push(filepath);
+            delete att.base64_data;
+          } catch (e) {
+            console.error(`Failed to save attachment ${att.filename}`, e);
+          }
+        }
+      }
+      return localFiles;
+    }
+    const targetFiles = await processAttachments(full);
+    const lines = [
+      `# Email Thread: ${full.subject}`,
+      "",
+      "## Target Message (Newest):",
+      `**From**: ${full.sender_name} <${full.sender_email}>`,
+      `**Date**: ${full.received_datetime}`
+    ];
+    if (targetFiles.length) {
+      lines.push("**Attachments Saved Locally**:");
+      targetFiles.forEach((f) => lines.push(`- \u{1F4CE} \`${f}\``));
+    }
+    const cleanBody = removeNestedQuotes(stripTags(full.body_html || ""));
+    lines.push(`**Body**:
+\`\`\`
+${cleanBody}
+\`\`\`
+`);
+    if (full.is_thread && full.messages?.length) {
+      lines.push("## Previous Messages in Thread (Historical Context):");
+      for (let i = 0; i < full.messages.length; i++) {
+        const histMsg = full.messages[i];
+        const histFiles = await processAttachments(histMsg);
+        lines.push(
+          `### Message -${i + 1} (Older)
+**From**: ${histMsg.sender_name} <${histMsg.sender_email}>
+**Date**: ${histMsg.received_datetime}`
+        );
+        if (histFiles.length) {
+          lines.push("**Attachments Saved Locally**:");
+          histFiles.forEach((f) => lines.push(`- \u{1F4CE} \`${f}\``));
+        }
+        lines.push(
+          `**Body**:
+\`\`\`
+${removeNestedQuotes(stripTags(histMsg.body_html || ""))}
+\`\`\`
+`
+        );
+      }
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+  return {
+    isError: true,
+    content: [{ type: "text", text: "Unknown response format from backend." }]
+  };
+}
+async function create_email_draft(args) {
+  const apiKey = await getCloudAuthToken();
+  if (!args.reply_to_email_id && (!args.subject || !args.to_recipients)) {
+    throw new Error(
+      "You must provide either 'reply_to_email_id' OR both 'subject' and 'to_recipients'."
+    );
+  }
+  const formData = new FormData();
+  formData.append("body_markdown", args.body_markdown);
+  if (args.reply_to_email_id) {
+    formData.append(
+      "reply_to_email_id",
+      resolveEmailId(args.reply_to_email_id)
+    );
+  }
+  if (args.subject) formData.append("subject", args.subject);
+  if (args.to_recipients) {
+    const recips = typeof args.to_recipients === "string" ? JSON.parse(args.to_recipients) : args.to_recipients;
+    formData.append("to_recipients", JSON.stringify(recips));
+  }
+  if (args.attachment_paths) {
+    const paths = typeof args.attachment_paths === "string" ? JSON.parse(args.attachment_paths) : args.attachment_paths;
+    for (const p of paths) {
+      const buf = readFileSync2(p);
+      const filename = p.split(/[/\\]/).pop();
+      formData.append("files", new Blob([buf]), filename);
+    }
+  }
+  const res = await fetch(`${BACKEND_URL}/api/v1/emails/drafts/new`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+    body: formData
+  });
+  if (res.status === 401) {
+    DesktopAuthManager.clearApiKey();
+    throw new Error(
+      "Authentication expired. Please call `login_to_adeu_cloud`."
+    );
+  }
+  if (!res.ok)
+    throw new Error(`Cloud draft creation failed: ${await res.text()}`);
+  const data = await res.json();
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Successfully created email draft! Draft ID: ${data.id}`
+      }
+    ]
+  };
+}
 // src/index.ts
+function readFileBytesOrThrow(filePath) {
+  try {
+    return readFileSync3(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";
 var PROCESS_BATCH_OPERATIONS_DESC = "Each item in `changes` must specify a `type`:\n1. 'modify': Search-and-replace. `target_text` must uniquely match \u2014 include surrounding context if the phrase is ambiguous. `new_text` supports Markdown: '# Heading 1' through '###### Heading 6', '**bold**', '_italic_', and '\\n\\n' to split into multiple paragraphs. Empty `new_text` deletes. Do NOT write CriticMarkup tags ({++, {--, {>>) manually \u2014 use the `comment` parameter for comments.\n2. 'accept' / 'reject': Finalize or revert a tracked change by `target_id` (e.g. 'Chg:12').\n3. 'reply': Reply to a comment by `target_id` (e.g. 'Com:5') with `text`.\n4. 'insert_row' / 'delete_row': Table edits. Disk mode only \u2014 not supported on Live Word canvas.\n\nID VOLATILITY: 'Chg:N' and 'Com:N' shift between document states. Always call `read_docx` immediately before any accept/reject/reply \u2014 do not reuse IDs from earlier in the conversation.\n\n`author_name` is used for attribution on all tracked changes and comments, in both disk and Live Word modes.";
 var DIFF_DOCX_DESC = "Compares two DOCX files and returns a unified diff of their text content. Useful for analyzing differences between versions before editing.";
-var server = new Server(
+var server = new Server2(
   {
     name: "adeu-redlining-service",
     version: "1.0.0"
@@ -183,12 +630,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 +670,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 +697,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 +715,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,157 +738,289 @@ 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"]
         }
+      },
+      {
+        name: "login_to_adeu_cloud",
+        description: "Logs the user into the Adeu Cloud backend. Securely opens a browser window for authentication.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "logout_of_adeu_cloud",
+        description: "Logs out of the Adeu Cloud backend by clearing the local API key.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "search_and_fetch_emails",
+        description: "Searches the user's live email inbox. By default, searches only the Inbox folder. Returns a list of lightweight previews. Call again with `email_id` to fetch the full body and download attachments.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sender: { type: "string" },
+            subject: { type: "string" },
+            has_attachments: { type: "boolean" },
+            attachment_name: { type: "string" },
+            is_unread: { type: "boolean" },
+            days_ago: { type: "number" },
+            folder: { type: "string", enum: ["inbox", "sent", "all"] },
+            limit: { type: "number", default: 10 },
+            offset: { type: "number", default: 0 },
+            email_id: { type: "string" },
+            working_directory: { type: "string" }
+          }
+        }
+      },
+      {
+        name: "create_email_draft",
+        description: "Creates an email draft in the user's native draft box. Provide `reply_to_email_id` to reply, or `subject` and `to_recipients` for a new email.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            body_markdown: { type: "string" },
+            reply_to_email_id: { type: "string" },
+            subject: { type: "string" },
+            to_recipients: { type: "array", items: { type: "string" } },
+            attachment_paths: { type: "array", items: { type: "string" } }
+          },
+          required: ["body_markdown"]
+        }
       }
     ]
   };
 });
-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}`
+            }
+          ]
+        };
+      }
+      if (name === "login_to_adeu_cloud") {
+        return await login_to_adeu_cloud();
+      }
+      if (name === "logout_of_adeu_cloud") {
+        return await logout_of_adeu_cloud();
+      }
+      if (name === "search_and_fetch_emails") {
+        return await search_and_fetch_emails(args || {});
+      }
+      if (name === "create_email_draft") {
+        return await create_email_draft(args || {});
+      }
+      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