@tiwater/office-mcp 0.18.7 → 0.18.9

package/office/contracts/docx_replace_table_rows.schema.json

@@ -38,6 +38,7 @@
           },
           "sourceRows": {
             "type": "object",
+            "description": "Contiguous source data rows. The header row stays outside this range. The first and last row must enclose complete vertical-merge groups as reported by docx_read_table.",
             "properties": {
               "first": {
                 "type": "object",
@@ -102,6 +103,7 @@
           },
           "targetRows": {
             "type": "object",
+            "description": "Contiguous target data rows to replace. The header row stays outside this range. The first and last row must enclose complete vertical-merge groups as reported by docx_read_table.",
             "properties": {
               "first": {
                 "type": "object",
@@ -149,6 +151,7 @@
           "columns": {
             "minItems": 1,
             "type": "array",
+            "description": "Source-to-target header-cell mappings. Source headers share one row, target headers share one row, both header rows stay outside the selected data rows, and each side covers its complete table grid.",
             "items": {
               "type": "object",
               "properties": {

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.18.7"
+    "version": "0.18.9"
   },
   "tools": [
     {
@@ -163,11 +163,11 @@
       "name": "docx_replace_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_table_rows.schema.json",
-        "sha256": "6472793274f22415b8144f693c393ed671dbcfc8045c978c652590619d34b0fc"
+        "sha256": "544d36dc38d9fdf77cfefc0208591fc64321a510171a9b407ab6b46b9c1797e4"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "6472793274f22415b8144f693c393ed671dbcfc8045c978c652590619d34b0fc"
+        "sha256": "544d36dc38d9fdf77cfefc0208591fc64321a510171a9b407ab6b46b9c1797e4"
       }
     },
     {

package/office/index.mjs

@@ -225,6 +225,16 @@ const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
     columnCount: z.number().int().nonnegative(),
     textPreview: z.string(),
     textLength: z.number().int().nonnegative(),
+    precedingParagraph: z.object({
+      address: docxAddress,
+      textPreview: z.string(),
+      textLength: z.number().int().nonnegative(),
+    }).strict().nullable(),
+    followingParagraph: z.object({
+      address: docxAddress,
+      textPreview: z.string(),
+      textLength: z.number().int().nonnegative(),
+    }).strict().nullable(),
   }).strict()),
 }).strict();
 
@@ -233,6 +243,16 @@ const docxTableReadOutput = artifactOutput('docx_read_table').extend({
   address: docxAddress,
   rowCount: z.number().int().nonnegative(),
   columnCount: z.number().int().nonnegative(),
+  precedingParagraph: z.object({
+    address: docxAddress,
+    textPreview: z.string(),
+    textLength: z.number().int().nonnegative(),
+  }).strict().nullable(),
+  followingParagraph: z.object({
+    address: docxAddress,
+    textPreview: z.string(),
+    textLength: z.number().int().nonnegative(),
+  }).strict().nullable(),
   rows: z.array(z.object({
     address: docxAddress,
     gridBefore: z.number().int().nonnegative(),
@@ -276,7 +296,7 @@ const tools = [
   },
   {
     name: 'docx_table_index',
-    description: 'Locate tables in one current DOCX. Returns one compact index containing every table address, shape, and short text preview. Choose the needed address from this index, then call docx_read_table. It does not return full cell content or decide table semantics.',
+    description: 'Locate tables in one current DOCX. Returns one compact index containing every table address, shape, short text preview, and the nearest non-empty paragraph before and after each table. Choose the needed address from this index, then call docx_read_table. It does not return full cell content or decide table semantics.',
     inputSchema: inputContract('docx_table_index'),
     outputSchema: docxTableIndexOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -292,7 +312,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Returns its rows, cells, spans, vertical merges, paragraphs, text nodes, and reusable addresses in document order. It does not locate a table or decide business meaning.',
+    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Returns its nearest non-empty paragraph before and after the table, rows, cells, spans, vertical merges, paragraphs, text nodes, and reusable addresses in document order. It does not locate a table or decide business meaning.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -314,7 +334,7 @@ const tools = [
   },
   {
     name: 'docx_replace_table_rows',
-    description: 'Replace one or more data-row ranges in one current target document. Each tables item binds sourceInput and exact source and target OpenXML addresses. Source cells copy all paragraphs by default. To keep selected content only, each sourceSelections item is a selection object with the observed address in its address field; range is optional for a substring.',
+    description: 'Replace one or more data-row ranges in one current target document. Read both tables first. Each selected row range excludes its header and encloses complete vertical-merge groups; header-cell mappings cover both complete grids. Source cells copy all paragraphs by default. To keep selected content only, each sourceSelections item puts the observed address in its address field; range is optional for a substring.',
     inputSchema: inputContract('docx_replace_table_rows'),
     outputSchema: fixedEditOutput('docx_replace_table_rows'),
     handler: args => fixedEdit('docx_replace_table_rows', args),

package/package.json

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