@tiwater/office-mcp 0.17.19 → 0.17.21

package/office/contracts/docx_copy_table_rows.schema.json

@@ -5,6 +5,7 @@
   "properties": {
     "changes": {
       "type": "array",
+      "description": "Complete resolved table-edit set for one target document. A successful call invalidates every prior target ref, so do not split this set across calls.",
       "minItems": 1,
       "items": {
         "type": "object",

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.19"
+    "version": "0.17.21"
   },
   "tools": [
     {
@@ -64,11 +64,11 @@
       "name": "docx_copy_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_table_rows.schema.json",
-        "sha256": "f0c72dc539bbacbc00320c4735ba1de5dd6ebe11be82e97f3951ba442a5bd6ad"
+        "sha256": "76cb4ee7a8a4ce3871fbf2773619b337a2aa95622699f08aa92e0448bb76721c"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_rows.schema.json",
-        "sha256": "f0c72dc539bbacbc00320c4735ba1de5dd6ebe11be82e97f3951ba442a5bd6ad"
+        "sha256": "76cb4ee7a8a4ce3871fbf2773619b337a2aa95622699f08aa92e0448bb76721c"
       }
     },
     {

package/office/index.mjs

@@ -173,6 +173,13 @@ function docxInspectionOutput(tool) {
     revision: docxRevision,
     summary: z.object({
       tableCount: z.number().int().nonnegative(),
+      tables: z.array(z.object({
+        ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
+        parentRef: z.string().regex(/^dox1_[0-9a-f]{64}$/).nullable(),
+        rowCount: z.number().int().nonnegative(),
+        columnCount: z.number().int().nonnegative(),
+        textPreview: z.string().max(240),
+      }).strict()),
       openingParagraphs: z.array(z.object({
         ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
         textPreview: z.string().min(1).max(240),
@@ -241,7 +248,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 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.',
+    description: 'Inspect one current DOCX. The response returns its revision, every table identity with shape and short text preview, and up to six opening non-empty body paragraphs. Reuse those native refs directly; use docx_find_literal only for text not exposed here and docx_list_objects only for container children. The complete inspection remains in the evidence artifact.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -287,7 +294,7 @@ const tools = [
   },
   {
     name: 'docx_copy_table_rows',
-    description: 'Populate existing target tables by replacing selected data-row ranges with selected source rows. Each changes item contains its sourceDocument, source table and rows, targetDocument, target table and rows, and header-cell mappings. Every item in one call must use the same target document; batch all resolved edits because a successful edit invalidates prior target refs. All source-cell paragraphs copy by default. When a source cell contains content that the target must omit, sourceCellContents selects the exact observed content in this same call.',
+    description: 'Apply all resolved row replacements for one target document in one call. changes is the only edit payload; each item names its source document and table rows, target document and table rows, and header-cell mappings. A success invalidates every prior target ref. All source-cell paragraphs copy by default; sourceCellContents selects exact observed content that the target keeps.',
     inputSchema: inputContract('docx_copy_table_rows'),
     outputSchema: fixedEditOutput('docx_copy_table_rows'),
     handler: args => fixedEdit('docx_copy_table_rows', args),
@@ -519,7 +526,17 @@ function compactDocxInspection(report) {
     }));
   return {
     revision: report.tables.revision,
-    summary: { tableCount: report.tables.tables.length, openingParagraphs },
+    summary: {
+      tableCount: report.tables.tables.length,
+      tables: report.tables.tables.map(table => ({
+        ref: table.ref,
+        parentRef: table.parentRef,
+        rowCount: table.rowCount,
+        columnCount: table.columnCount,
+        textPreview: String(table.textPreview ?? '').trim().replace(/\s+/gu, ' ').slice(0, 240),
+      })),
+      openingParagraphs,
+    },
   };
 }
 

package/package.json

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