@adeu/mcp-server 1.20.0 → 1.22.0

package/dist/index.js

@@ -3,8 +3,8 @@
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
-import { basename as basename2, resolve as resolve2, extname, dirname, join as join3 } from "path";
+import { readFileSync, existsSync } from "fs";
+import { basename as basename2, resolve as resolve2, extname, dirname, join } from "path";
 import { z } from "zod";
 import {
   registerAppTool as origRegisterAppTool,
@@ -22,13 +22,16 @@ import {
   create_word_patch_diff,
   finalize_document
 } from "@adeu/core";
+import { describe_illegal_control_chars } from "@adeu/core";
 
 // src/response-builders.ts
 import { resolve, basename } from "path";
 import {
   paginate,
   split_structural_appendix,
-  extract_outline
+  extract_outline,
+  RegexTimeoutError,
+  userFindAllMatches
 } from "@adeu/core";
 function _build_appendix_pointer(has_appendix) {
   if (!has_appendix) return "";
@@ -79,6 +82,21 @@ Document has ${nodes.length} headings, all at deeper levels. Call read_docx with
   }
   return lines.join("\n");
 }
+function build_full_document_response(text, file_path) {
+  const [body] = split_structural_appendix(text);
+  const ui_markdown = body;
+  const llm_content = `> **File Path:** \`${resolve(file_path)}\`
+
+${ui_markdown}`;
+  return {
+    content: [{ type: "text", text: llm_content }],
+    structuredContent: {
+      markdown: ui_markdown,
+      file_path: resolve(file_path),
+      title: basename(file_path)
+    }
+  };
+}
 function build_paginated_response(text, page, file_path) {
   const [body, appendix] = split_structural_appendix(text);
   const has_appendix = Boolean(appendix.trim());
@@ -111,6 +129,7 @@ ${ui_markdown}`;
   };
 }
 function build_outline_response(doc, projected_text, file_path, outline_max_level = 2, outline_verbose = false, paragraph_offsets = null) {
+  outline_max_level = Math.max(1, Math.min(outline_max_level, 6));
   const [body] = split_structural_appendix(projected_text);
   const pagination_result = paginate(body, "");
   const nodes = extract_outline(
@@ -206,9 +225,11 @@ function build_search_response(text, search_query, search_regex, search_case_sen
   const flags = search_case_sensitive ? "g" : "gi";
   let regexDowngradedNote = "";
   let regex;
+  let isUserRegex = false;
   if (search_regex) {
     try {
       regex = new RegExp(search_query, flags);
+      isUserRegex = true;
     } catch (e) {
       regexDowngradedNote = `> **Note:** \`${search_query}\` is not a valid regular expression (${e.message}), so it was searched as literal text instead. If you meant a regex, fix the pattern; if you meant literal text, set \`search_regex\` to false.`;
       regex = new RegExp(escapeRegExp(search_query), flags);
@@ -216,7 +237,21 @@ function build_search_response(text, search_query, search_regex, search_case_sen
   } else {
     regex = new RegExp(escapeRegExp(search_query), flags);
   }
-  const allMatches = Array.from(body.matchAll(regex));
+  let allMatches;
+  if (isUserRegex) {
+    try {
+      allMatches = userFindAllMatches(search_query, body, flags).map((m) => ({
+        0: body.slice(m.start, m.end),
+        index: m.start
+      }));
+    } catch (e) {
+      if (!(e instanceof RegexTimeoutError)) throw e;
+      regexDowngradedNote = `> **Note:** \`${search_query}\` was searched as literal text instead of as a regular expression: ${e.message}`;
+      allMatches = Array.from(body.matchAll(new RegExp(escapeRegExp(search_query), flags)));
+    }
+  } else {
+    allMatches = Array.from(body.matchAll(regex));
+  }
   const pag_res = paginate(body, "");
   const page_offsets = pag_res.body_page_offsets;
   const total_doc_pages = pag_res.total_pages;
@@ -377,901 +412,8 @@ ${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";
 var MARKDOWN_UI_URI = "ui://adeu/markdown-ui";
-var EMAIL_UI_URI = "ui://adeu/email-ui";
-
-// 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"
-      },
-      signal: AbortSignal.timeout(15e3)
-    });
-    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();
-    const email = data.email || "Unknown Email";
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Login successful. You are now authenticated to Adeu Cloud as the user who owns the provider account \`${email}\` (the account used for SSO).
-
-This single login grants access to ALL of this user's linked provider accounts and ALL of their mailboxes for the duration of this session \u2014 not just \`${email}\`. Call \`list_available_mailboxes\` to see every mailbox that can be queried or drafted from.`
-        }
-      ]
-    };
-  } 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 KNOWN_ERROR_HINTS = {
-  "Email not found.": "The email ID was not found. If this was a short ID (msg_*), it may have been evicted from the local cache or come from a different machine \u2014 re-run search_and_fetch_emails with filters to get a fresh ID. If it was an adeu_<numeric> or raw provider ID, verify it's correct. If the email lives in a shared or secondary mailbox, pass `mailbox_address` explicitly \u2014 provider IDs only resolve within the mailbox they came from.",
-  "Adeu email reference not found.": "The adeu_<id> reference doesn't resolve to any processed email for this user. Verify the ID, or re-run search_and_fetch_emails with filters to find the message.",
-  "Invalid adeu_ email ID format.": "The adeu_<id> reference is malformed. Expected format: adeu_<integer>."
-};
-function lookupErrorHint(detail) {
-  let hint = KNOWN_ERROR_HINTS[detail];
-  if (!hint && detail.startsWith("Mailbox '") && detail.endsWith("' not found.")) {
-    const mailbox = detail.slice("Mailbox '".length, -"' not found.".length);
-    hint = `The mailbox '${mailbox}' is not connected to your Adeu account. Call list_available_mailboxes to see valid mailbox addresses, then retry with one of those as \`mailbox_address\`.`;
-  }
-  return hint;
-}
-function formatBackendError(statusCode, responseBody) {
-  let detail = responseBody;
-  try {
-    const parsed = JSON.parse(responseBody);
-    if (parsed && typeof parsed === "object" && "detail" in parsed) {
-      detail = String(parsed.detail);
-    }
-  } catch {
-  }
-  const message = lookupErrorHint(detail) ?? detail;
-  return `Cloud search failed (HTTP ${statusCode}): ${message}`;
-}
-function isTimeoutError(err) {
-  if (!err || typeof err !== "object") return false;
-  const name = err.name;
-  return name === "TimeoutError" || name === "AbortError";
-}
-var CACHE_FILE = join2(homedir2(), ".adeu", "mcp_id_cache.json");
-var MAX_CACHE_SIZE = 1e3;
-function formatBytes(bytes) {
-  if (bytes == null) return "unknown size";
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-function cacheEntryParts(entry) {
-  if (!entry) return { id: null, mailbox: null };
-  if (typeof entry === "string") return { id: entry, mailbox: null };
-  return { id: entry.id ?? null, mailbox: entry.mailbox ?? null };
-}
-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, mailboxAddress) {
-  if (!realId) return realId;
-  const hash = createHash("md5").update(realId).digest("hex").slice(0, 6);
-  const shortId = `msg_${hash}`;
-  cache[shortId] = { id: realId, mailbox: mailboxAddress ?? null };
-  return shortId;
-}
-var StaleShortIdError = class extends Error {
-  constructor(shortId) {
-    super(
-      `Short ID '${shortId}' is not in the local cache (it may have been evicted, or it came from a different machine/session). Short IDs only persist on the machine where they were generated. Re-run search_and_fetch_emails with filters (sender, subject, days_ago) to fetch fresh IDs, then use the new ID from those results.`
-    );
-    this.name = "StaleShortIdError";
-  }
-};
-function resolveEmailId(shortId) {
-  if (!shortId) return shortId;
-  if (shortId.startsWith("adeu_")) return shortId;
-  const cache = loadIdCache();
-  const { id } = cacheEntryParts(cache[shortId]);
-  if (id) return id;
-  if (shortId.startsWith("msg_")) {
-    throw new StaleShortIdError(shortId);
-  }
-  return shortId;
-}
-function resolveCachedMailbox(shortId) {
-  if (!shortId || !shortId.startsWith("msg_")) return null;
-  return cacheEntryParts(loadIdCache()[shortId]).mailbox;
-}
-var HTML_NAMED_ENTITIES = {
-  nbsp: " ",
-  amp: "&",
-  lt: "<",
-  gt: ">",
-  quot: '"',
-  apos: "'",
-  copy: "\xA9",
-  reg: "\xAE",
-  trade: "\u2122",
-  hellip: "\u2026",
-  mdash: "\u2014",
-  ndash: "\u2013",
-  lsquo: "\u2018",
-  rsquo: "\u2019",
-  ldquo: "\u201C",
-  rdquo: "\u201D",
-  laquo: "\xAB",
-  raquo: "\xBB",
-  bull: "\u2022",
-  middot: "\xB7",
-  deg: "\xB0",
-  plusmn: "\xB1",
-  times: "\xD7",
-  divide: "\xF7",
-  euro: "\u20AC",
-  pound: "\xA3",
-  yen: "\xA5",
-  cent: "\xA2",
-  sect: "\xA7",
-  para: "\xB6",
-  iexcl: "\xA1",
-  iquest: "\xBF"
-};
-function decodeHtmlEntities(text) {
-  text = text.replace(/&#(\d+);/g, (_, dec) => {
-    const code = parseInt(dec, 10);
-    return Number.isFinite(code) ? String.fromCodePoint(code) : _;
-  });
-  text = text.replace(/&#[xX]([0-9a-fA-F]+);/g, (_, hex) => {
-    const code = parseInt(hex, 16);
-    return Number.isFinite(code) ? String.fromCodePoint(code) : _;
-  });
-  text = text.replace(/&([a-zA-Z][a-zA-Z0-9]*);/g, (match, name) => {
-    const replacement = HTML_NAMED_ENTITIES[name.toLowerCase()];
-    return replacement !== void 0 ? replacement : match;
-  });
-  return text;
-}
-function stripTags(html) {
-  if (!html) return "";
-  let text = html;
-  const suppressPattern = /<(style|script|head|title)\b[^>]*>[\s\S]*?<\/\1\s*>/gi;
-  let prev;
-  do {
-    prev = text;
-    text = text.replace(suppressPattern, "");
-  } while (text !== prev);
-  text = text.replace(/<(style|script|head|title)\b[^>]*>[\s\S]*$/gi, "");
-  text = text.replace(
-    /<\/?(p|div|br|hr|tr|li|h[1-6]|blockquote)\b[^>]*>/gi,
-    "\n"
-  );
-  text = text.replace(/<[^>]+>/g, "");
-  text = decodeHtmlEntities(text);
-  return text.replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
-}
-function removeNestedQuotes(text) {
-  if (!text) return "";
-  const fromTokens = [
-    "From",
-    // English
-    "L\xE4hett\xE4j\xE4",
-    // Finnish
-    "Fr\xE5n",
-    // Swedish
-    "Von",
-    // German
-    "De",
-    // French / Spanish / Portuguese
-    "Da",
-    // Italian
-    "Van",
-    // Dutch
-    "Fra",
-    // Norwegian / Danish
-    "Mittente"
-    // Italian (alt)
-  ];
-  const sentTokens = [
-    "Sent",
-    "L\xE4hetetty",
-    "Skickat",
-    "Gesendet",
-    "Envoy\xE9",
-    "Enviado",
-    "Inviato",
-    "Verzonden",
-    "Sendt"
-  ];
-  const wrotePatterns = [
-    /On .{1,200}? wrote:/,
-    // English
-    /Le .{1,200}? a écrit\s*:/i,
-    // French
-    /Am .{1,200}? schrieb .{1,100}?:/i,
-    // German
-    /El .{1,200}? escribió\s*:/i,
-    // Spanish
-    /Il .{1,200}? ha scritto\s*:/i,
-    // Italian
-    /Op .{1,200}? schreef .{1,100}?:/i,
-    // Dutch
-    /Den .{1,200}? skrev .{1,100}?:/i,
-    // Swedish/Norwegian/Danish
-    /Em .{1,200}? escreveu\s*:/i,
-    // Portuguese
-    /Em\b.{1,200}?, .{1,200}? escreveu\s*:/i,
-    // Portuguese (date prefix)
-    new RegExp(
-      `^(${fromTokens.join("|")})\\s*:.*?\\n(?:.*\\n){0,5}?(${sentTokens.join("|")})\\s*:`,
-      "m"
-    )
-  ];
-  const forwardedTokens = [
-    "Forwarded message",
-    "V\xE4litetty viesti",
-    "Vidarebefordrat meddelande",
-    "Weitergeleitete Nachricht",
-    "Message transf\xE9r\xE9",
-    "Mensaje reenviado",
-    "Messaggio inoltrato",
-    "Doorgestuurd bericht",
-    "Videresendt melding",
-    "Videresendt meddelelse",
-    "Mensagem encaminhada"
-  ].join("|");
-  const dividerPatterns = [
-    /_{10,}/m,
-    /-----\s*(Original Message|Alkuperäinen viesti|Ursprüngliches Nachricht|Message d'origine|Mensaje original|Messaggio originale|Oorspronkelijk bericht|Original meddelande)\s*-----/im,
-    /^(Original Message|Alkuperäinen viesti|Ursprüngliches Nachricht|Message d'origine|Mensaje original|Messaggio originale|Oorspronkelijk bericht)$/im,
-    // Gmail/Outlook-style "---------- Forwarded message ---------" with localized variants
-    new RegExp(`-+\\s*(${forwardedTokens})\\s*-+`, "i"),
-    new RegExp(`^(${forwardedTokens})$`, "im")
-  ];
-  const allPatterns = [...wrotePatterns, ...dividerPatterns];
-  let earliestCut = text.length;
-  for (const pattern of allPatterns) {
-    const match = pattern.exec(text);
-    if (match && match.index < earliestCut) {
-      earliestCut = match.index;
-    }
-  }
-  return text.substring(0, earliestCut).trim();
-}
-function getUniqueFilepath(saveDir, filename) {
-  return join2(saveDir, filename);
-}
-async function pollEmailTask(taskId, apiKey) {
-  const pollUrl = `${BACKEND_URL}/api/v1/emails/tasks/${taskId}`;
-  for (let attempt = 0; attempt < 10; attempt++) {
-    let res;
-    try {
-      res = await fetch(pollUrl, {
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          Accept: "application/json"
-        },
-        signal: AbortSignal.timeout(15e3)
-      });
-    } catch (err) {
-      if (isTimeoutError(err)) {
-        throw new Error("Checking task status timed out.");
-      }
-      throw err;
-    }
-    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(formatBackendError(res.status, await res.text()));
-    }
-    const taskData = await res.json();
-    const status = taskData.status;
-    if (status === "COMPLETED") {
-      return taskData;
-    }
-    if (status === "FAILED") {
-      const errorMsg = taskData.error || "Unknown internal error";
-      const hint = lookupErrorHint(errorMsg);
-      throw new Error(`Validation task failed on the server: ${hint ?? errorMsg}`);
-    }
-    await new Promise((resolve3) => setTimeout(resolve3, 5e3));
-  }
-  return null;
-}
-async function search_and_fetch_emails(args2) {
-  const apiKey = await getCloudAuthToken();
-  const maxAttachmentSizeMb = typeof args2.max_attachment_size_mb === "number" && args2.max_attachment_size_mb > 0 ? args2.max_attachment_size_mb : 10;
-  let effectiveMailbox = args2.mailbox_address;
-  let data;
-  if (args2.task_id) {
-    const completedData = await pollEmailTask(args2.task_id, apiKey);
-    if (!completedData) {
-      const msg = `Task ${args2.task_id} is still processing. Please call \`search_and_fetch_emails\` again with task_id=${args2.task_id}.`;
-      return {
-        content: [{ type: "text", text: msg }],
-        structuredContent: {
-          status: "pending",
-          task_id: args2.task_id,
-          message: msg
-        }
-      };
-    }
-    data = completedData;
-  } else {
-    let realEmailId;
-    try {
-      realEmailId = args2.email_id ? resolveEmailId(args2.email_id) : void 0;
-    } catch (err) {
-      if (err instanceof StaleShortIdError) {
-        return {
-          isError: true,
-          content: [{ type: "text", text: err.message }]
-        };
-      }
-      throw err;
-    }
-    if (args2.email_id && !effectiveMailbox) {
-      const cachedMailbox = resolveCachedMailbox(args2.email_id);
-      if (cachedMailbox) effectiveMailbox = cachedMailbox;
-    }
-    const payload = {
-      email_id: realEmailId,
-      sender: args2.sender,
-      subject: args2.subject,
-      has_attachments: args2.has_attachments,
-      attachment_name: args2.attachment_name,
-      is_unread: args2.is_unread,
-      days_ago: args2.days_ago,
-      folder: args2.folder,
-      limit: args2.limit ?? 10,
-      offset: args2.offset ?? 0,
-      mailbox_address: effectiveMailbox
-    };
-    Object.keys(payload).forEach(
-      (k) => payload[k] === void 0 && delete payload[k]
-    );
-    let res;
-    try {
-      res = await fetch(`${BACKEND_URL}/api/v1/emails/search`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(payload),
-        signal: AbortSignal.timeout(45e3)
-      });
-    } catch (err) {
-      if (isTimeoutError(err)) {
-        throw new Error(
-          "Email search timed out after 45s. The mail provider (Outlook/Gmail) may be slow. Try narrowing the search with more filters (sender, subject, days_ago), or retry shortly."
-        );
-      }
-      throw err;
-    }
-    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(formatBackendError(res.status, await res.text()));
-    data = await res.json();
-    if (res.status === 202 || data && (data.status === "pending" || data.task_id) && data.type === void 0) {
-      const newTaskId = data.task_id;
-      const completedData = await pollEmailTask(String(newTaskId), apiKey);
-      if (!completedData) {
-        const msg = `Task ${newTaskId} is still processing. Please call \`search_and_fetch_emails\` again immediately with task_id=${newTaskId} to monitor the progress.`;
-        return {
-          content: [{ type: "text", text: msg }],
-          structuredContent: {
-            status: "pending",
-            task_id: String(newTaskId),
-            message: msg
-          }
-        };
-      }
-      data = completedData;
-    }
-  }
-  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."
-          }
-        ],
-        // Keep the UI channel populated (Python parity) — without it the
-        // widget's tool-result handler bails and the skeleton spins forever.
-        structuredContent: data
-      };
-    const lines = [
-      `Found ${previews.length} email(s). Here are the previews:`,
-      ""
-    ];
-    for (const p of previews) {
-      const shortId = minifyEmailId(p.id, cache, effectiveMailbox);
-      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);
-    const limit = typeof args2.limit === "number" ? args2.limit : 10;
-    const offset = typeof args2.offset === "number" ? args2.offset : 0;
-    const pageHint = previews.length >= limit ? `
-*(If you need to see more results, call this tool again with offset=${offset + limit})*` : "";
-    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`." + pageHint
-    );
-    return {
-      content: [{ type: "text", text: lines.join("\n") }],
-      structuredContent: data
-    };
-  }
-  if (data.type === "full_email") {
-    const full = data.full_email || {};
-    const shortTargetId = minifyEmailId(
-      full.id || "unknown_id",
-      cache,
-      effectiveMailbox
-    );
-    saveIdCache(cache);
-    const autoEscalated = !args2.email_id && (args2.sender !== void 0 || args2.subject !== void 0 || args2.has_attachments !== void 0 || args2.attachment_name !== void 0 || args2.is_unread !== void 0 || args2.days_ago !== void 0 || args2.folder !== void 0);
-    let baseDir = tmpdir();
-    let usedWorkingDirectory = false;
-    let dirFallbackNote = null;
-    if (args2.working_directory) {
-      try {
-        mkdirSync2(args2.working_directory, { recursive: true });
-        baseDir = args2.working_directory;
-        usedWorkingDirectory = true;
-      } catch (e) {
-        dirFallbackNote = `\u26A0\uFE0F **Attachment location notice**: the requested \`working_directory\` (\`${args2.working_directory}\`) did not exist and could not be created (${e.message}). Any attachments were saved to the system temp directory instead \u2014 use the exact paths listed below; do NOT re-run the search expecting a different location.`;
-      }
-    }
-    const saveDir = join2(
-      baseDir,
-      usedWorkingDirectory ? "adeu_attachments" : "adeu_downloads",
-      shortTargetId
-    );
-    mkdirSync2(saveDir, { recursive: true });
-    async function processAttachments(msg) {
-      const localFiles = [];
-      const skipped = [];
-      const maxBytes = maxAttachmentSizeMb * 1024 * 1024;
-      for (const att of msg.attachments || []) {
-        const filename = att.filename || "unnamed_file";
-        const size = typeof att.size_bytes === "number" ? att.size_bytes : null;
-        if (size != null && size > maxBytes) {
-          skipped.push({
-            filename,
-            size_bytes: size,
-            reason: `exceeds ${maxAttachmentSizeMb} MB cap`
-          });
-          delete att.base64_data;
-          continue;
-        }
-        if (att.base64_data) {
-          try {
-            const filepath = getUniqueFilepath(saveDir, filename);
-            writeFileSync2(filepath, Buffer.from(att.base64_data, "base64"));
-            localFiles.push(filepath);
-            att.local_path = filepath;
-            delete att.base64_data;
-          } catch (e) {
-            console.error(`Failed to save attachment ${filename}`, e);
-            skipped.push({
-              filename,
-              size_bytes: size,
-              reason: `download failed: ${e.message}`
-            });
-          }
-        }
-      }
-      return { localFiles, skipped };
-    }
-    const { localFiles: targetFiles, skipped: targetSkipped } = await processAttachments(full);
-    const lines = [];
-    if (autoEscalated) {
-      lines.push(
-        "_(Search returned exactly one result; auto-fetched full email below.)_\n"
-      );
-    }
-    if (dirFallbackNote) {
-      lines.push(dirFallbackNote + "\n");
-    }
-    lines.push(
-      `# 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}\``));
-    }
-    if (targetSkipped.length) {
-      lines.push(
-        `**Attachments Skipped (not downloaded)** \u2014 pass \`max_attachment_size_mb\` to raise the ${maxAttachmentSizeMb} MB cap:`
-      );
-      targetSkipped.forEach(
-        (s) => lines.push(
-          `- \u26A0\uFE0F \`${s.filename}\` (${formatBytes(s.size_bytes)}, ${s.reason})`
-        )
-      );
-    }
-    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 { localFiles: histFiles, skipped: histSkipped } = 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}\``));
-        }
-        if (histSkipped.length) {
-          lines.push(
-            `**Attachments Skipped (not downloaded)** \u2014 pass \`max_attachment_size_mb\` \u2014 raise the cap:`
-          );
-          histSkipped.forEach(
-            (s) => lines.push(
-              `- \u26A0\uFE0F \`${s.filename}\` (${formatBytes(s.size_bytes)}, ${s.reason})`
-            )
-          );
-        }
-        lines.push(
-          `**Body**:
-\`\`\`
-${removeNestedQuotes(stripTags(histMsg.body_html || ""))}
-\`\`\`
-`
-        );
-      }
-    }
-    const hasAttachments = targetFiles.length > 0 || full.messages && full.messages.some(
-      (m) => m.attachments && m.attachments.length > 0
-    );
-    if (hasAttachments) {
-      lines.push(
-        "\n*You can now use tools like `read_docx`, `diff_docx_files`, or `finalize_document` on the local file paths listed under each message. These paths are on the user's machine \u2014 pass them directly to those tools; your own sandbox/shell may not see them, and that does NOT mean the download failed.*"
-      );
-    }
-    return {
-      content: [{ type: "text", text: lines.join("\n") }],
-      structuredContent: data
-    };
-  }
-  return {
-    isError: true,
-    content: [{ type: "text", text: "Unknown response format from backend." }],
-    structuredContent: data
-  };
-}
-async function create_email_draft(args2) {
-  const apiKey = await getCloudAuthToken();
-  if (!args2.reply_to_email_id && (!args2.subject || !args2.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", args2.body_markdown);
-  if (args2.reply_to_email_id) {
-    try {
-      formData.append(
-        "reply_to_email_id",
-        resolveEmailId(args2.reply_to_email_id)
-      );
-    } catch (err) {
-      if (err instanceof StaleShortIdError) {
-        return {
-          isError: true,
-          content: [{ type: "text", text: err.message }]
-        };
-      }
-      throw err;
-    }
-  }
-  if (args2.subject) formData.append("subject", args2.subject);
-  let draftMailbox = args2.mailbox_address;
-  if (args2.reply_to_email_id && !draftMailbox) {
-    const cachedMailbox = resolveCachedMailbox(args2.reply_to_email_id);
-    if (cachedMailbox) draftMailbox = cachedMailbox;
-  }
-  if (draftMailbox) {
-    formData.append("mailbox_address", draftMailbox);
-  }
-  if (args2.to_recipients) {
-    const recips = typeof args2.to_recipients === "string" ? JSON.parse(args2.to_recipients) : args2.to_recipients;
-    formData.append("to_recipients", JSON.stringify(recips));
-  }
-  if (args2.attachment_paths) {
-    const paths = typeof args2.attachment_paths === "string" ? JSON.parse(args2.attachment_paths) : args2.attachment_paths;
-    for (const p of paths) {
-      const buf = readFileSync2(p);
-      const filename = p.split(/[/\\]/).pop();
-      formData.append("files", new Blob([buf]), filename);
-    }
-  }
-  let res;
-  try {
-    res = await fetch(`${BACKEND_URL}/api/v1/emails/drafts/new`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        Accept: "application/json"
-      },
-      body: formData,
-      signal: AbortSignal.timeout(9e4)
-    });
-  } catch (err) {
-    if (isTimeoutError(err)) {
-      throw new Error(
-        "Draft creation timed out after 90s. If the draft includes large attachments, try splitting them across multiple drafts or omitting the largest files."
-      );
-    }
-    throw err;
-  }
-  if (res.status === 401) {
-    DesktopAuthManager.clearApiKey();
-    throw new Error(
-      "Authentication expired. Please call `login_to_adeu_cloud`."
-    );
-  }
-  if (!res.ok)
-    throw new Error(formatBackendError(res.status, await res.text()));
-  const data = await res.json();
-  return {
-    content: [
-      {
-        type: "text",
-        text: `Successfully created email draft! Draft ID: ${data.id}`
-      }
-    ]
-  };
-}
-async function list_available_mailboxes() {
-  const apiKey = await getCloudAuthToken();
-  let res;
-  try {
-    res = await fetch(`${BACKEND_URL}/api/v1/users/me/shared-mailboxes`, {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        Accept: "application/json"
-      },
-      signal: AbortSignal.timeout(15e3)
-    });
-  } catch (err) {
-    if (isTimeoutError(err)) {
-      throw new Error(
-        "Listing mailboxes timed out after 15s. The Adeu backend may be temporarily unavailable; retry shortly."
-      );
-    }
-    throw err;
-  }
-  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(formatBackendError(res.status, await res.text()));
-  }
-  const mailboxes = await res.json();
-  if (!mailboxes.length) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: "No configured mailboxes found for your profile."
-        }
-      ]
-    };
-  }
-  mailboxes.sort(
-    (a, b) => (a.email_address ?? "").toLowerCase().localeCompare((b.email_address ?? "").toLowerCase())
-  );
-  const lines = [
-    "### Connected Mailboxes",
-    "Below is the list of connected mailboxes you have access to. Use the `email_address` as the `mailbox_address` parameter in other tools to query or draft from a specific mailbox:",
-    ""
-  ];
-  for (const box of mailboxes) {
-    lines.push(
-      `- **${box.display_name || "Personal Mailbox"}**
-  - **Email Address**: \`${box.email_address}\`
-  - **Auto-Processing**: ${box.auto_process_enabled ? "Enabled" : "Disabled"}
-  - **Write-Back Mode**: \`${box.write_back_preference}\``
-    );
-  }
-  return {
-    content: [{ type: "text", text: lines.join("\n") }]
-  };
-}
 
 // src/index.ts
 var MATCH_MODE_SYNONYMS = {
@@ -1306,7 +448,7 @@ function coerceChangeItemInPlace(item) {
 }
 function readFileBytesOrThrow(filePath) {
   try {
-    return readFileSync3(filePath);
+    return readFileSync(filePath);
   } catch (err) {
     if (err.code === "ENOENT") {
       let available = "";
@@ -1323,24 +465,20 @@ function readFileBytesOrThrow(filePath) {
 }
 var DIST_DIR = import.meta.dirname;
 function getAssetContent(folder, filename, fallbackMessage) {
-  const filePath = join3(DIST_DIR, folder, filename);
-  if (existsSync3(filePath)) {
-    return readFileSync3(filePath, "utf-8");
+  const filePath = join(DIST_DIR, folder, filename);
+  if (existsSync(filePath)) {
+    return readFileSync(filePath, "utf-8");
   }
   return fallbackMessage;
 }
 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_COMMON_DESC = "Applies a batch of edits and review actions to a DOCX.\n\nBatches apply SEQUENTIALLY: each change is validated and applied against the document state produced by the changes before it, so you may chain dependent edits within one batch (e.g. rename X to Y, then modify Y \u2014 the second edit must target Y, the text as it reads after the rename). Validation failures reject the whole batch transactionally: nothing is applied until every change resolves.\n\n";
 var PROCESS_BATCH_OPERATIONS_DESC = "Each item in `changes` must specify a `type`:\n1. 'modify': Search-and-replace. By default `target_text` must match uniquely (`match_mode`:'strict') \u2014 add surrounding context to disambiguate, or set `match_mode`:'first'/'all' to edit the first or every occurrence. Set `regex`:true to treat `target_text` as a regular expression (capture groups available in `new_text` as $1, $2\u2026). `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.\n   \u2022 EMPTY/FORM TABLE CELLS: a blank cell has no text to match. `read_docx` renders each cell with a trailing `{#cell:<id>}` anchor \u2014 to fill a blank cell, set `target_text` to that exact anchor (e.g. '{#cell:0000005E}') and put the value in `new_text`. Do NOT try to match the pipe layout ('Date |  |  |'); the pipes are display separators, not editable text.\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. The `{#cell:<id>}` anchors are stable (Word-assigned) and safe to reuse across reads.\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 compact `@@ Word Patch @@` diff \u2014 Adeu's token-level, sub-word patch format \u2014 of their text content. Useful for analyzing differences between versions before editing.";
-var gitSha = "c60ac0a";
-var packageVersion = "1.20.0";
+var gitSha = "4947f97";
+var packageVersion = "1.22.0";
 var buildTag = ` [Adeu v${packageVersion}+${gitSha}]`;
-var args = process.argv.slice(2);
-var scopeIdx = args.indexOf("--scope");
-var requestedScope = (scopeIdx !== -1 ? args[scopeIdx + 1] : "all").toLowerCase();
-var isDocxOnly = requestedScope === "docx";
 var server = new McpServer({
   name: "adeu-redlining-service",
   version: packageVersion
@@ -1399,31 +537,6 @@ registerAppResource(
     };
   }
 );
-registerAppResource(
-  server,
-  EMAIL_UI_URI,
-  EMAIL_UI_URI,
-  { mimeType: RESOURCE_MIME_TYPE, description: "Adeu Email Viewer UI" },
-  async () => {
-    let html = getAssetContent(
-      "templates",
-      "email_ui.html",
-      "<html><body>UI Template Not Found</body></html>"
-    );
-    const svg = getAssetContent("assets", "adeu.svg", "");
-    html = html.replace("[[ adeu_svg_code ]]", svg);
-    return {
-      contents: [
-        {
-          uri: EMAIL_UI_URI,
-          mimeType: RESOURCE_MIME_TYPE,
-          text: html,
-          _meta: { ui: { csp: UI_CSP } }
-        }
-      ]
-    };
-  }
-);
 registerAppTool(
   server,
   "read_docx",
@@ -1442,7 +555,7 @@ registerAppTool(
         "'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms."
       ),
       page: z.union([z.number(), z.string()]).optional().describe(
-        "Without `search_query`: 1-indexed document page to display (defaults to 1). With `search_query`: restricts matches to that document page (defaults to searching all pages; pass `page='all'` to be explicit)."
+        "Without `search_query`: 1-indexed document page to display (defaults to 1). With `search_query`: restricts matches to that document page (defaults to searching all pages; pass `page='all'` to be explicit). Note: pages are synthetic, length-based content chunks sized for LLM consumption \u2014 they do NOT correspond to printed Word pages or explicit page breaks."
       ),
       outline_max_level: z.coerce.number().default(2).describe("For mode='outline' only: cap on heading depth."),
       outline_verbose: z.boolean().default(false).describe("For mode='outline' only: includes metadata."),
@@ -1501,7 +614,26 @@ registerAppTool(
         );
         return res2;
       }
-      const resolvedPage = page === void 0 || page === null ? 1 : typeof page === "number" ? page : parseInt(String(page), 10) || 1;
+      if (mode === "full" && page !== void 0 && page !== null && String(page).trim().toLowerCase() === "all") {
+        const res2 = build_full_document_response(text, file_path);
+        return res2;
+      }
+      let resolvedPage = 1;
+      if (page !== void 0 && page !== null) {
+        const parsed = typeof page === "number" ? page : parseInt(String(page).trim(), 10);
+        if (!Number.isFinite(parsed)) {
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: `Invalid page value: '${page}'. Provide a positive integer (pages are 1-indexed; 'all' is valid for mode='full' and together with search_query).`
+              }
+            ]
+          };
+        }
+        resolvedPage = parsed;
+      }
       if (mode === "appendix") {
         const res2 = build_appendix_response(text, resolvedPage, file_path);
         return res2;
@@ -1560,7 +692,7 @@ server.registerTool(
       original_docx_path: z.string().describe("Absolute path to the source file."),
       author_name: z.string().describe("Name to appear in Track Changes (e.g., 'Reviewer AI')."),
       changes: z.array(z.union([z.string(), CHANGE_ITEM_SCHEMA])).describe(
-        "Ordered list of changes to apply. Each item is an object carrying a `type` discriminator plus that type's fields (see the per-field docs and the tool description). All items evaluate against the ORIGINAL document state."
+        "Ordered list of changes to apply. Each item is an object carrying a `type` discriminator plus that type's fields (see the per-field docs and the tool description). Items apply SEQUENTIALLY: each one evaluates against the document state produced by the items before it, so later items may target text an earlier item introduced."
       ),
       output_path: z.string().optional().describe("Optional output path."),
       dry_run: z.boolean().optional().default(false).describe(
@@ -1584,6 +716,16 @@ server.registerTool(
             { type: "text", text: "Error: author_name cannot be empty." }
           ]
         };
+      const author_ctrl = describe_illegal_control_chars(author_name);
+      if (author_ctrl)
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: author_name contains control character(s) (${author_ctrl}) that cannot be stored in a DOCX. Remove them and retry.`
+            }
+          ]
+        };
       if (!changes || changes.length === 0)
         return {
           content: [{ type: "text", text: "Error: No changes provided." }]
@@ -1667,9 +809,26 @@ ${e.errors.join("\n\n")}`
       }
       if (!dry_run) {
         const outBuf = await doc.save();
-        fs.writeFileSync(outPath, outBuf);
+        try {
+          fs.writeFileSync(outPath, outBuf);
+        } catch (e) {
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: `Could not write output file '${outPath}': ${e.message}`
+              }
+            ]
+          };
+        }
+      }
+      let res = formatBatchResult(stats, outPath, !!dry_run);
+      if (sanitizedChanges.length === 0) {
+        res = `\u26A0\uFE0F 0 changes provided \u2014 nothing to do. The output is an unmodified copy of the original.
+
+` + res;
       }
