@tiwater/office-mcp 0.17.31 → 0.17.33

package/office/contracts/docx_read_object.schema.json

@@ -7,10 +7,11 @@
       "minLength": 1,
       "x-tiwater-file-role": "read"
     },
-    "ref": {
-      "description": "One object ref returned by a current DOCX observation. Read table structure through paragraph descendants first. For exact inline content, use an observed cell or paragraph ref; table-rooted run/text reads are rejected.",
-      "type": "string",
-      "pattern": "^dox1_[0-9a-f]{64}$"
+    "refs": {
+      "description": "Object refs from one current DOCX observation, returned in this order. Use row, cell, or paragraph refs; table-rooted reads are rejected.",
+      "type": "array",
+      "items": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+      "minItems": 1
     },
     "revision": {
       "description": "Optional expected revision id from the observation receipt; a changed document fails as stale.",
@@ -44,7 +45,7 @@
   },
   "required": [
     "input",
-    "ref",
+    "refs",
     "kinds",
     "output"
   ],

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.31"
+    "version": "0.17.33"
   },
   "tools": [
     {
@@ -119,11 +119,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "1b92b5620f0f76f47b7a9550d79d414f5e0a76cb37a7c4c2615e02e32cf9a02c"
+        "sha256": "589b616fa60e39107fb6061a67b23387f07acf0d3974a8bf1580cc2567857ff1"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "1b92b5620f0f76f47b7a9550d79d414f5e0a76cb37a7c4c2615e02e32cf9a02c"
+        "sha256": "589b616fa60e39107fb6061a67b23387f07acf0d3974a8bf1580cc2567857ff1"
       }
     },
     {
@@ -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

@@ -222,7 +222,7 @@ const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
 
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   revision: docxRevision,
-  observation: docxObservationNode,
+  observations: z.array(docxObservationNode).min(1),
 }).strict();
 
 const tools = [
@@ -244,7 +244,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX row, cell, or paragraph and requested descendants. For a table, page its row identities with docx_list_objects, then read only the current row. To select exact inline content, make a second read rooted at the observed cell or paragraph 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. 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.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -574,7 +574,7 @@ async function docxReadObject(args) {
   const { output: _output, ...request } = args;
   return withTempJsonFile(request, async requestPath => {
     const result = await runJsonCandidateChain(docxCandidates, ['docx_read_object', requestPath]);
-    if (result.json?.observation?.object?.kind === 'table') {
+    if (result.json?.observations?.some(observation => observation?.object?.kind === 'table')) {
       throw new Error('docx-table-read-requires-paged-row-selection');
     }
     return {
@@ -583,7 +583,7 @@ async function docxReadObject(args) {
       source: await fileArtifact(input),
       artifact: await writeJsonArtifact(output, result.json),
       revision: result.json.receipt.revision,
-      observation: compactDocxObservation(result.json.observation),
+      observations: result.json.observations.map(compactDocxObservation),
     };
   });
 }

package/package.json

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