@tiwater/office-mcp 0.21.44 → 0.21.46

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/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.44"
+    "version": "0.21.46"
   },
   "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"
       }
     },
     {

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/index.mjs

@@ -30,6 +30,7 @@ import {
   effectKindMetadata,
 } from '../_shared/effect-kind.mjs';
 import { compactDocxObjectIdentity } from './docx-object-identity.mjs';
+import { resolveFileBackedChanges } from './file-backed-changes.mjs';
 
 const packageMetadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
 const inputContractManifest = JSON.parse(await readFile(
@@ -591,10 +592,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',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.44",
+  "version": "0.21.46",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,7 @@
     "_shared/effect-kind.mjs",
     "office/index.mjs",
     "office/docx-object-identity.mjs",
+    "office/file-backed-changes.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.44"
+    "version": "0.21.46"
   },
   "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.44"
+    "version": "0.21.46"
   },
   "tools": [
     {