@gonzih/cc-tg 0.9.37 → 0.9.39

package/dist/bot.d.ts

@@ -27,6 +27,8 @@ export declare class CcTgBot {
     private namespace;
     private lastActiveChatId?;
     private cron;
+    /** In-memory cache of forum topic names: `${chatId}:${threadId}` → topic name */
+    private topicNameCache;
     constructor(opts: BotOptions);
     private registerBotCommands;
     /** Write a message to the Redis chat log. Fire-and-forget — no-op if Redis is not configured. */
@@ -43,6 +45,13 @@ export declare class CcTgBot {
     private replyToChat;
     /** Parse THREAD_CWD_MAP env var — maps thread name or thread_id to a CWD path */
     private getThreadCwdMap;
+    /**
+     * Parse FORUM_META_AGENT_ROUTING env var.
+     *   "auto" (default) → route all forum topics to meta-agents
+     *   "off"            → disable forum routing entirely
+     *   "topic-a,topic-b" → only route these named topics
+     */
+    private getForumRoutingConfig;
     private isAllowed;
     private handleTelegram;
     /**
@@ -85,4 +94,15 @@ export declare class CcTgBot {
 export declare function enrichPromptWithUrls(text: string): Promise<string>;
 /** List available skills from ~/.claude/skills/ */
 export declare function listSkills(): string;
+/**
+ * Normalize a Telegram forum topic name into a meta-agent namespace.
+ * Rules: strip leading #, lowercase, spaces → hyphens, non-alphanumeric → hyphens,
+ * collapse and trim hyphens.
+ *
+ * Examples:
+ *   "CC Suite"  → "cc-suite"
+ *   "#research" → "research"
+ *   "of-stack"  → "of-stack"
+ */
+export declare function normalizeTopicNamespace(name: string): string;
 export declare function splitMessage(text: string, maxLen?: number): string[];

package/dist/bot.js

@@ -176,6 +176,8 @@ export class CcTgBot {
     namespace;
     lastActiveChatId;
     cron;
+    /** In-memory cache of forum topic names: `${chatId}:${threadId}` → topic name */
+    topicNameCache = new Map();
     constructor(opts) {
         this.opts = opts;
         this.redis = opts.redis;
@@ -250,6 +252,20 @@ export class CcTgBot {
             return {};
         }
     }
+    /**
+     * Parse FORUM_META_AGENT_ROUTING env var.
+     *   "auto" (default) → route all forum topics to meta-agents
+     *   "off"            → disable forum routing entirely
+     *   "topic-a,topic-b" → only route these named topics
+     */
+    getForumRoutingConfig() {
+        const raw = process.env.FORUM_META_AGENT_ROUTING;
+        if (!raw || raw === "auto")
+            return "auto";
+        if (raw === "off")
+            return "off";
+        return new Set(raw.split(",").map((s) => s.trim()).filter(Boolean));
+    }
     isAllowed(userId) {
         if (!this.opts.allowedUserIds?.length)
             return true;
@@ -266,6 +282,26 @@ export class CcTgBot {
         const threadName = rawMsg.forum_topic_created
             ? rawMsg.forum_topic_created.name
             : undefined;
+        // Cache forum topic names from service messages so routing can look them up later
+        if (threadId !== undefined) {
+            if (threadName) {
+                this.topicNameCache.set(`${chatId}:${threadId}`, threadName);
+            }
+            // forum_topic_edited carries name only when the name was changed
+            const editedTopicName = rawMsg.forum_topic_edited?.name;
+            if (editedTopicName) {
+                this.topicNameCache.set(`${chatId}:${threadId}`, editedTopicName);
+            }
+            // Best-effort: first message in a topic often has reply_to_message pointing to the creation event
+            if (!this.topicNameCache.has(`${chatId}:${threadId}`)) {
+                const replyRaw = msg.reply_to_message;
+                const replyCreated = replyRaw?.forum_topic_created;
+                const replyName = replyCreated?.name;
+                if (replyName) {
+                    this.topicNameCache.set(`${chatId}:${threadId}`, replyName);
+                }
+            }
+        }
         if (!this.isAllowed(userId)) {
             await this.replyToChat(chatId, "Not authorized.", threadId);
             return;
@@ -428,6 +464,31 @@ export class CcTgBot {
                 return;
             }
         }
+        // Forum topic → meta-agent routing (runs after hashtag routing so explicit #tag wins)
+        if (this.redis && threadId !== undefined) {
+            const topicKey = `${chatId}:${threadId}`;
+            const topicName = this.topicNameCache.get(topicKey);
+            if (topicName) {
+                const namespace = normalizeTopicNamespace(topicName);
+                const routingConfig = this.getForumRoutingConfig();
+                const shouldRoute = routingConfig === "auto" ||
+                    (routingConfig instanceof Set && (routingConfig.has(topicName) || routingConfig.has(namespace)));
+                if (shouldRoute) {
+                    const defaultOrg = process.env.DEFAULT_GITHUB_ORG ?? "gonzih";
+                    const repoUrl = `https://github.com/${defaultOrg}/${namespace}`;
+                    await this.replyToChat(chatId, `→ #${namespace} (meta-agent)`, threadId);
+                    this.writeChatMessage("user", "telegram", text, chatId);
+                    try {
+                        await ensureMetaAgent(namespace, repoUrl, (toolName, args) => this.callCcAgentTool(toolName, args ?? {}), this.redis);
+                        await routeToMetaAgent(namespace, text, this.redis);
+                    }
+                    catch (err) {
+                        await this.replyToChat(chatId, `Failed to route to #${namespace}: ${err.message}`, threadId);
+                    }
+                    return;
+                }
+            }
+        }
         const session = this.getOrCreateSession(chatId, threadId, threadName);
         try {
             const enriched = await enrichPromptWithUrls(text);
@@ -1523,6 +1584,25 @@ export function listSkills() {
     }
     return lines.join("\n");
 }
+/**
+ * Normalize a Telegram forum topic name into a meta-agent namespace.
+ * Rules: strip leading #, lowercase, spaces → hyphens, non-alphanumeric → hyphens,
+ * collapse and trim hyphens.
+ *
+ * Examples:
+ *   "CC Suite"  → "cc-suite"
+ *   "#research" → "research"
+ *   "of-stack"  → "of-stack"
+ */
+export function normalizeTopicNamespace(name) {
+    return name
+        .replace(/^#+/, "") // strip leading # prefix
+        .toLowerCase()
+        .replace(/\s+/g, "-") // spaces → hyphens
+        .replace(/[^a-z0-9._-]/g, "-") // non-alphanumeric/non-safe → hyphens
+        .replace(/-+/g, "-") // collapse consecutive hyphens
+        .replace(/^-|-$/g, ""); // trim leading/trailing hyphens
+}
 export function splitMessage(text, maxLen = 4096) {
     if (text.length <= maxLen)
         return [text];

package/dist/router.js

@@ -58,13 +58,16 @@ export function parseRoutingTag(text) {
 export async function ensureMetaAgent(namespace, repoUrl, callTool, redis) {
     const timeoutMs = parseInt(process.env.META_AGENT_TIMEOUT_MS ?? "10000", 10);
     const statusKey = `cca:meta-agent:status:${namespace}`;
-    // Fast path: already running
+    console.log(`[router] ensureMetaAgent namespace=${namespace} checking ${statusKey}`);
+    // Fast path: already running or idle (idle = ready to receive messages)
     const statusRaw = await redis.get(statusKey);
     if (statusRaw) {
         try {
             const status = JSON.parse(statusRaw);
-            if (status.status === "running")
+            if (status.status === "running" || status.status === "idle") {
+                console.log(`[router] meta-agent ${namespace} is already ready (status=${status.status})`);
                 return;
+            }
         }
         catch {
             // Corrupt status value — fall through and restart
@@ -91,7 +94,7 @@ export async function ensureMetaAgent(namespace, repoUrl, callTool, redis) {
     if (result === null) {
         throw new Error(`start_meta_agent returned null — tool may not be available in cc-agent`);
     }
-    // Poll until the meta-agent reports "running"
+    // Poll until the meta-agent reports "running" or "idle" (both mean ready)
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
         await new Promise((resolve) => setTimeout(resolve, 1000));
@@ -99,13 +102,17 @@ export async function ensureMetaAgent(namespace, repoUrl, callTool, redis) {
         if (raw) {
             try {
                 const s = JSON.parse(raw);
-                if (s.status === "running")
+                console.log(`[router] waiting for meta-agent ${namespace} — current status: ${s.status}`);
+                if (s.status === "running" || s.status === "idle")
                     return;
             }
             catch {
                 // ignore parse errors, keep polling
             }
         }
+        else {
+            console.log(`[router] waiting for meta-agent ${namespace} — no status key yet`);
+        }
     }
     throw new Error(`Meta-agent for ${namespace} did not become ready within ${timeoutMs}ms`);
 }

package/package.json

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