@tiwater/office-mcp 0.18.17 → 0.19.1

package/office/contracts/docx_delete_table_columns.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_delete_table_columns",
+  "type": "object",
+  "properties": {
+    "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read" },
+    "changes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "table": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "columns": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "part": { "type": "string", "minLength": 1 },
+                "path": { "type": "string", "pattern": "^\\/" }
+              },
+              "required": ["part", "path"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["table", "columns"],
+        "additionalProperties": false
+      }
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Output DOCX path; may equal input for an atomic in-place update.",
+      "x-tiwater-file-role": "write"
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "changes", "output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/contracts/docx_insert_table_columns.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_insert_table_columns",
+  "type": "object",
+  "properties": {
+    "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read" },
+    "changes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "table": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "sourceColumn": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "before": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "repeat": { "type": "integer", "minimum": 1, "maximum": 2147483647 }
+        },
+        "required": ["table", "sourceColumn"],
+        "additionalProperties": false
+      }
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Output DOCX path; may equal input for an atomic in-place update.",
+      "x-tiwater-file-role": "write"
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "changes", "output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/contracts/tiwater-office-provider-contract-manifest-v1.json

@@ -2,7 +2,7 @@
   "schema": "tiwater.office-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.18.17"
+    "version": "0.19.1"
   },
   "tools": [
     {
@@ -60,6 +60,17 @@
         "sha256": "4497eb24df0e5631601232a8b35a9eddf914d02146992dd22f1cfba93ef7780f"
       }
     },
+    {
+      "name": "docx_delete_table_columns",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_delete_table_columns.schema.json",
+        "sha256": "4ce8f6d047fe30f50c711a4d9c1ee10efd6de886294f217e5d11f0bab58c9a90"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_delete_table_columns.schema.json",
+        "sha256": "4ce8f6d047fe30f50c711a4d9c1ee10efd6de886294f217e5d11f0bab58c9a90"
+      }
+    },
     {
       "name": "docx_export_json",
       "providerContract": {
@@ -82,6 +93,17 @@
         "sha256": "7cf239b13a9a5bfe15d426f9ed5747c5900a908d4877eeb77ddd9088afe8966f"
       }
     },
+    {
+      "name": "docx_insert_table_columns",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_insert_table_columns.schema.json",
+        "sha256": "bd07a489c6b6cd3538e133b99613fac84438de3097ff6ed8f5f1a32ef18a7b5a"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_insert_table_columns.schema.json",
+        "sha256": "bd07a489c6b6cd3538e133b99613fac84438de3097ff6ed8f5f1a32ef18a7b5a"
+      }
+    },
     {
       "name": "docx_inspect",
       "providerContract": {
@@ -159,17 +181,6 @@
         "sha256": "25f4d4e7c69fa5a2c4a82621aa58ea8eda21245636f84f2243ca4e9092616b68"
       }
     },
