@tiwater/office-mcp 0.17.28 → 0.17.30

package/office/contracts/docx_list_objects.schema.json

@@ -8,7 +8,7 @@
       "x-tiwater-file-role": "read"
     },
     "kinds": {
-      "description": "Open XML object kinds to list in native document order. Request paragraph and table together when their adjacency carries meaning. Returned parentRef is the valid targetParentRef for inserting beside that object.",
+      "description": "Open XML object kinds to list in native document order. Start at the selected story part, then follow returned refs through parentRef-scoped child pages. Request paragraph and table together when their adjacency carries meaning. Text previews describe already located objects; they do not identify a document or select a source. Returned parentRef is the valid targetParentRef for inserting beside that object.",
       "type": "array",
       "items": {
         "type": "string",
@@ -36,7 +36,7 @@
       "pattern": "^dox1_[0-9a-f]{64}$"
     },
     "limit": {
-      "description": "Maximum identities in this small page. Follow continuation only when the same structural inventory is required; use docx_find_literal instead of paging through paragraphs for content.",
+      "description": "Maximum identities in this small page. Follow continuation in native order when the same structural inventory is required, then use returned refs to descend into the selected object.",
       "default": 50,
       "type": "integer",
       "minimum": 1,

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.28"
+    "version": "0.17.30"
   },
   "tools": [
     {
@@ -82,17 +82,6 @@
         "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
       }
     },
-    {
-      "name": "docx_find_literal",
-      "providerContract": {
-        "source": "packages/docx-cli/contracts/mcp-input/docx_find_literal.schema.json",
-        "sha256": "4b063c8a4c683c1d7eb06ce1feec8e51546dca78759151ff654f41d45a17d64c"
-      },
-      "inputContract": {
-        "path": "office/contracts/docx_find_literal.schema.json",
-        "sha256": "4b063c8a4c683c1d7eb06ce1feec8e51546dca78759151ff654f41d45a17d64c"
-      }
-    },
     {
       "name": "docx_inspect",
       "providerContract": {
@@ -108,11 +97,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "c1a0742b914608044ba017c9bf968fe59f0864761ea54be6c31c9679c69085a3"
+        "sha256": "418e758c979a0a7dc8b7401091ac92efcf7ea53b77ceb263746588fcd546a0c8"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "c1a0742b914608044ba017c9bf968fe59f0864761ea54be6c31c9679c69085a3"
+        "sha256": "418e758c979a0a7dc8b7401091ac92efcf7ea53b77ceb263746588fcd546a0c8"
       }
     },
     {

package/office/index.mjs

@@ -173,17 +173,6 @@ function docxInspectionOutput(tool) {
     revision: docxRevision,
     summary: z.object({
       tableCount: z.number().int().nonnegative(),
-      tables: z.array(z.object({
-        ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
-        parentRef: z.string().regex(/^dox1_[0-9a-f]{64}$/).nullable(),
-        rowCount: z.number().int().nonnegative(),
-        columnCount: z.number().int().nonnegative(),
-        textPreview: z.string().max(240),
-        contextBefore: z.array(z.object({
-          ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
-          textPreview: z.string().min(1).max(240),
-        }).strict()).max(3),
-      }).strict()),
       openingParagraphs: z.array(z.object({
         ref: z.string().regex(/^dox1_[0-9a-f]{64}$/),
         textPreview: z.string().min(1).max(240),
@@ -216,7 +205,7 @@ const docxObservationNode = z.lazy(() => z.object({
 
 const docxObservationReceipt = z.object({
   schema: z.literal('tiwater.docx-observation-receipt/v1'),
-  operation: z.enum(['list', 'find', 'read']),
+  operation: z.literal('list'),
   revision: docxRevision,
   totalCount: z.number().int().nonnegative(),
   returnedCount: z.number().int().nonnegative(),
@@ -231,19 +220,6 @@ const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
   runtime: runtimeIdentity,
 }).strict();
 
-const docxFindLiteralOutput = artifactOutput('docx_find_literal').extend({
-  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,
   observation: docxObservationNode,
@@ -252,7 +228,7 @@ const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
 const tools = [
   {
     name: 'docx_inspect',
-    description: 'Inspect one current DOCX. The response returns its revision, every table identity with shape, short text preview, and up to three immediately preceding non-empty body paragraphs, plus up to six opening non-empty body paragraphs. Reuse those native refs directly; use docx_find_literal only for text not exposed here and docx_list_objects only for container children. The complete inspection remains in the evidence artifact.',
+    description: 'Inspect one current DOCX and retain its complete machine observation at output. The response returns the current revision, observation artifact, table count, and up to six opening non-empty body paragraphs for document identity. Use list and read operations to traverse selected document objects in native structure order.',
     inputSchema: inputContract('docx_inspect'),
     outputSchema: docxInspectionOutput('docx_inspect'),
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -260,20 +236,12 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of revision-bound nearest-child identities in native document order and retain the exact page at output for later reuse. Without parentRef, returns nearest children of each selected story part; request paragraph and table together when a heading, caption, or summary identifies the following table. Use parentRef to restrict another container, such as a table or row; use docx_find_literal when selecting by text.',
+    description: 'List one small page of revision-bound nearest-child identities in native document order and retain the exact page at output for later reuse. Start at the selected story part, follow continuation in order, and descend only through returned refs with parentRef. Request paragraph and table together when their adjacency carries meaning. Text previews describe already located objects; never use matching text to identify a document or select a source.',
     inputSchema: inputContract('docx_list_objects'),
     outputSchema: docxListObjectsOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_list_objects', args),
   },
-  {
-    name: 'docx_find_literal',
-    description: 'Find exact current text in one small page of revision-bound native DOCX objects and retain the exact page at output for later reuse. 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),
-  },
   {
     name: 'docx_read_object',
     description: 'Read one selected native DOCX row, cell, or paragraph and requested descendants. For a table, page its row identities with docx_list_objects, then read only the current row. To select exact inline content, make a second read rooted at the observed cell or paragraph and request run or text.',
@@ -528,34 +496,10 @@ function compactDocxInspection(report) {
       ref: item.objectRef,
       textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
     }));
-  const tableContexts = new Map();
-  let precedingParagraphs = [];
-  for (const item of report.flow) {
-    if (item?.type === 'paragraph' && /^dox1_[0-9a-f]{64}$/u.test(item.objectRef)
-      && typeof item.text === 'string' && item.text.trim()) {
-      precedingParagraphs.push({
-        ref: item.objectRef,
-        textPreview: item.text.trim().replace(/\s+/gu, ' ').slice(0, 240),
-      });
-      precedingParagraphs = precedingParagraphs.slice(-3);
-    }
-    if (item?.type === 'table' && Number.isInteger(item.tableIndex)) {
-      tableContexts.set(item.tableIndex, precedingParagraphs);
-      precedingParagraphs = [];
-    }
-  }
   return {
     revision: report.tables.revision,
     summary: {
       tableCount: report.tables.tables.length,
-      tables: report.tables.tables.map((table, tableIndex) => ({
-        ref: table.ref,
-        parentRef: table.parentRef,
-        rowCount: table.rowCount,
-        columnCount: table.columnCount,
-        textPreview: String(table.textPreview ?? '').trim().replace(/\s+/gu, ' ').slice(0, 240),
-        contextBefore: tableContexts.get(tableIndex) ?? [],
-      })),
       openingParagraphs,
     },
   };
@@ -620,16 +564,6 @@ async function docxObservation(tool, args) {
     if (tool === 'docx_list_objects') {
       return { ...retained, ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
     }
-    if (tool === 'docx_find_literal') {
-      return {
-        ...retained,
-        ...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.28",
+  "version": "0.17.30",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",

package/office/contracts/docx_find_literal.schema.json

@@ -1,63 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "input": {
-      "type": "string",
-      "minLength": 1,
-      "x-tiwater-file-role": "read"
-    },
-    "literal": {
-      "type": "string",
-      "minLength": 1
-    },
-    "kind": {
-      "type": "string",
-      "enum": [
-        "part",
-        "paragraph",
-        "table",
-        "gridColumn",
-        "row",
-        "cell",
-        "run",
-        "text",
-        "drawing"
-      ]
-    },
-    "scope": {
-      "description": "Exact story-part URI such as /word/document.xml.",
-      "type": "string",
-      "minLength": 1
-    },
-    "parentRef": {
-      "description": "Optional revision-bound parent object ref. Searches only its nearest published child objects, not every recursive descendant.",
-      "type": "string",
-      "pattern": "^dox1_[0-9a-f]{64}$"
-    },
-    "limit": {
-      "description": "Maximum matches in this small page. Refine the literal or parentRef when more matches remain; do not raise the page size to extract the document.",
-      "default": 50,
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 100
-    },
-    "continuation": {
-      "type": "string",
-      "minLength": 1
-    },
-    "output": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Absolute path for a new JSON artifact containing this exact search page for later reuse.",
-      "x-tiwater-file-role": "write"
-    }
-  },
-  "required": [
-    "input",
-    "literal",
-    "output"
-  ],
-  "additionalProperties": false,
-  "$id": "tiwater.office-mcp-input/docx_find_literal/v1"
-}