@adeu/mcp-server 1.10.0 → 1.11.2

package/README.md

@@ -39,4 +39,18 @@ Once connected, your AI agent will have access to the following tools:
 - `finalize_document`: Prepares a document for signature by applying native OOXML read-only locking and deep metadata sanitization.
 
 ## Documentation & Support
-For full architectural details, prompt recommendations, and the project constitution, please visit the [main Adeu repository](https://github.com/dealfluence/adeu) or our [website](https://adeu.ai).
+For full architectural details, prompt recommendations, and the project constitution, please visit the [main Adeu repository](https://github.com/dealfluence/adeu) or our [website](https://adeu.ai).
+
+---
+
+## Development Runbook Note: Workspace Linkage Trap
+
+> [!WARNING]
+> **Node MCP: a committed source fix is NOT a running fix.**
+> `dist/` is gitignored and the server runs the compiled bundle. After ANY change to `node/packages/core` or `mcp-server`:
+> 
+> 1. **Relink dependencies:** `cd node && npm install` (relinks `@adeu/core` in the workspace; a copied — not symlinked — core is the #1 cause of "fix didn't take").
+> 2. **Rebuild the workspace:** `npm run build` (core builds before mcp-server; confirm `core/dist` timestamp is updated).
+> 3. **Verify:** Check that the build verification sentinel check succeeds (automatically runs postbuild, or can be run manually via `npm run build:verify` under `packages/mcp-server`).
+> 4. **Restart the MCP server:** Restart the MCP server AND reconnect in the client to flush any cached process states.
+> 5. **Confirm the build stamp:** Verify that the build stamp in the live server (via `server_info` or startup logs) matches your built git HEAD.

package/dist/index.js

@@ -7,7 +7,7 @@ import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
 import { basename as basename2, resolve as resolve2, extname, dirname, join as join3 } from "path";
 import { z } from "zod";
 import {
-  registerAppTool,
+  registerAppTool as origRegisterAppTool,
   registerAppResource,
   RESOURCE_MIME_TYPE
 } from "@modelcontextprotocol/ext-apps/server";
@@ -15,6 +15,7 @@ import fs from "fs";
 import {
   identifyEngine,
   extractTextFromBuffer,
+  _extractTextFromDoc,
   DocumentObject as DocumentObject2,
   RedlineEngine,
   BatchValidationError,
@@ -109,14 +110,15 @@ ${ui_markdown}`;
     }
   };
 }
-function build_outline_response(doc, projected_text, file_path, outline_max_level = 2, outline_verbose = false) {
+function build_outline_response(doc, projected_text, file_path, outline_max_level = 2, outline_verbose = false, paragraph_offsets = null) {
   const [body] = split_structural_appendix(projected_text);
   const pagination_result = paginate(body, "");
   const nodes = extract_outline(
     doc,
     body,
     pagination_result.body_pages,
-    pagination_result.body_page_offsets
+    pagination_result.body_page_offsets,
+    paragraph_offsets
   );
   const rendered = render_outline_tree(
     nodes,
@@ -331,11 +333,14 @@ async function login_to_adeu_cloud() {
     }
     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! Connected to Adeu Cloud as: ${data.email || "Unknown Email"}.`
+          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.`
         }
       ]
     };
@@ -980,7 +985,9 @@ function readFileBytesOrThrow(filePath) {
     return readFileSync3(filePath);
   } catch (err) {
     if (err.code === "ENOENT") {
-      throw new Error(`File not found: ${filePath}`);
+      throw new Error(
+        `File not found: ${filePath}. Note: If you are running in a sandboxed/containerized environment, the host application or MCP server may not have access to your local workspace files. You can resolve this by installing Adeu directly inside your sandboxed environment using 'uv tool install adeu' and executing the commands via the CLI.`
+      );
     }
     throw err;
   }
@@ -998,10 +1005,30 @@ var READ_DOCX_TAIL = "Modes:\n- 'full' (default): paginated body content. Use pa
 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 gitSha = "650c01c";
+var packageVersion = "1.11.2";
+var buildTag = ` [Adeu v${packageVersion}+${gitSha}]`;
 var server = new McpServer({
   name: "adeu-redlining-service",
-  version: "1.0.0"
+  version: packageVersion
 });
+var originalRegisterTool = server.registerTool.bind(server);
+server.registerTool = (name, schema, handler) => {
+  if (schema && typeof schema === "object") {
+    if (schema.description) {
+      schema.description = schema.description.trim() + buildTag;
+    }
+  }
+  return originalRegisterTool(name, schema, handler);
+};
+var registerAppTool = (mcpServer, name, schema, handler) => {
+  if (schema && typeof schema === "object") {
+    if (schema.description) {
+      schema.description = schema.description.trim() + buildTag;
+    }
+  }
+  return origRegisterAppTool(mcpServer, name, schema, handler);
+};
 var UI_CSP = {
   connectDomains: ["https://fonts.googleapis.com", "https://fonts.gstatic.com"],
   resourceDomains: [
@@ -1094,21 +1121,26 @@ registerAppTool(
   }) => {
     try {
       const buf = readFileBytesOrThrow(file_path);
-      const text = await extractTextFromBuffer(buf, clean_view);
       if (mode === "outline") {
         const doc = await DocumentObject2.load(buf);
-        return build_outline_response(
+        const extract_res = _extractTextFromDoc(doc, clean_view, true, true);
+        const res2 = build_outline_response(
           doc,
-          text,
+          extract_res.text,
           file_path,
           outline_max_level,
-          outline_verbose
+          outline_verbose,
+          extract_res.paragraph_offsets
         );
+        return res2;
       }
+      const text = await extractTextFromBuffer(buf, clean_view);
       if (mode === "appendix") {
-        return build_appendix_response(text, page, file_path);
+        const res2 = build_appendix_response(text, page, file_path);
+        return res2;
       }
-      return build_paginated_response(text, page, file_path);
+      const res = build_paginated_response(text, page, file_path);
+      return res;
     } catch (e) {
       return {
         isError: true,
@@ -1167,10 +1199,18 @@ server.registerTool(
       author_name: z.string().describe("Name to appear in Track Changes (e.g., 'Reviewer AI')."),
       changes: z.array(z.any()).describe("List of changes to apply. Each change must specify 'type'."),
       output_path: z.string().optional().describe("Optional output path."),
-      dry_run: z.boolean().optional().default(false).describe("If True, simulates the changes and returns a detailed preview report without modifying any files.")
+      dry_run: z.boolean().optional().default(false).describe(
+        "If True, simulates the changes and returns a detailed preview report without modifying any files."
+      )
     }
   },
-  async ({ original_docx_path, author_name, changes, output_path, dry_run }) => {
+  async ({
+    original_docx_path,
+    author_name,
+    changes,
+    output_path,
+    dry_run
+  }) => {
     try {
       if (!author_name || !author_name.trim())
         return {
@@ -1362,7 +1402,9 @@ ${result.reportText}`
 );
 server.registerTool(
   "login_to_adeu_cloud",
-  { description: "Logs the user into the Adeu Cloud backend." },
+  {
+    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."
+  },
   async () => {
     try {
       return await login_to_adeu_cloud();
@@ -1408,7 +1450,7 @@ server.registerTool(
 server.registerTool(
   "list_available_mailboxes",
   {
-    description: "Lists all personal and shared delegated mailboxes the authenticated user has access to. Returns each mailbox's `email_address`, `display_name`, auto-processing settings, and write-back preference.\n\nCall this FIRST when the user mentions a specific mailbox or shared inbox by name, 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.\n\nOmitting `mailbox_address` on those tools targets the user's primary personal mailbox.",
+    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: {}
   },
   async () => {
@@ -1472,8 +1514,10 @@ ${stats.skipped_details.join("\n")}`;
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  const gitSha2 = "650c01c";
+  const buildTs = "2026-06-17T20:38:12.518Z";
   console.error(
-    `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`
+    `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio build=${gitSha2}@${buildTs}`
   );
 }
 main().catch(console.error);