@tiwater/office-mcp 0.15.5 → 0.15.7

package/office/contracts/docx_copy_table_range.schema.json

@@ -19,6 +19,7 @@
           "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
         },
         "rowRefs": {
+          "description": "Unique contiguous source row refs in document order, obtained from list/find with kind=row.",
           "minItems": 1,
           "type": "array",
           "items": {
@@ -47,10 +48,12 @@
           "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
         },
         "tableRef": {
+          "description": "Target table ref from docx_list_objects with kind=table.",
           "type": "string",
           "pattern": "^dox1_[0-9a-f]{64}$"
         },
         "rowPatternRefs": {
+          "description": "Unique contiguous target row refs belonging to tableRef. The complete pattern repeats when the source has more rows.",
           "minItems": 1,
           "type": "array",
           "items": {
@@ -74,11 +77,13 @@
         "type": "object",
         "properties": {
           "sourceGridColumn": {
+            "description": "Zero-based logical source grid column. A horizontally merged cell spans several grid indexes and may be selected only once.",
             "type": "integer",
             "minimum": 0,
             "maximum": 9007199254740991
           },
           "targetGridColumn": {
+            "description": "Zero-based logical target grid column. A horizontally merged cell spans several grid indexes and may be selected only once.",
             "type": "integer",
             "minimum": 0,
             "maximum": 9007199254740991

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

@@ -8,6 +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.",
       "type": "string",
       "enum": [
         "part",
@@ -20,10 +21,17 @@
       ]
     },
     "scope": {
+      "description": "Exact story-part URI such as /word/document.xml. This is not a table nativePath or ancestor filter.",
       "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,
       "type": "integer",
       "minimum": 1,

package/office/contracts/docx_read_object.schema.json

@@ -8,10 +8,12 @@
       "x-tiwater-file-role": "read"
     },
     "ref": {
+      "description": "One object ref returned by docx_list_objects or docx_find_literal. Read a selected table or row to inspect grid spans and merges without listing all cells.",
       "type": "string",
       "pattern": "^dox1_[0-9a-f]{64}$"
     },
     "revision": {
+      "description": "Optional expected revision id from the observation receipt; a changed document fails as stale.",
       "type": "string",
       "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
     }

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.5"
+    "version": "0.15.7"
   },
   "tools": [
     {
@@ -64,11 +64,11 @@
       "name": "docx_copy_table_range",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_table_range.schema.json",
-        "sha256": "203719ca85561647c6cef62eef803f6413290c8f13802cdbcb6cc67bb4892f31"
+        "sha256": "7e5bed1cd36e41058a2d0c26b16c758d8f6a0751d0964689d68c9c2ef0eb1b26"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_range.schema.json",
-        "sha256": "203719ca85561647c6cef62eef803f6413290c8f13802cdbcb6cc67bb4892f31"
+        "sha256": "7e5bed1cd36e41058a2d0c26b16c758d8f6a0751d0964689d68c9c2ef0eb1b26"
       }
     },
     {
@@ -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": "cdbe75c9f10cf72dffad22debb4dd5f96d8bf3f314dee362dd8e313e30f8ee32"
+        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "cdbe75c9f10cf72dffad22debb4dd5f96d8bf3f314dee362dd8e313e30f8ee32"
+        "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
       }
     },
     {
@@ -262,11 +262,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "bc8dd92c05fad110ed5875e6bef189a85e595bb857b7008e2451212ac6231f99"
+        "sha256": "66637468203435e04545045c9be0ac118956d353501b14e12e9ceae03ac4bd9a"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "bc8dd92c05fad110ed5875e6bef189a85e595bb857b7008e2451212ac6231f99"
+        "sha256": "66637468203435e04545045c9be0ac118956d353501b14e12e9ceae03ac4bd9a"
       }
     },
     {

package/office/index.mjs

@@ -206,28 +206,28 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one bounded page of revision-bound native DOCX objects by kind and optional story-part scope.',
+    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),
   },
   {
     name: 'docx_read_object',
-    description: 'Read one revision-bound native DOCX object in full technical Open XML detail.',
+    description: 'Read one selected revision-bound native DOCX object in full technical Open XML detail. Use a table or row ref from list/find to inspect grid spans and merges without enumerating document-wide cells.',
     inputSchema: inputContract('docx_read_object'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_read_object', args),
   },
   {
     name: 'docx_copy_table_range',
-    description: 'Copy selected source DOCX rows into a selected target row pattern with an explicit one-to-one grid-column mapping while preserving target structure and formatting.',
+    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.',
     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.5",
+  "version": "0.15.7",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",