@gonzih/cc-tg 0.9.15 → 0.9.16

package/dist/claude.d.ts

@@ -1,54 +0,0 @@
-/**
- * Claude Code subprocess wrapper.
- * Mirrors ce_ce's mechanism: spawn `claude` CLI with stream-json I/O,
- * pipe prompts in, parse streaming JSON messages out.
- */
-import { EventEmitter } from "events";
-export type MessageType = "system" | "assistant" | "user" | "result";
-export interface ClaudeMessage {
-    type: MessageType;
-    session_id?: string;
-    uuid?: string;
-    payload: Record<string, unknown>;
-    raw: Record<string, unknown>;
-}
-export interface ClaudeOptions {
-    cwd?: string;
-    systemPrompt?: string;
-    /** OAuth token (sk-ant-oat01-...) or API key (sk-ant-api03-...) */
-    token?: string;
-}
-export interface UsageEvent {
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    cacheWriteTokens: number;
-}
-export declare interface ClaudeProcess {
-    on(event: "message", listener: (msg: ClaudeMessage) => void): this;
-    on(event: "usage", listener: (usage: UsageEvent) => void): this;
-    on(event: "error", listener: (err: Error) => void): this;
-    on(event: "exit", listener: (code: number | null) => void): this;
-    on(event: "stderr", listener: (data: string) => void): this;
-}
-export declare class ClaudeProcess extends EventEmitter {
-    private proc;
-    private buffer;
-    private _exited;
-    constructor(opts?: ClaudeOptions);
-    sendPrompt(text: string): void;
-    /**
-     * Send an image (with optional text caption) to Claude via stream-json content blocks.
-     * mediaType: image/jpeg | image/png | image/gif | image/webp
-     */
-    sendImage(base64Data: string, mediaType: string, caption?: string): void;
-    kill(): void;
-    get exited(): boolean;
-    private drainBuffer;
-    private parseMessage;
-}
-/**
- * Extract the text content from an assistant message payload.
- * Handles both simple string content and content-block arrays.
- */
-export declare function extractText(msg: ClaudeMessage): string;

package/dist/claude.js

