@tiwater/office-mcp 0.17.3 → 0.17.5

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

package/office/index.mjs

@@ -168,21 +168,12 @@ const docxRevision = z.object({
   toolVersion: z.string(),
 }).strict();
 
-const docxTableIndexEntry = z.object({
-  ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
-  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(),
-  textLength: z.number().int().nonnegative(),
-}).strict();
-
 function docxInspectionOutput(tool) {
   return artifactOutput(tool).extend({
     revision: docxRevision,
-    tables: z.array(docxTableIndexEntry),
+    summary: z.object({
+      tableCount: z.number().int().nonnegative(),
+    }).strict(),
   }).strict();
 }
 
@@ -195,6 +186,36 @@ const docxObjectIdentity = z.object({
   verticalMerge: z.string().nullable(),
 }).strict();
 
+const docxObservationReceipt = z.object({
+  schema: z.literal('tiwater.docx-observation-receipt/v1'),
+  operation: z.enum(['list', 'find', 'read']),
+  revision: docxRevision,
+  totalCount: z.number().int().nonnegative(),
+  returnedCount: z.number().int().nonnegative(),
+  remaining: z.number().int().nonnegative(),
+  continuation: z.string().nullable(),
+}).strict();
+
+const docxListObjectsOutput = z.object({
+  schema: z.literal('tiwater.docx-observation-list/v1'),
+  receipt: docxObservationReceipt,
+  objects: z.array(docxObjectIdentity),
+  runtime: runtimeIdentity,
+}).strict();
+
+const docxFindLiteralOutput = z.object({
+  schema: z.literal('tiwater.docx-observation-find/v1'),
+  receipt: docxObservationReceipt,
+  matches: z.array(z.object({
+    object: docxObjectIdentity,
+    matches: z.array(z.object({
+      offset: z.number().int().nonnegative(),
+      length: z.number().int().positive(),
+    }).strict()),
+  }).strict()),
+  runtime: runtimeIdentity,
+}).strict();
+
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   revision: docxRevision,
   object: docxObjectIdentity,
@@ -204,7 +225,7 @@ const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
 const tools = [
   {
     name: 'docx_inspect',
-    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.',
+    description: 'Inspect one current DOCX. The response returns its revision and table count; use paged docx_find_literal or docx_list_objects to select native objects. The complete inspection remains in the evidence artifact.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -214,6 +235,7 @@ const tools = [
     name: 'docx_list_objects',
     description: 'List one small page of revision-bound nearest-child identities. Use parentRef to restrict any container, such as body paragraphs, table rows, or row cells; use docx_find_literal when selecting by text.',
     inputSchema: inputContract('docx_list_objects'),
+    outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
@@ -221,6 +243,7 @@ const tools = [
     name: 'docx_find_literal',
     description: 'Find exact current text in one small page of revision-bound native DOCX objects. With kind table or row, matching includes descendant cell text.',
     inputSchema: inputContract('docx_find_literal'),
+    outputSchema: docxFindLiteralOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_find_literal', args),
   },
@@ -465,11 +488,11 @@ function buildServer() {
   return server;
 }
 
-function compactDocxTableIndex(report) {
+function compactDocxInspection(report) {
   if (!report?.revision || !Array.isArray(report.tables)) {
     throw new Error('docx-table-inspection-result-invalid');
   }
-  return { revision: report.revision, tables: report.tables };
+  return { revision: report.revision, summary: { tableCount: report.tables.length } };
 }
 
 function compactDocxObjectIdentity(object) {
@@ -502,14 +525,27 @@ async function docxInspect(args) {
     runtime: commandRuntime(result),
     source: await fileArtifact(input),
     artifact: await writeJsonArtifact(requireString(args.output, 'output'), result.json),
-    ...compactDocxTableIndex(result.json.tables),
+    ...compactDocxInspection(result.json.tables),
   };
 }
 
 async function docxObservation(tool, args) {
   return withTempJsonFile(args, async requestPath => {
     const result = await runJsonCandidateChain(docxCandidates, [tool, requestPath]);
-    return { ...result.json, runtime: commandRuntime(result) };
+    const payload = { ...result.json, runtime: commandRuntime(result) };
+    if (tool === 'docx_list_objects') {
+      return { ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
+    }
+    if (tool === 'docx_find_literal') {
+      return {
+        ...payload,
+        matches: payload.matches.map(match => ({
+          object: compactDocxObjectIdentity(match.object),
+          matches: match.matches,
+        })),
+      };
+    }
+    throw new Error(`unsupported-docx-observation-tool:${tool}`);
   });
 }
 

package/package.json

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