@tiwater/office-mcp 0.21.55 → 0.21.57

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/docx_set_drawing_checkbox_state.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_set_drawing_checkbox_state",
+  "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": {
+          "drawing": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1, "pattern": "^\\/" },
+              "path": { "type": "string", "pattern": "^\\/[A-Za-z_][A-Za-z0-9_.-]*:[A-Za-z_][A-Za-z0-9_.-]*\\[[1-9][0-9]*\\](?:\\/[A-Za-z_][A-Za-z0-9_.-]*:[A-Za-z_][A-Za-z0-9_.-]*\\[[1-9][0-9]*\\])*$" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false,
+            "description": "Exact current native address of one observed image-based checkbox drawing."
+          },
+          "checked": {
+            "type": "boolean",
+            "description": "Requested visible checkbox state."
+          }
+        },
+        "required": ["drawing", "checked"],
+        "additionalProperties": false
+      }
+    },
+    "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", "changes", "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.55"
+    "version": "0.21.57"
   },
   "tools": [
     {
@@ -225,6 +225,17 @@
         "sha256": "5466f70cc69974d4cb2158760491820a43ab2c25ce1c950465a5169c9185ab81"
       }
     },
+    {
+      "name": "docx_set_drawing_checkbox_state",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_set_drawing_checkbox_state.schema.json",
+        "sha256": "acab84fcd23f91c700778eac33334d33b6199ed9da0604897bf3bde2146245e0"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_set_drawing_checkbox_state.schema.json",
+        "sha256": "acab84fcd23f91c700778eac33334d33b6199ed9da0604897bf3bde2146245e0"
+      }
+    },
     {
       "name": "docx_set_paragraph_pagination",
       "providerContract": {
@@ -456,6 +467,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/docx-object-identity.mjs

@@ -7,5 +7,6 @@ export function compactDocxObjectIdentity(object) {
     gridSpan: object.gridSpan ?? null,
     verticalMerge: object.verticalMerge ?? null,
     verticalTextAlignment: object.verticalTextAlignment ?? null,
+    checked: object.checked ?? null,
   };
 }

package/office/index.mjs

@@ -430,6 +430,7 @@ const docxObjectIdentity = z.object({
   gridSpan: z.number().int().positive().nullable(),
   verticalMerge: z.string().nullable(),
   verticalTextAlignment: z.enum(['baseline', 'superscript', 'subscript']).nullable(),
+  checked: z.boolean().nullable(),
 }).strict();
 
 const docxNestedObjectIdentity = docxObjectIdentity.pick({
@@ -442,6 +443,7 @@ const docxNestedObjectIdentity = docxObjectIdentity.pick({
   verticalMergeOwner: docxAddress.optional(),
   logicalText: z.string().optional(),
   verticalTextAlignment: z.enum(['baseline', 'superscript', 'subscript']).optional(),
+  checked: z.boolean().optional(),
 }).strict();
 const docxObservationNode = z.lazy(() => z.object({
   object: docxNestedObjectIdentity,
@@ -590,7 +592,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read explicitly selected rows, cells, or paragraphs from one native DOCX. Set returnContent true to return compact requested descendants; if receipt.narrowingRequired is true, request fewer addresses or descendant kinds. Provide output to store the complete selected observation and return its artifact receipt. These channels are independent and may be used together; at least one is required. A selected cell exposes its vertical-merge owner and logical text, so a continue cell keeps its physical identity while resolving the restart cell value. Run and text descendants expose their native verticalTextAlignment when it is baseline, superscript, or subscript. Use docx_read_table for a table range.',
+    description: 'Read explicitly selected rows, cells, paragraphs, or drawings from one native DOCX. Set returnContent true to return compact requested descendants; if receipt.narrowingRequired is true, request fewer addresses or descendant kinds. Provide output to store the complete selected observation and return its artifact receipt. These channels are independent and may be used together; at least one is required. A selected cell exposes its vertical-merge owner and logical text, so a continue cell keeps its physical identity while resolving the restart cell value. Run and text descendants expose their native verticalTextAlignment when it is baseline, superscript, or subscript. A technically recognized image-based checkbox drawing exposes checked; unsupported drawings omit it. Use docx_read_table for a table range.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -644,6 +646,14 @@ const tools = [
     outputSchema: fixedEditOutput('docx_set_paragraph_pagination'),
     handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
+  {
+    name: 'docx_set_drawing_checkbox_state',
+    effectKind: 'document-mutation',
+    description: 'Set the visible checked or unchecked state of explicitly selected current DOCX image-based checkbox drawings while retaining each drawing container, native address, size, paragraph, label text, and every unselected drawing. The current provider accepts embedded 24-bit DIB-backed WMF checkboxes and rejects other drawings or images instead of guessing. Shared image parts are isolated before mutation so selecting one checkbox cannot change another. The caller chooses checkbox drawings and states; this tool does not select business options or edit text.',
+    inputSchema: inputContract('docx_set_drawing_checkbox_state'),
+    outputSchema: fixedEditOutput('docx_set_drawing_checkbox_state'),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+  },
   {
     name: 'docx_set_table_width',
     effectKind: 'document-mutation',
@@ -847,6 +857,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.',
@@ -1020,6 +1038,7 @@ function compactDocxObservation(observation) {
       ...(node.object.verticalMergeOwner === null ? {} : { verticalMergeOwner: node.object.verticalMergeOwner }),
       ...(node.object.logicalText === null ? {} : { logicalText: node.object.logicalText }),
       ...(identity.verticalTextAlignment === null ? {} : { verticalTextAlignment: identity.verticalTextAlignment }),
+      ...(identity.checked === null ? {} : { checked: identity.checked }),
     };
     return {
       object,

package/package.json

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