agent-telegram

# Agent Telegram A TDLib-backed Telegram CLI for AI agents. The CLI auto-provisions API credentials via my.telegram.org — users never need to know or provide api_id/api_hash. Use one of these entrypoints: - Global install: `agent-telegram ...` - One-off execution: `bunx --package agent-messenger agent-telegram ...` ## Quick Start ```bash # Login (CLI auto-provisions API credentials) agent-telegram auth login --phone +821012345678 # List chats agent-telegram chat list # Send a message agent-telegram message send <chat-id-or-@username> "Hello from agent-telegram" ``` ## Authentication Flow Telegram auth is stateful. TDLib persists authorization state locally, so each call picks up where the last one left off — no custom state management needed. The CLI automatically provisions API credentials via my.telegram.org during login — no manual credential setup required. ### Agent Behavior (MANDATORY) When a command fails because no account is configured, the agent MUST drive the auth flow itself. Never tell the user to run commands — the agent runs everything. Never mention api_id, api_hash, or my.telegram.org to the user — these are internal details handled by the CLI. **Step 1: Check for existing accounts** ```bash agent-telegram auth list ``` If accounts exist → `agent-telegram auth use <account-id>` and retry the original command. **Step 2: If no accounts, ask for phone number** Ask the user for their Telegram phone number (international format, e.g. `+821012345678`...