@tiwater/office-mcp 0.17.9 → 0.17.10

package/office/contracts/docx_find_literal.schema.json

@@ -45,11 +45,18 @@
     "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"
+    "literal",
+    "output"
   ],
   "additionalProperties": false,
   "$id": "tiwater.office-mcp-input/docx_find_literal/v1"

package/office/contracts/docx_list_objects.schema.json

@@ -42,11 +42,18 @@
     "continuation": {
       "type": "string",
       "minLength": 1
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path for a new JSON artifact containing this exact object page for later reuse.",
+      "x-tiwater-file-role": "write"
     }
   },
   "required": [
     "input",
-    "kind"
+    "kind",
+    "output"
   ],
   "additionalProperties": false,
   "$id": "tiwater.office-mcp-input/docx_list_objects/v1"

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.9"
+    "version": "0.17.10"
   },
   "tools": [
     {
@@ -97,11 +97,11 @@
       "name": "docx_find_literal",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_find_literal.schema.json",
-        "sha256": "a81b88ee6fa7d897d01c4cb05a18ca3b92738f2690b6f2fa6aff402c4c1ff182"
+        "sha256": "4b063c8a4c683c1d7eb06ce1feec8e51546dca78759151ff654f41d45a17d64c"
       },
       "inputContract": {
         "path": "office/contracts/docx_find_literal.schema.json",
-        "sha256": "a81b88ee6fa7d897d01c4cb05a18ca3b92738f2690b6f2fa6aff402c4c1ff182"
+        "sha256": "4b063c8a4c683c1d7eb06ce1feec8e51546dca78759151ff654f41d45a17d64c"
       }
     },
     {
@@ -119,11 +119,11 @@
       "name": "docx_list_objects",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
-        "sha256": "d8894a1b453fc780c1d2b355f34de27759a055ef6859333796665ac6439dd464"
+        "sha256": "5aff2a708172ea8ccba630e5fe3c42314ca3db3d333fcf001d69df87568c18fa"
       },
       "inputContract": {
         "path": "office/contracts/docx_list_objects.schema.json",
-        "sha256": "d8894a1b453fc780c1d2b355f34de27759a055ef6859333796665ac6439dd464"
+        "sha256": "5aff2a708172ea8ccba630e5fe3c42314ca3db3d333fcf001d69df87568c18fa"
       }
     },
     {

package/office/index.mjs

@@ -213,14 +213,14 @@ const docxObservationReceipt = z.object({
   continuation: z.string().nullable(),
 }).strict();
 
-const docxListObjectsOutput = z.object({
+const docxListObjectsOutput = artifactOutput('docx_list_objects').extend({
   schema: z.literal('tiwater.docx-observation-list/v1'),
   receipt: docxObservationReceipt,
   objects: z.array(docxObjectIdentity),
   runtime: runtimeIdentity,
 }).strict();
 
-const docxFindLiteralOutput = z.object({
+const docxFindLiteralOutput = artifactOutput('docx_find_literal').extend({
   schema: z.literal('tiwater.docx-observation-find/v1'),
   receipt: docxObservationReceipt,
   matches: z.array(z.object({
@@ -249,7 +249,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.',
+    description: 'List one small page of revision-bound nearest-child identities and retain the exact page at output for later reuse. 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 },
@@ -257,7 +257,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.',
+    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 },
@@ -567,14 +567,24 @@ async function docxInspect(args) {
 }
 
 async function docxObservation(tool, args) {
-  return withTempJsonFile(args, async requestPath => {
+  const input = path.resolve(requireString(args.input, 'input'));
+  const output = requireString(args.output, 'output');
+  const { output: _output, ...request } = args;
+  return withTempJsonFile(request, async requestPath => {
     const result = await runJsonCandidateChain(docxCandidates, [tool, requestPath]);
     const payload = { ...result.json, runtime: commandRuntime(result) };
+    const retained = {
+      tool,
+      runtime: payload.runtime,
+      source: await fileArtifact(input),
+      artifact: await writeJsonArtifact(output, result.json),
+    };
     if (tool === 'docx_list_objects') {
-      return { ...payload, objects: payload.objects.map(compactDocxObjectIdentity) };
+      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),

package/package.json

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