@@ -1,208 +0,0 @@
-/**
- * Claude Code subprocess wrapper.
- * Mirrors ce_ce's mechanism: spawn `claude` CLI with stream-json I/O,
- * pipe prompts in, parse streaming JSON messages out.
- */
-import { spawn } from "child_process";
-import { EventEmitter } from "events";
-import { existsSync } from "fs";
-export class ClaudeProcess extends EventEmitter {
-    proc;
-    buffer = "";
-    _exited = false;
-    constructor(opts = {}) {
-        super();
-        const args = [
-            "--continue",
-            "--output-format", "stream-json",
-            "--input-format", "stream-json",
-            "--print",
-            "--verbose",
-            "--dangerously-skip-permissions",
-        ];
-        if (opts.systemPrompt) {
-            args.push("--system-prompt", opts.systemPrompt);
-        }
-        const env = { ...process.env };
-        if (opts.token) {
-            // API keys start with sk-ant-api — set ANTHROPIC_API_KEY only
-            // Everything else (OAuth sk-ant-oat, setup-token format with #, etc.)
-            // goes into CLAUDE_CODE_OAUTH_TOKEN
-            // Mixing them causes "Invalid API key" errors
-            if (opts.token.startsWith("sk-ant-api")) {
-                env.ANTHROPIC_API_KEY = opts.token;
-                delete env.CLAUDE_CODE_OAUTH_TOKEN;
-            }
-            else {
-                env.CLAUDE_CODE_OAUTH_TOKEN = opts.token;
-                delete env.ANTHROPIC_API_KEY;
-            }
-        }
-        // Resolve claude binary — check common install locations if not in PATH
-        const claudeBin = resolveClaude(env.PATH);
-        this.proc = spawn(claudeBin, args, {
-            cwd: opts.cwd ?? process.cwd(),
-            env,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        this.proc.stdout.on("data", (chunk) => {
-            this.buffer += chunk.toString();
-            this.drainBuffer();
-        });
-        this.proc.stderr.on("data", (chunk) => {
-            this.emit("stderr", chunk.toString());
-        });
-        this.proc.on("exit", (code) => {
-            this._exited = true;
-            this.emit("exit", code);
-        });
-        this.proc.on("error", (err) => {
-            this.emit("error", err);
-        });
-    }
-    sendPrompt(text) {
-        if (this._exited)
-            throw new Error("Claude process has exited");
-        const payload = JSON.stringify({
-            type: "user",
-            message: { role: "user", content: text },
-        });
-        this.proc.stdin.write(payload + "\n");
-    }
-    /**
-     * Send an image (with optional text caption) to Claude via stream-json content blocks.
-     * mediaType: image/jpeg | image/png | image/gif | image/webp
-     */
-    sendImage(base64Data, mediaType, caption) {
-        if (this._exited)
-            throw new Error("Claude process has exited");
-        const content = [];
-        if (caption) {
-            content.push({ type: "text", text: caption });
-        }
-        content.push({
-            type: "image",
-            source: {
-                type: "base64",
-                media_type: mediaType,
-                data: base64Data,
-            },
-        });
-        const payload = JSON.stringify({
-            type: "user",
-            message: { role: "user", content },
-        });
-        this.proc.stdin.write(payload + "\n");
-    }
-    kill() {
-        this.proc.kill();
-    }
-    get exited() {
-        return this._exited;
-    }
-    drainBuffer() {
-        const lines = this.buffer.split("\n");
-        // Last element may be incomplete — keep it
-        this.buffer = lines.pop() ?? "";
-        for (const line of lines) {
-            if (!line.trim())
-                continue;
-            let raw;
-            try {
-                raw = JSON.parse(line);
-            }
-            catch {
-                // Non-JSON line (startup noise etc.) — ignore
-                continue;
-            }
-            // Emit usage events from Anthropic API stream events passed through by Claude CLI
-            if (raw.type === "message_start") {
-                const usage = (raw.message?.usage);
-                if (usage) {
-                    this.emit("usage", {
-                        inputTokens: usage.input_tokens ?? 0,
-                        outputTokens: 0, // output_tokens at message_start is always 0
-                        cacheReadTokens: usage.cache_read_input_tokens ?? 0,
-                        cacheWriteTokens: usage.cache_creation_input_tokens ?? 0,
-                    });
-                }
-            }
-            else if (raw.type === "message_delta") {
-                const usage = raw.usage;
-                if (usage?.output_tokens) {
-                    this.emit("usage", {
-                        inputTokens: 0,
-                        outputTokens: usage.output_tokens,
-                        cacheReadTokens: 0,
-                        cacheWriteTokens: 0,
-                    });
-                }
-            }
-            const msg = this.parseMessage(raw);
-            if (msg)
-                this.emit("message", msg);
-        }
-    }
-    parseMessage(raw) {
-        const type = raw.type;
-        if (!type)
-            return null;
-        return {
-            type,
-            session_id: raw.session_id,
-            uuid: raw.uuid,
-            payload: raw,
-            raw,
-        };
-    }
-}
-/**
- * Extract the text content from an assistant message payload.
- * Handles both simple string content and content-block arrays.
- */
-export function extractText(msg) {
-    const message = msg.payload.message;
-    if (!message) {
-        // result message type
-        if (msg.type === "result") {
-            return msg.payload.result ?? "";
-        }
-        return "";
-    }
-    const content = message.content;
-    if (typeof content === "string")
-        return content;
-    if (Array.isArray(content)) {
-        return content
-            .filter((b) => b.type === "text")
-            .map((b) => b.text)
-            .join("");
-    }
-    return "";
-}
-/**
- * Resolve the claude CLI binary path.
- * Checks PATH entries + common npm global install locations.
- */
-function resolveClaude(pathEnv) {
-    // Try PATH entries first
-    const dirs = (pathEnv ?? process.env.PATH ?? "").split(":");
-    for (const dir of dirs) {
-        const candidate = `${dir}/claude`;
-        if (existsSync(candidate))
-            return candidate;
-    }
-    // Common fallback locations
-    const fallbacks = [
-        `${process.env.HOME}/.npm-global/bin/claude`,
-        "/opt/homebrew/bin/claude",
-        "/usr/local/bin/claude",
-        "/usr/bin/claude",
-    ];
-    for (const p of fallbacks) {
-        if (existsSync(p))
-            return p;
-    }
-    // Last resort — let the OS resolve it (will throw ENOENT if missing)
-    return "claude";
-}

package/dist/cron.d.ts

@@ -1,33 +0,0 @@
-/**
- * Cron job manager for cc-tg.
- * Persists jobs to <cwd>/.cc-tg/crons.json.
- * Fires prompts into Claude sessions on schedule.
- */
-export interface CronJob {
-    id: string;
-    chatId: number;
-    intervalMs: number;
-    prompt: string;
-    createdAt: string;
-    schedule: string;
-}
-type FireCallback = (chatId: number, prompt: string) => void;
-export declare class CronManager {
-    private jobs;
-    private storePath;
-    private fire;
-    constructor(cwd: string, fire: FireCallback);
-    /** Parse "every 30m", "every 2h", "every 1d" → ms */
-    static parseSchedule(schedule: string): number | null;
-    add(chatId: number, schedule: string, prompt: string): CronJob | null;
-    remove(chatId: number, id: string): boolean;
-    clearAll(chatId: number): number;
-    list(chatId: number): CronJob[];
-    update(chatId: number, id: string, updates: {
-        schedule?: string;
-        prompt?: string;
-    }): CronJob | null | false;
-    private persist;
-    private load;
-}
-export {};

package/dist/cron.js

@@ -1,127 +0,0 @@
-/**
- * Cron job manager for cc-tg.
- * Persists jobs to <cwd>/.cc-tg/crons.json.
- * Fires prompts into Claude sessions on schedule.
- */
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join } from "path";
-export class CronManager {
-    jobs = new Map();
-    storePath;
-    fire;
-    constructor(cwd, fire) {
-        this.storePath = join(cwd, ".cc-tg", "crons.json");
-        this.fire = fire;
-        this.load();
-    }
-    /** Parse "every 30m", "every 2h", "every 1d" → ms */
-    static parseSchedule(schedule) {
-        const m = schedule.trim().match(/^every\s+(\d+)(m|h|d)$/i);
-        if (!m)
-            return null;
-        const n = parseInt(m[1]);
-        const unit = m[2].toLowerCase();
-        if (unit === "m")
-            return n * 60_000;
-        if (unit === "h")
-            return n * 3_600_000;
-        if (unit === "d")
-            return n * 86_400_000;
-        return null;
-    }
-    add(chatId, schedule, prompt) {
-        const intervalMs = CronManager.parseSchedule(schedule);
-        if (!intervalMs)
-            return null;
-        const id = `${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
-        const job = { id, chatId, intervalMs, prompt, schedule, createdAt: new Date().toISOString() };
-        const timer = setInterval(() => {
-            console.log(`[cron:${id}] firing for chat=${chatId} prompt="${prompt}"`);
-            this.fire(chatId, prompt);
-        }, intervalMs);
-        this.jobs.set(id, { ...job, timer });
-        this.persist();
-        return job;
-    }
-    remove(chatId, id) {
-        const job = this.jobs.get(id);
-        if (!job || job.chatId !== chatId)
-            return false;
-        clearInterval(job.timer);
-        this.jobs.delete(id);
-        this.persist();
-        return true;
-    }
-    clearAll(chatId) {
-        let count = 0;
-        for (const [id, job] of this.jobs) {
-            if (job.chatId === chatId) {
-                clearInterval(job.timer);
-                this.jobs.delete(id);
-                count++;
-            }
-        }
-        if (count)
-            this.persist();
-        return count;
-    }
-    list(chatId) {
-        return [...this.jobs.values()]
-            .filter((j) => j.chatId === chatId)
-            .map(({ timer: _t, ...j }) => j);
-    }
-    update(chatId, id, updates) {
-        const job = this.jobs.get(id);
-        if (!job || job.chatId !== chatId)
-            return false;
-        if (updates.schedule !== undefined) {
-            const intervalMs = CronManager.parseSchedule(updates.schedule);
-            if (!intervalMs)
-                return null;
-            job.intervalMs = intervalMs;
-            job.schedule = updates.schedule;
-        }
-        if (updates.prompt !== undefined) {
-            job.prompt = updates.prompt;
-        }
-        // Recreate timer so it uses updated intervalMs and always reads latest job.prompt
-        clearInterval(job.timer);
-        job.timer = setInterval(() => {
-            console.log(`[cron:${job.id}] firing for chat=${job.chatId} prompt="${job.prompt}"`);
-            this.fire(job.chatId, job.prompt);
-        }, job.intervalMs);
-        this.persist();
-        const { timer: _t, ...cronJob } = job;
-        return cronJob;
-    }
-    persist() {
-        try {
-            const dir = join(this.storePath, "..");
-            if (!existsSync(dir))
-                mkdirSync(dir, { recursive: true });
-            const data = [...this.jobs.values()].map(({ timer: _t, ...j }) => j);
-            writeFileSync(this.storePath, JSON.stringify(data, null, 2));
-        }
-        catch (err) {
-            console.error("[cron] persist error:", err.message);
-        }
-    }
-    load() {
-        if (!existsSync(this.storePath))
-            return;
-        try {
-            const data = JSON.parse(readFileSync(this.storePath, "utf8"));
-            for (const job of data) {
-                const timer = setInterval(() => {
-                    console.log(`[cron:${job.id}] firing for chat=${job.chatId} prompt="${job.prompt}"`);
-                    this.fire(job.chatId, job.prompt);
-                }, job.intervalMs);
-                this.jobs.set(job.id, { ...job, timer });
-            }
-            console.log(`[cron] loaded ${data.length} jobs from disk`);
-        }
-        catch (err) {
-            console.error("[cron] load error:", err.message);
-        }
-    }
-}

package/dist/formatter.d.ts

@@ -1,23 +0,0 @@
-/**
- * Telegram MarkdownV2 post-processor.
- * Converts standard markdown to Telegram's MarkdownV2 format.
- */
-/**
- * Convert standard markdown text to Telegram MarkdownV2 format.
- *
- * Processing order:
- * 1. Extract code blocks (fenced + inline) — protect from further processing
- * 2. Strip raw HTML tags
- * 3. Convert --- → blank line
- * 4. Convert ## headings → *bold*
- * 5. Convert **bold** → *bold*
- * 6. Convert - list items → • item
- * 7. Escape MarkdownV2 special chars (outside code blocks)
- * 8. Reinsert code blocks unchanged
- */
-export declare function formatForTelegram(text: string): string;
-/**
- * Split a long message at natural boundaries (paragraph > line > word).
- * Never splits mid-word. Chunks are at most maxLen characters.
- */
-export declare function splitLongMessage(text: string, maxLen?: number): string[];

package/dist/formatter.js

@@ -1,86 +0,0 @@
-/**
- * Telegram MarkdownV2 post-processor.
- * Converts standard markdown to Telegram's MarkdownV2 format.
- */
-/**
- * Convert standard markdown text to Telegram MarkdownV2 format.
- *
- * Processing order:
- * 1. Extract code blocks (fenced + inline) — protect from further processing
- * 2. Strip raw HTML tags
- * 3. Convert --- → blank line
- * 4. Convert ## headings → *bold*
- * 5. Convert **bold** → *bold*
- * 6. Convert - list items → • item
- * 7. Escape MarkdownV2 special chars (outside code blocks)
- * 8. Reinsert code blocks unchanged
- */
-export function formatForTelegram(text) {
-    // Step 1: Extract code blocks and inline code to protect them
-    const placeholders = [];
-    // Fenced code blocks first (``` ... ```)
-    let out = text.replace(/```[\s\S]*?```/g, (match) => {
-        placeholders.push(match);
-        return `\x00P${placeholders.length - 1}\x00`;
-    });
-    // Inline code (`...`)
-    out = out.replace(/`[^`\n]+`/g, (match) => {
-        placeholders.push(match);
-        return `\x00P${placeholders.length - 1}\x00`;
-    });
-    // Step 2: Strip raw HTML tags
-    out = out.replace(/<[^>]+>/g, "");
-    // Step 3: Convert --- → blank line
-    out = out.replace(/^-{3,}$/gm, "");
-    // Step 4: Convert ## headings → *bold*
-    out = out.replace(/^#{1,6}\s+(.+)$/gm, "*$1*");
-    // Step 5: Convert **bold** → *bold*
-    out = out.replace(/\*\*(.+?)\*\*/gs, "*$1*");
-    // Step 6: Convert - list items → • item (leading - or * bullet)
-    out = out.replace(/^[ \t]*[-*]\s+(.+)$/gm, "• $1");
-    // Step 7: Escape MarkdownV2 special chars outside code blocks.
-    // Per Telegram spec, these must be escaped: _ [ ] ( ) ~ > # + - = | { } . ! \
-    // * is intentionally NOT escaped — it is used for bold formatting above.
-    out = out.replace(/([_\[\]()~>#+\-=|{}.!\\])/g, "\\$1");
-    // Step 8: Reinsert code blocks unchanged (no escaping inside them)
-    out = out.replace(/\x00P(\d+)\x00/g, (_, i) => placeholders[parseInt(i, 10)]);
-    return out;
-}
-/**
- * Split a long message at natural boundaries (paragraph > line > word).
- * Never splits mid-word. Chunks are at most maxLen characters.
- */
-export function splitLongMessage(text, maxLen = 4096) {
-    if (text.length <= maxLen)
-        return [text];
-    const chunks = [];
-    let remaining = text;
-    while (remaining.length > maxLen) {
-        const slice = remaining.slice(0, maxLen);
-        // Prefer paragraph boundary (\n\n)
-        const lastPara = slice.lastIndexOf("\n\n");
-        // Then line boundary (\n)
-        const lastLine = slice.lastIndexOf("\n");
-        // Then word boundary (space)
-        const lastSpace = slice.lastIndexOf(" ");
-        let splitAt;
-        if (lastPara > 0) {
-            splitAt = lastPara + 2;
-        }
-        else if (lastLine > 0) {
-            splitAt = lastLine + 1;
-        }
-        else if (lastSpace > 0) {
-            splitAt = lastSpace + 1;
-        }
-        else {
-            splitAt = maxLen;
-        }
-        chunks.push(remaining.slice(0, splitAt).trimEnd());
-        remaining = remaining.slice(splitAt).trimStart();
-    }
-    if (remaining.length > 0) {
-        chunks.push(remaining);
-    }
-    return chunks;
-}

package/dist/index.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-/**
- * cc-tg — Claude Code Telegram bot
- *
- * Usage:
- *   npx @gonzih/cc-tg
- *
- * Required env:
- *   TELEGRAM_BOT_TOKEN   — from @BotFather
- *   CLAUDE_CODE_TOKEN    — your Claude Code OAuth token (or ANTHROPIC_API_KEY)
- *
- * Optional env:
- *   ALLOWED_USER_IDS     — comma-separated Telegram user IDs (leave empty to allow all)
- *   GROUP_CHAT_IDS       — comma-separated Telegram group/supergroup chat IDs (leave empty to allow all groups)
- *   CWD                  — working directory for Claude Code (default: process.cwd())
- */
-export {};

package/dist/index.js

@@ -1,123 +0,0 @@
-#!/usr/bin/env node
-/**
- * cc-tg — Claude Code Telegram bot
- *
- * Usage:
- *   npx @gonzih/cc-tg
- *
- * Required env:
- *   TELEGRAM_BOT_TOKEN   — from @BotFather
- *   CLAUDE_CODE_TOKEN    — your Claude Code OAuth token (or ANTHROPIC_API_KEY)
- *
- * Optional env:
- *   ALLOWED_USER_IDS     — comma-separated Telegram user IDs (leave empty to allow all)
- *   GROUP_CHAT_IDS       — comma-separated Telegram group/supergroup chat IDs (leave empty to allow all groups)
- *   CWD                  — working directory for Claude Code (default: process.cwd())
- */
-import { createServer, createConnection } from "net";
-import { unlinkSync } from "fs";
-import { tmpdir } from "os";
-import { join } from "path";
-import { createHash } from "crypto";
-import { CcTgBot } from "./bot.js";
-// Derive socket path from token hash so multiple instances (feral/law/simorgh)
-// never collide, and the path is stable across restarts on the same machine.
-function lockSocketPath(token) {
-    const hash = createHash("sha256").update(token).digest("hex").slice(0, 12);
-    return join(tmpdir(), `cc-tg-${hash}.sock`);
-}
-function acquireLock(socketPath) {
-    return new Promise((resolve) => {
-        const server = createServer();
-        server.listen(socketPath, () => {
-            // Bound successfully — we own the lock. Socket auto-released on any exit incl. SIGKILL.
-            resolve(true);
-        });
-        server.on("error", (err) => {
-            if (err.code !== "EADDRINUSE") {
-                resolve(true); // unrelated error, proceed
-                return;
-            }
-            // Socket path exists — probe if anything is actually listening
-            const probe = createConnection(socketPath);
-            probe.on("connect", () => {
-                probe.destroy();
-                console.error("[cc-tg] Another instance is already running. Exiting.");
-                resolve(false);
-            });
-            probe.on("error", () => {
-                // Nothing listening — stale socket, remove and retry
-                try {
-                    unlinkSync(socketPath);
-                }
-                catch { }
-                const retry = createServer();
-                retry.listen(socketPath, () => resolve(true));
-                retry.on("error", () => resolve(true)); // give up on lock, just start
-            });
-        });
-    });
-}
-function required(name) {
-    const val = process.env[name];
-    if (!val) {
-        console.error(`
-ERROR: ${name} is not set.
-
-cc-tg requires:
-  TELEGRAM_BOT_TOKEN   — get one from @BotFather on Telegram
-  CLAUDE_CODE_TOKEN    — your Claude Code OAuth token
-
-Set them and run again:
-  TELEGRAM_BOT_TOKEN=xxx CLAUDE_CODE_TOKEN=yyy npx @gonzih/cc-tg
-
-Or add to your shell profile / .env file.
-`);
-        process.exit(1);
-    }
-    return val;
-}
-const telegramToken = required("TELEGRAM_BOT_TOKEN");
-// Acquire lock before doing anything else. Socket derived from token hash so
-// multiple instances (different bots / users) never share the same socket.
-const LOCK_SOCKET = lockSocketPath(telegramToken);
-const lockAcquired = await acquireLock(LOCK_SOCKET);
-if (!lockAcquired) {
-    process.exit(1);
-}
-// Accept CLAUDE_CODE_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, or ANTHROPIC_API_KEY
-const claudeToken = process.env.CLAUDE_CODE_TOKEN ??
-    process.env.CLAUDE_CODE_OAUTH_TOKEN ??
-    process.env.ANTHROPIC_API_KEY;
-if (!claudeToken) {
-    console.error(`
-ERROR: No Claude token set. Set one of: CLAUDE_CODE_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, or ANTHROPIC_API_KEY.
-
-Set one and run again:
-  TELEGRAM_BOT_TOKEN=xxx CLAUDE_CODE_TOKEN=yyy npx @gonzih/cc-tg
-`);
-    process.exit(1);
-}
-const allowedUserIds = process.env.ALLOWED_USER_IDS
-    ? process.env.ALLOWED_USER_IDS.split(",").map((s) => parseInt(s.trim(), 10)).filter(Boolean)
-    : [];
-const groupChatIds = process.env.GROUP_CHAT_IDS
-    ? process.env.GROUP_CHAT_IDS.split(",").map((s) => parseInt(s.trim(), 10)).filter(Boolean)
-    : [];
-const cwd = process.env.CWD ?? process.cwd();
-const bot = new CcTgBot({
-    telegramToken,
-    claudeToken,
-    cwd,
-    allowedUserIds,
-    groupChatIds,
-});
-process.on("SIGINT", () => {
-    console.log("\nShutting down...");
-    bot.stop();
-    process.exit(0);
-});
-process.on("SIGTERM", () => {
-    bot.stop();
-    process.exit(0);
-});

package/dist/usage-limit.d.ts

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