@tiwater/office-mcp 0.18.3 → 0.18.4

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.4"
   },
   "tools": [
     {
@@ -192,6 +192,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,18 @@ 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 docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   observations: z.array(docxObservationNode).min(1),
 }).strict();
@@ -237,6 +249,14 @@ 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.',
@@ -559,6 +579,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 };
     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.4",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",