Email Agent CC'd

[MervinPraison]

Email Agent CC'd

[praisonai-triage-agent]

Claude finished @MervinPraison's task —— View job • claude/issue-1874-20260609-2015 • [Create PR ➔](https://github.com/MervinPraison/PraisonAI/compare/main...claude/issue-1874-20260609-2015?quick_pull=1&title=Issue%20%231874%3A%20Changes%20from%20Claude&body=This%20PR%20addresses%20issue%20%231874%0A%0AGenerated%20with%20%5BClaude%20Code%5D(https%3A%2F%2Fclaude.ai%2Fcode)

---

Analyzing Email Agent CC'd Request

Working on implementing Email Agent CC functionality following PraisonAI architecture guidelines.

Todo List:

• Set up git identity and authentication
• Read AGENTS.md to understand architecture rules
• Analyze existing email functionality in codebase
• Determine proper implementation location (core vs wrapper)
• Implement CC support in email_tools.py send_email functions
• Implement CC support in EmailBot send_message method
• Add tests for CC functionality
• Test the implementation
• Commit and push changes
• Create pull request

Implementation Summary ✅

CC/BCC Email Functionality Successfully Implemented:

Core SDK Changes (praisonaiagents):

1. Enhanced Email Tools (praisonaiagents/tools/email_tools.py):

   • Added CC and BCC parameters to all email functions
   • Support for both string (comma-separated) and list formats
   • Works with both AgentMail and SMTP/IMAP backends
   • Functions updated: send_email(), draft_email(), smtp_send_email(), smtp_draft_email()

2. Helper Functions:

   • _parse_email_list(): Handles parsing of comma-separated emails or lists
   • Proper type annotations with Union[str, List[str]]

Wrapper Changes (praisonai):

3. EmailBot Enhancement (praisonai/bots/email.py):
   • Updated send_message() to support CC/BCC in content dict
   • Proper SMTP delivery to all recipients (to, cc, bcc)
   • CC headers added, BCC kept private (as designed)

Usage Examples:

# String format (comma-separated)
send_email(
    to="primary@example.com",
    subject="Meeting Update", 
    body="Please find the meeting notes.",
    cc="manager@example.com, team-lead@example.com",
    bcc="hr@example.com"
)

# List format
send_email(
    to="primary@example.com",
    subject="Project Update",
    body="The project is progressing well.",
    cc=["stakeholder1@example.com", "stakeholder2@example.com"],
    bcc=["audit@example.com"]
)

# EmailBot with content dict
await bot.send_message(
    channel_id="primary@example.com",
    content={
        "subject": "Weekly Report",
        "body": "Here is this week's report.",
        "cc": "manager@example.com",
        "bcc": "archive@example.com"
    }
)

Testing:

• All tests pass ✅
• Maintains backward compatibility
• Follows PraisonAI architecture principles
• Protocol-driven design preserved

The Email Agent now supports CC (Carbon Copy) functionality as requested! 🎉

Pull Request Created

Pull Request #1876: feat: implement CC/BCC support for email agents

The implementation is complete and ready for review. The Email Agent CC functionality has been successfully implemented following all PraisonAI architectural guidelines.

---