@adeu/mcp-server 1.6.2 → 1.6.5

package/dist/index.js

@@ -1,3 +1,5 @@
+#!/usr/bin/env node
+
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/response-builders.ts"],"sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\r\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\r\nimport { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';\r\nimport { readFileSync } from 'node:fs';\r\nimport { basename, resolve, extname, dirname } from 'node:path';\r\nimport { \r\n  identifyEngine, \r\n  extractTextFromBuffer, \r\n  DocumentObject, \r\n  RedlineEngine, \r\n  BatchValidationError \r\n} from '@adeu/core';\r\nimport { \r\n  build_paginated_response, \r\n  build_outline_response, \r\n  build_appendix_response \r\n} from './response-builders.js';\r\n\r\n// --- Tool Description Constants (Parity with Python) ---\r\nconst 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\";\r\nconst READ_DOCX_TAIL = \"Modes:\\n- 'full' (default): paginated body content. Use page=N to navigate.\\n- 'outline': heading map only — 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.\";\r\n\r\nconst PROCESS_BATCH_COMMON_DESC = \"Applies a batch of edits and review actions to a DOCX.\\n\\nAll changes evaluate against the ORIGINAL document state — 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\";\r\nconst PROCESS_BATCH_OPERATIONS_DESC = \"Each item in `changes` must specify a `type`:\\n1. 'modify': Search-and-replace. `target_text` must uniquely match — 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 — 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 — 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 — 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.\";\r\n\r\n// --- Server Setup ---\r\nconst server = new Server(\r\n  {\r\n    name: 'adeu-redlining-service',\r\n    version: '1.0.0',\r\n  },\r\n  {\r\n    capabilities: {\r\n      tools: {},\r\n    },\r\n  }\r\n);\r\n\r\n// --- Tool Registration ---\r\nserver.setRequestHandler(ListToolsRequestSchema, async () => {\r\n  return {\r\n    tools: [\r\n      {\r\n        name: 'read_docx',\r\n        description: READ_DOCX_COMMON_DESC + READ_DOCX_TAIL,\r\n        inputSchema: {\r\n          type: 'object',\r\n          properties: {\r\n            file_path: { type: 'string', description: 'Absolute path to the DOCX file.' },\r\n            clean_view: { type: 'boolean', description: \"If False (default), returns the 'Raw' text with inline CriticMarkup. If True, returns 'Accepted' text.\", default: false },\r\n            mode: { type: 'string', enum: ['full', 'outline', 'appendix'], description: \"'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms.\", default: 'full' },\r\n            page: { type: 'number', description: 'Page number (1-indexed) for mode=\\'full\\'. Defaults to 1.', default: 1 },\r\n            outline_max_level: { type: 'number', description: 'For mode=\\'outline\\' only: cap on heading depth.', default: 2 },\r\n            outline_verbose: { type: 'boolean', description: 'For mode=\\'outline\\' only: includes metadata.', default: false }\r\n          },\r\n          required: ['file_path']\r\n        }\r\n      },\r\n      {\r\n        name: 'process_document_batch',\r\n        description: PROCESS_BATCH_COMMON_DESC + PROCESS_BATCH_OPERATIONS_DESC,\r\n        inputSchema: {\r\n          type: 'object',\r\n          properties: {\r\n            original_docx_path: { type: 'string', description: 'Absolute path to the source file.' },\r\n            author_name: { type: 'string', description: \"Name to appear in Track Changes (e.g., 'Reviewer AI').\" },\r\n            changes: { \r\n              type: 'array', \r\n              description: \"List of changes to apply. Each change must specify 'type'.\",\r\n              items: { type: 'object' } \r\n            },\r\n            output_path: { type: 'string', description: 'Optional output path.' }\r\n          },\r\n          required: ['original_docx_path', 'author_name', 'changes']\r\n        }\r\n      },\r\n      {\r\n        name: 'accept_all_changes',\r\n        description: \"Accepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines.\",\r\n        inputSchema: {\r\n          type: 'object',\r\n          properties: {\r\n            docx_path: { type: 'string', description: 'Absolute path to the DOCX file.' },\r\n            output_path: { type: 'string', description: 'Optional output path.' }\r\n          },\r\n          required: ['docx_path']\r\n        }\r\n      }\r\n    ]\r\n  };\r\n});\r\n\r\n// --- Tool Execution ---\r\nserver.setRequestHandler(CallToolRequestSchema, async (request): Promise<any> => {\r\n  const { name, arguments: args } = request.params;\r\n\r\n  try {\r\n    if (name === 'read_docx') {\r\n      const filePath = args?.file_path as string;\r\n      const cleanView = args?.clean_view as boolean ?? false;\r\n      const mode = args?.mode as string ?? 'full';\r\n      const page = args?.page as number ?? 1;\r\n      const outline_max_level = args?.outline_max_level as number ?? 2;\r\n      const outline_verbose = args?.outline_verbose as boolean ?? false;\r\n      \r\n      const buf = readFileSync(filePath);\r\n      const text = await extractTextFromBuffer(buf, cleanView);\r\n      \r\n      if (mode === 'outline') {\r\n        const doc = await DocumentObject.load(buf);\r\n        return build_outline_response(doc, text, filePath, outline_max_level, outline_verbose);\r\n      }\r\n      if (mode === 'appendix') {\r\n        return build_appendix_response(text, page, filePath);\r\n      }\r\n      return build_paginated_response(text, page, filePath);\r\n    }\r\n\r\n    if (name === 'process_document_batch') {\r\n      const origPath = args?.original_docx_path as string;\r\n      const authorName = args?.author_name as string;\r\n      const changes = args?.changes as any[];\r\n      let outPath = args?.output_path as string;\r\n\r\n      if (!outPath) {\r\n        const ext = extname(origPath);\r\n        const base = basename(origPath, ext);\r\n        const dir = dirname(origPath);\r\n        outPath = resolve(dir, `${base}_processed${ext}`);\r\n      }\r\n\r\n      const buf = readFileSync(origPath);\r\n      const doc = await DocumentObject.load(buf);\r\n      const engine = new RedlineEngine(doc, authorName);\r\n      \r\n      let stats;\r\n      try {\r\n        stats = engine.process_batch(changes);\r\n      } catch (e) {\r\n        if (e instanceof BatchValidationError) {\r\n          return {\r\n            content: [{ type: 'text', text: `Batch rejected. Some edits failed validation:\\n\\n${(e as BatchValidationError).errors.join('\\n\\n')}` }],\r\n            isError: true\r\n          };\r\n        }\r\n        throw e;\r\n      }\r\n\r\n      const outBuf = await doc.save();\r\n      // Using dynamic import of fs/promises or just sync write\r\n      const fs = await import('node:fs');\r\n      fs.writeFileSync(outPath, outBuf);\r\n\r\n      let res = `Batch complete. Saved to: ${outPath}\\nActions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.\\nEdits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.`;\r\n      if (stats.skipped_details?.length > 0) {\r\n        res += `\\n\\nSkipped Details:\\n${stats.skipped_details.join('\\n')}`;\r\n      }\r\n\r\n      return {\r\n        content: [{ type: 'text', text: res }]\r\n      };\r\n    }\r\n\r\n    if (name === 'accept_all_changes') {\r\n      const docxPath = args?.docx_path as string;\r\n      let outPath = args?.output_path as string;\r\n\r\n      if (!outPath) {\r\n        const ext = extname(docxPath);\r\n        const base = basename(docxPath, ext);\r\n        const dir = dirname(docxPath);\r\n        outPath = resolve(dir, `${base}_clean${ext}`);\r\n      }\r\n\r\n      const buf = readFileSync(docxPath);\r\n      const doc = await DocumentObject.load(buf);\r\n      const engine = new RedlineEngine(doc);\r\n      \r\n      // We implement the public facing accept_all wrapper from python\r\n      engine.accept_all_revisions();\r\n      \r\n      const outBuf = await doc.save();\r\n      const fs = await import('node:fs');\r\n      fs.writeFileSync(outPath, outBuf);\r\n\r\n      return {\r\n        content: [{ type: 'text', text: `Accepted all changes. Saved to: ${outPath}` }]\r\n      };\r\n    }\r\n\r\n    throw new Error(`Unknown tool: ${name}`);\r\n\r\n  } catch (error: any) {\r\n    return {\r\n      content: [{ type: 'text', text: `Error executing tool ${name}: ${error.message}` }],\r\n      isError: true,\r\n    };\r\n  }\r\n});\r\n\r\n// --- Startup ---\r\nasync function main() {\r\n  const transport = new StdioServerTransport();\r\n  await server.connect(transport);\r\n  console.error(`Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`);\r\n}\r\n\r\nmain().catch(console.error);","import { resolve, basename } from 'node:path';\r\nimport { \r\n  DocumentObject, \r\n  paginate, \r\n  split_structural_appendix, \r\n  extract_outline, \r\n  OutlineNode \r\n} from '@adeu/core';\r\n\r\nexport interface ToolResult {\r\n  content: { type: 'text'; text: string }[];\r\n  isError?: boolean;\r\n  [key: string]: unknown;\r\n}\r\n\r\nfunction _build_appendix_pointer(has_appendix: boolean): string {\r\n  if (!has_appendix) return '';\r\n  return `\\n\\n---\\n\\n> **Appendix available.** This document has structural metadata (defined terms, cross-references, bookmarks, diagnostics) that may be relevant when editing. Call \\`read_docx\\` with \\`mode='appendix'\\` to load it before submitting edits.`;\r\n}\r\n\r\nfunction _build_page_banner(page: number, total: number): string {\r\n  if (total <= 1) return '';\r\n  return `> **Page ${page} of ${total}** — call \\`read_docx\\` with \\`mode='outline'\\` for a heading map of the full document.\\n\\n---\\n\\n`;\r\n}\r\n\r\nfunction _build_page_footer(page: number, total: number, has_next: boolean): string {\r\n  if (total <= 1 || !has_next) return '';\r\n  return `\\n\\n---\\n\\n> **Continues on page ${page + 1} of ${total}.**`;\r\n}\r\n\r\nexport function render_outline_tree(nodes: OutlineNode[], max_level: number = 2, verbose: boolean = false): string {\r\n  if (!nodes || nodes.length === 0) {\r\n    return '# (No headings detected)\\n\\nThis document has no detectable headings.';\r\n  }\r\n\r\n  const visible = nodes.filter(n => n.level <= max_level);\r\n\r\n  if (visible.length === 0) {\r\n    return `# (No headings at level <= ${max_level})\\n\\nDocument has ${nodes.length} headings, all at deeper levels. Call read_docx with mode='outline' and outline_max_level=N (up to 6) to see them.`;\r\n  }\r\n\r\n  const lines: string[] = [];\r\n  for (const node of visible) {\r\n    const prefix = '#'.repeat(node.level);\r\n    if (verbose) {\r\n      const meta_parts = [`p${node.page}`, node.style];\r\n      if (node.has_table) meta_parts.push('has table');\r\n      if (node.footnote_ids && node.footnote_ids.length > 0) meta_parts.push('fn:' + node.footnote_ids.join(','));\r\n      lines.push(`${prefix} ${node.text} (${meta_parts.join(', ')})`);\r\n    } else {\r\n      lines.push(`${prefix} ${node.text} (p${node.page})`);\r\n    }\r\n  }\r\n  return lines.join('\\n');\r\n}\r\n\r\nexport function build_paginated_response(text: string, page: number, file_path: string): ToolResult {\r\n  const [body, appendix] = split_structural_appendix(text);\r\n  const has_appendix = Boolean(appendix.trim());\r\n\r\n  const result = paginate(body, '');\r\n\r\n  if (page < 1 || page > result.total_pages) {\r\n    throw new Error(`Page ${page} out of range (doc has ${result.total_pages} pages).`);\r\n  }\r\n\r\n  const selected = result.pages[page - 1];\r\n  const banner = _build_page_banner(selected.page, selected.total_pages);\r\n  const footer = _build_page_footer(selected.page, selected.total_pages, selected.has_next);\r\n  const appendix_pointer = _build_appendix_pointer(has_appendix);\r\n  \r\n  const ui_markdown = banner + selected.page_content + footer + appendix_pointer;\r\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\r\n\r\n  return {\r\n    content: [{ type: 'text', text: llm_content }]\r\n  };\r\n}\r\n\r\nexport function build_outline_response(\r\n  doc: DocumentObject, \r\n  projected_text: string, \r\n  file_path: string, \r\n  outline_max_level: number = 2, \r\n  outline_verbose: boolean = false\r\n): ToolResult {\r\n  const [body] = split_structural_appendix(projected_text);\r\n  const pagination_result = paginate(body, '');\r\n\r\n  const nodes = extract_outline(\r\n    doc,\r\n    body,\r\n    pagination_result.body_pages,\r\n    pagination_result.body_page_offsets\r\n  );\r\n\r\n  const rendered = render_outline_tree(nodes, outline_max_level, outline_verbose);\r\n\r\n  const visible_count = nodes.filter(n => n.level <= outline_max_level).length;\r\n  const deeper_count = nodes.length - visible_count;\r\n  const deeper_hint = deeper_count > 0 ? ` (${deeper_count} more at deeper levels, raise outline_max_level to see)` : '';\r\n\r\n  const header = `> **Outline view** — showing ${visible_count} of ${nodes.length} headings (L1-L${outline_max_level}${deeper_hint}) across ${pagination_result.total_pages} page(s). Call \\`read_docx\\` with \\`mode='full'\\` and \\`page=N\\` to read a section.\\n\\n---\\n\\n`;\r\n  const ui_markdown = header + rendered;\r\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\r\n\r\n  return {\r\n    content: [{ type: 'text', text: llm_content }]\r\n  };\r\n}\r\n\r\nexport function build_appendix_response(text: string, page: number, file_path: string): ToolResult {\r\n  const [, appendix] = split_structural_appendix(text);\r\n\r\n  if (!appendix.trim()) {\r\n    const ui_markdown = \"# Appendix\\n\\nThis document has no structural appendix (no defined terms, named anchors, or diagnostics detected).\";\r\n    const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\r\n    return {\r\n      content: [{ type: 'text', text: llm_content }]\r\n    };\r\n  }\r\n\r\n  const result = paginate(appendix, '');\r\n\r\n  if (page < 1 || page > result.total_pages) {\r\n    throw new Error(`Appendix page ${page} out of range (appendix has ${result.total_pages} pages).`);\r\n  }\r\n\r\n  const selected = result.pages[page - 1];\r\n\r\n  let banner = '';\r\n  let footer = '';\r\n\r\n  if (selected.total_pages > 1) {\r\n    banner = `> **Appendix page ${selected.page} of ${selected.total_pages}** — structural metadata for this document.\\n\\n---\\n\\n`;\r\n    footer = selected.has_next ? `\\n\\n---\\n\\n> **Continues on appendix page ${selected.page + 1} of ${selected.total_pages}.**` : '';\r\n  } else {\r\n    banner = \"> **Appendix** — structural metadata for this document.\\n\\n---\\n\\n\";\r\n  }\r\n\r\n  const ui_markdown = banner + selected.page_content + footer;\r\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\r\n\r\n  return {\r\n    content: [{ type: 'text', text: llm_content }]\r\n  };\r\n}"],"mappings":";AAAA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AACrC,SAAS,uBAAuB,8BAA8B;AAC9D,SAAS,oBAAoB;AAC7B,SAAS,YAAAA,WAAU,WAAAC,UAAS,SAAS,eAAe;AACpD;AAAA,EACE;AAAA,EACA;AAAA,EACA,kBAAAC;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACXP,SAAS,eAAyB;AAClC;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAQP,SAAS,wBAAwB,cAA+B;AAC9D,MAAI,CAAC,aAAc,QAAO;AAC1B,SAAO;AAAA;AAAA;AAAA;AAAA;AACT;AAEA,SAAS,mBAAmB,MAAc,OAAuB;AAC/D,MAAI,SAAS,EAAG,QAAO;AACvB,SAAO,YAAY,IAAI,OAAO,KAAK;AAAA;AAAA;AAAA;AAAA;AACrC;AAEA,SAAS,mBAAmB,MAAc,OAAe,UAA2B;AAClF,MAAI,SAAS,KAAK,CAAC,SAAU,QAAO;AACpC,SAAO;AAAA;AAAA;AAAA;AAAA,wBAAoC,OAAO,CAAC,OAAO,KAAK;AACjE;AAEO,SAAS,oBAAoB,OAAsB,YAAoB,GAAG,UAAmB,OAAe;AACjH,MAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,MAAM,OAAO,OAAK,EAAE,SAAS,SAAS;AAEtD,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,8BAA8B,SAAS;AAAA;AAAA,eAAqB,MAAM,MAAM;AAAA,EACjF;AAEA,QAAM,QAAkB,CAAC;AACzB,aAAW,QAAQ,SAAS;AAC1B,UAAM,SAAS,IAAI,OAAO,KAAK,KAAK;AACpC,QAAI,SAAS;AACX,YAAM,aAAa,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK;AAC/C,UAAI,KAAK,UAAW,YAAW,KAAK,WAAW;AAC/C,UAAI,KAAK,gBAAgB,KAAK,aAAa,SAAS,EAAG,YAAW,KAAK,QAAQ,KAAK,aAAa,KAAK,GAAG,CAAC;AAC1G,YAAM,KAAK,GAAG,MAAM,IAAI,KAAK,IAAI,KAAK,WAAW,KAAK,IAAI,CAAC,GAAG;AAAA,IAChE,OAAO;AACL,YAAM,KAAK,GAAG,MAAM,IAAI,KAAK,IAAI,MAAM,KAAK,IAAI,GAAG;AAAA,IACrD;AAAA,EACF;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,yBAAyB,MAAc,MAAc,WAA+B;AAClG,QAAM,CAAC,MAAM,QAAQ,IAAI,0BAA0B,IAAI;AACvD,QAAM,eAAe,QAAQ,SAAS,KAAK,CAAC;AAE5C,QAAM,SAAS,SAAS,MAAM,EAAE;AAEhC,MAAI,OAAO,KAAK,OAAO,OAAO,aAAa;AACzC,UAAM,IAAI,MAAM,QAAQ,IAAI,0BAA0B,OAAO,WAAW,UAAU;AAAA,EACpF;AAEA,QAAM,WAAW,OAAO,MAAM,OAAO,CAAC;AACtC,QAAM,SAAS,mBAAmB,SAAS,MAAM,SAAS,WAAW;AACrE,QAAM,SAAS,mBAAmB,SAAS,MAAM,SAAS,aAAa,SAAS,QAAQ;AACxF,QAAM,mBAAmB,wBAAwB,YAAY;AAE7D,QAAM,cAAc,SAAS,SAAS,eAAe,SAAS;AAC9D,QAAM,cAAc,sBAAsB,QAAQ,SAAS,CAAC;AAAA;AAAA,EAAS,WAAW;AAEhF,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,YAAY,CAAC;AAAA,EAC/C;AACF;AAEO,SAAS,uBACd,KACA,gBACA,WACA,oBAA4B,GAC5B,kBAA2B,OACf;AACZ,QAAM,CAAC,IAAI,IAAI,0BAA0B,cAAc;AACvD,QAAM,oBAAoB,SAAS,MAAM,EAAE;AAE3C,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA,kBAAkB;AAAA,IAClB,kBAAkB;AAAA,EACpB;AAEA,QAAM,WAAW,oBAAoB,OAAO,mBAAmB,eAAe;AAE9E,QAAM,gBAAgB,MAAM,OAAO,OAAK,EAAE,SAAS,iBAAiB,EAAE;AACtE,QAAM,eAAe,MAAM,SAAS;AACpC,QAAM,cAAc,eAAe,IAAI,KAAK,YAAY,4DAA4D;AAEpH,QAAM,SAAS,qCAAgC,aAAa,OAAO,MAAM,MAAM,kBAAkB,iBAAiB,GAAG,WAAW,YAAY,kBAAkB,WAAW;AAAA;AAAA;AAAA;AAAA;AACzK,QAAM,cAAc,SAAS;AAC7B,QAAM,cAAc,sBAAsB,QAAQ,SAAS,CAAC;AAAA;AAAA,EAAS,WAAW;AAEhF,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,YAAY,CAAC;AAAA,EAC/C;AACF;AAEO,SAAS,wBAAwB,MAAc,MAAc,WAA+B;AACjG,QAAM,CAAC,EAAE,QAAQ,IAAI,0BAA0B,IAAI;AAEnD,MAAI,CAAC,SAAS,KAAK,GAAG;AACpB,UAAMC,eAAc;AACpB,UAAMC,eAAc,sBAAsB,QAAQ,SAAS,CAAC;AAAA;AAAA,EAASD,YAAW;AAChF,WAAO;AAAA,MACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAMC,aAAY,CAAC;AAAA,IAC/C;AAAA,EACF;AAEA,QAAM,SAAS,SAAS,UAAU,EAAE;AAEpC,MAAI,OAAO,KAAK,OAAO,OAAO,aAAa;AACzC,UAAM,IAAI,MAAM,iBAAiB,IAAI,+BAA+B,OAAO,WAAW,UAAU;AAAA,EAClG;AAEA,QAAM,WAAW,OAAO,MAAM,OAAO,CAAC;AAEtC,MAAI,SAAS;AACb,MAAI,SAAS;AAEb,MAAI,SAAS,cAAc,GAAG;AAC5B,aAAS,qBAAqB,SAAS,IAAI,OAAO,SAAS,WAAW;AAAA;AAAA;AAAA;AAAA;AACtE,aAAS,SAAS,WAAW;AAAA;AAAA;AAAA;AAAA,iCAA6C,SAAS,OAAO,CAAC,OAAO,SAAS,WAAW,QAAQ;AAAA,EAChI,OAAO;AACL,aAAS;AAAA,EACX;AAEA,QAAM,cAAc,SAAS,SAAS,eAAe;AACrD,QAAM,cAAc,sBAAsB,QAAQ,SAAS,CAAC;AAAA;AAAA,EAAS,WAAW;AAEhF,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,YAAY,CAAC;AAAA,EAC/C;AACF;;;AD/HA,IAAM,wBAAwB;AAC9B,IAAM,iBAAiB;AAEvB,IAAM,4BAA4B;AAClC,IAAM,gCAAgC;AAGtC,IAAM,SAAS,IAAI;AAAA,EACjB;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AAAA,EACA;AAAA,IACE,cAAc;AAAA,MACZ,OAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;AAGA,OAAO,kBAAkB,wBAAwB,YAAY;AAC3D,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,aAAa,wBAAwB;AAAA,QACrC,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,WAAW,EAAE,MAAM,UAAU,aAAa,kCAAkC;AAAA,YAC5E,YAAY,EAAE,MAAM,WAAW,aAAa,0GAA0G,SAAS,MAAM;AAAA,YACrK,MAAM,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,WAAW,UAAU,GAAG,aAAa,8GAA8G,SAAS,OAAO;AAAA,YAC1M,MAAM,EAAE,MAAM,UAAU,aAAa,2DAA6D,SAAS,EAAE;AAAA,YAC7G,mBAAmB,EAAE,MAAM,UAAU,aAAa,kDAAoD,SAAS,EAAE;AAAA,YACjH,iBAAiB,EAAE,MAAM,WAAW,aAAa,+CAAiD,SAAS,MAAM;AAAA,UACnH;AAAA,UACA,UAAU,CAAC,WAAW;AAAA,QACxB;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa,4BAA4B;AAAA,QACzC,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,oBAAoB,EAAE,MAAM,UAAU,aAAa,oCAAoC;AAAA,YACvF,aAAa,EAAE,MAAM,UAAU,aAAa,yDAAyD;AAAA,YACrG,SAAS;AAAA,cACP,MAAM;AAAA,cACN,aAAa;AAAA,cACb,OAAO,EAAE,MAAM,SAAS;AAAA,YAC1B;AAAA,YACA,aAAa,EAAE,MAAM,UAAU,aAAa,wBAAwB;AAAA,UACtE;AAAA,UACA,UAAU,CAAC,sBAAsB,eAAe,SAAS;AAAA,QAC3D;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,QACb,aAAa;AAAA,UACX,MAAM;AAAA,UACN,YAAY;AAAA,YACV,WAAW,EAAE,MAAM,UAAU,aAAa,kCAAkC;AAAA,YAC5E,aAAa,EAAE,MAAM,UAAU,aAAa,wBAAwB;AAAA,UACtE;AAAA,UACA,UAAU,CAAC,WAAW;AAAA,QACxB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAGD,OAAO,kBAAkB,uBAAuB,OAAO,YAA0B;AAC/E,QAAM,EAAE,MAAM,WAAW,KAAK,IAAI,QAAQ;AAE1C,MAAI;AACF,QAAI,SAAS,aAAa;AACxB,YAAM,WAAW,MAAM;AACvB,YAAM,YAAY,MAAM,cAAyB;AACjD,YAAM,OAAO,MAAM,QAAkB;AACrC,YAAM,OAAO,MAAM,QAAkB;AACrC,YAAM,oBAAoB,MAAM,qBAA+B;AAC/D,YAAM,kBAAkB,MAAM,mBAA8B;AAE5D,YAAM,MAAM,aAAa,QAAQ;AACjC,YAAM,OAAO,MAAM,sBAAsB,KAAK,SAAS;AAEvD,UAAI,SAAS,WAAW;AACtB,cAAM,MAAM,MAAMC,gBAAe,KAAK,GAAG;AACzC,eAAO,uBAAuB,KAAK,MAAM,UAAU,mBAAmB,eAAe;AAAA,MACvF;AACA,UAAI,SAAS,YAAY;AACvB,eAAO,wBAAwB,MAAM,MAAM,QAAQ;AAAA,MACrD;AACA,aAAO,yBAAyB,MAAM,MAAM,QAAQ;AAAA,IACtD;AAEA,QAAI,SAAS,0BAA0B;AACrC,YAAM,WAAW,MAAM;AACvB,YAAM,aAAa,MAAM;AACzB,YAAM,UAAU,MAAM;AACtB,UAAI,UAAU,MAAM;AAEpB,UAAI,CAAC,SAAS;AACZ,cAAM,MAAM,QAAQ,QAAQ;AAC5B,cAAM,OAAOC,UAAS,UAAU,GAAG;AACnC,cAAM,MAAM,QAAQ,QAAQ;AAC5B,kBAAUC,SAAQ,KAAK,GAAG,IAAI,aAAa,GAAG,EAAE;AAAA,MAClD;AAEA,YAAM,MAAM,aAAa,QAAQ;AACjC,YAAM,MAAM,MAAMF,gBAAe,KAAK,GAAG;AACzC,YAAM,SAAS,IAAI,cAAc,KAAK,UAAU;AAEhD,UAAI;AACJ,UAAI;AACF,gBAAQ,OAAO,cAAc,OAAO;AAAA,MACtC,SAAS,GAAG;AACV,YAAI,aAAa,sBAAsB;AACrC,iBAAO;AAAA,YACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM;AAAA;AAAA,EAAqD,EAA2B,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC;AAAA,YACvI,SAAS;AAAA,UACX;AAAA,QACF;AACA,cAAM;AAAA,MACR;AAEA,YAAM,SAAS,MAAM,IAAI,KAAK;AAE9B,YAAM,KAAK,MAAM,OAAO,IAAS;AACjC,SAAG,cAAc,SAAS,MAAM;AAEhC,UAAI,MAAM,6BAA6B,OAAO;AAAA,WAAc,MAAM,eAAe,aAAa,MAAM,eAAe;AAAA,SAAqB,MAAM,aAAa,aAAa,MAAM,aAAa;AAC3L,UAAI,MAAM,iBAAiB,SAAS,GAAG;AACrC,eAAO;AAAA;AAAA;AAAA,EAAyB,MAAM,gBAAgB,KAAK,IAAI,CAAC;AAAA,MAClE;AAEA,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,IAAI,CAAC;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,SAAS,sBAAsB;AACjC,YAAM,WAAW,MAAM;AACvB,UAAI,UAAU,MAAM;AAEpB,UAAI,CAAC,SAAS;AACZ,cAAM,MAAM,QAAQ,QAAQ;AAC5B,cAAM,OAAOC,UAAS,UAAU,GAAG;AACnC,cAAM,MAAM,QAAQ,QAAQ;AAC5B,kBAAUC,SAAQ,KAAK,GAAG,IAAI,SAAS,GAAG,EAAE;AAAA,MAC9C;AAEA,YAAM,MAAM,aAAa,QAAQ;AACjC,YAAM,MAAM,MAAMF,gBAAe,KAAK,GAAG;AACzC,YAAM,SAAS,IAAI,cAAc,GAAG;AAGpC,aAAO,qBAAqB;AAE5B,YAAM,SAAS,MAAM,IAAI,KAAK;AAC9B,YAAM,KAAK,MAAM,OAAO,IAAS;AACjC,SAAG,cAAc,SAAS,MAAM;AAEhC,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,mCAAmC,OAAO,GAAG,CAAC;AAAA,MAChF;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,iBAAiB,IAAI,EAAE;AAAA,EAEzC,SAAS,OAAY;AACnB,WAAO;AAAA,MACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,wBAAwB,IAAI,KAAK,MAAM,OAAO,GAAG,CAAC;AAAA,MAClF,SAAS;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAGD,eAAe,OAAO;AACpB,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAC9B,UAAQ,MAAM,oCAAoC,eAAe,CAAC,oBAAoB;AACxF;AAEA,KAAK,EAAE,MAAM,QAAQ,KAAK;","names":["basename","resolve","DocumentObject","ui_markdown","llm_content","DocumentObject","basename","resolve"]}
+{"version":3,"sources":["../src/index.ts","../src/response-builders.ts"],"sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { readFileSync } from 'node:fs';\nimport { basename, resolve, extname, dirname } from 'node:path';\nimport { \n  identifyEngine, \n  extractTextFromBuffer, \n  DocumentObject, \n  RedlineEngine, \n  BatchValidationError \n} from '@adeu/core';\nimport { \n  build_paginated_response, \n  build_outline_response, \n  build_appendix_response \n} from './response-builders.js';\n\n// --- Tool Description Constants (Parity with Python) ---\nconst 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\";\nconst READ_DOCX_TAIL = \"Modes:\\n- 'full' (default): paginated body content. Use page=N to navigate.\\n- 'outline': heading map only — 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.\";\n\nconst PROCESS_BATCH_COMMON_DESC = \"Applies a batch of edits and review actions to a DOCX.\\n\\nAll changes evaluate against the ORIGINAL document state — 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\";\nconst PROCESS_BATCH_OPERATIONS_DESC = \"Each item in `changes` must specify a `type`:\\n1. 'modify': Search-and-replace. `target_text` must uniquely match — 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 — 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 — 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 — 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.\";\n\n// --- Server Setup ---\nconst server = new Server(\n  {\n    name: 'adeu-redlining-service',\n    version: '1.0.0',\n  },\n  {\n    capabilities: {\n      tools: {},\n    },\n  }\n);\n\n// --- Tool Registration ---\nserver.setRequestHandler(ListToolsRequestSchema, async () => {\n  return {\n    tools: [\n      {\n        name: 'read_docx',\n        description: READ_DOCX_COMMON_DESC + READ_DOCX_TAIL,\n        inputSchema: {\n          type: 'object',\n          properties: {\n            file_path: { type: 'string', description: 'Absolute path to the DOCX file.' },\n            clean_view: { type: 'boolean', description: \"If False (default), returns the 'Raw' text with inline CriticMarkup. If True, returns 'Accepted' text.\", default: false },\n            mode: { type: 'string', enum: ['full', 'outline', 'appendix'], description: \"'full' returns body content. 'outline' returns a structural heading map. 'appendix' returns defined terms.\", default: 'full' },\n            page: { type: 'number', description: 'Page number (1-indexed) for mode=\\'full\\'. Defaults to 1.', default: 1 },\n            outline_max_level: { type: 'number', description: 'For mode=\\'outline\\' only: cap on heading depth.', default: 2 },\n            outline_verbose: { type: 'boolean', description: 'For mode=\\'outline\\' only: includes metadata.', default: false }\n          },\n          required: ['file_path']\n        }\n      },\n      {\n        name: 'process_document_batch',\n        description: PROCESS_BATCH_COMMON_DESC + PROCESS_BATCH_OPERATIONS_DESC,\n        inputSchema: {\n          type: 'object',\n          properties: {\n            original_docx_path: { type: 'string', description: 'Absolute path to the source file.' },\n            author_name: { type: 'string', description: \"Name to appear in Track Changes (e.g., 'Reviewer AI').\" },\n            changes: { \n              type: 'array', \n              description: \"List of changes to apply. Each change must specify 'type'.\",\n              items: { type: 'object' } \n            },\n            output_path: { type: 'string', description: 'Optional output path.' }\n          },\n          required: ['original_docx_path', 'author_name', 'changes']\n        }\n      },\n      {\n        name: 'accept_all_changes',\n        description: \"Accepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines.\",\n        inputSchema: {\n          type: 'object',\n          properties: {\n            docx_path: { type: 'string', description: 'Absolute path to the DOCX file.' },\n            output_path: { type: 'string', description: 'Optional output path.' }\n          },\n          required: ['docx_path']\n        }\n      }\n    ]\n  };\n});\n\n// --- Tool Execution ---\nserver.setRequestHandler(CallToolRequestSchema, async (request): Promise<any> => {\n  const { name, arguments: args } = request.params;\n\n  try {\n    if (name === 'read_docx') {\n      const filePath = args?.file_path as string;\n      const cleanView = args?.clean_view as boolean ?? false;\n      const mode = args?.mode as string ?? 'full';\n      const page = args?.page as number ?? 1;\n      const outline_max_level = args?.outline_max_level as number ?? 2;\n      const outline_verbose = args?.outline_verbose as boolean ?? false;\n      \n      const buf = readFileSync(filePath);\n      const text = await extractTextFromBuffer(buf, cleanView);\n      \n      if (mode === 'outline') {\n        const doc = await DocumentObject.load(buf);\n        return build_outline_response(doc, text, filePath, outline_max_level, outline_verbose);\n      }\n      if (mode === 'appendix') {\n        return build_appendix_response(text, page, filePath);\n      }\n      return build_paginated_response(text, page, filePath);\n    }\n\n    if (name === 'process_document_batch') {\n      const origPath = args?.original_docx_path as string;\n      const authorName = args?.author_name as string;\n      const changes = args?.changes as any[];\n      let outPath = args?.output_path as string;\n\n      if (!outPath) {\n        const ext = extname(origPath);\n        const base = basename(origPath, ext);\n        const dir = dirname(origPath);\n        outPath = resolve(dir, `${base}_processed${ext}`);\n      }\n\n      const buf = readFileSync(origPath);\n      const doc = await DocumentObject.load(buf);\n      const engine = new RedlineEngine(doc, authorName);\n      \n      let stats;\n      try {\n        stats = engine.process_batch(changes);\n      } catch (e) {\n        if (e instanceof BatchValidationError) {\n          return {\n            content: [{ type: 'text', text: `Batch rejected. Some edits failed validation:\\n\\n${(e as BatchValidationError).errors.join('\\n\\n')}` }],\n            isError: true\n          };\n        }\n        throw e;\n      }\n\n      const outBuf = await doc.save();\n      // Using dynamic import of fs/promises or just sync write\n      const fs = await import('node:fs');\n      fs.writeFileSync(outPath, outBuf);\n\n      let res = `Batch complete. Saved to: ${outPath}\\nActions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.\\nEdits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.`;\n      if (stats.skipped_details?.length > 0) {\n        res += `\\n\\nSkipped Details:\\n${stats.skipped_details.join('\\n')}`;\n      }\n\n      return {\n        content: [{ type: 'text', text: res }]\n      };\n    }\n\n    if (name === 'accept_all_changes') {\n      const docxPath = args?.docx_path as string;\n      let outPath = args?.output_path as string;\n\n      if (!outPath) {\n        const ext = extname(docxPath);\n        const base = basename(docxPath, ext);\n        const dir = dirname(docxPath);\n        outPath = resolve(dir, `${base}_clean${ext}`);\n      }\n\n      const buf = readFileSync(docxPath);\n      const doc = await DocumentObject.load(buf);\n      const engine = new RedlineEngine(doc);\n      \n      // We implement the public facing accept_all wrapper from python\n      engine.accept_all_revisions();\n      \n      const outBuf = await doc.save();\n      const fs = await import('node:fs');\n      fs.writeFileSync(outPath, outBuf);\n\n      return {\n        content: [{ type: 'text', text: `Accepted all changes. Saved to: ${outPath}` }]\n      };\n    }\n\n    throw new Error(`Unknown tool: ${name}`);\n\n  } catch (error: any) {\n    return {\n      content: [{ type: 'text', text: `Error executing tool ${name}: ${error.message}` }],\n      isError: true,\n    };\n  }\n});\n\n// --- Startup ---\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  console.error(`Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`);\n}\n\nmain().catch(console.error);","import { resolve, basename } from 'node:path';\nimport { \n  DocumentObject, \n  paginate, \n  split_structural_appendix, \n  extract_outline, \n  OutlineNode \n} from '@adeu/core';\n\nexport interface ToolResult {\n  content: { type: 'text'; text: string }[];\n  isError?: boolean;\n  [key: string]: unknown;\n}\n\nfunction _build_appendix_pointer(has_appendix: boolean): string {\n  if (!has_appendix) return '';\n  return `\\n\\n---\\n\\n> **Appendix available.** This document has structural metadata (defined terms, cross-references, bookmarks, diagnostics) that may be relevant when editing. Call \\`read_docx\\` with \\`mode='appendix'\\` to load it before submitting edits.`;\n}\n\nfunction _build_page_banner(page: number, total: number): string {\n  if (total <= 1) return '';\n  return `> **Page ${page} of ${total}** — call \\`read_docx\\` with \\`mode='outline'\\` for a heading map of the full document.\\n\\n---\\n\\n`;\n}\n\nfunction _build_page_footer(page: number, total: number, has_next: boolean): string {\n  if (total <= 1 || !has_next) return '';\n  return `\\n\\n---\\n\\n> **Continues on page ${page + 1} of ${total}.**`;\n}\n\nexport function render_outline_tree(nodes: OutlineNode[], max_level: number = 2, verbose: boolean = false): string {\n  if (!nodes || nodes.length === 0) {\n    return '# (No headings detected)\\n\\nThis document has no detectable headings.';\n  }\n\n  const visible = nodes.filter(n => n.level <= max_level);\n\n  if (visible.length === 0) {\n    return `# (No headings at level <= ${max_level})\\n\\nDocument has ${nodes.length} headings, all at deeper levels. Call read_docx with mode='outline' and outline_max_level=N (up to 6) to see them.`;\n  }\n\n  const lines: string[] = [];\n  for (const node of visible) {\n    const prefix = '#'.repeat(node.level);\n    if (verbose) {\n      const meta_parts = [`p${node.page}`, node.style];\n      if (node.has_table) meta_parts.push('has table');\n      if (node.footnote_ids && node.footnote_ids.length > 0) meta_parts.push('fn:' + node.footnote_ids.join(','));\n      lines.push(`${prefix} ${node.text} (${meta_parts.join(', ')})`);\n    } else {\n      lines.push(`${prefix} ${node.text} (p${node.page})`);\n    }\n  }\n  return lines.join('\\n');\n}\n\nexport function build_paginated_response(text: string, page: number, file_path: string): ToolResult {\n  const [body, appendix] = split_structural_appendix(text);\n  const has_appendix = Boolean(appendix.trim());\n\n  const result = paginate(body, '');\n\n  if (page < 1 || page > result.total_pages) {\n    throw new Error(`Page ${page} out of range (doc has ${result.total_pages} pages).`);\n  }\n\n  const selected = result.pages[page - 1];\n  const banner = _build_page_banner(selected.page, selected.total_pages);\n  const footer = _build_page_footer(selected.page, selected.total_pages, selected.has_next);\n  const appendix_pointer = _build_appendix_pointer(has_appendix);\n  \n  const ui_markdown = banner + selected.page_content + footer + appendix_pointer;\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\n\n  return {\n    content: [{ type: 'text', text: llm_content }]\n  };\n}\n\nexport function build_outline_response(\n  doc: DocumentObject, \n  projected_text: string, \n  file_path: string, \n  outline_max_level: number = 2, \n  outline_verbose: boolean = false\n): ToolResult {\n  const [body] = split_structural_appendix(projected_text);\n  const pagination_result = paginate(body, '');\n\n  const nodes = extract_outline(\n    doc,\n    body,\n    pagination_result.body_pages,\n    pagination_result.body_page_offsets\n  );\n\n  const rendered = render_outline_tree(nodes, outline_max_level, outline_verbose);\n\n  const visible_count = nodes.filter(n => n.level <= outline_max_level).length;\n  const deeper_count = nodes.length - visible_count;\n  const deeper_hint = deeper_count > 0 ? ` (${deeper_count} more at deeper levels, raise outline_max_level to see)` : '';\n\n  const header = `> **Outline view** — showing ${visible_count} of ${nodes.length} headings (L1-L${outline_max_level}${deeper_hint}) across ${pagination_result.total_pages} page(s). Call \\`read_docx\\` with \\`mode='full'\\` and \\`page=N\\` to read a section.\\n\\n---\\n\\n`;\n  const ui_markdown = header + rendered;\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\n\n  return {\n    content: [{ type: 'text', text: llm_content }]\n  };\n}\n\nexport function build_appendix_response(text: string, page: number, file_path: string): ToolResult {\n  const [, appendix] = split_structural_appendix(text);\n\n  if (!appendix.trim()) {\n    const ui_markdown = \"# Appendix\\n\\nThis document has no structural appendix (no defined terms, named anchors, or diagnostics detected).\";\n    const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\n    return {\n      content: [{ type: 'text', text: llm_content }]\n    };\n  }\n\n  const result = paginate(appendix, '');\n\n  if (page < 1 || page > result.total_pages) {\n    throw new Error(`Appendix page ${page} out of range (appendix has ${result.total_pages} pages).`);\n  }\n\n  const selected = result.pages[page - 1];\n\n  let banner = '';\n  let footer = '';\n\n  if (selected.total_pages > 1) {\n    banner = `> **Appendix page ${selected.page} of ${selected.total_pages}** — structural metadata for this document.\\n\\n---\\n\\n`;\n    footer = selected.has_next ? `\\n\\n---\\n\\n> **Continues on appendix page ${selected.page + 1} of ${selected.total_pages}.**` : '';\n  } else {\n    banner = \"> **Appendix** — structural metadata for this document.\\n\\n---\\n\\n\";\n  }\n\n  const ui_markdown = banner + selected.page_content + footer;\n  const llm_content = `> **File Path:** \\`${resolve(file_path)}\\`\\n\\n${ui_markdown}`;\n\n  return {\n    content: [{ type: 'text', text: llm_content }]\n  };\n}"],"mappings":"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","names":["basename","resolve","DocumentObject","ui_markdown","llm_content","DocumentObject","basename","resolve"]}

