Files
Eduard van Valkenburg 36ce0950e4 Simplify Python hosting core (#6492)
Remove linking, multicast, durable delivery, and host push machinery from the v1 hosting core. Keep those scenarios in a proposed follow-up ADR and update channel packages, samples, docs, tests, and workspace metadata around the smaller host/channel contract.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
36ce0950e4 · 2026-06-12 08:34:08 +02:00
History
..

agent-framework-hosting-telegram

Telegram channel for agent-framework-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

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.