@tiwater/office-mcp 0.16.13 → 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. Do not begin on an unlabeled continuation row from an excluded business group. 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/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. The response returns only matching descendant identities; the artifact retains the complete object.",
+      "description": "Object kinds required by the next operation. Both the response and artifact contain only matching descendant identities.",
       "type": "array",
       "items": {
         "type": "string",
@@ -38,7 +38,7 @@
     "output": {
       "type": "string",
       "minLength": 1,
-      "description": "Absolute path for a new JSON artifact containing the complete native object observation.",
+      "description": "Absolute path for a new JSON artifact containing the selected native object and only the requested descendant kinds.",
       "x-tiwater-file-role": "write"
     }
   },

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.13"
+    "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": "f24924a80de9d9cfe619c9b4f6475d370c75fe221dcbe3af9692ad15c648d3b0"
+        "sha256": "17fafe8f67129220479cf39ae058c669e2b55958122c4286ce7128d7f7a0cb7d"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_rows.schema.json",
-        "sha256": "f24924a80de9d9cfe619c9b4f6475d370c75fe221dcbe3af9692ad15c648d3b0"
+        "sha256": "17fafe8f67129220479cf39ae058c669e2b55958122c4286ce7128d7f7a0cb7d"
       }
     },
     {
@@ -119,11 +119,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "d75d81f6ec62ed40e6116beacc1860b692e0307dc0da09f05599511816aa38ab"
+        "sha256": "9b78138005fc6f875cf9ed530b8389ec4b2a751294c9d316e8b9fc2463560a3f"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "d75d81f6ec62ed40e6116beacc1860b692e0307dc0da09f05599511816aa38ab"
+        "sha256": "9b78138005fc6f875cf9ed530b8389ec4b2a751294c9d316e8b9fc2463560a3f"
       }
     },
     {

package/office/index.mjs

@@ -145,10 +145,9 @@ const docxRevision = z.object({
 
 const docxTableIndexEntry = z.object({
   ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
-  tableIndex: z.number().int().nonnegative(),
-  containmentPath: z.array(z.string()),
-  parentCellAddress: z.string().nullable(),
-  storyKind: z.string(),
+  parentRef: z.string().regex(/^dox1_[0-9a-f]{64}$/).nullable(),
+  storyPart: z.string(),
+  nativePath: z.string(),
   rowCount: z.number().int().nonnegative(),
   columnCount: z.number().int().nonnegative(),
   textPreview: z.string(),
@@ -167,12 +166,19 @@ const docxObjectIdentity = z.object({
   parentRef: z.string().regex(/^dox1_[0-9a-f]{64}$/).nullable(),
   kind: z.string(),
   textPreview: z.string().nullable(),
+  gridSpan: z.number().int().positive().nullable(),
+  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 = [
@@ -181,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,
   },
   {
@@ -199,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 },
@@ -406,29 +413,10 @@ function buildServer() {
 }
 
 function compactDocxTableIndex(report) {
-  if (!report?.Revision || !Array.isArray(report.Tables)
-      || (report.StoryTables !== null && !Array.isArray(report.StoryTables))) {
+  if (!report?.revision || !Array.isArray(report.tables)) {
     throw new Error('docx-table-inspection-result-invalid');
   }
-  const tables = [...report.Tables, ...(report.StoryTables ?? [])].map(table => {
-    const text = table.Rows.flatMap(row => row.Cells.map(cell => cell.Text))
-      .filter(value => typeof value === 'string' && value.length > 0)
-      .join(' ')
-      .replace(/\s+/gu, ' ')
-      .trim();
-    return {
-      ref: table.Ref,
-      tableIndex: table.TableIndex,
-      containmentPath: table.ContainmentPath,
-      parentCellAddress: table.ParentCellAddress ?? null,
-      storyKind: table.Story.Kind,
-      rowCount: table.RowCount,
-      columnCount: table.ColumnCount,
-      textPreview: text.length <= 160 ? text : `${text.slice(0, 160)}...`,
-      textLength: text.length,
-    };
-  });
-  return { revision: report.Revision, tables };
+  return { revision: report.revision, tables: report.tables };
 }
 
 function compactDocxObjectIdentity(object) {
@@ -437,6 +425,8 @@ function compactDocxObjectIdentity(object) {
     parentRef: object.parentRef,
     kind: object.kind,
     textPreview: object.textPreview,
+    gridSpan: object.gridSpan,
+    verticalMerge: object.verticalMerge,
   };
 }
 
@@ -462,7 +452,6 @@ 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]);
@@ -473,13 +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
-        .filter(identity => kinds.has(identity.kind))
-        .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.13",
+  "version": "0.16.15",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",