@tiwater/office-mcp 0.17.32 → 0.17.34

package/office/contracts/docx_replace_table_rows.schema.json

@@ -111,7 +111,12 @@
         "additionalProperties": false
       }
     },
-    "output": { "type": "string", "minLength": 1, "x-tiwater-file-role": "write" },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "New DOCX revision. Every targetDocument object ref becomes stale after success; observe this output before any later structural call.",
+      "x-tiwater-file-role": "write"
+    },
     "receiptOutput": {
       "type": "string",
       "minLength": 1,

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.17.32"
+    "version": "0.17.34"
   },
   "tools": [
     {
@@ -152,11 +152,11 @@
       "name": "docx_replace_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_table_rows.schema.json",
-        "sha256": "dc0afe9a4be1974744df80d7d6b920034f0fa78f79ea18b2844eb67d69ecac5f"
+        "sha256": "2b2aa0f981767c57b974ff088e8bfe51091cc73bd10ad3eb86a6ce5ff3a798e9"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "dc0afe9a4be1974744df80d7d6b920034f0fa78f79ea18b2844eb67d69ecac5f"
+        "sha256": "2b2aa0f981767c57b974ff088e8bfe51091cc73bd10ad3eb86a6ce5ff3a798e9"
       }
     },
     {

package/office/index.mjs

@@ -236,7 +236,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of revision-bound nearest-child identities in native document order and retain the exact page at output for later reuse. Request only the object kinds needed by the current local traversal, follow continuation in order, and descend only through returned refs with parentRef. Text previews describe already located objects; never use matching text to identify a document or select a source.',
+    description: 'List one small page of nearest-child identities from the current DOCX in native document order and retain the exact page at output. This call creates and returns the current revision; it does not accept a revision argument. Request only the object kinds needed by the current local traversal, follow continuation in order, and descend only through returned refs with parentRef. Text previews describe already located objects; they do not prove descendant content.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -244,7 +244,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read selected rows, cells, or paragraphs from one native DOCX in one call and return them in refs order. Pass the document path once and all refs needed for the current target. For exact inline content, use observed cell or paragraph refs and request run or text.',
+    description: 'Read selected rows, cells, or paragraphs from one native DOCX in one call and return them in refs order. Unlike docx_list_objects, this call accepts the list result revision to reject stale refs. Pass the document path once and only the refs needed for the current target. For exact inline content, use observed cell or paragraph refs and request run or text.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },

package/package.json

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