@tiwater/office-mcp 0.18.3 → 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/docx_table_index.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_table_index/v1",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Current DOCX path.",
+      "x-tiwater-file-role": "read"
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON artifact path for the complete table index.",
+      "x-tiwater-file-role": "write"
+    }
+  },
+  "required": ["input", "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.3"
+    "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": {
@@ -192,6 +203,17 @@
         "sha256": "4931d4432c574154eb7a344ee4dc485d99d8840c07d2e46f647e14490cbeedae"
       }
     },
+    {
+      "name": "docx_table_index",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_table_index.schema.json",
+        "sha256": "7549ce28e3cc51ae17cd86c77c97698b6e90f0125afd34ae8831fde7f87ddf67"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_table_index.schema.json",
+        "sha256": "7549ce28e3cc51ae17cd86c77c97698b6e90f0125afd34ae8831fde7f87ddf67"
+      }
+    },
     {
       "name": "docx_validate",
       "providerContract": {

package/office/index.mjs

@@ -216,6 +216,43 @@ const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
   runtime: runtimeIdentity,
 }).strict();
 
+const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
+  schema: z.literal('tiwater.docx-table-index/v1'),
+  tables: z.array(z.object({
+    address: docxAddress,
+    parentAddress: docxAddress.nullable(),
+    rowCount: z.number().int().nonnegative(),
+    columnCount: z.number().int().nonnegative(),
+    textPreview: z.string(),
+    textLength: z.number().int().nonnegative(),
+  }).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();
@@ -237,14 +274,30 @@ const tools = [
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
+  {
+    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.',
+    inputSchema: inputContract('docx_table_index'),
+    outputSchema: docxTableIndexOutput,
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    handler: args => docxObservation('docx_table_index', args),
+  },
   {
     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.',
@@ -559,6 +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' || 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.3",
+  "version": "0.18.5",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",