PraisonAI 4.5.64__tar.gz → 4.5.67__tar.gz

{praisonai-4.5.64 → praisonai-4.5.67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.5.64
+Version: 4.5.67
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.5.64
+Requires-Dist: praisonaiagents>=1.5.67
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm>=1.81.0
 Requires-Dist: PyYAML>=6.0
@@ -199,16 +199,11 @@ PraisonAI 🦞 — Automate and solve complex challenges with AI agent teams tha
 
 ## ⚡ Performance
 
-PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
+PraisonAI is built for speed, with agent instantiation in under 4μs. This reduces overhead, improves responsiveness, and helps multi-agent systems scale efficiently in real-world production workloads.
 
-| Framework | Avg Time (μs) | Relative |
-|-----------|---------------|----------|
-| **PraisonAI** | **3.77** | **1.00x (fastest)** |
-| OpenAI Agents SDK | 5.26 | 1.39x |
-| Agno | 5.64 | 1.49x |
-| PraisonAI (LiteLLM) | 7.56 | 2.00x |
-| PydanticAI | 226.94 | 60.16x |
-| LangGraph | 4,558.71 | 1,209x |
+| Performance Metric | PraisonAI |
+|--------------------|-----------|
+| Avg Instantiation Time | **3.77 μs** |
 
 ---
 

{praisonai-4.5.64 → praisonai-4.5.67}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.5.64
+Version: 4.5.67
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.5.64
+Requires-Dist: praisonaiagents>=1.5.67
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm>=1.81.0
 Requires-Dist: PyYAML>=6.0
@@ -199,16 +199,11 @@ PraisonAI 🦞 — Automate and solve complex challenges with AI agent teams tha
 
 ## ⚡ Performance
 
-PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
+PraisonAI is built for speed, with agent instantiation in under 4μs. This reduces overhead, improves responsiveness, and helps multi-agent systems scale efficiently in real-world production workloads.
 
-| Framework | Avg Time (μs) | Relative |
-|-----------|---------------|----------|
-| **PraisonAI** | **3.77** | **1.00x (fastest)** |
-| OpenAI Agents SDK | 5.26 | 1.39x |
-| Agno | 5.64 | 1.49x |
-| PraisonAI (LiteLLM) | 7.56 | 2.00x |
-| PydanticAI | 226.94 | 60.16x |
-| LangGraph | 4,558.71 | 1,209x |
+| Performance Metric | PraisonAI |
+|--------------------|-----------|
+| Avg Instantiation Time | **3.77 μs** |
 
 ---
 

{praisonai-4.5.64 → praisonai-4.5.67}/PraisonAI.egg-info/SOURCES.txt

@@ -59,6 +59,7 @@ praisonai/bots/_commands.py
 praisonai/bots/_config_schema.py
 praisonai/bots/_debounce.py
 praisonai/bots/_discord_approval.py
+praisonai/bots/_email_utils.py
 praisonai/bots/_http_approval.py
 praisonai/bots/_protocol_mixin.py
 praisonai/bots/_rate_limit.py
@@ -69,9 +70,11 @@ praisonai/bots/_slack_approval.py
 praisonai/bots/_telegram_approval.py
 praisonai/bots/_webhook_approval.py
 praisonai/bots/_whatsapp_web_adapter.py
+praisonai/bots/agentmail.py
 praisonai/bots/bot.py
 praisonai/bots/botos.py
 praisonai/bots/discord.py
+praisonai/bots/email.py
 praisonai/bots/media.py
 praisonai/bots/slack.py
 praisonai/bots/telegram.py

{praisonai-4.5.64 → praisonai-4.5.67}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.5.64
+praisonaiagents>=1.5.67
 python-dotenv>=0.19.0
 litellm>=1.81.0
 PyYAML>=6.0

{praisonai-4.5.64 → praisonai-4.5.67}/README.md

@@ -50,16 +50,11 @@ PraisonAI 🦞 — Automate and solve complex challenges with AI agent teams tha
 
 ## ⚡ Performance
 
-PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
-
-| Framework | Avg Time (μs) | Relative |
-|-----------|---------------|----------|
-| **PraisonAI** | **3.77** | **1.00x (fastest)** |
-| OpenAI Agents SDK | 5.26 | 1.39x |
-| Agno | 5.64 | 1.49x |
-| PraisonAI (LiteLLM) | 7.56 | 2.00x |
-| PydanticAI | 226.94 | 60.16x |
-| LangGraph | 4,558.71 | 1,209x |
+PraisonAI is built for speed, with agent instantiation in under 4μs. This reduces overhead, improves responsiveness, and helps multi-agent systems scale efficiently in real-world production workloads.
+
+| Performance Metric | PraisonAI |
+|--------------------|-----------|
+| Avg Instantiation Time | **3.77 μs** |
 
 ---
 

{praisonai-4.5.64 → praisonai-4.5.67}/praisonai/bots/__init__.py

@@ -12,6 +12,8 @@ if TYPE_CHECKING:
     from .discord import DiscordBot
     from .slack import SlackBot
     from .whatsapp import WhatsAppBot
+    from .email import EmailBot
+    from .agentmail import AgentMailBot
     from .bot import Bot
     from .botos import BotOS
     from ._slack_approval import SlackApproval
@@ -34,6 +36,12 @@ def __getattr__(name: str):
     if name == "WhatsAppBot":
         from .whatsapp import WhatsAppBot
         return WhatsAppBot
+    if name == "EmailBot":
+        from .email import EmailBot
+        return EmailBot
+    if name == "AgentMailBot":
+        from .agentmail import AgentMailBot
+        return AgentMailBot
     if name == "Bot":
         from .bot import Bot
         return Bot
@@ -58,7 +66,7 @@ def __getattr__(name: str):
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
 
 __all__ = [
-    "TelegramBot", "DiscordBot", "SlackBot", "WhatsAppBot",
+    "TelegramBot", "DiscordBot", "SlackBot", "WhatsAppBot", "EmailBot", "AgentMailBot",
     "Bot", "BotOS",
     "SlackApproval", "TelegramApproval", "DiscordApproval",
     "WebhookApproval", "HTTPApproval",

{praisonai-4.5.64 → praisonai-4.5.67}/praisonai/bots/_config_schema.py

@@ -91,7 +91,7 @@ class BotYamlSchema(BaseModel):
                 "(telegram, discord, slack, whatsapp) to your bot.yaml"
             )
         # Validate channel names
-        valid_platforms = {"telegram", "discord", "slack", "whatsapp"}
+        valid_platforms = {"telegram", "discord", "slack", "whatsapp", "email", "agentmail"}
         for name in self.channels:
             if name not in valid_platforms:
                 raise ValueError(

praisonai-4.5.67/praisonai/bots/_email_utils.py

@@ -0,0 +1,128 @@
+"""
+Shared email utilities for PraisonAI bots.
+
+Contains common email logic used by both EmailBot (IMAP/SMTP) and AgentMailBot (API).
+"""
+
+from __future__ import annotations
+
+from typing import Dict, Set
+
+# Headers that indicate auto-generated/auto-reply emails
+AUTO_REPLY_HEADERS: Set[str] = {
+    "auto-submitted",
+    "x-auto-response-suppress",
+    "x-autoreply",
+    "x-autorespond",
+    "x-autogenerated",
+    "precedence",  # Often set to "bulk" or "auto_reply"
+}
+
+# Sender patterns to never reply to (prevents loops)
+BLOCKED_SENDERS: Set[str] = {
+    "mailer-daemon",
+    "postmaster",
+    "noreply",
+    "no-reply",
+    "donotreply",
+    "do-not-reply",
+    "bounce",
+    "auto",
+    "daemon",
+}
+
+
+def is_auto_reply(headers: Dict[str, str]) -> bool:
+    """Check if email headers indicate an auto-reply.
+    
+    Args:
+        headers: Dictionary of email headers (case-insensitive keys recommended).
+        
+    Returns:
+        True if the email appears to be an auto-reply.
+    """
+    headers_lower = {k.lower(): v for k, v in headers.items()}
+    
+    for header in AUTO_REPLY_HEADERS:
+        if header in headers_lower:
+            value = headers_lower[header]
+            # auto-submitted: auto-replied, auto-generated, auto-notified
+            if header == "auto-submitted" and value and value.lower() != "no":
+                return True
+            # precedence: bulk, junk, list, auto_reply
+            if header == "precedence" and value and value.lower() in ("bulk", "junk", "auto_reply"):
+                return True
+            # Other headers: any non-empty value indicates auto-reply
+            if header not in ("auto-submitted", "precedence") and value:
+                return True
+    
+    return False
+
+
+def is_blocked_sender(sender: str) -> bool:
+    """Check if sender should be blocked (system addresses, no-reply, etc.).
+    
+    Args:
+        sender: Email address or display name of sender.
+        
+    Returns:
+        True if the sender should not receive replies.
+    """
+    if not sender:
+        return True
+    
+    sender_lower = sender.lower()
+    return any(blocked in sender_lower for blocked in BLOCKED_SENDERS)
+
+
+def extract_email_address(full_address: str) -> str:
+    """Extract email address from a full address string.
+    
+    Args:
+        full_address: Full address like "John Doe <john@example.com>" or "john@example.com"
+        
+    Returns:
+        Just the email address part.
+    """
+    if not full_address:
+        return ""
+    
+    # Handle "Name <email>" format
+    if "<" in full_address and ">" in full_address:
+        start = full_address.index("<") + 1
+        end = full_address.index(">")
+        return full_address[start:end].strip()
+    
+    return full_address.strip()
+
+
+def normalize_subject(subject: str, strip_prefixes: bool = True) -> str:
+    """Normalize email subject for comparison/threading.
+    
+    Args:
+        subject: Original subject line.
+        strip_prefixes: If True, removes Re:, Fwd:, etc.
+        
+    Returns:
+        Normalized subject string.
+    """
+    if not subject:
+        return ""
+    
+    result = subject.strip()
+    
+    if strip_prefixes:
+        # Remove common reply/forward prefixes
+        prefixes = ("re:", "fwd:", "fw:", "aw:", "sv:", "vs:")
+        while True:
+            lower = result.lower()
+            stripped = False
+            for prefix in prefixes:
+                if lower.startswith(prefix):
+                    result = result[len(prefix):].strip()
+                    stripped = True
+                    break
+            if not stripped:
+                break
+    
+    return result

{praisonai-4.5.64 → praisonai-4.5.67}/praisonai/bots/_registry.py

@@ -15,6 +15,8 @@ _BUILTIN_PLATFORMS: Dict[str, tuple] = {
     "discord": ("praisonai.bots.discord", "DiscordBot"),
     "slack": ("praisonai.bots.slack", "SlackBot"),
     "whatsapp": ("praisonai.bots.whatsapp", "WhatsAppBot"),
+    "email": ("praisonai.bots.email", "EmailBot"),
+    "agentmail": ("praisonai.bots.agentmail", "AgentMailBot"),
 }
 
 # Custom platforms registered at runtime