@tiwater/office-mcp 0.21.61 → 0.21.63

package/office/contracts/docx_apply_toc_style_policy.schema.json

@@ -6,6 +6,12 @@
     "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current" },
     "italic": { "type": "boolean" },
     "indentCharactersPerLevel": { "type": "integer", "minimum": 0, "maximum": 21474836 },
+    "tocStyleLevels": {
+      "type": "object",
+      "properties": {},
+      "description": "Optional exact mapping from current TOC entry paragraph style IDs to displayed one-based levels. When provided, every current TOC entry style must be mapped and unused styles are rejected.",
+      "additionalProperties": { "type": "integer", "minimum": 1, "maximum": 9 }
+    },
     "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",

package/office/contracts/docx_read_all_tables.schema.json

@@ -15,6 +15,11 @@
       "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
+    },
+    "returnContent": {
+      "type": "boolean",
+      "const": false,
+      "description": "Optional compatibility flag for a uniform observation request. Only false is accepted because this tool always writes the complete result to output and never returns table content inline."
     }
   },
   "required": ["input", "output"],

package/office/contracts/docx_validate_toc_style_policy.schema.json

@@ -15,6 +15,12 @@
       "minimum": 0,
       "maximum": 9007199254740991
     },
+    "tocStyleLevels": {
+      "type": "object",
+      "properties": {},
+      "description": "Optional exact mapping from current TOC entry paragraph style IDs to displayed one-based levels. When provided, every current TOC entry style must be mapped and unused styles are rejected.",
+      "additionalProperties": { "type": "integer", "minimum": 1, "maximum": 9 }
+    },
     "returnContent": {
       "type": "boolean",
       "description": "Return the complete result directly when it fits the published response limit."

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.61"
+    "version": "0.21.63"
   },
   "tools": [
     {
@@ -20,11 +20,11 @@
       "name": "docx_apply_toc_style_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_apply_toc_style_policy.schema.json",
-        "sha256": "975fd24572ae28fb2181edaae9da856417cdcd657f8d83c5eb46c3ff069d2376"
+        "sha256": "ffc43335216af8c214eadf0aa87cddd95a9269e3b97370eee58890df04e66d5d"
       },
       "inputContract": {
         "path": "office/contracts/docx_apply_toc_style_policy.schema.json",
-        "sha256": "975fd24572ae28fb2181edaae9da856417cdcd657f8d83c5eb46c3ff069d2376"
+        "sha256": "ffc43335216af8c214eadf0aa87cddd95a9269e3b97370eee58890df04e66d5d"
       }
     },
     {
@@ -174,11 +174,11 @@
       "name": "docx_read_all_tables",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_all_tables.schema.json",
-        "sha256": "a5a22e6368977d620af1c53cc934d8934550734069d7ef7f65fc434e4136ae62"
+        "sha256": "e9b2ff2d66c7574fa20216af908f41c22decf18edd14ed297e53f4c6599f5c60"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_all_tables.schema.json",
-        "sha256": "a5a22e6368977d620af1c53cc934d8934550734069d7ef7f65fc434e4136ae62"
+        "sha256": "e9b2ff2d66c7574fa20216af908f41c22decf18edd14ed297e53f4c6599f5c60"
       }
     },
     {
@@ -361,11 +361,11 @@
       "name": "docx_validate_toc_style_policy",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_validate_toc_style_policy.schema.json",
-        "sha256": "5a98a3073a8e149a591254ef4e93f27d3b8f5dbce3204199d7155365f00088ef"
+        "sha256": "da5a001a699adba31269cfbe0dd055cdbb9bbd53d0d4447f1b881981ec8dcf66"
       },
       "inputContract": {
         "path": "office/contracts/docx_validate_toc_style_policy.schema.json",
-        "sha256": "5a98a3073a8e149a591254ef4e93f27d3b8f5dbce3204199d7155365f00088ef"
+        "sha256": "da5a001a699adba31269cfbe0dd055cdbb9bbd53d0d4447f1b881981ec8dcf66"
       }
     },
     {

package/office/index.mjs

@@ -608,7 +608,7 @@ const tools = [
   },
   {
     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.',
+    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. The optional compatibility argument returnContent may only be false; true is unsupported because table content is never returned inline. This tool does not select business tables or infer their meaning.',
     inputSchema: inputContract('docx_read_all_tables'),
     outputSchema: docxReadAllTablesOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -785,7 +785,7 @@ const tools = [
   },
   {
     name: 'docx_validate_toc_style_policy',
-    description: 'Validate current DOCX table-of-contents paragraph styles against an explicit policy. 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.',
+    description: 'Validate current DOCX table-of-contents paragraph styles against an explicit policy. Optionally provide an exact mapping from current TOC entry paragraph style IDs to displayed levels. 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.',
     inputSchema: inputContract('docx_validate_toc_style_policy'),
     outputSchema: largeResultOutput('docx_validate_toc_style_policy'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -794,7 +794,7 @@ const tools = [
   {
     name: 'docx_apply_toc_style_policy',
     effectKind: 'document-mutation',
-    description: 'Apply explicit italic and per-level indentation values to current built-in table-of-contents paragraph styles. It does not change heading text or refresh fields.',
+    description: 'Apply explicit italic and per-level indentation values to current table-of-contents entries. Optionally provide an exact mapping from current TOC entry paragraph style IDs to displayed levels. It does not change heading text or refresh fields.',
     inputSchema: inputContract('docx_apply_toc_style_policy'),
     outputSchema: fixedEditOutput('docx_apply_toc_style_policy'),
     handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
@@ -1335,10 +1335,15 @@ async function docxValidateFontPolicy(args) {
 
 async function docxValidateTocStylePolicy(args) {
   const input = path.resolve(requireString(args.input, 'input'));
-  const result = await runJsonCandidateChain(docxCandidates, [
-    'validate-toc-style-policy', input, String(args.italic), String(args.indentCharactersPerLevel),
-  ], { allowedExitCodes: [0, 1] });
-  return deliverLargeJsonResult({ tool: 'docx_validate_toc_style_policy', args, runtime: commandRuntime(result), payload: result.json, sourcePaths: [input] });
+  const validate = async tocStyleLevelsPath => {
+    const commandArgs = ['validate-toc-style-policy', input, String(args.italic), String(args.indentCharactersPerLevel)];
+    if (tocStyleLevelsPath) commandArgs.push(tocStyleLevelsPath);
+    const result = await runJsonCandidateChain(docxCandidates, commandArgs, { allowedExitCodes: [0, 1] });
+    return deliverLargeJsonResult({ tool: 'docx_validate_toc_style_policy', args, runtime: commandRuntime(result), payload: result.json, sourcePaths: [input] });
+  };
+  return args.tocStyleLevels === undefined
+    ? validate(undefined)
+    : withTempJsonFile(args.tocStyleLevels, validate);
 }
 
 async function docxStripDirectFormatting(args) {

package/package.json

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