mcp-word-bridge 4.1.0 → 4.1.1

package/dist/server.js

@@ -18722,7 +18722,15 @@ var Bridge = class {
 
 // src/server/mcp.ts
 var import_server = require("@modelcontextprotocol/sdk/server/index.js");
-var import_types7 = require("@modelcontextprotocol/sdk/types.js");
+var import_types8 = require("@modelcontextprotocol/sdk/types.js");
+
+// src/server/types.ts
+var ToolError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ToolError";
+  }
+};
 
 // src/server/tools/helpers.ts
 function jsonResult(data) {
@@ -18823,6 +18831,9 @@ var getDocumentOutline = {
   },
   async handler(args, bridge2) {
     const maxLevel = args.maxLevel ?? 3;
+    if (typeof args.maxLevel === "number" && (args.maxLevel < 1 || args.maxLevel > 9 || !Number.isInteger(args.maxLevel))) {
+      throw new ToolError("maxLevel must be an integer between 1 and 9.");
+    }
     const result = await bridge2.send("getParagraphs", {});
     const headings = [];
     for (const para of result.paragraphs) {
@@ -18854,14 +18865,6 @@ var documentTools = [
   getDocumentOutline
 ];
 
-// src/server/types.ts
-var ToolError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ToolError";
-  }
-};
-
 // src/server/validation.ts
 function checkNonEmpty(value, name) {
   if (!value || typeof value !== "string" || value.trim() === "") {
@@ -19180,12 +19183,17 @@ var paragraphTools = [
 // src/server/tools/search.ts
 var search = forwardTool(
   "word_search",
-  '[Search] Find text in the document. Returns match count and up to 30 matches. Query must be \u2264255 chars. Note: Word search codes (^p = paragraph mark, ^t = tab) are interpreted. To search for literal "^", use "^^".',
+  '[Search] Find text in the document. Returns match count and up to 30 matches. Query must be \u2264255 chars. Supports Word search codes (^p = paragraph mark, ^t = tab, etc.) and wildcard mode (?, *, [], {n,m}). To search for literal "^", use "^^".',
   {
     properties: {
       query: { type: "string" },
       matchCase: { type: "boolean", description: "Case-sensitive search. Default: false" },
-      matchWholeWord: { type: "boolean" }
+      matchWholeWord: { type: "boolean", description: "Match whole words only. Default: false" },
+      matchWildcards: { type: "boolean", description: "Enable wildcard/regex search (?, *, [], {n,m}, @). Default: false" },
+      matchPrefix: { type: "boolean", description: "Match words that begin with the search string. Default: false" },
+      matchSuffix: { type: "boolean", description: "Match words that end with the search string. Default: false" },
+      ignorePunct: { type: "boolean", description: "Ignore punctuation between words when matching. Default: false" },
+      ignoreSpace: { type: "boolean", description: "Ignore whitespace between words when matching. Default: false" }
     },
     required: ["query"]
   },
@@ -19193,13 +19201,18 @@ var search = forwardTool(
 );
 var searchAndReplace = {
   name: "word_search_and_replace",
-  description: "[Search] Find and replace ALL occurrences. Supports Word search codes (^p = paragraph mark, ^t = tab). For single-paragraph edits, prefer word_replace_paragraph_text.",
+  description: "[Search] Find and replace ALL occurrences. Supports Word search codes in both find and replace: ^p (paragraph mark), ^l (line break), ^m (page break), ^n (column break), ^t (tab), ^s (non-breaking space), ^~ (non-breaking hyphen), ^- (optional hyphen), ^+ (em dash), ^= (en dash), ^^ (literal caret). Supports wildcard search in find string. For single-paragraph edits, prefer word_replace_paragraph_text.",
   schema: {
     properties: {
       find: { type: "string" },
       replace: { type: "string" },
       matchCase: { type: "boolean", description: "Default: false" },
-      matchWholeWord: { type: "boolean" },
+      matchWholeWord: { type: "boolean", description: "Match whole words only. Default: false" },
+      matchWildcards: { type: "boolean", description: "Enable wildcard/regex search in find string (?, *, [], {n,m}, @). Default: false" },
+      matchPrefix: { type: "boolean", description: "Match words that begin with the find string. Default: false" },
+      matchSuffix: { type: "boolean", description: "Match words that end with the find string. Default: false" },
+      ignorePunct: { type: "boolean", description: "Ignore punctuation between words when matching. Default: false" },
+      ignoreSpace: { type: "boolean", description: "Ignore whitespace between words when matching. Default: false" },
       preserveBookmarks: { type: "boolean", description: "Re-create bookmarks on replacement text after replace. Default: false" }
     },
     required: ["find", "replace"]
@@ -19215,14 +19228,19 @@ var searchAndReplace = {
 };
 var insertTextAtMatch = forwardTool(
   "word_insert_text_at_match",
-  '[Search] Insert text before or after a search match. Provide "after" OR "before" as the anchor text. Use occurrence for Nth match.',
+  '[Search] Insert text before or after a search match. Supports Word search codes in inserted text: ^p (paragraph mark), ^l (line break), ^t (tab), ^s (non-breaking space), ^m (page break), ^n (column break), ^~ (non-breaking hyphen), ^- (optional hyphen), ^+ (em dash), ^= (en dash), ^^ (literal caret). Provide "after" OR "before" as the anchor text. Use occurrence for Nth match.',
   {
     properties: {
       text: { type: "string", description: "Text to insert" },
       after: { type: "string", description: "Search for this text and insert AFTER it" },
       before: { type: "string", description: "Search for this text and insert BEFORE it" },
       occurrence: { type: "number", description: "0=first, 1=second, etc. Default: 0" },
-      matchCase: { type: "boolean", description: "Default: false" }
+      matchCase: { type: "boolean", description: "Default: false" },
+      matchWildcards: { type: "boolean", description: "Enable wildcard/regex search for anchor text. Default: false" },
+      matchPrefix: { type: "boolean", description: "Match words that begin with the anchor text. Default: false" },
+      matchSuffix: { type: "boolean", description: "Match words that end with the anchor text. Default: false" },
+      ignorePunct: { type: "boolean", description: "Ignore punctuation between words when matching. Default: false" },
+      ignoreSpace: { type: "boolean", description: "Ignore whitespace between words when matching. Default: false" }
     },
     required: ["text"]
   },
@@ -19813,6 +19831,9 @@ var setContentControlText = {
     if (tag) {
       const ccResult = await bridge2.send("getContentControls", {});
       const matches = ccResult.controls.filter((c) => c.tag === tag);
+      if (matches.length === 0) {
+        throw new ToolError(`Content control with tag "${tag}" not found. Use word_get_content_controls to list available controls.`);
+      }
       if (matches.length > 1) {
         throw new ToolError(
           `Multiple content controls (${matches.length}) share tag "${tag}". Use "id" instead to target a specific control. Matching IDs: ${matches.map((m) => m.id).join(", ")}.`
@@ -20442,7 +20463,7 @@ After inserting a Table of Contents, heading text appears twice (in TOC and body
 // package.json
 var package_default = {
   name: "mcp-word-bridge",
-  version: "4.1.0",
+  version: "4.1.1",
   description: "MCP server for live Word document editing via Office Add-in",
   main: "dist/server.js",
   bin: {
@@ -20507,7 +20528,7 @@ function createMcpServer(bridge2) {
   );
   const { tools, handlers } = buildToolRegistry();
   const toolMutex = createMutex();
-  server.setRequestHandler(import_types7.ListToolsRequestSchema, async () => ({
+  server.setRequestHandler(import_types8.ListToolsRequestSchema, async () => ({
     tools: tools.map((t) => ({
       name: t.name,
       description: t.description,
@@ -20518,7 +20539,7 @@ function createMcpServer(bridge2) {
       }
     }))
   }));
-  server.setRequestHandler(import_types7.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(import_types8.CallToolRequestSchema, async (request) => {
     return toolMutex.run(async () => {
       const { name, arguments: args } = request.params;
       const handler = handlers.get(name);
@@ -20534,7 +20555,7 @@ function createMcpServer(bridge2) {
       }
     });
   });
-  server.setRequestHandler(import_types7.ListResourcesRequestSchema, async () => ({
+  server.setRequestHandler(import_types8.ListResourcesRequestSchema, async () => ({
     resources: [{
       uri: "word-bridge://usage-guide",
       name: "Word Bridge Usage Guide",
@@ -20542,7 +20563,7 @@ function createMcpServer(bridge2) {
       mimeType: "text/markdown"
     }]
   }));
-  server.setRequestHandler(import_types7.ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler(import_types8.ReadResourceRequestSchema, async (request) => {
     if (request.params.uri === "word-bridge://usage-guide") {
       return { contents: [{ uri: request.params.uri, mimeType: "text/markdown", text: usageGuide }] };
     }