ralph-cli-sandboxed 0.4.0 → 0.4.2

package/dist/providers/slack.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Slack chat client implementation.
+ * Uses @slack/bolt for WebSocket-based real-time messaging via Socket Mode.
+ *
+ * Required packages (must be installed separately):
+ *   npm install @slack/bolt @slack/web-api
+ */
+import { ChatClient, ChatCommandHandler, ChatMessage, ChatMessageHandler, SlackSettings, SendMessageOptions } from "../utils/chat-client.js";
+import { ResponderMatch } from "../utils/responder.js";
+/**
+ * Callback for handling responder matches.
+ * Returns the response text to send back to the channel.
+ */
+export type ResponderHandler = (match: ResponderMatch, message: ChatMessage) => Promise<string | null>;
+export declare class SlackChatClient implements ChatClient {
+    readonly provider: "slack";
+    private settings;
+    private connected;
+    private debug;
+    private app;
+    private webClient;
+    private onCommand;
+    private onMessage;
+    private responderMatcher;
+    private respondersConfig;
+    private botUserId;
+    private threadConversations;
+    constructor(settings: SlackSettings, debug?: boolean);
+    /**
+     * Initialize responder matching from config.
+     */
+    private initializeResponders;
+    /**
+     * Fetch thread context (previous messages in the thread).
+     * Returns formatted context string or empty string if not in a thread.
+     */
+    private fetchThreadContext;
+    /**
+     * Execute a responder and return the result.
+     */
+    private executeResponder;
+    /**
+     * Handle a message that might match a responder or continue an existing thread conversation.
+     * Returns true if a responder was matched and executed.
+     */
+    private handleResponderMessage;
+    /**
+     * Continue an existing thread conversation with the LLM.
+     */
+    private continueThreadConversation;
+    /**
+     * Check if a message is mentioning the bot.
+     */
+    private isBotMentioned;
+    /**
+     * Remove bot mention from message text.
+     */
+    private removeBotMention;
+    /**
+     * Check if a channel ID is allowed.
+     */
+    private isChannelAllowed;
+    /**
+     * Convert a Slack message event to our ChatMessage format.
+     */
+    private toMessage;
+    /**
+     * Setup event handlers for the Slack app.
+     */
+    private setupEventHandlers;
+    connect(onCommand: ChatCommandHandler, onMessage?: ChatMessageHandler): Promise<void>;
+    sendMessage(chatId: string, text: string, options?: SendMessageOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+/**
+ * Create a Slack chat client from settings.
+ */
+export declare function createSlackClient(settings: SlackSettings, debug?: boolean): ChatClient;