@tiwater/office-mcp 0.16.17 → 0.16.19

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

package/office/index.mjs

@@ -170,15 +170,9 @@ const docxObjectIdentity = z.object({
   verticalMerge: z.string().nullable(),
 }).strict();
 
-const docxObjectNode = z.lazy(() => z.object({
-  object: docxObjectIdentity,
-  children: z.array(docxObjectNode),
-}).strict());
-
 const docxReadObjectOutput = artifactOutput('docx_read_object').extend({
   revision: docxRevision,
   object: docxObjectIdentity,
-  children: z.array(docxObjectNode),
 }).strict();
 
 const tools = [
@@ -206,7 +200,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    description: 'Read one selected native DOCX object as an ordered native hierarchy. For a table, request row and cell kinds once; each row contains its ordered cells with text, grid span, and vertical merge state. Also request paragraph when paragraph boundaries determine what a later copy operation must retain.',
+    description: 'Read one selected native DOCX object as an ordered native hierarchy written to the requested output artifact. The tool response only identifies that artifact and the selected root object; read the artifact for descendant refs and content. For a table, request row and cell kinds once; each row contains its ordered cells with text, grid span, and vertical merge state. Also request paragraph when paragraph boundaries determine what a later copy operation must retain.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -266,6 +260,7 @@ const tools = [
     description: 'Write a body-only DOCX JSON projection only when a downstream consumer explicitly requires that format. It is not a companion to docx_inspect and does not replace bounded list/find/read object selection.',
     inputSchema: inputContract('docx_export_json'),
     outputSchema: artifactOutput('docx_export_json'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: docxExportJson,
   },
   {
@@ -319,6 +314,7 @@ const tools = [
     description: 'Inspect a current XLSX workbook or legacy XLS workbook and write one JSON observation containing workbook structure, exported values, formulas, styles, merged ranges, and any published legacy-format conversion evidence.',
     inputSchema: inputContract('xlsx_inspect'),
     outputSchema: artifactOutput('xlsx_inspect'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: xlsxInspect,
   },
   {
@@ -326,6 +322,7 @@ const tools = [
     description: 'Export workbook sheet data from XLSX as structured JSON.',
     inputSchema: inputContract('xlsx_export_json'),
     outputSchema: artifactOutput('xlsx_export_json'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: xlsxExportJson,
   },
   ...fixedToolDefinitions(xlsxFixedTools),
@@ -341,6 +338,7 @@ const tools = [
     description: 'Inspect a PPTX file and write one detailed JSON observation containing slides, masters, layouts, shapes, transforms, paragraphs, runs, and placeholders.',
     inputSchema: inputContract('pptx_inspect'),
     outputSchema: artifactOutput('pptx_inspect'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: pptxInspect,
   },
   {
@@ -348,6 +346,7 @@ const tools = [
     description: 'Export PPTX slide text, notes, and placeholder hints to a new JSON artifact without returning the full presentation through MCP.',
     inputSchema: inputContract('pptx_export_json'),
     outputSchema: artifactOutput('pptx_export_json'),
+    annotations: { readOnlyHint: true, idempotentHint: true },
     handler: pptxExportJson,
   },
   {
@@ -462,18 +461,10 @@ async function docxReadObject(args) {
       artifact: await writeJsonArtifact(output, result.json),
       revision: result.json.receipt.revision,
       object: compactDocxObjectIdentity(result.json.observation.object),
-      children: result.json.observation.children.map(compactDocxObjectNode),
     };
   });
 }
 
-function compactDocxObjectNode(node) {
-  return {
-    object: compactDocxObjectIdentity(node.object),
-    children: node.children.map(compactDocxObjectNode),
-  };
-}
-
 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.16.17",
+  "version": "0.16.19",
   "description": "Published MCP server for Tiwater Office document capabilities",
   "type": "module",
   "license": "MIT",