@tiwater/office-mcp 0.16.13 → 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

@@ -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.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": "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,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({
@@ -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,
   };
 }
 
@@ -462,7 +446,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]);
@@ -474,7 +457,6 @@ async function docxReadObject(args) {
       revision: result.json.receipt.revision,
       object: compactDocxObjectIdentity(result.json.observation.object),
       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.13",
+  "version": "0.16.14",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",