@tiwater/office-mcp 0.21.52 → 0.21.54

package/office/contracts/docx_collapse_trailing_empty_section.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_collapse_trailing_empty_section",
+  "type": "object",
+  "properties": {
+    "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current" },
+    "output": { "type": "string", "minLength": 1, "description": "Output DOCX path; may equal input for an 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", "output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/contracts/docx_set_section_margins.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_set_section_margins",
+  "type": "object",
+  "properties": {
+    "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current" },
+    "changes": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": {
+      "sectionIndex": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+      "unit": { "type": "string", "const": "twip", "description": "Unit for every supplied margin value." },
+      "margins": { "type": "object", "description": "At least one margin must be supplied; omitted margins remain unchanged.", "properties": {
+        "top": { "type": "integer", "minimum": 0, "maximum": 31680 },
+        "bottom": { "type": "integer", "minimum": 0, "maximum": 31680 },
+        "left": { "type": "integer", "minimum": 0, "maximum": 31680 },
+        "right": { "type": "integer", "minimum": 0, "maximum": 31680 },
+        "header": { "type": "integer", "minimum": 0, "maximum": 31680 },
+        "footer": { "type": "integer", "minimum": 0, "maximum": 31680 }
+      }, "additionalProperties": false }
+    }, "required": ["sectionIndex", "unit", "margins"], "additionalProperties": false } },
+    "output": { "type": "string", "minLength": 1, "description": "Output DOCX path; may equal input for an 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", "changes", "output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/contracts/docx_set_text.schema.json

@@ -48,6 +48,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,
@@ -63,7 +69,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.52"
+    "version": "0.21.54"
   },
   "tools": [
     {
@@ -27,6 +27,17 @@
         "sha256": "975fd24572ae28fb2181edaae9da856417cdcd657f8d83c5eb46c3ff069d2376"
       }
     },
+    {
+      "name": "docx_collapse_trailing_empty_section",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_collapse_trailing_empty_section.schema.json",
+        "sha256": "aa111bc52626aad17c6a7efd9af1b31a0209c7e40811ba0b80cc96bddf6553ac"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_collapse_trailing_empty_section.schema.json",
+        "sha256": "aa111bc52626aad17c6a7efd9af1b31a0209c7e40811ba0b80cc96bddf6553ac"
+      }
+    },
     {
       "name": "docx_compare",
       "providerContract": {
@@ -214,6 +225,17 @@
         "sha256": "02343da9dd2072257781e7e94a07682639f3de80b4bec0c7d9c0fc5da6a3b2f5"
       }
     },
+    {
+      "name": "docx_set_section_margins",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_set_section_margins.schema.json",
+        "sha256": "7a58c93c36789394fa624d1dbba617346685e2dc3fd74b9bbae76c124a97b1a1"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_set_section_margins.schema.json",
+        "sha256": "7a58c93c36789394fa624d1dbba617346685e2dc3fd74b9bbae76c124a97b1a1"
+      }
+    },
     {
       "name": "docx_set_table",
       "providerContract": {
@@ -240,11 +262,11 @@
       "name": "docx_set_text",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_text.schema.json",
-        "sha256": "45d8aa5d95402ac5b17fe07540355f81afa0804214ef319f33d7da11cf3c56cc"
+        "sha256": "6a69b2ba25551698b8cbc6040fda2c1d2b81afde4a9629a613ca37c9120bebe6"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_text.schema.json",
-        "sha256": "45d8aa5d95402ac5b17fe07540355f81afa0804214ef319f33d7da11cf3c56cc"
+        "sha256": "6a69b2ba25551698b8cbc6040fda2c1d2b81afde4a9629a613ca37c9120bebe6"
       }
     },
     {

package/office/index.mjs

@@ -614,10 +614,10 @@ const tools = [
   {
     name: 'docx_set_text',
     effectKind: 'document-mutation',
-    description: 'Replace the whole text content of paragraph or cell objects observed from this exact input DOCX while retaining target formatting, bookmarks, spans, and vertical merges. A change may explicitly set the Latin and complex-script font family of its nonempty replacement run; East Asian font settings remain inherited from the target. For a vertically merged logical cell, write its visible text to the restart cell rather than a continue cell. Tabs and line breaks remain native document text controls; targets containing non-text objects are rejected. Use this only for newly derived text. Content copied or selected from a source DOCX uses docx_replace_content_from_source so native runs such as superscript and subscript are retained. This does not insert objects, change table structure, copy source formatting, or decide business wording.',
+    description: 'Replace the whole text content of paragraph or cell objects observed from this exact input DOCX while retaining target formatting, bookmarks, spans, and vertical merges. Pass small batches in changes or keep a large batch out of the tool call by putting the same changes array in changesInput; both may be combined in one atomic commit. A change may explicitly set the Latin and complex-script font family of its nonempty replacement run; East Asian font settings remain inherited from the target. For a vertically merged logical cell, write its visible text to the restart cell rather than a continue cell. Tabs and line breaks remain native document text controls; targets containing non-text objects are rejected. Use this only for newly derived text. Content copied or selected from a source DOCX uses docx_replace_content_from_source so native runs such as superscript and subscript are retained. This does not insert objects, change table structure, copy source formatting, or decide business wording.',
     inputSchema: inputContract('docx_set_text'),
     outputSchema: fixedEditOutput('docx_set_text'),
-    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+    handler: async (args, tool) => fixedEdit(tool, await resolveFileBackedChanges(args), docxCandidates),
   },
   {
     name: 'docx_set_paragraph_pagination',
@@ -635,6 +635,22 @@ const tools = [
     outputSchema: fixedEditOutput('docx_set_table_width'),
     handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
+  {
+    name: 'docx_set_section_margins',
+    effectKind: 'document-mutation',
+    description: 'Atomically set explicitly supplied page or header/footer margins on selected current DOCX sections. Sections use zero-based native document order, values use twips, and omitted margins remain unchanged. This does not select sections, calculate layout clearance, insert content, or decide business formatting.',
+    inputSchema: inputContract('docx_set_section_margins'),
+    outputSchema: fixedEditOutput('docx_set_section_margins'),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+  },
+  {
+    name: 'docx_collapse_trailing_empty_section',
+    effectKind: 'document-mutation',
+    description: 'Atomically remove exactly one observed trailing empty DOCX section by promoting the preceding section properties and removing only intervening empty paragraphs. The operation fails when that native structure is absent and preserves all visible document content. This does not choose business sections, delete nonempty content, or normalize other section breaks.',
+    inputSchema: inputContract('docx_collapse_trailing_empty_section'),
+    outputSchema: fixedEditOutput('docx_collapse_trailing_empty_section'),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+  },
   {
     name: 'docx_set_table',
     effectKind: 'document-mutation',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.52",
+  "version": "0.21.54",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",

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.52"
+    "version": "0.21.54"
   },
   "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.52"
+    "version": "0.21.54"
   },
   "tools": [
     {