package/package.json

@@ -1,31 +1,31 @@
-{
-  "name": "@adeu/mcp-server",
-  "version": "1.6.2",
-  "description": "",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "adeu-mcp-server": "./dist/index.js"
-  },
-  "devDependencies": {},
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "start": "node ./dist/index.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/dealfluence/adeu.git",
-    "directory": "node/packages/mcp-server"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "author": "Mikko Korpela <mikko@adeu.ai>",
-  "license": "MIT",
-  "type": "module",
-  "dependencies": {
-    "@adeu/core": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.0.0"
-  }
-}
+{
+  "name": "@adeu/mcp-server",
+  "version": "1.6.5",
+  "description": "",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "adeu-mcp-server": "./dist/index.js"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "start": "node ./dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dealfluence/adeu.git",
+    "directory": "node/packages/mcp-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Mikko Korpela <mikko@adeu.ai>",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@adeu/core": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}

package/src/index.test.ts

@@ -1,7 +1,7 @@
-import { describe, it, expect } from 'vitest';
-
-describe('MCP Server', () => {
-  it('should have a passing dummy test', () => {
-    expect(true).toBe(true);
-  });
+import { describe, it, expect } from 'vitest';
+
+describe('MCP Server', () => {
+  it('should have a passing dummy test', () => {
+    expect(true).toBe(true);
+  });
 });

package/src/index.ts

@@ -1,208 +1,208 @@
-import { Server } 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 'node:fs';
-import { basename, resolve, extname, dirname } from 'node:path';
-import { 
-  identifyEngine, 
-  extractTextFromBuffer, 
-  DocumentObject, 
-  RedlineEngine, 
-  BatchValidationError 
-} from '@adeu/core';
-import { 
-  build_paginated_response, 
-  build_outline_response, 
-  build_appendix_response 
-} from './response-builders.js';
-
-// --- Tool Description Constants (Parity with Python) ---
-const 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";
-const READ_DOCX_TAIL = "Modes:\n- 'full' (default): paginated body content. Use page=N to navigate.\n- 'outline': heading map only — 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.";
-
-const PROCESS_BATCH_COMMON_DESC = "Applies a batch of edits and review actions to a DOCX.\n\nAll changes evaluate against the ORIGINAL document state — 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";
-const PROCESS_BATCH_OPERATIONS_DESC = "Each item in `changes` must specify a `type`:\n1. 'modify': Search-and-replace. `target_text` must uniquely match — 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 — 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 — 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 — 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.";
-
-// --- Server Setup ---
-const server = new Server(
-  {
-    name: 'adeu-redlining-service',
-    version: '1.0.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  }
-);
-
-// --- Tool Registration ---
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: 'read_docx',
-        description: READ_DOCX_COMMON_DESC + READ_DOCX_TAIL,
-        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 }
-          },
-          required: ['file_path']
-        }
-      },
-      {
-        name: 'process_document_batch',
-        description: PROCESS_BATCH_COMMON_DESC + PROCESS_BATCH_OPERATIONS_DESC,
-        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')." },
-            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.' }
-          },
-          required: ['original_docx_path', 'author_name', 'changes']
-        }
-      },
-      {
-        name: 'accept_all_changes',
-        description: "Accepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines.",
-        inputSchema: {
-          type: 'object',
-          properties: {
-            docx_path: { type: 'string', description: 'Absolute path to the DOCX file.' },
-            output_path: { type: 'string', description: 'Optional output path.' }
-          },
-          required: ['docx_path']
-        }
-      }
-    ]
-  };
-});
-
-// --- Tool Execution ---
-server.setRequestHandler(CallToolRequestSchema, async (request): Promise<any> => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    if (name === 'read_docx') {
-      const filePath = args?.file_path as string;
-      const cleanView = args?.clean_view as boolean ?? false;
-      const mode = args?.mode as string ?? 'full';
-      const page = args?.page as number ?? 1;
-      const outline_max_level = args?.outline_max_level as number ?? 2;
-      const outline_verbose = args?.outline_verbose as boolean ?? false;
-      
-      const buf = readFileSync(filePath);
-      const text = await extractTextFromBuffer(buf, cleanView);
-      
-      if (mode === 'outline') {
-        const doc = await DocumentObject.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 as string;
-      const authorName = args?.author_name as string;
-      const changes = args?.changes as any[];
-      let outPath = args?.output_path as string;
-
-      if (!outPath) {
-        const ext = extname(origPath);
-        const base = basename(origPath, ext);
-        const dir = dirname(origPath);
-        outPath = resolve(dir, `${base}_processed${ext}`);
-      }
-
-      const buf = readFileSync(origPath);
-      const doc = await DocumentObject.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:\n\n${(e as BatchValidationError).errors.join('\n\n')}` }],
-            isError: true
-          };
-        }
-        throw e;
-      }
-
-      const outBuf = await doc.save();
-      // Using dynamic import of fs/promises or just sync write
-      const fs = await import('node:fs');
-      fs.writeFileSync(outPath, outBuf);
-
-      let res = `Batch complete. Saved to: ${outPath}\nActions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.\nEdits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.`;
-      if (stats.skipped_details?.length > 0) {
-        res += `\n\nSkipped Details:\n${stats.skipped_details.join('\n')}`;
-      }
-
-      return {
-        content: [{ type: 'text', text: res }]
-      };
-    }
-
-    if (name === 'accept_all_changes') {
-      const docxPath = args?.docx_path as string;
-      let outPath = args?.output_path as string;
-
-      if (!outPath) {
-        const ext = extname(docxPath);
-        const base = basename(docxPath, ext);
-        const dir = dirname(docxPath);
-        outPath = resolve(dir, `${base}_clean${ext}`);
-      }
-
-      const buf = readFileSync(docxPath);
-      const doc = await DocumentObject.load(buf);
-      const engine = new RedlineEngine(doc);
-      
-      // We implement the public facing accept_all wrapper from python
-      engine.accept_all_revisions();
-      
-      const outBuf = await doc.save();
-      const fs = await import('node:fs');
-      fs.writeFileSync(outPath, outBuf);
-
-      return {
-        content: [{ type: 'text', text: `Accepted all changes. Saved to: ${outPath}` }]
-      };
-    }
-
-    throw new Error(`Unknown tool: ${name}`);
-
-  } catch (error: any) {
-    return {
-      content: [{ type: 'text', text: `Error executing tool ${name}: ${error.message}` }],
-      isError: true,
-    };
-  }
-});
-
-// --- Startup ---
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error(`Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`);
-}
-
+import { Server } 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 'node:fs';
+import { basename, resolve, extname, dirname } from 'node:path';
+import { 
+  identifyEngine, 
+  extractTextFromBuffer, 
+  DocumentObject, 
+  RedlineEngine, 
+  BatchValidationError 
+} from '@adeu/core';
+import { 
+  build_paginated_response, 
+  build_outline_response, 
+  build_appendix_response 
+} from './response-builders.js';
+
+// --- Tool Description Constants (Parity with Python) ---
+const 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";
+const READ_DOCX_TAIL = "Modes:\n- 'full' (default): paginated body content. Use page=N to navigate.\n- 'outline': heading map only — 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.";
+
+const PROCESS_BATCH_COMMON_DESC = "Applies a batch of edits and review actions to a DOCX.\n\nAll changes evaluate against the ORIGINAL document state — 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";
+const PROCESS_BATCH_OPERATIONS_DESC = "Each item in `changes` must specify a `type`:\n1. 'modify': Search-and-replace. `target_text` must uniquely match — 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 — 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 — 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 — 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.";
+
+// --- Server Setup ---
+const server = new Server(
+  {
+    name: 'adeu-redlining-service',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// --- Tool Registration ---
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: 'read_docx',
+        description: READ_DOCX_COMMON_DESC + READ_DOCX_TAIL,
+        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 }
+          },
+          required: ['file_path']
+        }
+      },
+      {
+        name: 'process_document_batch',
+        description: PROCESS_BATCH_COMMON_DESC + PROCESS_BATCH_OPERATIONS_DESC,
+        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')." },
+            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.' }
+          },
+          required: ['original_docx_path', 'author_name', 'changes']
+        }
+      },
+      {
+        name: 'accept_all_changes',
+        description: "Accepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines.",
+        inputSchema: {
+          type: 'object',
+          properties: {
+            docx_path: { type: 'string', description: 'Absolute path to the DOCX file.' },
+            output_path: { type: 'string', description: 'Optional output path.' }
+          },
+          required: ['docx_path']
+        }
+      }
+    ]
+  };
+});
+
+// --- Tool Execution ---
+server.setRequestHandler(CallToolRequestSchema, async (request): Promise<any> => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    if (name === 'read_docx') {
+      const filePath = args?.file_path as string;
+      const cleanView = args?.clean_view as boolean ?? false;
+      const mode = args?.mode as string ?? 'full';
+      const page = args?.page as number ?? 1;
+      const outline_max_level = args?.outline_max_level as number ?? 2;
+      const outline_verbose = args?.outline_verbose as boolean ?? false;
+      
+      const buf = readFileSync(filePath);
+      const text = await extractTextFromBuffer(buf, cleanView);
+      
+      if (mode === 'outline') {
+        const doc = await DocumentObject.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 as string;
+      const authorName = args?.author_name as string;
+      const changes = args?.changes as any[];
+      let outPath = args?.output_path as string;
+
+      if (!outPath) {
+        const ext = extname(origPath);
+        const base = basename(origPath, ext);
+        const dir = dirname(origPath);
+        outPath = resolve(dir, `${base}_processed${ext}`);
+      }
+
+      const buf = readFileSync(origPath);
+      const doc = await DocumentObject.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:\n\n${(e as BatchValidationError).errors.join('\n\n')}` }],
+            isError: true
+          };
+        }
+        throw e;
+      }
+
+      const outBuf = await doc.save();
+      // Using dynamic import of fs/promises or just sync write
+      const fs = await import('node:fs');
+      fs.writeFileSync(outPath, outBuf);
+
+      let res = `Batch complete. Saved to: ${outPath}\nActions: ${stats.actions_applied} applied, ${stats.actions_skipped} skipped.\nEdits: ${stats.edits_applied} applied, ${stats.edits_skipped} skipped.`;
+      if (stats.skipped_details?.length > 0) {
+        res += `\n\nSkipped Details:\n${stats.skipped_details.join('\n')}`;
+      }
+
+      return {
+        content: [{ type: 'text', text: res }]
+      };
+    }
+
+    if (name === 'accept_all_changes') {
+      const docxPath = args?.docx_path as string;
+      let outPath = args?.output_path as string;
+
+      if (!outPath) {
+        const ext = extname(docxPath);
+        const base = basename(docxPath, ext);
+        const dir = dirname(docxPath);
+        outPath = resolve(dir, `${base}_clean${ext}`);
+      }
+
+      const buf = readFileSync(docxPath);
+      const doc = await DocumentObject.load(buf);
+      const engine = new RedlineEngine(doc);
+      
+      // We implement the public facing accept_all wrapper from python
+      engine.accept_all_revisions();
+      
+      const outBuf = await doc.save();
+      const fs = await import('node:fs');
+      fs.writeFileSync(outPath, outBuf);
+
+      return {
+        content: [{ type: 'text', text: `Accepted all changes. Saved to: ${outPath}` }]
+      };
+    }
+
+    throw new Error(`Unknown tool: ${name}`);
+
+  } catch (error: any) {
+    return {
+      content: [{ type: 'text', text: `Error executing tool ${name}: ${error.message}` }],
+      isError: true,
+    };
+  }
+});
+
+// --- Startup ---
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio`);
+}
+
 main().catch(console.error);

package/src/response-builders.ts

@@ -1,147 +1,147 @@
-import { resolve, basename } from 'node:path';
-import { 
-  DocumentObject, 
-  paginate, 
-  split_structural_appendix, 
-  extract_outline, 
-  OutlineNode 
-} from '@adeu/core';
-
-export interface ToolResult {
-  content: { type: 'text'; text: string }[];
-  isError?: boolean;
-  [key: string]: unknown;
-}
-
-function _build_appendix_pointer(has_appendix: boolean): string {
-  if (!has_appendix) return '';
-  return `\n\n---\n\n> **Appendix available.** This document has structural metadata (defined terms, cross-references, bookmarks, diagnostics) that may be relevant when editing. Call \`read_docx\` with \`mode='appendix'\` to load it before submitting edits.`;
-}
-
-function _build_page_banner(page: number, total: number): string {
-  if (total <= 1) return '';
-  return `> **Page ${page} of ${total}** — call \`read_docx\` with \`mode='outline'\` for a heading map of the full document.\n\n---\n\n`;
-}
-
-function _build_page_footer(page: number, total: number, has_next: boolean): string {
-  if (total <= 1 || !has_next) return '';
-  return `\n\n---\n\n> **Continues on page ${page + 1} of ${total}.**`;
-}
-
-export function render_outline_tree(nodes: OutlineNode[], max_level: number = 2, verbose: boolean = false): string {
-  if (!nodes || nodes.length === 0) {
-    return '# (No headings detected)\n\nThis document has no detectable headings.';
-  }
-
-  const visible = nodes.filter(n => n.level <= max_level);
-
-  if (visible.length === 0) {
-    return `# (No headings at level <= ${max_level})\n\nDocument has ${nodes.length} headings, all at deeper levels. Call read_docx with mode='outline' and outline_max_level=N (up to 6) to see them.`;
-  }
-
-  const lines: string[] = [];
-  for (const node of visible) {
-    const prefix = '#'.repeat(node.level);
-    if (verbose) {
-      const meta_parts = [`p${node.page}`, node.style];
-      if (node.has_table) meta_parts.push('has table');
-      if (node.footnote_ids && node.footnote_ids.length > 0) meta_parts.push('fn:' + node.footnote_ids.join(','));
-      lines.push(`${prefix} ${node.text} (${meta_parts.join(', ')})`);
-    } else {
-      lines.push(`${prefix} ${node.text} (p${node.page})`);
-    }
-  }
-  return lines.join('\n');
-}
-
-export function build_paginated_response(text: string, page: number, file_path: string): ToolResult {
-  const [body, appendix] = split_structural_appendix(text);
-  const has_appendix = Boolean(appendix.trim());
-
-  const result = paginate(body, '');
-
-  if (page < 1 || page > result.total_pages) {
-    throw new Error(`Page ${page} out of range (doc has ${result.total_pages} pages).`);
-  }
-
-  const selected = result.pages[page - 1];
-  const banner = _build_page_banner(selected.page, selected.total_pages);
-  const footer = _build_page_footer(selected.page, selected.total_pages, selected.has_next);
-  const appendix_pointer = _build_appendix_pointer(has_appendix);
-  
-  const ui_markdown = banner + selected.page_content + footer + appendix_pointer;
-  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
-
-  return {
-    content: [{ type: 'text', text: llm_content }]
-  };
-}
-
-export function build_outline_response(
-  doc: DocumentObject, 
-  projected_text: string, 
-  file_path: string, 
-  outline_max_level: number = 2, 
-  outline_verbose: boolean = false
-): ToolResult {
-  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
-  );
-
-  const rendered = render_outline_tree(nodes, outline_max_level, outline_verbose);
-
-  const visible_count = nodes.filter(n => n.level <= outline_max_level).length;
-  const deeper_count = nodes.length - visible_count;
-  const deeper_hint = deeper_count > 0 ? ` (${deeper_count} more at deeper levels, raise outline_max_level to see)` : '';
-
-  const header = `> **Outline view** — showing ${visible_count} of ${nodes.length} headings (L1-L${outline_max_level}${deeper_hint}) across ${pagination_result.total_pages} page(s). Call \`read_docx\` with \`mode='full'\` and \`page=N\` to read a section.\n\n---\n\n`;
-  const ui_markdown = header + rendered;
-  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
-
-  return {
-    content: [{ type: 'text', text: llm_content }]
-  };
-}
-
-export function build_appendix_response(text: string, page: number, file_path: string): ToolResult {
-  const [, appendix] = split_structural_appendix(text);
-
-  if (!appendix.trim()) {
-    const ui_markdown = "# Appendix\n\nThis document has no structural appendix (no defined terms, named anchors, or diagnostics detected).";
-    const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
-    return {
-      content: [{ type: 'text', text: llm_content }]
-    };
-  }
-
-  const result = paginate(appendix, '');
-
-  if (page < 1 || page > result.total_pages) {
-    throw new Error(`Appendix page ${page} out of range (appendix has ${result.total_pages} pages).`);
-  }
-
-  const selected = result.pages[page - 1];
-
-  let banner = '';
-  let footer = '';
-
-  if (selected.total_pages > 1) {
-    banner = `> **Appendix page ${selected.page} of ${selected.total_pages}** — structural metadata for this document.\n\n---\n\n`;
-    footer = selected.has_next ? `\n\n---\n\n> **Continues on appendix page ${selected.page + 1} of ${selected.total_pages}.**` : '';
-  } else {
-    banner = "> **Appendix** — structural metadata for this document.\n\n---\n\n";
-  }
-
-  const ui_markdown = banner + selected.page_content + footer;
-  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
-
-  return {
-    content: [{ type: 'text', text: llm_content }]
-  };
+import { resolve, basename } from 'node:path';
+import { 
+  DocumentObject, 
+  paginate, 
+  split_structural_appendix, 
+  extract_outline, 
+  OutlineNode 
+} from '@adeu/core';
+
+export interface ToolResult {
+  content: { type: 'text'; text: string }[];
+  isError?: boolean;
+  [key: string]: unknown;
+}
+
+function _build_appendix_pointer(has_appendix: boolean): string {
+  if (!has_appendix) return '';
+  return `\n\n---\n\n> **Appendix available.** This document has structural metadata (defined terms, cross-references, bookmarks, diagnostics) that may be relevant when editing. Call \`read_docx\` with \`mode='appendix'\` to load it before submitting edits.`;
+}
+
+function _build_page_banner(page: number, total: number): string {
+  if (total <= 1) return '';
+  return `> **Page ${page} of ${total}** — call \`read_docx\` with \`mode='outline'\` for a heading map of the full document.\n\n---\n\n`;
+}
+
+function _build_page_footer(page: number, total: number, has_next: boolean): string {
+  if (total <= 1 || !has_next) return '';
+  return `\n\n---\n\n> **Continues on page ${page + 1} of ${total}.**`;
+}
+
+export function render_outline_tree(nodes: OutlineNode[], max_level: number = 2, verbose: boolean = false): string {
+  if (!nodes || nodes.length === 0) {
+    return '# (No headings detected)\n\nThis document has no detectable headings.';
+  }
+
+  const visible = nodes.filter(n => n.level <= max_level);
+
+  if (visible.length === 0) {
+    return `# (No headings at level <= ${max_level})\n\nDocument has ${nodes.length} headings, all at deeper levels. Call read_docx with mode='outline' and outline_max_level=N (up to 6) to see them.`;
+  }
+
+  const lines: string[] = [];
+  for (const node of visible) {
+    const prefix = '#'.repeat(node.level);
+    if (verbose) {
+      const meta_parts = [`p${node.page}`, node.style];
+      if (node.has_table) meta_parts.push('has table');
+      if (node.footnote_ids && node.footnote_ids.length > 0) meta_parts.push('fn:' + node.footnote_ids.join(','));
+      lines.push(`${prefix} ${node.text} (${meta_parts.join(', ')})`);
+    } else {
+      lines.push(`${prefix} ${node.text} (p${node.page})`);
+    }
+  }
+  return lines.join('\n');
+}
+
+export function build_paginated_response(text: string, page: number, file_path: string): ToolResult {
+  const [body, appendix] = split_structural_appendix(text);
+  const has_appendix = Boolean(appendix.trim());
+
+  const result = paginate(body, '');
+
+  if (page < 1 || page > result.total_pages) {
+    throw new Error(`Page ${page} out of range (doc has ${result.total_pages} pages).`);
+  }
+
+  const selected = result.pages[page - 1];
+  const banner = _build_page_banner(selected.page, selected.total_pages);
+  const footer = _build_page_footer(selected.page, selected.total_pages, selected.has_next);
+  const appendix_pointer = _build_appendix_pointer(has_appendix);
+  
+  const ui_markdown = banner + selected.page_content + footer + appendix_pointer;
+  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
+
+  return {
+    content: [{ type: 'text', text: llm_content }]
+  };
+}
+
+export function build_outline_response(
+  doc: DocumentObject, 
+  projected_text: string, 
+  file_path: string, 
+  outline_max_level: number = 2, 
+  outline_verbose: boolean = false
+): ToolResult {
+  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
+  );
+
+  const rendered = render_outline_tree(nodes, outline_max_level, outline_verbose);
+
+  const visible_count = nodes.filter(n => n.level <= outline_max_level).length;
+  const deeper_count = nodes.length - visible_count;
+  const deeper_hint = deeper_count > 0 ? ` (${deeper_count} more at deeper levels, raise outline_max_level to see)` : '';
+
+  const header = `> **Outline view** — showing ${visible_count} of ${nodes.length} headings (L1-L${outline_max_level}${deeper_hint}) across ${pagination_result.total_pages} page(s). Call \`read_docx\` with \`mode='full'\` and \`page=N\` to read a section.\n\n---\n\n`;
+  const ui_markdown = header + rendered;
+  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
+
+  return {
+    content: [{ type: 'text', text: llm_content }]
+  };
+}
+
+export function build_appendix_response(text: string, page: number, file_path: string): ToolResult {
+  const [, appendix] = split_structural_appendix(text);
+
+  if (!appendix.trim()) {
+    const ui_markdown = "# Appendix\n\nThis document has no structural appendix (no defined terms, named anchors, or diagnostics detected).";
+    const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
+    return {
+      content: [{ type: 'text', text: llm_content }]
+    };
+  }
+
+  const result = paginate(appendix, '');
+
+  if (page < 1 || page > result.total_pages) {
+    throw new Error(`Appendix page ${page} out of range (appendix has ${result.total_pages} pages).`);
+  }
+
+  const selected = result.pages[page - 1];
+
+  let banner = '';
+  let footer = '';
+
+  if (selected.total_pages > 1) {
+    banner = `> **Appendix page ${selected.page} of ${selected.total_pages}** — structural metadata for this document.\n\n---\n\n`;
+    footer = selected.has_next ? `\n\n---\n\n> **Continues on appendix page ${selected.page + 1} of ${selected.total_pages}.**` : '';
+  } else {
+    banner = "> **Appendix** — structural metadata for this document.\n\n---\n\n";
+  }
+
+  const ui_markdown = banner + selected.page_content + footer;
+  const llm_content = `> **File Path:** \`${resolve(file_path)}\`\n\n${ui_markdown}`;
+
+  return {
+    content: [{ type: 'text', text: llm_content }]
+  };
 }

