@tiwater/office-mcp 0.17.26 → 0.17.28

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.26"
+    "version": "0.17.28"
   },
   "tools": [
     {

package/office/index.mjs

@@ -179,6 +179,10 @@ function docxInspectionOutput(tool) {
         rowCount: z.number().int().nonnegative(),
         columnCount: z.number().int().nonnegative(),
         textPreview: z.string().max(240),
+        contextBefore: z.array(z.object({
+          ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
+          textPreview: z.string().min(1).max(240),
+        }).strict()).max(3),
       }).strict()),
       openingParagraphs: z.array(z.object({
         ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
@@ -248,7 +252,7 @@ const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
 const tools = [
   {
     name: 'docx_inspect',
-    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.',
+    description: 'Inspect one current DOCX. The response returns its revision, every table identity with shape, short text preview, and up to three immediately preceding non-empty body paragraphs, plus 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 },
@@ -524,16 +528,33 @@ function compactDocxInspection(report) {
       ref: item.objectRef,
       textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
     }));
+  const tableContexts = new Map();
+  let precedingParagraphs = [];
+  for (const item of report.flow) {
+    if (item?.type === 'paragraph' && /^dox1_[0-9a-f]{64}$/u.test(item.objectRef)
+      && typeof item.text === 'string' && item.text.trim()) {
+      precedingParagraphs.push({
+        ref: item.objectRef,
+        textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
+      });
+      precedingParagraphs = precedingParagraphs.slice(-3);
+    }
+    if (item?.type === 'table' && Number.isInteger(item.tableIndex)) {
+      tableContexts.set(item.tableIndex, precedingParagraphs);
+      precedingParagraphs = [];
+    }
+  }
   return {
     revision: report.tables.revision,
     summary: {
       tableCount: report.tables.tables.length,
-      tables: report.tables.tables.map(table => ({
+      tables: report.tables.tables.map((table, tableIndex) => ({
         ref: table.ref,
         parentRef: table.parentRef,
         rowCount: table.rowCount,
         columnCount: table.columnCount,
         textPreview: String(table.textPreview ?? '').trim().replace(/\s+/gu, ' ').slice(0, 240),
+        contextBefore: tableContexts.get(tableIndex) ?? [],
       })),
       openingParagraphs,
     },

package/package.json

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