mcp-word-bridge 4.0.1 → 4.0.3

package/dist/{server.cjs → server.js}

@@ -20203,108 +20203,166 @@ function buildToolRegistry() {
 // src/server/usage-guide.ts
 var usageGuide = `# MCP Word Bridge \u2014 Usage Guide
 
-Controls a live Word document through an Office Add-in. All operations execute immediately in Word.
+Controls a live Word document. All operations execute immediately.
 
 ## Quick Start
 
-1. **Read before writing** \u2014 call \`word_get_document_outline\` or \`word_get_paragraphs\` to understand the document structure
-2. **Use the right tool for the job:**
-   - Appending content \u2192 \`word_insert_paragraph\` (Start/End)
-   - Inserting at a position \u2192 \`word_insert_paragraph_at_index\` (Before/After by index)
-   - Editing existing text \u2192 \`word_replace_paragraph_text\` (by index, safe for collaboration)
+1. **Read before writing** \u2014 call \`word_get_document_outline\` or \`word_get_paragraphs\` to understand structure
+2. **Use the right tool:**
+   - Append content \u2192 \`word_insert_paragraph\` (Start/End)
+   - Insert at position \u2192 \`word_insert_paragraph_at_index\` (Before/After by index)
+   - Edit existing text \u2192 \`word_replace_paragraph_text\` (by index, preferred)
    - Bulk find/replace \u2192 \`word_search_and_replace\` (all occurrences)
-   - Inserting adjacent to text \u2192 \`word_insert_text_at_match\` (searches then inserts)
-3. **Batch multiple operations** \u2014 use \`word_batch\` to send up to 50 operations in one call
+   - Insert adjacent to text \u2192 \`word_insert_text_at_match\` (searches then inserts)
+3. **Batch operations** \u2014 use \`word_batch\` for multiple operations in one call (faster, fewer round-trips)
 4. **Save explicitly** \u2014 call \`word_save\` after significant changes
 
-## Reading Content
-- \`word_get_document_outline\` \u2014 heading hierarchy (fast structural overview)
-- \`word_get_paragraphs\` \u2014 all paragraphs with text, style, alignment. Paginate with start/end.
-- \`word_get_text\` \u2014 quick plain-text dump
+## Reading
+
+- \`word_get_document_outline\` \u2014 heading tree (fast structural overview)
+- \`word_get_paragraphs\` \u2014 paragraphs with text, style, alignment. Paginate with start/end.
+- \`word_get_paragraph_by_index\` \u2014 full details of one paragraph (font, spacing, indent)
+- \`word_get_text\` \u2014 plain-text dump (no structure)
 - \`word_search\` \u2014 locate text before operating on it
 
-## Editing Text
-- \`word_replace_paragraph_text\` \u2014 replace text by paragraph index (PREFERRED for collaborative docs)
+## Editing
+
+- \`word_replace_paragraph_text\` \u2014 replace by index (safe for collaboration, preserves style)
 - \`word_search_and_replace\` \u2014 bulk find/replace across document
-- \`word_insert_text_at_match\` \u2014 insert before/after a search match
-- \`word_move_paragraph\` \u2014 reorder content (avoids index-shifting bugs with manual delete+insert)
-- \`word_copy_paragraph\` \u2014 duplicate content with full fidelity (footnotes, formatting, hyperlinks preserved)
+- \`word_insert_text_at_match\` \u2014 insert before/after a search match (use \`occurrence\` for Nth)
+- \`word_move_paragraph\` \u2014 reorder content (preserves footnotes, formatting, hyperlinks)
+- \`word_copy_paragraph\` \u2014 duplicate content with full fidelity
+- Verify edits with \`word_search\` or \`word_get_paragraphs\`
+
+## Batch
 
-## Batch Operations
-\`word_batch\` executes multiple operations in a single MCP call:
 \`\`\`json
 {"operations": [
   {"tool": "word_insert_paragraph", "args": {"text": "Hello", "style": "Heading 1"}},
-  {"tool": "word_insert_paragraph", "args": {"text": "World", "style": "Normal"}},
-  {"tool": "word_save", "args": {}}
+  {"tool": "word_insert_paragraph", "args": {"text": "World"}},
+  {"tool": "word_format_text", "args": {"text": "Hello", "bold": true}}
 ]}
 \`\`\`
-Operations run sequentially. If one fails, the rest are skipped. Maximum 50 per batch.
+Runs sequentially. Stops on first error. Maximum 50 per batch. Prefer batching over individual calls.
 
-## Search Behavior
-- Case-insensitive by default. Pass \`matchCase: true\` for exact case match.
-- Query must be \u2264255 characters.
-- Affected tools: search, search_and_replace, insert_text_at_match, format_text, insert_footnote, add_comment, insert_hyperlink, insert_bookmark, insert_content_control, clear_formatting, get_font_info, insert_line_break, remove_hyperlink, insert_endnote, insert_equation (inline with anchor).
+## Search
 
-## Alignment Values
-Accepts: Left, Center/Centered, Right, Justify/Justified.
+- Case-insensitive by default. Pass \`matchCase: true\` for exact case.
+- Text parameters must be \u2264255 characters.
+- Use \`occurrence\` (0-indexed) to target the Nth match when multiple exist.
 
-## Change Tracking
-- Call \`word_set_change_tracking({mode:"TrackAll"})\` BEFORE edits for tracked changes
-- \`search_and_replace\` with tracking may only expose the "Added" half
+## Comments \u2014 Important
 
-## Comments
-- \`word_get_comments\` returns all comments with their anchor text
-- **\`word_search_and_replace\` on text anchoring a comment deletes the comment** \u2014 check comments first
-- Safe pattern: get_comments \u2192 reply/resolve \u2192 then replace text
+- \`word_get_comments\` returns comments with their anchor text
+- **Replacing text that anchors a comment deletes the comment** \u2014 always check comments first
+- Safe pattern: \`word_get_comments\` \u2192 \`word_reply_to_comment\`/\`word_resolve_comment\` \u2192 then replace
 
 ## Tables
+
 - All indices 0-based: tableIndex, row, col
-- \`word_list_tables\` for metadata (no cell values) \u2192 \`word_get_table_data\` for content
-- Can't insert page/section breaks inside table cells
+- \`word_list_tables\` for metadata \u2192 \`word_get_table_data\` for cell values
+- Cannot insert page/section breaks inside table cells
 
 ## Footnotes & Endnotes
-- \`word_insert_footnote\` \u2014 anchor to text match
-- \`word_insert_footnote_at_index\` \u2014 anchor to paragraph by index (no search needed)
+
+- \`word_insert_footnote\` \u2014 anchor to a text match
+- \`word_insert_footnote_at_index\` \u2014 anchor to a paragraph by index (no search needed)
 
 ## Page Layout
+
 - Margins in points (72 pt = 1 inch)
-- \`lineSpacing\` in points, not a multiplier (12pt font: 12=single, 18=1.5x, 24=double)
+- \`lineSpacing\` is in points, not a multiplier (12pt font: 12=single, 18=1.5x, 24=double)
 
 ## Content Controls
-- RichText/PlainText: wraps the anchor text (non-destructive)
-- CheckBox: REPLACES anchor text with a checkbox (cannot use set_content_control_text)
 
-## TOC Behavior
+- RichText/PlainText: wraps anchor text (non-destructive)
+- CheckBox: REPLACES anchor text with a checkbox (cannot set text after)
+
+## TOC
+
 After inserting a Table of Contents, heading text appears twice (in TOC and body). Search matches TOC entries first \u2014 use \`occurrence\` to target the body instance.
 
 ## Equations
-- Takes a LaTeX string, inserts a native Word equation
-- \`displayMode: true\` (default) = centered block, \`false\` = inline
-- For inline, provide \`anchorText\` to position after a search match
+
+- \`word_insert_equation\` takes LaTeX, inserts a native editable Word equation
+- \`displayMode: true\` (default) = centered block equation
+- \`displayMode: false\` = inline; provide \`anchorText\` to position after a match
 - Supports: fractions, roots, integrals, sums, matrices, Greek letters, AMS math
+- Examples: \`\\\\frac{a}{b}\`, \`\\\\int_0^\\\\infty e^{-x} dx\`, \`\\\\sum_{i=1}^n x_i\`
 
-## Error Messages
-- "Word taskpane not connected" \u2014 user must open the MCP Word Bridge add-in in Word
-- "Anchor not found" \u2014 search text not found in document
-- "Occurrence N not found" \u2014 match index out of range
+## Change Tracking
+
+- Call \`word_set_change_tracking({mode:"TrackAll"})\` BEFORE edits to track them
+- Tracked edits appear as revisions in Word (visible to collaborators)
 
 ## Best Practices
-1. Start with \`word_get_document_outline\` to understand structure
-2. \`word_get_comments\` before bulk replacements to avoid anchor damage
-3. Use \`word_batch\` for multiple sequential operations
-4. In collaborative editing, prefer index-based tools over search-based
-5. Enable change tracking for collaborative documents
-6. \`word_save\` explicitly after significant changes
-7. Resolve comments rather than deleting them (preserves audit trail)
-8. Use \`word_move_paragraph\` to reorder content
-9. Use \`word_copy_paragraph\` to duplicate content with full fidelity
+
+1. Read structure first (\`word_get_document_outline\`)
+2. Check comments before bulk replacements (\`word_get_comments\`)
+3. Batch multiple operations (\`word_batch\`)
+4. Prefer index-based tools over search-based in collaborative editing
+5. Use \`word_move_paragraph\` to reorder (not delete+insert)
+6. Use \`word_copy_paragraph\` to duplicate (preserves everything)
+7. Save explicitly after significant changes
+8. Resolve comments rather than deleting (preserves audit trail)
 `;
 
+// package.json
+var package_default = {
+  name: "mcp-word-bridge",
+  version: "4.0.3",
+  description: "MCP server for live Word document editing via Office Add-in",
+  main: "dist/server.js",
+  bin: {
+    "mcp-word-bridge": "dist/server.js",
+    "mcp-word-bridge-install": "scripts/install-manifest.js"
+  },
+  scripts: {
+    build: "node scripts/build.mjs",
+    start: "node dist/server.cjs",
+    dev: "node scripts/build.mjs --watch",
+    test: "vitest run",
+    "test:ci": "vitest run --reporter=default",
+    "test:live": "vitest run --config vitest.live.config.ts",
+    lint: "eslint src/",
+    typecheck: "tsc --noEmit",
+    prepublishOnly: "npm run build"
+  },
+  keywords: ["mcp", "word", "office", "add-in", "document", "editing"],
+  repository: {
+    type: "git",
+    url: "https://github.com/likelion/mcp-word-bridge.git"
+  },
+  author: "Leonid Mokrushin <likelion@gmail.com>",
+  license: "MIT",
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    mathml2omml: "^0.5.0",
+    temml: "^0.13.3",
+    ws: "^8.16.0"
+  },
+  devDependencies: {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10",
+    esbuild: "^0.25.0",
+    eslint: "^10.4.1",
+    typescript: "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    vitest: "^3.0.0"
+  },
+  files: [
+    "dist/",
+    "certs/cert.conf",
+    "taskpane.html",
+    "manifest.xml",
+    "scripts/install-manifest.js"
+  ]
+};
+
 // src/server/mcp.ts
 function createMcpServer(bridge2) {
   const server = new import_server.Server(
-    { name: "mcp-word-bridge", version: "4.0.1" },
+    { name: "mcp-word-bridge", version: package_default.version },
     { capabilities: { tools: {}, resources: {} } }
   );
   const { tools, handlers } = buildToolRegistry();
@@ -20492,4 +20550,4 @@ main().catch((e) => {
   process.stderr.write("[mcp-word-bridge] Fatal: " + e.message + "\n");
   process.exit(1);
 });
-//# sourceMappingURL=server.cjs.map
+//# sourceMappingURL=server.js.map