@tiwater/office-mcp 0.21.34 → 0.21.36

package/_shared/effect-kind.mjs

@@ -70,6 +70,17 @@ export function assertEffectKindToolContract(tool, expectedKind = undefined) {
   return metadata.kind;
 }
 
+export function documentMutationFileArguments(tool, args) {
+  assertEffectKindToolContract(tool, 'document-mutation');
+  const bindings = boundFileArguments(tool?.inputSchema, args);
+  const current = bindings.filter(binding => binding.revisionRole === 'current');
+  const effectiveOutput = bindings.filter(binding => binding.role === 'write' && binding.effect);
+  if (current.length !== 1 || effectiveOutput.length !== 1) {
+    throw new Error(`document-mutation-file-arguments-invalid:${tool?.name || 'unnamed'}`);
+  }
+  return { current: current[0].value, effectiveOutput: effectiveOutput[0].value };
+}
+
 function fileBindings(schema) {
   const bindings = [];
   function visit(node) {
@@ -91,3 +102,35 @@ function fileBindings(schema) {
   visit(schema);
   return bindings;
 }
+
+function boundFileArguments(schema, value) {
+  const bindings = [];
+  function visit(node, currentValue) {
+    if (!node || typeof node !== 'object' || Array.isArray(node)) return;
+    if (node['x-tiwater-file-role'] === 'read' || node['x-tiwater-file-role'] === 'write') {
+      if (typeof currentValue !== 'string' || currentValue.length === 0) {
+        throw new Error('provider-file-argument-invalid');
+      }
+      bindings.push({
+        role: node['x-tiwater-file-role'],
+        effect: node['x-tiwater-file-role'] === 'write'
+          && node['x-tiwater-file-effect'] !== false,
+        revisionRole: node[documentRevisionRoleKey],
+        value: currentValue,
+      });
+      return;
+    }
+    if (Array.isArray(currentValue)) {
+      for (const entry of currentValue) visit(node.items, entry);
+    } else if (currentValue && typeof currentValue === 'object') {
+      for (const [name, child] of Object.entries(node.properties || {})) {
+        if (Object.hasOwn(currentValue, name)) visit(child, currentValue[name]);
+      }
+    }
+    for (const keyword of ['allOf', 'anyOf', 'oneOf']) {
+      for (const child of node[keyword] || []) visit(child, currentValue);
+    }
+  }
+  visit(schema, value);
+  return bindings;
+}

package/office/contracts/docx_read_table.schema.json

@@ -21,17 +21,10 @@
       "required": ["part", "path"],
       "additionalProperties": false
     },
-    "limit": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 9007199254740991,
-      "description": "Maximum number of table rows requested in this response page. The provider may return fewer to keep the machine response bounded."
-    },
-    "offset": {
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991,
-      "description": "Zero-based row offset. Continue only when an unreturned row is needed for the current operation; unused blank template rows need not be read."
+    "continuation": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Opaque continuation returned by the preceding page. Pass it back unchanged; omit it for the first page."
     },
     "output": {
       "type": "string",

package/office/contracts/docx_replace_content_from_source.schema.json

@@ -6,12 +6,13 @@
       "type": "string",
       "minLength": 1,
       "description": "Current target DOCX containing every target paragraph or table cell.",
-      "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
+      "x-tiwater-file-role": "read",
+      "x-tiwater-document-revision-role": "current"
     },
     "changes": {
       "minItems": 1,
       "type": "array",
-      "description": "Atomic source-to-target content replacements. Every source selection is resolved and validated before the target document is changed.",
+      "description": "Replace one or more existing target paragraphs or cells with explicit native source selections in one atomic commit. This preserves selected native runs but does not change rows, spans, or merges.",
       "items": {
         "type": "object",
         "properties": {
@@ -44,7 +45,7 @@
           "sourceSelections": {
             "minItems": 1,
             "type": "array",
-            "description": "Ordered native source cells, paragraphs, runs, or text nodes. Consecutive run or text selections from one source paragraph form one target paragraph; a range retains the native runs it crosses. A source paragraph boundary remains a target paragraph boundary. Selected content becomes the target content without Agent transcription.",
+            "description": "Ordered native source cells, paragraphs, runs, or text nodes. The target becomes exactly these selections; omitted source content is omitted. When excluding parallel-language text, explicitly include every required language-neutral formula, number, unit, and symbol in source order. Consecutive selections from one source paragraph form one target paragraph; a range retains the native runs it crosses. A source paragraph boundary remains a target paragraph boundary. Selected content becomes the target content without Agent transcription.",
             "items": {
               "type": "object",
               "properties": {

package/office/contracts/docx_set_table.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_set_table",
+  "type": "object",
+  "properties": {
+    "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current" },
+    "table": {
+      "type": "object",
+      "description": "Current target table address returned by docx_read_table or docx_table_index.",
+      "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
+    },
+    "existingRows": {
+      "type": "object",
+      "description": "Exact contiguous current row range to replace. Rows outside this range stay unchanged, and the range must enclose every vertical merge it intersects.",
+      "properties": {
+        "first": {
+          "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
+        },
+        "last": {
+          "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
+        }
+      }, "required": ["first", "last"], "additionalProperties": false
+    },
+    "columns": {
+      "type": "array", "minItems": 1,
+      "description": "Complete target table grid in native order. IDs are request-local names used only by rows below.",
+      "items": {
+        "type": "object", "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 80 },
+          "gridColumn": {
+            "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
+          }
+        }, "required": ["id", "gridColumn"], "additionalProperties": false
+      }
+    },
+    "rows": {
+      "type": "array", "minItems": 0,
+      "description": "Final logical rows. Explicit cells plus active row spans cover the target grid exactly once.",
+      "items": {
+        "type": "object", "properties": {
+          "prototypeRow": {
+            "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
+          },
+          "cells": {
+            "type": "array", "minItems": 1,
+            "items": {
+              "type": "object", "properties": {
+                "columns": { "type": "array", "minItems": 1, "description": "One or more contiguous request-local column IDs occupied by this cell.", "items": { "type": "string", "minLength": 1, "maxLength": 80 } },
+                "rowSpan": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+                "text": { "anyOf": [{ "type": "string" }, { "type": "null" }], "description": "Final derived plain text, or null when sourceContent is used." },
+                "sourceContent": {
+                  "anyOf": [{
+                    "type": "object",
+                    "properties": {
+                      "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read" },
+                      "selections": {
+                        "type": "array", "minItems": 1,
+                        "items": {
+                          "type": "object", "properties": {
+                            "address": {
+                              "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
+                            },
+                            "range": {
+                              "type": "object", "properties": {
+                                "start": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+                                "length": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+                              }, "required": ["start", "length"], "additionalProperties": false
+                            }
+                          }, "required": ["address"], "additionalProperties": false
+                        }
+                      }
+                    }, "required": ["input", "selections"], "additionalProperties": false
+                  }, { "type": "null" }],
+                  "description": "Exact ordered native source selections, or null when text is used."
+                }
+              }, "required": ["columns", "text", "sourceContent"], "additionalProperties": false
+            }
+          },
+          "cantSplit": { "type": "boolean" }
+        }, "required": ["prototypeRow", "cells"], "additionalProperties": false
+      }
+    },
+    "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"],
+  "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.34"
+    "version": "0.21.36"
   },
   "tools": [
     {
@@ -71,17 +71,6 @@
         "sha256": "995eb1a5a8992e2a2186f2d7621b5eea7875eecd78ce153e77964d2942db2211"
       }
     },
-    {
-      "name": "docx_fill_table_from_tables",
-      "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_fill_table_from_tables.schema.json",
-        "sha256": "81d335ffaf20b896ae043e96a5a83f1beb3debbaf7404a99c8b4f06a62989c7d"
-      },
-      "inputContract": {
-        "path": "office/contracts/docx_fill_table_from_tables.schema.json",
-        "sha256": "81d335ffaf20b896ae043e96a5a83f1beb3debbaf7404a99c8b4f06a62989c7d"
-      }
-    },
     {
       "name": "docx_insert_objects",
       "providerContract": {
@@ -152,11 +141,11 @@
       "name": "docx_read_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_table.schema.json",
-        "sha256": "6f69cef86035d3905cb84b2b9c4a6af3ac66179be4122f82543fe7acacef288f"
+        "sha256": "0b7a5669daeaa6f8e171ba01542b4bfd065cd282a32943e7b5b5854551b4afc7"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_table.schema.json",
-        "sha256": "6f69cef86035d3905cb84b2b9c4a6af3ac66179be4122f82543fe7acacef288f"
+        "sha256": "0b7a5669daeaa6f8e171ba01542b4bfd065cd282a32943e7b5b5854551b4afc7"
       }
     },
     {
@@ -174,11 +163,11 @@
       "name": "docx_replace_content_from_source",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_content_from_source.schema.json",
-        "sha256": "beca665f61a19911e8c4cb17dc5bad27051c5561e8b31dd839f8825bee7e6385"
+        "sha256": "04740981ad30190be4625ce3a2640b48abec02a9bc0eccc3e0e7d4fe40dbc6e0"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_content_from_source.schema.json",
-        "sha256": "beca665f61a19911e8c4cb17dc5bad27051c5561e8b31dd839f8825bee7e6385"
+        "sha256": "04740981ad30190be4625ce3a2640b48abec02a9bc0eccc3e0e7d4fe40dbc6e0"
       }
     },
     {
@@ -204,14 +193,14 @@
       }
     },
     {
-      "name": "docx_set_table_body",
+      "name": "docx_set_table",
       "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_set_table_body.schema.json",
-        "sha256": "a22d7d38cd3bad30372d45e289e3dc4700a3e52715fec990ac4644888e92ac5e"
+        "source": "packages/docx-cli/contracts/mcp-input/docx_set_table.schema.json",
+        "sha256": "1b501654b6cd3ee58831393c9100ac37e1e5c21a5a92071a6f612b103aae122e"
       },
       "inputContract": {
-        "path": "office/contracts/docx_set_table_body.schema.json",
-        "sha256": "a22d7d38cd3bad30372d45e289e3dc4700a3e52715fec990ac4644888e92ac5e"
+        "path": "office/contracts/docx_set_table.schema.json",
+        "sha256": "1b501654b6cd3ee58831393c9100ac37e1e5c21a5a92071a6f612b103aae122e"
       }
     },
     {

package/office/index.mjs

@@ -24,7 +24,10 @@ import {
 } from '../_shared/large-json-result.mjs';
 import { withOutputWriteLock } from '../_shared/output-write-lock.mjs';
 import { evidenceRoleMetadata } from '../_shared/evidence-role.mjs';
-import { effectKindMetadata } from '../_shared/effect-kind.mjs';
+import {
+  documentMutationFileArguments,
+  effectKindMetadata,
+} from '../_shared/effect-kind.mjs';
 import { compactDocxObjectIdentity } from './docx-object-identity.mjs';
 
 const packageMetadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
@@ -38,14 +41,20 @@ if (inputContractManifest.provider?.id !== packageMetadata.name
 }
 const inputContracts = new Map(await Promise.all(inputContractManifest.tools.map(async entry => {
   const schema = JSON.parse(await readFile(new URL(`./contracts/${entry.name}.schema.json`, import.meta.url), 'utf8'));
-  return [entry.name, z.fromJSONSchema(schema)];
+  return [entry.name, { schema, validator: z.fromJSONSchema(schema) }];
 })));
 const invocationCwd = process.cwd();
 
 function inputContract(toolName) {
   const contract = inputContracts.get(toolName);
   if (!contract) throw new Error(`Missing provider-owned MCP input contract: ${toolName}`);
-  return contract;
+  return contract.validator;
+}
+
+function inputContractSchema(toolName) {
+  const contract = inputContracts.get(toolName);
+  if (!contract) throw new Error(`Missing provider-owned MCP input contract: ${toolName}`);
+  return contract.schema;
 }
 
 const docxCandidates = [
@@ -151,14 +160,14 @@ const xlsxFixedTools = [
   {"name":"xlsx_set_column_width","description":"Set current worksheet column widths."},
 ];
 
-function fixedToolDefinitions(definitions) {
+function fixedToolDefinitions(definitions, candidates) {
   return definitions.map(definition => ({
     name: definition.name,
     effectKind: 'document-mutation',
     description: definition.description,
     inputSchema: inputContract(definition.name),
     outputSchema: fixedEditOutput(definition.name),
-    handler: args => fixedEdit(definition.name, args),
+    handler: (args, tool) => fixedEdit(tool, args, candidates),
   }));
 }
 
@@ -372,9 +381,10 @@ const docxTableReadOutput = docxObservationOutput('docx_read_table').extend({
   receipt: z.object({
     schema: z.literal('tiwater.docx-table-page-receipt/v1'),
     totalRowCount: z.number().int().nonnegative(),
+    retainedRowCount: z.number().int().nonnegative(),
     returnedRowCount: z.number().int().nonnegative(),
     remaining: z.number().int().nonnegative(),
-    nextOffset: z.number().int().nonnegative().optional(),
+    nextContinuation: z.string().min(1).optional(),
     detailPageRetained: z.boolean(),
     narrowingRequired: z.boolean(),
   }).strict(),
@@ -460,7 +470,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read an explicit row range from exactly one table selected by native OpenXML address; it never builds another whole-table data object. Set returnContent true to return a byte-bounded compact row page. Provide output to store full paragraph and text-node detail, including native verticalTextAlignment, for the selected row page and return its artifact receipt. These channels are independent and may be used together; at least one is required. Request only rows needed for the current decision; receipt.remaining is navigation information, not an obligation to read unused rows, and blank template rows need not be paged through. receipt.nextOffset is present only when another row page exists. Each returned row and cell keeps its reusable native address, zero-based logical gridColumnStart, gridSpan, vertical-merge owner, physical text, and logical text. Match columns across rows by gridColumnStart; a tc[n] path or array position is only that row\'s physical cell ordinal and is not a column identity when gridSpan or gridBefore is present. In a vertical merge, restart begins one logical cell and a continue cell is not an independent row value: logicalText resolves the restart cell value while text remains the physical cell value. Use docx_read_object when one exact object needs a narrower descendant view. The provider reports physical structure only; the Agent decides template and business meaning.',
+    description: 'Read one explicit native DOCX table. Provide output to retain every remaining row with full paragraph and text-node detail. Set returnContent true to also receive the largest compact inline page within the response limit; these channels are independent and at least one is required. retainedRowCount counts artifact rows and returnedRowCount counts inline rows. When remaining is nonzero, continue only by passing receipt.nextContinuation unchanged in the next call; a continuation page depends on the preceding receipt and cannot be predicted or read in parallel. Match columns by gridColumnStart, not tc position. A vertical-merge restart owns one logical value; a continue cell points to verticalMergeOwner and does not repeat that value inline.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -469,10 +479,10 @@ const tools = [
   {
     name: 'docx_replace_content_from_source',
     effectKind: 'document-mutation',
-    description: 'Replace existing target paragraph or table-cell content from explicitly selected native source cells, paragraphs, runs, text nodes, or exact text ranges while retaining target container formatting and table structure. For a source cell already returned by docx_read_table, select a Unicode-scalar range directly against its returned text; the provider retains every crossed native run, including superscript and subscript, without another descendant read. Consecutive run or text selections from one source paragraph form one target paragraph, and source paragraph boundaries remain paragraph boundaries. Use it after docx_fill_table_from_tables when the target needs selected source content instead of the whole source cell; pass returned addresses unchanged and never retype source-owned text. It does not copy source rows, cells, spans, or merges.',
+    description: 'Atomically replace one or more existing target paragraphs or cells with exactly the selected native source content. Select source cells, paragraphs, runs, text nodes, or Unicode-scalar text ranges; omitted content is omitted, while selected runs retain superscript, subscript, formulas, numbers, units, and symbols. This tool does not change table rows, spans, or merges.',
     inputSchema: inputContract('docx_replace_content_from_source'),
     outputSchema: fixedEditOutput('docx_replace_content_from_source'),
-    handler: args => fixedEdit('docx_replace_content_from_source', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_set_text',
@@ -480,7 +490,7 @@ const tools = [
     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.',
     inputSchema: inputContract('docx_set_text'),
     outputSchema: fixedEditOutput('docx_set_text'),
-    handler: args => fixedEdit('docx_set_text', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_set_paragraph_pagination',
@@ -488,23 +498,15 @@ const tools = [
     description: 'Set native pagination properties on explicitly selected current DOCX paragraphs. Each change sets at least one pagination property. keepWithNext keeps a paragraph with the immediately following paragraph or table but does not guarantee that a table header remains with its first body row. keepLinesTogether keeps one paragraph on one page; pageBreakBefore starts it on a new page; preventWidowOrphanLines controls isolated first or last lines. Omitted properties remain unchanged. The caller chooses paragraphs from current native addresses; the provider does not decide document layout or business meaning.',
     inputSchema: inputContract('docx_set_paragraph_pagination'),
     outputSchema: fixedEditOutput('docx_set_paragraph_pagination'),
-    handler: args => fixedEdit('docx_set_paragraph_pagination', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
-    name: 'docx_set_table_body',
+    name: 'docx_set_table',
     effectKind: 'document-mutation',
-    description: 'Atomically replace one exact current target-table row range while retaining the table, target styles, grid widths, and all rows and surrounding content outside the range. When retaining leading rows reported with repeatHeader=true, existingRows starts after all of them and never at a verticalMerge=continue row. Name every target grid column in native order and choose one current row inside existingRows as the style prototype for each final row. Horizontal spans use contiguous column IDs. Set rowSpan on one logical cell to occupy multiple rows and omit those columns from the covered rows; the provider writes native vertical merge cells. Set cantSplit on a final physical row when it must remain whole across page boundaries; omit it to preserve the prototype row property. Every other grid column remains explicit. Every explicit cell includes an already-derived value; source-owned content is not retyped here. An empty final row array removes the range when another table row remains. The provider commits once and returns structural readback. It does not read source tables, map source to target, derive text, choose business columns, identify headers, or accept non-text cell content; use docx_fill_table_from_tables and docx_replace_content_from_source for source-owned table content.',
-    inputSchema: inputContract('docx_set_table_body'),
-    outputSchema: fixedEditOutput('docx_set_table_body'),
-    handler: args => fixedEdit('docx_set_table_body', args),
-  },
-  {
-    name: 'docx_fill_table_from_tables',
-    effectKind: 'document-mutation',
-    description: 'Fill one current target-table body from one or more explicitly ordered current source-table row ranges. For each source, select an unmerged record column when every physical source row must remain an output row; mapped columns still retain their native vertical merges. Select a merged record column only when every mapping into one target cell has one equal scalar value throughout that merge group. Map source grid columns onto every target prototype cell. The provider concatenates source records in declared order, copies each mapped source cell in full, preserves horizontal spans, rebuilds vertical merges only within each source range, validates the complete target grid, commits once, and returns structural readback. It does not discover source tables, choose source or target business meaning, filter records, translate or rewrite text, or apply business-specific rules. A single source uses the same sources array with one item. If a target needs only selected source descendants, such as one language from a bilingual cell, immediately use the returned target-cell addresses with docx_replace_content_from_source before releasing that source or reading back the completed target.',
-    inputSchema: inputContract('docx_fill_table_from_tables'),
-    outputSchema: fixedEditOutput('docx_fill_table_from_tables'),
-    handler: args => fixedEdit('docx_fill_table_from_tables', args),
+    description: 'Atomically replace one exact current target-table row range with a fully specified table body. Name every target grid column in native order. Each explicit cell occupies contiguous columns and may span logical rows; covered columns are omitted from following rows. Set each cell from either derived text or exact native source selections, never both. 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),
   },
   {
     name: 'docx_insert_objects',
@@ -512,7 +514,7 @@ const tools = [
     description: 'Insert selected current DOCX objects under an existing parent. Table rows are objects: expand a target table by copying one contiguous observed row range and use repeat for count; sourceInput may equal input. A row range beginning with vertical-merge continuations may be inserted only inside a target boundary with the same active grid spans, which extends those merges. Individual table cells are not raw insertion targets because that would bypass the table grid.',
     inputSchema: inputContract('docx_insert_objects'),
     outputSchema: fixedEditOutput('docx_insert_objects'),
-    handler: args => fixedEdit('docx_insert_objects', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_delete_object',
@@ -520,7 +522,7 @@ const tools = [
     description: 'Delete selected current DOCX objects directly from the current target document. Selected table rows must close every vertical merge and cannot remove the whole table. Individual table cells are not raw deletion targets; use column or merge operations for table structure.',
     inputSchema: inputContract('docx_delete_object'),
     outputSchema: fixedEditOutput('docx_delete_object'),
-    handler: args => fixedEdit('docx_delete_object', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_merge_cells',
@@ -528,7 +530,7 @@ const tools = [
     description: 'Merge selected current DOCX cells when they form one closed rectangle. A one-column, multi-row rectangle creates a vertical merge whose first cell is the restart owner and whose later cells are continuations. All selected cell content moves into the top-left owner, so the selected content must already be correct for that one logical cell.',
     inputSchema: inputContract('docx_merge_cells'),
     outputSchema: fixedEditOutput('docx_merge_cells'),
-    handler: args => fixedEdit('docx_merge_cells', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_split_cells',
@@ -536,7 +538,7 @@ const tools = [
     description: 'Split selected current DOCX merged cells.',
     inputSchema: inputContract('docx_split_cells'),
     outputSchema: fixedEditOutput('docx_split_cells'),
-    handler: args => fixedEdit('docx_split_cells', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_insert_table_columns',
@@ -544,7 +546,7 @@ const tools = [
     description: 'Insert empty template-shaped grid columns into one current main-document table. Select an observed source grid column for width and per-row cell formatting, and optionally a before grid-column address; cells spanning the insertion boundary expand instead of being split. It does not copy business values or decide column meaning.',
     inputSchema: inputContract('docx_insert_table_columns'),
     outputSchema: fixedEditOutput('docx_insert_table_columns'),
-    handler: args => fixedEdit('docx_insert_table_columns', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_delete_table_columns',
@@ -552,7 +554,7 @@ const tools = [
     description: 'Delete selected observed grid columns from one current main-document table while shrinking spanning cells and preserving the remaining table grid. It cannot remove every column and does not decide whether a business column is unused.',
     inputSchema: inputContract('docx_delete_table_columns'),
     outputSchema: fixedEditOutput('docx_delete_table_columns'),
-    handler: args => fixedEdit('docx_delete_table_columns', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_compare',
@@ -593,7 +595,7 @@ const tools = [
     description: 'Apply one explicit font family and size policy to current main-document body and table text. It does not derive a policy or alter other run semantics.',
     inputSchema: inputContract('docx_apply_font_policy'),
     outputSchema: fixedEditOutput('docx_apply_font_policy'),
-    handler: args => fixedEdit('docx_apply_font_policy', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_validate_toc_style_policy',
@@ -609,7 +611,7 @@ const tools = [
     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.',
     inputSchema: inputContract('docx_apply_toc_style_policy'),
     outputSchema: fixedEditOutput('docx_apply_toc_style_policy'),
-    handler: args => fixedEdit('docx_apply_toc_style_policy', args),
+    handler: (args, tool) => fixedEdit(tool, args, docxCandidates),
   },
   {
     name: 'docx_refresh_fields',
@@ -676,7 +678,7 @@ const tools = [
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: xlsxReadRange,
   },
-  ...fixedToolDefinitions(xlsxFixedTools),
+  ...fixedToolDefinitions(xlsxFixedTools, xlsxCandidates),
   {
     name: 'xlsx_validate',
     description: 'Validate an XLSX workbook package and produce OpenXML validation evidence. 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.',
@@ -709,7 +711,7 @@ const tools = [
     description: 'Apply one deterministic PPTX template-application plan to a current presentation. This tool executes the published plan; it does not select a template or derive business content, slide mappings, geometry, or formatting decisions.',
     inputSchema: inputContract('pptx_apply_template'),
     outputSchema: fixedEditOutput('pptx_apply_template'),
-    handler: args => fixedEdit('pptx_apply_template', args),
+    handler: (args, tool) => fixedEdit(tool, args, pptxCandidates),
   },
   {
     name: 'pptx_apply_format',
@@ -717,7 +719,7 @@ const tools = [
     description: 'Apply one deterministic PPTX formatting plan to a current presentation. This tool executes published formatting operations; it does not derive values, coordinates, or business decisions.',
     inputSchema: inputContract('pptx_apply_format'),
     outputSchema: fixedEditOutput('pptx_apply_format'),
-    handler: args => fixedEdit('pptx_apply_format', args),
+    handler: (args, tool) => fixedEdit(tool, args, pptxCandidates),
   },
   {
     name: 'pptx_set_shape_geometry',
@@ -725,7 +727,7 @@ const tools = [
     description: 'Set exact native EMU bounds for uniquely identified current-slide PPTX objects. One call batches only this fixed geometry action and does not infer repair coordinates.',
     inputSchema: inputContract('pptx_set_shape_geometry'),
     outputSchema: fixedEditOutput('pptx_set_shape_geometry'),
-    handler: args => fixedEdit('pptx_set_shape_geometry', args),
+    handler: (args, tool) => fixedEdit(tool, args, pptxCandidates),
   },
   {
     name: 'pptx_replace_picture_image',
@@ -733,7 +735,7 @@ const tools = [
     description: 'Replace embedded PNG or JPEG media for uniquely identified current-slide PPTX pictures while preserving the picture object, geometry, crop, and unrelated media. One call batches only this fixed replacement action.',
     inputSchema: inputContract('pptx_replace_picture_image'),
     outputSchema: fixedEditOutput('pptx_replace_picture_image'),
-    handler: args => fixedEdit('pptx_replace_picture_image', args),
+    handler: (args, tool) => fixedEdit(tool, args, pptxCandidates),
   },
   {
     name: 'pptx_validate',
@@ -769,8 +771,8 @@ function buildServer() {
       },
       async args => {
         const payload = typeof args.output === 'string'
-          ? await withOutputWriteLock(args.output, () => tool.handler(args))
-          : await tool.handler(args);
+          ? await withOutputWriteLock(args.output, () => tool.handler(args, tool))
+          : await tool.handler(args, tool);
         return createToolResult(payload, { isError: payload?.summary?.pass === false });
       },
     );
@@ -853,6 +855,34 @@ async function docxInspect(args) {
   };
 }
 
+function encodeTableContinuation(input, table, offset) {
+  return Buffer.from(JSON.stringify({
+    schema: 'tiwater.docx-table-continuation/v1',
+    input,
+    table,
+    offset,
+  })).toString('base64url');
+}
+
+function decodeTableContinuation(continuation, input, table) {
+  if (continuation === undefined) return 0;
+  let decoded;
+  try {
+    decoded = JSON.parse(Buffer.from(continuation, 'base64url').toString('utf8'));
+  } catch {
+    throw new Error('invalid-docx-table-continuation');
+  }
+  if (decoded?.schema !== 'tiwater.docx-table-continuation/v1'
+      || decoded.input !== input
+      || decoded.table?.part !== table?.part
+      || decoded.table?.path !== table?.path
+      || !Number.isSafeInteger(decoded.offset)
+      || decoded.offset < 0) {
+    throw new Error('invalid-docx-table-continuation');
+  }
+  return decoded.offset;
+}
+
 async function docxObservation(tool, args) {
   const input = path.resolve(requireString(args.input, 'input'));
   const delivery = resultChannels(args);
@@ -947,18 +977,20 @@ async function docxObservation(tool, args) {
     }
     if (tool === 'docx_read_table') {
       const totalRowCount = payload.rows.length;
-      const offset = Math.min(args.offset ?? 0, totalRowCount);
-      const requestedLimit = args.limit ?? totalRowCount;
-      const selectedRows = payload.rows.slice(offset, offset + requestedLimit);
+      const offset = Math.min(decodeTableContinuation(args.continuation, input, args.table), totalRowCount);
+      const selectedRows = payload.rows.slice(offset);
       const selectedNextOffset = offset + selectedRows.length < totalRowCount
         ? offset + selectedRows.length
         : null;
       const selectedPageReceipt = {
         schema: 'tiwater.docx-table-page-receipt/v1',
         totalRowCount,
+        retainedRowCount: selectedRows.length,
         returnedRowCount: selectedRows.length,
         remaining: totalRowCount - offset - selectedRows.length,
-        ...(selectedNextOffset === null ? {} : { nextOffset: selectedNextOffset }),
+        ...(selectedNextOffset === null ? {} : {
+          nextContinuation: encodeTableContinuation(input, args.table, selectedNextOffset),
+        }),
       };
       const detailPage = {
         schema: 'tiwater.docx-table-detail-page/v1',
@@ -987,6 +1019,7 @@ async function docxObservation(tool, args) {
           followingParagraph: payload.followingParagraph,
           receipt: {
             ...selectedPageReceipt,
+            returnedRowCount: 0,
             detailPageRetained: true,
             narrowingRequired: false,
           },
@@ -1008,7 +1041,7 @@ async function docxObservation(tool, args) {
             verticalMerge: cell.verticalMerge,
             verticalMergeOwner: cell.verticalMergeOwner,
             text: cell.paragraphs.map(paragraph => paragraph.text).join('\n'),
-            logicalText: cell.logicalText,
+            logicalText: cell.verticalMerge === 'continue' ? '' : cell.logicalText,
           })),
         };
         const candidate = [...rows, row];
@@ -1018,15 +1051,19 @@ async function docxObservation(tool, args) {
         }
         rows.push(row);
       }
-      const nextOffset = !narrowingRequired && offset + rows.length < totalRowCount
+      const retainedRowCount = delivery.output === null ? rows.length : selectedRows.length;
+      const inlineNextOffset = offset + rows.length < totalRowCount
         ? offset + rows.length
         : null;
       const pageReceipt = {
         schema: 'tiwater.docx-table-page-receipt/v1',
         totalRowCount,
+        retainedRowCount,
         returnedRowCount: rows.length,
         remaining: totalRowCount - offset - rows.length,
-        ...(nextOffset === null ? {} : { nextOffset }),
+        ...(inlineNextOffset === null ? {} : {
+          nextContinuation: encodeTableContinuation(input, args.table, inlineNextOffset),
+        }),
       };
       return {
         ...withArtifact,
@@ -1040,7 +1077,7 @@ async function docxObservation(tool, args) {
         receipt: {
           ...pageReceipt,
           detailPageRetained: delivery.output !== null,
-          narrowingRequired,
+          narrowingRequired: delivery.output === null && narrowingRequired,
         },
         rows,
       };
@@ -1165,28 +1202,37 @@ async function copyTransform(tool, candidates, command, args, suffix = []) {
   }
 }
 
-async function fixedEdit(tool, args) {
-  const input = path.resolve(requireString(args.input, 'input'));
-  const output = path.resolve(requireString(args.output, 'output'));
+async function fixedEdit(tool, args, candidates) {
+  const publishedContract = {
+    name: tool.name,
+    inputSchema: inputContractSchema(tool.name),
+    annotations: tool.annotations,
+    _meta: effectKindMetadata(tool.effectKind),
+  };
+  const bindings = documentMutationFileArguments(publishedContract, args);
+  const input = path.resolve(bindings.current);
+  const output = path.resolve(bindings.effectiveOutput);
   const receiptOutput = path.resolve(requireString(args.receiptOutput, 'receiptOutput'));
-  if (!(tool.startsWith('docx_') && input === output)) await requireNewFile(output, 'output');
+  if (input !== output) await requireNewFile(output, 'output');
   await requireNewFile(receiptOutput, 'receiptOutput');
-  const candidates = tool.startsWith('docx_') ? docxCandidates
-    : tool.startsWith('xlsx_') ? xlsxCandidates
-    : pptxCandidates;
   return withTempJsonFile(args, async requestPath => {
-    const result = await runJsonCandidateChain(candidates, [tool, requestPath], { allowedExitCodes: [0, 1] });
+    const result = await runJsonCandidateChain(candidates, [tool.name, requestPath], { allowedExitCodes: [0, 1] });
     if (result.code !== 0) {
-      const detail = result.stderr.trim() || result.stdout.trim() || `${tool} failed with exit code ${result.code}`;
+      const detail = result.stderr.trim() || result.stdout.trim()
+        || `${tool.name} failed with exit code ${result.code}`;
       throw new Error(detail);
     }
-    if (result.json?.tool !== tool) throw new Error(`${tool} returned a mismatched tool identity`);
+    if (result.json?.tool !== tool.name) throw new Error(`${tool.name} returned a mismatched tool identity`);
     await requireReturnedArtifact(result.json.receipt, receiptOutput, 'receipt');
     if (result.json.output === null) {
-      if (result.json.summary?.pass !== false) throw new Error(`${tool} omitted output without reporting failure`);
+      if (result.json.summary?.pass !== false) {
+        throw new Error(`${tool.name} omitted output without reporting failure`);
+      }
     } else {
       await requireReturnedArtifact(result.json.output, output, 'output');
-      if (result.json.summary?.pass !== true) throw new Error(`${tool} returned output without reporting success`);
+      if (result.json.summary?.pass !== true) {
+        throw new Error(`${tool.name} returned output without reporting success`);
+      }
     }
     return { ...result.json, runtime: commandRuntime(result) };
   });

package/package.json

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

package/office/contracts/docx_fill_table_from_tables.schema.json

@@ -1,162 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "tiwater.office-mcp-input/docx_fill_table_from_tables",
-  "description": "Project source-table rows into one target template table atomically. Use this instead of manually rebuilding rows when target cells derive from source tables. Target formatting is reused, and native vertical-merge owners are preserved within each source range.",
-  "type": "object",
-  "properties": {
-    "input": { "type": "string", "minLength": 1, "description": "Current target DOCX.", "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current" },
-    "table": {
-      "type": "object",
-      "description": "Current target table address returned by docx_read_table or docx_table_index.",
-      "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
-    },
-    "existingRows": {
-      "type": "object",
-      "description": "Exact contiguous current target row range to replace; it must enclose every vertical merge it intersects.",
-      "properties": {
-        "first": {
-          "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
-        },
-        "last": {
-          "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
-        }
-      },
-      "required": ["first", "last"],
-      "additionalProperties": false
-    },
-    "prototypeRow": {
-      "type": "object",
-      "description": "One current row inside existingRows whose cell formatting is reused for every generated body row.",
-      "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
-    },
-    "sources": {
-      "type": "array",
-      "minItems": 1,
-      "description": "Ordered source-table ranges whose logical records are concatenated into the target body. Source boundaries never create a vertical merge with one another.",
-      "items": {
-        "type": "object",
-        "properties": {
-          "input": { "type": "string", "minLength": 1, "description": "Current source DOCX.", "x-tiwater-file-role": "read" },
-          "table": {
-            "type": "object",
-            "description": "Current source table address.",
-            "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
-          },
-          "rows": {
-            "type": "object",
-            "description": "Exact contiguous source data-row range. Intersecting native vertical merges are clipped to this range, retain their owner content, and restart at the first selected row.",
-            "properties": {
-              "first": {
-                "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
-              },
-              "last": {
-                "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
-              }
-            },
-            "required": ["first", "last"],
-            "additionalProperties": false
-          },
-          "recordColumn": {
-            "type": "object",
-            "description": "Source grid-column address that defines output-row records. Choose an unmerged column when every physical source row must remain an output row; vertical merges in other mapped columns are still preserved. Choose a merged column only when every mapping into one target cell has one equal scalar value throughout that merge group.",
-            "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
-          },
-          "columnMappings": {
-            "type": "array",
-            "minItems": 1,
-            "description": "Complete projection from this source grid onto all target prototype cells. Multiple adjacent source columns may compose one target cell; one source column may spread its logical values across several target cells.",
-            "items": {
-              "type": "object",
-              "properties": {
-                "sourceColumns": {
-                  "type": "array",
-                  "minItems": 1,
-                  "description": "One or more contiguous source grid columns in native order. Multiple columns compose one target cell; a source cell spanning several selected columns contributes once.",
-                  "items": {
-                    "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
-                  }
-                },
-                "targetColumns": {
-                  "type": "array",
-                  "minItems": 1,
-                  "description": "One or more contiguous target grid columns covering complete prototype cells.",
-                  "items": {
-                    "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
-                  }
-                },
-                "joinWith": {
-                  "type": "string",
-                  "description": "Separator used when sourceColumns compose one target cell. Defaults to a newline."
-                }
-              },
-              "required": ["sourceColumns", "targetColumns"],
-              "additionalProperties": false
-            }
-          }
-        },
-        "required": ["input", "table", "rows", "recordColumn", "columnMappings"],
-        "additionalProperties": false
-      }
-    },
-    "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", "prototypeRow", "sources", "output", "receiptOutput"],
-  "additionalProperties": false
-}

package/office/contracts/docx_set_table_body.schema.json

@@ -1,136 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "tiwater.office-mcp-input/docx_set_table_body",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
-    },
-    "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,
-      "description": "Current target table address returned by docx_read_table or docx_table_index."
-    },
-    "existingRows": {
-      "type": "object",
-      "description": "Exact contiguous current row range to replace. Rows outside this range stay unchanged, and the range must enclose every vertical merge it intersects.",
-      "properties": {
-        "first": {
-          "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
-        },
-        "last": {
-          "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
-        }
-      },
-      "required": ["first", "last"],
-      "additionalProperties": false
-    },
-    "columns": {
-      "type": "array",
-      "minItems": 1,
-      "description": "Complete target table grid in the native order returned by docx_read_table. IDs are request-local names used only by rows below.",
-      "items": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "string", "minLength": 1, "maxLength": 80 },
-          "gridColumn": {
-            "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
-          }
-        },
-        "required": ["id", "gridColumn"],
-        "additionalProperties": false
-      }
-    },
-    "rows": {
-      "type": "array",
-      "minItems": 0,
-      "description": "Final logical rows; an empty array removes the range when another row remains. Cells plus active row spans cover the complete target grid exactly once.",
-      "items": {
-        "type": "object",
-        "properties": {
-          "prototypeRow": {
-            "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
-          },
-          "cells": {
-            "type": "array",
-            "minItems": 1,
-            "items": {
-              "type": "object",
-              "properties": {
-                "columns": {
-                  "type": "array",
-                  "minItems": 1,
-                  "description": "One or more contiguous request-local column IDs occupied by this cell.",
-                  "items": { "type": "string", "minLength": 1, "maxLength": 80 }
-                },
-                "text": {
-                  "type": "string",
-                  "description": "Final plain text for this cell. If the current cell at the same row and grid span already has exactly this text, its native paragraphs and run formatting are retained while row and merge properties are updated."
-                },
-                "rowSpan": {
-                  "type": "integer",
-                  "minimum": 1,
-                  "maximum": 2147483647,
-                  "description": "Logical row count occupied by this cell; omitted means one. Later rows omit these columns."
-                }
-              },
-              "required": ["columns", "text"],
-              "additionalProperties": false
-            }
-          },
-          "cantSplit": {
-            "type": "boolean",
-            "description": "Whether Word may split this physical row across pages. Omit to preserve the prototype row property."
-          }
-        },
-        "required": ["prototypeRow", "cells"],
-        "additionalProperties": false
-      }
-    },
-    "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"],
-  "additionalProperties": false
-}