@tiwater/office-mcp 0.21.46 → 0.21.47

package/office/contracts/docx_set_table.schema.json

@@ -93,9 +93,15 @@
         }, "required": ["prototypeRow", "cells"], "additionalProperties": false
       }
     },
+    "tableInput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path to a JSON file containing exactly table, existingRows, columns, and rows. Use this for a large table replacement so its structure and content stay out of the tool call.",
+      "x-tiwater-file-role": "read"
+    },
     "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"],
+  "required": ["input", "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.46"
+    "version": "0.21.47"
   },
   "tools": [
     {
@@ -207,11 +207,11 @@
       "name": "docx_set_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_table.schema.json",
-        "sha256": "d9a9f09ee3ca13764120bcf58e501a3edc508333b01aa4e6d299db8ba7bf2834"
+        "sha256": "d04c40174ce3427689c970b26dd3a282f9d9f6889e4c5ac737eca5926ef709b9"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_table.schema.json",
-        "sha256": "d9a9f09ee3ca13764120bcf58e501a3edc508333b01aa4e6d299db8ba7bf2834"
+        "sha256": "d04c40174ce3427689c970b26dd3a282f9d9f6889e4c5ac737eca5926ef709b9"
       }
     },
     {

package/office/file-backed-table.mjs

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const tableFields = ['table', 'existingRows', 'columns', 'rows'];
+
+function hasInlineTable(args) {
+  return tableFields.every((field) => args?.[field] !== undefined);
+}
+
+export async function resolveFileBackedTable(args) {
+  const hasInline = hasInlineTable(args);
+  const hasFile = typeof args?.tableInput === 'string' && args.tableInput.trim().length > 0;
+  if (!hasInline && !hasFile) throw new Error('provide-inline-table-or-tableInput');
+  if (hasInline && hasFile) throw new Error('provide-only-one-table-input');
+  if (hasInline) return args;
+
+  let tableRequest;
+  try {
+    tableRequest = JSON.parse(await readFile(path.resolve(args.tableInput), 'utf8'));
+  } catch (error) {
+    throw new Error(`tableInput-invalid: ${error.message}`);
+  }
+  if (!tableRequest || typeof tableRequest !== 'object' || Array.isArray(tableRequest)
+      || !tableFields.every((field) => tableRequest[field] !== undefined)
+      || Object.keys(tableRequest).some((field) => !tableFields.includes(field))) {
+    throw new Error('tableInput-must-contain-table-existingRows-columns-and-rows');
+  }
+  const resolved = { ...args, ...tableRequest };
+  delete resolved.tableInput;
+  return resolved;
+}

package/office/index.mjs

@@ -31,6 +31,7 @@ import {
 } from '../_shared/effect-kind.mjs';
 import { compactDocxObjectIdentity } from './docx-object-identity.mjs';
 import { resolveFileBackedChanges } from './file-backed-changes.mjs';
+import { resolveFileBackedTable } from './file-backed-table.mjs';
 
 const packageMetadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
 const inputContractManifest = JSON.parse(await readFile(
@@ -619,7 +620,7 @@ const tools = [
     description: 'Atomically replace one exact current target-table row range with a fully specified table body. Name every target grid column in native order. Every rows[] item must contain its own prototypeRow; there is no table-level prototypeRow. Every cell must contain text: use a string for derived plain text, or null together with sourceInput and exact native sourceSelections. Each explicit cell occupies contiguous columns and may span logical rows; covered columns are omitted from following rows. Native source selections retain run formatting such as superscript and subscript. The provider retains the target table, target cell styles, grid widths, and all content outside the replaced range, and exposes no intermediate document. It does not select source rows, map business columns, infer target shape, derive wording, or copy a source table wholesale.',
     inputSchema: inputContract('docx_set_table'),
     outputSchema: fixedEditOutput('docx_set_table'),
-    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+    handler: async (args, tool) => fixedEdit(tool, await resolveFileBackedTable(args), docxCandidates),
   },
   {
     name: 'docx_insert_objects',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.46",
+  "version": "0.21.47",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",
@@ -27,6 +27,7 @@
     "office/index.mjs",
     "office/docx-object-identity.mjs",
     "office/file-backed-changes.mjs",
+    "office/file-backed-table.mjs",
     "office/README.md",
     "office/contracts/tiwater-office-provider-contract-manifest-v1.json",
     "office/contracts/*.schema.json",

package/pdf/contracts/tiwater-pdf-provider-contract-manifest-v1.json

@@ -2,7 +2,7 @@
   "schema": "tiwater.pdf-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.46"
+    "version": "0.21.47"
   },
   "runtime": {
     "command": "tiwater-pdf"

package/text/contracts/tiwater-text-provider-contract-manifest-v1.json

@@ -2,7 +2,7 @@
   "schema": "tiwater.text-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.46"
+    "version": "0.21.47"
   },
   "tools": [
     {