@gonzih/cc-tg 0.9.53 → 0.9.54

package/README.md

@@ -32,6 +32,8 @@ Open your bot in Telegram and start chatting.
 | `ALLOWED_USER_IDS` | no | Comma-separated Telegram user IDs. Leave empty to allow anyone |
 | `CWD` | no | Working directory for Claude Code. Defaults to current directory |
 | `THREAD_CWD_MAP` | no | JSON mapping of forum topic names or IDs to CWD paths (see [Multi-topic sessions](#multi-topic-sessions)) |
+| `CC_TG_AUTO_COMPACT_MESSAGES` | no | Automatically send `/compact` after this many messages in a session (default: 40, set to 0 to disable) |
+| `CC_TG_COST_WARN_USD` | no | Send a cost warning notification when session cost exceeds this USD amount (default: 5.0, set to 0 to disable) |
 
 *One of `CLAUDE_CODE_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`, or `ANTHROPIC_API_KEY` required.
 
@@ -66,6 +68,8 @@ Message [@userinfobot](https://t.me/userinfobot) — it replies with your numeri
 | `/mcp_version` | Show latest published cc-agent npm version and current cache |
 | `/clear_npx_cache` | Clear npx cache and reload cc-agent (upgrades to latest version) |
 | `/get_file <path>` | Send a file from the server to this chat |
+| `/effort <level>` | Set Claude effort level (`low` / `medium` / `high` / `xhigh` / `max` / `auto`) |
+| `/compact` | Compact context history to free tokens |
 | `/restart` | Self-restart the cc-tg bot process (no SSH needed) |
 | Any text | Sent directly to Claude Code |
 | Voice message | Transcribed via whisper.cpp and sent to Claude |

package/dist/bot.d.ts

@@ -105,6 +105,13 @@ export declare class CcTgBot {
     private handleWikiSync;
     private callCcAgentTool;
     private killSession;
+    private handleEffort;
+    private handleCompact;
+    /**
+     * If CC_TG_AUTO_COMPACT_MESSAGES threshold is reached, send /compact to the active Claude
+     * session before the next user message. Resets the per-session counter on fire.
+     */
+    private maybeSendAutoCompact;
     getMe(): Promise<TelegramBot.User>;
     stop(): void;
 }

package/dist/bot.js

@@ -37,6 +37,8 @@ const BOT_COMMANDS = [
     { command: "drivers", description: "List available agent drivers" },
     { command: "agents", description: "Show running meta-agents and their live status" },
     { command: "wiki", description: "Manage wiki pages — list/show/update/delete/sync" },
+    { command: "effort", description: "Set effort level: low / medium / high / xhigh / max / auto" },
+    { command: "compact", description: "Compact context history to free tokens" },
 ];
 // Debounces streaming chunks. Resets on each chunk. Fires 800ms after last chunk.
 const FLUSH_DELAY_MS = 800;
@@ -463,6 +465,16 @@ export class CcTgBot {
             await this.handleWiki(chatId, text, threadId);
             return;
         }
+        // /effort <level> — forward effort level to active Claude session
+        if (text.startsWith("/effort")) {
+            await this.handleEffort(chatId, text, threadId);
+            return;
+        }
+        // /compact — compact context history in active Claude session
+        if (text === "/compact") {
+            await this.handleCompact(chatId, threadId);
+            return;
+        }
         // #tag / #org/repo routing — delegate to meta-agent instead of local Claude session
         if (this.redis) {
             const routing = parseRoutingTag(text);
@@ -514,6 +526,7 @@ export class CcTgBot {
             const enriched = await enrichPromptWithUrls(text);
             const prompt = buildPromptWithReplyContext(enriched, msg);
             session.currentPrompt = prompt;
+            this.maybeSendAutoCompact(session, chatId, threadId);
             session.claude.sendPrompt(stampPrompt(prompt));
             this.startTyping(chatId, session);
             this.writeChatMessage("user", "telegram", text, chatId);
@@ -789,6 +802,8 @@ export class CcTgBot {
             currentPrompt: "",
             isRetry: false,
             threadId,
+            messagesSinceCompact: 0,
+            costWarnSent: false,
         };
         claude.on("usage", (usage) => {
             this.costStore.addUsage(chatId, usage);
@@ -847,6 +862,7 @@ export class CcTgBot {
             return;
         this.stopTyping(session);
         this.costStore.incrementMessages(chatId);
+        session.messagesSinceCompact++;
         const text = extractText(msg);
         if (!text)
             return;
@@ -955,6 +971,17 @@ export class CcTgBot {
         catch (err) {
             console.error(`[tg:${chatId}] uploadMentionedFiles error:`, err.message);
         }
+        // Cost threshold warning — fires once per session when cost first exceeds the limit
+        if (!session.costWarnSent) {
+            const warnThreshold = parseFloat(process.env.CC_TG_COST_WARN_USD ?? "5.0");
+            if (!isNaN(warnThreshold) && warnThreshold > 0) {
+                const cost = this.costStore.get(chatId);
+                if (cost.totalCostUsd >= warnThreshold) {
+                    session.costWarnSent = true;
+                    this.replyToChat(chatId, `⚠️ Session cost: $${cost.totalCostUsd.toFixed(2)} — consider /compact or /reset`, threadId).catch(() => { });
+                }
+            }
+        }
     }
     trackWrittenFiles(msg, session, cwd) {
         // Only look at assistant messages with tool_use blocks
@@ -1664,6 +1691,49 @@ export class CcTgBot {
             this.sessions.delete(key);
         }
     }
+    async handleEffort(chatId, text, threadId) {
+        const VALID_LEVELS = new Set(["low", "medium", "high", "xhigh", "max", "auto"]);
+        const parts = text.trim().split(/\s+/);
+        const level = parts[1]?.toLowerCase();
+        if (!level || !VALID_LEVELS.has(level)) {
+            await this.replyToChat(chatId, "Usage: /effort <level>\nValid levels: low, medium, high, xhigh, max, auto", threadId);
+            return;
+        }
+        const sessionKey = this.sessionKey(chatId, threadId);
+        const session = this.sessions.get(sessionKey);
+        if (!session || session.claude.exited) {
+            await this.replyToChat(chatId, `No active session. Start one, then use /effort ${level} to set the effort level.`, threadId);
+            return;
+        }
+        session.claude.sendPrompt(`/effort ${level}`);
+        await this.replyToChat(chatId, `⚡ Effort set to: ${level}`, threadId);
+    }
+    async handleCompact(chatId, threadId) {
+        const sessionKey = this.sessionKey(chatId, threadId);
+        const session = this.sessions.get(sessionKey);
+        if (!session || session.claude.exited) {
+            await this.replyToChat(chatId, "No active session.", threadId);
+            return;
+        }
+        session.claude.sendPrompt("/compact");
+        session.messagesSinceCompact = 0;
+        await this.replyToChat(chatId, "🗜️ Compacting context history...", threadId);
+    }
+    /**
+     * If CC_TG_AUTO_COMPACT_MESSAGES threshold is reached, send /compact to the active Claude
+     * session before the next user message. Resets the per-session counter on fire.
+     */
+    maybeSendAutoCompact(session, chatId, threadId) {
+        const threshold = parseInt(process.env.CC_TG_AUTO_COMPACT_MESSAGES ?? "40", 10);
+        if (isNaN(threshold) || threshold <= 0)
+            return;
+        if (session.messagesSinceCompact >= threshold) {
+            console.log(`[auto-compact:${chatId}] firing after ${session.messagesSinceCompact} messages`);
+            session.messagesSinceCompact = 0;
+            session.claude.sendPrompt("/compact");
+            this.replyToChat(chatId, `🗜️ Auto-compacting context (${threshold} message limit reached)...`, threadId).catch(() => { });
+        }
+    }
     getMe() {
         return this.bot.getMe();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonzih/cc-tg",
-  "version": "0.9.53",
+  "version": "0.9.54",
   "description": "Claude Code Telegram bot — chat with Claude Code via Telegram",
   "type": "module",
   "bin": {