@tiwater/office-mcp 0.21.45 → 0.21.47

package/office/contracts/docx_replace_content_from_source.schema.json

@@ -106,6 +106,12 @@
         "additionalProperties": false
       }
     },
+    "changesInput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path to a JSON file containing the same non-empty changes array accepted by changes. Use this for large batches so the array stays out of the tool call.",
+      "x-tiwater-file-role": "read"
+    },
     "output": {
       "type": "string",
       "minLength": 1,
@@ -122,7 +128,6 @@
   },
   "required": [
     "input",
-    "changes",
     "output",
     "receiptOutput"
   ],

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.45"
+    "version": "0.21.47"
   },
   "tools": [
     {
@@ -174,11 +174,11 @@
       "name": "docx_replace_content_from_source",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_content_from_source.schema.json",
-        "sha256": "9e739afeeda64a6014f180f97667402e98a4b0c8a79a182d6a6ef7a1c5f31cff"
+        "sha256": "91f021a7a848778adaffdbf338524d8a94b5593665be064edc17bd09f94ccafa"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_content_from_source.schema.json",
-        "sha256": "9e739afeeda64a6014f180f97667402e98a4b0c8a79a182d6a6ef7a1c5f31cff"
+        "sha256": "91f021a7a848778adaffdbf338524d8a94b5593665be064edc17bd09f94ccafa"
       }
     },
     {
@@ -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-changes.mjs

@@ -0,0 +1,22 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+export async function resolveFileBackedChanges(args) {
+  const hasInline = Array.isArray(args?.changes);
+  const hasFile = typeof args?.changesInput === 'string' && args.changesInput.trim().length > 0;
+  if (!hasInline && !hasFile) throw new Error('provide-changes-or-changesInput');
+  if (hasInline && !hasFile) return args;
+
+  let changes;
+  try {
+    changes = JSON.parse(await readFile(path.resolve(args.changesInput), 'utf8'));
+  } catch (error) {
+    throw new Error(`changesInput-invalid: ${error.message}`);
+  }
+  if (!Array.isArray(changes) || changes.length === 0) {
+    throw new Error('changesInput-must-contain-non-empty-json-array');
+  }
+  const resolved = { ...args, changes: hasInline ? [...args.changes, ...changes] : changes };
+  delete resolved.changesInput;
+  return resolved;
+}

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

@@ -30,6 +30,8 @@ import {
   effectKindMetadata,
 } 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(
@@ -591,10 +593,10 @@ const tools = [
   {
     name: 'docx_replace_content_from_source',
     effectKind: 'document-mutation',
-    description: 'Atomically replace one or more existing target paragraphs or cells with exactly the selected native source content. Select source cells, paragraphs, runs, text nodes, or Unicode-scalar text ranges; omitted content is omitted, while selected runs retain superscript, subscript, formulas, numbers, units, and symbols. This tool does not change table rows, spans, or merges.',
+    description: 'Atomically replace one or more existing target paragraphs or cells with exactly the selected native source content. Pass small batches in changes or keep a large batch out of the tool call by putting the same changes array in changesInput. Select source cells, paragraphs, runs, text nodes, or Unicode-scalar text ranges; omitted content is omitted, while selected runs retain superscript, subscript, formulas, numbers, units, and symbols. This tool does not change table rows, spans, or merges.',
     inputSchema: inputContract('docx_replace_content_from_source'),
     outputSchema: fixedEditOutput('docx_replace_content_from_source'),
-    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+    handler: async (args, tool) => fixedEdit(tool, await resolveFileBackedChanges(args), docxCandidates),
   },
   {
     name: 'docx_set_text',
@@ -618,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.45",
+  "version": "0.21.47",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,8 @@
     "_shared/effect-kind.mjs",
     "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.45"
+    "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.45"
+    "version": "0.21.47"
   },
   "tools": [
     {