@tiwater/office-mcp 0.18.4 → 0.18.6

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.6"
   },
   "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();
@@ -243,7 +268,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of nearest-child OpenXML addresses from the current DOCX in native document order and retain the exact page at output. Continue with nextOffset and descend through a returned address as parent. Text previews describe already located objects; they do not prove descendant content.',
+    description: 'Page through mixed nearest-child OpenXML objects when document order or paragraph relationships are required. Continue with nextOffset and descend through a returned parent address. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then docx_read_table for one selected table.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -251,7 +276,7 @@ const tools = [
   },
   {
     name: 'docx_table_index',
-    description: 'List every table in one current DOCX as a compact native index with its OpenXML address, row count, column count, and short text preview. Use it to choose a table and confirm its shape before listing rows or reading selected content. It does not return full cell content or decide table semantics.',
+    description: 'Locate tables in one current DOCX. Returns one compact index containing every table address, shape, and short text preview. Choose the needed address from this index, then call docx_read_table. It does not return full cell content or decide table semantics.',
     inputSchema: inputContract('docx_table_index'),
     outputSchema: docxTableIndexOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -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 exactly one table selected from docx_table_index by native OpenXML address. Returns its rows, cells, spans, vertical merges, paragraphs, text nodes, and reusable addresses in document order. It does not locate 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.6",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",