@tiwater/office-mcp 0.15.8 → 0.15.10

package/office/contracts/docx_find_literal.schema.json

@@ -34,10 +34,11 @@
       "pattern": "^dox1_[0-9a-f]{64}$"
     },
     "limit": {
-      "default": 100,
+      "description": "Maximum matches in this small page. Refine the literal or parentRef when more matches remain; do not raise the page size to extract the document.",
+      "default": 50,
       "type": "integer",
       "minimum": 1,
-      "maximum": 1000
+      "maximum": 100
     },
     "continuation": {
       "type": "string",

package/office/contracts/docx_list_objects.schema.json

@@ -8,7 +8,7 @@
       "x-tiwater-file-role": "read"
     },
     "kind": {
-      "description": "Object granularity. Use row for table-range discovery; use cell or run only when the task directly targets that object kind.",
+      "description": "Object granularity for structure discovery, not document-text extraction. Use table to locate tables and row with a table parentRef for table-range discovery; use cell or run only when the task directly targets that object kind.",
       "type": "string",
       "enum": [
         "part",
@@ -31,11 +31,11 @@
       "pattern": "^dox1_[0-9a-f]{64}$"
     },
     "limit": {
-      "description": "Maximum objects in this page. Follow continuation for another bounded page; do not raise the limit to replace semantic filtering.",
-      "default": 100,
+      "description": "Maximum identities in this small page. Follow continuation only when the same structural inventory is required; use docx_find_literal instead of paging through paragraphs for content.",
+      "default": 50,
       "type": "integer",
       "minimum": 1,
-      "maximum": 1000
+      "maximum": 100
     },
     "continuation": {
       "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.15.8"
+    "version": "0.15.10"
   },
   "tools": [
     {
@@ -141,11 +141,11 @@
       "name": "docx_find_literal",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_find_literal.schema.json",
-        "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
+        "sha256": "4d5465456d58c0375276e93ee21023c4b14b2caf7c4e1840b60414a7d3c7fd64"
       },
       "inputContract": {
         "path": "office/contracts/docx_find_literal.schema.json",
-        "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
+        "sha256": "4d5465456d58c0375276e93ee21023c4b14b2caf7c4e1840b60414a7d3c7fd64"
       }
     },
     {
@@ -229,11 +229,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
+        "sha256": "329952b59c2b614e956ed8c00208a0fec17a06cb586dddc205aa4581f8d8e0d5"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
+        "sha256": "329952b59c2b614e956ed8c00208a0fec17a06cb586dddc205aa4581f8d8e0d5"
       }
     },
     {

package/office/index.mjs

@@ -126,7 +126,7 @@ const docxFixedTools = [
   {"name":"docx_set_table_cell_rich_text","description":"Set current body table cell rich text."},
   {"name":"docx_insert_table_rows","description":"Insert rows into a current body table."},
   {"name":"docx_delete_table_rows","description":"Delete current body table row ranges."},
-  {"name":"docx_replace_table_rows","description":"Replace current body table row ranges."},
+  {"name":"docx_replace_table_rows","description":"Replace a current body table range with explicit final rows. Use when values must be regrouped, filtered, assigned to different semantic columns, or given explicit gridSpan/vMerge states; matching template-row styles are retained."},
   {"name":"docx_insert_table_columns","description":"Insert columns into a current body table."},
   {"name":"docx_set_table_width","description":"Set current body table widths."},
   {"name":"docx_set_table_cell_alignment","description":"Set current body table cell alignment."},
@@ -206,14 +206,14 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one bounded page of revision-bound native DOCX objects by kind. Use parentRef to return only the nearest published children of a selected object: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
+    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not document-text extraction. For content, use docx_find_literal and then docx_read_object on the selected table or row. Use parentRef for nearest children: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
     inputSchema: inputContract('docx_list_objects'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
   {
     name: 'docx_find_literal',
-    description: 'Find exact current text in revision-bound native DOCX objects with bounded paging. Use parentRef to search only the nearest published children of a selected part, table, row, cell, or paragraph; this is not recursive descendant search.',
+    description: 'Find exact current text in one small page of revision-bound native DOCX objects, then pass a selected table or row ref to docx_read_object. Use parentRef to search only the nearest published children of a selected part, table, row, cell, or paragraph; this is not recursive descendant search.',
     inputSchema: inputContract('docx_find_literal'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_find_literal', args),
@@ -227,7 +227,7 @@ const tools = [
   },
   {
     name: 'docx_copy_table_range',
-    description: 'Copy contiguous source row refs into contiguous target row-pattern refs with an explicit one-to-one logical grid-column mapping. Get row refs from list/find with kind=row; merged cells span grid columns, and one physical cell may be selected only once.',
+    description: 'Copy contiguous source rows verbatim, one source row per output row, into a repeating target row pattern whose mapped vertical-merge topology already matches the source. This does not regroup rows, change semantic columns, remove translations, or rewrite values; use docx_replace_table_rows for those operations. Get row refs from list/find with kind=row; a merged physical cell may be selected only once.',
     inputSchema: inputContract('docx_copy_table_range'),
     outputSchema: fixedEditOutput('docx_copy_table_range'),
     handler: args => fixedEdit('docx_copy_table_range', args),

package/package.json

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