Feature/add gmail integration

[pulinduvidmal]

Description

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Performance improvement
• Test update
• CI/CD update
• Other (please describe):

Related Issues

Fixes #
Relates to #

Changes Made

• Added Telegram handler: AgentGmailRequestHandler
• Created example app in examples/api/tgmail/
• Added config and build scripts
• Updated documentation and README

Testing

• Unit tests pass locally
• Integration tests pass locally
• Manual testing completed
• New tests added for changes

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots (if applicable)

Additional Notes

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 22 out of 25 changed files in this pull request and generated 17 comments.

Comments suppressed due to low confidence (2)

ak-py/src/agentkernel/integration/telegram/telegram_chat.py:1

• Import of 'hashlib' is not used.

import hashlib

ak-py/src/agentkernel/integration/telegram/telegram_chat.py:2

• Import of 'hmac' is not used.

import hmac

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 16 comments.

Comments suppressed due to low confidence (3)

examples/api/gmail/server_test.py:3

• Import of 'subprocess' is not used.

import subprocess

examples/api/gmail/server_test.py:4

• Import of 'sys' is not used.

import sys

examples/api/gmail/server_test.py:73

• 'except' clause does nothing but pass and there is no explanatory comment.

    except httpx.HTTPStatusError:

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.