feat: preliminary imap_mail integration closes issue #3202

[waleedalzarooni]

Description

IMAP integration into toolkit

Checklist

Go over all the following points, and put an x in all the boxes that apply.

• [X ] I have read the CONTRIBUTION guide (required)
• [X ] I have linked this PR to an issue using the Development section on the right sidebar or by adding Fixes #issue-number in the PR description (required)
• [ X] I have checked if any dependencies need to be added or updated in pyproject.toml and uv lock
• [ X] I have updated the tests accordingly (required for a bug fix or a new feature)
• [ X] I have updated the documentation if needed:
• [ X] I have added examples if this is a new feature

If you are unsure about any of these, don't hesitate to ask. We are here to help!

[coderabbitai[bot]]

[!IMPORTANT]

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• [ ] Create PR with unit tests
• [ ] Post copyable unit tests in a comment
• [ ] Commit unit tests in branch imap-mail-toolkit

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[waleedalzarooni]

first draft still needs some tweaks!

[waleedalzarooni]

@Wendong-Fan,

My apologies, I haven't been active on this PR because I thought the enhance PR merged into main. Shall we go ahead with shipping this now.