-    {
-      "name": "docx_replace_table_rows",
-      "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_replace_table_rows.schema.json",
-        "sha256": "180cd21147fcd8158d640d769d9b6e435f0fe8761a0c41a03b711582dfb9c64c"
-      },
-      "inputContract": {
-        "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "180cd21147fcd8158d640d769d9b6e435f0fe8761a0c41a03b711582dfb9c64c"
-      }
-    },
     {
       "name": "docx_set_text",
       "providerContract": {

package/office/index.mjs

@@ -246,7 +246,7 @@ const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
 }).strict();
 
 const docxTableReadOutput = artifactOutput('docx_read_table').extend({
-  schema: z.literal('tiwater.docx-table-read/v1'),
+  schema: z.literal('tiwater.docx-table-read/v2'),
   receipt: z.object({
     schema: z.literal('tiwater.docx-table-read-receipt/v1'),
     totalRowCount: z.number().int().nonnegative(),
@@ -259,6 +259,10 @@ const docxTableReadOutput = artifactOutput('docx_read_table').extend({
   address: docxAddress,
   rowCount: z.number().int().nonnegative(),
   columnCount: z.number().int().nonnegative(),
+  gridColumns: z.array(z.object({
+    address: docxAddress,
+    widthTwips: z.number().int().positive().nullable(),
+  }).strict()),
   precedingParagraph: z.object({
     address: docxAddress,
     textPreview: z.string(),
@@ -271,12 +275,16 @@ const docxTableReadOutput = artifactOutput('docx_read_table').extend({
   }).strict().nullable(),
   rows: z.array(z.object({
     address: docxAddress,
+    repeatHeader: z.boolean(),
+    cantSplit: z.boolean(),
     gridBefore: z.number().int().nonnegative(),
     gridAfter: z.number().int().nonnegative(),
     cells: z.array(z.object({
       address: docxAddress,
+      gridColumnStart: z.number().int().nonnegative(),
       gridSpan: z.number().int().positive(),
       verticalMerge: z.string().nullable(),
+      verticalMergeOwner: docxAddress.nullable(),
       paragraphs: z.array(z.object({
         address: docxAddress,
         text: z.string(),
@@ -335,7 +343,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Writes the complete table, including text nodes, to output and returns a bounded row page with cells, spans, vertical merges, paragraph text, and reusable addresses. In a vertical merge, restart begins one logical cell and following continue cells belong to it; a continue cell is not an independent row value. Continue with receipt.nextOffset. If receipt.narrowingRequired is true, list rows under the same table and read smaller objects. It does not locate a table or decide business meaning.',
+    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Writes the complete table, including text nodes, to output and returns a bounded row page with grid-column addresses and widths, each cell\'s zero-based grid start and span, vertical-merge owner, repeated-header and no-split row properties, paragraph text, and reusable addresses. In a vertical merge, restart begins one logical cell and a continue cell is not an independent row value. The provider reports physical structure only; the Agent decides the template and business meaning. Continue with receipt.nextOffset. If receipt.narrowingRequired is true, list rows under the same table and read smaller objects.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -355,23 +363,16 @@ const tools = [
     outputSchema: fixedEditOutput('docx_set_text'),
     handler: args => fixedEdit('docx_set_text', args),
   },
-  {
-    name: 'docx_replace_table_rows',
-    description: 'Atomically replace a contiguous data-row range in existing target tables after reading both tables. Each range excludes its header and closes vertical merges; omit targetRows.last to replace through the table end. It maps complete source columns into the target grid and copies every source paragraph. Prepare any semantic content changes with separate published text or object operations before this structural replacement.',
-    inputSchema: inputContract('docx_replace_table_rows'),
-    outputSchema: fixedEditOutput('docx_replace_table_rows'),
-    handler: args => fixedEdit('docx_replace_table_rows', args),
-  },
   {
     name: 'docx_insert_objects',
-    description: 'Insert selected current DOCX objects under an existing parent. Table rows are objects: expand a target table by copying observed row patterns into that table, using before for insertion position and repeat for count; sourceInput may equal input. This inserts new rows only; use docx_replace_table_rows to replace an existing data-row range from a source table.',
+    description: 'Insert selected current DOCX objects under an existing parent. Table rows are objects: expand a target table by copying one contiguous observed row range and use repeat for count; sourceInput may equal input. A row range beginning with vertical-merge continuations may be inserted only inside a target boundary with the same active grid spans, which extends those merges. Individual table cells are not raw insertion targets because that would bypass the table grid.',
     inputSchema: inputContract('docx_insert_objects'),
     outputSchema: fixedEditOutput('docx_insert_objects'),
     handler: args => fixedEdit('docx_insert_objects', args),
   },
   {
     name: 'docx_delete_object',
-    description: 'Delete selected current DOCX objects directly from the current target document.',
+    description: 'Delete selected current DOCX objects directly from the current target document. Selected table rows must close every vertical merge and cannot remove the whole table. Individual table cells are not raw deletion targets; use column or merge operations for table structure.',
     inputSchema: inputContract('docx_delete_object'),
     outputSchema: fixedEditOutput('docx_delete_object'),
     handler: args => fixedEdit('docx_delete_object', args),
@@ -390,6 +391,20 @@ const tools = [
     outputSchema: fixedEditOutput('docx_split_cells'),
     handler: args => fixedEdit('docx_split_cells', args),
   },
+  {
+    name: 'docx_insert_table_columns',
+    description: 'Insert empty template-shaped grid columns into one current main-document table. Select an observed source grid column for width and per-row cell formatting, and optionally a before grid-column address; cells spanning the insertion boundary expand instead of being split. It does not copy business values or decide column meaning.',
+    inputSchema: inputContract('docx_insert_table_columns'),
+    outputSchema: fixedEditOutput('docx_insert_table_columns'),
+    handler: args => fixedEdit('docx_insert_table_columns', args),
+  },
+  {
+    name: 'docx_delete_table_columns',
+    description: 'Delete selected observed grid columns from one current main-document table while shrinking spanning cells and preserving the remaining table grid. It cannot remove every column and does not decide whether a business column is unused.',
+    inputSchema: inputContract('docx_delete_table_columns'),
+    outputSchema: fixedEditOutput('docx_delete_table_columns'),
+    handler: args => fixedEdit('docx_delete_table_columns', args),
+  },
   {
     name: 'docx_compare',
     description: 'Compare two DOCX files and report package, metric, and style differences.',
@@ -730,6 +745,7 @@ async function docxObservation(tool, args) {
         address: payload.address,
         rowCount: payload.rowCount,
         columnCount: payload.columnCount,
+        gridColumns: payload.gridColumns,
         precedingParagraph: payload.precedingParagraph,
         followingParagraph: payload.followingParagraph,
         receipt: {

package/package.json

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

package/office/contracts/docx_replace_table_rows.schema.json

@@ -1,234 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "tables": {
-      "minItems": 1,
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "sourceInput": {
-            "type": "string",
-            "minLength": 1,
-            "x-tiwater-file-role": "read"
-          },
-          "sourceTable": {
-            "type": "object",
-            "properties": {
-              "part": {
-                "type": "string",
-                "minLength": 1
-              },
-              "path": {
-                "type": "string",
-                "pattern": "^\\/"
-              }
-            },
-            "required": [
-              "part",
-              "path"
-            ],
-            "additionalProperties": false
-          },
-          "sourceRows": {
-            "type": "object",
-            "description": "Contiguous source data rows. The header row stays outside this range. The first and last row must enclose complete vertical-merge groups as reported by docx_read_table.",
-            "properties": {
-              "first": {
-                "type": "object",
-                "properties": {
-                  "part": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "path": {
-                    "type": "string",
-                    "pattern": "^\\/"
-                  }
-                },
-                "required": [
-                  "part",
-                  "path"
-                ],
-                "additionalProperties": false
-              },
-              "last": {
-                "type": "object",
-                "properties": {
-                  "part": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "path": {
-                    "type": "string",
-                    "pattern": "^\\/"
-                  }
-                },
-                "required": [
-                  "part",
-                  "path"
-                ],
-                "additionalProperties": false
-              }
-            },
-            "required": [
-              "first",
-              "last"
-            ],
-            "additionalProperties": false
-          },
-          "targetTable": {
-            "type": "object",
-            "properties": {
-              "part": {
-                "type": "string",
-                "minLength": 1
-              },
-              "path": {
-                "type": "string",
-                "pattern": "^\\/"
-              }
-            },
-            "required": [
-              "part",
-              "path"
-            ],
-            "additionalProperties": false
-          },
-          "targetRows": {
-            "type": "object",
-            "description": "Contiguous target data rows to replace. The header row stays outside this range. Omit last to replace from first through the table's final row. An explicit first and last must enclose complete vertical-merge groups as reported by docx_read_table.",
-            "properties": {
-              "first": {
-                "type": "object",
-                "properties": {
-                  "part": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "path": {
-                    "type": "string",
-                    "pattern": "^\\/"
-                  }
-                },
-                "required": [
-                  "part",
-                  "path"
-                ],
-                "additionalProperties": false
-              },
-              "last": {
-                "type": "object",
-                "properties": {
-                  "part": {
-                    "type": "string",
-                    "minLength": 1
-                  },
-                  "path": {
-                    "type": "string",
-                    "pattern": "^\\/"
-                  }
-                },
-                "required": [
-                  "part",
-                  "path"
-                ],
-                "additionalProperties": false
-              }
-            },
-            "required": [
-              "first"
-            ],
-            "additionalProperties": false
-          },
-          "columns": {
-            "minItems": 1,
-            "type": "array",
-            "description": "Source-to-target header-cell mappings. Source headers share one row, target headers share one row, both header rows stay outside the selected data rows, and each side covers its complete table grid.",
-            "items": {
-              "type": "object",
-              "properties": {
-                "sourceHeader": {
-                  "type": "object",
-                  "properties": {
-                    "part": {
-                      "type": "string",
-                      "minLength": 1
-                    },
-                    "path": {
-                      "type": "string",
-                      "pattern": "^\\/"
-                    }
-                  },
-                  "required": [
-                    "part",
-                    "path"
-                  ],
-                  "additionalProperties": false
-                },
-                "targetHeader": {
-                  "type": "object",
-                  "properties": {
-                    "part": {
-                      "type": "string",
-                      "minLength": 1
-                    },
-                    "path": {
-                      "type": "string",
-                      "pattern": "^\\/"
-                    }
-                  },
-                  "required": [
-                    "part",
-                    "path"
-                  ],
-                  "additionalProperties": false
-                }
-              },
-              "required": [
-                "sourceHeader",
-                "targetHeader"
-              ],
-              "additionalProperties": false
-            }
-          }
-        },
-        "required": [
-          "sourceInput",
-          "sourceTable",
-          "sourceRows",
-          "targetTable",
-          "targetRows",
-          "columns"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Output DOCX path; may equal input for an atomic in-place update.",
-      "x-tiwater-file-role": "write"
-    },
-    "receiptOutput": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "write",
-      "x-tiwater-file-effect": false
-    }
-  },
-  "required": [
-    "input",
-    "tables",
-    "output",
-    "receiptOutput"
-  ],
-  "additionalProperties": false,
-  "$id": "tiwater.office-mcp-input/docx_replace_table_rows"
-}