From 56ce18167e2453d5a72b4f72f332092684f754e7 Mon Sep 17 00:00:00 2001 From: chengyongru Date: Tue, 9 Jun 2026 13:43:43 +0800 Subject: [PATCH] docs: clarify email post-action expunge fallback maintainer edit: clarify that postActionExpunge only allows the broad EXPUNGE fallback when UID-scoped expunge is unavailable or fails. --- docs/chat-apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/chat-apps.md b/docs/chat-apps.md index 0d65b06f4..a529ff00a 100644 --- a/docs/chat-apps.md +++ b/docs/chat-apps.md @@ -581,7 +581,7 @@ Give nanobot its own email account. It polls **IMAP** for incoming mail and repl > This runs only after an accepted email is successfully delivered to the AI pipeline. > - `postActionMoveMailbox`: Destination mailbox used when `postAction` is `"move"` (for example `"Processed"` or `"[Gmail]/Trash"`). > - `postActionIgnoreSkipped`: If `true` (default), skipped emails are ignored for post-action and not moved/deleted. -> - `postActionExpunge`: When `true`, the channel performs a full mailbox cleanup after processing emails (default `false`). Enable only on very old IMAP servers that lack modern UIDPLUS support. Note that this will expunge **all** messages marked as deleted in the mailbox, including ones not handled by the agent. Leaving this off is safe for all modern IMAP servers. +> - `postActionExpunge`: When `true`, the channel allows a full-mailbox `EXPUNGE` fallback if UID-scoped expunge is unavailable or fails (default `false`). Enable only on very old IMAP servers that lack modern UIDPLUS support. Note that this fallback will expunge **all** messages marked as deleted in the mailbox, including ones not handled by the agent. Leaving this off is safe for all modern IMAP servers. > - `allowedAttachmentTypes`: Save inbound attachments matching these MIME types — `["*"]` for all, e.g. `["application/pdf", "image/*"]` (default `[]` = disabled). > - `maxAttachmentSize`: Max size per attachment in bytes (default `2000000` / 2MB). > - `maxAttachmentsPerEmail`: Max attachments to save per email (default `5`).