@tiwater/office-mcp 0.16.14 → 0.16.15

package/office/contracts/docx_copy_table_rows.schema.json

@@ -41,14 +41,10 @@
           "sourceTableRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
       "sourceRows": {
         "type": "object",
-      "description": "Contiguous source business-row range. excludeRefs contains every physical row to remove; excluding a vertically merged group requires its restart row and all continuation rows. Do not begin on an unlabeled continuation row. If another column's visible merge began before the range, the provider carries its origin value into a new merge start.",
+      "description": "Exact contiguous source rows to copy. Select only wanted rows; the range cannot begin or end inside a vertical merge.",
             "properties": {
               "firstRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
-              "lastRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
-              "excludeRefs": {
-                "type": "array",
-                "items": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" }
-              }
+              "lastRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" }
             },
             "required": ["firstRef", "lastRef"],
             "additionalProperties": false

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.16.14"
+    "version": "0.16.15"
   },
   "tools": [
     {
@@ -42,11 +42,11 @@
       "name": "docx_copy_table_rows",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_table_rows.schema.json",
-        "sha256": "2b6ba0a54290ab8671f1f5547850bb37370655f05170f6dcaffa9586e9f409f2"
+        "sha256": "17fafe8f67129220479cf39ae058c669e2b55958122c4286ce7128d7f7a0cb7d"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_rows.schema.json",
-        "sha256": "2b6ba0a54290ab8671f1f5547850bb37370655f05170f6dcaffa9586e9f409f2"
+        "sha256": "17fafe8f67129220479cf39ae058c669e2b55958122c4286ce7128d7f7a0cb7d"
       }
     },
     {

package/office/index.mjs

@@ -170,10 +170,15 @@ const docxObjectIdentity = z.object({
   verticalMerge: z.string().nullable(),
 }).strict();
 
+const docxObjectNode = z.lazy(() => z.object({
+  object: docxObjectIdentity,
+  children: z.array(docxObjectNode),
+}).strict());
+
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   revision: docxRevision,
   object: docxObjectIdentity,
-  descendants: z.array(docxObjectIdentity),
+  children: z.array(docxObjectNode),
 }).strict();
 
 const tools = [
@@ -182,6 +187,7 @@ const tools = [
     description: 'Inspect one current DOCX. The response returns its revision and a bounded table identity index for the next selection; the complete observation remains in the evidence artifact.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: docxInspect,
   },
   {
@@ -200,7 +206,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX object. Declare only the descendant kinds required by the next operation; the response returns those identities and the evidence artifact retains the complete object.',
+    description: 'Read one selected native DOCX object as an ordered native hierarchy. For a table, request row and cell kinds once; each row contains its ordered cells with text, grid span, and vertical merge state.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -456,12 +462,18 @@ async function docxReadObject(args) {
       artifact: await writeJsonArtifact(output, result.json),
       revision: result.json.receipt.revision,
       object: compactDocxObjectIdentity(result.json.observation.object),
-      descendants: result.json.observation.descendants
-        .map(compactDocxObjectIdentity),
+      children: result.json.observation.children.map(compactDocxObjectNode),
     };
   });
 }
 
+function compactDocxObjectNode(node) {
+  return {
+    object: compactDocxObjectIdentity(node.object),
+    children: node.children.map(compactDocxObjectNode),
+  };
+}
+
 async function docxValidate(args) {
   const result = await runJsonCandidateChain(docxCandidates, ['validate-openxml', requireString(args.input, 'input')], { allowedExitCodes: [0, 1] });
   return { tool: 'docx_validate', runtime: commandRuntime(result), result: result.json };

package/package.json

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