@gonzih/cc-discord 0.1.0

package/dist/bot.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Discord bot that routes messages to/from a Claude Code subprocess.
+ * One ClaudeProcess per channel (or channel:thread) — sessions are isolated per channel.
+ */
+import { Redis } from "ioredis";
+/** Prepend [MM-DD HH:mm] so Claude knows when the message was received. */
+export declare function stampPrompt(text: string, now?: Date): string;
+export interface DiscordBotOptions {
+    discordToken: string;
+    claudeToken?: string;
+    cwd?: string;
+    allowedUserIds?: string[];
+    redis?: Redis;
+    namespace?: string;
+    guildIds?: string[];
+    /** Called when a message is routed to a non-default namespace so the notifier
+     *  can forward the response back to the originating Discord channel. */
+    registerRoutedChannelId?: (namespace: string, channelId: string) => void;
+}
+/** MCP tool call result — returned from callCcAgentTool */
+export type CallToolFn = (toolName: string, args?: Record<string, unknown>) => Promise<string | null>;
+export declare class CcDiscordBot {
+    private client;
+    private sessions;
+    private costs;
+    private opts;
+    private redis?;
+    private namespace;
+    private lastActiveChannelId?;
+    private cron;
+    /** ClaudeProcess running the MCP tool bridge (for callCcAgentTool) */
+    private mcpSession?;
+    constructor(opts: DiscordBotOptions);
+    /** Reverse-lookup: find the channelId string for a cron-stored integer */
+    private snowflakeMap;
+    private storeSnowflake;
+    private reverseSnowflakeLookup;
+    /** Session key: "channelId" or "channelId:threadId" for threads */
+    private sessionKey;
+    /** Get the channel/thread for sending messages */
+    private getChannel;
+    /** Send text to a channel, splitting at 2000 chars, sending file attachments if detected. */
+    private sendToChannel;
+    /** Send to a channel by ID — used by notifier callbacks. */
+    sendToChannelById(channelId: string, text: string): Promise<void>;
+    private isAllowed;
+    private handleMessage;
+    private handleVoice;
+    private handleImage;
+    private getOrCreateSession;
+    private onClaudeMessage;
+    private flushSession;
+    private startTyping;
+    private killSession;
+    private getCost;
+    private addUsage;
+    private buildCostEmbed;
+    private registerSlashCommands;
+    private handleSlashCommand;
+    private handleCronsCommand;
+    /**
+     * Call a cc-agent MCP tool via a dedicated ClaudeProcess.
+     * Returns the tool result as a string, or null on failure.
+     */
+    callCcAgentTool(toolName: string, args?: Record<string, unknown>): Promise<string | null>;
+    private runCronTask;
+    /** Write a message to the Redis chat log. Fire-and-forget. */
+    private writeChatMessage;
+    /** Returns the last channelId that sent a message. */
+    getLastActiveChannelId(): string | undefined;
+    /**
+     * Feed a text message into the active Claude session for the given channel.
+     * Called by the notifier when a UI message arrives via Redis pub/sub.
+     */
+    handleUserMessage(channelId: string, text: string): Promise<void>;
+    /**
+     * Forward a cc-agent job notification into an existing Claude session.
+     * Unlike handleUserMessage, this never creates a new session.
+     */
+    forwardNotification(channelId: string, text: string): void;
+    stop(): void;
+}