npm - @tiwater/office-mcp - Versions diffs - 0.21.35 → 0.21.37 - Mend

@tiwater/office-mcp 0.21.35 → 0.21.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/office/contracts/docx_read_table.schema.json CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -0,0 +1,100 @@
+{
+  "$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 sourceInput and sourceSelections are used." },
+                "sourceInput": { "type": "string", "minLength": 1, "description": "Current source DOCX containing sourceSelections. Omit when text is used.", "x-tiwater-file-role": "read" },
+                "sourceSelections": {
+                  "type": "array", "minItems": 1,
+                  "description": "Exact ordered native source selections. Omit when text is used.",
+                  "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": ["columns", "text"], "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 CHANGED Viewed

@@ -2,7 +2,7 @@
   "schema": "tiwater.office-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.35"
+    "version": "0.21.37"
   },
   "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": "17c0f3c64fe36bbb3658ee44ce2b505b25241f37d0c08957a8706bd610f8e160"
       },
       "inputContract": {
-        "path": "office/contracts/docx_set_table_body.schema.json",
-        "sha256": "a22d7d38cd3bad30372d45e289e3dc4700a3e52715fec990ac4644888e92ac5e"
+        "path": "office/contracts/docx_set_table.schema.json",
+        "sha256": "17c0f3c64fe36bbb3658ee44ce2b505b25241f37d0c08957a8706bd610f8e160"
       }
     },
     {

package/office/index.mjs CHANGED Viewed

@@ -381,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(),
@@ -469,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 },
@@ -478,7 +479,7 @@ 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, tool) => fixedEdit(tool, args, docxCandidates),
@@ -500,19 +501,11 @@ const tools = [
     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, tool) => fixedEdit(tool, args, docxCandidates),
-  },
-  {
-    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'),
+    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 sourceInput plus exact native sourceSelections, 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),
   },
   {
@@ -862,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);
@@ -956,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',
@@ -996,6 +1019,7 @@ async function docxObservation(tool, args) {
           followingParagraph: payload.followingParagraph,
           receipt: {
             ...selectedPageReceipt,
+            returnedRowCount: 0,
             detailPageRetained: true,
             narrowingRequired: false,
           },
@@ -1017,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];
@@ -1027,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,
@@ -1049,7 +1077,7 @@ async function docxObservation(tool, args) {
         receipt: {
           ...pageReceipt,
           detailPageRetained: delivery.output !== null,
-          narrowingRequired,
+          narrowingRequired: delivery.output === null && narrowingRequired,
         },
         rows,
       };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.35",
+  "version": "0.21.37",
   "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 CHANGED Viewed

@@ -2,7 +2,7 @@
   "schema": "tiwater.pdf-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.35"
+    "version": "0.21.37"
   },
   "runtime": {
     "command": "tiwater-pdf"

package/text/contracts/tiwater-text-provider-contract-manifest-v1.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "schema": "tiwater.text-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.35"
+    "version": "0.21.37"
   },
   "tools": [
     {

package/office/contracts/docx_fill_table_from_tables.schema.json DELETED Viewed

@@ -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 DELETED Viewed

@@ -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
-}