@gonzih/cc-tg 0.4.0 → 0.5.0

package/README.md

@@ -29,6 +29,7 @@ Open your bot in Telegram and start chatting.
 | `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.
 
@@ -118,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.
 

package/dist/bot.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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";
+export interface BotOptions {
+    telegramToken: string;
+    claudeToken?: string;
+    cwd?: string;
+    allowedUserIds?: number[];
+    groupChatIds?: number[];
+}
+export declare class CcTgBot {
+    private bot;
+    private sessions;
+    private pendingRetries;
+    private opts;
+    private cron;
+    private costStore;
+    private botUsername;
+    private botId;
+    constructor(opts: BotOptions);
+    private registerBotCommands;
+    /** 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;
+    private handleVoice;
+    private handlePhoto;
+    private handleDocument;
+    private getOrCreateSession;
+    private handleClaudeMessage;
+    private startTyping;
+    private stopTyping;
+    private flushPending;
+    private trackWrittenFiles;
+    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. */
+    private killCcAgent;
+    private handleReloadMcp;
+    private handleMcpStatus;
+    private handleMcpVersion;
+    private handleClearNpxCache;
+    private handleRestart;
+    private handleGetFile;
+    private callCcAgentTool;
+    private killSession;
+    getMe(): Promise<TelegramBot.User>;
+    stop(): void;
+}
+export declare function splitMessage(text: string, maxLen?: number): string[];