@tiwater/office-mcp 0.16.3 → 0.16.5

package/office/contracts/docx_copy_object.schema.json

@@ -53,11 +53,13 @@
           },
           "targetParentRef": {
             "type": "string",
-            "pattern": "^dox1_[0-9a-f]{64}$"
+            "pattern": "^dox1_[0-9a-f]{64}$",
+            "description": "Revision-bound parent ref returned as parentRef on its direct children."
           },
           "beforeRef": {
             "type": "string",
-            "pattern": "^dox1_[0-9a-f]{64}$"
+            "pattern": "^dox1_[0-9a-f]{64}$",
+            "description": "Optional direct child whose returned parentRef equals targetParentRef."
           },
           "repeat": {
             "type": "integer",

package/office/contracts/docx_list_objects.schema.json

@@ -8,7 +8,7 @@
       "x-tiwater-file-role": "read"
     },
     "kind": {
-      "description": "Open XML object kind to list. Use parentRef to walk only the native structure needed for the direct operation.",
+      "description": "Open XML object kind to list. Returned parentRef is the valid targetParentRef for inserting beside that object.",
       "type": "string",
       "enum": [
         "part",

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.16.3"
+    "version": "0.16.5"
   },
   "tools": [
     {
@@ -31,11 +31,11 @@
       "name": "docx_copy_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_object.schema.json",
-        "sha256": "45d30d97ba58ece704beb352ea41b4105f64cf9f43f11e94b6fb3de52b0b5823"
+        "sha256": "5f0bfc826d68f451055aba20390686e0e0df2182797fc36ff285f42d09084104"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_object.schema.json",
-        "sha256": "45d30d97ba58ece704beb352ea41b4105f64cf9f43f11e94b6fb3de52b0b5823"
+        "sha256": "5f0bfc826d68f451055aba20390686e0e0df2182797fc36ff285f42d09084104"
       }
     },
     {
@@ -97,11 +97,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "7f0c3213addbeab2ff96579bcdd860ad65b8ae95c9e6b1e3fb7e5497f3e5a89d"
+        "sha256": "d8894a1b453fc780c1d2b355f34de27759a055ef6859333796665ac6439dd464"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "7f0c3213addbeab2ff96579bcdd860ad65b8ae95c9e6b1e3fb7e5497f3e5a89d"
+        "sha256": "d8894a1b453fc780c1d2b355f34de27759a055ef6859333796665ac6439dd464"
       }
     },
     {

package/office/index.mjs

@@ -154,21 +154,21 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not selection by text. To select a table or row by any descendant cell text, call docx_find_literal with kind table or row instead of listing the document. 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.',
+    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not selection by text. To select a table or row by any descendant cell text, call docx_find_literal with kind table or row instead of listing the document. After selecting a table or row, call docx_read_object once to obtain every descendant ref; do not list its rows and cells separately. Use parentRef only when nearest-child paging itself is the requested observation.',
     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 one small page of revision-bound native DOCX objects. With kind table or row, matching includes all descendant cell text, so no prior paragraph, cell, or document-wide list is needed. Use parentRef only to search nearest published children of a selected object.',
+    description: 'Find exact current text in one small page of revision-bound native DOCX objects. With kind table or row, matching includes all descendant cell text. After selecting a table or row, call docx_read_object once to obtain every descendant ref; do not list its rows and cells separately.',
     inputSchema: inputContract('docx_find_literal'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_find_literal', args),
   },
   {
     name: 'docx_read_object',
-    description: 'Write one selected revision-bound native DOCX object in full technical Open XML detail to a new JSON artifact. Use a table or row ref from list/find to inspect grid spans and merges without enumerating document-wide cells.',
+    description: 'Write one selected revision-bound native DOCX object, its Open XML, and every descendant object ref to a new JSON artifact. One table read provides all row, cell, paragraph, run, text, and drawing refs needed for mutation; do not enumerate those descendants with repeated list calls.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: artifactOutput('docx_read_object'),
     annotations: { readOnlyHint: true, idempotentHint: true },

package/package.json

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