@tiwater/office-mcp 0.15.6 → 0.15.7

package/office/contracts/docx_find_literal.schema.json

@@ -24,9 +24,15 @@
       ]
     },
     "scope": {
+      "description": "Exact story-part URI such as /word/document.xml.",
       "type": "string",
       "minLength": 1
     },
+    "parentRef": {
+      "description": "Optional revision-bound parent object ref. Searches only its nearest published child objects, not every recursive descendant.",
+      "type": "string",
+      "pattern": "^dox1_[0-9a-f]{64}$"
+    },
     "limit": {
       "default": 100,
       "type": "integer",

package/office/contracts/docx_list_objects.schema.json

@@ -25,6 +25,11 @@
       "type": "string",
       "minLength": 1
     },
+    "parentRef": {
+      "description": "Optional revision-bound parent object ref. Returns only its nearest published child objects: a part yields top-level story blocks, a table yields rows, a row yields cells. This is not recursive descendant search.",
+      "type": "string",
+      "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,

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.6"
+    "version": "0.15.7"
   },
   "tools": [
     {
@@ -141,11 +141,11 @@
       "name": "docx_find_literal",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_find_literal.schema.json",
-        "sha256": "df445818f3e166f4ac20fcd6539dff5871d304c50f2cd9986a8026635558d79a"
+        "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
       },
       "inputContract": {
         "path": "office/contracts/docx_find_literal.schema.json",
-        "sha256": "df445818f3e166f4ac20fcd6539dff5871d304c50f2cd9986a8026635558d79a"
+        "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
       }
     },
     {
@@ -229,11 +229,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "0b9701d46ebce82369fb8483bdbebb5867cb02a6e52627413a8428d3ddd49b2b"
+        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "0b9701d46ebce82369fb8483bdbebb5867cb02a6e52627413a8428d3ddd49b2b"
+        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
       }
     },
     {

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. scope is an exact story-part URI, not a table or ancestor filter. For table transfer, list or find rows and read only the selected table or rows; do not enumerate document-wide cells or runs.',
+    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.',
     inputSchema: inputContract('docx_list_objects'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
   {
     name: 'docx_find_literal',
-    description: 'Find literal current text in revision-bound native DOCX objects with bounded paging and optional kind or story-part scope.',
+    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.',
     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.6",
+  "version": "0.15.7",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",