@tiwater/office-mcp 0.16.16 → 0.16.18

package/office/contracts/docx_copy_content.schema.json

@@ -18,7 +18,11 @@
       "items": {
         "type": "object",
         "properties": {
-          "targetRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+          "targetRef": {
+            "type": "string",
+            "pattern": "^dox1_[0-9a-f]{64}$",
+            "description": "Target cell ref whose content is replaced while its cell formatting is retained."
+          },
           "sourceDocument": {
             "type": "object",
             "properties": {
@@ -31,12 +35,18 @@
           "sourceSelections": {
             "type": "array",
             "minItems": 1,
+            "description": "Ordered source content copied into the target cell. Select a whole observed object by ref alone, or select an exact substring by adding range to an observed run or text ref. Multiple selections are copied in this array order.",
             "items": {
               "type": "object",
               "properties": {
-                "ref": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+                "ref": {
+                  "type": "string",
+                  "pattern": "^dox1_[0-9a-f]{64}$",
+                  "description": "Observed source object ref. When range is present this must be a run or text ref, not a paragraph, cell, row, or table ref."
+                },
                 "range": {
                   "type": "object",
+                  "description": "Zero-based substring within the selected run or text object. Omit range to copy the whole selected object.",
                   "properties": {
                     "start": { "type": "integer", "minimum": 0, "maximum": 2147483647 },
                     "length": { "type": "integer", "exclusiveMinimum": 0, "maximum": 2147483647 }

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.16"
+    "version": "0.16.18"
   },
   "tools": [
     {
@@ -20,11 +20,11 @@
       "name": "docx_copy_content",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_copy_content.schema.json",
-        "sha256": "f85a71fa40cc378b007baf36c76b1a114a046ef6810f3933614f8683749d1cc1"
+        "sha256": "27110c4590087bb38bd08f77ab2dc19a62407a836f58a603d222ebdb184c97b6"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_content.schema.json",
-        "sha256": "f85a71fa40cc378b007baf36c76b1a114a046ef6810f3933614f8683749d1cc1"
+        "sha256": "27110c4590087bb38bd08f77ab2dc19a62407a836f58a603d222ebdb184c97b6"
       }
     },
     {

package/office/index.mjs

@@ -170,15 +170,9 @@ 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,
-  children: z.array(docxObjectNode),
 }).strict();
 
 const tools = [
@@ -206,7 +200,7 @@ const tools = [
   },
   {
     name: 'docx_read_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.',
+    description: 'Read one selected native DOCX object as an ordered native hierarchy written to the requested output artifact. The tool response only identifies that artifact and the selected root object; read the artifact for descendant refs and content. 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 },
@@ -214,7 +208,7 @@ const tools = [
   },
   {
     name: 'docx_copy_content',
-    description: 'Create a new output by copying targetDocument and applying one or more content changes to selected target cells, retaining target cell formatting and source inline meaning.',
+    description: 'Replace content in existing target cells while retaining target cell formatting and source inline meaning. Use this directly or after docx_copy_table_rows when a target cell needs an exact observed subset of source content. A source selection copies a whole object by ref, or an exact substring when range is attached to a run or text ref.',
     inputSchema: inputContract('docx_copy_content'),
     outputSchema: fixedEditOutput('docx_copy_content'),
     handler: args => fixedEdit('docx_copy_content', args),
@@ -462,18 +456,10 @@ async function docxReadObject(args) {
       artifact: await writeJsonArtifact(output, result.json),
       revision: result.json.receipt.revision,
       object: compactDocxObjectIdentity(result.json.observation.object),
-      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.16",
+  "version": "0.16.18",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",