Skip to content
This repository was archived by the owner on Aug 5, 2026. It is now read-only.

Commit 324bce1

Browse files
authored
feat: add native Telegram bot integration (#19)
* feat: add native Telegram bot integration (#97) - Add grammy dependency for Telegram bot API - Create telegram_sessions and telegram_allowlist database tables - Create TelegramService with message handling, session persistence, and allowlist - Add /api/telegram/* routes for bot management - Auto-start bot when TELEGRAM_BOT_TOKEN env var is set - Add telegram status to /api/health endpoint - Add 44 unit tests (26 service + 18 routes) - total now 147 tests - Update docs/requirements.md with native Telegram integration specs * docs: update plan.md with PR link * docs: replace example tokens with placeholders to avoid GitGuardian false positives * test: add STT routes unit tests (14 tests) * docs: update plan.md with STT tests and test coverage gaps
1 parent 82df0e3 commit 324bce1

12 files changed

Lines changed: 1577 additions & 16 deletions

File tree

‎backend/src/db/migrations.ts‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,31 @@ export function runMigrations(db: Database): void {
143143
logger.debug('Scheduled tasks table might already exist:', error)
144144
}
145145

146+
try {
147+
db.run(`
148+
CREATE TABLE IF NOT EXISTS telegram_sessions (
149+
id INTEGER PRIMARY KEY AUTOINCREMENT,
150+
chat_id TEXT UNIQUE NOT NULL,
151+
opencode_session_id TEXT NOT NULL,
152+
created_at INTEGER NOT NULL,
153+
updated_at INTEGER NOT NULL
154+
)
155+
`)
156+
db.run('CREATE INDEX IF NOT EXISTS idx_telegram_sessions_chat_id ON telegram_sessions(chat_id)')
157+
158+
db.run(`
159+
CREATE TABLE IF NOT EXISTS telegram_allowlist (
160+
id INTEGER PRIMARY KEY AUTOINCREMENT,
161+
chat_id TEXT UNIQUE NOT NULL,
162+
added_at INTEGER NOT NULL
163+
)
164+
`)
165+
db.run('CREATE INDEX IF NOT EXISTS idx_telegram_allowlist_chat_id ON telegram_allowlist(chat_id)')
166+
logger.info('Telegram tables created/verified')
167+
} catch (error) {
168+
logger.debug('Telegram tables might already exist:', error)
169+
}
170+
146171
logger.info('Database migrations completed successfully')
147172
} catch (error) {
148173
logger.error('Failed to run database migrations:', error)

‎backend/src/index.ts‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,10 @@ import { createOAuthRoutes } from './routes/oauth'
1919
import { createTerminalRoutes, registerTerminalSocketIO } from './routes/terminal'
2020
import { createPushRoutes } from './routes/push'
2121
import { createTaskRoutes } from './routes/tasks'
22+
import { createTelegramRoutes } from './routes/telegram'
2223
import { terminalService } from './services/terminal'
2324
import { schedulerService } from './services/scheduler'
25+
import { telegramService } from './services/telegram'
2426
import { whisperServerManager } from './services/whisper'
2527
import { ensureDirectoryExists, writeFileContent, fileExists, readFileContent } from './services/file-operations'
2628
import { SettingsService } from './services/settings'
@@ -332,6 +334,19 @@ try {
332334
logger.warn('Scheduler service failed to initialize:', error)
333335
}
334336

337+
try {
338+
telegramService.setDatabase(db)
339+
telegramService.seedAllowlistFromEnv()
340+
341+
const telegramToken = process.env.TELEGRAM_BOT_TOKEN
342+
if (telegramToken) {
343+
await telegramService.start(telegramToken)
344+
logger.info('Telegram bot started automatically (TELEGRAM_BOT_TOKEN detected)')
345+
}
346+
} catch (error) {
347+
logger.warn('Telegram bot failed to start:', error)
348+
}
349+
335350
// Chatterbox auto-start disabled - use on-demand via API
336351
// try {
337352
// await chatterboxServerManager.start()
@@ -355,6 +370,7 @@ app.route('/api/stt', createSTTRoutes(db))
355370
app.route('/api/terminal', createTerminalRoutes())
356371
app.route('/api/push', createPushRoutes(db))
357372
app.route('/api/tasks', createTaskRoutes(db))
373+
app.route('/api/telegram', createTelegramRoutes(db))
358374

359375
app.all('/api/opencode/*', async (c) => {
360376
const request = c.req.raw
@@ -472,6 +488,8 @@ const shutdown = async (signal: string) => {
472488
logger.info('Terminal sessions destroyed')
473489
await schedulerService.shutdown()
474490
logger.info('Scheduler service stopped')
491+
await telegramService.stop()
492+
logger.info('Telegram bot stopped')
475493
await whisperServerManager.stop()
476494
logger.info('Whisper server stopped')
477495
await chatterboxServerManager.stop()

‎backend/src/routes/health.ts‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
import { Hono } from 'hono'
22
import type { Database } from 'bun:sqlite'
33
import { opencodeServerManager } from '../services/opencode-single-server'
4+
import { telegramService } from '../services/telegram'
45

56
export function createHealthRoutes(db: Database) {
67
const app = new Hono()
@@ -10,6 +11,7 @@ export function createHealthRoutes(db: Database) {
1011
const dbCheck = db.prepare('SELECT 1').get()
1112
const opencodeHealthy = await opencodeServerManager.checkHealth()
1213
const startupError = opencodeServerManager.getLastStartupError()
14+
const telegramStatus = telegramService.getStatus()
1315

1416
const status = startupError && !opencodeHealthy
1517
? 'unhealthy'
@@ -23,7 +25,12 @@ export function createHealthRoutes(db: Database) {
2325
opencodePort: opencodeServerManager.getPort(),
2426
opencodeVersion: opencodeServerManager.getVersion(),
2527
opencodeMinVersion: opencodeServerManager.getMinVersion(),
26-
opencodeVersionSupported: opencodeServerManager.isVersionSupported()
28+
opencodeVersionSupported: opencodeServerManager.isVersionSupported(),
29+
telegram: {
30+
running: telegramStatus.running,
31+
sessions: telegramStatus.activeSessions,
32+
allowlist: telegramStatus.allowlistCount,
33+
},
2734
}
2835

2936
if (startupError && !opencodeHealthy) {

‎backend/src/routes/telegram.ts‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
import { Hono } from 'hono'
2+
import { z } from 'zod'
3+
import { Database } from 'bun:sqlite'
4+
import { telegramService } from '../services/telegram'
5+
import { logger } from '../utils/logger'
6+
7+
const AddToAllowlistSchema = z.object({
8+
chatId: z.string().min(1),
9+
})
10+
11+
const StartBotSchema = z.object({
12+
token: z.string().min(1),
13+
})
14+
15+
export function createTelegramRoutes(db: Database) {
16+
const app = new Hono()
17+
18+
telegramService.setDatabase(db)
19+
20+
app.get('/status', async (c) => {
21+
const status = telegramService.getStatus()
22+
return c.json(status)
23+
})
24+
25+
app.post('/start', async (c) => {
26+
try {
27+
const body = await c.req.json()
28+
const parsed = StartBotSchema.safeParse(body)
29+
30+
if (!parsed.success) {
31+
const token = process.env.TELEGRAM_BOT_TOKEN
32+
if (!token) {
33+
return c.json({ error: 'No token provided and TELEGRAM_BOT_TOKEN not set' }, 400)
34+
}
35+
await telegramService.start(token)
36+
} else {
37+
await telegramService.start(parsed.data.token)
38+
}
39+
40+
return c.json({ success: true, status: telegramService.getStatus() })
41+
} catch (error) {
42+
logger.error('Failed to start Telegram bot:', error)
43+
return c.json({
44+
error: error instanceof Error ? error.message : 'Failed to start bot'
45+
}, 500)
46+
}
47+
})
48+
49+
app.post('/stop', async (c) => {
50+
try {
51+
await telegramService.stop()
52+
return c.json({ success: true })
53+
} catch (error) {
54+
logger.error('Failed to stop Telegram bot:', error)
55+
return c.json({
56+
error: error instanceof Error ? error.message : 'Failed to stop bot'
57+
}, 500)
58+
}
59+
})
60+
61+
app.get('/sessions', async (c) => {
62+
const sessions = telegramService.getAllSessions()
63+
return c.json(sessions)
64+
})
65+
66+
app.delete('/sessions/:chatId', async (c) => {
67+
const chatId = c.req.param('chatId')
68+
const deleted = telegramService.deleteSession(chatId)
69+
70+
if (deleted) {
71+
return c.json({ success: true })
72+
}
73+
return c.json({ error: 'Session not found' }, 404)
74+
})
75+
76+
app.get('/allowlist', async (c) => {
77+
const allowlist = telegramService.getAllowlist()
78+
return c.json(allowlist)
79+
})
80+
81+
app.post('/allowlist', async (c) => {
82+
try {
83+
const body = await c.req.json()
84+
const parsed = AddToAllowlistSchema.safeParse(body)
85+
86+
if (!parsed.success) {
87+
return c.json({ error: 'Invalid request: chatId is required' }, 400)
88+
}
89+
90+
telegramService.addToAllowlist(parsed.data.chatId)
91+
return c.json({ success: true })
92+
} catch (error) {
93+
return c.json({
94+
error: error instanceof Error ? error.message : 'Failed to add to allowlist'
95+
}, 500)
96+
}
97+
})
98+
99+
app.delete('/allowlist/:chatId', async (c) => {
100+
const chatId = c.req.param('chatId')
101+
const removed = telegramService.removeFromAllowlist(chatId)
102+
103+
if (removed) {
104+
return c.json({ success: true })
105+
}
106+
return c.json({ error: 'Chat ID not found in allowlist' }, 404)
107+
})
108+
109+
return app
110+
}

0 commit comments

Comments
 (0)