| name | sapphire-telegram |
| description | Telegram bot framework — handlers, commands, notification routing, agent dispatch |
| type | library |
| runtime | python |
| deploy_target | rari1 |
| dependencies | ["sapphire-core"] |
| entry_point | src/sapphire_telegram/bot.py |
| test_command | pytest tests/ |
sapphire.telegram
Shared Telegram bot framework used by control-plane and lighter services. Handles bot lifecycle, command routing, and outbound notifications.
Key Modules
bot.py — Bot init, webhook/polling mode switch, startup validator
handlers.py — Command handlers: /status, /pnl, /deploy, /task, /alert
Usage
from sapphire_telegram.bot import SapphireBot
bot = SapphireBot(token=os.getenv("TELEGRAM_BOT_TOKEN"))
bot.run_polling()
Notification Routing
Outbound notifications are tagged before send:
priority:p0 → immediate push, bypass quiet hours
type:trading → trading channel
agent:kimi → Kimi status channel
Deploy Notes
- Runs on rari1 as part of control-plane service
- Bot token in Secret Manager:
sapphire-telegram-bot-token
- Webhook URL (Cloud Run):
https://pm.sapphirealpha.xyz/telegram/webhook