Python: Add Telegram channel for agent-framework-hosting

python/PACKAGE_STATUS.md

@@ -36,6 +36,7 @@ Status is grouped into these buckets:
 | `agent-framework-github-copilot` | `python/packages/github_copilot` | `rc` |
 | `agent-framework-hosting` | `python/packages/hosting` | `alpha` |
 | `agent-framework-hosting-responses` | `python/packages/hosting-responses` | `alpha` |
+| `agent-framework-hosting-telegram` | `python/packages/hosting-telegram` | `alpha` |
 | `agent-framework-hyperlight` | `python/packages/hyperlight` | `beta` |
 | `agent-framework-lab` | `python/packages/lab` | `beta` |
 | `agent-framework-mem0` | `python/packages/mem0` | `beta` |

python/packages/hosting-telegram/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

python/packages/hosting-telegram/README.md

@@ -0,0 +1,29 @@
+# agent-framework-hosting-telegram
+
+Telegram channel for [agent-framework-hosting](../hosting). Supports both
+**polling** (default — no public URL required, perfect for local dev) and
+**webhook** transports, multi-content messages (text + media), command
+registration, and end-to-end SSE-style streaming via Telegram message edits.
+
+## Usage
+
+```python
+from agent_framework_hosting import AgentFrameworkHost
+from agent_framework_hosting_telegram import TelegramChannel
+
+host = AgentFrameworkHost(
+    target=my_agent,
+    channels=[TelegramChannel(bot_token="...")],
+)
+host.serve()
+```
+
+For production, configure `webhook_url="https://…"` and the channel will
+register the webhook on startup and receive updates over HTTPS.
+
+## Identity & sessions
+
+Each Telegram chat is mapped to an opaque isolation key
+(`telegram:<chat_id>`) so other channels can opt into the same per-chat
+session by reusing the same key. The helper `telegram_isolation_key(chat_id)`
+is exported for that purpose.

python/packages/hosting-telegram/agent_framework_hosting_telegram/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""Telegram channel for :mod:`agent_framework_hosting`."""
+
+from ._channel import TelegramChannel, telegram_isolation_key
+
+__all__ = ["TelegramChannel", "telegram_isolation_key"]