@tiwater/office-mcp 0.15.7 → 0.15.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,7 +10,7 @@
10
10
  "output": {
11
11
  "type": "string",
12
12
  "minLength": 1,
13
- "description": "New JSON artifact path. Existing files are never overwritten.",
13
+ "description": "Absolute path for a new JSON artifact inside the caller-authorized output directory. Existing files are never overwritten.",
14
14
  "x-tiwater-file-role": "write"
15
15
  }
16
16
  },
@@ -34,10 +34,11 @@
34
34
  "pattern": "^dox1_[0-9a-f]{64}$"
35
35
  },
36
36
  "limit": {
37
- "default": 100,
37
+ "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.",
38
+ "default": 50,
38
39
  "type": "integer",
39
40
  "minimum": 1,
40
- "maximum": 1000
41
+ "maximum": 100
41
42
  },
42
43
  "continuation": {
43
44
  "type": "string",
@@ -10,7 +10,7 @@
10
10
  "output": {
11
11
  "type": "string",
12
12
  "minLength": 1,
13
- "description": "New JSON artifact path. Existing files are never overwritten.",
13
+ "description": "Absolute path for a new JSON artifact inside the caller-authorized output directory. Existing files are never overwritten.",
14
14
  "x-tiwater-file-role": "write"
15
15
  }
16
16
  },
@@ -8,7 +8,7 @@
8
8
  "x-tiwater-file-role": "read"
9
9
  },
