@tiwater/office-mcp 0.17.11 → 0.17.12

package/office/contracts/docx_read_object.schema.json

@@ -8,7 +8,7 @@
       "x-tiwater-file-role": "read"
     },
     "ref": {
-      "description": "One object ref returned by docx_list_objects or docx_find_literal. Read a complete small or medium table once; page rows only when the complete table is too large for one response.",
+      "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}$"
     },
@@ -18,7 +18,7 @@
       "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
     },
     "kinds": {
-      "description": "Object kinds required by the next operation. Include paragraph when paragraph boundaries affect a later content selection.",
+      "description": "Object kinds required by the next operation. Include paragraph for table content boundaries. Request run or text only when ref identifies a cell or paragraph, never a whole table.",
       "type": "array",
       "items": {
         "type": "string",

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

package/office/index.mjs

@@ -265,7 +265,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX object and requested descendants. Read a complete small or medium table once with row, cell, and paragraph descendants; add run or text only for an exact inline selection. Page rows only when the complete table is too large for one response.',
+    description: 'Read one selected native DOCX object and requested descendants. For a table, read row, cell, and paragraph descendants first. To select exact inline content, make a second read rooted at the observed cell or paragraph and request run or text; table-rooted inline reads are rejected so one call cannot return the document-wide character tree.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -538,14 +538,14 @@ function compactDocxObservation(observation) {
   if (!observation?.object) throw new Error('docx-read-object-missing-observation');
   function compactNode(node) {
     const identity = compactDocxObjectIdentity(node.object);
+    const children = (node.children ?? []).map(compactNode);
     const object = {
       ref: identity.ref,
       kind: identity.kind,
-      textPreview: identity.textPreview,
+      textPreview: children.length === 0 ? identity.textPreview : null,
       ...(identity.gridSpan === null ? {} : { gridSpan: identity.gridSpan }),
       ...(identity.verticalMerge === null ? {} : { verticalMerge: identity.verticalMerge }),
     };
-    const children = (node.children ?? []).map(compactNode);
     return {
       object,
       ...(children.length === 0 ? {} : { children }),
@@ -602,6 +602,10 @@ 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'
+      && args.kinds.some(kind => kind === 'run' || kind === 'text')) {
+      throw new Error('docx-table-inline-detail-requires-cell-or-paragraph-root');
+    }
     return {
       tool: 'docx_read_object',
       runtime: commandRuntime(result),

package/package.json

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