@tiwater/office-mcp 0.18.5 → 0.18.7

package/office/contracts/docx_replace_table_rows.schema.json

@@ -198,6 +198,7 @@
           },
           "sourceCellContents": {
             "type": "array",
+            "description": "Optional per-cell content selections. Omit this field to copy every paragraph from each mapped source cell.",
             "items": {
               "type": "object",
               "properties": {
@@ -221,11 +222,13 @@
                 },
                 "sourceSelections": {
                   "type": "array",
+                  "description": "Content selections inside sourceCell. Each item is a selection object; put the observed OpenXML address in its required address field and add range only for a substring.",
                   "items": {
                     "type": "object",
                     "properties": {
                       "address": {
                         "type": "object",
+                        "description": "Observed paragraph, run, or text OpenXML address selected from sourceCell.",
                         "properties": {
                           "part": {
                             "type": "string",

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.5"
+    "version": "0.18.7"
   },
   "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": "02ce941414496ddffa7d531ca6fa982598f607b516d990d598ace521d725cdf6"
+        "sha256": "6472793274f22415b8144f693c393ed671dbcfc8045c978c652590619d34b0fc"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "02ce941414496ddffa7d531ca6fa982598f607b516d990d598ace521d725cdf6"
+        "sha256": "6472793274f22415b8144f693c393ed671dbcfc8045c978c652590619d34b0fc"
       }
     },
     {

package/office/index.mjs

@@ -268,7 +268,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of nearest-child OpenXML addresses from the current DOCX in native document order and retain the exact page at output. Continue with nextOffset and descend through a returned address as parent. Text previews describe already located objects; they do not prove descendant content.',
+    description: 'Page through mixed nearest-child OpenXML objects when document order or paragraph relationships are required. Continue with nextOffset and descend through a returned parent address. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then docx_read_table for one selected table.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -276,7 +276,7 @@ const tools = [
   },
   {
     name: 'docx_table_index',
-    description: 'List every table in one current DOCX as a compact native index with its OpenXML address, row count, column count, and short text preview. Use it to choose a table and confirm its shape before listing rows or reading selected content. 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, 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.',
     inputSchema: inputContract('docx_table_index'),
     outputSchema: docxTableIndexOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -292,7 +292,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read one complete table selected by its native OpenXML address. Returns compact rows, cells, spans, vertical merges, paragraphs, text nodes, and their reusable addresses in document order. It does not search for a table or decide business meaning.',
+    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.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -314,7 +314,7 @@ const tools = [
   },
   {
     name: 'docx_replace_table_rows',
-    description: 'Replace one or more data-row ranges in one current target document. input appears once; each tables item binds sourceInput and exact source and target OpenXML addresses. All source-cell paragraphs copy by default; sourceCellContents selects exact observed content that the target keeps.',
+    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.',
     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.5",
+  "version": "0.18.7",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",