@adeu/mcp-server 1.13.0 → 1.15.0

package/dist/index.js

@@ -200,6 +200,128 @@ ${ui_markdown}`;
     }
   };
 }
+function build_search_response(text, search_query, search_regex, search_case_sensitive, page, file_path) {
+  const [body] = split_structural_appendix(text);
+  const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const flags = search_case_sensitive ? "g" : "gi";
+  const patternStr = search_regex ? search_query : escapeRegExp(search_query);
+  let regex;
+  try {
+    regex = new RegExp(patternStr, flags);
+  } catch (e) {
+    throw new Error(`Invalid regex pattern: ${e.message}`);
+  }
+  const matches = Array.from(body.matchAll(regex));
+  if (matches.length === 0) {
+    const ui_markdown2 = `> **Search Results** \u2014 No matches found for query \`${search_query}\` in \`${basename(file_path)}\`.
+
+Verify your search spelling, or try setting \`search_case_sensitive\` to false or enabling \`search_regex\` if you used pattern wildcards.`;
+    const llm_content2 = `> **File Path:** \`${resolve(file_path)}\`
+
+${ui_markdown2}`;
+    return {
+      content: [{ type: "text", text: llm_content2 }],
+      structuredContent: {
+        markdown: ui_markdown2,
+        title: `Search: ${basename(file_path)}`,
+        file_path: resolve(file_path)
+      }
+    };
+  }
+  const pag_res = paginate(body, "");
+  const page_offsets = pag_res.body_page_offsets;
+  const total_matches = matches.length;
+  const total_pages = Math.ceil(total_matches / 10);
+  let start_idx = 0;
+  let end_idx = total_matches;
+  let page_text = "all";
+  const pageStr = String(page).toLowerCase();
+  if (pageStr !== "all") {
+    const page_num = parseInt(pageStr, 10);
+    if (isNaN(page_num) || page_num < 1 || page_num > total_pages) {
+      throw new Error(`Page ${page} out of range (search has ${total_pages} pages).`);
+    }
+    start_idx = (page_num - 1) * 10;
+    end_idx = Math.min(start_idx + 10, total_matches);
+    page_text = `${page_num} of ${total_pages}`;
+  }
+  const page_matches = matches.slice(start_idx, end_idx);
+  const ui_parts = [
+    `> **Search Results** \u2014 Found ${total_matches} matches for query \`${search_query}\` in \`${basename(file_path)}\`.`
+  ];
+  if (total_pages > 1 && pageStr !== "all") {
+    const nextPage = parseInt(pageStr, 10) + 1;
+    ui_parts.push(`> Showing page ${page_text} (matches ${start_idx + 1}-${end_idx}). To see more matches, call \`read_docx\` with \`search_query='${search_query}'\`, \`search_regex=${search_regex ? "true" : "false"}\`, and \`page=${nextPage}\`.`);
+  }
+  const occurrences_map = {};
+  for (const m of matches) {
+    const matched_str = m[0];
+    occurrences_map[matched_str] = (occurrences_map[matched_str] || 0) + 1;
+  }
+  function get_heading(idx, txt) {
+    const txtBefore = txt.substring(0, idx);
+    const lines = txtBefore.split("\n");
+    const path = [];
+    let current_level = 999;
+    for (let i2 = lines.length - 1; i2 >= 0; i2--) {
+      const line = lines[i2];
+      const m = line.match(/^(#{1,6})\s+(.*)/);
+      if (m) {
+        const level = m[1].length;
+        if (level < current_level) {
+          let cleanHeading = m[2].replace(/\*\*|__|[*_]/g, "").replace(/\{#[^}]+\}/g, "").trim();
+          if (cleanHeading.length > 80) {
+            cleanHeading = cleanHeading.substring(0, 80) + "...";
+          }
+          path.unshift(cleanHeading);
+          current_level = level;
+          if (level === 1) break;
+        }
+      }
+    }
+    return path.join(" > ");
+  }
+  let i = start_idx + 1;
+  for (const m of page_matches) {
+    const matched_str = m[0];
+    const m_start = m.index;
+    const m_end = m_start + matched_str.length;
+    let p_num = 1;
+    for (let j = 0; j < page_offsets.length; j++) {
+      if (m_start >= page_offsets[j]) {
+        p_num = j + 1;
+      } else {
+        break;
+      }
+    }
+    const snippet_start = Math.max(0, m_start - 100);
+    const snippet_end = Math.min(body.length, m_end + 100);
+    const snippet = body.substring(snippet_start, m_start) + `**${matched_str}**` + body.substring(m_end, snippet_end);
+    const snippet_lines = snippet.split("\n").filter((line) => line.trim().length > 0).map((line) => `> ${line}`).join("\n");
+    ui_parts.push("---");
+    ui_parts.push(`### Match ${i} (p${p_num})`);
+    const h_path = get_heading(m_start, body);
+    if (h_path) {
+      ui_parts.push(`**Path:** \`${h_path}\``);
+    }
+    const count = occurrences_map[matched_str];
+    ui_parts.push(snippet_lines);
+    ui_parts.push(`*Occurrences:* This exact phrasing appears ${count} time${count !== 1 ? "s" : ""} in the document.`);
+    i++;
+  }
+  const ui_markdown = ui_parts.join("\n\n");
+  const llm_content = `> **File Path:** \`${resolve(file_path)}\`
+
+${ui_markdown}`;
+  return {
+    content: [{ type: "text", text: llm_content }],
+    structuredContent: {
+      markdown: ui_markdown,
+      title: `Search: ${basename(file_path)}`,
+      file_path: resolve(file_path)
+    }
+  };
+}
 
 // src/desktop-auth.ts
 import { createServer } from "http";
@@ -1089,8 +1211,8 @@ 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 = "cab9a8d";
-var packageVersion = "1.13.0";
+var gitSha = "fa47c47";
+var packageVersion = "1.15.0";
 var buildTag = ` [Adeu v${packageVersion}+${gitSha}]`;
 var args = process.argv.slice(2);
 var scopeIdx = args.indexOf("--scope");
@@ -1193,9 +1315,12 @@ registerAppTool(
       mode: z.enum(["full", "outline", "appendix"]).default("full").describe(
         "'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms."
       ),
-      page: z.number().default(1).describe("Page number (1-indexed) for mode='full'. Defaults to 1."),
+      page: z.union([z.number(), z.literal("all")]).default(1).describe("Page number (1-indexed) for mode='full', or 'all' to return unpaginated."),
       outline_max_level: z.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.")
+      outline_verbose: z.boolean().default(false).describe("For mode='outline' only: includes metadata."),
+      search_query: z.string().optional().describe("The substring or regex pattern to search for. When provided, filters results to matching paragraphs."),
+      search_regex: z.boolean().default(false).describe("Set to true to interpret search_query as a regular expression."),
+      search_case_sensitive: z.boolean().default(true).describe("Set to false to perform case-insensitive matching.")
     }),
     _meta: { ui: { resourceUri: MARKDOWN_UI_URI } }
   },
@@ -1205,7 +1330,10 @@ registerAppTool(
     mode,
     page,
     outline_max_level,
-    outline_verbose
+    outline_verbose,
+    search_query,
+    search_regex,
+    search_case_sensitive
   }) => {
     try {
       const buf = readFileBytesOrThrow(file_path);
@@ -1223,11 +1351,15 @@ registerAppTool(
         return res2;
       }
       const text = await extractTextFromBuffer(buf, clean_view);
+      if (search_query !== void 0 && search_query !== null) {
+        const res2 = build_search_response(text, search_query, search_regex, search_case_sensitive, page, file_path);
+        return res2;
+      }
       if (mode === "appendix") {
-        const res2 = build_appendix_response(text, page, file_path);
+        const res2 = build_appendix_response(text, typeof page === "number" ? page : parseInt(page, 10) || 1, file_path);
         return res2;
       }
-      const res = build_paginated_response(text, page, file_path);
+      const res = build_paginated_response(text, typeof page === "number" ? page : parseInt(page, 10) || 1, file_path);
       return res;
     } catch (e) {
       return {
@@ -1274,6 +1406,20 @@ server.registerTool(
         return {
           content: [{ type: "text", text: "Error: No changes provided." }]
         };
+      const sanitizedChanges = changes.map((item) => {
+        if (typeof item === "string") {
+          try {
+            const parsed = JSON.parse(item);
+            if (parsed !== null && typeof parsed === "object") {
+              return parsed;
+            }
+            return item;
+          } catch {
+            return item;
+          }
+        }
+        return item;
+      });
       let outPath = output_path;
       if (!outPath) {
         const ext = extname(original_docx_path);
@@ -1286,7 +1432,7 @@ server.registerTool(
       const engine = new RedlineEngine(doc, author_name);
       let stats;
       try {
-        stats = engine.process_batch(changes, dry_run);
+        stats = engine.process_batch(sanitizedChanges, dry_run);
       } catch (e) {
         if (e instanceof BatchValidationError) {
           return {
@@ -1561,52 +1707,61 @@ function formatBatchResult(stats, outPath, dry_run) {
     res = `Batch complete. Saved to: ${outPath}
 `;
   }
+  const total_occurrences = stats.edits ? stats.edits.reduce((acc, e) => acc + (e.status === "applied" ? e.occurrences_modified || 1 : 0), 0) : 0;
+  const occ_text = total_occurrences > stats.edits_applied ? ` (${total_occurrences} occurrences)` : "";
   res += `Actions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.
 `;
-  res += `Edits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.
+  res += `Edits: ${stats.edits_applied} applied${occ_text}, ${stats.edits_skipped} skipped.
 `;
   if (stats.edits && stats.edits.length > 0) {
     res += "\nDetailed Edit Reports:\n";
     for (let i = 0; i < stats.edits.length; i++) {
       const report = stats.edits[i];
       const status_indicator = report.status === "applied" ? "\u2705 [applied]" : "\u274C [failed]";
-      res += `Edit ${i + 1} ${status_indicator}:
-`;
-      res += `  Target: '${report.target_text}'
+      const pagesStr = report.pages && report.pages.length > 0 ? ` (p${report.pages.join(", p")})` : "";
+      res += `### Edit ${i + 1} ${status_indicator}${pagesStr}
 `;
-      res += `  New text: '${report.new_text}'
+      if (report.heading_path) {
+        res += `**Path:** \`${report.heading_path}\`
 `;
-      if (report.warning) {
-        res += `  Warning: ${report.warning}
+      }
+      if (report.match_mode) {
+        const occ = report.occurrences_modified || (report.status === "applied" ? 1 : 0);
+        res += `**Mode:** \`${report.match_mode}\` (${occ} occurrence${occ !== 1 ? "s" : ""} modified)
 `;
       }
       if (report.error) {
-        res += `  Error: ${report.error}
+        res += `*Error:* ${report.error}
+`;
+      }
+      if (report.warning) {
+        res += `*Warning:* ${report.warning}
 `;
       }
       if (report.critic_markup) {
-        res += `  Preview (CriticMarkup): ${report.critic_markup}
+        res += `*Preview (CriticMarkup):*
+> ${report.critic_markup.split("\\n").join("\\n> ")}
 `;
       }
       if (report.clean_text) {
-        res += `  Clean text preview: ${report.clean_text}
+        res += `*Preview (Clean):*
+> ${report.clean_text.split("\\n").join("\\n> ")}
 `;
       }
+      res += "\n";
     }
   }
   if (stats.skipped_details && stats.skipped_details.length > 0) {
-    res += `
-
-Skipped Details:
+    res += `Skipped Details:
 ${stats.skipped_details.join("\n")}`;
   }
-  return res;
+  return res.trim();
 }
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  const gitSha2 = "cab9a8d";
-  const buildTs = "2026-06-23T13:51:25.626Z";
+  const gitSha2 = "fa47c47";
+  const buildTs = "2026-06-25T10:39:47.565Z";
   console.error(
     `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio build=${gitSha2}@${buildTs}`
   );