@tiwater/office-mcp 0.16.11 → 0.16.13

package/office/contracts/docx_read_object.schema.json

@@ -17,6 +17,24 @@
       "type": "string",
       "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
     },
+    "kinds": {
+      "description": "Object kinds required by the next operation. The response returns only matching descendant identities; the artifact retains the complete object.",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "paragraph",
+          "table",
+          "gridColumn",
+          "row",
+          "cell",
+          "run",
+          "text",
+          "drawing"
+        ]
+      },
+      "minItems": 1
+    },
     "output": {
       "type": "string",
       "minLength": 1,
@@ -27,6 +45,7 @@
   "required": [
     "input",
     "ref",
+    "kinds",
     "output"
   ],
   "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.11"
+    "version": "0.16.13"
   },
   "tools": [
     {
@@ -119,11 +119,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
+        "sha256": "d75d81f6ec62ed40e6116beacc1860b692e0307dc0da09f05599511816aa38ab"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
+        "sha256": "d75d81f6ec62ed40e6116beacc1860b692e0307dc0da09f05599511816aa38ab"
       }
     },
     {

package/office/index.mjs

@@ -199,7 +199,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX object. The response returns that object and every descendant identity for the next operation; full Open XML remains in the evidence artifact.',
+    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.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -214,14 +214,14 @@ const tools = [
   },
   {
     name: 'docx_copy_table_rows',
-    description: 'Create a new DOCX by replacing selected target table row ranges with selected source rows, using explicit source-to-target header cell mappings while retaining target presentation.',
+    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.',
     inputSchema: inputContract('docx_copy_table_rows'),
     outputSchema: fixedEditOutput('docx_copy_table_rows'),
     handler: args => fixedEdit('docx_copy_table_rows', args),
   },
   {
     name: 'docx_copy_object',
-    description: 'Create a new output by copying targetDocument and applying one or more selected-object insertions under selected target parent objects.',
+    description: 'Insert selected objects only when the target needs a new object under an existing parent. Do not use this to populate or replace rows in an existing target table; use docx_copy_table_rows instead.',
     inputSchema: inputContract('docx_copy_object'),
     outputSchema: fixedEditOutput('docx_copy_object'),
     handler: args => fixedEdit('docx_copy_object', args),
@@ -462,6 +462,7 @@ async function docxObservation(tool, args) {
 async function docxReadObject(args) {
   const input = path.resolve(requireString(args.input, 'input'));
   const output = requireString(args.output, 'output');
+  const kinds = new Set(args.kinds);
   const { output: _output, ...request } = args;
   return withTempJsonFile(request, async requestPath => {
     const result = await runJsonCandidateChain(docxCandidates, ['docx_read_object', requestPath]);
@@ -472,7 +473,9 @@ 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),
+      descendants: result.json.observation.descendants
+        .filter(identity => kinds.has(identity.kind))
+        .map(compactDocxObjectIdentity),
     };
   });
 }

package/package.json

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