@adeu/mcp-server 1.15.2 → 1.16.0

package/dist/index.js

@@ -1254,10 +1254,10 @@ function getAssetContent(folder, filename, 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_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 = "23b2879";
-var packageVersion = "1.15.2";
+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.\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 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 = "2179c76";
+var packageVersion = "1.16.0";
 var buildTag = ` [Adeu v${packageVersion}+${gitSha}]`;
 var args = process.argv.slice(2);
 var scopeIdx = args.indexOf("--scope");
@@ -1270,7 +1270,7 @@ var server = new McpServer({
 var originalRegisterTool = server.registerTool.bind(server);
 server.registerTool = (name, schema, handler) => {
   if (schema && typeof schema === "object") {
-    if (schema.description) {
+    if (schema.description && !schema.description.includes(buildTag.trim())) {
       schema.description = schema.description.trim() + buildTag;
     }
   }
@@ -1438,6 +1438,34 @@ registerAppTool(
     }
   }
 );
+var CHANGE_ITEM_SCHEMA = z.object({
+  type: z.enum(["modify", "accept", "reject", "reply", "insert_row", "delete_row"]).describe(
+    "Change kind: 'modify' (search-and-replace), 'accept'/'reject' (resolve a tracked change by id), 'reply' (reply to a comment by id), 'insert_row'/'delete_row' (table edits; disk mode only)."
+  ),
+  target_text: z.string().optional().describe(
+    "modify / insert_row / delete_row: the existing text to locate (interpreted as a regex when regex=true)."
+  ),
+  new_text: z.string().optional().describe(
+    "modify: replacement text. Supports Markdown (headings, **bold**, _italic_, '\\n\\n' paragraph splits); empty string deletes. Regex capture groups are available as $1, $2\u2026"
+  ),
+  target_id: z.string().optional().describe(
+    "accept / reject / reply: the 'Chg:N' or 'Com:N' id taken from a fresh read_docx."
+  ),
+  text: z.string().optional().describe("reply: the reply body."),
+  comment: z.string().optional().describe(
+    "modify / accept / reject: attach a margin comment to the change (no manual CriticMarkup)."
+  ),
+  match_mode: z.enum(["strict", "first", "all"]).optional().describe(
+    "modify only: 'strict' (default \u2014 target must match uniquely), 'first' (first occurrence), or 'all' (every occurrence)."
+  ),
+  regex: z.boolean().optional().describe(
+    "modify only: treat target_text as a regular expression (default false)."
+  ),
+  position: z.enum(["above", "below"]).optional().describe(
+    "insert_row: place the new row above or below the matched row."
+  ),
+  cells: z.array(z.string()).optional().describe("insert_row: the cell values for the new row, left to right.")
+}).passthrough();
 server.registerTool(
   "process_document_batch",
   {
@@ -1445,7 +1473,9 @@ server.registerTool(
     inputSchema: {
       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.any()).describe("List of changes to apply. Each change must specify 'type'."),
+      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."
+      ),
       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."
@@ -1602,7 +1632,7 @@ server.registerTool(
 server.registerTool(
   "finalize_document",
   {
-    description: "Prepares a document for external distribution or e-signature.",
+    description: "Prepares a document for external distribution or e-signature. Note: in this zero-dependency environment, protection_mode='encrypt' is unsupported and falls back to a native read-only lock; export_pdf and password are ignored.",
     inputSchema: {
       file_path: z.string().describe("Absolute path to the DOCX file."),
       output_path: z.string().optional().describe("Optional output path."),
@@ -1610,7 +1640,9 @@ server.registerTool(
       accept_all: z.boolean().optional().describe(
         "If true, auto-accepts all unresolved track changes before finalizing."
       ),
-      protection_mode: z.enum(["read_only", "encrypt"]).optional().describe("Native OOXML document locking."),
+      protection_mode: z.enum(["read_only", "encrypt"]).optional().describe(
+        "Native OOXML document locking. Note: 'encrypt' is unsupported in this zero-dependency build and falls back to 'read_only'."
+      ),
       password: z.string().optional().describe("Ignored in this environment."),
       author: z.string().optional().describe("Replace all remaining markup authorship with this name."),
       export_pdf: z.boolean().optional().describe("Ignored in this environment.")
@@ -1827,8 +1859,8 @@ ${stats.skipped_details.join("\n")}`;
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  const gitSha2 = "23b2879";
-  const buildTs = "2026-06-25T13:51:23.036Z";
+  const gitSha2 = "2179c76";
+  const buildTs = "2026-06-26T07:48:21.832Z";
   console.error(
     `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio build=${gitSha2}@${buildTs}`
   );