@tiwater/office-mcp 0.21.41 → 0.21.43

package/office/contracts/docx_read_table.schema.json

@@ -21,10 +21,11 @@
       "required": ["part", "path"],
       "additionalProperties": false
     },
-    "continuation": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Opaque continuation returned by the preceding page. Pass it back unchanged; omit it for the first page."
+    "offset": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991,
+      "description": "Zero-based row offset. Continue from receipt.nextOffset only when a later row is needed."
     },
     "output": {
       "type": "string",

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.21.41"
+    "version": "0.21.43"
   },
   "tools": [
     {
@@ -152,11 +152,11 @@
       "name": "docx_read_table",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_table.schema.json",
-        "sha256": "a0d13fb70cc43d7ee7f3be9730f98df9a5e988d33fb7454b44f5e455d068b950"
+        "sha256": "c5f9f628494a11e0377248c256b3c047471f897c92a81b6fa1a01f408e478962"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_table.schema.json",
-        "sha256": "a0d13fb70cc43d7ee7f3be9730f98df9a5e988d33fb7454b44f5e455d068b950"
+        "sha256": "c5f9f628494a11e0377248c256b3c047471f897c92a81b6fa1a01f408e478962"
       }
     },
     {
@@ -405,187 +405,187 @@
       "name": "xlsx_convert_legacy",
       "providerContract": {
         "source": "packages/convert-cli/schemas/mcp-input/xlsx_convert_legacy.schema.json",
-        "sha256": "08efc93ee8105666278d0d45c4886ec325c660d4e610754928e6926cf169188a"
+        "sha256": "0867f51d4b2461ae2d739a0a9dd01c1d7935bb6b4ebeb9678f56ddc8775543ad"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_convert_legacy.schema.json",
-        "sha256": "08efc93ee8105666278d0d45c4886ec325c660d4e610754928e6926cf169188a"
+        "sha256": "0867f51d4b2461ae2d739a0a9dd01c1d7935bb6b4ebeb9678f56ddc8775543ad"
       }
     },
     {
       "name": "xlsx_copy_row",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_copy_row.schema.json",
-        "sha256": "7159b2ed971a54a0c5f0c7e9686e6594908858694eab9e6e65b15771e0ab3500"
+        "sha256": "66d20708d28a82112a372fee7cdd20976b32e562788d0f6336e27311b872caf6"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_copy_row.schema.json",
-        "sha256": "7159b2ed971a54a0c5f0c7e9686e6594908858694eab9e6e65b15771e0ab3500"
+        "sha256": "66d20708d28a82112a372fee7cdd20976b32e562788d0f6336e27311b872caf6"
       }
     },
     {
       "name": "xlsx_delete_rows",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_delete_rows.schema.json",
-        "sha256": "0d54bf1299dd8591baf2cd550adfb191ea6bfad91b3dfb28543a56d8dc135910"
+        "sha256": "13211831a052d1c5d2b406f1481412ebe95c46344fe8c86e6744184f22fc8352"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_delete_rows.schema.json",
-        "sha256": "0d54bf1299dd8591baf2cd550adfb191ea6bfad91b3dfb28543a56d8dc135910"
+        "sha256": "13211831a052d1c5d2b406f1481412ebe95c46344fe8c86e6744184f22fc8352"
       }
     },
     {
       "name": "xlsx_expand_section_rows",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_expand_section_rows.schema.json",
-        "sha256": "93f9e8562e7bf99f3f0612bbf701efcd3c142f51be790e8b348a8472998f8f24"
+        "sha256": "b9a3b3b73186e0d03777977717bc07afd25816e9843e9c832596f3fff348a871"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_expand_section_rows.schema.json",
-        "sha256": "93f9e8562e7bf99f3f0612bbf701efcd3c142f51be790e8b348a8472998f8f24"
+        "sha256": "b9a3b3b73186e0d03777977717bc07afd25816e9843e9c832596f3fff348a871"
       }
     },
     {
       "name": "xlsx_export_json",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_export_json.schema.json",
-        "sha256": "3943fa01506e5b9ea1cb0ecfd13fc484c16ec96245af462c9a6a37377f2a7a82"
+        "sha256": "a5d08d470d52c8deab61894ac28319339ae5a6d2c769280a24fa9c6d40579c3e"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_export_json.schema.json",
-        "sha256": "3943fa01506e5b9ea1cb0ecfd13fc484c16ec96245af462c9a6a37377f2a7a82"
+        "sha256": "a5d08d470d52c8deab61894ac28319339ae5a6d2c769280a24fa9c6d40579c3e"
       }
     },
     {
       "name": "xlsx_insert_rows",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_insert_rows.schema.json",
-        "sha256": "a295530a293a9930a5fe49d320f5d965fe4065322e2106575f0e74b18ec70680"
+        "sha256": "6667ff2ddada86e4bac3da7e1dfec99d107f80eed00bc1af4335c95e3e2ebe29"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_insert_rows.schema.json",
-        "sha256": "a295530a293a9930a5fe49d320f5d965fe4065322e2106575f0e74b18ec70680"
+        "sha256": "6667ff2ddada86e4bac3da7e1dfec99d107f80eed00bc1af4335c95e3e2ebe29"
       }
     },
     {
       "name": "xlsx_inspect",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_inspect.schema.json",
-        "sha256": "9cde8fdda335f379d44e60819367b305a2c97c6c0c8fdf2141bf460335e5da84"
+        "sha256": "f1c15dc66eafe6208a30a711c76c4e058c8b2a035707a4064e6a0a3b64687945"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_inspect.schema.json",
-        "sha256": "9cde8fdda335f379d44e60819367b305a2c97c6c0c8fdf2141bf460335e5da84"
+        "sha256": "f1c15dc66eafe6208a30a711c76c4e058c8b2a035707a4064e6a0a3b64687945"
       }
     },
     {
       "name": "xlsx_read_range",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_read_range.schema.json",
-        "sha256": "66a5ff24b1a207d70aa278b81a8efba5dc272af2f7a7c12331154e8aa8d8f3dd"
+        "sha256": "a4c489e1e695347bc853a9113f330d14a8256ae56b056936147fe510d0a48a82"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_read_range.schema.json",
-        "sha256": "66a5ff24b1a207d70aa278b81a8efba5dc272af2f7a7c12331154e8aa8d8f3dd"
+        "sha256": "a4c489e1e695347bc853a9113f330d14a8256ae56b056936147fe510d0a48a82"
       }
     },
     {
       "name": "xlsx_set_cell_number_format",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_cell_number_format.schema.json",
-        "sha256": "b5f40eb92bea55b43166de3eea3944bcac000cb3b29f402ef1731ab190242db1"
+        "sha256": "5e250e4de4b287f0f3963e9c00218095bcb36ac3966334fab1af0d418a92c1c0"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_cell_number_format.schema.json",
-        "sha256": "b5f40eb92bea55b43166de3eea3944bcac000cb3b29f402ef1731ab190242db1"
+        "sha256": "5e250e4de4b287f0f3963e9c00218095bcb36ac3966334fab1af0d418a92c1c0"
       }
     },
     {
       "name": "xlsx_set_cell_value",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_cell_value.schema.json",
-        "sha256": "ba49e6edd2741162161b9b98f3a4aa8d093f5552084cbdbc736b5e8e9431edc7"
+        "sha256": "b781ff899a8690ee9f1d487885fa7354071940f7f62afe22c9235a07ff8d277d"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_cell_value.schema.json",
-        "sha256": "ba49e6edd2741162161b9b98f3a4aa8d093f5552084cbdbc736b5e8e9431edc7"
+        "sha256": "b781ff899a8690ee9f1d487885fa7354071940f7f62afe22c9235a07ff8d277d"
       }
     },
     {
       "name": "xlsx_set_column_width",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_column_width.schema.json",
-        "sha256": "b1435b0b12c1f2a8dcc504bfc78a8b8ca456e4a1fbd48ed0a8a61b9746d40839"
+        "sha256": "6fbc2b7db11436369ef94f04860bc83fd0ca19025728e59f781f83ce4afa10ae"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_column_width.schema.json",
-        "sha256": "b1435b0b12c1f2a8dcc504bfc78a8b8ca456e4a1fbd48ed0a8a61b9746d40839"
+        "sha256": "6fbc2b7db11436369ef94f04860bc83fd0ca19025728e59f781f83ce4afa10ae"
       }
     },
     {
       "name": "xlsx_set_page_setup",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_page_setup.schema.json",
-        "sha256": "8340463fe45d05ab1c56c56a9c52d80cd2cf459722c02f5f795e8ef2214dd5e7"
+        "sha256": "caad609ad9375cd8ca45172b2e7672195128957330aeabc2575b10777e1ceeac"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_page_setup.schema.json",
-        "sha256": "8340463fe45d05ab1c56c56a9c52d80cd2cf459722c02f5f795e8ef2214dd5e7"
+        "sha256": "caad609ad9375cd8ca45172b2e7672195128957330aeabc2575b10777e1ceeac"
       }
     },
     {
       "name": "xlsx_set_print_area",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_print_area.schema.json",
-        "sha256": "ca125ccbd01cf461872566ef3f13047b2bb735fc2157bea61c2ee2c0f41a4ecd"
+        "sha256": "e5b4b96f107850f23bda595a7c439ba1c1af89f43ffca1769da07b49391d4611"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_print_area.schema.json",
-        "sha256": "ca125ccbd01cf461872566ef3f13047b2bb735fc2157bea61c2ee2c0f41a4ecd"
+        "sha256": "e5b4b96f107850f23bda595a7c439ba1c1af89f43ffca1769da07b49391d4611"
       }
     },
     {
       "name": "xlsx_set_range_values",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_range_values.schema.json",
-        "sha256": "5ce9843e5cb03c237a743e54bce185d4e597d22cd072cbd67adb2bd87f2692e0"
+        "sha256": "62643e69fe16fc6d1a498d14e3f2fb07897491a0951278c474843994b79b0df3"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_range_values.schema.json",
-        "sha256": "5ce9843e5cb03c237a743e54bce185d4e597d22cd072cbd67adb2bd87f2692e0"
+        "sha256": "62643e69fe16fc6d1a498d14e3f2fb07897491a0951278c474843994b79b0df3"
       }
     },
     {
       "name": "xlsx_set_rich_text_cell_value",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_rich_text_cell_value.schema.json",
-        "sha256": "563308df6bbfd74b3679f9d12dda4572f2ebbd2328919f26c57ba3f67f31e201"
+        "sha256": "5ec57876cda3217979d77ba9304383002830931996dd0a361a4a69147896a145"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_rich_text_cell_value.schema.json",
-        "sha256": "563308df6bbfd74b3679f9d12dda4572f2ebbd2328919f26c57ba3f67f31e201"
+        "sha256": "5ec57876cda3217979d77ba9304383002830931996dd0a361a4a69147896a145"
       }
     },
     {
       "name": "xlsx_set_row_page_breaks",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_set_row_page_breaks.schema.json",
-        "sha256": "d6ef42029c60481d58d840d3ae27f99cd7be15ad582c92d33f0dff66f04b26c3"
+        "sha256": "f912774c49e48dd797169907e72de56696fb91c5b2a9108ab16334339a0b98e6"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_set_row_page_breaks.schema.json",
-        "sha256": "d6ef42029c60481d58d840d3ae27f99cd7be15ad582c92d33f0dff66f04b26c3"
+        "sha256": "f912774c49e48dd797169907e72de56696fb91c5b2a9108ab16334339a0b98e6"
       }
     },
     {
       "name": "xlsx_validate",
       "providerContract": {
         "source": "packages/xlsx-cli/contracts/mcp-input/xlsx_validate.schema.json",
-        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
+        "sha256": "3844ee1273cd434814fb3e8eb2d4b7098342641a9ac6a6cefb35b06b67fd58ca"
       },
       "inputContract": {
         "path": "office/contracts/xlsx_validate.schema.json",
-        "sha256": "06d5f29f7ed23ab53fdf7a5de09cbfb6a800e7a19ae076a3d6d80abf22c464be"
+        "sha256": "3844ee1273cd434814fb3e8eb2d4b7098342641a9ac6a6cefb35b06b67fd58ca"
       }
     }
   ]

