@gonzih/cc-tg 0.9.30 → 0.9.31

package/dist/claude.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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

@@ -0,0 +1,208 @@
+/**
+ * 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

@@ -0,0 +1,39 @@
+/**
+ * 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;
+}
+/** Called when a job fires. `done` must be called when the task completes so
+ *  the next scheduled tick is allowed to run. Until `done` is called, concurrent
+ *  ticks for the same job are silently skipped (prevents the resume-loop explosion
+ *  where each tick spawns more agents than the last). */
+type FireCallback = (chatId: number, prompt: string, jobId: string, done: () => void) => void;
+export declare class CronManager {
+    private jobs;
+    /** Job IDs whose fire callback has been invoked but whose `done` hasn't fired yet. */
+    private activeJobs;
+    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

@@ -0,0 +1,148 @@
+/**
+ * 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();
+    /** Job IDs whose fire callback has been invoked but whose `done` hasn't fired yet. */
+    activeJobs = new Set();
+    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(() => {
+            if (this.activeJobs.has(id)) {
+                console.log(`[cron:${id}] skipping tick — previous task still running`);
+                return;
+            }
+            this.activeJobs.add(id);
+            console.log(`[cron:${id}] firing for chat=${chatId} prompt="${prompt}"`);
+            this.fire(chatId, prompt, id, () => { this.activeJobs.delete(id); });
+        }, 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.activeJobs.delete(id);
+        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.activeJobs.delete(id);
+                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);
+        // Also clear any active-job lock so the updated timer can fire immediately next tick
+        this.activeJobs.delete(job.id);
+        job.timer = setInterval(() => {
+            if (this.activeJobs.has(job.id)) {
+                console.log(`[cron:${job.id}] skipping tick — previous task still running`);
+                return;
+            }
+            this.activeJobs.add(job.id);
+            console.log(`[cron:${job.id}] firing for chat=${job.chatId} prompt="${job.prompt}"`);
+            this.fire(job.chatId, job.prompt, job.id, () => { this.activeJobs.delete(job.id); });
+        }, 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(() => {
+                    if (this.activeJobs.has(job.id)) {
+                        console.log(`[cron:${job.id}] skipping tick — previous task still running`);
+                        return;
+                    }
+                    this.activeJobs.add(job.id);
+                    console.log(`[cron:${job.id}] firing for chat=${job.chatId} prompt="${job.prompt}"`);
+                    this.fire(job.chatId, job.prompt, job.id, () => { this.activeJobs.delete(job.id); });
+                }, 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

@@ -0,0 +1,25 @@
+/**
+ * Telegram HTML post-processor.
+ * Converts standard markdown to Telegram's HTML parse mode format.
+ */
+/**
+ * Convert standard markdown text to Telegram HTML format.
+ *
+ * Processing order:
+ * 1. Extract fenced code blocks (``` ... ```) → <pre>, protect from further processing
+ * 2. Extract inline code (`...`) → <code>, protect from further processing
+ * 3. HTML-escape remaining text: & → &amp;  < → &lt;  > → &gt;
+ * 4. Convert --- → blank line
+ * 5. Convert ## headings → <b>Heading</b>
+ * 6. Convert **bold** → <b>bold</b>
+ * 7. Convert - item / * item → • item
+ * 8. Convert *bold* → <b>bold</b>
+ * 9. Convert _italic_ → <i>italic</i>
+ * 10. Reinsert code blocks
+ */
+export declare function formatForTelegram(text: string): string;
+/**
+ * Split a long message at natural boundaries (paragraph > line > word).
+ * Never splits mid-word or inside <pre> blocks. Chunks are at most maxLen characters.
+ */
+export declare function splitLongMessage(text: string, maxLen?: number): string[];

package/dist/formatter.js

@@ -0,0 +1,122 @@
+/**
+ * Telegram HTML post-processor.
+ * Converts standard markdown to Telegram's HTML parse mode format.
+ */
+function htmlEscape(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+/**
+ * Convert standard markdown text to Telegram HTML format.
+ *
+ * Processing order:
+ * 1. Extract fenced code blocks (``` ... ```) → <pre>, protect from further processing
+ * 2. Extract inline code (`...`) → <code>, protect from further processing
+ * 3. HTML-escape remaining text: & → &amp;  < → &lt;  > → &gt;
+ * 4. Convert --- → blank line
+ * 5. Convert ## headings → <b>Heading</b>
+ * 6. Convert **bold** → <b>bold</b>
+ * 7. Convert - item / * item → • item
+ * 8. Convert *bold* → <b>bold</b>
+ * 9. Convert _italic_ → <i>italic</i>
+ * 10. Reinsert code blocks
+ */
+export function formatForTelegram(text) {
+    const placeholders = [];
+    // Step 1: Extract fenced code blocks (``` ... ```) → <pre>
+    let out = text.replace(/```(?:\w*)\n?([\s\S]*?)```/g, (_, content) => {
+        placeholders.push(`<pre>${htmlEscape(content)}</pre>`);
+        return `\x00P${placeholders.length - 1}\x00`;
+    });
+    // Step 2: Extract inline code (`...`) → <code>
+    out = out.replace(/`([^`\n]+)`/g, (_, content) => {
+        placeholders.push(`<code>${htmlEscape(content)}</code>`);
+        return `\x00P${placeholders.length - 1}\x00`;
+    });
+    // Step 3: HTML-escape remaining text
+    out = htmlEscape(out);
+    // Step 4: Convert --- → blank line
+    out = out.replace(/^-{3,}$/gm, "");
+    // Step 5: Convert ## headings → <b>Heading</b>
+    out = out.replace(/^#{1,6}\s+(.+)$/gm, "<b>$1</b>");
+    // Step 6: Convert **bold** → <b>bold</b>
+    out = out.replace(/\*\*(.+?)\*\*/gs, "<b>$1</b>");
+    // Step 7: Convert - item / * item → • item
+    out = out.replace(/^[ \t]*[-*]\s+(.+)$/gm, "• $1");
+    // Step 8: Convert *bold* → <b>bold</b> (single asterisk, after bullets handled)
+    out = out.replace(/\*([^*\n]+)\*/g, "<b>$1</b>");
+    // Step 9: Convert _italic_ → <i>italic</i>
+    // Use word-boundary guards to avoid mangling snake_case identifiers
+    out = out.replace(/(?<![a-zA-Z0-9])_([^_\n]+?)_(?![a-zA-Z0-9])/g, "<i>$1</i>");
+    // Step 10: Reinsert code blocks
+    out = out.replace(/\x00P(\d+)\x00/g, (_, i) => placeholders[parseInt(i, 10)]);
+    return out;
+}
+function findPreRanges(text) {
+    const ranges = [];
+    const open = "<pre>";
+    const close = "</pre>";
+    let i = 0;
+    while (i < text.length) {
+        const start = text.indexOf(open, i);
+        if (start === -1)
+            break;
+        const end = text.indexOf(close, start);
+        if (end === -1)
+            break;
+        ranges.push([start, end + close.length]);
+        i = end + close.length;
+    }
+    return ranges;
+}
+function isInsidePre(pos, ranges) {
+    return ranges.some(([start, end]) => pos > start && pos < end);
+}
+/**
+ * Split a long message at natural boundaries (paragraph > line > word).
+ * Never splits mid-word or inside <pre> blocks. 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);
+        const preRanges = findPreRanges(remaining);
+        // 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 && !isInsidePre(lastPara, preRanges)) {
+            splitAt = lastPara + 2;
+        }
+        else if (lastLine > 0 && !isInsidePre(lastLine, preRanges)) {
+            splitAt = lastLine + 1;
+        }
+        else if (lastSpace > 0 && !isInsidePre(lastSpace, preRanges)) {
+            splitAt = lastSpace + 1;
+        }
+        else {
+            // If all candidate split points are inside a <pre> block, split after it
+            const coveringPre = preRanges.find(([start, end]) => start < maxLen && end > maxLen);
+            if (coveringPre) {
+                splitAt = coveringPre[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

@@ -0,0 +1,17 @@
+#!/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 {};