@tiwater/office-mcp 0.16.14 → 0.16.16

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
@@ -62,7 +58,11 @@
               "properties": {
                 "sourceHeaderRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
                 "targetHeaderRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
-                "content": { "type": "string", "enum": ["all-paragraphs", "first-paragraph"] }
+                "content": {
+                  "type": "string",
+                  "enum": ["all-paragraphs", "first-paragraph"],
+                  "description": "Content copied from each mapped source cell. all-paragraphs preserves every source paragraph in order. first-paragraph copies only the first source paragraph. Before choosing first-paragraph, read the selected source table with docx_read_object kinds row, cell, and paragraph to prove later paragraphs are intentionally omitted."
+                }
               },
               "required": ["sourceHeaderRef", "targetHeaderRef", "content"],
               "additionalProperties": false

package/office/contracts/docx_read_object.schema.json

@@ -18,7 +18,7 @@
       "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
     },
     "kinds": {
-      "description": "Object kinds required by the next operation. Both the response and artifact contain only matching descendant identities.",
+      "description": "Object kinds required by the next operation. Both the response and artifact contain only matching descendant identities. Include paragraph whenever paragraph boundaries affect a later content selection such as docx_copy_table_rows first-paragraph versus all-paragraphs.",
       "type": "array",
       "items": {
         "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.16.14"
+    "version": "0.16.16"
   },
   "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": "a246ed7a97fce47ab0cde6f6ad9c97a2936a775d8b390b4ad807c1dff5720fb7"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_rows.schema.json",
-        "sha256": "2b6ba0a54290ab8671f1f5547850bb37370655f05170f6dcaffa9586e9f409f2"
+        "sha256": "a246ed7a97fce47ab0cde6f6ad9c97a2936a775d8b390b4ad807c1dff5720fb7"
       }
     },
     {
@@ -119,11 +119,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "9b78138005fc6f875cf9ed530b8389ec4b2a751294c9d316e8b9fc2463560a3f"
+        "sha256": "29ba026050f1120219491f918e74c344551224795b1d15e49ec886d4e81e092a"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "9b78138005fc6f875cf9ed530b8389ec4b2a751294c9d316e8b9fc2463560a3f"
+        "sha256": "29ba026050f1120219491f918e74c344551224795b1d15e49ec886d4e81e092a"
       }
     },
     {

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. Also request paragraph when paragraph boundaries determine what a later copy operation must retain.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -215,7 +221,7 @@ const tools = [
   },
   {
     name: 'docx_copy_table_rows',
-    description: 'Populate existing target tables by replacing selected data-row ranges with selected source rows. Use this whenever the target table already exists; explicit header-cell mappings preserve target presentation and native source grouping even when source and target grid spans differ.',
+    description: 'Populate existing target tables by replacing selected data-row ranges with selected source rows. Use this whenever the target table already exists; explicit header-cell mappings preserve target presentation and native source grouping even when source and target grid spans differ. Each column must explicitly copy all source-cell paragraphs or only the first; inspect paragraph children before choosing.',
     inputSchema: inputContract('docx_copy_table_rows'),
     outputSchema: fixedEditOutput('docx_copy_table_rows'),
     handler: args => fixedEdit('docx_copy_table_rows', args),
@@ -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.16",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",