Configuration

Config key	Env fallback	Default	Meaning
`token`	`DSH_TELEGRAM_TOKEN`	— (required)	Telegram bot token.
`allowedChatIds`	`DSH_TELEGRAM_ALLOWED_CHATS`	`[]` (deny all)	Authorized chat ids. Note: schemastery validates a missing array to `[]`, so an empty/absent allowlist always falls back to the environment.
`apiBase`	—	`https://api.telegram.org`	Bot API base (useful for proxies and tests).
`defaultAgentId`	—	none	Session id plain messages target when the chat has no `/agent` selection.
`pollTimeoutSec`	—	`50`	Long-poll `getUpdates` timeout (Telegram accepts up to 50).
`replyTimeoutMs`	—	`600000` (10 min)	Max wait for an agent reply before flushing partial output with a note.
`showToolCalls`	—	`false`	Emit one-line `🔧` notices while a reply is pending.
`maxMessageChars`	—	`4000`	Per-message character cap before Telegram-side splitting.

dsh-telegram-control