From b96ed1b7c66f98f87a246d9fef6a6d63689d4411 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fl=C3=A1vio=20Veloso=20Soares?= <flaviovs@magnux.com>
Date: Tue, 2 Jun 2026 22:22:10 -0700
Subject: [PATCH] docs(email): clarify _fetch_new_messages return docstring

---
 nanobot/channels/email.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/nanobot/channels/email.py b/nanobot/channels/email.py
index 611fdb357..b5c8413d5 100644
--- a/nanobot/channels/email.py
+++ b/nanobot/channels/email.py
@@ -349,7 +349,7 @@ class EmailChannel(BaseChannel):
             smtp.send_message(msg)
 
     def _fetch_new_messages(self) -> tuple[list[dict[str, Any]], set[str]]:
-        """Poll IMAP and return parsed unread messages."""
+        """Poll IMAP and return parsed unread messages plus skipped message UIDs."""
         return self._fetch_messages(
             search_criteria=("UNSEEN",),
             mark_seen=self.config.mark_seen,