@tiwater/office-mcp 0.17.29 → 0.17.31

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. Request only the kinds needed by the current local traversal, then follow returned refs through parentRef-scoped child pages. 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.29"
+    "version": "0.17.31"
   },
   "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": "f496d10fefe414d49993b447b50ccce4d808fd11e6df8625f8f906de8a2d90bb"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "c1a0742b914608044ba017c9bf968fe59f0864761ea54be6c31c9679c69085a3"
+        "sha256": "f496d10fefe414d49993b447b50ccce4d808fd11e6df8625f8f906de8a2d90bb"
       }
     },
     {

package/office/index.mjs

@@ -205,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(),
@@ -220,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,
@@ -241,7 +228,7 @@ const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
 const tools = [
   {
     name: 'docx_inspect',
-    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 bounded list, find, and read operations for selected document objects.',
+    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 },
@@ -249,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. Request only the object kinds needed by the current local traversal, follow continuation in order, and descend only through returned refs with parentRef. 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.',
@@ -585,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.29",
+  "version": "0.17.31",
   "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"
-}