10
10
  "kind": {
11
- "description": "Object granularity. Use row for table-range discovery; use cell or run only when the task directly targets that object kind.",
11
+ "description": "Object granularity for structure discovery, not document-text extraction. Use table to locate tables and row with a table parentRef for table-range discovery; use cell or run only when the task directly targets that object kind.",
12
12
  "type": "string",
13
13
  "enum": [
14
14
  "part",
@@ -31,11 +31,11 @@
31
31
  "pattern": "^dox1_[0-9a-f]{64}$"
32
32
  },
33
33
  "limit": {
34
- "description": "Maximum objects in this page. Follow continuation for another bounded page; do not raise the limit to replace semantic filtering.",
35
- "default": 100,
34
+ "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.",
35
+ "default": 50,
36
36
  "type": "integer",
37
37
  "minimum": 1,
38
- "maximum": 1000
38
+ "maximum": 100
39
39
  },
40
40
  "continuation": {
41
41
  "type": "string",
@@ -2,7 +2,7 @@
2
2
  "schema": "tiwater.office-provider-contract-manifest/v1",
3
3
  "provider": {
4
4
  "id": "@tiwater/office-mcp",
5
- "version": "0.15.7"
5
+ "version": "0.15.9"
6
6
  },
7
7
  "tools": [
8
8
  {
@@ -130,22 +130,22 @@
130
130
  "name": "docx_export_json",
131
131
  "providerContract": {
132
132
  "source": "packages/docx-cli/contracts/mcp-input/docx_export_json.schema.json",
133
- "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
133
+ "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
134
134
  },
135
135
  "inputContract": {
136
136
  "path": "office/contracts/docx_export_json.schema.json",
137
- "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
137
+ "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
138
138
  }
139
139
  },
140
140
  {
141
141
  "name": "docx_find_literal",
142
142
  "providerContract": {
143
143
  "source": "packages/docx-cli/contracts/mcp-input/docx_find_literal.schema.json",
144
- "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
144
+ "sha256": "4d5465456d58c0375276e93ee21023c4b14b2caf7c4e1840b60414a7d3c7fd64"
145
145
  },
146
146
  "inputContract": {
147
147
  "path": "office/contracts/docx_find_literal.schema.json",
148
- "sha256": "f0df9a19d99db372a0c125b966b00d76161cc734581e2da3d4636b058c2e27d9"
148
+ "sha256": "4d5465456d58c0375276e93ee21023c4b14b2caf7c4e1840b60414a7d3c7fd64"
149
149
  }
150
150
  },
151
151
  {
@@ -207,11 +207,11 @@
207
207
  "name": "docx_inspect",
208
208
  "providerContract": {
209
209
  "source": "packages/docx-cli/contracts/mcp-input/docx_inspect.schema.json",
210
- "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
210
+ "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
211
211
  },
212
212
  "inputContract": {
213
213
  "path": "office/contracts/docx_inspect.schema.json",
214
- "sha256": "f14160d7cff99949dd3e14d60a2d532b31f520bfa72327de972c29c15b9817aa"
214
+ "sha256": "ecf528f83a28f2709efb12182dba18f5f4baf065e8442c76ab568ad01465603d"
215
215
  }
216
216
  },
217
217
  {
@@ -229,11 +229,11 @@
229
229
  "name": "docx_list_objects",
230
230
  "providerContract": {
231
231
  "source": "packages/docx-cli/contracts/mcp-input/docx_list_objects.schema.json",
232
- "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
232
+ "sha256": "329952b59c2b614e956ed8c00208a0fec17a06cb586dddc205aa4581f8d8e0d5"
233
233
  },
234
234
  "inputContract": {
235
235
  "path": "office/contracts/docx_list_objects.schema.json",
236
- "sha256": "ea8152a6b44eacda63688680d91b758efa3e2a55b92de24eeb977951fda8f720"
236
+ "sha256": "329952b59c2b614e956ed8c00208a0fec17a06cb586dddc205aa4581f8d8e0d5"
237
237
  }
238
238
  },
239
239
  {
package/office/index.mjs CHANGED
@@ -191,7 +191,7 @@ function artifactOutput(tool) {
191
191
  const tools = [
192
192
  {
193
193
  name: 'docx_inspect',
194
- description: 'Inspect a DOCX document and write one unified JSON observation containing placeholders, comments, anchors, tables, fields, flow, fonts, and formatting metrics.',
194
+ description: 'Write the default single full-document DOCX observation containing body content, structure, placeholders, comments, anchors, tables, fields, flow, fonts, and formatting metrics. Do not also call docx_export_json for the same observation.',
195
195
  inputSchema: inputContract('docx_inspect'),
196
196
  outputSchema: artifactOutput('docx_inspect'),
197
197
  handler: docxInspect,
@@ -206,14 +206,14 @@ const tools = [
206
206
  },
207
207
  {
208
208
  name: 'docx_list_objects',
209
- description: 'List one bounded page of revision-bound native DOCX objects by kind. Use parentRef to return only the nearest published children of a selected object: 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.',
209
+ 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.',
210
210
  inputSchema: inputContract('docx_list_objects'),
211
211
  annotations: { readOnlyHint: true, idempotentHint: true },
212
212
  handler: args => docxObservation('docx_list_objects', args),
213
213
  },
214
214
  {
215
215
  name: 'docx_find_literal',
216
- description: 'Find exact current text in revision-bound native DOCX objects with bounded paging. Use parentRef to search only the nearest published children of a selected part, table, row, cell, or paragraph; this is not recursive descendant search.',
216
+ 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.',
217
217
  inputSchema: inputContract('docx_find_literal'),
218
218
  annotations: { readOnlyHint: true, idempotentHint: true },
219
219
  handler: args => docxObservation('docx_find_literal', args),
@@ -241,7 +241,7 @@ const tools = [
241
241
  },
242
242
  {
243
243
  name: 'docx_export_json',
244
- description: 'Export DOCX body content to a new JSON artifact without returning the full document through MCP.',
244
+ 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.',
245
245
  inputSchema: inputContract('docx_export_json'),
246
246
  outputSchema: artifactOutput('docx_export_json'),
247
247
  handler: docxExportJson,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tiwater/office-mcp",
3
- "version": "0.15.7",
3
+ "version": "0.15.9",
4
4
  "description": "Published MCP server for Tiwater Office document capabilities",
5
5
  "type": "module",
6
6
  "license": "MIT",