@tiwater/office-mcp 0.21.46 → 0.21.48

package/office/contracts/docx_set_table.schema.json

@@ -93,9 +93,15 @@
         }, "required": ["prototypeRow", "cells"], "additionalProperties": false
       }
     },
+    "tableInput": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path to a JSON file containing exactly table, existingRows, columns, and rows. Use this for a large table replacement so its structure and content stay out of the tool call.",
+      "x-tiwater-file-role": "read"
+    },
     "output": { "type": "string", "minLength": 1, "description": "Output DOCX path; may equal input for one 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", "table", "existingRows", "columns", "rows", "output", "receiptOutput"],
+  "required": ["input", "output", "receiptOutput"],
   "additionalProperties": false
 }

package/office/contracts/docx_set_table_width.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_set_table_width",
+  "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": {
+          "table": {
+            "type": "object",
+            "properties": {
+              "part": { "type": "string", "minLength": 1, "pattern": "^\\/" },
+              "path": { "type": "string", "pattern": "^\\/[A-Za-z_][A-Za-z0-9_.-]*:[A-Za-z_][A-Za-z0-9_.-]*\\[[1-9][0-9]*\\](?:\\/[A-Za-z_][A-Za-z0-9_.-]*:[A-Za-z_][A-Za-z0-9_.-]*\\[[1-9][0-9]*\\])*$" }
+            },
+            "required": ["part", "path"],
+            "additionalProperties": false
+          },
+          "width": {
+            "oneOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "type": { "type": "string", "enum": ["dxa", "pct"] },
+                  "value": { "type": "string", "pattern": "^[1-9][0-9]*$" }
+                },
+                "required": ["type", "value"],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "type": { "type": "string", "enum": ["auto", "nil"] },
+                  "value": { "type": "string", "const": "0" }
+                },
+                "required": ["type", "value"],
+                "additionalProperties": false
+              }
+            ]
+          }
+        },
+        "required": ["table", "width"],
+        "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/docx_set_text.schema.json

