@gonzih/cc-tg 0.9.21 → 0.9.22

package/README.md

@@ -25,9 +25,11 @@ Open your bot in Telegram and start chatting.
 | `TELEGRAM_BOT_TOKEN` | yes | From @BotFather |
 | `CLAUDE_CODE_TOKEN` | yes* | Claude Code OAuth token (starts with `sk-ant-oat`) |
 | `CLAUDE_CODE_OAUTH_TOKEN` | yes* | Alias for `CLAUDE_CODE_TOKEN` |
+| `CLAUDE_CODE_OAUTH_TOKENS` | no | Comma-separated OAuth tokens for rotation — e.g. `token1,token2,token3`. When one account hits its usage limit, automatically switches to the next token instead of sleeping. |
 | `ANTHROPIC_API_KEY` | yes* | Alternative — API key from console.anthropic.com |
 | `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)) |
 
 *One of `CLAUDE_CODE_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`, or `ANTHROPIC_API_KEY` required.
 
@@ -117,6 +119,37 @@ Manage the cc-agent MCP server from Telegram without SSH:
 ### Self-restart
 `/restart` — spawns a detached child process with the same Node binary and args, sends you a confirmation message, then exits. The new process inherits all environment variables. No SSH required to restart the bot after updates.
 
+### Multi-topic sessions
+
+When you use cc-tg in a **Telegram group with Topics enabled** (a "Forum" group), each topic gets its own **isolated Claude Code session**. One bot token, one daemon, unlimited isolated project contexts.
+
+**How it works:**
+- Session key = `chatId:threadId` for forum topics
+- Session key = `chatId:main` for direct messages and non-topic groups (backward compatible)
+- Commands like `/reset`, `/stop`, `/status` are scoped to the current topic
+
+**Setup:**
+1. Create a Telegram group → Settings → Topics → Enable
+2. Create topics for each project (e.g. "Simorgh", "LeWM", "EcoClaw")
+3. Each topic now has its own isolated Claude context
+
+**Optional: route topics to different working directories**
+
+Set `THREAD_CWD_MAP` to a JSON string mapping topic names (or thread IDs) to absolute paths:
+
+```bash
+THREAD_CWD_MAP='{"Simorgh":"/Users/you/simorgh-app","LeWM":"/Users/you/le-wm","EcoClaw":"/Users/you/ecoclaw"}'
+```
+
+When cc-tg creates a new session for a topic, it looks up the topic name in this map and starts Claude in the corresponding directory. If no match is found, falls back to `CWD`.
+
+You can also map by numeric thread ID:
+```bash
+THREAD_CWD_MAP='{"12345":"/Users/you/project-a","67890":"/Users/you/project-b"}'
+```
+
+If `THREAD_CWD_MAP` is not set, all topics share the same CWD — context isolation still works, just without directory routing.
+
 ### Typing indicator
 While Claude is working, the bot sends a continuous typing indicator. Works for both regular messages and cron job execution.
 
@@ -157,6 +190,9 @@ cc-tg works with the [cc-agent](https://github.com/Gonzih/cc-agent) MCP server t
         <string>your_token</string>
         <key>CLAUDE_CODE_TOKEN</key>
         <string>your_claude_token</string>
+        <!-- Optional: comma-separated OAuth tokens for automatic rotation on usage limit -->
+        <!-- <key>CLAUDE_CODE_OAUTH_TOKENS</key> -->
+        <!-- <string>token1,token2,token3</string> -->
         <key>ALLOWED_USER_IDS</key>
         <string>your_telegram_id</string>
         <key>CWD</key>

package/dist/bot.d.ts

@@ -2,27 +2,54 @@
  * 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 { Redis } from "ioredis";
 export interface BotOptions {
     telegramToken: string;
     claudeToken?: string;
     cwd?: string;
     allowedUserIds?: number[];
     groupChatIds?: number[];
+    redis?: Redis;
+    namespace?: string;
 }
 export declare class CcTgBot {
     private bot;
     private sessions;
     private pendingRetries;
     private opts;
-    private cron;
     private costStore;
     private botUsername;
     private botId;
+    private redis?;
+    private namespace;
+    private lastActiveChatId?;
+    private cron;
     constructor(opts: BotOptions);
     private registerBotCommands;
+    /** Write a message to the Redis chat log. Fire-and-forget — no-op if Redis is not configured. */
+    private writeChatMessage;
+    /** Returns the last chatId that sent a message — used by the chat bridge when no fixed chatId is configured. */
+    getLastActiveChatId(): number | undefined;
+    /** Session key: "chatId:threadId" for topics, "chatId:main" for DMs/non-topic groups */
+    private sessionKey;
+    /**
+     * 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).
+     */
+    private replyToChat;
+    /** Parse THREAD_CWD_MAP env var — maps thread name or thread_id to a CWD path */
+    private getThreadCwdMap;
     private isAllowed;
     private handleTelegram;
+    /**
+     * 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.
+     */
+    handleUserMessage(chatId: number, text: string): Promise<void>;
     private handleVoice;
+    private handleVoiceRetry;
     private handlePhoto;
     private handleDocument;
     private getOrCreateSession;
@@ -34,9 +61,6 @@ export declare class CcTgBot {
     private isSensitiveFile;
     private uploadMentionedFiles;
     private extractToolName;
-    private runCronTask;
-    private handleCron;
-    private handleCronEdit;
     /** Find cc-agent PIDs via pgrep. Returns array of numeric PIDs. */
     private findCcAgentPids;
     /** Kill cc-agent PIDs with SIGTERM. Returns the list of killed PIDs. */
@@ -46,9 +70,17 @@ export declare class CcTgBot {
     private handleMcpVersion;
     private handleClearNpxCache;
     private handleRestart;
+    private handleCron;
+    private runCronTask;
     private handleGetFile;
+    private handleDrivers;
     private callCcAgentTool;
     private killSession;
+    getMe(): Promise<TelegramBot.User>;
     stop(): void;
 }
+/** Detect URLs in text, fetch each via Jina Reader, and prepend content to the prompt */
+export declare function enrichPromptWithUrls(text: string): Promise<string>;
+/** List available skills from ~/.claude/skills/ */
+export declare function listSkills(): string;
 export declare function splitMessage(text: string, maxLen?: number): string[];