@tiwater/office-mcp 0.21.54 → 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/docx_read_all_tables.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_read_all_tables/v1",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Current DOCX to read once.",
+      "x-tiwater-file-role": "read"
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON file that receives every native table in document order, including rows, cells, merges, paragraphs, and text nodes.",
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["input", "output"],
+  "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.54"
+    "version": "0.21.56"
   },
   "tools": [
     {
@@ -159,6 +159,17 @@
         "sha256": "4ba37e5570ea7958c374111ae7c0f6460eec29937e5c822eba44eb1b8e908d17"
       }
     },
+    {
+      "name": "docx_read_all_tables",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_read_all_tables.schema.json",
+        "sha256": "a5a22e6368977d620af1c53cc934d8934550734069d7ef7f65fc434e4136ae62"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_read_all_tables.schema.json",
+        "sha256": "a5a22e6368977d620af1c53cc934d8934550734069d7ef7f65fc434e4136ae62"
+      }
+    },
     {
       "name": "docx_read_object",
       "providerContract": {
@@ -445,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

@@ -534,6 +534,15 @@ const docxTableReadOutput = docxObservationOutput('docx_read_table').extend({
   }).strict()).optional(),
 }).strict();
 
+const docxReadAllTablesOutput = z.object({
+  tool: z.literal('docx_read_all_tables'),
+  runtime: runtimeIdentity,
+  source: artifact,
+  artifact,
+  schema: z.literal('tiwater.docx-table-read-set/v1'),
+  tableCount: z.number().int().nonnegative(),
+}).strict();
+
 const docxReadObjectOutput = docxObservationOutput('docx_read_object').extend({
   receipt: z.object({
     schema: z.literal('tiwater.docx-read-object-receipt/v1'),
@@ -595,6 +604,14 @@ const tools = [
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_read_table', args),
   },
+  {
+    name: 'docx_read_all_tables',
+    description: 'Read every native table from one current DOCX in document order. The document is opened once and the complete rows, cells, merge ownership, paragraphs, and text nodes are written to output. Only a compact receipt is returned. This tool does not select business tables or infer their meaning.',
+    inputSchema: inputContract('docx_read_all_tables'),
+    outputSchema: docxReadAllTablesOutput,
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    handler: docxReadAllTables,
+  },
   {
     name: 'docx_replace_content_from_source',
     effectKind: 'document-mutation',
@@ -830,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.',
@@ -1230,6 +1255,22 @@ async function docxObservation(tool, args) {
   });
 }
 
+async function docxReadAllTables(args) {
+  const input = path.resolve(requireString(args.input, 'input'));
+  const output = path.resolve(requireString(args.output, 'output'));
+  return withTempJsonFile({ input }, async requestPath => {
+    const result = await runJsonCandidateChain(docxCandidates, ['docx_read_all_tables', requestPath]);
+    return {
+      tool: 'docx_read_all_tables',
+      runtime: commandRuntime(result),
+      source: await fileArtifact(input),
+      artifact: await writeIdempotentJsonArtifact(output, result.json),
+      schema: result.json.schema,
+      tableCount: result.json.tables.length,
+    };
+  });
+}
+
 async function docxReadObject(args) {
   const input = path.resolve(requireString(args.input, 'input'));
   const delivery = resultChannels(args);

package/package.json

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