@tiwater/office-mcp 0.15.13 → 0.16.0

package/office/index.mjs

@@ -100,57 +100,6 @@ const nativeRenderOutput = z.object({
   }).strict(),
 }).strict();
 
-const docxFixedTools = [
-  {"name":"docx_set_anchored_text","description":"Set text at current DOCX comment anchors."},
-  {"name":"docx_set_paragraph_text","description":"Set current body paragraph text."},
-  {"name":"docx_set_paragraph_run_text","description":"Set current body paragraph run text."},
-  {"name":"docx_replace_body_text","description":"Replace uniquely matched current body text."},
-  {"name":"docx_delete_body_paragraph","description":"Delete uniquely matched current body paragraphs."},
-  {"name":"docx_delete_body_drawing_before_paragraph","description":"Delete the drawing immediately before a uniquely matched current paragraph."},
-  {"name":"docx_insert_body_range","description":"Insert a bounded direct-body range from a current source DOCX before a current target body boundary, preserving supported styles and relationships."},
-  {"name":"docx_replace_drawing_image","description":"Replace the image relationship of a current body drawing while preserving its drawing geometry."},
-  {"name":"docx_insert_body_image","description":"Insert an image as a new inline drawing before a current direct-body boundary."},
-  {"name":"docx_delete_body_range","description":"Delete uniquely bounded current body ranges."},
-  {"name":"docx_start_section","description":"Start a section before a uniquely matched current paragraph."},
-  {"name":"docx_set_header_paragraph_text","description":"Set current header paragraph text."},
-  {"name":"docx_set_header_run_text","description":"Set current header run text."},
-  {"name":"docx_replace_header_text","description":"Replace uniquely matched current header text."},
-  {"name":"docx_set_footer_paragraph_text","description":"Set current footer paragraph text."},
-  {"name":"docx_set_footer_run_text","description":"Set current footer run text."},
-  {"name":"docx_set_table_cell_text","description":"Set current body table cell text."},
-  {"name":"docx_set_table_cell_run_text","description":"Set current body table cell run text."},
-  {"name":"docx_set_header_table_cell_text","description":"Set current header table cell text."},
-  {"name":"docx_set_header_table_cell_run_text","description":"Set current header table cell run text."},
-  {"name":"docx_set_footer_table_cell_text","description":"Set current footer table cell text."},
-  {"name":"docx_set_footer_table_cell_run_text","description":"Set current footer table cell run text."},
-  {"name":"docx_set_table_cell_rich_text","description":"Set current body table cell rich text."},
-  {"name":"docx_insert_table_rows","description":"Insert rows into a current body table."},
-  {"name":"docx_delete_table_rows","description":"Delete current body table row ranges."},
-  {"name":"docx_replace_table_rows","description":"Replace an inclusive range of existing current body table rows with explicit final rows. startRowIndex/endRowIndex address existing rows and do not describe the number of replacement rows; rows may contain a different count. Use when values must be regrouped, filtered, assigned to different semantic columns, or given explicit gridSpan/vMerge states; matching template-row styles are retained."},
-  {"name":"docx_insert_table_columns","description":"Insert columns into a current body table."},
-  {"name":"docx_set_table_width","description":"Set current body table widths."},
-  {"name":"docx_set_table_cell_alignment","description":"Set current body table cell alignment."},
-  {"name":"docx_set_table_cell_no_wrap","description":"Set current body table cell no-wrap state."},
-  {"name":"docx_set_table_cell_font_size","description":"Set current body table cell font size."},
-  {"name":"docx_apply_font_policy","description":"Apply an explicit font policy to current document text."},
-  {"name":"docx_set_table_row_height","description":"Set current body table row height."},
-  {"name":"docx_set_table_row_cant_split","description":"Set current body table row split behavior."},
-  {"name":"docx_set_table_row_repeat_as_header","description":"Set or unset repeat-as-header on uniquely addressed current body, header, or footer table rows."},
-  {"name":"docx_set_table_row_keep_next","description":"Set keep-next behavior for current body table rows."},
-  {"name":"docx_set_body_paragraph_keep_next","description":"Set keep-next behavior for current body paragraphs."},
-  {"name":"docx_set_body_paragraph_keep_lines","description":"Set keep-lines behavior for current body paragraphs."},
-  {"name":"docx_apply_toc_style_policy","description":"Apply current document table-of-contents paragraph style properties."},
-  {"name":"docx_set_header_paragraph_font_size","description":"Set current header paragraph font size."},
-  {"name":"docx_collapse_trailing_empty_section","description":"Collapse a current trailing empty section."},
-  {"name":"docx_collapse_trailing_empty_paragraphs","description":"Collapse current trailing empty body paragraphs."},
-  {"name":"docx_merge_cells","description":"Merge selected current DOCX cells when they form one closed rectangle."},
-  {"name":"docx_split_cells","description":"Split selected current DOCX merged cells."},
-  {"name":"docx_delete_comments","description":"Delete explicit current DOCX comments."},
-  {"name":"docx_mark_fields_dirty","description":"Mark current DOCX fields for native refresh."},
-  {"name":"docx_sanitize_fields","description":"Remove update prompts and dirty markers from current DOCX fields."},
-  {"name":"docx_freeze_fields","description":"Convert current visible DOCX field results to ordinary content."},
-];
-
 const xlsxFixedTools = [
   {"name":"xlsx_set_cell_value","description":"Set current workbook cell values."},
   {"name":"xlsx_set_cell_number_format","description":"Set current workbook cell number formats."},
@@ -205,14 +154,14 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not document-text extraction. For content, use docx_find_literal and then docx_read_object on the selected table or row. Use parentRef for nearest children: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
+    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not selection by text. To select a table or row by any descendant cell text, call docx_find_literal with kind table or row instead of listing the document. Use parentRef for nearest children: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
     inputSchema: inputContract('docx_list_objects'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
   {
     name: 'docx_find_literal',
-    description: 'Find exact current text in one small page of revision-bound native DOCX objects, then pass a selected table or row ref to docx_read_object. Use parentRef to search only the nearest published children of a selected part, table, row, cell, or paragraph; this is not recursive descendant search.',
+    description: 'Find exact current text in one small page of revision-bound native DOCX objects. With kind table or row, matching includes all descendant cell text, so no prior paragraph, cell, or document-wide list is needed. Use parentRef only to search nearest published children of a selected object.',
     inputSchema: inputContract('docx_find_literal'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_find_literal', args),
@@ -246,6 +195,20 @@ const tools = [
     outputSchema: fixedEditOutput('docx_delete_object'),
     handler: args => fixedEdit('docx_delete_object', args),
   },
+  {
+    name: 'docx_merge_cells',
+    description: 'Merge selected current DOCX cells when they form one closed rectangle.',
+    inputSchema: inputContract('docx_merge_cells'),
+    outputSchema: fixedEditOutput('docx_merge_cells'),
+    handler: args => fixedEdit('docx_merge_cells', args),
+  },
+  {
+    name: 'docx_split_cells',
+    description: 'Split selected current DOCX merged cells.',
+    inputSchema: inputContract('docx_split_cells'),
+    outputSchema: fixedEditOutput('docx_split_cells'),
+    handler: args => fixedEdit('docx_split_cells', args),
+  },
   {
     name: 'docx_compare',
     description: 'Compare two DOCX files and report package, metric, and style differences.',
@@ -293,7 +256,6 @@ const tools = [
     inputSchema: inputContract('docx_replace_style_ids'),
     handler: docxReplaceStyleIds,
   },
-  ...fixedToolDefinitions(docxFixedTools),
   {
     name: 'office_render_pdf',
     description: 'Render a current Office document to PDF with its required native WPS backend and write the complete provider receipt as evidence. The input extension selects Writer, Spreadsheets, or Presentation; fallback rendering is rejected.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.15.13",
+  "version": "0.16.0",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",

package/office/contracts/docx_apply_font_policy.schema.json

@@ -1,77 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "fontPolicy": {
-            "type": "object",
-            "properties": {
-              "schema": {
-                "type": "string",
-                "minLength": 1
-              },
-              "body": {
-                "type": "object",
-                "propertyNames": {
-                  "type": "string"
-                },
-                "additionalProperties": {
-                  "type": "string"
-                }
-              },
-              "table": {
-                "type": "object",
-                "propertyNames": {
-                  "type": "string"
-                },
-                "additionalProperties": {
-                  "type": "string"
-                }
-              }
-            },
-            "required": [
-              "schema",
-              "body",
-              "table"
-            ],
-            "additionalProperties": false
-          }
-        },
-        "required": [
-          "fontPolicy"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_apply_toc_style_policy.schema.json

@@ -1,53 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "italic": {
-            "type": "boolean"
-          },
-          "indentCharactersPerLevel": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          }
-        },
-        "required": [
-          "italic",
-          "indentCharactersPerLevel"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_collapse_trailing_empty_paragraphs.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_collapse_trailing_empty_section.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_delete_body_drawing_before_paragraph.schema.json

@@ -1,54 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "findText": {
-            "type": "string",
-            "minLength": 1
-          },
-          "matchMode": {
-            "type": "string"
-          },
-          "paragraphStyle": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "findText"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_delete_body_paragraph.schema.json

@@ -1,54 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "findText": {
-            "type": "string",
-            "minLength": 1
-          },
-          "matchMode": {
-            "type": "string"
-          },
-          "paragraphStyle": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "findText"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_delete_body_range.schema.json

@@ -1,69 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "findText": {
-            "type": "string",
-            "minLength": 1
-          },
-          "endFindText": {
-            "type": "string"
-          },
-          "matchMode": {
-            "type": "string"
-          },
-          "endMatchMode": {
-            "type": "string"
-          },
-          "paragraphStyle": {
-            "type": "string"
-          },
-          "endParagraphStyle": {
-            "type": "string"
-          },
-          "deleteToBodyEnd": {
-            "type": "boolean"
-          },
-          "removePrecedingPageBreak": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "findText"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_delete_comments.schema.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "commentIds": {
-            "minItems": 1,
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          }
-        },
-        "required": [
-          "commentIds"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_delete_table_rows.schema.json

@@ -1,61 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    },
-    "changes": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "tableIndex": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          },
-          "startRowIndex": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          },
-          "endRowIndex": {
-            "type": "integer",
-            "minimum": 0,
-            "maximum": 9007199254740991
-          }
-        },
-        "required": [
-          "tableIndex",
-          "startRowIndex",
-          "endRowIndex"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput",
-    "changes"
-  ],
-  "additionalProperties": false
-}

package/office/contracts/docx_freeze_fields.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New document output path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON receipt path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    }
-  },
-  "required": [
-    "input",
-    "output",
-    "receiptOutput"
-  ],
-  "additionalProperties": false
-}