@gonzih/cc-tg 0.9.42 → 0.9.43

package/README.md

@@ -1,6 +1,6 @@
 # cc-tg
 
-<img src="assets/logo.png" alt="cc-tg" width="120">
+<img src="assets/logo.png" alt="AMAI" width="120">
 
 [![npm version](https://img.shields.io/npm/v/@gonzih/cc-tg)](https://www.npmjs.com/package/@gonzih/cc-tg)
 

package/dist/bot.d.ts

@@ -27,8 +27,6 @@ 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. */
@@ -45,13 +43,6 @@ 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;
     /**
@@ -94,15 +85,4 @@ 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

@@ -16,7 +16,6 @@ import { detectUsageLimit } from "./usage-limit.js";
 import { getCurrentToken, rotateToken, getTokenIndex, getTokenCount } from "./tokens.js";
 import { writeChatLog } from "./notifier.js";
 import { CronManager } from "./cron.js";
-import { parseRoutingTag, ensureMetaAgent, routeToMetaAgent } from "./router.js";
 const BOT_COMMANDS = [
     { command: "start", description: "Reset session and start fresh" },
     { command: "reset", description: "Reset Claude session" },
@@ -36,8 +35,7 @@ const BOT_COMMANDS = [
     { command: "drivers", description: "List available agent drivers" },
     { command: "agents", description: "Show running meta-agents and their live status" },
 ];
-// Debounces streaming chunks. Resets on each chunk. Fires 800ms after last chunk.
-const FLUSH_DELAY_MS = 800;
+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 = {
@@ -176,8 +174,6 @@ 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;
@@ -208,7 +204,7 @@ export class CcTgBot {
         if (!this.redis)
             return;
         const msg = {
-            id: crypto.randomUUID(),
+            id: `${source}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
             source,
             role,
             content,
@@ -252,20 +248,6 @@ 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;
@@ -282,26 +264,6 @@ 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;
@@ -447,48 +409,6 @@ export class CcTgBot {
             await this.handleAgents(chatId, threadId);
             return;
         }
-        // #tag / #org/repo routing — delegate to meta-agent instead of local Claude session
-        if (this.redis) {
-            const routing = parseRoutingTag(text);
-            if (routing) {
-                // Acknowledge routing immediately so user knows the message was delegated
-                await this.replyToChat(chatId, `→ #${routing.namespace}`, threadId);
-                this.writeChatMessage("user", "telegram", text, chatId);
-                try {
-                    await ensureMetaAgent(routing.namespace, routing.repoUrl, (toolName, args) => this.callCcAgentTool(toolName, args ?? {}), this.redis);
-                    await routeToMetaAgent(routing.namespace, routing.strippedMessage, this.redis);
-                }
-                catch (err) {
-                    await this.replyToChat(chatId, `Failed to route to #${routing.namespace}: ${err.message}`, threadId);
-                }
-                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);
@@ -1584,25 +1504,6 @@ 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/notifier.js

@@ -79,7 +79,6 @@ export function writeChatLog(redis, namespace, msg) {
     const logKey = `cca:chat:log:${namespace}`;
     const outKey = `cca:chat:outgoing:${namespace}`;
     const payload = JSON.stringify(msg);
-    // LIFO — newest first. Consumers must LRANGE 0 N then reverse for chronological order.
     redis.lpush(logKey, payload).catch((err) => {
         log("warn", "writeChatLog lpush failed:", err.message);
     });
@@ -142,9 +141,7 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
             log("info", "psubscribed to cca:chat:outgoing:*");
         }
     });
-    // 1.5s silence buffer. Combined with cc-agent's 3s poll = up to 4.5s meta-agent response latency.
-    const META_AGENT_FLUSH_DELAY_MS = 1500;
-    // Per-namespace debounce buffer: accumulate streaming lines, flush after silence
+    // Per-namespace debounce buffer: accumulate streaming lines, flush after 1.5s silence
     const metaAgentBuffers = new Map();
     function flushMetaAgentBuffer(ns, targetChatId) {
         const buf = metaAgentBuffers.get(ns);
@@ -188,10 +185,17 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
             buf = { text: "", timer: null };
             metaAgentBuffers.set(ns, buf);
         }
-        buf.text += (buf.text ? "\n" : "") + content;
+        // Prefix first line with ← when message comes from a different namespace (e.g. of-stack)
+        const isExternal = ns !== namespace;
+        if (!buf.text && isExternal) {
+            buf.text = "← " + content;
+        }
+        else {
+            buf.text += (buf.text ? "\n" : "") + content;
+        }
         if (buf.timer)
             clearTimeout(buf.timer);
-        buf.timer = setTimeout(() => flushMetaAgentBuffer(ns, targetChatId), META_AGENT_FLUSH_DELAY_MS);
+        buf.timer = setTimeout(() => flushMetaAgentBuffer(ns, targetChatId), 1500);
     });
     // Poll the cca:notify:{namespace} LIST every 5 seconds.
     // Jobs push to this list via RPUSH; pub/sub alone won't deliver those messages.
@@ -230,9 +234,6 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
             bot.sendMessage(targetId, text).catch((err) => {
                 log("warn", "notify list sendMessage failed:", err.message);
             });
-            if (handleUserMessage) {
-                handleUserMessage(targetId, text);
-            }
         }
         if (remaining > 0) {
             bot.sendMessage(targetId, `...and ${remaining} more notifications`).catch((err) => {
@@ -253,9 +254,6 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
                 bot.sendMessage(targetId, text).catch((err) => {
                     log("warn", "sendMessage failed:", err.message);
                 });
-                if (handleUserMessage) {
-                    handleUserMessage(targetId, text);
-                }
             }
             else {
                 log("warn", "notify: no chatId available, dropping notification");
@@ -284,7 +282,7 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
                 });
                 // Log the incoming message — preserve original timestamp from UI if present
                 const inMsg = {
-                    id: crypto.randomUUID(),
+                    id: `ui-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
                     source: "ui", // 'ui' distinguishes this from telegram/claude messages
                     role: "user",
                     content,
@@ -306,8 +304,7 @@ export function startNotifier(bot, chatId, namespace, redis, handleUserMessage,
                                     content,
                                     timestamp: new Date().toISOString(),
                                 });
-                                // Polled by cc-agent every 3s — up to 3s delivery latency
-                                await redis.rpush(`cca:meta:${namespace}:input`, entry);
+                                await redis.lpush(`cca:meta:${namespace}:input`, entry);
                                 log("info", `cca:chat:incoming: routed to meta-agent for namespace ${namespace}`);
                                 routedToMetaAgent = true;
                             }

package/dist/tokens.d.ts

@@ -3,8 +3,6 @@
  *
  * Supports CLAUDE_CODE_OAUTH_TOKENS (comma-separated list of tokens).
  * Falls back to CLAUDE_CODE_OAUTH_TOKEN for single-token / backwards compat.
- *
- * cc-tg token pool rotates independently from cc-agent's pool. No coordination between them.
  */
 /**
  * Load tokens from env vars. Called on startup; also re-callable in tests.

package/dist/tokens.js

@@ -3,8 +3,6 @@
  *
  * Supports CLAUDE_CODE_OAUTH_TOKENS (comma-separated list of tokens).
  * Falls back to CLAUDE_CODE_OAUTH_TOKEN for single-token / backwards compat.
- *
- * cc-tg token pool rotates independently from cc-agent's pool. No coordination between them.
  */
 let tokens = [];
 let currentIndex = 0;

package/package.json

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

package/LICENSE

@@ -1,203 +0,0 @@
-Copyright 2026 Maksim Soltan
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or exemplary damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.

package/dist/router.d.ts

@@ -1,59 +0,0 @@
-/**
- * Hashtag meta-agent routing.
- *
- * Parses #tag or #org/repo tokens from Telegram messages and routes them to
- * the appropriate cc-agent meta-agent instead of the local Claude session.
- *
- * Tag formats:
- *   #repo-name    → namespace=repo-name, repo=https://github.com/{DEFAULT_GITHUB_ORG}/repo-name (null if DEFAULT_GITHUB_ORG unset)
- *   #org/repo     → namespace=repo,      repo=https://github.com/org/repo
- */
-import { Redis } from "ioredis";
-/** Callback type matching CcTgBot.callCcAgentTool */
-export type CallToolFn = (toolName: string, args?: Record<string, unknown>) => Promise<string | null>;
-export interface RoutingTag {
-    namespace: string;
-    repoUrl: string;
-    /** Original message with the tag token stripped and whitespace collapsed */
-    strippedMessage: string;
-}
-/**
- * Parse the first #tag or #org/repo token from a message.
- * Returns null when no routing tag is present, or when the short #repo format is used
- * without DEFAULT_GITHUB_ORG being set (operators must configure this explicitly).
- *
- * Examples:
- *   "#cc-agent fix the bug"           → null if DEFAULT_GITHUB_ORG unset; { namespace: "cc-agent", repoUrl: "…/{org}/cc-agent", … } if set
- *   "#gonzih/of-stack deploy it"      → { namespace: "of-stack", repoUrl: "…/gonzih/of-stack", … }
- *   "#org/repo do something"          → { namespace: "repo",     repoUrl: "…/org/repo", … }
- *   "please help #of-stack with this" → null if DEFAULT_GITHUB_ORG unset
- */
-export declare function parseRoutingTag(text: string): RoutingTag | null;
-/**
- * Ensure a meta-agent for the given namespace is running.
- *
- * Steps:
- *   1. Check Redis for readiness via two keys (see below) — return early if already ready.
- *   2. Verify the GitHub repo exists; create it (public) if not.
- *   3. Call the start_meta_agent MCP tool via callTool.
- *   4. Poll both Redis keys every 1s until ready or META_AGENT_TIMEOUT_MS expires.
- *
- * Two Redis keys are checked:
- *   cca:meta-agent:status:{namespace} — live-status key written by writeLiveStatus()
- *     (only populated after the first message is processed by messageMetaAgent)
- *   cca:meta:{namespace} — state key written by startMetaAgent() directly via saveState()
- *     (populated as soon as the workspace is created, with status:"idle")
- *
- * Bug context: start_meta_agent writes cca:meta:{namespace} but NOT cca:meta-agent:status:{namespace}.
- * Polling only the status key caused a 10s timeout on every cold start.
- *
- * Throws on failure (repo creation error, tool call failure, or timeout).
- */
-export declare function ensureMetaAgent(namespace: string, repoUrl: string, callTool: CallToolFn, redis: Redis): Promise<void>;
-/**
- * Route a message to a running meta-agent via Redis RPUSH.
- * The cc-agent polls cca:meta:{namespace}:input every 3s (up to 3s delivery latency).
- *
- * No-op when strippedMessage is empty (user sent only the tag token).
- */
-export declare function routeToMetaAgent(namespace: string, strippedMessage: string, redis: Redis): Promise<void>;

package/dist/router.js

@@ -1,192 +0,0 @@
-/**
- * Hashtag meta-agent routing.
- *
- * Parses #tag or #org/repo tokens from Telegram messages and routes them to
- * the appropriate cc-agent meta-agent instead of the local Claude session.
- *
- * Tag formats:
- *   #repo-name    → namespace=repo-name, repo=https://github.com/{DEFAULT_GITHUB_ORG}/repo-name (null if DEFAULT_GITHUB_ORG unset)
- *   #org/repo     → namespace=repo,      repo=https://github.com/org/repo
- */
-import { execSync } from "child_process";
-/**
- * Parse the first #tag or #org/repo token from a message.
- * Returns null when no routing tag is present, or when the short #repo format is used
- * without DEFAULT_GITHUB_ORG being set (operators must configure this explicitly).
- *
- * Examples:
- *   "#cc-agent fix the bug"           → null if DEFAULT_GITHUB_ORG unset; { namespace: "cc-agent", repoUrl: "…/{org}/cc-agent", … } if set
- *   "#gonzih/of-stack deploy it"      → { namespace: "of-stack", repoUrl: "…/gonzih/of-stack", … }
- *   "#org/repo do something"          → { namespace: "repo",     repoUrl: "…/org/repo", … }
- *   "please help #of-stack with this" → null if DEFAULT_GITHUB_ORG unset
- */
-export function parseRoutingTag(text) {
-    const defaultOrg = process.env.DEFAULT_GITHUB_ORG;
-    // Match #word or #org/repo — each segment: starts with alphanumeric, allows ._- inside
-    const match = text.match(/#([a-zA-Z0-9][a-zA-Z0-9._-]*)(?:\/([a-zA-Z0-9][a-zA-Z0-9._-]*))?/);
-    if (!match)
-        return null;
-    const fullMatch = match[0]; // e.g. "#gonzih/of-stack"
-    const part1 = match[1]; // org-or-repo
-    const part2 = match[2]; // repo (only present in #org/repo format)
-    let namespace;
-    let repoUrl;
-    if (part2) {
-        // #org/repo format
-        namespace = part2;
-        repoUrl = `https://github.com/${part1}/${part2}`;
-    }
-    else {
-        // #repo format — requires DEFAULT_GITHUB_ORG; return null if unset
-        if (!defaultOrg)
-            return null;
-        namespace = part1;
-        repoUrl = `https://github.com/${defaultOrg}/${part1}`;
-    }
-    // Strip the matched tag token and collapse whitespace
-    const strippedMessage = text.replace(fullMatch, "").replace(/\s+/g, " ").trim();
-    return { namespace, repoUrl, strippedMessage };
-}
-/**
- * Ensure a meta-agent for the given namespace is running.
- *
- * Steps:
- *   1. Check Redis for readiness via two keys (see below) — return early if already ready.
- *   2. Verify the GitHub repo exists; create it (public) if not.
- *   3. Call the start_meta_agent MCP tool via callTool.
- *   4. Poll both Redis keys every 1s until ready or META_AGENT_TIMEOUT_MS expires.
- *
- * Two Redis keys are checked:
- *   cca:meta-agent:status:{namespace} — live-status key written by writeLiveStatus()
- *     (only populated after the first message is processed by messageMetaAgent)
- *   cca:meta:{namespace} — state key written by startMetaAgent() directly via saveState()
- *     (populated as soon as the workspace is created, with status:"idle")
- *
- * Bug context: start_meta_agent writes cca:meta:{namespace} but NOT cca:meta-agent:status:{namespace}.
- * Polling only the status key caused a 10s timeout on every cold start.
- *
- * Throws on failure (repo creation error, tool call failure, or timeout).
- */
-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}`;
-    // State key written by startMetaAgent() directly — the source of truth for workspace existence.
-    const stateKey = `cca:meta:${namespace}`;
-    console.log(`[router] ensureMetaAgent namespace=${namespace}`);
-    // Fast path: check live-status key (written by messageMetaAgent after first message)
-    const statusRaw = await redis.get(statusKey);
-    if (statusRaw) {
-        try {
-            const status = JSON.parse(statusRaw);
-            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
-        }
-    }
-    // Fast path: also check state key (written by startMetaAgent, persists 30 days).
-    // Presence of this key means the workspace was already created — no need to re-run start_meta_agent.
-    const stateRaw = await redis.get(stateKey);
-    if (stateRaw) {
-        try {
-            const state = JSON.parse(stateRaw);
-            if (state.status === "idle" || state.status === "running") {
-                console.log(`[router] meta-agent ${namespace} workspace exists (state.status=${state.status})`);
-                return;
-            }
-        }
-        catch {
-            // Corrupt state — fall through and re-initialize
-        }
-    }
-    // Derive "org/repo" from the full URL for gh CLI calls
-    const orgRepo = repoUrl.replace(/^https:\/\/github\.com\//, "");
-    // Verify / create the GitHub repo
-    try {
-        execSync(`gh repo view ${orgRepo}`, { stdio: "ignore" });
-    }
-    catch {
-        // Repo not found — create it
-        try {
-            execSync(`gh repo create ${orgRepo} --public --description "Meta-agent workspace for ${namespace}"`, { stdio: "pipe" });
-            console.log(`[router] created repo ${orgRepo} for namespace=${namespace}`);
-        }
-        catch (createErr) {
-            throw new Error(`Failed to create repo ${orgRepo}: ${createErr.message}`);
-        }
-    }
-    // Start the meta-agent via MCP (clones workspace if needed, writes cca:meta:{namespace})
-    const result = await callTool("start_meta_agent", { namespace, repo_url: repoUrl });
-    if (result === null) {
-        throw new Error(`start_meta_agent returned null — tool may not be available in cc-agent`);
-    }
-    // Check for explicit failure payload (e.g. git clone error)
-    try {
-        const parsed = JSON.parse(result);
-        if (parsed.ok === false) {
-            throw new Error(`start_meta_agent failed: ${parsed.error ?? "unknown error"}`);
-        }
-    }
-    catch (jsonErr) {
-        if (!(jsonErr instanceof SyntaxError))
-            throw jsonErr;
-        // Non-JSON result (e.g. plain "ok") — not an error, continue to poll
-    }
-    // Poll until ready. Check both keys:
-    //   - statusKey: written by writeLiveStatus() during messageMetaAgent (may not exist yet on cold start)
-    //   - stateKey:  written by startMetaAgent() above — will appear within 1s of the tool call returning
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        const raw = await redis.get(statusKey);
-        if (raw) {
-            try {
-                const s = JSON.parse(raw);
-                console.log(`[router] waiting for meta-agent ${namespace} — status key: ${s.status}`);
-                if (s.status === "running" || s.status === "idle")
-                    return;
-            }
-            catch {
-                // ignore parse errors, keep polling
-            }
-        }
-        // Also check state key — startMetaAgent writes this synchronously before responding
-        const state = await redis.get(stateKey);
-        if (state) {
-            try {
-                const s = JSON.parse(state);
-                console.log(`[router] waiting for meta-agent ${namespace} — state key: ${s.status}`);
-                if (s.status === "idle" || s.status === "running")
-                    return;
-            }
-            catch {
-                // ignore parse errors, keep polling
-            }
-        }
-        else {
-            console.log(`[router] waiting for meta-agent ${namespace} — neither key present yet`);
-        }
-    }
-    throw new Error(`Meta-agent for ${namespace} did not become ready within ${timeoutMs}ms`);
-}
-/**
- * Route a message to a running meta-agent via Redis RPUSH.
- * The cc-agent polls cca:meta:{namespace}:input every 3s (up to 3s delivery latency).
- *
- * No-op when strippedMessage is empty (user sent only the tag token).
- */
-export async function routeToMetaAgent(namespace, strippedMessage, redis) {
-    if (!strippedMessage)
-        return;
-    const entry = JSON.stringify({
-        id: crypto.randomUUID(),
-        content: strippedMessage,
-        timestamp: new Date().toISOString(),
-    });
-    // FIFO — cc-agent reads via LPOP
-    await redis.rpush(`cca:meta:${namespace}:input`, entry);
-    console.log(`[router] routed message to meta-agent namespace=${namespace}`);
-}