package/office/contracts/xlsx_convert_legacy.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS]$",
       "x-tiwater-file-role": "read"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "write"
     },
     "receiptOutput": {

package/office/contracts/xlsx_copy_row.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_delete_rows.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_expand_section_rows.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_export_json.schema.json

@@ -5,6 +5,7 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read"
     },
     "returnContent": {

package/office/contracts/xlsx_insert_rows.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_inspect.schema.json

@@ -5,6 +5,7 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]?$",
       "x-tiwater-file-role": "read"
     },
     "returnContent": {

package/office/contracts/xlsx_read_range.schema.json

@@ -6,6 +6,7 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Current XLSX workbook. Convert legacy XLS before selecting Open XML cells.",
       "x-tiwater-file-role": "read"
     },

package/office/contracts/xlsx_set_cell_number_format.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_cell_value.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_column_width.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_page_setup.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_print_area.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_range_values.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_rich_text_cell_value.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_set_row_page_breaks.schema.json

@@ -5,11 +5,13 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read", "x-tiwater-document-revision-role": "current"
     },
     "output": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "description": "Output document path; may equal input for an atomic in-place update.",
       "x-tiwater-file-role": "write"
     },

package/office/contracts/xlsx_validate.schema.json

@@ -5,6 +5,7 @@
     "input": {
       "type": "string",
       "minLength": 1,
+      "pattern": "\\.[xX][lL][sS][xX]$",
       "x-tiwater-file-role": "read"
     },
     "returnContent": {

package/office/index.mjs

@@ -488,7 +488,7 @@ const docxTableReadOutput = docxObservationOutput('docx_read_table').extend({
     retainedRowCount: z.number().int().nonnegative(),
     returnedRowCount: z.number().int().nonnegative(),
     remaining: z.number().int().nonnegative(),
-    nextContinuation: z.string().min(1).optional(),
+    nextOffset: z.number().int().nonnegative().nullable(),
     detailPageRetained: z.boolean(),
     narrowingRequired: z.boolean(),
   }).strict(),
@@ -582,7 +582,7 @@ const tools = [
   },
   {
     name: 'docx_read_table',
-    description: 'Read one explicit native DOCX table. Provide output to retain every remaining row with full paragraph and text-node detail. Set returnContent true to also receive the largest compact inline page within the response limit; these channels are independent and at least one is required. retainedRowCount counts artifact rows and returnedRowCount counts inline rows. When remaining is nonzero, continue only by passing receipt.nextContinuation unchanged in the next call; a continuation page depends on the preceding receipt and cannot be predicted or read in parallel. Match columns by gridColumnStart, not tc position. A vertical-merge restart owns one logical value; a continue cell points to verticalMergeOwner and does not repeat that value inline.',
+    description: 'Read one explicit native DOCX table. Provide output to retain every remaining row with full paragraph and text-node detail. Set returnContent true to also receive the largest compact inline page within the response limit; these channels are independent and at least one is required. retainedRowCount counts artifact rows and returnedRowCount counts inline rows. When remaining is nonzero, continue from receipt.nextOffset only when a later row is needed. Match columns by gridColumnStart, not tc position. A vertical-merge restart owns one logical value; a continue cell points to verticalMergeOwner and does not repeat that value inline.',
     inputSchema: inputContract('docx_read_table'),
     outputSchema: docxTableReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -784,7 +784,7 @@ const tools = [
   },
   {
     name: 'xlsx_read_range',
-    description: 'Read one explicit native A1 cell or rectangular range from one current XLSX worksheet. The provider chooses the bounded page size. Pages use a row-major cell offset and return physical presence, raw and formatted values, normalized value type, formula metadata, style, rich text, and merged-range ownership. The receipt always reports remaining cells and the next offset. Continue only when another selected cell is needed. Set returnContent true to return the selected page when it fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not infer regions, headers, records, field meanings, or business mappings; convert legacy XLS before reading Open XML cells.',
+    description: 'Read one explicit native A1 cell or rectangular range from one current XLSX worksheet. The provider chooses the bounded page size. Pages use a row-major cell offset and return physical presence, raw and formatted values, normalized value type, formula metadata, style, rich text, and merged-range ownership. The receipt always reports remaining cells and the next offset. Continue only when another selected cell is needed. Set returnContent true to return the largest leading cell page that fits the response limit. Provide output to store the same complete selected page as an immutable artifact. These channels are independent and may be used together; at least one is required. This tool does not infer regions, headers, records, field meanings, or business mappings; convert legacy XLS before reading Open XML cells.',
     inputSchema: inputContract('xlsx_read_range'),
     outputSchema: xlsxRangeReadOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -989,34 +989,6 @@ async function docxInspect(args) {
   };
 }
 
-function encodeTableContinuation(input, table, offset) {
-  return Buffer.from(JSON.stringify({
-    schema: 'tiwater.docx-table-continuation/v1',
-    input,
-    table,
-    offset,
-  })).toString('base64url');
-}
-
-function decodeTableContinuation(continuation, input, table) {
-  if (continuation === undefined) return 0;
-  let decoded;
-  try {
-    decoded = JSON.parse(Buffer.from(continuation, 'base64url').toString('utf8'));
-  } catch {
-    throw new Error('invalid-docx-table-continuation');
-  }
-  if (decoded?.schema !== 'tiwater.docx-table-continuation/v1'
-      || decoded.input !== input
-      || decoded.table?.part !== table?.part
-      || decoded.table?.path !== table?.path
-      || !Number.isSafeInteger(decoded.offset)
-      || decoded.offset < 0) {
-    throw new Error('invalid-docx-table-continuation');
-  }
-  return decoded.offset;
-}
-
 async function docxObservation(tool, args) {
   const input = path.resolve(requireString(args.input, 'input'));
   const delivery = resultChannels(args);
@@ -1111,7 +1083,7 @@ async function docxObservation(tool, args) {
     }
     if (tool === 'docx_read_table') {
       const totalRowCount = payload.rows.length;
-      const offset = Math.min(decodeTableContinuation(args.continuation, input, args.table), totalRowCount);
+      const offset = Math.min(args.offset ?? 0, totalRowCount);
       const selectedRows = payload.rows.slice(offset);
       const selectedNextOffset = offset + selectedRows.length < totalRowCount
         ? offset + selectedRows.length
@@ -1122,9 +1094,7 @@ async function docxObservation(tool, args) {
         retainedRowCount: selectedRows.length,
         returnedRowCount: selectedRows.length,
         remaining: totalRowCount - offset - selectedRows.length,
-        ...(selectedNextOffset === null ? {} : {
-          nextContinuation: encodeTableContinuation(input, args.table, selectedNextOffset),
-        }),
+        nextOffset: selectedNextOffset,
       };
       const detailPage = {
         schema: 'tiwater.docx-table-detail-page/v1',
@@ -1195,9 +1165,7 @@ async function docxObservation(tool, args) {
         retainedRowCount,
         returnedRowCount: rows.length,
         remaining: totalRowCount - offset - rows.length,
-        ...(inlineNextOffset === null ? {} : {
-          nextContinuation: encodeTableContinuation(input, args.table, inlineNextOffset),
-        }),
+        nextOffset: inlineNextOffset,
       };
       return {
         ...withArtifact,
@@ -1520,17 +1488,52 @@ async function xlsxExportJson(args) {
   return deliverLargeJsonResult({ tool: 'xlsx_export_json', args, runtime: commandRuntime(result), payload: result.json, sourcePaths: [input] });
 }
 
+function xlsxRangeDeliveryPage(page, returnContent) {
+  if (!returnContent || page.cells.length === 0) return page;
+  const startOffset = page.receipt.totalCellCount
+    - page.receipt.remaining
+    - page.receipt.returnedCellCount;
+  for (let count = page.cells.length; count > 0; count -= 1) {
+    const remaining = page.receipt.totalCellCount - startOffset - count;
+    const candidate = {
+      ...page,
+      receipt: {
+        ...page.receipt,
+        returnedCellCount: count,
+        remaining,
+        nextOffset: remaining > 0 ? startOffset + count : null,
+      },
+      cells: page.cells.slice(0, count),
+    };
+    if (Buffer.byteLength(JSON.stringify(candidate), 'utf8') <= returnedContentBudgetBytes) {
+      return candidate;
+    }
+  }
+  const remaining = page.receipt.totalCellCount - startOffset - 1;
+  return {
+    ...page,
+    receipt: {
+      ...page.receipt,
+      returnedCellCount: 1,
+      remaining,
+      nextOffset: remaining > 0 ? startOffset + 1 : null,
+    },
+    cells: page.cells.slice(0, 1),
+  };
+}
+
 async function xlsxReadRange(args) {
   const input = path.resolve(requireString(args.input, 'input'));
   return withTempJsonFile(args, async requestPath => {
     const result = await runJsonCandidateChain(xlsxCandidates, ['xlsx_read_range', requestPath]);
+    const page = xlsxRangeDeliveryPage(result.json, args.returnContent === true);
     return deliverLargeJsonResult({
       tool: 'xlsx_read_range',
       args,
       runtime: commandRuntime(result),
-      payload: result.json,
+      payload: page,
       sourcePaths: [input],
-      summary: result.json.receipt,
+      summary: page.receipt,
     });
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiwater/office-mcp",
-  "version": "0.21.41",
+  "version": "0.21.43",
   "description": "Published MCP distribution for independent Tiwater Office, PDF, and Text document capabilities",
   "type": "module",
   "license": "MIT",

package/pdf/contracts/tiwater-pdf-provider-contract-manifest-v1.json

@@ -2,7 +2,7 @@
   "schema": "tiwater.pdf-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.41"
+    "version": "0.21.43"
   },
   "runtime": {
     "command": "tiwater-pdf"

package/text/contracts/tiwater-text-provider-contract-manifest-v1.json

@@ -2,7 +2,7 @@
   "schema": "tiwater.text-provider-contract-manifest/v1",
   "provider": {
     "id": "@tiwater/office-mcp",
-    "version": "0.21.41"
+    "version": "0.21.43"
   },
   "tools": [
     {