@tiwater/office-mcp 0.18.8 → 0.18.10

package/office/contracts/docx_table_index.schema.json

@@ -14,6 +14,18 @@
       "minLength": 1,
       "description": "New JSON artifact path for the complete table index.",
       "x-tiwater-file-role": "write"
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1000,
+      "description": "Maximum number of table summaries requested in this response page. The provider may return fewer to keep the machine response bounded."
+    },
+    "offset": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991,
+      "description": "Zero-based table offset. Continue from receipt.nextOffset until it is null."
     }
   },
   "required": ["input", "output"],

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.18.8"
+    "version": "0.18.10"
   },
   "tools": [
     {
@@ -207,11 +207,11 @@
       "name": "docx_table_index",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_table_index.schema.json",
-        "sha256": "7549ce28e3cc51ae17cd86c77c97698b6e90f0125afd34ae8831fde7f87ddf67"
+        "sha256": "e10ea5780559f269b6fa193aadb0fc0793009e5e7a4047a7a46aa5621dfeaac1"
       },
       "inputContract": {
         "path": "office/contracts/docx_table_index.schema.json",
-        "sha256": "7549ce28e3cc51ae17cd86c77c97698b6e90f0125afd34ae8831fde7f87ddf67"
+        "sha256": "e10ea5780559f269b6fa193aadb0fc0793009e5e7a4047a7a46aa5621dfeaac1"
       }
     },
     {

package/office/index.mjs

@@ -218,6 +218,13 @@ const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
 
 const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
   schema: z.literal('tiwater.docx-table-index/v1'),
+  receipt: z.object({
+    schema: z.literal('tiwater.docx-table-index-receipt/v1'),
+    totalCount: z.number().int().nonnegative(),
+    returnedCount: z.number().int().nonnegative(),
+    remaining: z.number().int().nonnegative(),
+    nextOffset: z.number().int().nonnegative().nullable(),
+  }).strict(),
   tables: z.array(z.object({
     address: docxAddress,
     parentAddress: docxAddress.nullable(),
@@ -225,6 +232,16 @@ const docxTableIndexOutput = artifactOutput('docx_table_index').extend({
     columnCount: z.number().int().nonnegative(),
     textPreview: z.string(),
     textLength: z.number().int().nonnegative(),
+    precedingParagraph: z.object({
+      address: docxAddress,
+      textPreview: z.string(),
+      textLength: z.number().int().nonnegative(),
+    }).strict().nullable(),
+    followingParagraph: z.object({
+      address: docxAddress,
+      textPreview: z.string(),
+      textLength: z.number().int().nonnegative(),
+    }).strict().nullable(),
   }).strict()),
 }).strict();
 
@@ -233,6 +250,16 @@ const docxTableReadOutput = artifactOutput('docx_read_table').extend({
   address: docxAddress,
   rowCount: z.number().int().nonnegative(),
   columnCount: z.number().int().nonnegative(),
+  precedingParagraph: z.object({
+    address: docxAddress,
+    textPreview: z.string(),
+    textLength: z.number().int().nonnegative(),
+  }).strict().nullable(),
+  followingParagraph: z.object({
+    address: docxAddress,
+    textPreview: z.string(),
+    textLength: z.number().int().nonnegative(),
+  }).strict().nullable(),
   rows: z.array(z.object({
     address: docxAddress,
     gridBefore: z.number().int().nonnegative(),
@@ -276,7 +303,7 @@ const tools = [
   },
   {
     name: 'docx_table_index',
-    description: 'Locate tables in one current DOCX. Returns one compact index containing every table address, shape, and short text preview. Choose the needed address from this index, then call docx_read_table. It does not return full cell content or decide table semantics.',
+    description: 'Locate tables in one current DOCX. Writes the complete index to output and returns a bounded page containing table address, shape, short text preview, and nearest non-empty paragraphs. Continue with receipt.nextOffset, then call docx_read_table for one selected address. It does not return full cell content or decide table semantics.',
     inputSchema: inputContract('docx_table_index'),
     outputSchema: docxTableIndexOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -292,7 +319,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Returns its rows, cells, spans, vertical merges, paragraphs, text nodes, and reusable addresses in document order. It does not locate a table or decide business meaning.',
+    description: 'Read exactly one table selected from docx_table_index by native OpenXML address. Returns its nearest non-empty paragraph before and after the table, rows, cells, spans, vertical merges, paragraphs, text nodes, and reusable addresses in document order. It does not locate a table or decide business meaning.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -612,7 +639,31 @@ async function docxObservation(tool, args) {
     if (tool === 'docx_list_objects') {
       return { ...retained, ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
     }
-    if (tool === 'docx_table_index' || tool === 'docx_read_table') return { ...retained, ...payload };
+    if (tool === 'docx_table_index') {
+      const totalCount = payload.tables.length;
+      const offset = Math.min(args.offset ?? 0, totalCount);
+      const requestedLimit = args.limit ?? totalCount;
+      const tables = [];
+      for (const table of payload.tables.slice(offset, offset + requestedLimit)) {
+        const candidate = [...tables, table];
+        if (tables.length > 0 && Buffer.byteLength(JSON.stringify(candidate)) > 7_000) break;
+        tables.push(table);
+      }
+      const nextOffset = offset + tables.length < totalCount ? offset + tables.length : null;
+      return {
+        ...retained,
+        schema: payload.schema,
+        receipt: {
+          schema: 'tiwater.docx-table-index-receipt/v1',
+          totalCount,
+          returnedCount: tables.length,
+          remaining: totalCount - offset - tables.length,
+          nextOffset,
+        },
+        tables,
+      };
+    }
+    if (tool === 'docx_read_table') return { ...retained, ...payload };
     throw new Error(`unsupported-docx-observation-tool:${tool}`);
   });
 }

package/package.json

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