@tiwater/office-mcp 0.16.8 → 0.16.10

package/office/README.md

@@ -43,10 +43,12 @@ DOCX mutations accept revision-bound native object references. Physical table,
 row, column, paragraph, run, drawing, and body indexes are not public mutation
 addresses.
 
-`docx_inspect_tables` preserves the v1 body `Tables` view and additively exposes
-header/footer topology in `StoryTables`. Header/footer tables carry part
-coordinates plus section/reference bindings, and only supported direct-story
-tables expose mutation addresses.
+Table-row copying is a distinct bulk table responsibility: the caller selects
+current source and target tables, bounded row regions, excluded source rows,
+and source/target columns. The provider expands the target region, preserves
+target presentation, carries selected source paragraph content, and reproduces
+the selected source row order and merge topology. It does not infer business
+identity, language, row scope, or column meaning.
 
 The catalog is intentionally open to new generic document capabilities, but a
 specific workflow, template, customer, issue, input document, or model

package/office/contracts/docx_copy_table_rows.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tiwater.office-mcp-input/docx_copy_table_rows",
+  "type": "object",
+  "properties": {
+    "targetDocument": {
+      "type": "object",
+      "properties": {
+        "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read" },
+        "revision": { "type": "string", "pattern": "^docx-rev-v1-[0-9a-f]{64}$" }
+      },
+      "required": ["input", "revision"],
+      "additionalProperties": false
+    },
+    "changes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "targetTableRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+          "targetRows": {
+            "type": "object",
+            "properties": {
+              "firstRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+              "lastRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" }
+            },
+            "required": ["firstRef", "lastRef"],
+            "additionalProperties": false
+          },
+          "sourceDocument": {
+            "type": "object",
+            "properties": {
+              "input": { "type": "string", "minLength": 1, "x-tiwater-file-role": "read" },
+              "revision": { "type": "string", "pattern": "^docx-rev-v1-[0-9a-f]{64}$" }
+            },
+            "required": ["input", "revision"],
+            "additionalProperties": false
+          },
+          "sourceTableRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
+          "sourceRows": {
+            "type": "object",
+            "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}$" }
+              }
+            },
+            "required": ["firstRef", "lastRef"],
+            "additionalProperties": false
+          },
+          "columns": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "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"] }
+              },
+              "required": ["sourceHeaderRef", "targetHeaderRef", "content"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["targetTableRef", "targetRows", "sourceDocument", "sourceTableRef", "sourceRows", "columns"],
+        "additionalProperties": false
+      }
+    },
+    "output": { "type": "string", "minLength": 1, "x-tiwater-file-role": "write" },
+    "receiptOutput": {
+      "type": "string",
+      "minLength": 1,
+      "x-tiwater-file-role": "write",
+      "x-tiwater-file-effect": false
+    }
+  },
+  "required": ["targetDocument", "changes", "output", "receiptOutput"],
+  "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.8"
+    "version": "0.16.10"
   },
   "tools": [
     {
@@ -38,6 +38,17 @@
         "sha256": "5f0bfc826d68f451055aba20390686e0e0df2182797fc36ff285f42d09084104"
       }
     },
+    {
+      "name": "docx_copy_table_rows",
+      "providerContract": {
+        "source": "packages/docx-cli/contracts/mcp-input/docx_copy_table_rows.schema.json",
+        "sha256": "1698ca119543d17b954ce1cfeaf31f536a98da23cc90c9120cfd3d1d74093706"
+      },
+      "inputContract": {
+        "path": "office/contracts/docx_copy_table_rows.schema.json",
+        "sha256": "1698ca119543d17b954ce1cfeaf31f536a98da23cc90c9120cfd3d1d74093706"
+      }
+    },
     {
       "name": "docx_delete_object",
       "providerContract": {
@@ -82,17 +93,6 @@
         "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       }
     },
-    {
-      "name": "docx_inspect_tables",
-      "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_inspect_tables.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
-      },
-      "inputContract": {
-        "path": "office/contracts/docx_inspect_tables.schema.json",
-        "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
-      }
-    },
     {
       "name": "docx_list_objects",
       "providerContract": {

package/office/index.mjs

@@ -183,14 +183,6 @@ const tools = [
     outputSchema: docxInspectionOutput('docx_inspect'),
     handler: docxInspect,
   },
-  {
-    name: 'docx_inspect_tables',
-    description: 'Inspect current DOCX tables. The response returns the revision and a bounded table identity index; the complete table observation remains in the evidence artifact.',
-    inputSchema: inputContract('docx_inspect_tables'),
-    outputSchema: docxInspectionOutput('docx_inspect_tables'),
-    annotations: { readOnlyHint: true, idempotentHint: true },
-    handler: docxInspectTables,
-  },
   {
     name: 'docx_list_objects',
     description: 'List one small page of revision-bound DOCX object identities for structure discovery, not selection by text. To select a table or row by any descendant cell text, call docx_find_literal with kind table or row instead of listing the document. After selecting a table or row, call docx_read_object once to obtain every descendant ref; do not list its rows and cells separately. Use parentRef only when nearest-child paging itself is the requested observation.',
@@ -220,6 +212,13 @@ const tools = [
     outputSchema: fixedEditOutput('docx_copy_content'),
     handler: args => fixedEdit('docx_copy_content', args),
   },
+  {
+    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.',
+    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.',
@@ -453,18 +452,6 @@ async function docxInspect(args) {
   };
 }
 
-async function docxInspectTables(args) {
-  const input = path.resolve(requireString(args.input, 'input'));
-  const result = await runJsonCandidateChain(docxCandidates, ['inspect-tables', input, '--json']);
-  return {
-    tool: 'docx_inspect_tables',
-    runtime: commandRuntime(result),
-    source: await fileArtifact(input),
-    artifact: await writeJsonArtifact(requireString(args.output, 'output'), result.json),
-    ...compactDocxTableIndex(result.json),
-  };
-}
-
 async function docxObservation(tool, args) {
   return withTempJsonFile(args, async requestPath => {
     const result = await runJsonCandidateChain(docxCandidates, [tool, requestPath]);

package/package.json

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

package/office/contracts/docx_inspect_tables.schema.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "New JSON artifact path. Existing files are never overwritten.",
-      "x-tiwater-file-role": "write"
-    }
-  },
-  "required": [
-    "input",
-    "output"
-  ],
-  "additionalProperties": false
-}