@tiwater/office-mcp 0.21.62 → 0.21.64

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_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.62"
+    "version": "0.21.64"
   },
   "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"
       }
     },
     {
@@ -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

@@ -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.62",
+  "version": "0.21.64",
   "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.62"
+    "version": "0.21.64"
   },
   "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.62"
+    "version": "0.21.64"
   },
   "tools": [
     {