apple-mail-mcp 2.17.6 → 2.17.7
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.
- package/README.md +19 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -256,6 +256,25 @@ To search inside a large mailbox, scope the call with `mailbox` (and ideally a
|
|
|
256
256
|
to disable the guard and attempt every mailbox regardless of size).
|
|
257
257
|
([#24](https://github.com/sweetrb/apple-mail-mcp/issues/24))
|
|
258
258
|
|
|
259
|
+
**Coverage diagnostics (structured fields).** The warning above is prose for a
|
|
260
|
+
human reader; the same information is also returned as structured fields on
|
|
261
|
+
`search-messages` and `list-messages`, so a caller can tell *"nothing matched"*
|
|
262
|
+
apart from *"I did not look everywhere"* without parsing the text:
|
|
263
|
+
|
|
264
|
+
| Field | Type | Meaning |
|
|
265
|
+
|---|---|---|
|
|
266
|
+
| `partial` | boolean | Coverage was incomplete — **the result is not a confirmed "no such mail"**. True whenever any field below is non-empty. |
|
|
267
|
+
| `skippedLargeMailboxes` | string[] | Mailboxes never scanned because their message count exceeded `APPLE_MAIL_MAX_SEARCH_MAILBOX`, formatted `"Account / Mailbox (count)"` — e.g. `"iCloud / Archive (90694)"`. |
|
|
268
|
+
| `notSearchedMailboxes` | string[] | Mailboxes that *were* reached but timed out or errored mid-scan, formatted `"Account / Mailbox"`. Also carries the IMAP path's `failedMailboxes`. |
|
|
269
|
+
| `timedOutAccounts` | string[] | Accounts whose whole-account AppleScript was killed by the per-account time budget — nothing from that account was searched. |
|
|
270
|
+
| `failedMailboxes` | string[] | IMAP-backend mailboxes that errored. These are merged into `notSearchedMailboxes` as well; read that field unless you need to attribute the failure to the IMAP path specifically. |
|
|
271
|
+
|
|
272
|
+
Treat a non-empty `skippedLargeMailboxes` as actionable rather than
|
|
273
|
+
informational: re-run scoped to the named mailbox with a `dateFrom`/`dateTo`
|
|
274
|
+
window, or configure the [IMAP backend](#imap-backend--opt-in), which searches
|
|
275
|
+
those mailboxes server-side. All five fields are optional and are omitted when
|
|
276
|
+
coverage was complete.
|
|
277
|
+
|
|
259
278
|
---
|
|
260
279
|
|
|
261
280
|
#### `get-message`
|
package/package.json
CHANGED