MailInterface (mail/mail.py)

Mail interface for Upsonic framework, enabling IMAP polling, SMTP sending, and email-based agent interactions.

# Source: https://github.com/Upsonic/Upsonic | License: MIT | Copyright 2024 Upsonic Teknoloji A.Ş
# Provided via justclaw.it.com; keep this notice with the code.
"""
Generic Mail (SMTP/IMAP) Interface for the Upsonic Framework.

This module provides a universal email interface that works with any
mail provider supporting standard SMTP and IMAP protocols. It supports:
- Fetching and listing emails via IMAP
- Sending emails and replies via SMTP
- Attachment handling (incoming and outgoing)
- Task and Chat modes
- Whitelist-based access control
- Heartbeat auto-poll for AutonomousAgent
- Event deduplication
- Configurable mailbox/folder

Works with: Gmail, Outlook, Yahoo, Zoho, self-hosted mail servers, etc.
"""

import asyncio
import os
import re
import tempfile
import time
from typing impo

... (truncated -- full source via MCP)