@tiwater/office-mcp 0.15.8 → 0.15.9

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.9"
   },
   "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

@@ -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),

package/package.json

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