@@ -34,6 +34,11 @@
           },
           "text": {
             "type": "string"
+          },
+          "fontName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional Latin and complex-script font family for the replacement run. East Asian font settings remain inherited from the target."
           }
         },
         "required": [

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.46"
+    "version": "0.21.48"
   },
   "tools": [
     {
@@ -207,22 +207,33 @@
       "name": "docx_set_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_table.schema.json",
-        "sha256": "d9a9f09ee3ca13764120bcf58e501a3edc508333b01aa4e6d299db8ba7bf2834"
+        "sha256": "d04c40174ce3427689c970b26dd3a282f9d9f6889e4c5ac737eca5926ef709b9"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_table.schema.json",
-        "sha256": "d9a9f09ee3ca13764120bcf58e501a3edc508333b01aa4e6d299db8ba7bf2834"
+        "sha256": "d04c40174ce3427689c970b26dd3a282f9d9f6889e4c5ac737eca5926ef709b9"
+      }
+    },
+    {
+      "name": "docx_set_table_width",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_set_table_width.schema.json",
+        "sha256": "7a51a25a139ffa57c76eeed43dc2a8b9252fafdc0d299ede995f68d44021a3a6"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_set_table_width.schema.json",
+        "sha256": "7a51a25a139ffa57c76eeed43dc2a8b9252fafdc0d299ede995f68d44021a3a6"
       }
     },
     {
       "name": "docx_set_text",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_text.schema.json",
-        "sha256": "4d6f69ef474c0a3ceade95cce362fba7e000946bb890e64119177c5519524db2"
+        "sha256": "45d8aa5d95402ac5b17fe07540355f81afa0804214ef319f33d7da11cf3c56cc"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_text.schema.json",
-        "sha256": "4d6f69ef474c0a3ceade95cce362fba7e000946bb890e64119177c5519524db2"
+        "sha256": "45d8aa5d95402ac5b17fe07540355f81afa0804214ef319f33d7da11cf3c56cc"
       }
     },
     {

package/office/file-backed-table.mjs

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const tableFields = ['table', 'existingRows', 'columns', 'rows'];
+
+function hasInlineTable(args) {
+  return tableFields.every((field) => args?.[field] !== undefined);
+}
+
+export async function resolveFileBackedTable(args) {
+  const hasInline = hasInlineTable(args);
+  const hasFile = typeof args?.tableInput === 'string' && args.tableInput.trim().length > 0;
+  if (!hasInline && !hasFile) throw new Error('provide-inline-table-or-tableInput');
+  if (hasInline && hasFile) throw new Error('provide-only-one-table-input');
+  if (hasInline) return args;
+
+  let tableRequest;
+  try {
+    tableRequest = JSON.parse(await readFile(path.resolve(args.tableInput), 'utf8'));
+  } catch (error) {
+    throw new Error(`tableInput-invalid: ${error.message}`);
+  }
+  if (!tableRequest || typeof tableRequest !== 'object' || Array.isArray(tableRequest)
+      || !tableFields.every((field) => tableRequest[field] !== undefined)
+      || Object.keys(tableRequest).some((field) => !tableFields.includes(field))) {
+    throw new Error('tableInput-must-contain-table-existingRows-columns-and-rows');
+  }
+  const resolved = { ...args, ...tableRequest };
+  delete resolved.tableInput;
+  return resolved;
+}

package/office/index.mjs

@@ -31,6 +31,7 @@ import {
 } from '../_shared/effect-kind.mjs';
 import { compactDocxObjectIdentity } from './docx-object-identity.mjs';
 import { resolveFileBackedChanges } from './file-backed-changes.mjs';
+import { resolveFileBackedTable } from './file-backed-table.mjs';
 
 const packageMetadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
 const inputContractManifest = JSON.parse(await readFile(
@@ -496,6 +497,10 @@ const docxTableReadOutput = docxObservationOutput('docx_read_table').extend({
   address: docxAddress,
   rowCount: z.number().int().nonnegative(),
   columnCount: z.number().int().nonnegative(),
+  tableWidth: z.object({
+    type: z.enum(['auto', 'dxa', 'nil', 'pct']),
+    value: z.string(),
+  }).strict().nullable(),
   gridColumns: z.array(z.object({
     address: docxAddress,
     widthTwips: z.number().int().positive().nullable(),
@@ -600,7 +605,7 @@ const tools = [
   {
     name: 'docx_set_text',
     effectKind: 'document-mutation',
-    description: 'Replace the whole text content of paragraph or cell objects observed from this exact input DOCX while retaining target formatting, bookmarks, spans, and vertical merges. For a vertically merged logical cell, write its visible text to the restart cell rather than a continue cell. Tabs and line breaks remain native document text controls; targets containing non-text objects are rejected. Use this only for newly derived text. Content copied or selected from a source DOCX uses docx_replace_content_from_source so native runs such as superscript and subscript are retained. This does not insert objects, change table structure, copy source formatting, or decide business wording.',
+    description: 'Replace the whole text content of paragraph or cell objects observed from this exact input DOCX while retaining target formatting, bookmarks, spans, and vertical merges. A change may explicitly set the Latin and complex-script font family of its nonempty replacement run; East Asian font settings remain inherited from the target. For a vertically merged logical cell, write its visible text to the restart cell rather than a continue cell. Tabs and line breaks remain native document text controls; targets containing non-text objects are rejected. Use this only for newly derived text. Content copied or selected from a source DOCX uses docx_replace_content_from_source so native runs such as superscript and subscript are retained. This does not insert objects, change table structure, copy source formatting, or decide business wording.',
     inputSchema: inputContract('docx_set_text'),
     outputSchema: fixedEditOutput('docx_set_text'),
     handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
@@ -613,13 +618,21 @@ const tools = [
     outputSchema: fixedEditOutput('docx_set_paragraph_pagination'),
     handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
+  {
+    name: 'docx_set_table_width',
+    effectKind: 'document-mutation',
+    description: 'Set the explicit native width of one or more selected current DOCX tables. Width type is pct, dxa, auto, or nil; pct/dxa take an exact positive Open XML value and auto/nil take 0. This does not change grid-column widths, autofit behavior, cell widths, table structure, content, or business meaning.',
+    inputSchema: inputContract('docx_set_table_width'),
+    outputSchema: fixedEditOutput('docx_set_table_width'),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+  },
   {
     name: 'docx_set_table',
     effectKind: 'document-mutation',
     description: 'Atomically replace one exact current target-table row range with a fully specified table body. Name every target grid column in native order. Every rows[] item must contain its own prototypeRow; there is no table-level prototypeRow. Every cell must contain text: use a string for derived plain text, or null together with sourceInput and exact native sourceSelections. Each explicit cell occupies contiguous columns and may span logical rows; covered columns are omitted from following rows. Native source selections retain run formatting such as superscript and subscript. The provider retains the target table, target cell styles, grid widths, and all content outside the replaced range, and exposes no intermediate document. It does not select source rows, map business columns, infer target shape, derive wording, or copy a source table wholesale.',
     inputSchema: inputContract('docx_set_table'),
     outputSchema: fixedEditOutput('docx_set_table'),
-    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
+    handler: async (args, tool) => fixedEdit(tool, await resolveFileBackedTable(args), docxCandidates),
   },
   {
     name: 'docx_insert_objects',
@@ -1102,6 +1115,7 @@ async function docxObservation(tool, args) {
         address: payload.address,
         rowCount: payload.rowCount,
         columnCount: payload.columnCount,
+        tableWidth: payload.tableWidth,
         gridColumns: payload.gridColumns,
         precedingParagraph: payload.precedingParagraph,
         followingParagraph: payload.followingParagraph,
@@ -1119,6 +1133,7 @@ async function docxObservation(tool, args) {
           address: payload.address,
           rowCount: payload.rowCount,
           columnCount: payload.columnCount,
+          tableWidth: payload.tableWidth,
           gridColumns: payload.gridColumns,
           precedingParagraph: payload.precedingParagraph,
           followingParagraph: payload.followingParagraph,
@@ -1174,6 +1189,7 @@ async function docxObservation(tool, args) {
         address: payload.address,
         rowCount: payload.rowCount,
         columnCount: payload.columnCount,
+        tableWidth: payload.tableWidth,
         gridColumns: payload.gridColumns,
         precedingParagraph: payload.precedingParagraph,
         followingParagraph: payload.followingParagraph,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.46",
+  "version": "0.21.48",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",
@@ -27,6 +27,7 @@
     "office/index.mjs",
     "office/docx-object-identity.mjs",
     "office/file-backed-changes.mjs",
+    "office/file-backed-table.mjs",
     "office/README.md",
     "office/contracts/tiwater-office-provider-contract-manifest-v1.json",
     "office/contracts/*.schema.json",

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.46"
+    "version": "0.21.48"
   },
   "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.46"
+    "version": "0.21.48"
   },
   "tools": [
     {