package/tsconfig.json

@@ -1,21 +1,21 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022", "DOM"],
-    "types": ["node"],
-    "ignoreDeprecations": "6.0",
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node"],
+    "ignoreDeprecations": "6.0",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -1,23 +1,26 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig([
-  {
-    entry: ['src/index.ts'],
-    format: ['esm'],
-    dts: true,
-    sourcemap: true,
-    clean: true,
-    outDir: 'dist',
-  },
-  {
-    entry: ['src/index.ts'],
-    format: ['esm'],
-    outExtension: () => ({ js: '.js' }),
-    noExternal: [/(.*)/], // Bundle all NPM dependencies
-    external: [/^node:/], // Leave Node.js native built-ins external
-    outDir: '../../../desktop-extension',
-    dts: false,
-    sourcemap: false,
-    clean: false, // Don't clean the whole dir (preserves icon and manifest)
-  }
+import { defineConfig } from 'tsup';
+
+export default defineConfig([
+  {
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    dts: true,
+    sourcemap: true,
+    clean: true,
+    outDir: 'dist',
+    banner: {
+      js: '#!/usr/bin/env node',
+    },
+  },
+  {
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    outExtension: () => ({ js: '.js' }),
+    noExternal: [/(.*)/], // Bundle all NPM dependencies
+    external: [/^node:/], // Leave Node.js native built-ins external
+    outDir: '../../../desktop-extension',
+    dts: false,
+    sourcemap: false,
+    clean: false, // Don't clean the whole dir (preserves icon and manifest)
+  }
 ]);