@gonzih/cc-tg 0.9.35 → 0.9.37

package/README.md

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

package/dist/bot.js

@@ -16,6 +16,7 @@ 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" },
@@ -410,6 +411,23 @@ 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;
+            }
+        }
         const session = this.getOrCreateSession(chatId, threadId, threadName);
         try {
             const enriched = await enrichPromptWithUrls(text);

package/dist/router.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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
+ *   #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.
+ *
+ * Examples:
+ *   "#cc-agent fix the bug"           → { namespace: "cc-agent", repoUrl: "…/gonzih/cc-agent", … }
+ *   "#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" → { namespace: "of-stack", repoUrl: "…/gonzih/of-stack", … }
+ */
+export declare function parseRoutingTag(text: string): RoutingTag | null;
+/**
+ * Ensure a meta-agent for the given namespace is running.
+ *
+ * Steps:
+ *   1. Check cca:meta-agent:status:{namespace} in Redis — return early if already running.
+ *   2. Verify the GitHub repo exists; create it (public) if not.
+ *   3. Call the start_meta_agent MCP tool via callTool.
+ *   4. Poll the Redis status key every 1s until running or META_AGENT_TIMEOUT_MS expires.
+ *
+ * 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

@@ -0,0 +1,129 @@
+/**
+ * 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
+ *   #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.
+ *
+ * Examples:
+ *   "#cc-agent fix the bug"           → { namespace: "cc-agent", repoUrl: "…/gonzih/cc-agent", … }
+ *   "#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" → { namespace: "of-stack", repoUrl: "…/gonzih/of-stack", … }
+ */
+export function parseRoutingTag(text) {
+    const defaultOrg = process.env.DEFAULT_GITHUB_ORG ?? "gonzih";
+    // 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 — use DEFAULT_GITHUB_ORG
+        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 cca:meta-agent:status:{namespace} in Redis — return early if already running.
+ *   2. Verify the GitHub repo exists; create it (public) if not.
+ *   3. Call the start_meta_agent MCP tool via callTool.
+ *   4. Poll the Redis status key every 1s until running or META_AGENT_TIMEOUT_MS expires.
+ *
+ * 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}`;
+    // Fast path: already running
+    const statusRaw = await redis.get(statusKey);
+    if (statusRaw) {
+        try {
+            const status = JSON.parse(statusRaw);
+            if (status.status === "running")
+                return;
+        }
+        catch {
+            // Corrupt status value — fall through and restart
+        }
+    }
+    // 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
+    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`);
+    }
+    // Poll until the meta-agent reports "running"
+    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);
+                if (s.status === "running")
+                    return;
+            }
+            catch {
+                // ignore parse errors, keep polling
+            }
+        }
+    }
+    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}`);
+}

package/package.json

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