@gonzih/cc-tg 0.6.5 → 0.6.6

package/dist/cc-agent-events.d.ts

@@ -1,98 +0,0 @@
-/**
- * cc-agent Redis event subscriber.
- *
- * Listens to the `cca:events` pub/sub channel for job completion events,
- * asks Claude to decide what to do, and acts accordingly:
- *   NOTIFY_ONLY    — send a Telegram message to the configured chat
- *   SPAWN_FOLLOWUP — spawn a follow-up cc-agent job via MCP + notify Telegram
- *   SILENT         — log and do nothing
- *
- * Controlled via CC_AGENT_EVENTS_ENABLED env var (default: true).
- * Requires CC_AGENT_NOTIFY_CHAT_ID to send Telegram notifications.
- */
-import { Redis } from "ioredis";
-export interface JobEvent {
-    jobId: string;
-    status: "done" | "failed" | "interrupted" | "running" | "cancelled";
-    title: string;
-    repoUrl: string;
-    lastLines: string[];
-    score?: number;
-    timestamp: number;
-}
-export interface CoordinatorPlan {
-    nextStep?: {
-        repo_url: string;
-        task: string;
-    };
-    summary: string;
-}
-export interface DecisionResult {
-    action: "NOTIFY_ONLY" | "SPAWN_FOLLOWUP" | "SILENT";
-    message?: string;
-    followup?: {
-        repo_url: string;
-        task: string;
-    };
-}
-/** Injectable dependencies for testability */
-export interface HandlerDeps {
-    askClaude: (prompt: string) => Promise<string>;
-    sendTelegramMessage: (chatId: number, text: string) => Promise<void>;
-    spawnFollowupAgent: (repoUrl: string, task: string) => Promise<void>;
-    readJobOutput: (jobId: string) => Promise<string[]>;
-    readCoordinatorPlan: (jobId: string) => Promise<CoordinatorPlan | null>;
-    getRunningJobCount: () => Promise<number>;
-    getActiveChatIds: () => Promise<number[]>;
-}
-export declare function buildDecisionPrompt(event: JobEvent, last40lines: string[], coordinatorPlan: CoordinatorPlan | null): string;
-export declare function parseDecision(raw: string): DecisionResult;
-/**
- * Ask Claude to make a decision about a completed job.
- * Returns the raw text response from Claude.
- */
-export declare function defaultAskClaude(prompt: string): Promise<string>;
-export declare function defaultSendTelegramMessage(chatId: number, text: string): Promise<void>;
-export declare function defaultSpawnFollowupAgent(repoUrl: string, task: string): Promise<void>;
-export declare function defaultReadJobOutput(jobId: string): Promise<string[]>;
-export declare function defaultReadCoordinatorPlan(jobId: string): Promise<CoordinatorPlan | null>;
-export declare function defaultGetRunningJobCount(): Promise<number>;
-/**
- * Returns chat IDs to notify about job events.
- * Reads unique chatIds from the cron jobs file (same users who set up cron jobs).
- * Falls back to CC_AGENT_NOTIFY_CHAT_ID env var for backward compatibility.
- */
-export declare function defaultGetActiveChatIds(): Promise<number[]>;
-/**
- * Write a coordinator plan for a job, so cc-tg knows what follow-up to spawn.
- * Call this when spawning a job that has a planned follow-up.
- * TTL: 7 days.
- */
-export declare function writeCoordinatorPlan(jobId: string, plan: {
-    nextStep?: {
-        repo_url: string;
-        task: string;
-    };
-    summary: string;
-}): Promise<void>;
-/**
- * Handle a single job event message from Redis pub/sub.
- * Exported for testability — production code passes defaultDeps.
- */
-export declare function handleJobEvent(message: string, deps: HandlerDeps): Promise<void>;
-/** Parse flat key-value field array from a Redis Stream entry into a record. */
-export declare function parseStreamFields(fields: string[]): Record<string, string>;
-/** Convert stream entry fields to a JobEvent JSON string for handleJobEvent. */
-export declare function streamEntryToMessage(fields: Record<string, string>): string | null;
-/**
- * Replay events from the Redis Stream that were missed since last-seen ID.
- * Uses `cca:event-stream:last-id:{botName}` in Redis to track position.
- * Exported for testability — pass a real or mock Redis instance.
- */
-export declare function replayStreamEvents(redis: Redis, deps: HandlerDeps, botName?: string): Promise<void>;
-/**
- * Connect to Redis and subscribe to cca:events.
- * Reconnects automatically on disconnect.
- * Call once at startup.
- */
-export declare function connectEventSubscriber(): Promise<void>;