@tiwater/office-mcp 0.21.16 → 0.21.18

package/office/contracts/docx_fill_table_from_table.schema.json

@@ -100,18 +100,23 @@
     "columnMappings": {
       "type": "array",
       "minItems": 1,
-      "description": "Complete source-to-target grid-column mapping. Target columns that belong to one prototype cell remain one cell. When the selected target columns cover multiple prototype cells, those cells receive the source column's logical values in source-row order and unused trailing cells stay blank.",
+      "description": "Complete source-to-target grid-column projection. Multiple adjacent source columns may compose one target cell. One source column may spread its logical values across several prototype cells. Composition and spreading cannot occur in the same mapping. Target columns that belong to one prototype cell remain one cell, and unused trailing spread cells stay blank.",
       "items": {
         "type": "object",
         "properties": {
-          "sourceColumn": {
-            "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
+          "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",
@@ -125,9 +130,13 @@
               "required": ["part", "path"],
               "additionalProperties": false
             }
+          },
+          "joinWith": {
+            "type": "string",
+            "description": "Separator used when sourceColumns compose one target cell. Defaults to a newline. It does not apply when one source column spreads across multiple target cells."
           }
         },
-        "required": ["sourceColumn", "targetColumns"],
+        "required": ["sourceColumns", "targetColumns"],
         "additionalProperties": false
       }
     },

package/office/contracts/{docx_copy_content.schema.json → docx_replace_content_from_source.schema.json}

