@tiwater/office-mcp 0.14.2 → 0.15.0

package/office/README.md

@@ -3,16 +3,16 @@
 Published generic Office capabilities for DOCX, XLS/XLSX, and PPTX.
 
 The server owns technical observation, native conversion, fixed-action edits,
-package validation, and native WPS rendering. It owns no scenario meaning,
-template-migration workflow, customer mapping, or Lucid lifecycle.
+package validation, and native WPS rendering. Callers own document selections,
+values, business mappings, workflow decisions, and delivery status.
 
 ## Capability families
 
-- DOCX: inspect document/tables, export, compare, validate OpenXML and font
-  policy, fill placeholders, transform styles, and batch one fixed edit action.
-- XLS/XLSX: convert legacy XLS with ET, inspect/export/fill, validate, and batch
+- DOCX: inspect document/tables, export, compare, validate OpenXML, font, and table-of-contents styles
+  policy, 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.
-- PPTX: inspect/export/fill, bind selected masters/layouts, apply text formatting,
+- 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
@@ -48,10 +48,10 @@ coordinates plus section/reference bindings, and only supported direct-story
 tables expose mutation addresses.
 
 The catalog is intentionally open to new generic document capabilities, but a
-scenario, template, customer, issue, work item, or model difference does not
-justify a new tool. Add a tool only for a stable technical responsibility that
-cannot be composed from the existing public capabilities; merge or remove
-overlapping capabilities.
+specific workflow, template, customer, issue, input document, or model
+difference does not justify a new tool. Add a tool only for a stable technical
+responsibility that cannot be composed from the existing public capabilities;
+merge or remove overlapping capabilities.
 
 ## Run
 

package/office/contracts/docx_apply_font_policy.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "fontPolicy": {
+            "type": "object",
+            "properties": {
+              "schema": {
+                "type": "string",
+                "minLength": 1
+              },
+              "body": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "table": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "schema",
+              "body",
+              "table"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "fontPolicy"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_apply_toc_style_policy.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "italic": {
+            "type": "boolean"
+          },
+          "indentCharactersPerLevel": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": [
+          "italic",
+          "indentCharactersPerLevel"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_collapse_trailing_empty_paragraphs.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_collapse_trailing_empty_section.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_compare.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "baseline": {
+      "type": "string",
+      "minLength": 1
+    },
+    "updated": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "baseline",
+    "updated"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_copy_table_range.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "tiwater.docx-copy-table-range/v1"
+    },
+    "source": {
+      "type": "object",
+      "properties": {
+        "input": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision": {
+          "type": "string",
+          "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
+        },
+        "rowRefs": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^dox1_[0-9a-f]{64}$"
+          }
+        }
+      },
+      "required": [
+        "input",
+        "revision",
+        "rowRefs"
+      ],
+      "additionalProperties": false
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "input": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision": {
+          "type": "string",
+          "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
+        },
+        "tableRef": {
+          "type": "string",
+          "pattern": "^dox1_[0-9a-f]{64}$"
+        },
+        "rowPatternRefs": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^dox1_[0-9a-f]{64}$"
+          }
+        }
+      },
+      "required": [
+        "input",
+        "revision",
+        "tableRef",
+        "rowPatternRefs"
+      ],
+      "additionalProperties": false
+    },
+    "columns": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "sourceGridColumn": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "targetGridColumn": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": [
+          "sourceGridColumn",
+          "targetGridColumn"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "schema",
+    "source",
+    "target",
+    "columns",
+    "output",
+    "receiptOutput"
+  ],
+  "additionalProperties": false,
+  "$id": "tiwater.docx-copy-table-range/v1"
+}

package/office/contracts/docx_delete_body_drawing_before_paragraph.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "findText": {
+            "type": "string",
+            "minLength": 1
+          },
+          "matchMode": {
+            "type": "string"
+          },
+          "paragraphStyle": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "findText"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_delete_body_paragraph.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "findText": {
+            "type": "string",
+            "minLength": 1
+          },
+          "matchMode": {
+            "type": "string"
+          },
+          "paragraphStyle": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "findText"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_delete_body_range.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "findText": {
+            "type": "string",
+            "minLength": 1
+          },
+          "endFindText": {
+            "type": "string"
+          },
+          "matchMode": {
+            "type": "string"
+          },
+          "endMatchMode": {
+            "type": "string"
+          },
+          "paragraphStyle": {
+            "type": "string"
+          },
+          "endParagraphStyle": {
+            "type": "string"
+          },
+          "deleteToBodyEnd": {
+            "type": "boolean"
+          },
+          "removePrecedingPageBreak": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "findText"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_delete_comments.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "commentIds": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "required": [
+          "commentIds"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_delete_table_rows.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New document output path. Existing files are never overwritten."
+    },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON receipt path. Existing files are never overwritten."
+    },
+    "changes": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "tableIndex": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "startRowIndex": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "endRowIndex": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": [
+          "tableIndex",
+          "startRowIndex",
+          "endRowIndex"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "input",
+    "output",
+    "receiptOutput",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_export_json.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New JSON artifact path. Existing files are never overwritten."
+    }
+  },
+  "required": [
+    "input",
+    "output"
+  ],
+  "additionalProperties": false
+}

package/office/contracts/docx_find_literal.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "input": {
+      "type": "string",
+      "minLength": 1
+    },
+    "literal": {
+      "type": "string",
+      "minLength": 1
+    },
+    "kind": {
+      "type": "string",
+      "enum": [
+        "part",
+        "paragraph",
+        "table",
+        "row",
+        "cell",
+        "run",
+        "drawing"
+      ]
+    },
+    "scope": {
+      "type": "string",
+      "minLength": 1
+    },
+    "limit": {
+      "default": 100,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1000
+    },
+    "continuation": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "input",
+    "literal"
+  ],
+  "additionalProperties": false,
+  "$id": "tiwater.office-mcp-input/docx_find_literal/v1"
+}