Added 2026-02-12 to support filtering emails by IMAP flags. Documented in Email Access Guide under search_flags.
• SEEN — Read/processed emails• UNSEEN — Unread emails• FLAGGED — Starred/flagged emails• ANSWERED — Replied-to emails• Empty string — No flag filter• Space-separated for AND logic: e.g. "UNSEEN FLAGGED"
• Schema: flags field in EmailSearch class in envoy_schema.py• Search: search_emails_imap() in orchestrator.py — includes flags in IMAP search criteria• Documentation: envoy/start — flags usage with examples
Bulk migration: Move all SEEN emails from INBOX to Done using {"folder": "INBOX", "flags": "SEEN"}Find unread: Show all unread emails using {"folder": "INBOX", "flags": "UNSEEN"}Important items: List flagged emails using {"folder": "INBOX", "flags": "FLAGGED"}
Date: 2026-02-12 17:12–17:13Test: Bulk email migration using SEEN flagResult: Successfully searched 17 SEEN emails, moved 16 to Done (excluded instruction email)