@gonzih/cc-tg 0.9.30 → 0.9.31

package/dist/bot.js

@@ -0,0 +1,1525 @@
+/**
+ * Telegram bot that routes messages to/from a Claude Code subprocess.
+ * One ClaudeProcess per chat_id — sessions are isolated per user.
+ */
+import TelegramBot from "node-telegram-bot-api";
+import { existsSync, createWriteStream, mkdirSync, statSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import { resolve, basename, join } from "path";
+import os from "os";
+import { execSync, spawn } from "child_process";
+import https from "https";
+import http from "http";
+import { ClaudeProcess, extractText } from "./claude.js";
+import { transcribeVoice, isVoiceAvailable } from "./voice.js";
+import { formatForTelegram, splitLongMessage } from "./formatter.js";
+import { detectUsageLimit } from "./usage-limit.js";
+import { getCurrentToken, rotateToken, getTokenIndex, getTokenCount } from "./tokens.js";
+import { writeChatLog } from "./notifier.js";
+import { CronManager } from "./cron.js";
+const BOT_COMMANDS = [
+    { command: "start", description: "Reset session and start fresh" },
+    { command: "reset", description: "Reset Claude session" },
+    { command: "stop", description: "Stop the current Claude task" },
+    { command: "status", description: "Check if a session is active" },
+    { command: "help", description: "Show all available commands" },
+    { command: "reload_mcp", description: "Restart the cc-agent MCP server process" },
+    { command: "mcp_status", description: "Check MCP server connection status" },
+    { command: "mcp_version", description: "Show cc-agent npm version and npx cache info" },
+    { command: "clear_npx_cache", description: "Clear npx cache and restart MCP to pick up latest version" },
+    { command: "restart", description: "Restart the bot process in-place" },
+    { command: "get_file", description: "Send a file from the server to this chat" },
+    { command: "cost", description: "Show session token usage and cost" },
+    { command: "skills", description: "List available Claude skills with descriptions" },
+    { command: "cron", description: "Manage cron jobs — add/list/edit/remove/clear" },
+    { command: "voice_retry", description: "Retry failed voice message transcriptions" },
+    { command: "drivers", description: "List available agent drivers" },
+    { command: "agents", description: "Show running meta-agents and their live status" },
+];
+const FLUSH_DELAY_MS = 800; // debounce streaming chunks into one Telegram message
+const TYPING_INTERVAL_MS = 4000; // re-send typing action before Telegram's 5s expiry
+// Claude Sonnet 4.6 pricing (per 1M tokens)
+const PRICING = {
+    inputPerM: 3.00,
+    outputPerM: 15.00,
+    cacheReadPerM: 0.30,
+    cacheWritePerM: 3.75,
+};
+function computeCostUsd(usage) {
+    return (usage.inputTokens * PRICING.inputPerM / 1_000_000 +
+        usage.outputTokens * PRICING.outputPerM / 1_000_000 +
+        usage.cacheReadTokens * PRICING.cacheReadPerM / 1_000_000 +
+        usage.cacheWriteTokens * PRICING.cacheWritePerM / 1_000_000);
+}
+/** Prepend [MM-DD HH:mm] so Claude knows when the message was received. Not shown in Telegram. */
+export function stampPrompt(text, now = new Date()) {
+    const mm = String(now.getMonth() + 1).padStart(2, "0");
+    const dd = String(now.getDate()).padStart(2, "0");
+    const hh = String(now.getHours()).padStart(2, "0");
+    const min = String(now.getMinutes()).padStart(2, "0");
+    return `[${mm}-${dd} ${hh}:${min}] ${text}`;
+}
+function formatTokens(n) {
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return String(n);
+}
+function formatCostReport(cost) {
+    const inputCost = cost.totalInputTokens * PRICING.inputPerM / 1_000_000;
+    const outputCost = cost.totalOutputTokens * PRICING.outputPerM / 1_000_000;
+    const cacheReadCost = cost.totalCacheReadTokens * PRICING.cacheReadPerM / 1_000_000;
+    const cacheWriteCost = cost.totalCacheWriteTokens * PRICING.cacheWritePerM / 1_000_000;
+    return [
+        "📊 Session cost",
+        `Messages: ${cost.messageCount}`,
+        `Total: $${cost.totalCostUsd.toFixed(3)}`,
+        `  Input: ${formatTokens(cost.totalInputTokens)} tokens ($${inputCost.toFixed(3)})`,
+        `  Output: ${formatTokens(cost.totalOutputTokens)} tokens ($${outputCost.toFixed(3)})`,
+        `  Cache read: ${formatTokens(cost.totalCacheReadTokens)} tokens ($${cacheReadCost.toFixed(3)})`,
+        `  Cache write: ${formatTokens(cost.totalCacheWriteTokens)} tokens ($${cacheWriteCost.toFixed(3)})`,
+    ].join("\n");
+}
+function formatAgentCostSummary(text) {
+    try {
+        const data = JSON.parse(text);
+        const totalCost = (data.total_cost_usd ?? data.total_cost ?? 0);
+        const byRepo = (data.by_repo ?? []);
+        if (byRepo.length === 0) {
+            return "No cost data available yet.";
+        }
+        const lines = ["💰 Cost Summary", ""];
+        // Align repo names with right-padded costs
+        const maxLen = Math.max(...byRepo.map((e) => (e.repo ?? e.repository ?? "unknown").length));
+        for (const entry of byRepo) {
+            const repo = (entry.repo ?? entry.repository ?? "unknown");
+            const cost = (entry.cost_usd ?? entry.cost ?? 0);
+            const pad = " ".repeat(maxLen - repo.length + 3);
+            lines.push(`${repo}${pad}$${cost.toFixed(2)}`);
+        }
+        lines.push("");
+        lines.push(`Total: $${totalCost.toFixed(2)}`);
+        return lines.join("\n");
+    }
+    catch {
+        return `💰 Cost Summary\n${text}`;
+    }
+}
+class CostStore {
+    costs = new Map();
+    storePath;
+    constructor(cwd) {
+        this.storePath = join(cwd, ".cc-tg", "costs.json");
+        this.load();
+    }
+    get(chatId) {
+        let cost = this.costs.get(chatId);
+        if (!cost) {
+            cost = { totalInputTokens: 0, totalOutputTokens: 0, totalCacheReadTokens: 0, totalCacheWriteTokens: 0, totalCostUsd: 0, messageCount: 0 };
+            this.costs.set(chatId, cost);
+        }
+        return cost;
+    }
+    addUsage(chatId, usage) {
+        const cost = this.get(chatId);
+        cost.totalInputTokens += usage.inputTokens;
+        cost.totalOutputTokens += usage.outputTokens;
+        cost.totalCacheReadTokens += usage.cacheReadTokens;
+        cost.totalCacheWriteTokens += usage.cacheWriteTokens;
+        cost.totalCostUsd += computeCostUsd(usage);
+        this.persist();
+    }
+    incrementMessages(chatId) {
+        const cost = this.get(chatId);
+        cost.messageCount++;
+        this.persist();
+    }
+    persist() {
+        try {
+            const dir = join(this.storePath, "..");
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            const data = {};
+            for (const [chatId, cost] of this.costs) {
+                data[String(chatId)] = cost;
+            }
+            writeFileSync(this.storePath, JSON.stringify(data, null, 2));
+        }
+        catch (err) {
+            console.error("[costs] persist error:", err.message);
+        }
+    }
+    load() {
+        if (!existsSync(this.storePath))
+            return;
+        try {
+            const data = JSON.parse(readFileSync(this.storePath, "utf8"));
+            for (const [key, cost] of Object.entries(data)) {
+                this.costs.set(Number(key), cost);
+            }
+            console.log(`[costs] loaded ${this.costs.size} session costs from disk`);
+        }
+        catch (err) {
+            console.error("[costs] load error:", err.message);
+        }
+    }
+}
+export class CcTgBot {
+    bot;
+    sessions = new Map();
+    pendingRetries = new Map();
+    opts;
+    costStore;
+    botUsername = "";
+    botId = 0;
+    redis;
+    namespace;
+    lastActiveChatId;
+    cron;
+    constructor(opts) {
+        this.opts = opts;
+        this.redis = opts.redis;
+        this.namespace = opts.namespace ?? "default";
+        this.bot = new TelegramBot(opts.telegramToken, { polling: true });
+        this.bot.on("message", (msg) => this.handleTelegram(msg));
+        this.bot.on("polling_error", (err) => console.error("[tg]", err.message));
+        this.bot.getMe().then((me) => {
+            this.botUsername = me.username ?? "";
+            this.botId = me.id;
+            console.log(`[tg] bot identity: @${this.botUsername} (id=${this.botId})`);
+        }).catch((err) => console.error("[tg] getMe failed:", err.message));
+        this.costStore = new CostStore(opts.cwd ?? process.cwd());
+        this.cron = new CronManager(opts.cwd ?? process.cwd(), (chatId, prompt, _jobId, done) => {
+            this.runCronTask(chatId, prompt, done);
+        });
+        this.registerBotCommands();
+        console.log("cc-tg bot started");
+        console.log(`[voice] whisper available: ${isVoiceAvailable()}`);
+    }
+    registerBotCommands() {
+        this.bot.setMyCommands(BOT_COMMANDS)
+            .then(() => console.log("[tg] bot commands registered"))
+            .catch((err) => console.error("[tg] setMyCommands failed:", err.message));
+    }
+    /** Write a message to the Redis chat log. Fire-and-forget — no-op if Redis is not configured. */
+    writeChatMessage(role, source, content, chatId) {
+        if (!this.redis)
+            return;
+        const msg = {
+            id: `${source}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+            source,
+            role,
+            content,
+            timestamp: new Date().toISOString(),
+            chatId,
+        };
+        writeChatLog(this.redis, this.namespace, msg);
+    }
+    /** Returns the last chatId that sent a message — used by the chat bridge when no fixed chatId is configured. */
+    getLastActiveChatId() {
+        return this.lastActiveChatId;
+    }
+    /** Session key: "chatId:threadId" for topics, "chatId:main" for DMs/non-topic groups */
+    sessionKey(chatId, threadId) {
+        return `${chatId}:${threadId ?? 'main'}`;
+    }
+    /**
+     * Send a message back to the correct thread (or plain chat if no thread).
+     * When threadId is undefined, calls sendMessage with exactly 2 args to preserve
+     * backward-compatible call signatures (no extra options object).
+     */
+    replyToChat(chatId, text, threadId, opts) {
+        if (threadId !== undefined) {
+            return this.bot.sendMessage(chatId, text, { ...opts, message_thread_id: threadId });
+        }
+        if (opts) {
+            return this.bot.sendMessage(chatId, text, opts);
+        }
+        return this.bot.sendMessage(chatId, text);
+    }
+    /** Parse THREAD_CWD_MAP env var — maps thread name or thread_id to a CWD path */
+    getThreadCwdMap() {
+        const raw = process.env.THREAD_CWD_MAP;
+        if (!raw)
+            return {};
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            console.warn('[cc-tg] THREAD_CWD_MAP is not valid JSON, ignoring');
+            return {};
+        }
+    }
+    isAllowed(userId) {
+        if (!this.opts.allowedUserIds?.length)
+            return true;
+        return this.opts.allowedUserIds.includes(userId);
+    }
+    async handleTelegram(msg) {
+        const chatId = msg.chat.id;
+        const userId = msg.from?.id ?? chatId;
+        // Forum topic thread_id — undefined for DMs and non-topic group messages
+        const threadId = msg.message_thread_id;
+        // Thread name is available on the service message that creates a new topic.
+        // forum_topic_created is not in older @types/node-telegram-bot-api versions, so cast via unknown.
+        const rawMsg = msg;
+        const threadName = rawMsg.forum_topic_created
+            ? rawMsg.forum_topic_created.name
+            : undefined;
+        if (!this.isAllowed(userId)) {
+            await this.replyToChat(chatId, "Not authorized.", threadId);
+            return;
+        }
+        // Track the last chat that sent us a message for the chat bridge
+        this.lastActiveChatId = chatId;
+        // Group chat handling
+        const isGroup = msg.chat.type === "group" || msg.chat.type === "supergroup";
+        if (isGroup) {
+            // If GROUP_CHAT_IDS allowlist is set, only respond in those chats
+            if (this.opts.groupChatIds?.length && !this.opts.groupChatIds.includes(chatId)) {
+                return;
+            }
+            // Only respond if: bot is @mentioned, message is a reply to the bot, or text starts with /
+            const text = msg.text?.trim() ?? "";
+            const isMentioned = this.botUsername && text.includes(`@${this.botUsername}`);
+            const isReplyToBot = msg.reply_to_message?.from?.id === this.botId;
+            const isCommand = text.startsWith("/");
+            if (!isMentioned && !isReplyToBot && !isCommand) {
+                return;
+            }
+        }
+        // Voice message — transcribe then feed as text
+        if (msg.voice || msg.audio) {
+            await this.handleVoice(chatId, msg, threadId, threadName);
+            return;
+        }
+        // Photo — send as base64 image content block to Claude
+        if (msg.photo?.length) {
+            await this.handlePhoto(chatId, msg, threadId, threadName);
+            return;
+        }
+        // Document — download to CWD/.cc-tg/uploads/, tell Claude the path
+        if (msg.document) {
+            await this.handleDocument(chatId, msg, threadId, threadName);
+            return;
+        }
+        let text = msg.text?.trim();
+        if (!text)
+            return;
+        // Strip @botname mention prefix in group chats
+        if (this.botUsername) {
+            text = text.replace(new RegExp(`@${this.botUsername}\\s*`, "g"), "").trim();
+        }
+        const sessionKey = this.sessionKey(chatId, threadId);
+        // /start or /reset — kill existing session and ack
+        if (text === "/start" || text === "/reset") {
+            this.killSession(chatId, true, threadId);
+            await this.replyToChat(chatId, "Session reset. Send a message to start.", threadId);
+            return;
+        }
+        // /stop — kill active session (interrupt running Claude task)
+        if (text === "/stop") {
+            const has = this.sessions.has(sessionKey);
+            this.killSession(chatId, true, threadId);
+            await this.replyToChat(chatId, has ? "Stopped." : "No active session.", threadId);
+            return;
+        }
+        // /help — list all commands
+        if (text === "/help") {
+            const lines = BOT_COMMANDS.map((c) => `/${c.command} — ${c.description}`);
+            await this.replyToChat(chatId, lines.join("\n"), threadId);
+            return;
+        }
+        // /status
+        if (text === "/status") {
+            const has = this.sessions.has(sessionKey);
+            let status = has ? "Session active." : "No active session.";
+            const sleeping = this.pendingRetries.size;
+            if (sleeping > 0)
+                status += `\n⏸ ${sleeping} request(s) sleeping (usage limit).`;
+            await this.replyToChat(chatId, status, threadId);
+            return;
+        }
+        // /reload_mcp — kill cc-agent process so Claude Code auto-restarts it
+        if (text === "/reload_mcp") {
+            await this.handleReloadMcp(chatId, threadId);
+            return;
+        }
+        // /mcp_status — run `claude mcp list` and show connection status
+        if (text === "/mcp_status") {
+            await this.handleMcpStatus(chatId, threadId);
+            return;
+        }
+        // /mcp_version — show published npm version and cached npx entries
+        if (text === "/mcp_version") {
+            await this.handleMcpVersion(chatId, threadId);
+            return;
+        }
+        // /clear_npx_cache — wipe ~/.npm/_npx/ then restart cc-agent
+        if (text === "/clear_npx_cache") {
+            await this.handleClearNpxCache(chatId, threadId);
+            return;
+        }
+        // /restart — restart the bot process in-place
+        if (text === "/restart") {
+            await this.handleRestart(chatId, threadId);
+            return;
+        }
+        // /cron <schedule> <prompt> | /cron list | /cron clear | /cron remove <id>
+        if (text.startsWith("/cron")) {
+            await this.handleCron(chatId, text, threadId);
+            return;
+        }
+        // /get_file <path> — send a file from the server to the user
+        if (text.startsWith("/get_file")) {
+            await this.handleGetFile(chatId, text, threadId);
+            return;
+        }
+        // /cost — show session token usage and cost
+        if (text === "/cost") {
+            const cost = this.costStore.get(chatId);
+            let reply = formatCostReport(cost);
+            try {
+                const rawSummary = await this.callCcAgentTool("cost_summary");
+                if (rawSummary) {
+                    reply += "\n\n" + formatAgentCostSummary(rawSummary);
+                }
+            }
+            catch (err) {
+                console.error("[cost] cc-agent cost_summary failed:", err.message);
+            }
+            await this.replyToChat(chatId, reply, threadId);
+            return;
+        }
+        // /skills — list available Claude skills from ~/.claude/skills/
+        if (text === "/skills") {
+            await this.replyToChat(chatId, listSkills(), threadId);
+            return;
+        }
+        // /voice_retry — retry failed voice message transcriptions
+        if (text === "/voice_retry") {
+            await this.handleVoiceRetry(chatId, threadId);
+            return;
+        }
+        // /drivers — list available agent drivers via cc-agent MCP
+        if (text === "/drivers") {
+            await this.handleDrivers(chatId, threadId);
+            return;
+        }
+        // /agents — show running meta-agents and their live status
+        if (text === "/agents") {
+            await this.handleAgents(chatId, threadId);
+            return;
+        }
+        const session = this.getOrCreateSession(chatId, threadId, threadName);
+        try {
+            const enriched = await enrichPromptWithUrls(text);
+            const prompt = buildPromptWithReplyContext(enriched, msg);
+            session.currentPrompt = prompt;
+            session.claude.sendPrompt(stampPrompt(prompt));
+            this.startTyping(chatId, session);
+            this.writeChatMessage("user", "telegram", text, chatId);
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Error sending to Claude: ${err.message}`, threadId);
+            this.killSession(chatId, true, threadId);
+        }
+    }
+    /**
+     * Feed a text message into the active Claude session for the given chat.
+     * Called by the notifier when a UI message arrives via Redis pub/sub.
+     */
+    async handleUserMessage(chatId, text) {
+        const session = this.getOrCreateSession(chatId);
+        try {
+            const enriched = await enrichPromptWithUrls(text);
+            session.currentPrompt = enriched;
+            session.claude.sendPrompt(stampPrompt(enriched));
+            this.startTyping(chatId, session);
+            this.writeChatMessage("user", "ui", text, chatId);
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Error sending to Claude: ${err.message}`);
+            this.killSession(chatId, true);
+        }
+    }
+    async handleVoice(chatId, msg, threadId, threadName) {
+        const fileId = msg.voice?.file_id ?? msg.audio?.file_id;
+        if (!fileId)
+            return;
+        console.log(`[voice:${chatId}] received voice message, transcribing...`);
+        this.bot.sendChatAction(chatId, "typing", threadId !== undefined ? { message_thread_id: threadId } : undefined).catch(() => { });
+        // Store in Redis before transcription so we can retry on failure
+        const pendingEntry = JSON.stringify({
+            file_id: fileId,
+            chat_id: chatId,
+            message_id: msg.message_id,
+            timestamp: Date.now(),
+        });
+        if (this.redis) {
+            await this.redis.rpush("voice:pending", pendingEntry).catch((err) => console.warn("[voice] redis rpush voice:pending failed:", err.message));
+        }
+        try {
+            const fileLink = await this.bot.getFileLink(fileId);
+            const transcript = await transcribeVoice(fileLink);
+            console.log(`[voice:${chatId}] transcribed: ${transcript}`);
+            // Remove from pending on success
+            if (this.redis) {
+                await this.redis.lrem("voice:pending", 0, pendingEntry).catch((err) => console.warn("[voice] redis lrem voice:pending failed:", err.message));
+            }
+            if (!transcript || transcript === "[empty transcription]") {
+                await this.replyToChat(chatId, "Could not transcribe voice message.", threadId);
+                return;
+            }
+            // Feed transcript into Claude as if user typed it
+            const session = this.getOrCreateSession(chatId, threadId, threadName);
+            try {
+                const prompt = buildPromptWithReplyContext(transcript, msg);
+                this.writeChatMessage("user", "telegram", transcript, chatId);
+                session.currentPrompt = prompt;
+                session.claude.sendPrompt(stampPrompt(prompt));
+                this.startTyping(chatId, session);
+            }
+            catch (err) {
+                await this.replyToChat(chatId, `Error sending to Claude: ${err.message}`, threadId);
+                this.killSession(chatId, true, threadId);
+            }
+        }
+        catch (err) {
+            const errMsg = err.message;
+            console.error(`[voice:${chatId}] error:`, errMsg);
+            // Push to voice:failed on failure (entry stays in voice:pending for retry)
+            if (this.redis) {
+                const failedEntry = JSON.stringify({
+                    file_id: fileId,
+                    chat_id: chatId,
+                    message_id: msg.message_id,
+                    timestamp: Date.now(),
+                    error: errMsg,
+                    failed_at: Date.now(),
+                });
+                this.redis.rpush("voice:failed", failedEntry)
+                    .then(() => this.redis.expire("voice:failed", 48 * 60 * 60))
+                    .catch((redisErr) => console.warn("[voice] redis write voice:failed failed:", redisErr.message));
+            }
+            // User-friendly error messages
+            let userMsg;
+            if (errMsg.includes("whisper-cpp not found") || errMsg.includes("whisper not found")) {
+                userMsg = "Voice transcription unavailable — whisper-cpp not installed";
+            }
+            else if (errMsg.includes("No whisper model found")) {
+                userMsg = "Voice transcription unavailable — no whisper model found";
+            }
+            else if (errMsg.includes("HTTP") && errMsg.includes("downloading")) {
+                userMsg = "Could not download voice file from Telegram";
+            }
+            else {
+                userMsg = `Voice transcription failed: ${errMsg}`;
+            }
+            await this.replyToChat(chatId, userMsg, threadId);
+        }
+    }
+    async handleVoiceRetry(chatId, threadId) {
+        if (!this.redis) {
+            await this.replyToChat(chatId, "Redis not configured — voice retry unavailable.", threadId);
+            return;
+        }
+        const [pendingRaw, failedRaw] = await Promise.all([
+            this.redis.lrange("voice:pending", 0, -1).catch(() => []),
+            this.redis.lrange("voice:failed", 0, -1).catch(() => []),
+        ]);
+        // Deduplicate by file_id across both lists
+        const allEntries = new Map();
+        for (const raw of [...pendingRaw, ...failedRaw]) {
+            try {
+                const entry = JSON.parse(raw);
+                if (entry.file_id)
+                    allEntries.set(entry.file_id, entry);
+            }
+            catch { /* skip malformed entries */ }
+        }
+        if (allEntries.size === 0) {
+            await this.replyToChat(chatId, "No pending voice messages to retry.", threadId);
+            return;
+        }
+        await this.replyToChat(chatId, `Retrying ${allEntries.size} voice message(s)...`, threadId);
+        let succeeded = 0;
+        let failed = 0;
+        const errors = [];
+        for (const [fileId, entry] of allEntries) {
+            try {
+                const fileLink = await this.bot.getFileLink(fileId);
+                const transcript = await transcribeVoice(fileLink);
+                if (transcript && transcript !== "[empty transcription]") {
+                    const session = this.getOrCreateSession(entry.chat_id, threadId, undefined);
+                    session.claude.sendPrompt(stampPrompt(transcript));
+                    this.writeChatMessage("user", "telegram", transcript, entry.chat_id);
+                    // Remove from both lists
+                    const matchPending = pendingRaw.find((r) => r.includes(`"${fileId}"`));
+                    const matchFailed = failedRaw.find((r) => r.includes(`"${fileId}"`));
+                    if (matchPending)
+                        await this.redis.lrem("voice:pending", 0, matchPending).catch(() => { });
+                    if (matchFailed)
+                        await this.redis.lrem("voice:failed", 0, matchFailed).catch(() => { });
+                    succeeded++;
+                }
+                else {
+                    failed++;
+                    errors.push(`${fileId}: empty transcription`);
+                }
+            }
+            catch (err) {
+                const errMsg = err.message;
+                failed++;
+                errors.push(`${fileId}: ${errMsg}`);
+                // Permanently unretryable (expired Telegram link) — remove from voice:pending
+                if (errMsg.includes("Bad Request") || errMsg.includes("file_id")) {
+                    const matchPending = pendingRaw.find((r) => r.includes(`"${fileId}"`));
+                    if (matchPending)
+                        await this.redis.lrem("voice:pending", 0, matchPending).catch(() => { });
+                }
+            }
+        }
+        // Purge stale entries from voice:pending older than 48h
+        const staleThreshold = 48 * 60 * 60 * 1000;
+        let purged = 0;
+        for (const raw of pendingRaw) {
+            try {
+                const entry = JSON.parse(raw);
+                if (entry.timestamp && Date.now() - entry.timestamp > staleThreshold) {
+                    await this.redis.lrem("voice:pending", 0, raw).catch(() => { });
+                    purged++;
+                }
+            }
+            catch { /* skip malformed entries */ }
+        }
+        const lines = [`Voice retry complete: ${succeeded} succeeded, ${failed} failed, ${purged} stale entries purged.`];
+        if (errors.length > 0)
+            lines.push(...errors.map((e) => `• ${e}`));
+        await this.replyToChat(chatId, lines.join("\n"), threadId);
+    }
+    async handlePhoto(chatId, msg, threadId, threadName) {
+        // Pick highest resolution photo
+        const photos = msg.photo;
+        const best = photos[photos.length - 1];
+        const caption = msg.caption?.trim();
+        console.log(`[photo:${chatId}] received image file_id=${best.file_id}`);
+        this.bot.sendChatAction(chatId, "typing", threadId !== undefined ? { message_thread_id: threadId } : undefined).catch(() => { });
+        try {
+            const fileLink = await this.bot.getFileLink(best.file_id);
+            const imageData = await fetchAsBase64(fileLink);
+            // Telegram photos are always JPEG
+            const session = this.getOrCreateSession(chatId, threadId, threadName);
+            session.claude.sendImage(imageData, "image/jpeg", stampPrompt(caption ?? ""));
+            this.startTyping(chatId, session);
+        }
+        catch (err) {
+            console.error(`[photo:${chatId}] error:`, err.message);
+            await this.replyToChat(chatId, `Failed to process image: ${err.message}`, threadId);
+        }
+    }
+    async handleDocument(chatId, msg, threadId, threadName) {
+        const doc = msg.document;
+        const caption = msg.caption?.trim();
+        const fileName = doc.file_name ?? `file_${doc.file_id}`;
+        console.log(`[doc:${chatId}] received document file_name=${fileName} mime=${doc.mime_type}`);
+        this.bot.sendChatAction(chatId, "typing", threadId !== undefined ? { message_thread_id: threadId } : undefined).catch(() => { });
+        try {
+            const uploadsDir = join(this.opts.cwd ?? process.cwd(), ".cc-tg", "uploads");
+            mkdirSync(uploadsDir, { recursive: true });
+            const destPath = join(uploadsDir, fileName);
+            const fileLink = await this.bot.getFileLink(doc.file_id);
+            await downloadToFile(fileLink, destPath);
+            console.log(`[doc:${chatId}] saved to ${destPath}`);
+            const prompt = caption
+                ? `${caption}\n\nATTACHMENTS: [${fileName}](${destPath})`
+                : `ATTACHMENTS: [${fileName}](${destPath})`;
+            const session = this.getOrCreateSession(chatId, threadId, threadName);
+            session.claude.sendPrompt(stampPrompt(prompt));
+            this.startTyping(chatId, session);
+        }
+        catch (err) {
+            console.error(`[doc:${chatId}] error:`, err.message);
+            await this.replyToChat(chatId, `Failed to receive document: ${err.message}`, threadId);
+        }
+    }
+    getOrCreateSession(chatId, threadId, threadName) {
+        const key = this.sessionKey(chatId, threadId);
+        const existing = this.sessions.get(key);
+        if (existing && !existing.claude.exited)
+            return existing;
+        // Determine CWD for this thread — check THREAD_CWD_MAP by name then by ID
+        let sessionCwd = this.opts.cwd;
+        const threadCwdMap = this.getThreadCwdMap();
+        if (threadName && threadCwdMap[threadName]) {
+            sessionCwd = threadCwdMap[threadName];
+            console.log(`[cc-tg] thread "${threadName}" → cwd: ${sessionCwd}`);
+        }
+        else if (threadId !== undefined && threadCwdMap[String(threadId)]) {
+            sessionCwd = threadCwdMap[String(threadId)];
+            console.log(`[cc-tg] thread ${threadId} → cwd: ${sessionCwd}`);
+        }
+        const claude = new ClaudeProcess({
+            cwd: sessionCwd,
+            token: getCurrentToken() || this.opts.claudeToken,
+        });
+        const session = {
+            claude,
+            pendingText: "",
+            flushTimer: null,
+            typingTimer: null,
+            writtenFiles: new Set(),
+            currentPrompt: "",
+            isRetry: false,
+            threadId,
+        };
+        claude.on("usage", (usage) => {
+            this.costStore.addUsage(chatId, usage);
+        });
+        claude.on("message", (msg) => {
+            // Verbose logging — log every message type and subtype
+            const subtype = msg.payload.subtype ?? "";
+            const toolName = this.extractToolName(msg);
+            const logParts = [`[claude:${key}] msg=${msg.type}`];
+            if (subtype)
+                logParts.push(`subtype=${subtype}`);
+            if (toolName)
+                logParts.push(`tool=${toolName}`);
+            console.log(logParts.join(" "));
+            // Track files written by Write/Edit tool calls
+            this.trackWrittenFiles(msg, session, sessionCwd);
+            // Publish tool call events to the chat log
+            if (msg.type === "assistant") {
+                const message = msg.payload.message;
+                const content = message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (block.type !== "tool_use")
+                            continue;
+                        const name = block.name;
+                        const input = block.input;
+                        this.writeChatMessage("tool", "cc-tg", `[tool] ${name}: ${JSON.stringify(input ?? {})}`, chatId);
+                    }
+                }
+            }
+            this.handleClaudeMessage(chatId, session, msg);
+        });
+        claude.on("stderr", (data) => {
+            const line = data.trim();
+            if (line)
+                console.error(`[claude:${key}:stderr]`, line);
+        });
+        claude.on("exit", (code) => {
+            console.log(`[claude:${key}] exited code=${code}`);
+            this.stopTyping(session);
+            this.sessions.delete(key);
+        });
+        claude.on("error", (err) => {
+            console.error(`[claude:${key}] process error: ${err.message}`);
+            this.bot.sendMessage(chatId, `Claude process error: ${err.message}`).catch(() => { });
+            this.stopTyping(session);
+            this.sessions.delete(key);
+        });
+        this.sessions.set(key, session);
+        return session;
+    }
+    handleClaudeMessage(chatId, session, msg) {
+        // Use only the final `result` message — it contains the complete response text.
+        // Ignore `assistant` streaming chunks to avoid duplicates.
+        if (msg.type !== "result")
+            return;
+        this.stopTyping(session);
+        this.costStore.incrementMessages(chatId);
+        const text = extractText(msg);
+        if (!text)
+            return;
+        // Check for usage/rate limit signals before forwarding to Telegram
+        const sig = detectUsageLimit(text);
+        if (sig.detected) {
+            const threadId = session.threadId;
+            const retryKey = this.sessionKey(chatId, threadId);
+            const lastPrompt = session.currentPrompt;
+            const prevRetry = this.pendingRetries.get(retryKey);
+            const attempt = (prevRetry?.attempt ?? 0) + 1;
+            if (prevRetry)
+                clearTimeout(prevRetry.timer);
+            this.replyToChat(chatId, sig.humanMessage, threadId).catch(() => { });
+            this.killSession(chatId, true, threadId);
+            // Token rotation: if this is a usage_exhausted signal and we have multiple
+            // tokens, rotate to the next one and retry immediately instead of sleeping.
+            // Only rotate if we haven't yet cycled through all tokens (attempt <= count-1).
+            if (sig.reason === "usage_exhausted" && getTokenCount() > 1 && attempt <= getTokenCount() - 1) {
+                const prevIdx = getTokenIndex();
+                rotateToken();
+                const newIdx = getTokenIndex();
+                const total = getTokenCount();
+                console.log(`[cc-tg] Token ${prevIdx + 1}/${total} exhausted, rotating to token ${newIdx + 1}/${total}`);
+                this.replyToChat(chatId, `🔄 Token ${prevIdx + 1}/${total} exhausted, switching to token ${newIdx + 1}/${total}...`, threadId).catch(() => { });
+                this.pendingRetries.set(retryKey, { text: lastPrompt, attempt, timer: setTimeout(() => { }, 0) });
+                try {
+                    const retrySession = this.getOrCreateSession(chatId, threadId);
+                    retrySession.currentPrompt = lastPrompt;
+                    retrySession.isRetry = true;
+                    retrySession.claude.sendPrompt(stampPrompt(lastPrompt));
+                    this.startTyping(chatId, retrySession);
+                }
+                catch (err) {
+                    this.replyToChat(chatId, `❌ Failed to retry with rotated token: ${err.message}`, threadId).catch(() => { });
+                }
+                return;
+            }
+            if (attempt > 3) {
+                this.replyToChat(chatId, "❌ Claude usage limit persists after 3 retries. Please try again later.", threadId).catch(() => { });
+                this.pendingRetries.delete(retryKey);
+                return;
+            }
+            console.log(`[usage-limit:${retryKey}] ${sig.reason} — scheduling retry attempt=${attempt} in ${sig.retryAfterMs}ms`);
+            const timer = setTimeout(() => {
+                this.pendingRetries.delete(retryKey);
+                try {
+                    const retrySession = this.getOrCreateSession(chatId, threadId);
+                    retrySession.currentPrompt = lastPrompt;
+                    retrySession.isRetry = true;
+                    retrySession.claude.sendPrompt(stampPrompt(lastPrompt));
+                    this.startTyping(chatId, retrySession);
+                }
+                catch (err) {
+                    this.replyToChat(chatId, `❌ Failed to retry: ${err.message}`, threadId).catch(() => { });
+                }
+            }, sig.retryAfterMs);
+            this.pendingRetries.set(retryKey, { text: lastPrompt, attempt, timer });
+            return;
+        }
+        // Accumulate text and debounce — Claude streams chunks rapidly
+        session.pendingText += text;
+        if (session.flushTimer)
+            clearTimeout(session.flushTimer);
+        session.flushTimer = setTimeout(() => this.flushPending(chatId, session), FLUSH_DELAY_MS);
+    }
+    startTyping(chatId, session) {
+        this.stopTyping(session);
+        // Send immediately, then keep alive every 4s
+        // Pass message_thread_id so typing appears in the correct forum topic thread
+        const threadOpts = session.threadId !== undefined ? { message_thread_id: session.threadId } : undefined;
+        this.bot.sendChatAction(chatId, "typing", threadOpts).catch(() => { });
+        session.typingTimer = setInterval(() => {
+            this.bot.sendChatAction(chatId, "typing", threadOpts).catch(() => { });
+        }, TYPING_INTERVAL_MS);
+    }
+    stopTyping(session) {
+        if (session.typingTimer) {
+            clearInterval(session.typingTimer);
+            session.typingTimer = null;
+        }
+    }
+    flushPending(chatId, session) {
+        const raw = session.pendingText.trim();
+        session.pendingText = "";
+        session.flushTimer = null;
+        if (!raw)
+            return;
+        this.writeChatMessage("assistant", "cc-tg", raw, chatId);
+        const text = session.isRetry ? `✅ Claude is back!\n\n${raw}` : raw;
+        session.isRetry = false;
+        // Format for Telegram HTML and split if needed (max 4096 chars)
+        const formatted = formatForTelegram(text);
+        const chunks = splitLongMessage(formatted);
+        const threadId = session.threadId;
+        for (const chunk of chunks) {
+            this.replyToChat(chatId, chunk, threadId, { parse_mode: "HTML" }).catch(() => {
+                // HTML parse failed — retry as plain text
+                this.replyToChat(chatId, chunk, threadId).catch((err) => console.error(`[tg:${chatId}] send failed:`, err.message));
+            });
+        }
+        // Hybrid file upload: find files mentioned in result text that Claude actually wrote
+        try {
+            this.uploadMentionedFiles(chatId, text, session);
+        }
+        catch (err) {
+            console.error(`[tg:${chatId}] uploadMentionedFiles error:`, err.message);
+        }
+    }
+    trackWrittenFiles(msg, session, cwd) {
+        // Only look at assistant messages with tool_use blocks
+        if (msg.type !== "assistant")
+            return;
+        const message = msg.payload.message;
+        if (!message)
+            return;
+        const content = message.content;
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (block.type !== "tool_use")
+                continue;
+            const name = block.name;
+            const input = block.input;
+            if (!input)
+                continue;
+            if (["Write", "Edit", "NotebookEdit"].includes(name)) {
+                // Write tool uses file_path, Edit uses file_path
+                const filePath = input.file_path ?? input.path;
+                if (!filePath)
+                    continue;
+                // Resolve relative paths against cwd
+                const resolved = filePath.startsWith("/")
+                    ? filePath
+                    : resolve(cwd ?? process.cwd(), filePath);
+                console.log(`[claude:files] tracked written file: ${resolved}`);
+                session.writtenFiles.add(resolved);
+            }
+            else if (name === "Bash") {
+                const cmd = input.command ?? "";
+                if (/\byt-dlp\b|\bffmpeg\b/.test(cmd)) {
+                    // Scan output dir for recently modified media files (template paths like /tmp/%(title)s.%(ext)s
+                    // make the actual filename unknowable at tracking time)
+                    const oFlagMatch = cmd.match(/-o\s+["']?([^\s"']+)/);
+                    let scanDir = "/tmp/";
+                    if (oFlagMatch) {
+                        const oPath = oFlagMatch[1].replace(/["'].*$/, "");
+                        const dirEnd = oPath.lastIndexOf("/");
+                        if (dirEnd > 0)
+                            scanDir = oPath.slice(0, dirEnd + 1);
+                    }
+                    const MEDIA_EXTS = new Set([".mp3", ".mp4", ".wav", ".ogg", ".flac", ".webm", ".m4a", ".aac"]);
+                    const nowMs = Date.now();
+                    try {
+                        for (const entry of readdirSync(scanDir)) {
+                            const dotIdx = entry.lastIndexOf(".");
+                            if (dotIdx < 0)
+                                continue;
+                            const ext = entry.slice(dotIdx).toLowerCase();
+                            if (!MEDIA_EXTS.has(ext))
+                                continue;
+                            const full = join(scanDir, entry);
+                            try {
+                                if (nowMs - statSync(full).mtimeMs <= 90_000) {
+                                    console.log(`[claude:files] tracked yt-dlp/ffmpeg output: ${full}`);
+                                    session.writtenFiles.add(full);
+                                }
+                            }
+                            catch { /* skip unreadable entries */ }
+                        }
+                    }
+                    catch { /* scanDir doesn't exist or unreadable */ }
+                }
+                else {
+                    // Other bash commands: try to extract output path from -o flag
+                    const oFlag = cmd.match(/-o\s+["']?([^\s"']+\.[\w]{1,10})["']?/);
+                    if (oFlag)
+                        session.writtenFiles.add(resolve(cwd ?? process.cwd(), oFlag[1]));
+                }
+                // mv source dest — track dest
+                const mvMatch = cmd.match(/\bmv\s+\S+\s+["']?([^\s"']+)["']?$/);
+                if (mvMatch)
+                    session.writtenFiles.add(resolve(cwd ?? process.cwd(), mvMatch[1]));
+                // cp source dest — track dest
+                const cpMatch = cmd.match(/\bcp\s+\S+\s+["']?([^\s"']+)["']?$/);
+                if (cpMatch)
+                    session.writtenFiles.add(resolve(cwd ?? process.cwd(), cpMatch[1]));
+                // curl -o path or wget -O path
+                const curlMatch = cmd.match(/curl\s+.*?-o\s+["']?([^\s"']+)["']?/);
+                if (curlMatch)
+                    session.writtenFiles.add(resolve(cwd ?? process.cwd(), curlMatch[1]));
+                // wget -O path
+                const wgetMatch = cmd.match(/wget\s+.*?-O\s+["']?([^\s"']+)["']?/);
+                if (wgetMatch)
+                    session.writtenFiles.add(resolve(cwd ?? process.cwd(), wgetMatch[1]));
+            }
+        }
+    }
+    uploadMentionedFiles(chatId, resultText, session) {
+        // Extract file path candidates from result text
+        // Match: /absolute/path/file.ext or relative like ./foo/bar.csv or just foo.pdf
+        const pathPattern = /(?:^|[\s`'"(])(\/?[\w.\-/]+\.[\w]{1,10})(?:[\s`'")\n]|$)/gm;
+        const quotedPattern = /"([^"]+\.[a-zA-Z0-9]{1,10})"|'([^']+\.[a-zA-Z0-9]{1,10})'/g;
+        const candidates = new Set();
+        let match;
+        while ((match = pathPattern.exec(resultText)) !== null) {
+            candidates.add(match[1]);
+        }
+        while ((match = quotedPattern.exec(resultText)) !== null) {
+            candidates.add(match[1] ?? match[2]);
+        }
+        const safeDirs = ["/tmp/", "/var/folders/", os.homedir() + "/Downloads/"];
+        const isSafeDir = (p) => safeDirs.some(d => p.startsWith(d)) || p.startsWith(this.opts.cwd ?? process.cwd());
+        const toUpload = [];
+        if (session.writtenFiles.size > 0) {
+            for (const candidate of candidates) {
+                // Try as-is (absolute), or resolve against cwd
+                const resolved = candidate.startsWith("/")
+                    ? candidate
+                    : resolve(this.opts.cwd ?? process.cwd(), candidate);
+                if (session.writtenFiles.has(resolved) && existsSync(resolved)) {
+                    toUpload.push(resolved);
+                }
+                else {
+                    // Also check by basename — result might mention just the filename
+                    for (const written of session.writtenFiles) {
+                        if (basename(written) === basename(candidate) && existsSync(written)) {
+                            toUpload.push(written);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        // Also upload files mentioned in result text that exist in safe dirs
+        // even if not tracked via Write tool
+        for (const candidate of candidates) {
+            const resolved = candidate.startsWith("/")
+                ? candidate
+                : resolve(this.opts.cwd ?? process.cwd(), candidate);
+            if (existsSync(resolved) && isSafeDir(resolved) && !toUpload.includes(resolved)) {
+                toUpload.push(resolved);
+            }
+        }
+        const unique = [...new Set(toUpload)];
+        for (const filePath of unique) {
+            let fileSize;
+            try {
+                fileSize = statSync(filePath).size;
+            }
+            catch {
+                continue; // file disappeared between existsSync and statSync
+            }
+            const MAX_TG_FILE_BYTES = 50 * 1024 * 1024;
+            if (fileSize > MAX_TG_FILE_BYTES) {
+                const mb = (fileSize / (1024 * 1024)).toFixed(1);
+                this.replyToChat(chatId, `File too large for Telegram (${mb}mb). Find it at: ${filePath}`, session.threadId).catch(() => { });
+                continue;
+            }
+            console.log(`[claude:files] uploading to telegram: ${filePath}`);
+            const docOpts = session.threadId ? { message_thread_id: session.threadId } : undefined;
+            this.bot.sendDocument(chatId, filePath, docOpts).catch((err) => console.error(`[tg:${chatId}] sendDocument failed for ${filePath}:`, err.message));
+        }
+        // Clear written files for next turn
+        session.writtenFiles.clear();
+    }
+    extractToolName(msg) {
+        const message = msg.payload.message;
+        if (!message)
+            return "";
+        const content = message.content;
+        if (!Array.isArray(content))
+            return "";
+        const toolUse = content.find((b) => b.type === "tool_use");
+        return toolUse?.name ?? "";
+    }
+    /** Find cc-agent PIDs via pgrep. Returns array of numeric PIDs. */
+    findCcAgentPids() {
+        try {
+            const out = execSync("pgrep -f cc-agent", { encoding: "utf8" }).trim();
+            return out.split("\n").map((s) => parseInt(s.trim(), 10)).filter((n) => !isNaN(n) && n > 0);
+        }
+        catch {
+            // pgrep exits with code 1 when no match — that's fine
+            return [];
+        }
+    }
+    /** Kill cc-agent PIDs with SIGTERM. Returns the list of killed PIDs. */
+    killCcAgent() {
+        const pids = this.findCcAgentPids();
+        for (const pid of pids) {
+            try {
+                process.kill(pid, "SIGTERM");
+                console.log(`[mcp] sent SIGTERM to cc-agent pid=${pid}`);
+            }
+            catch (err) {
+                console.warn(`[mcp] failed to kill pid=${pid}:`, err.message);
+            }
+        }
+        return pids;
+    }
+    async handleReloadMcp(chatId, threadId) {
+        await this.replyToChat(chatId, "Clearing npx cache and reloading MCP...", threadId);
+        try {
+            const home = process.env.HOME ?? "~";
+            execSync(`rm -rf "${home}/.npm/_npx/"`, { encoding: "utf8", shell: "/bin/sh" });
+            console.log("[mcp] cleared ~/.npm/_npx/");
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Warning: failed to clear npx cache: ${err.message}`, threadId);
+        }
+        const pids = this.killCcAgent();
+        if (pids.length === 0) {
+            await this.replyToChat(chatId, "NPX cache cleared. No cc-agent process found — MCP will start fresh on the next agent call.", threadId);
+            return;
+        }
+        await this.replyToChat(chatId, `NPX cache cleared. Sent SIGTERM to cc-agent (pid${pids.length > 1 ? "s" : ""}: ${pids.join(", ")}).\nMCP restarted. New process will load on next agent call.`, threadId);
+    }
+    async handleMcpStatus(chatId, threadId) {
+        try {
+            const output = execSync("claude mcp list", { encoding: "utf8", shell: "/bin/sh" }).trim();
+            await this.replyToChat(chatId, `MCP server status:\n\n${output || "(no output)"}`, threadId);
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Failed to run claude mcp list: ${err.message}`, threadId);
+        }
+    }
+    async handleMcpVersion(chatId, threadId) {
+        let npmVersion = "unknown";
+        let cacheEntries = "(unavailable)";
+        try {
+            npmVersion = execSync("npm view @gonzih/cc-agent version", { encoding: "utf8" }).trim();
+        }
+        catch (err) {
+            npmVersion = `error: ${err.message.split("\n")[0]}`;
+        }
+        try {
+            const home = process.env.HOME ?? "~";
+            const cacheOut = execSync(`ls "${home}/.npm/_npx/" 2>/dev/null | head -5`, { encoding: "utf8", shell: "/bin/sh" }).trim();
+            cacheEntries = cacheOut || "(empty)";
+        }
+        catch {
+            cacheEntries = "(empty or not found)";
+        }
+        await this.replyToChat(chatId, `cc-agent npm version: ${npmVersion}\n\nnpx cache (~/.npm/_npx/):\n${cacheEntries}`, threadId);
+    }
+    async handleClearNpxCache(chatId, threadId) {
+        const home = process.env.HOME ?? "/tmp";
+        const cleared = [];
+        const failed = [];
+        // Clear both npx execution cache and full npm package cache
+        for (const dir of [`${home}/.npm/_npx`, `${home}/.npm/cache`]) {
+            try {
+                execSync(`rm -rf "${dir}"`, { encoding: "utf8", shell: "/bin/sh" });
+                cleared.push(dir.replace(home, "~"));
+                console.log(`[cache] cleared ${dir}`);
+            }
+            catch (err) {
+                failed.push(dir.replace(home, "~"));
+                console.warn(`[cache] failed to clear ${dir}:`, err.message);
+            }
+        }
+        const pids = this.killCcAgent();
+        const pidNote = pids.length > 0
+            ? ` Sent SIGTERM to cc-agent pid${pids.length > 1 ? "s" : ""}: ${pids.join(", ")}.`
+            : " No cc-agent running.";
+        const clearNote = failed.length
+            ? `Cleared: ${cleared.join(", ")}. Failed: ${failed.join(", ")}.`
+            : `Cleared: ${cleared.join(", ")}.`;
+        await this.replyToChat(chatId, `${clearNote}${pidNote} Next call picks up latest npm version.`, threadId);
+    }
+    async handleRestart(chatId, threadId) {
+        await this.replyToChat(chatId, "Clearing cache and restarting... brb.", threadId);
+        await new Promise(resolve => setTimeout(resolve, 300));
+        // Clear npm caches before restart so launchd brings up fresh version
+        const home = process.env.HOME ?? "/tmp";
+        for (const dir of [`${home}/.npm/_npx`, `${home}/.npm/cache`]) {
+            try {
+                execSync(`rm -rf "${dir}"`, { shell: "/bin/sh" });
+            }
+            catch { }
+        }
+        // Kill all active Claude sessions cleanly
+        for (const session of this.sessions.values()) {
+            this.stopTyping(session);
+            session.claude.kill();
+        }
+        this.sessions.clear();
+        await new Promise(resolve => setTimeout(resolve, 200));
+        process.exit(0);
+    }
+    async handleCron(chatId, text, threadId) {
+        const args = text.slice("/cron".length).trim();
+        if (args === "list" || args === "") {
+            const jobs = this.cron.list(chatId);
+            if (!jobs.length) {
+                await this.replyToChat(chatId, "No cron jobs.", threadId);
+                return;
+            }
+            const lines = jobs.map((j, i) => {
+                const short = j.prompt.length > 50 ? j.prompt.slice(0, 50) + "…" : j.prompt;
+                return `#${i + 1} ${j.schedule} — "${short}"`;
+            });
+            await this.replyToChat(chatId, `Cron jobs (${jobs.length}):\n${lines.join("\n")}`, threadId);
+            return;
+        }
+        if (args === "clear") {
+            const n = this.cron.clearAll(chatId);
+            await this.replyToChat(chatId, `Cleared ${n} cron job(s).`, threadId);
+            return;
+        }
+        if (args.startsWith("remove ")) {
+            const id = args.slice("remove ".length).trim();
+            const ok = this.cron.remove(chatId, id);
+            await this.replyToChat(chatId, ok ? `Removed ${id}.` : `Not found: ${id}`, threadId);
+            return;
+        }
+        const scheduleMatch = args.match(/^(every\s+\d+[mhd])\s+(.+)$/i);
+        if (!scheduleMatch) {
+            await this.replyToChat(chatId, "Usage:\n/cron every 1h <prompt>\n/cron list\n/cron remove <id>\n/cron clear", threadId);
+            return;
+        }
+        const schedule = scheduleMatch[1];
+        const prompt = scheduleMatch[2];
+        const job = this.cron.add(chatId, schedule, prompt);
+        if (!job) {
+            await this.replyToChat(chatId, "Invalid schedule. Use: every 30m / every 2h / every 1d", threadId);
+            return;
+        }
+        await this.replyToChat(chatId, `Cron set [${job.id}]: ${schedule} — "${prompt}"`, threadId);
+    }
+    runCronTask(chatId, prompt, done = () => { }) {
+        const cronProcess = new ClaudeProcess({ cwd: this.opts.cwd ?? process.cwd() });
+        cronProcess.sendPrompt(prompt);
+        cronProcess.on("message", (msg) => {
+            const result = extractText(msg);
+            if (result) {
+                const formatted = formatForTelegram(`🕐 ${result}`);
+                const chunks = splitLongMessage(formatted);
+                for (const chunk of chunks) {
+                    this.replyToChat(chatId, chunk).catch((err) => console.error("[cron] send failed:", err.message));
+                }
+            }
+        });
+        cronProcess.on("exit", () => done());
+    }
+    async handleGetFile(chatId, text, threadId) {
+        const arg = text.slice("/get_file".length).trim();
+        if (!arg) {
+            await this.replyToChat(chatId, "Usage: /get_file <path>", threadId);
+            return;
+        }
+        const filePath = resolve(arg);
+        const safeDirs = ["/tmp/", "/var/folders/", os.homedir() + "/Downloads/", this.opts.cwd ?? process.cwd()];
+        const inSafeDir = safeDirs.some(d => filePath.startsWith(d));
+        if (!inSafeDir) {
+            await this.replyToChat(chatId, "Access denied: path not in allowed directories", threadId);
+            return;
+        }
+        if (!existsSync(filePath)) {
+            await this.replyToChat(chatId, `File not found: ${filePath}`, threadId);
+            return;
+        }
+        if (!statSync(filePath).isFile()) {
+            await this.replyToChat(chatId, `Not a file: ${filePath}`, threadId);
+            return;
+        }
+        const MAX_TG_FILE_BYTES = 50 * 1024 * 1024;
+        const fileSize = statSync(filePath).size;
+        if (fileSize > MAX_TG_FILE_BYTES) {
+            const mb = (fileSize / (1024 * 1024)).toFixed(1);
+            await this.replyToChat(chatId, `File too large for Telegram (${mb}mb). Find it at: ${filePath}`, threadId);
+            return;
+        }
+        const docOpts = threadId ? { message_thread_id: threadId } : undefined;
+        await this.bot.sendDocument(chatId, filePath, docOpts);
+    }
+    async handleDrivers(chatId, threadId) {
+        try {
+            const raw = await this.callCcAgentTool("list_drivers");
+            if (!raw) {
+                await this.replyToChat(chatId, "No drivers available or cc-agent did not respond.", threadId);
+                return;
+            }
+            // Try to pretty-print JSON array/object, fall back to raw string
+            let reply;
+            try {
+                const data = JSON.parse(raw);
+                if (Array.isArray(data)) {
+                    const current = process.env.CC_AGENT_DEFAULT_DRIVER || "claude";
+                    const lines = data.map((d) => d === current ? `• ${d} (default)` : `• ${d}`);
+                    reply = `Available drivers:\n${lines.join("\n")}`;
+                }
+                else {
+                    reply = `Available drivers:\n${raw}`;
+                }
+            }
+            catch {
+                reply = `Available drivers:\n${raw}`;
+            }
+            await this.replyToChat(chatId, reply, threadId);
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Failed to list drivers: ${err.message}`, threadId);
+        }
+    }
+    async handleAgents(chatId, threadId) {
+        if (!this.redis) {
+            await this.replyToChat(chatId, "Redis not configured — agents status unavailable.", threadId);
+            return;
+        }
+        try {
+            // Scan for all meta-agent status keys
+            const keys = [];
+            let cursor = "0";
+            do {
+                const [nextCursor, found] = await this.redis.scan(cursor, "MATCH", "cca:meta-agent:status:*", "COUNT", 100);
+                cursor = nextCursor;
+                keys.push(...found);
+            } while (cursor !== "0");
+            if (keys.length === 0) {
+                await this.replyToChat(chatId, "No active meta-agents.", threadId);
+                return;
+            }
+            const statuses = await Promise.all(keys.sort().map(async (key) => ({ key, raw: await this.redis.get(key) })));
+            const lines = ["🤖 Active Agents", ""];
+            for (const { key, raw } of statuses) {
+                const namespace = key.replace("cca:meta-agent:status:", "");
+                if (!raw) {
+                    lines.push(`${namespace} — status unknown`);
+                    continue;
+                }
+                try {
+                    const status = JSON.parse(raw);
+                    const state = status.status ?? "unknown";
+                    const turns = status.turn ?? status.turn_count ?? 0;
+                    const tool = status.current_tool;
+                    const lastActivity = status.last_activity ?? status.updated_at;
+                    let ageStr = "";
+                    if (lastActivity) {
+                        const ageSec = Math.floor((Date.now() - new Date(lastActivity).getTime()) / 1000);
+                        if (ageSec < 60)
+                            ageStr = `${ageSec}s ago`;
+                        else if (ageSec < 3600)
+                            ageStr = `${Math.floor(ageSec / 60)}m ago`;
+                        else
+                            ageStr = `${Math.floor(ageSec / 3600)}h ago`;
+                    }
+                    let statusDesc;
+                    if (state === "running" && tool) {
+                        statusDesc = `typing... (turn ${turns})`;
+                    }
+                    else if (state === "running") {
+                        statusDesc = `running (turn ${turns}${ageStr ? `, ${ageStr}` : ""})`;
+                    }
+                    else {
+                        statusDesc = `idle (turn ${turns}${ageStr ? `, ${ageStr}` : ""})`;
+                    }
+                    lines.push(`${namespace} — ${statusDesc}`);
+                }
+                catch {
+                    lines.push(`${namespace} — status unknown`);
+                }
+            }
+            await this.replyToChat(chatId, lines.join("\n"), threadId);
+        }
+        catch (err) {
+            await this.replyToChat(chatId, `Failed to get agents status: ${err.message}`, threadId);
+        }
+    }
+    callCcAgentTool(toolName, args = {}) {
+        // For spawn tools, pass through the configured driver and model
+        const spawnTools = new Set(["spawn_agent", "spawn_from_profile"]);
+        if (spawnTools.has(toolName)) {
+            const driver = process.env.CC_AGENT_DEFAULT_DRIVER || "claude";
+            const model = process.env.CC_AGENT_DEFAULT_MODEL || undefined;
+            args = { agent_driver: driver, ...(model ? { agent_model: model } : {}), ...args };
+        }
+        return new Promise((resolve) => {
+            let settled = false;
+            const done = (val) => {
+                if (!settled) {
+                    settled = true;
+                    resolve(val);
+                }
+            };
+            let proc;
+            try {
+                proc = spawn("npx", ["-y", "@gonzih/cc-agent@latest"], {
+                    env: { ...process.env },
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+            }
+            catch (err) {
+                console.error("[mcp] failed to spawn cc-agent:", err.message);
+                done(null);
+                return;
+            }
+            const timeout = setTimeout(() => {
+                console.warn("[mcp] cc-agent tool call timed out");
+                proc.kill();
+                done(null);
+            }, 30_000);
+            let buffer = "";
+            const sendMsg = (msg) => { proc.stdin.write(JSON.stringify(msg) + "\n"); };
+            sendMsg({
+                jsonrpc: "2.0", id: 1, method: "initialize",
+                params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "cc-tg", version: "1.0.0" } },
+            });
+            proc.stdout.on("data", (chunk) => {
+                buffer += chunk.toString();
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const msg = JSON.parse(line);
+                        if (msg.id === 1 && "result" in msg) {
+                            sendMsg({ jsonrpc: "2.0", method: "notifications/initialized" });
+                            sendMsg({ jsonrpc: "2.0", id: 2, method: "tools/call", params: { name: toolName, arguments: args } });
+                        }
+                        else if (msg.id === 2) {
+                            clearTimeout(timeout);
+                            if (msg.error) {
+                                console.error("[mcp] cost_summary error:", JSON.stringify(msg.error));
+                                proc.kill();
+                                done(null);
+                                return;
+                            }
+                            const result = msg.result;
+                            const content = result?.content;
+                            const text = (content ?? []).filter((b) => b.type === "text").map((b) => b.text).join("");
+                            proc.kill();
+                            done(text || null);
+                        }
+                    }
+                    catch { /* ignore non-JSON lines */ }
+                }
+            });
+            proc.on("error", (err) => {
+                console.error("[mcp] cc-agent spawn error:", err.message);
+                clearTimeout(timeout);
+                done(null);
+            });
+            proc.on("exit", () => { clearTimeout(timeout); done(null); });
+        });
+    }
+    killSession(chatId, _keepCrons = true, threadId) {
+        const key = this.sessionKey(chatId, threadId);
+        const session = this.sessions.get(key);
+        if (session) {
+            this.stopTyping(session);
+            session.claude.kill();
+            this.sessions.delete(key);
+        }
+    }
+    getMe() {
+        return this.bot.getMe();
+    }
+    stop() {
+        this.bot.stopPolling();
+        for (const session of this.sessions.values()) {
+            this.stopTyping(session);
+            session.claude.kill();
+        }
+        this.sessions.clear();
+    }
+}
+function buildPromptWithReplyContext(text, msg) {
+    const reply = msg.reply_to_message;
+    if (!reply)
+        return text;
+    const quotedText = reply.text || reply.caption || null;
+    if (!quotedText)
+        return text;
+    const truncated = quotedText.length > 500
+        ? quotedText.slice(0, 500) + "... [truncated]"
+        : quotedText;
+    return `[Replying to: "${truncated}"]\n\n${text}`;
+}
+/** Download a URL and return its contents as a base64 string */
+function fetchAsBase64(url) {
+    return new Promise((resolve, reject) => {
+        const client = url.startsWith("https") ? https : http;
+        client.get(url, (res) => {
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks).toString("base64")));
+            res.on("error", reject);
+        }).on("error", reject);
+    });
+}
+/** Download a URL to a local file path */
+function downloadToFile(url, destPath) {
+    return new Promise((resolve, reject) => {
+        const client = url.startsWith("https") ? https : http;
+        const file = createWriteStream(destPath);
+        client.get(url, (res) => {
+            res.pipe(file);
+            file.on("finish", () => file.close(() => resolve()));
+            file.on("error", reject);
+        }).on("error", reject);
+    });
+}
+/** Fetch URL via Jina Reader and return first maxChars characters */
+function fetchUrlViaJina(url, maxChars = 2000) {
+    const jinaUrl = `https://r.jina.ai/${url}`;
+    return new Promise((resolve, reject) => {
+        https.get(jinaUrl, (res) => {
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => {
+                const text = Buffer.concat(chunks).toString("utf8");
+                resolve(text.slice(0, maxChars));
+            });
+            res.on("error", reject);
+        }).on("error", reject);
+    });
+}
+/** Detect URLs in text, fetch each via Jina Reader, and prepend content to the prompt */
+export async function enrichPromptWithUrls(text) {
+    const urlRegex = /https?:\/\/[^\s]+/g;
+    const urls = text.match(urlRegex);
+    if (!urls || urls.length === 0)
+        return text;
+    const prefixes = [];
+    for (const url of urls) {
+        // Skip jina.ai URLs to avoid recursion
+        if (url.includes("r.jina.ai"))
+            continue;
+        try {
+            const content = await fetchUrlViaJina(url);
+            if (content.trim()) {
+                prefixes.push(`[Web content from ${url}]:\n${content}`);
+            }
+        }
+        catch (err) {
+            console.warn(`[url-fetch] failed to fetch ${url}:`, err.message);
+        }
+    }
+    if (prefixes.length === 0)
+        return text;
+    return prefixes.join("\n\n") + "\n\n" + text;
+}
+/** Parse frontmatter description from a skill markdown file */
+function parseSkillDescription(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const frontmatter = match[1];
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    return descMatch ? descMatch[1].trim() : null;
+}
+/** List available skills from ~/.claude/skills/ */
+export function listSkills() {
+    const skillsDir = join(os.homedir(), ".claude", "skills");
+    if (!existsSync(skillsDir)) {
+        return "No skills directory found at ~/.claude/skills/";
+    }
+    let files;
+    try {
+        files = readdirSync(skillsDir).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        return "Could not read skills directory.";
+    }
+    if (files.length === 0) {
+        return "No skills found in ~/.claude/skills/";
+    }
+    const lines = ["Available skills:"];
+    for (const file of files.sort()) {
+        const name = "/" + file.replace(/\.md$/, "");
+        try {
+            const content = readFileSync(join(skillsDir, file), "utf8");
+            const description = parseSkillDescription(content);
+            lines.push(description ? `${name} — ${description}` : name);
+        }
+        catch {
+            lines.push(name);
+        }
+    }
+    return lines.join("\n");
+}
+export function splitMessage(text, maxLen = 4096) {
+    if (text.length <= maxLen)
+        return [text];
+    const chunks = [];
+    let i = 0;
+    while (i < text.length) {
+        chunks.push(text.slice(i, i + maxLen));
+        i += maxLen;
+    }
+    return chunks;
+}