@tiwater/office-mcp 0.16.18 → 0.16.20

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

package/office/index.mjs

@@ -200,7 +200,7 @@ const tools = [
   },
   {
     name: 'docx_read_object',
-    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.',
+    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 once. Add paragraph for whole-paragraph choices; add run and text for exact content selections.',
     inputSchema: inputContract('docx_read_object'),
     outputSchema: docxReadObjectOutput,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -208,14 +208,14 @@ const tools = [
   },
   {
     name: 'docx_copy_content',
-    description: 'Replace content in existing target cells while retaining target cell formatting and source inline meaning. Use this directly or after docx_copy_table_rows when a target cell needs an exact observed subset of source content. A source selection copies a whole object by ref, or an exact substring when range is attached to a run or text ref.',
+    description: 'Replace content in existing target cells while retaining target cell formatting and source inline meaning. Batch cells that need exact observed subsets after docx_copy_table_rows. A selection copies a whole object by ref, or an exact substring when range is attached to a run or text ref.',
     inputSchema: inputContract('docx_copy_content'),
     outputSchema: fixedEditOutput('docx_copy_content'),
     handler: args => fixedEdit('docx_copy_content', args),
   },
   {
     name: 'docx_copy_table_rows',
-    description: 'Populate existing target tables by replacing selected data-row ranges with selected source rows. Use this whenever the target table already exists; explicit header-cell mappings preserve target presentation and native source grouping even when source and target grid spans differ. Each column must explicitly copy all source-cell paragraphs or only the first; inspect paragraph children before choosing.',
+    description: 'Populate existing target tables by replacing selected data-row ranges with selected source rows. Explicit header-cell mappings preserve target presentation and source grouping. A column content mode applies to every copied cell in that column; when cells need different subsets, copy the row structure first and batch those cells with docx_copy_content.',
     inputSchema: inputContract('docx_copy_table_rows'),
     outputSchema: fixedEditOutput('docx_copy_table_rows'),
     handler: args => fixedEdit('docx_copy_table_rows', args),
@@ -260,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,
   },
   {
@@ -313,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,
   },
   {
@@ -320,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),
@@ -335,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,
   },
   {
@@ -342,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,
   },
   {

package/package.json

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