-      const res = formatBatchResult(stats, outPath, !!dry_run);
       return { content: [{ type: "text", text: res }] };
     } catch (e) {
       return {
@@ -1829,130 +988,6 @@ ${result.reportText}`
     }
   }
 );
-if (!isDocxOnly) {
-  registerAppTool(
-    server,
-    "search_and_fetch_emails",
-    {
-      title: "Search & Fetch Emails",
-      description: "Searches the user's live email inbox via the Adeu cloud backend.\n\nTWO MODES:\n1. Search mode (no `email_id`): returns up to `limit` lightweight previews. Use filters (`sender`, `subject`, `is_unread`, `days_ago`, `folder`, `has_attachments`, `attachment_name`) to narrow down.\n2. Fetch mode (with `email_id`): returns the full email body, thread history, and downloads attachments under `max_attachment_size_mb` to the local disk.\n\nAUTO-ESCALATION: If a search returns exactly one preview, the backend automatically fetches the full email in the same call. Plan around the response shape \u2014 check the `type` field (`previews` vs `full_email`) before assuming.\n\nEMAIL ID FORMATS (`email_id` parameter accepts any of):\n- `msg_<6 chars>` \u2014 short ID returned by previews on THIS machine. NOT portable across machines or sessions; the local cache holds the most recent 1000. If you reference one that's been evicted, the tool returns a StaleShortIdError telling you to re-search. The mailbox used in the original search is remembered with the short ID and re-applied automatically when you fetch or reply without specifying `mailbox_address`.\n- `adeu_<numeric>` \u2014 server-side reference for emails Adeu has previously processed. Portable across machines and sessions for the same authenticated user.\n- Raw provider ID (Gmail/Outlook native ID) \u2014 works if you have it, but you usually won't.\n\nFOLDER DEFAULT: omitting `folder` searches the Inbox only (matching what the user sees in their mail client). Use `folder='sent'` for sent items, `folder='all'` to include Deleted Items, Drafts, and other folders.\n\nATTACHMENTS: attachments larger than `max_attachment_size_mb` (default 10) are listed in the response but NOT downloaded \u2014 raise the cap if you need them. Always set `working_directory` when calling from a project so attachments land alongside the user's other files; the directory is created automatically if it does not exist. This directory path refers to the user's native operating system, not the LLM's sandbox environment.",
-      inputSchema: z.object({
-        reasoning: z.string().describe(
-          "Why do I need to search or fetch these emails? State this reason before any other parameter."
-        ),
-        sender: z.string().optional(),
-        subject: z.string().optional(),
-        has_attachments: z.boolean().optional(),
-        attachment_name: z.string().optional(),
-        is_unread: z.boolean().optional(),
-        days_ago: z.coerce.number().optional(),
-        folder: z.enum(["inbox", "sent", "all"]).optional(),
-        limit: z.coerce.number().default(10),
-        offset: z.coerce.number().default(0),
-        email_id: z.string().optional(),
-        working_directory: z.string().optional().describe(
-          "Optional. The current working directory of the project or task. If provided, attachments will be saved here under an 'adeu_attachments' subfolder; the directory is created automatically if it does not exist. If omitted, attachments are saved to the system temp directory."
-        ),
-        mailbox_address: z.string().optional().describe("Optional target mailbox email address to search within."),
-        task_id: z.string().optional().describe("If resuming a pending check, provide the task ID here."),
-        max_attachment_size_mb: z.coerce.number().optional().describe(
-          "Maximum attachment size in MB to download (default 10). Attachments larger than this are listed in the response but not downloaded. Raise this to fetch large files."
-        )
-      }),
-      _meta: { ui: { resourceUri: EMAIL_UI_URI } }
-    },
-    async (args2) => {
-      try {
-        return await search_and_fetch_emails(args2);
-      } catch (e) {
-        return {
-          isError: true,
-          content: [{ type: "text", text: e.message }]
-        };
-      }
-    }
-  );
-  server.registerTool(
-    "login_to_adeu_cloud",
-    {
-      description: "Logs the user into Adeu Cloud. Opens a browser window for SSO authentication.\n\nIMPORTANT \u2014 login is user-level, not account-level:\n- An Adeu user can have multiple linked provider accounts (Microsoft, Google) and multiple mailboxes (personal + shared/delegated). One linked account is marked primary.\n- Signing in through ANY of the user's linked accounts authenticates the same Adeu user. Once logged in, the session can read from and draft in ALL of that user's linked accounts and ALL of their mailboxes \u2014 not just the one used to sign in.\n- The choice of which provider account to sign in through is purely an SSO mechanism; it does not select a 'current account' for the session.\n\nWhen the user asks which accounts or mailboxes are available, call `list_available_mailboxes` rather than naming a single account from the login response.",
-      inputSchema: {
-        reasoning: z.string().describe(
-          "Why do I need to log in to Adeu Cloud? State this reason before any other parameter."
-        )
-      }
-    },
-    async () => {
-      try {
-        return await login_to_adeu_cloud();
-      } catch (e) {
-        return { isError: true, content: [{ type: "text", text: e.message }] };
-      }
-    }
-  );
-  server.registerTool(
-    "logout_of_adeu_cloud",
-    {
-      description: "Logs out of the Adeu Cloud backend.",
-      inputSchema: {
-        reasoning: z.string().describe(
-          "Why do I need to log out of Adeu Cloud? State this reason before any other parameter."
-        )
-      }
-    },
-    async () => {
-      try {
-        return await logout_of_adeu_cloud();
-      } catch (e) {
-        return { isError: true, content: [{ type: "text", text: e.message }] };
-      }
-    }
-  );
-  server.registerTool(
-    "create_email_draft",
-    {
-      description: "Creates an email draft in the user's native draft box (Outlook Drafts or Gmail Drafts).\n\nTWO MODES:\n1. Reply mode: pass `reply_to_email_id` to create a threaded reply. The draft inherits subject, recipients, and threading headers from the original \u2014 do NOT pass `subject` or `to_recipients`.\n2. New email mode: omit `reply_to_email_id` and pass BOTH `subject` and `to_recipients`.\n\n`reply_to_email_id` accepts the same ID formats as search_and_fetch_emails (`msg_*` short IDs, `adeu_*` references, or raw provider IDs). Short IDs are validated against the local cache before the call; stale ones fail fast with a clear error telling you to re-search.\n\n`body_markdown` is converted server-side to styled HTML with inlined CSS for email-client compatibility. Write the body in plain Markdown \u2014 do not pre-render HTML.\n\n`attachment_paths` takes absolute file paths on the user's local disk and uploads them with the draft. Useful right after search_and_fetch_emails downloaded attachments \u2014 those local paths can be passed directly here.",
-      inputSchema: {
-        reasoning: z.string().describe(
-          "Why do I need to create this email draft? State this reason before any other parameter."
-        ),
-        body_markdown: z.string(),
-        reply_to_email_id: z.string().optional(),
-        subject: z.string().optional(),
-        to_recipients: z.array(z.string()).optional(),
-        attachment_paths: z.array(z.string()).optional(),
-        mailbox_address: z.string().optional().describe(
-          "Optional target mailbox email address to create the draft in."
-        )
-      }
-    },
-    async (args2) => {
-      try {
-        return await create_email_draft(args2);
-      } catch (e) {
-        return { isError: true, content: [{ type: "text", text: e.message }] };
-      }
-    }
-  );
-  server.registerTool(
-    "list_available_mailboxes",
-    {
-      description: "Lists all personal and shared/delegated mailboxes the authenticated Adeu user has access to, across ALL of their linked provider accounts. Returns each mailbox's `email_address`, `display_name`, auto-processing settings, and write-back preference.\n\nThis is the right tool to answer 'which accounts/mailboxes am I logged into?' \u2014 Adeu login is user-level, so a single MCP session can see every mailbox listed here regardless of which provider account was used for SSO.\n\nCall this FIRST when the user names a specific mailbox or shared inbox, to resolve the canonical `email_address`. Then pass that address as `mailbox_address` to `search_and_fetch_emails` or `create_email_draft` to scope the operation. Omitting `mailbox_address` on those tools targets the user's primary personal mailbox.",
-      inputSchema: {
-        reasoning: z.string().describe(
-          "Why do I need to list available mailboxes? State this reason before any other parameter."
-        )
-      }
-    },
-    async () => {
-      try {
-        return await list_available_mailboxes();
-      } catch (e) {
-        return { isError: true, content: [{ type: "text", text: e.message }] };
-      }
-    }
-  );
-}
 function formatBatchResult(stats, outPath, dry_run) {
   let res = "";
   if (dry_run) {
@@ -2018,8 +1053,8 @@ ${stats.skipped_details.join("\n")}`;
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  const gitSha2 = "c60ac0a";
-  const buildTs = "2026-07-16T10:28:45.581Z";
+  const gitSha2 = "4947f97";
+  const buildTs = "2026-07-18T07:52:19.202Z";
   console.error(
     `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio build=${gitSha2}@${buildTs}`
   );