@tiwater/office-mcp 0.15.12 → 0.15.14

package/office/README.md

@@ -8,6 +8,7 @@ values, business mappings, workflow decisions, and delivery status.
 
 Every inspect/export result binds its observation artifact to the exact source
 file path, SHA-256, and byte count used by that invocation.
+Full native object reads are also written as artifacts instead of being inlined.
 
 Every filesystem argument is identified in the published MCP input schema by
 `x-tiwater-file-role`. `read` marks an existing provider input; `write` marks a

package/office/contracts/docx_read_object.schema.json

@@ -16,11 +16,18 @@
       "description": "Optional expected revision id from the observation receipt; a changed document fails as stale.",
       "type": "string",
       "pattern": "^docx-rev-v1-[0-9a-f]{64}$"
+    },
+    "output": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path for a new JSON artifact containing the complete native object observation.",
+      "x-tiwater-file-role": "write"
     }
   },
   "required": [
     "input",
-    "ref"
+    "ref",
+    "output"
   ],
   "additionalProperties": false,
   "$id": "tiwater.office-mcp-input/docx_read_object/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.15.12"
+    "version": "0.15.14"
   },
   "tools": [
     {
@@ -284,11 +284,11 @@
       "name": "docx_read_object",
       "providerContract": {
         "source": "packages/docx-cli/contracts/mcp-input/docx_read_object.schema.json",
-        "sha256": "66637468203435e04545045c9be0ac118956d353501b14e12e9ceae03ac4bd9a"
+        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
       },
       "inputContract": {
         "path": "office/contracts/docx_read_object.schema.json",
-        "sha256": "66637468203435e04545045c9be0ac118956d353501b14e12e9ceae03ac4bd9a"
+        "sha256": "ed4068627fe84872fb8d15d57d5950a22d03e79b4bb11cbc376a8d8b84cee0c0"
       }
     },
     {

package/office/index.mjs

@@ -205,24 +205,25 @@ const tools = [
   },
   {
     name: 'docx_list_objects',
-    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not document-text extraction. For content, use docx_find_literal and then docx_read_object on the selected table or row. Use parentRef for nearest children: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
+    description: 'List one small page of revision-bound DOCX object identities for structure discovery, not selection by text. To select a table or row by any descendant cell text, call docx_find_literal with kind table or row instead of listing the document. Use parentRef for nearest children: a part yields top-level story blocks and a table yields rows. Without parentRef the request is story-wide; scope is only an exact story-part URI.',
     inputSchema: inputContract('docx_list_objects'),
     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, then pass a selected table or row ref to docx_read_object. Use parentRef to search only the nearest published children of a selected part, table, row, cell, or paragraph; this is not recursive descendant search.',
+    description: 'Find exact current text in one small page of revision-bound native DOCX objects. With kind table or row, matching includes all descendant cell text, so no prior paragraph, cell, or document-wide list is needed. Use parentRef only to search nearest published children of a selected object.',
     inputSchema: inputContract('docx_find_literal'),
     annotations: { readOnlyHint: true, idempotentHint: true },
     handler: args => docxObservation('docx_find_literal', args),
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected revision-bound native DOCX object in full technical Open XML detail. Use a table or row ref from list/find to inspect grid spans and merges without enumerating document-wide cells.',
+    description: 'Write one selected revision-bound native DOCX object in full technical Open XML detail to a new JSON artifact. Use a table or row ref from list/find to inspect grid spans and merges without enumerating document-wide cells.',
     inputSchema: inputContract('docx_read_object'),
+    outputSchema: artifactOutput('docx_read_object'),
     annotations: { readOnlyHint: true, idempotentHint: true },
-    handler: args => docxObservation('docx_read_object', args),
+    handler: docxReadObject,
   },
   {
     name: 'docx_copy_content',
@@ -428,6 +429,21 @@ async function docxObservation(tool, args) {
   });
 }
 
+async function docxReadObject(args) {
+  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, ['docx_read_object', requestPath]);
+    return {
+      tool: 'docx_read_object',
+      runtime: commandRuntime(result),
+      source: await fileArtifact(input),
+      artifact: await writeJsonArtifact(output, result.json),
+    };
+  });
+}
+
 async function docxValidate(args) {
   const result = await runJsonCandidateChain(docxCandidates, ['validate-openxml', requireString(args.input, 'input')], { allowedExitCodes: [0, 1] });
   return { tool: 'docx_validate', runtime: commandRuntime(result), result: result.json };

package/package.json

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