@tiwater/office-mcp 0.15.6 → 0.15.8

package/office/contracts/docx_export_json.schema.json

@@ -10,7 +10,7 @@
     "output": {
       "type": "string",
       "minLength": 1,
-      "description": "New JSON artifact path. Existing files are never overwritten.",
+      "description": "Absolute path for a new JSON artifact inside the caller-authorized output directory. Existing files are never overwritten.",
       "x-tiwater-file-role": "write"
     }
   },

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_inspect.schema.json

@@ -10,7 +10,7 @@
     "output": {
       "type": "string",
       "minLength": 1,
-      "description": "New JSON artifact path. Existing files are never overwritten.",
+      "description": "Absolute path for a new JSON artifact inside the caller-authorized output directory. Existing files are never overwritten.",
       "x-tiwater-file-role": "write"
     }
   },

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.8"
   },
   "tools": [
     {
@@ -130,22 +130,22 @@
       "name": "docx_export_json",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_export_json.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
+        "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       },
       "inputContract": {
         "path": "office/contracts/docx_export_json.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
+        "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       }
     },
     {
       "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"
       }
     },
     {
@@ -207,11 +207,11 @@
       "name": "docx_inspect",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_inspect.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
+        "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       },
       "inputContract": {
         "path": "office/contracts/docx_inspect.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
+        "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       }
     },
     {
@@ -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

@@ -191,7 +191,7 @@ function artifactOutput(tool) {
 const tools = [
   {
     name: 'docx_inspect',
-    description: 'Inspect a DOCX document and write one unified JSON observation containing placeholders, comments, anchors, tables, fields, flow, fonts, and formatting metrics.',
+    description: 'Write the default single full-document DOCX observation containing body content, structure, placeholders, comments, anchors, tables, fields, flow, fonts, and formatting metrics. Do not also call docx_export_json for the same observation.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: artifactOutput('docx_inspect'),
     handler: docxInspect,
@@ -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),
@@ -241,7 +241,7 @@ const tools = [
   },
   {
     name: 'docx_export_json',
-    description: 'Export DOCX body content to a new JSON artifact without returning the full document through MCP.',
+    description: 'Write a body-only DOCX JSON projection only when a downstream consumer explicitly requires that format. It is not a companion to docx_inspect and does not replace bounded list/find/read object selection.',
     inputSchema: inputContract('docx_export_json'),
     outputSchema: artifactOutput('docx_export_json'),
     handler: docxExportJson,

package/package.json

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