@tiwater/office-mcp 0.17.6 → 0.17.8

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.17.6"
+    "version": "0.17.8"
   },
   "tools": [
     {

package/office/index.mjs

@@ -173,7 +173,10 @@ function docxInspectionOutput(tool) {
     revision: docxRevision,
     summary: z.object({
       tableCount: z.number().int().nonnegative(),
-      openingText: z.array(z.string().min(1).max(240)).max(6),
+      openingParagraphs: z.array(z.object({
+        ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
+        textPreview: z.string().min(1).max(240),
+      }).strict()).max(6),
     }).strict(),
   }).strict();
 }
@@ -187,6 +190,19 @@ const docxObjectIdentity = z.object({
   verticalMerge: z.string().nullable(),
 }).strict();
 
+const docxNestedObjectIdentity = docxObjectIdentity.pick({
+  ref: true,
+  kind: true,
+  textPreview: true,
+}).extend({
+  gridSpan: z.number().int().positive().optional(),
+  verticalMerge: z.string().optional(),
+}).strict();
+const docxObservationNode = z.lazy(() => z.object({
+  object: docxNestedObjectIdentity,
+  children: z.array(docxObservationNode).optional(),
+}).strict());
+
 const docxObservationReceipt = z.object({
   schema: z.literal('tiwater.docx-observation-receipt/v1'),
   operation: z.enum(['list', 'find', 'read']),
@@ -219,14 +235,13 @@ const docxFindLiteralOutput = z.object({
 
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   revision: docxRevision,
-  object: docxObjectIdentity,
-  objects: z.array(docxObjectIdentity).min(1),
+  observation: docxObservationNode,
 }).strict();
 
 const tools = [
   {
     name: 'docx_inspect',
-    description: 'Inspect one current DOCX. The response returns its revision, table count, and a bounded sample of its opening non-empty paragraphs for document identification; use paged docx_find_literal or docx_list_objects to select native objects. The complete inspection remains in the evidence artifact.',
+    description: 'Inspect one current DOCX. The response returns its revision, table count, and up to six opening non-empty body paragraphs with native refs for document identification and immediate reuse; use docx_find_literal for other text and docx_list_objects for container children. The complete inspection remains in the evidence artifact.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -493,13 +508,18 @@ function compactDocxInspection(report) {
   if (!report?.tables?.revision || !Array.isArray(report.tables.tables) || !Array.isArray(report.flow)) {
     throw new Error('docx-table-inspection-result-invalid');
   }
-  const openingText = report.flow
-    .filter(item => item?.type === 'paragraph' && typeof item.text === 'string' && item.text.trim())
+  const openingParagraphs = report.flow
+    .filter(item => item?.type === 'paragraph'
+      && /^dox1_[0-9a-f]{64}$/u.test(item.objectRef)
+      && typeof item.text === 'string' && item.text.trim())
     .slice(0, 6)
-    .map(item => item.text.trim().replace(/\s+/gu, ' ').slice(0, 240));
+    .map(item => ({
+      ref: item.objectRef,
+      textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
+    }));
   return {
     revision: report.tables.revision,
-    summary: { tableCount: report.tables.tables.length, openingText },
+    summary: { tableCount: report.tables.tables.length, openingParagraphs },
   };
 }
 
@@ -514,15 +534,24 @@ function compactDocxObjectIdentity(object) {
   };
 }
 
-function compactDocxObservationObjects(observation) {
-  const objects = [];
-  function visit(node) {
-    if (!node?.object) return;
-    objects.push(compactDocxObjectIdentity(node.object));
-    for (const child of node.children ?? []) visit(child);
+function compactDocxObservation(observation) {
+  if (!observation?.object) throw new Error('docx-read-object-missing-observation');
+  function compactNode(node) {
+    const identity = compactDocxObjectIdentity(node.object);
+    const object = {
+      ref: identity.ref,
+      kind: identity.kind,
+      textPreview: identity.textPreview,
+      ...(identity.gridSpan === null ? {} : { gridSpan: identity.gridSpan }),
+      ...(identity.verticalMerge === null ? {} : { verticalMerge: identity.verticalMerge }),
+    };
+    const children = (node.children ?? []).map(compactNode);
+    return {
+      object,
+      ...(children.length === 0 ? {} : { children }),
+    };
   }
-  visit(observation);
-  return objects;
+  return compactNode(observation);
 }
 
 async function docxInspect(args) {
@@ -569,8 +598,7 @@ async function docxReadObject(args) {
       source: await fileArtifact(input),
       artifact: await writeJsonArtifact(output, result.json),
       revision: result.json.receipt.revision,
-      object: compactDocxObjectIdentity(result.json.observation.object),
-      objects: compactDocxObservationObjects(result.json.observation),
+      observation: compactDocxObservation(result.json.observation),
     };
   });
 }

package/package.json

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