@tiwater/office-mcp 0.16.12 → 0.16.14

package/office/contracts/docx_copy_table_rows.schema.json

@@ -41,7 +41,7 @@
           "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": "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.",
             "properties": {
               "firstRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },
               "lastRef": { "type": "string", "pattern": "^dox1_[0-9a-f]{64}$" },

package/office/contracts/docx_read_object.schema.json

@@ -17,16 +17,35 @@
       "type": "string",
       "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.",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "paragraph",
+          "table",
+          "gridColumn",
+          "row",
+          "cell",
+          "run",
+          "text",
+          "drawing"
+        ]
+      },
+      "minItems": 1
+    },
     "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"
     }
   },
   "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.12"
+    "version": "0.16.14"
   },
   "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": "2b6ba0a54290ab8671f1f5547850bb37370655f05170f6dcaffa9586e9f409f2"
       },
       "inputContract": {
         "path": "office/contracts/docx_copy_table_rows.schema.json",
-        "sha256": "f24924a80de9d9cfe619c9b4f6475d370c75fe221dcbe3af9692ad15c648d3b0"
+        "sha256": "2b6ba0a54290ab8671f1f5547850bb37370655f05170f6dcaffa9586e9f409f2"
       }
     },
     {
@@ -119,11 +119,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
+        "sha256": "9b78138005fc6f875cf9ed530b8389ec4b2a751294c9d316e8b9fc2463560a3f"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
+        "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,6 +166,8 @@ 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 docxReadObjectOutput = artifactOutput('docx_read_object').extend({
@@ -199,7 +200,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 },
@@ -406,29 +407,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 +419,8 @@ function compactDocxObjectIdentity(object) {
     parentRef: object.parentRef,
     kind: object.kind,
     textPreview: object.textPreview,
+    gridSpan: object.gridSpan,
+    verticalMerge: object.verticalMerge,
   };
 }
 
@@ -472,7 +456,8 @@ 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
+        .map(compactDocxObjectIdentity),
     };
   });
 }

package/package.json

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