@tiwater/office-mcp 0.18.4 → 0.18.5

package/office/contracts/docx_read_table.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_read_table/v1",
+  "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
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "x-tiwater-file-role": "write"
+    }
+  },
+  "required": ["input", "table", "output"],
+  "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.4"
+    "version": "0.18.5"
   },
   "tools": [
     {
@@ -126,6 +126,17 @@
         "sha256": "f8d29a89c0a321332d5d964c970b2cb18c7ecd59f87e9892e6779747a00f9825"
       }
     },
+    {
+      "name": "docx_read_table",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_read_table.schema.json",
+        "sha256": "3b85fb6bc390053abdcdbcf4d5a2a4f958a06154286a0327676144324706af83"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_read_table.schema.json",
+        "sha256": "3b85fb6bc390053abdcdbcf4d5a2a4f958a06154286a0327676144324706af83"
+      }
+    },
     {
       "name": "docx_refresh_fields",
       "providerContract": {

package/office/index.mjs

@@ -228,6 +228,31 @@ const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
   }).strict()),
 }).strict();
 
+const docxTableReadOutput = artifactOutput('docx_read_table').extend({
+  schema: z.literal('tiwater.docx-table-read/v1'),
+  address: docxAddress,
+  rowCount: z.number().int().nonnegative(),
+  columnCount: z.number().int().nonnegative(),
+  rows: z.array(z.object({
+    address: docxAddress,
+    gridBefore: z.number().int().nonnegative(),
+    gridAfter: z.number().int().nonnegative(),
+    cells: z.array(z.object({
+      address: docxAddress,
+      gridSpan: z.number().int().positive(),
+      verticalMerge: z.string().nullable(),
+      paragraphs: z.array(z.object({
+        address: docxAddress,
+        text: z.string(),
+        textNodes: z.array(z.object({
+          address: docxAddress,
+          text: z.string(),
+        }).strict()),
+      }).strict()),
+    }).strict()),
+  }).strict()),
+}).strict();
+
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   observations: z.array(docxObservationNode).min(1),
 }).strict();
@@ -259,12 +284,20 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read selected tables, rows, cells, or paragraphs from one native DOCX in one call and return them in address order. Pass the document path once and only the OpenXML addresses needed for the current target. For exact inline content, use an observed cell or paragraph address and request run or text.',
+    description: 'Read selected rows, cells, or paragraphs from one native DOCX in one call and return their requested descendants in address order. Use docx_read_table when the current task needs one complete table. For exact inline content, use an observed cell or paragraph address and request run or text.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: docxReadObject,
   },
+  {
+    name: 'docx_read_table',
+    description: 'Read one complete table selected by its native OpenXML address. Returns compact rows, cells, spans, vertical merges, paragraphs, text nodes, and their reusable addresses in document order. It does not search for a table or decide business meaning.',
+    inputSchema: inputContract('docx_read_table'),
+    outputSchema: docxTableReadOutput,
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    handler: args => docxObservation('docx_read_table', args),
+  },
   {
     name: 'docx_copy_content',
     description: 'Replace content in existing plain-text target paragraphs or cells while retaining target container formatting and source inline meaning. A selection copies a whole object by OpenXML address, or an exact substring when range is attached to a run or text address.',
@@ -579,7 +612,7 @@ async function docxObservation(tool, args) {
     if (tool === 'docx_list_objects') {
       return { ...retained, ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
     }
-    if (tool === 'docx_table_index') return { ...retained, ...payload };
+    if (tool === 'docx_table_index' || tool === 'docx_read_table') return { ...retained, ...payload };
     throw new Error(`unsupported-docx-observation-tool:${tool}`);
   });
 }

package/package.json

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