@herdctl/slack 0.0.1 → 0.2.1

package/dist/slack-connector.js

@@ -0,0 +1,447 @@
+/**
+ * Slack Connector
+ *
+ * Single Bolt App instance with channel->agent routing.
+ * Uses Socket Mode for connection (no public URL needed).
+ *
+ * Key design:
+ * - ONE connector shared across all agents (not N connectors)
+ * - Channel->agent routing via channelAgentMap
+ * - Channel-based conversations (channelId as session key, matching Discord)
+ * - Hourglass emoji reaction as typing indicator
+ */
+import { EventEmitter } from "node:events";
+import { shouldProcessMessage, processMessage, isBotMentioned, } from "./message-handler.js";
+import { CommandHandler, helpCommand, resetCommand, statusCommand, } from "./commands/index.js";
+import { markdownToMrkdwn } from "./formatting.js";
+import { AlreadyConnectedError, SlackConnectionError } from "./errors.js";
+import { createDefaultSlackLogger } from "./logger.js";
+// =============================================================================
+// Slack Connector Implementation
+// =============================================================================
+export class SlackConnector extends EventEmitter {
+    botToken;
+    appToken;
+    channelAgentMap;
+    channelConfigs;
+    sessionManagers;
+    logger;
+    // Bolt App instance (dynamically imported)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    app = null;
+    // Command handler for prefix commands (!help, !reset, !status)
+    commandHandler = null;
+    // Connection state
+    status = "disconnected";
+    connectedAt = null;
+    disconnectedAt = null;
+    reconnectAttempts = 0;
+    lastError = null;
+    botUserId = null;
+    botUsername = null;
+    // Message stats
+    messagesReceived = 0;
+    messagesSent = 0;
+    messagesIgnored = 0;
+    constructor(options) {
+        super();
+        this.botToken = options.botToken;
+        this.appToken = options.appToken;
+        this.channelAgentMap = options.channelAgentMap;
+        this.channelConfigs = options.channelConfigs ?? new Map();
+        this.sessionManagers = options.sessionManagers;
+        this.logger = options.logger ?? createDefaultSlackLogger();
+    }
+    // ===========================================================================
+    // ISlackConnector Implementation
+    // ===========================================================================
+    async connect() {
+        if (this.status === "connected" || this.status === "connecting") {
+            throw new AlreadyConnectedError();
+        }
+        this.status = "connecting";
+        this.logger.debug("Connecting to Slack via Socket Mode...");
+        try {
+            // Dynamically import @slack/bolt
+            const { App } = await import("@slack/bolt");
+            this.app = new App({
+                token: this.botToken,
+                appToken: this.appToken,
+                socketMode: true,
+            });
+            // Register event handlers
+            this.registerEventHandlers();
+            // Start the app
+            await this.app.start();
+            // Get bot info
+            const authResult = await this.app.client.auth.test();
+            this.botUserId = authResult.user_id;
+            this.botUsername = authResult.user;
+            // Initialize command handler with built-in commands
+            this.commandHandler = new CommandHandler({ logger: this.logger });
+            this.commandHandler.registerCommand(helpCommand);
+            this.commandHandler.registerCommand(resetCommand);
+            this.commandHandler.registerCommand(statusCommand);
+            this.status = "connected";
+            this.connectedAt = new Date().toISOString();
+            this.disconnectedAt = null;
+            this.reconnectAttempts = 0;
+            this.lastError = null;
+            this.logger.info("Connected to Slack", {
+                botUserId: this.botUserId,
+                botUsername: this.botUsername,
+                channelCount: this.channelAgentMap.size,
+            });
+            this.emit("ready", {
+                botUser: {
+                    id: this.botUserId,
+                    username: this.botUsername ?? "unknown",
+                },
+            });
+            // Clean up expired sessions on startup (matching Discord behavior)
+            for (const [agentName, sessionManager] of this.sessionManagers) {
+                try {
+                    const cleaned = await sessionManager.cleanupExpiredSessions();
+                    if (cleaned > 0) {
+                        this.logger.info(`Cleaned ${cleaned} expired session(s) for agent '${agentName}'`);
+                    }
+                }
+                catch (cleanupError) {
+                    this.logger.warn(`Failed to cleanup sessions for agent '${agentName}'`, {
+                        error: cleanupError instanceof Error ? cleanupError.message : String(cleanupError),
+                    });
+                }
+            }
+        }
+        catch (error) {
+            this.status = "error";
+            this.lastError =
+                error instanceof Error ? error.message : String(error);
+            this.logger.error("Failed to connect to Slack", {
+                error: this.lastError,
+            });
+            throw new SlackConnectionError(`Failed to connect to Slack: ${this.lastError}`, { cause: error instanceof Error ? error : undefined });
+        }
+    }
+    async disconnect() {
+        if (this.status === "disconnected" ||
+            this.status === "disconnecting") {
+            return;
+        }
+        this.status = "disconnecting";
+        this.logger.info("Disconnecting from Slack...");
+        try {
+            if (this.app) {
+                await this.app.stop();
+                this.app = null;
+            }
+            this.commandHandler = null;
+            this.status = "disconnected";
+            this.disconnectedAt = new Date().toISOString();
+            this.logger.info("Disconnected from Slack", {
+                messagesReceived: this.messagesReceived,
+                messagesSent: this.messagesSent,
+                messagesIgnored: this.messagesIgnored,
+            });
+            this.emit("disconnect", { reason: "Intentional disconnect" });
+        }
+        catch (error) {
+            this.status = "error";
+            this.lastError =
+                error instanceof Error ? error.message : String(error);
+            this.logger.error("Error disconnecting from Slack", {
+                error: this.lastError,
+            });
+        }
+    }
+    isConnected() {
+        return this.status === "connected" && this.app !== null;
+    }
+    getState() {
+        return {
+            status: this.status,
+            connectedAt: this.connectedAt,
+            disconnectedAt: this.disconnectedAt,
+            reconnectAttempts: this.reconnectAttempts,
+            lastError: this.lastError,
+            botUser: this.botUserId
+                ? {
+                    id: this.botUserId,
+                    username: this.botUsername ?? "unknown",
+                }
+                : null,
+            messageStats: {
+                received: this.messagesReceived,
+                sent: this.messagesSent,
+                ignored: this.messagesIgnored,
+            },
+        };
+    }
+    // ===========================================================================
+    // File Upload
+    // ===========================================================================
+    async uploadFile(params) {
+        if (!this.app?.client) {
+            throw new Error("Cannot upload file: not connected to Slack");
+        }
+        const response = await this.app.client.files.uploadV2({
+            channel_id: params.channelId,
+            file: params.fileBuffer,
+            filename: params.filename,
+            initial_comment: params.message ?? "",
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const fileId = response.files?.[0]?.id ?? "unknown";
+        this.logger.info("File uploaded to Slack", {
+            fileId,
+            filename: params.filename,
+            channelId: params.channelId,
+            size: params.fileBuffer.length,
+        });
+        return { fileId };
+    }
+    // ===========================================================================
+    // Event Handlers
+    // ===========================================================================
+    registerEventHandlers() {
+        if (!this.app)
+            return;
+        // Handle @mentions
+        this.app.event("app_mention", async ({ event, say }) => {
+            this.messagesReceived++;
+            if (!this.botUserId)
+                return;
+            // Find which agent handles this channel
+            const agentName = this.channelAgentMap.get(event.channel);
+            if (!agentName) {
+                this.messagesIgnored++;
+                this.emit("messageIgnored", {
+                    agentName: "unknown",
+                    reason: "not_configured",
+                    channelId: event.channel,
+                    messageTs: event.ts,
+                });
+                this.logger.debug("Ignoring mention in unconfigured channel", {
+                    channel: event.channel,
+                });
+                return;
+            }
+            const prompt = processMessage(event.text, this.botUserId);
+            if (!prompt) {
+                this.messagesIgnored++;
+                this.emit("messageIgnored", {
+                    agentName,
+                    reason: "empty_prompt",
+                    channelId: event.channel,
+                    messageTs: event.ts,
+                });
+                return;
+            }
+            // Check for prefix commands before processing as a message
+            const wasCommand = await this.tryExecuteCommand(prompt, agentName, event.channel, event.user, say);
+            if (wasCommand)
+                return;
+            const messageEvent = this.buildMessageEvent(agentName, prompt, event.channel, event.ts, event.user, true, say);
+            this.emit("message", messageEvent);
+        });
+        // Handle all messages — thread replies AND top-level channel messages
+        this.app.event("message", async ({ event, say }) => {
+            this.messagesReceived++;
+            if (!this.botUserId)
+                return;
+            // Ignore bot messages and own messages
+            if (!shouldProcessMessage(event, this.botUserId)) {
+                this.messagesIgnored++;
+                this.emit("messageIgnored", {
+                    agentName: "unknown",
+                    reason: "bot_message",
+                    channelId: event.channel,
+                    messageTs: event.ts,
+                });
+                this.logger.debug("Skipping bot/own message", {
+                    channel: event.channel,
+                    botId: event.bot_id,
+                    user: event.user,
+                });
+                return;
+            }
+            // Skip @mentions — handled by the app_mention handler above
+            if (typeof event.text === "string" &&
+                isBotMentioned(event.text, this.botUserId)) {
+                this.logger.debug("Skipping @mention message (handled by app_mention)", {
+                    channel: event.channel,
+                    ts: event.ts,
+                });
+                return;
+            }
+            // Resolve agent for this channel
+            const resolvedAgent = this.channelAgentMap.get(event.channel);
+            if (!resolvedAgent) {
+                this.messagesIgnored++;
+                this.emit("messageIgnored", {
+                    agentName: "unknown",
+                    reason: "no_agent_resolved",
+                    channelId: event.channel,
+                    messageTs: event.ts,
+                });
+                this.logger.debug("No agent resolved for message", {
+                    channel: event.channel,
+                });
+                return;
+            }
+            // For top-level messages (no thread_ts), check channel mode
+            if (!event.thread_ts) {
+                const channelConfig = this.channelConfigs.get(event.channel);
+                const mode = channelConfig?.mode ?? "mention";
+                if (mode === "mention") {
+                    this.messagesIgnored++;
+                    this.emit("messageIgnored", {
+                        agentName: resolvedAgent,
+                        reason: "not_configured",
+                        channelId: event.channel,
+                        messageTs: event.ts,
+                    });
+                    this.logger.debug("Ignoring top-level message in mention-mode channel", {
+                        channel: event.channel,
+                        agent: resolvedAgent,
+                        mode,
+                    });
+                    return;
+                }
+                this.logger.debug("Top-level channel message (auto mode)", {
+                    channel: event.channel,
+                    agent: resolvedAgent,
+                    ts: event.ts,
+                });
+            }
+            const prompt = processMessage(event.text ?? "", this.botUserId);
+            if (!prompt) {
+                this.messagesIgnored++;
+                this.emit("messageIgnored", {
+                    agentName: resolvedAgent,
+                    reason: "empty_prompt",
+                    channelId: event.channel,
+                    messageTs: event.ts,
+                });
+                return;
+            }
+            // Check for prefix commands before processing as a message
+            const wasCommand = await this.tryExecuteCommand(prompt, resolvedAgent, event.channel, event.user ?? "", say);
+            if (wasCommand)
+                return;
+            const messageEvent = this.buildMessageEvent(resolvedAgent, prompt, event.channel, event.ts, event.user ?? "", false, say);
+            this.emit("message", messageEvent);
+        });
+    }
+    // ===========================================================================
+    // Command Handling
+    // ===========================================================================
+    /**
+     * Try to execute a prefix command. Returns true if a command was handled.
+     */
+    async tryExecuteCommand(prompt, agentName, channelId, userId, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    say) {
+        if (!this.commandHandler || !this.commandHandler.isCommand(prompt)) {
+            return false;
+        }
+        const sessionManager = this.sessionManagers.get(agentName);
+        if (!sessionManager) {
+            return false;
+        }
+        const executed = await this.commandHandler.executeCommand(prompt, {
+            agentName,
+            channelId,
+            userId,
+            reply: async (content) => {
+                await say({ text: content });
+            },
+            sessionManager,
+            connectorState: this.getState(),
+        });
+        if (executed) {
+            const commandName = prompt.trim().slice(1).split(/\s+/)[0];
+            this.logger.info("Command executed", {
+                command: commandName,
+                agentName,
+                channelId,
+            });
+            this.emit("commandExecuted", {
+                agentName,
+                commandName,
+                userId,
+                channelId,
+            });
+        }
+        return executed;
+    }
+    // ===========================================================================
+    // Message Building
+    // ===========================================================================
+    buildMessageEvent(agentName, prompt, channelId, messageTs, userId, wasMentioned, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    say) {
+        const reply = async (content) => {
+            await say({
+                text: markdownToMrkdwn(content),
+            });
+            this.messagesSent++;
+        };
+        const startProcessingIndicator = () => {
+            // Add hourglass reaction while processing
+            if (this.app?.client) {
+                this.app.client.reactions
+                    .add({
+                    channel: channelId,
+                    name: "hourglass_flowing_sand",
+                    timestamp: messageTs,
+                })
+                    .catch(() => {
+                    // Ignore reaction errors — not critical
+                });
+            }
+            return () => {
+                // Remove hourglass reaction when done
+                if (this.app?.client) {
+                    this.app.client.reactions
+                        .remove({
+                        channel: channelId,
+                        name: "hourglass_flowing_sand",
+                        timestamp: messageTs,
+                    })
+                        .catch(() => {
+                        // Ignore reaction errors — not critical
+                    });
+                }
+            };
+        };
+        return {
+            agentName,
+            prompt,
+            metadata: {
+                channelId,
+                messageTs,
+                userId,
+                wasMentioned,
+            },
+            reply,
+            startProcessingIndicator,
+        };
+    }
+    // ===========================================================================
+    // Type-Safe Event Emitter Overrides
+    // ===========================================================================
+    emit(event, payload) {
+        return super.emit(event, payload);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+//# sourceMappingURL=slack-connector.js.map

package/dist/slack-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-connector.js","sourceRoot":"","sources":["../src/slack-connector.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Type definitions for the Slack connector
+ *
+ * Provides interfaces for connector configuration, state tracking,
+ * and event definitions.
+ */
+import type { EventEmitter } from "node:events";
+/**
+ * Slack connector connection status
+ */
+export type SlackConnectionStatus = "disconnected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "error";
+/**
+ * Current state of the Slack connector
+ */
+export interface SlackConnectorState {
+    /** Current connection status */
+    status: SlackConnectionStatus;
+    /** ISO timestamp when the connector connected */
+    connectedAt: string | null;
+    /** ISO timestamp when the connector disconnected */
+    disconnectedAt: string | null;
+    /** Number of reconnect attempts */
+    reconnectAttempts: number;
+    /** Last error message */
+    lastError: string | null;
+    /** Bot user info (only present when connected) */
+    botUser: {
+        id: string;
+        username: string;
+    } | null;
+    /** Message statistics */
+    messageStats: {
+        received: number;
+        sent: number;
+        ignored: number;
+    };
+}
+/**
+ * Options for creating a SlackConnector
+ */
+/**
+ * Per-channel configuration
+ */
+export interface SlackChannelConfig {
+    /** Channel message mode: "mention" = only @mentions, "auto" = all messages */
+    mode: "mention" | "auto";
+    /** Number of context messages (future use) */
+    contextMessages: number;
+}
+/**
+ * Options for creating a SlackConnector
+ */
+export interface SlackConnectorOptions {
+    /** Slack Bot Token (xoxb-...) */
+    botToken: string;
+    /** Slack App Token for Socket Mode (xapp-...) */
+    appToken: string;
+    /** Map of channel ID to agent name for routing */
+    channelAgentMap: Map<string, string>;
+    /** Per-channel configuration (keyed by channel ID) */
+    channelConfigs?: Map<string, SlackChannelConfig>;
+    /** Session managers keyed by agent name */
+    sessionManagers: Map<string, ISlackSessionManager>;
+    /** Logger for connector operations */
+    logger?: SlackConnectorLogger;
+    /** State directory for persistence */
+    stateDir?: string;
+}
+/**
+ * Logger interface for Slack connector operations
+ */
+export interface SlackConnectorLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Message event payload from SlackConnector
+ */
+export interface SlackMessageEvent {
+    /** Name of the agent handling this message */
+    agentName: string;
+    /** The processed prompt text */
+    prompt: string;
+    /** Slack-specific metadata */
+    metadata: {
+        /** Channel ID where the message was sent */
+        channelId: string;
+        /** Message timestamp */
+        messageTs: string;
+        /** User ID who sent the message */
+        userId: string;
+        /** Whether this was triggered by a mention */
+        wasMentioned: boolean;
+    };
+    /** Function to send a reply in the same thread */
+    reply: (content: string) => Promise<void>;
+    /** Add hourglass reaction while processing, returns remove function */
+    startProcessingIndicator: () => () => void;
+}
+/**
+ * Error event payload from SlackConnector
+ */
+export interface SlackErrorEvent {
+    agentName: string;
+    error: Error;
+}
+/**
+ * Interface for the Slack connector
+ */
+/**
+ * Parameters for uploading a file to Slack
+ */
+export interface SlackFileUploadParams {
+    /** Channel ID to upload to */
+    channelId: string;
+    /** File contents */
+    fileBuffer: Buffer;
+    /** Filename for the upload */
+    filename: string;
+    /** Optional message to accompany the file */
+    message?: string;
+}
+export interface ISlackConnector extends EventEmitter {
+    /** Connect to Slack via Socket Mode */
+    connect(): Promise<void>;
+    /** Disconnect from Slack */
+    disconnect(): Promise<void>;
+    /** Check if connected */
+    isConnected(): boolean;
+    /** Get current state */
+    getState(): SlackConnectorState;
+    /** Upload a file to a Slack channel/thread */
+    uploadFile(params: SlackFileUploadParams): Promise<{
+        fileId: string;
+    }>;
+    /** Type-safe event subscription */
+    on<K extends SlackConnectorEventName>(event: K, listener: (payload: SlackConnectorEventMap[K]) => void): this;
+    once<K extends SlackConnectorEventName>(event: K, listener: (payload: SlackConnectorEventMap[K]) => void): this;
+    off<K extends SlackConnectorEventName>(event: K, listener: (payload: SlackConnectorEventMap[K]) => void): this;
+}
+/**
+ * Session manager interface for Slack
+ *
+ * Keyed by channelId (matching Discord's approach).
+ */
+export interface ISlackSessionManager {
+    readonly agentName: string;
+    getOrCreateSession(channelId: string): Promise<{
+        sessionId: string;
+        isNew: boolean;
+    }>;
+    getSession(channelId: string): Promise<{
+        sessionId: string;
+        lastMessageAt: string;
+    } | null>;
+    setSession(channelId: string, sessionId: string): Promise<void>;
+    touchSession(channelId: string): Promise<void>;
+    clearSession(channelId: string): Promise<boolean>;
+    cleanupExpiredSessions(): Promise<number>;
+    getActiveSessionCount(): Promise<number>;
+}
+/**
+ * Strongly-typed event map for SlackConnector
+ *
+ * Uses object syntax matching Discord's DiscordConnectorEventMap pattern.
+ */
+export interface SlackConnectorEventMap {
+    /** Emitted when connection is established and ready */
+    ready: {
+        botUser: {
+            id: string;
+            username: string;
+        };
+    };
+    /** Emitted when connection is lost */
+    disconnect: {
+        reason: string;
+    };
+    /** Emitted on connection error */
+    error: {
+        error: Error;
+    };
+    /** Emitted when a processable message is received */
+    message: SlackMessageEvent;
+    /** Emitted when a message is ignored */
+    messageIgnored: {
+        agentName: string;
+        reason: "not_configured" | "bot_message" | "no_agent_resolved" | "empty_prompt";
+        channelId: string;
+        messageTs: string;
+    };
+    /** Emitted when a prefix command is executed */
+    commandExecuted: {
+        agentName: string;
+        commandName: string;
+        userId: string;
+        channelId: string;
+    };
+    /** Emitted when a session is created, resumed, expired, or cleared */
+    sessionLifecycle: {
+        agentName: string;
+        event: "created" | "resumed" | "expired" | "cleared";
+        channelId: string;
+        sessionId: string;
+    };
+}
+export type SlackConnectorEventName = keyof SlackConnectorEventMap;
+export type SlackConnectorEventPayload<E extends SlackConnectorEventName> = SlackConnectorEventMap[E];
+//# sourceMappingURL=types.d.ts.map