@tiwater/office-mcp 0.21.53 → 0.21.55

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_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/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/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.53"
+    "version": "0.21.55"
   },
   "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": {
@@ -148,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": {
@@ -214,6 +236,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": {

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',
@@ -635,6 +652,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',
@@ -1214,6 +1247,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.53",
+  "version": "0.21.55",
   "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.53"
+    "version": "0.21.55"
   },
   "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.53"
+    "version": "0.21.55"
   },
   "tools": [
     {