@tiwater/office-mcp 0.17.7 → 0.17.9

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. Select the smallest object that contains the needed detail; for a large table, page its rows first and read only the selected rows.",
+      "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.",
       "type": "string",
       "pattern": "^dox1_[0-9a-f]{64}$"
     },

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

package/office/index.mjs

@@ -173,7 +173,10 @@ function docxInspectionOutput(tool) {
     revision: docxRevision,
     summary: z.object({
       tableCount: z.number().int().nonnegative(),
-      openingText: z.array(z.string().min(1).max(240)).max(6),
+      openingParagraphs: z.array(z.object({
+        ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
+        textPreview: z.string().min(1).max(240),
+      }).strict()).max(6),
     }).strict(),
   }).strict();
 }
@@ -238,7 +241,7 @@ const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
 const tools = [
   {
     name: 'docx_inspect',
-    description: 'Inspect one current DOCX. The response returns its revision, table count, and a bounded sample of its opening non-empty paragraphs for document identification; use paged docx_find_literal or docx_list_objects to select native objects. The complete inspection remains in the evidence artifact.',
+    description: 'Inspect one current DOCX. The response returns its revision, table count, and up to six opening non-empty body paragraphs with native refs for document identification and immediate reuse; use docx_find_literal for other text and docx_list_objects for container children. The complete inspection remains in the evidence artifact.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -262,7 +265,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX object and requested descendants. Select the smallest useful object; for a large table, page rows with docx_list_objects and read only the selected rows.',
+    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.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -505,13 +508,18 @@ function compactDocxInspection(report) {
   if (!report?.tables?.revision || !Array.isArray(report.tables.tables) || !Array.isArray(report.flow)) {
     throw new Error('docx-table-inspection-result-invalid');
   }
-  const openingText = report.flow
-    .filter(item => item?.type === 'paragraph' && typeof item.text === 'string' && item.text.trim())
+  const openingParagraphs = report.flow
+    .filter(item => item?.type === 'paragraph'
+      && /^dox1_[0-9a-f]{64}$/u.test(item.objectRef)
+      && typeof item.text === 'string' && item.text.trim())
     .slice(0, 6)
-    .map(item => item.text.trim().replace(/\s+/gu, ' ').slice(0, 240));
+    .map(item => ({
+      ref: item.objectRef,
+      textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
+    }));
   return {
     revision: report.tables.revision,
-    summary: { tableCount: report.tables.tables.length, openingText },
+    summary: { tableCount: report.tables.tables.length, openingParagraphs },
   };
 }
 

package/package.json

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