@@ -5,16 +5,19 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "description": "Current target DOCX containing every target paragraph or table cell.",
       "x-tiwater-file-role": "read"
     },
     "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.",
       "items": {
         "type": "object",
         "properties": {
           "target": {
             "type": "object",
+            "description": "Existing main-document paragraph or table-cell address whose inline content is replaced while its container formatting and table structure remain unchanged.",
             "properties": {
               "part": {
                 "type": "string",
@@ -35,16 +38,19 @@
           "sourceInput": {
             "type": "string",
             "minLength": 1,
+            "description": "Current source DOCX containing this change's sourceSelections.",
             "x-tiwater-file-role": "read"
           },
           "sourceSelections": {
             "minItems": 1,
             "type": "array",
+            "description": "Ordered native source paragraphs, runs, or text nodes. Their selected inline content becomes the target content without Agent transcription.",
             "items": {
               "type": "object",
               "properties": {
                 "address": {
                   "type": "object",
+                  "description": "Native source object address returned by docx_read_object or docx_read_table. Selecting a paragraph copies that paragraph's inline content; selecting a cell copies its direct paragraphs.",
                   "properties": {
                     "part": {
                       "type": "string",
@@ -64,6 +70,7 @@
                 },
                 "range": {
                   "type": "object",
+                  "description": "Optional Unicode-scalar substring of a selected run or text node. Omit it to copy the complete selected object.",
                   "properties": {
                     "start": {
                       "type": "integer",
@@ -101,12 +108,13 @@
     "output": {
       "type": "string",
       "minLength": 1,
-      "description": "Output DOCX path; may equal input for an atomic in-place update.",
+      "description": "Output DOCX path; may equal input for one atomic in-place update after every replacement has passed preflight.",
       "x-tiwater-file-role": "write"
     },
     "receiptOutput": {
       "type": "string",
       "minLength": 1,
+      "description": "New JSON receipt path containing target readback for every completed replacement.",
       "x-tiwater-file-role": "write",
       "x-tiwater-file-effect": false
     }
@@ -118,5 +126,5 @@
     "receiptOutput"
   ],
   "additionalProperties": false,
-  "$id": "tiwater.office-mcp-input/docx_copy_content"
+  "$id": "tiwater.office-mcp-input/docx_replace_content_from_source"
 }

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.16"
+    "version": "0.21.18"
   },
   "tools": [
     {
@@ -38,17 +38,6 @@
         "sha256": "a6d59ee785d8ab3994eb6f539b48411b272565ac136219de58d39a449b3112f3"
       }
     },
-    {
-      "name": "docx_copy_content",
-      "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_copy_content.schema.json",
-        "sha256": "71deed6ea5cdd44ae753350c9069d2c4ffee22719956a4c0d05d25e32f2c6ff9"
-      },
-      "inputContract": {
-        "path": "office/contracts/docx_copy_content.schema.json",
-        "sha256": "71deed6ea5cdd44ae753350c9069d2c4ffee22719956a4c0d05d25e32f2c6ff9"
-      }
-    },
     {
       "name": "docx_delete_object",
       "providerContract": {
@@ -86,11 +75,11 @@
       "name": "docx_fill_table_from_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_fill_table_from_table.schema.json",
-        "sha256": "03a5afe6443899e3daae8825070a341254c0bd23ae4505a8c6119f524fd61a9b"
+        "sha256": "473b4e8ac319c0edcf481fa8c2167ea9b1c340995311ca662e34f493772a0de4"
       },
       "inputContract": {
         "path": "office/contracts/docx_fill_table_from_table.schema.json",
-        "sha256": "03a5afe6443899e3daae8825070a341254c0bd23ae4505a8c6119f524fd61a9b"
+        "sha256": "473b4e8ac319c0edcf481fa8c2167ea9b1c340995311ca662e34f493772a0de4"
       }
     },
     {
@@ -181,6 +170,17 @@
         "sha256": "8f2f8694b6d533d7f48b6e1e0c82be3a9c5aac55c50dba00daadd0ea0a76a8a7"
       }
     },
+    {
+      "name": "docx_replace_content_from_source",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_replace_content_from_source.schema.json",
+        "sha256": "d6ce53f684ea0991508cab930e101c910ac05e9725cc25d5312806070c20d320"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_replace_content_from_source.schema.json",
+        "sha256": "d6ce53f684ea0991508cab930e101c910ac05e9725cc25d5312806070c20d320"
+      }
+    },
     {
       "name": "docx_replace_style_ids",
       "providerContract": {

package/office/index.mjs

@@ -409,11 +409,11 @@ const tools = [
     handler: args => docxObservation('docx_read_table', args),
   },
   {
-    name: 'docx_copy_content',
-    description: 'Replace content in existing plain-text target paragraphs or cells while retaining target container formatting. A whole-object selection copies only that object\'s inline content; a range copies an exact substring from a run or text address. Source table, row, cell, span, and merge structure are not copied.',
-    inputSchema: inputContract('docx_copy_content'),
-    outputSchema: fixedEditOutput('docx_copy_content'),
-    handler: args => fixedEdit('docx_copy_content', args),
+    name: 'docx_replace_content_from_source',
+    description: 'Replace existing target paragraph or table-cell content from explicitly selected native source paragraphs, runs, text nodes, or exact text ranges while retaining target container formatting and table structure. Use it after docx_fill_table_from_table when the target needs selected source child content instead of the whole source cell; supply returned target-cell addresses and observed source descendant addresses, never retype source-owned text. It does not copy source rows, cells, 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),
   },
   {
     name: 'docx_set_text',
@@ -424,14 +424,14 @@ const tools = [
   },
   {
     name: 'docx_set_table_body',
-    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. Every other grid column remains explicit. Every explicit cell includes text; use an empty string for a blank cell. 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 a source table, map source to target, derive text, choose business columns, identify headers, or accept non-text cell content.',
+    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. 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 a source table, map source to target, derive text, choose business columns, identify headers, or accept non-text cell content; use docx_fill_table_from_table 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_table',
-    description: 'Fill one current target-table body from one current source-table row range. Select the source grid column whose native vertical merges define logical records, then map source grid columns onto the target prototype cells. Target columns belonging to one prototype cell retain that horizontal span; multiple prototype cells receive source values in row order. The provider derives output rows and vertical merges, validates the complete target grid, commits once, and returns structural readback. It does not choose source or target business meaning, filter records, translate or rewrite text, or apply business-specific rules.',
+    description: 'Fill one current target-table body from one current source-table row range. Select the source grid column whose native vertical merges define logical records, then map source grid columns onto the target prototype cells. Target columns belonging to one prototype cell retain that horizontal span; multiple prototype cells receive source values in row order. The provider derives output rows and vertical merges, validates the complete target grid, commits once, and returns structural readback. It does not choose source or target business meaning, filter records, translate or rewrite text, or apply business-specific rules. When only selected source paragraphs belong in the target, use its returned target-cell addresses with docx_replace_content_from_source before readback.',
     inputSchema: inputContract('docx_fill_table_from_table'),
     outputSchema: fixedEditOutput('docx_fill_table_from_table'),
     handler: args => fixedEdit('docx_fill_table_from_table', args),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.16",
+  "version": "0.21.18",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",