@tiwater/office-mcp 0.21.2 → 0.21.4

package/office/contracts/docx_set_table_body.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_set_table_body",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "x-tiwater-file-role": "read"
+    },
+    "table": {
+      "type": "object",
+      "properties": {
+        "part": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "pattern": "^\\/" }
+      },
+      "required": ["part", "path"],
+      "additionalProperties": false,
+      "description": "Current target table address returned by docx_read_table or docx_table_index."
+    },
+    "existingRows": {
+      "type": "object",
+      "description": "Exact contiguous current row range to replace. Rows outside this range stay unchanged, and the range must enclose every vertical merge it intersects.",
+      "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
+    },
+    "columns": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Complete target table grid in the native order returned by docx_read_table. IDs are request-local names used only by rows below.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 80 },
+          "gridColumn": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          }
+        },
+        "required": ["id", "gridColumn"],
+        "additionalProperties": false
+      }
+    },
+    "rows": {
+      "type": "array",
+      "minItems": 0,
+      "description": "Exact final rows; an empty array removes the declared range when at least one table row remains. Each final row names one current row in existingRows as its style prototype. Cells plus active row spans must cover the complete target grid exactly once.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "prototypeRow": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^\\/" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "cells": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "columns": {
+                  "type": "array",
+                  "minItems": 1,
+                  "description": "One or more contiguous request-local column IDs occupied by this cell.",
+                  "items": { "type": "string", "minLength": 1, "maxLength": 80 }
+                },
+                "text": { "type": "string" },
+                "rowSpan": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 2147483647,
+                  "description": "Number of final rows occupied by this cell; omitted means one row."
+                }
+              },
+              "required": ["columns", "text"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["prototypeRow", "cells"],
+        "additionalProperties": false
+      }
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Output DOCX path; may equal input for one 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", "table", "existingRows", "columns", "rows", "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.21.2"
+    "version": "0.21.4"
   },
   "tools": [
     {
@@ -181,6 +181,17 @@
         "sha256": "25f4d4e7c69fa5a2c4a82621aa58ea8eda21245636f84f2243ca4e9092616b68"
       }
     },
+    {
+      "name": "docx_set_table_body",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_set_table_body.schema.json",
+        "sha256": "2270274f25154dc0573c972c8c71240636e29e7e23a1eacae616952cc600b1e0"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_set_table_body.schema.json",
+        "sha256": "2270274f25154dc0573c972c8c71240636e29e7e23a1eacae616952cc600b1e0"
+      }
+    },
     {
       "name": "docx_set_text",
       "providerContract": {

package/office/index.mjs

@@ -316,7 +316,7 @@ const docxTableReadOutput = docxObservationOutput('docx_read_table').extend({
     totalRowCount: z.number().int().nonnegative(),
     returnedRowCount: z.number().int().nonnegative(),
     remaining: z.number().int().nonnegative(),
-    nextOffset: z.number().int().nonnegative().nullable(),
+    nextOffset: z.number().int().nonnegative().optional(),
     detailPageRetained: z.boolean(),
     narrowingRequired: z.boolean(),
   }).strict(),
@@ -401,7 +401,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read an explicit row range from exactly one table selected by native OpenXML address; it never builds another whole-table data object. Set returnContent true to return a byte-bounded compact row page. Provide output to store full paragraph and text-node detail for the selected row page and return its artifact receipt. These channels are independent and may be used together; at least one is required. Request only rows needed for the current decision; receipt.remaining is navigation information, not an obligation to read unused rows, and blank template rows need not be paged through. Each returned row and cell keeps its reusable native address, zero-based logical gridColumnStart, gridSpan, vertical-merge owner, physical text, and logical text. Match columns across rows by gridColumnStart; a tc[n] path or array position is only that row\'s physical cell ordinal and is not a column identity when gridSpan or gridBefore is present. In a vertical merge, restart begins one logical cell and a continue cell is not an independent row value: logicalText resolves the restart cell value while text remains the physical cell value. Use docx_read_object when one exact object needs a narrower descendant view. The provider reports physical structure only; the Agent decides template and business meaning.',
+    description: 'Read an explicit row range from exactly one table selected by native OpenXML address; it never builds another whole-table data object. Set returnContent true to return a byte-bounded compact row page. Provide output to store full paragraph and text-node detail for the selected row page and return its artifact receipt. These channels are independent and may be used together; at least one is required. Request only rows needed for the current decision; receipt.remaining is navigation information, not an obligation to read unused rows, and blank template rows need not be paged through. receipt.nextOffset is present only when another row page exists. Each returned row and cell keeps its reusable native address, zero-based logical gridColumnStart, gridSpan, vertical-merge owner, physical text, and logical text. Match columns across rows by gridColumnStart; a tc[n] path or array position is only that row\'s physical cell ordinal and is not a column identity when gridSpan or gridBefore is present. In a vertical merge, restart begins one logical cell and a continue cell is not an independent row value: logicalText resolves the restart cell value while text remains the physical cell value. Use docx_read_object when one exact object needs a narrower descendant view. The provider reports physical structure only; the Agent decides template and business meaning.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -421,6 +421,13 @@ const tools = [
     outputSchema: fixedEditOutput('docx_set_text'),
     handler: args => fixedEdit('docx_set_text', args),
   },
+  {
+    name: 'docx_set_table_body',
+    description: 'Atomically replace one exact current target-table row range with final text rows while retaining the table, target styles, grid widths, and all rows and surrounding content outside the range. Name every target grid column in native order, choose one current row as the style prototype for each final row, and express horizontal spans with contiguous column IDs and vertical spans with rowSpan. An empty final row array removes the range when another table row remains. The provider commits once and returns structural readback. It does not read a source table, map source to target, derive text, choose business columns, identify headers, or accept non-text cell content.',
+    inputSchema: inputContract('docx_set_table_body'),
+    outputSchema: fixedEditOutput('docx_set_table_body'),
+    handler: args => fixedEdit('docx_set_table_body', 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 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.',
@@ -850,7 +857,7 @@ async function docxObservation(tool, args) {
         totalRowCount,
         returnedRowCount: selectedRows.length,
         remaining: totalRowCount - offset - selectedRows.length,
-        nextOffset: selectedNextOffset,
+        ...(selectedNextOffset === null ? {} : { nextOffset: selectedNextOffset }),
       };
       const detailPage = {
         schema: 'tiwater.docx-table-detail-page/v1',
@@ -918,7 +925,7 @@ async function docxObservation(tool, args) {
         totalRowCount,
         returnedRowCount: rows.length,
         remaining: totalRowCount - offset - rows.length,
-        nextOffset,
+        ...(nextOffset === null ? {} : { nextOffset }),
       };
       return {
         ...withArtifact,

package/package.json

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