@tiwater/office-mcp 0.17.11 → 0.17.13

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/docx_set_text.schema.json

@@ -21,7 +21,7 @@
           "targetRef": {
             "type": "string",
             "pattern": "^dox1_[0-9a-f]{64}$",
-            "description": "Observed plain-text paragraph or cell ref whose whole text content is replaced. Paragraph bookmarks are preserved; targets containing fields, drawings, nested tables, controls, links, or other non-text content are rejected."
+            "description": "Observed paragraph or cell ref whose whole text content is replaced. Bookmarks and target formatting are preserved; tabs and line breaks are written as native OpenXML text controls. Targets containing fields, drawings, nested tables, controls, links, or other non-text content are rejected."
           },
           "text": { "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.13"
   },
   "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"
       }
     },
     {
@@ -174,11 +174,11 @@
       "name": "docx_set_text",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_set_text.schema.json",
-        "sha256": "945a5af0d9390c21f380cc9d255429353d6f743264b19a9e85111e75b3c0344b"
+        "sha256": "f66adf07e6e53599d93ad29420d7a977d869371ef3e0759a128fb2333f8daf08"
       },
       "inputContract": {
         "path": "office/contracts/docx_set_text.schema.json",
-        "sha256": "945a5af0d9390c21f380cc9d255429353d6f743264b19a9e85111e75b3c0344b"
+        "sha256": "f66adf07e6e53599d93ad29420d7a977d869371ef3e0759a128fb2333f8daf08"
       }
     },
     {

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 },
@@ -280,7 +280,7 @@ const tools = [
   },
   {
     name: 'docx_set_text',
-    description: 'Replace the whole text content of observed plain-text paragraph or cell objects while retaining their target formatting. Targets containing non-text objects are rejected. This sets already-derived text; it does not insert objects, copy source formatting, or decide business wording.',
+    description: 'Replace the whole text content of observed paragraph or cell objects while retaining target formatting and bookmarks. Tabs and line breaks remain native document text controls; targets containing non-text objects are rejected. This sets already-derived text; it does not insert objects, copy source formatting, or decide business wording.',
     inputSchema: inputContract('docx_set_text'),
     outputSchema: fixedEditOutput('docx_set_text'),
     handler: args => fixedEdit('docx_set_text', args),
@@ -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.13",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",