@tiwater/office-mcp 0.18.11 → 0.18.13

package/office/contracts/docx_replace_table_rows.schema.json

@@ -103,7 +103,7 @@
           },
           "targetRows": {
             "type": "object",
-            "description": "Contiguous target data rows to replace. The header row stays outside this range. The first and last row must enclose complete vertical-merge groups as reported by docx_read_table.",
+            "description": "Contiguous target data rows to replace. The header row stays outside this range. Omit last to replace from first through the table's final row. An explicit first and last must enclose complete vertical-merge groups as reported by docx_read_table.",
             "properties": {
               "first": {
                 "type": "object",
@@ -143,8 +143,7 @@
               }
             },
             "required": [
-              "first",
-              "last"
+              "first"
             ],
             "additionalProperties": false
           },
@@ -282,6 +281,11 @@
               ],
               "additionalProperties": false
             }
+          },
+          "sourceParagraphMode": {
+            "type": "string",
+            "const": "omit-paired-latin-prose",
+            "description": "Optional deterministic paragraph selection for every mapped source cell. omit-paired-latin-prose preserves Han or mixed-language paragraphs and standalone technical expressions, while omitting adjacent Latin prose paired after Han text. It cannot be combined with sourceCellContents."
           }
         },
         "required": [

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.11"
+    "version": "0.18.13"
   },
   "tools": [
     {
@@ -163,11 +163,11 @@
       "name": "docx_replace_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_replace_table_rows.schema.json",
-        "sha256": "544d36dc38d9fdf77cfefc0208591fc64321a510171a9b407ab6b46b9c1797e4"
+        "sha256": "b5ea315e8a21e7a2ca4e52857504f190ace7dffb6666fa549994799be242ce20"
       },
       "inputContract": {
         "path": "office/contracts/docx_replace_table_rows.schema.json",
-        "sha256": "544d36dc38d9fdf77cfefc0208591fc64321a510171a9b407ab6b46b9c1797e4"
+        "sha256": "b5ea315e8a21e7a2ca4e52857504f190ace7dffb6666fa549994799be242ce20"
       }
     },
     {

package/office/index.mjs

@@ -311,7 +311,7 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'Page through mixed nearest-child OpenXML objects when document order or paragraph relationships are required. Continue with nextOffset and descend through a returned parent address. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then docx_read_table for one selected table.',
+    description: 'Page through mixed nearest-child OpenXML objects when document order or paragraph relationships are required. The complete requested provider page is retained at output; the response returns a byte-bounded prefix. Continue with receipt.nextOffset and descend through a returned parent address. Do not use this tool to locate tables or read a whole document: use docx_table_index to locate tables, then docx_read_table for one selected table.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -357,7 +357,7 @@ const tools = [
   },
   {
     name: 'docx_replace_table_rows',
-    description: 'Replace one or more data-row ranges in one current target document. Read both tables first. Each selected row range excludes its header and encloses complete vertical-merge groups; header-cell mappings cover both complete grids. Source cells copy all paragraphs by default. To keep selected content only, each sourceSelections item puts the observed address in its address field; range is optional for a substring.',
+    description: 'Replace data rows in existing target tables after reading both tables. Each range excludes its header and closes vertical merges; omit targetRows.last to replace through the table end. Source cells copy all paragraphs by default. sourceParagraphMode can omit paired Latin prose while retaining Han text and standalone technical expressions; explicit sourceCellContents remains available for exact selections.',
     inputSchema: inputContract('docx_replace_table_rows'),
     outputSchema: fixedEditOutput('docx_replace_table_rows'),
     handler: args => fixedEdit('docx_replace_table_rows', args),
@@ -653,7 +653,28 @@ async function docxObservation(tool, args) {
       artifact: await writeJsonArtifact(output, result.json),
     };
     if (tool === 'docx_list_objects') {
-      return { ...retained, ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
+      const totalCount = payload.receipt.totalCount;
+      const offset = Math.min(args.offset ?? 0, totalCount);
+      const objects = [];
+      for (const sourceObject of payload.objects.map(compactDocxObjectIdentity)) {
+        const candidate = [...objects, sourceObject];
+        if (objects.length > 0 && Buffer.byteLength(JSON.stringify(candidate)) > 6_500) break;
+        objects.push(sourceObject);
+      }
+      const nextOffset = offset + objects.length < totalCount ? offset + objects.length : null;
+      return {
+        ...retained,
+        schema: payload.schema,
+        receipt: {
+          schema: 'tiwater.docx-observation-receipt/v1',
+          operation: 'list',
+          totalCount,
+          returnedCount: objects.length,
+          remaining: totalCount - offset - objects.length,
+          nextOffset,
+        },
+        objects,
+      };
     }
     if (tool === 'docx_table_index') {
       const totalCount = payload.tables.length;

package/package.json

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