@tiwater/office-mcp 0.21.55 → 0.21.56

package/office/README.md

@@ -20,18 +20,22 @@ OpenXML-internal identifiers, not filesystem arguments.
 - DOCX: inspect document/tables, export, compare, validate OpenXML, apply or validate font and
   table-of-contents style policies, refresh document fields, replace object text, transform styles,
   and batch one fixed edit action.
-- XLS/XLSX: convert legacy XLS with ET, inspect/export, validate, and batch
-  one fixed workbook edit action.
+- XLS/XLSX: convert legacy XLS with ET, inspect/export, validate, batch one
+  fixed workbook edit action, or atomically apply one immutable provider-ready
+  mixed-operation handoff.
 - PPTX: inspect/export, bind selected masters/layouts, apply text formatting,
   set exact top-level object geometry, replace existing picture media, and
   validate OpenXML.
 - Office: render DOC/DOCX/XLS/XLSX/PPT/PPTX to PDF with the corresponding native
   WPS backend.
 
-Each mutation tool fixes its provider operation type. Callers submit only the
+Fixed-action mutation tools fix their provider operation type. Callers submit only the
 coordinates and values for that action, so they cannot provide an arbitrary
 operation discriminator or a multi-action plan language. A call may batch
 multiple changes only when every change has the same action kind.
+The atomic XLSX handoff capability accepts only a file identity for an already
+approved operation artifact. It does not choose, rewrite, partition, or infer
+operations, and it commits workbook bytes only when the complete ordered handoff succeeds.
 When a completed mutation receipt reports `summary.pass=false`, the MCP result
 also sets the standard `isError` field; consumers do not need a private failure
 interpretation.

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.55"
+    "version": "0.21.56"
   },
   "tools": [
     {
@@ -456,6 +456,17 @@
         "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
       }
     },
+    {
+      "name": "xlsx_apply_operations",
+      "providerContract": {
+        "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_apply_operations.schema.json",
+        "sha256": "89b0946543671b5dc75ce40db9656f23b3909bc2a9ef945e7cdf5b73f40845d2"
+      },
+      "inputContract": {
+        "path": "office/contracts/xlsx_apply_operations.schema.json",
+        "sha256": "89b0946543671b5dc75ce40db9656f23b3909bc2a9ef945e7cdf5b73f40845d2"
+      }
+    },
     {
       "name": "xlsx_convert_legacy",
       "providerContract": {

package/office/contracts/xlsx_apply_operations.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
+      "x-tiwater-file-role": "read",
+      "x-tiwater-document-revision-role": "current"
+    },
+    "operationsInput": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\.[jJ][sS][oO][nN]$",
+      "description": "Immutable provider-ready operation handoff containing only a non-empty operations array.",
+      "x-tiwater-file-role": "read"
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
+      "description": "Output document path; may equal input for one atomic mixed-operation update.",
+      "x-tiwater-file-role": "write"
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten.",
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "operationsInput", "output", "receiptOutput"],
+  "additionalProperties": false
+}

package/office/index.mjs

@@ -847,6 +847,14 @@ const tools = [
     handler: xlsxReadRange,
   },
   ...fixedToolDefinitions(xlsxFixedTools, xlsxCandidates),
+  {
+    name: 'xlsx_apply_operations',
+    effectKind: 'document-mutation',
+    description: 'Apply one immutable provider-ready XLSX operation handoff as a single atomic workbook edit. The provider preflights and executes the complete ordered operation list, commits output bytes only when every operation succeeds, and returns one complete receipt.',
+    inputSchema: inputContract('xlsx_apply_operations'),
+    outputSchema: fixedEditOutput('xlsx_apply_operations'),
+    handler: (args, tool) => fixedEdit(tool, args, xlsxCandidates),
+  },
   {
     name: 'xlsx_validate',
     description: 'Validate an XLSX workbook package and produce OpenXML validation evidence. Set returnContent true to return the complete result when it fits the response limit. Provide output to write the complete result to a new JSON file. The two choices are independent and may be used together; at least one is required.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.55",
+  "version": "0.21.56",
   "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.55"
+    "version": "0.21.56"
   },
   "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.55"
+    "version": "0.21.56"
   },
   "tools": [
     {