@gonzih/cc-tg 0.7.3 → 0.7.4

package/dist/notifier.js

@@ -0,0 +1,105 @@
+/**
+ * Notifier — subscribes to Redis pub/sub channels and bridges messages to Telegram.
+ *
+ * Channels:
+ *   cca:notify:{namespace}       — job completion notifications from cc-agent → forward to Telegram
+ *   cca:chat:incoming:{namespace} — messages from the web UI → echo to Telegram + feed into Claude session
+ *
+ * All messages (Telegram incoming, Claude responses) are also written to:
+ *   cca:chat:log:{namespace}     — LPUSH + LTRIM 0 499 (last 500 messages)
+ *   cca:chat:outgoing:{namespace} — PUBLISH for web UI to consume
+ */
+function log(level, ...args) {
+    const fn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+    fn("[notifier]", ...args);
+}
+/**
+ * Write a message to the chat log in Redis.
+ * Fire-and-forget — errors are logged but not thrown.
+ */
+export function writeChatLog(redis, namespace, msg) {
+    const logKey = `cca:chat:log:${namespace}`;
+    const outKey = `cca:chat:outgoing:${namespace}`;
+    const payload = JSON.stringify(msg);
+    redis.lpush(logKey, payload).catch((err) => {
+        log("warn", "writeChatLog lpush failed:", err.message);
+    });
+    redis.ltrim(logKey, 0, 499).catch((err) => {
+        log("warn", "writeChatLog ltrim failed:", err.message);
+    });
+    redis.publish(outKey, payload).catch((err) => {
+        log("warn", "writeChatLog publish failed:", err.message);
+    });
+}
+/**
+ * Start the notifier.
+ *
+ * @param bot       - Telegram bot instance (for sending messages)
+ * @param chatId    - Telegram chat ID to forward notifications to
+ * @param namespace - cc-agent namespace (used to build Redis channel names)
+ * @param redis     - ioredis client in normal mode (will be duplicated for pub/sub)
+ * @param handleUserMessage - Optional callback to feed UI messages into the active Claude session
+ */
+export function startNotifier(bot, chatId, namespace, redis, handleUserMessage) {
+    const sub = redis.duplicate();
+    sub.on("error", (err) => {
+        log("warn", "subscriber error:", err.message);
+    });
+    // cca:notify:{namespace} — forward job completion notifications to Telegram
+    sub.subscribe(`cca:notify:${namespace}`, (err) => {
+        if (err) {
+            log("error", `subscribe cca:notify:${namespace} failed:`, err.message);
+        }
+        else {
+            log("info", `subscribed to cca:notify:${namespace}`);
+        }
+    });
+    // cca:chat:incoming:{namespace} — messages from UI
+    sub.subscribe(`cca:chat:incoming:${namespace}`, (err) => {
+        if (err) {
+            log("error", `subscribe cca:chat:incoming:${namespace} failed:`, err.message);
+        }
+        else {
+            log("info", `subscribed to cca:chat:incoming:${namespace}`);
+        }
+    });
+    sub.on("message", (channel, message) => {
+        const notifyChannel = `cca:notify:${namespace}`;
+        const incomingChannel = `cca:chat:incoming:${namespace}`;
+        if (channel === notifyChannel) {
+            bot.sendMessage(chatId, message).catch((err) => {
+                log("warn", "sendMessage failed:", err.message);
+            });
+            return;
+        }
+        if (channel === incomingChannel) {
+            let content = message;
+            try {
+                const parsed = JSON.parse(message);
+                if (parsed.content)
+                    content = parsed.content;
+            }
+            catch {
+                // raw string message — use as-is
+            }
+            // Echo to Telegram so the user sees UI messages in the chat
+            bot.sendMessage(chatId, `📱 [from UI]: ${content}`).catch((err) => {
+                log("warn", "sendMessage (UI echo) failed:", err.message);
+            });
+            // Log the incoming message
+            const inMsg = {
+                id: `ui-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                source: "ui",
+                role: "user",
+                content,
+                timestamp: new Date().toISOString(),
+                chatId,
+            };
+            writeChatLog(redis, namespace, inMsg);
+            // Feed into active Claude session as if user typed it
+            if (handleUserMessage) {
+                handleUserMessage(chatId, content);
+            }
+        }
+    });
+}

package/dist/tokens.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OAuth token pool management.
+ *
+ * Supports CLAUDE_CODE_OAUTH_TOKENS (comma-separated list of tokens).
+ * Falls back to CLAUDE_CODE_OAUTH_TOKEN for single-token / backwards compat.
+ */
+/**
+ * Load tokens from env vars. Called on startup; also re-callable in tests.
+ * Priority: CLAUDE_CODE_OAUTH_TOKENS > CLAUDE_CODE_OAUTH_TOKEN > (empty)
+ */
+export declare function loadTokens(): string[];
+/** Returns the current active token, or empty string if none configured. */
+export declare function getCurrentToken(): string;
+/**
+ * Advance to the next token (wraps around).
+ * Returns the new current token.
+ */
+export declare function rotateToken(): string;
+/** Zero-based index of the current token. */
+export declare function getTokenIndex(): number;
+/** Total number of tokens in the pool. */
+export declare function getTokenCount(): number;

package/dist/tokens.js

@@ -0,0 +1,56 @@
+/**
+ * OAuth token pool management.
+ *
+ * Supports CLAUDE_CODE_OAUTH_TOKENS (comma-separated list of tokens).
+ * Falls back to CLAUDE_CODE_OAUTH_TOKEN for single-token / backwards compat.
+ */
+let tokens = [];
+let currentIndex = 0;
+let initialized = false;
+/**
+ * Load tokens from env vars. Called on startup; also re-callable in tests.
+ * Priority: CLAUDE_CODE_OAUTH_TOKENS > CLAUDE_CODE_OAUTH_TOKEN > (empty)
+ */
+export function loadTokens() {
+    const multi = process.env.CLAUDE_CODE_OAUTH_TOKENS;
+    if (multi) {
+        tokens = multi.split(",").map((t) => t.trim()).filter(Boolean);
+    }
+    else {
+        const single = process.env.CLAUDE_CODE_OAUTH_TOKEN;
+        tokens = single ? [single] : [];
+    }
+    currentIndex = 0;
+    initialized = true;
+    return tokens;
+}
+function ensureInitialized() {
+    if (!initialized)
+        loadTokens();
+}
+/** Returns the current active token, or empty string if none configured. */
+export function getCurrentToken() {
+    ensureInitialized();
+    return tokens[currentIndex] ?? "";
+}
+/**
+ * Advance to the next token (wraps around).
+ * Returns the new current token.
+ */
+export function rotateToken() {
+    ensureInitialized();
+    if (tokens.length === 0)
+        return "";
+    currentIndex = (currentIndex + 1) % tokens.length;
+    return tokens[currentIndex];
+}
+/** Zero-based index of the current token. */
+export function getTokenIndex() {
+    ensureInitialized();
+    return currentIndex;
+}
+/** Total number of tokens in the pool. */
+export function getTokenCount() {
+    ensureInitialized();
+    return tokens.length;
+}

package/dist/usage-limit.d.ts

@@ -0,0 +1,7 @@
+export interface UsageLimitSignal {
+    detected: boolean;
+    reason: 'usage_exhausted' | 'rate_limit';
+    retryAfterMs: number;
+    humanMessage: string;
+}
+export declare function detectUsageLimit(text: string): UsageLimitSignal;

package/dist/usage-limit.js

@@ -0,0 +1,29 @@
+export function detectUsageLimit(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes('extra usage') ||
+        lower.includes('usage has been disabled') ||
+        lower.includes('billing_error') ||
+        lower.includes('usage limit')) {
+        const wake = nextHourBoundary() + 5 * 60 * 1000;
+        return {
+            detected: true,
+            reason: 'usage_exhausted',
+            retryAfterMs: wake - Date.now(),
+            humanMessage: `⏸ Claude usage limit reached. Will auto-resume at ${new Date(wake).toUTCString()}. I'll message you when it's back.`,
+        };
+    }
+    if (lower.includes('rate limit') || lower.includes('overloaded')) {
+        return {
+            detected: true,
+            reason: 'rate_limit',
+            retryAfterMs: 2 * 60 * 1000,
+            humanMessage: `⏸ Rate limited. Retrying in 2 minutes...`,
+        };
+    }
+    return { detected: false, reason: 'rate_limit', retryAfterMs: 0, humanMessage: '' };
+}
+function nextHourBoundary() {
+    const d = new Date();
+    d.setHours(d.getHours() + 1, 0, 0, 0);
+    return d.getTime();
+}

package/dist/voice.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Voice message transcription via whisper.cpp.
+ * Flow: Telegram OGG → ffmpeg convert to 16kHz WAV → whisper-cpp → text
+ */
+/**
+ * Transcribe a voice message from a Telegram file URL.
+ * Returns the transcribed text, or throws if whisper/ffmpeg not available.
+ */
+export declare function transcribeVoice(fileUrl: string): Promise<string>;
+/**
+ * Check if voice transcription is available on this system.
+ */
+export declare function isVoiceAvailable(): boolean;

package/dist/voice.js

@@ -0,0 +1,124 @@
+/**
+ * Voice message transcription via whisper.cpp.
+ * Flow: Telegram OGG → ffmpeg convert to 16kHz WAV → whisper-cpp → text
+ */
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { existsSync } from "fs";
+import { unlink } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import https from "https";
+import http from "http";
+import { createWriteStream } from "fs";
+const execFileAsync = promisify(execFile);
+// Whisper model — small.en is fast and accurate enough for commands
+// Falls back to base.en if small not found
+const WHISPER_MODELS = [
+    "/opt/homebrew/share/whisper-cpp/ggml-small.en.bin",
+    "/opt/homebrew/share/whisper-cpp/ggml-small.bin",
+    "/opt/homebrew/share/whisper-cpp/ggml-base.en.bin",
+    "/opt/homebrew/share/whisper-cpp/ggml-base.bin",
+    // user-local
+    `${process.env.HOME}/.local/share/whisper-cpp/ggml-small.en.bin`,
+    `${process.env.HOME}/.local/share/whisper-cpp/ggml-base.en.bin`,
+];
+const WHISPER_BIN_CANDIDATES = [
+    "/opt/homebrew/bin/whisper-cli", // whisper-cpp brew formula installs as whisper-cli
+    "/opt/homebrew/bin/whisper-cpp",
+    "/usr/local/bin/whisper-cli",
+    "/usr/local/bin/whisper-cpp",
+    "/opt/homebrew/bin/whisper",
+];
+const FFMPEG_CANDIDATES = [
+    "/opt/homebrew/bin/ffmpeg",
+    "/usr/local/bin/ffmpeg",
+    "/usr/bin/ffmpeg",
+];
+function findBin(candidates) {
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function findModel() {
+    for (const p of WHISPER_MODELS) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = createWriteStream(dest);
+        const getter = url.startsWith("https") ? https : http;
+        getter.get(url, (res) => {
+            if (res.statusCode !== 200) {
+                reject(new Error(`HTTP ${res.statusCode} downloading ${url}`));
+                return;
+            }
+            res.pipe(file);
+            file.on("finish", () => file.close(() => resolve()));
+            file.on("error", reject);
+        }).on("error", reject);
+    });
+}
+/**
+ * Transcribe a voice message from a Telegram file URL.
+ * Returns the transcribed text, or throws if whisper/ffmpeg not available.
+ */
+export async function transcribeVoice(fileUrl) {
+    const whisperBin = findBin(WHISPER_BIN_CANDIDATES);
+    if (!whisperBin)
+        throw new Error("whisper-cpp not found — install with: brew install whisper-cpp");
+    const ffmpegBin = findBin(FFMPEG_CANDIDATES);
+    if (!ffmpegBin)
+        throw new Error("ffmpeg not found — install with: brew install ffmpeg");
+    const model = findModel();
+    if (!model)
+        throw new Error("No whisper model found — run: whisper-cpp-download-ggml-model small.en");
+    const tmp = join(tmpdir(), `cc-tg-voice-${Date.now()}`);
+    const oggPath = `${tmp}.ogg`;
+    const wavPath = `${tmp}.wav`;
+    try {
+        // 1. Download OGG from Telegram
+        await downloadFile(fileUrl, oggPath);
+        // 2. Convert OGG → 16kHz mono WAV (whisper requirement)
+        await execFileAsync(ffmpegBin, [
+            "-y", "-i", oggPath,
+            "-ar", "16000",
+            "-ac", "1",
+            "-c:a", "pcm_s16le",
+            wavPath,
+        ]);
+        // 3. Run whisper-cpp
+        const { stdout } = await execFileAsync(whisperBin, [
+            "-m", model,
+            "-f", wavPath,
+            "--no-timestamps",
+            "-l", "auto",
+            "--output-txt",
+        ]);
+        // whisper outputs to stdout — strip leading/trailing whitespace and [BLANK_AUDIO] artifacts
+        const text = stdout
+            .replace(/\[BLANK_AUDIO\]/gi, "")
+            .replace(/\[.*?\]/g, "") // remove timestamp artifacts
+            .trim();
+        return text || "[empty transcription]";
+    }
+    finally {
+        // Cleanup temp files
+        await unlink(oggPath).catch(() => { });
+        await unlink(wavPath).catch(() => { });
+        await unlink(`${wavPath}.txt`).catch(() => { });
+    }
+}
+/**
+ * Check if voice transcription is available on this system.
+ */
+export function isVoiceAvailable() {
+    return (findBin(WHISPER_BIN_CANDIDATES) !== null &&
+        findBin(FFMPEG_CANDIDATES) !== null &&
+        findModel() !== null);
+}

package/package.json

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