@herdctl/slack 0.0.1 → 0.2.0

package/dist/commands/command-handler.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Command handler for Slack message prefix commands
+ *
+ * Handles !command style messages for MVP simplicity
+ * (vs Slack slash commands which require URL verification).
+ */
+import type { SlackConnectorLogger, ISlackSessionManager } from "../types.js";
+import type { SlackConnectorState } from "../types.js";
+/**
+ * Context passed to command handlers
+ */
+export interface CommandContext {
+    /** Name of the agent handling this command */
+    agentName: string;
+    /** Channel ID */
+    channelId: string;
+    /** User who sent the command */
+    userId: string;
+    /** Function to reply in the channel */
+    reply: (content: string) => Promise<void>;
+    /** Session manager for the agent */
+    sessionManager: ISlackSessionManager;
+    /** Current connector state */
+    connectorState: SlackConnectorState;
+}
+/**
+ * A prefix command definition
+ */
+export interface PrefixCommand {
+    /** Command name (without ! prefix) */
+    name: string;
+    /** Description of the command */
+    description: string;
+    /** Execute the command */
+    execute(context: CommandContext): Promise<void>;
+}
+/**
+ * Options for CommandHandler
+ */
+export interface CommandHandlerOptions {
+    /** Logger instance */
+    logger?: SlackConnectorLogger;
+}
+/**
+ * CommandHandler manages message prefix commands for Slack
+ *
+ * Commands are triggered by messages starting with `!` (e.g., `!reset`, `!status`)
+ */
+export declare class CommandHandler {
+    private commands;
+    private readonly logger;
+    constructor(options?: CommandHandlerOptions);
+    /**
+     * Register a command
+     */
+    registerCommand(command: PrefixCommand): void;
+    /**
+     * Check if a message is a command
+     */
+    isCommand(text: string): boolean;
+    /**
+     * Execute a command from message text
+     *
+     * @returns true if a command was executed, false otherwise
+     */
+    executeCommand(text: string, context: CommandContext): Promise<boolean>;
+    /**
+     * Get all registered commands
+     */
+    getCommands(): PrefixCommand[];
+}
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/commands/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/commands/command-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,oCAAoC;IACpC,cAAc,EAAE,oBAAoB,CAAC;IAErC,8BAA8B;IAC9B,cAAc,EAAE,mBAAmB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAMD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,OAAO,GAAE,qBAA0B;IAS/C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI7C;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUhC;;;;OAIG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC;IAsCnB;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;CAG/B"}

package/dist/commands/command-handler.js

@@ -0,0 +1,85 @@
+/**
+ * Command handler for Slack message prefix commands
+ *
+ * Handles !command style messages for MVP simplicity
+ * (vs Slack slash commands which require URL verification).
+ */
+// =============================================================================
+// Command Handler
+// =============================================================================
+/**
+ * CommandHandler manages message prefix commands for Slack
+ *
+ * Commands are triggered by messages starting with `!` (e.g., `!reset`, `!status`)
+ */
+export class CommandHandler {
+    commands = new Map();
+    logger;
+    constructor(options = {}) {
+        this.logger = options.logger ?? {
+            debug: () => { },
+            info: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+    }
+    /**
+     * Register a command
+     */
+    registerCommand(command) {
+        this.commands.set(command.name.toLowerCase(), command);
+    }
+    /**
+     * Check if a message is a command
+     */
+    isCommand(text) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith("!")) {
+            return false;
+        }
+        const commandName = trimmed.slice(1).split(/\s+/)[0].toLowerCase();
+        return this.commands.has(commandName);
+    }
+    /**
+     * Execute a command from message text
+     *
+     * @returns true if a command was executed, false otherwise
+     */
+    async executeCommand(text, context) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith("!")) {
+            return false;
+        }
+        const commandName = trimmed.slice(1).split(/\s+/)[0].toLowerCase();
+        const command = this.commands.get(commandName);
+        if (!command) {
+            return false;
+        }
+        this.logger.info(`Executing command: !${commandName}`, {
+            agentName: context.agentName,
+            channelId: context.channelId,
+        });
+        try {
+            await command.execute(context);
+            return true;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Command !${commandName} failed: ${errorMessage}`);
+            try {
+                await context.reply(`An error occurred while executing \`!${commandName}\`. Please try again.`);
+            }
+            catch {
+                // Ignore reply error
+            }
+            return true; // Command was attempted, even if it failed
+        }
+    }
+    /**
+     * Get all registered commands
+     */
+    getCommands() {
+        return Array.from(this.commands.values());
+    }
+}
+//# sourceMappingURL=command-handler.js.map

package/dist/commands/command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../src/commands/command-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsDH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAC;IACxC,MAAM,CAAuB;IAE9C,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI;YAC9B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAsB;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAClB,IAAY,EACZ,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,WAAW,EAAE,EAAE;YACrD,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,WAAW,YAAY,YAAY,EAAE,CAAC,CAAC;YAErE,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,CACjB,wCAAwC,WAAW,uBAAuB,CAC3E,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;YAED,OAAO,IAAI,CAAC,CAAC,2CAA2C;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/commands/help.d.ts

@@ -0,0 +1,6 @@
+/**
+ * !help command — Show available commands
+ */
+import type { PrefixCommand } from "./command-handler.js";
+export declare const helpCommand: PrefixCommand;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAE1E,eAAO,MAAM,WAAW,EAAE,aAoBzB,CAAC"}

package/dist/commands/help.js

@@ -0,0 +1,22 @@
+/**
+ * !help command — Show available commands
+ */
+export const helpCommand = {
+    name: "help",
+    description: "Show available commands",
+    async execute(context) {
+        const { agentName, reply } = context;
+        const helpMessage = `*${agentName} Bot Commands*
+
+\`!help\` — Show this help message
+\`!status\` — Show agent status and session info
+\`!reset\` — Clear conversation context (start fresh session)
+
+*Interacting with the bot:*
+\u2022 Mention the bot in a configured channel to start a conversation
+\u2022 The bot remembers context within each channel
+\u2022 Use \`!reset\` to clear the conversation and start fresh`;
+        await reply(helpMessage);
+    },
+};
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yBAAyB;IAEtC,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAErC,MAAM,WAAW,GAAG,IAAI,SAAS;;;;;;;;;gEAS2B,CAAC;QAE7D,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Commands module for Slack
+ *
+ * Provides message prefix command handling.
+ */
+export { CommandHandler } from "./command-handler.js";
+export type { CommandContext, PrefixCommand, CommandHandlerOptions, } from "./command-handler.js";
+export { helpCommand } from "./help.js";
+export { resetCommand } from "./reset.js";
+export { statusCommand } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,YAAY,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,10 @@
+/**
+ * Commands module for Slack
+ *
+ * Provides message prefix command handling.
+ */
+export { CommandHandler } from "./command-handler.js";
+export { helpCommand } from "./help.js";
+export { resetCommand } from "./reset.js";
+export { statusCommand } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/commands/reset.d.ts

@@ -0,0 +1,6 @@
+/**
+ * !reset command — Clear session for current channel
+ */
+import type { PrefixCommand } from "./command-handler.js";
+export declare const resetCommand: PrefixCommand;
+//# sourceMappingURL=reset.d.ts.map

package/dist/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAE1E,eAAO,MAAM,YAAY,EAAE,aAiB1B,CAAC"}

package/dist/commands/reset.js

@@ -0,0 +1,18 @@
+/**
+ * !reset command — Clear session for current channel
+ */
+export const resetCommand = {
+    name: "reset",
+    description: "Clear conversation context (start fresh session)",
+    async execute(context) {
+        const { channelId, sessionManager, reply } = context;
+        const cleared = await sessionManager.clearSession(channelId);
+        if (cleared) {
+            await reply("Session cleared. The next message will start a fresh conversation.");
+        }
+        else {
+            await reply("No active session in this channel.");
+        }
+    },
+};
+//# sourceMappingURL=reset.js.map

package/dist/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,kDAAkD;IAE/D,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAErD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,CACT,oEAAoE,CACrE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * !status command — Show agent status and connection info
+ */
+import type { PrefixCommand } from "./command-handler.js";
+export declare const statusCommand: PrefixCommand;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AA6D1E,eAAO,MAAM,aAAa,EAAE,aA4C3B,CAAC"}

package/dist/commands/status.js

@@ -0,0 +1,94 @@
+/**
+ * !status command — Show agent status and connection info
+ */
+/**
+ * Format a timestamp for display
+ */
+function formatTimestamp(isoString) {
+    if (!isoString) {
+        return "N/A";
+    }
+    const date = new Date(isoString);
+    return date.toLocaleString();
+}
+/**
+ * Format duration since a timestamp
+ */
+function formatDuration(isoString) {
+    if (!isoString) {
+        return "N/A";
+    }
+    const startTime = new Date(isoString).getTime();
+    const now = Date.now();
+    const durationMs = now - startTime;
+    const seconds = Math.floor(durationMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days}d ${hours % 24}h`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Get status emoji based on connection status
+ */
+function getStatusEmoji(status) {
+    switch (status) {
+        case "connected":
+            return "\u{1F7E2}"; // Green circle
+        case "connecting":
+        case "reconnecting":
+            return "\u{1F7E1}"; // Yellow circle
+        case "disconnected":
+        case "disconnecting":
+            return "\u26AA"; // White circle
+        case "error":
+            return "\u{1F534}"; // Red circle
+        default:
+            return "\u2753"; // Question mark
+    }
+}
+export const statusCommand = {
+    name: "status",
+    description: "Show agent status and connection info",
+    async execute(context) {
+        const { agentName, channelId, connectorState, sessionManager, reply } = context;
+        // Get session info for this channel
+        const session = await sessionManager.getSession(channelId);
+        // Build status message using Slack mrkdwn
+        const statusEmoji = getStatusEmoji(connectorState.status);
+        const botUsername = connectorState.botUser?.username ?? "Unknown";
+        let statusMessage = `*${agentName} Status*\n\n`;
+        statusMessage += `${statusEmoji} *Connection:* ${connectorState.status}\n`;
+        statusMessage += `*Bot:* ${botUsername}`;
+        if (connectorState.connectedAt) {
+            statusMessage += `\n*Connected:* ${formatTimestamp(connectorState.connectedAt)}`;
+            statusMessage += `\n*Uptime:* ${formatDuration(connectorState.connectedAt)}`;
+        }
+        if (connectorState.reconnectAttempts > 0) {
+            statusMessage += `\n*Reconnect Attempts:* ${connectorState.reconnectAttempts}`;
+        }
+        if (connectorState.lastError) {
+            statusMessage += `\n*Last Error:* ${connectorState.lastError}`;
+        }
+        // Session info
+        statusMessage += `\n\n*Session Info*`;
+        if (session) {
+            statusMessage += `\n*Session ID:* \`${session.sessionId.substring(0, 20)}...\``;
+            statusMessage += `\n*Last Activity:* ${formatTimestamp(session.lastMessageAt)}`;
+            statusMessage += `\n*Session Age:* ${formatDuration(session.lastMessageAt)}`;
+        }
+        else {
+            statusMessage += `\nNo active session in this channel.`;
+        }
+        await reply(statusMessage);
+    },
+};
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/error-handler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Error handling utilities for the Slack connector
+ *
+ * Provides error classification, user-friendly messages,
+ * and retry logic for Slack API operations.
+ */
+import type { SlackConnectorLogger } from "./types.js";
+/**
+ * Error categories for classification
+ */
+export declare enum ErrorCategory {
+    /** Authentication/authorization errors */
+    AUTH = "auth",
+    /** Rate limiting errors */
+    RATE_LIMIT = "rate_limit",
+    /** Network errors */
+    NETWORK = "network",
+    /** Slack API errors */
+    API = "api",
+    /** Internal errors */
+    INTERNAL = "internal",
+    /** Unknown errors */
+    UNKNOWN = "unknown"
+}
+/**
+ * Classified error with category and user-facing message
+ */
+export interface ClassifiedError {
+    category: ErrorCategory;
+    userMessage: string;
+    isRetryable: boolean;
+    originalError: Error;
+}
+/**
+ * User-friendly error messages
+ */
+export declare const USER_ERROR_MESSAGES: Record<string, string>;
+/**
+ * Classify an error for appropriate handling
+ */
+export declare function classifyError(error: Error): ClassifiedError;
+/**
+ * Execute a function safely, catching and logging errors
+ */
+export declare function safeExecute<T>(fn: () => Promise<T>, logger: SlackConnectorLogger, context: string): Promise<T | undefined>;
+/**
+ * Execute a function safely and reply with error message on failure
+ */
+export declare function safeExecuteWithReply(fn: () => Promise<void>, reply: (content: string) => Promise<void>, logger: SlackConnectorLogger, context: string): Promise<void>;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD;;GAEG;AACH,oBAAY,aAAa;IACvB,0CAA0C;IAC1C,IAAI,SAAS;IACb,2BAA2B;IAC3B,UAAU,eAAe;IACzB,qBAAqB;IACrB,OAAO,YAAY;IACnB,uBAAuB;IACvB,GAAG,QAAQ;IACX,sBAAsB;IACtB,QAAQ,aAAa;IACrB,qBAAqB;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAsD3D;AAMD;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACzC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/error-handler.js

@@ -0,0 +1,123 @@
+/**
+ * Error handling utilities for the Slack connector
+ *
+ * Provides error classification, user-friendly messages,
+ * and retry logic for Slack API operations.
+ */
+// =============================================================================
+// Error Classification
+// =============================================================================
+/**
+ * Error categories for classification
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    /** Authentication/authorization errors */
+    ErrorCategory["AUTH"] = "auth";
+    /** Rate limiting errors */
+    ErrorCategory["RATE_LIMIT"] = "rate_limit";
+    /** Network errors */
+    ErrorCategory["NETWORK"] = "network";
+    /** Slack API errors */
+    ErrorCategory["API"] = "api";
+    /** Internal errors */
+    ErrorCategory["INTERNAL"] = "internal";
+    /** Unknown errors */
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * User-friendly error messages
+ */
+export const USER_ERROR_MESSAGES = {
+    auth: "I'm having trouble authenticating with Slack. Please check the bot configuration.",
+    rate_limit: "I'm being rate limited by Slack. Please try again in a moment.",
+    network: "I'm having trouble connecting to Slack. Please try again later.",
+    api: "Something went wrong with the Slack API. Please try again.",
+    internal: "An internal error occurred. Please try again or use `!reset` to start a new session.",
+    unknown: "An unexpected error occurred. Please try again.",
+};
+/**
+ * Classify an error for appropriate handling
+ */
+export function classifyError(error) {
+    const message = error.message.toLowerCase();
+    if (message.includes("invalid_auth") ||
+        message.includes("token_revoked") ||
+        message.includes("token_expired") ||
+        message.includes("not_authed")) {
+        return {
+            category: ErrorCategory.AUTH,
+            userMessage: USER_ERROR_MESSAGES.auth,
+            isRetryable: false,
+            originalError: error,
+        };
+    }
+    if (message.includes("rate_limit") || message.includes("ratelimited")) {
+        return {
+            category: ErrorCategory.RATE_LIMIT,
+            userMessage: USER_ERROR_MESSAGES.rate_limit,
+            isRetryable: true,
+            originalError: error,
+        };
+    }
+    if (message.includes("econnrefused") ||
+        message.includes("enotfound") ||
+        message.includes("timeout")) {
+        return {
+            category: ErrorCategory.NETWORK,
+            userMessage: USER_ERROR_MESSAGES.network,
+            isRetryable: true,
+            originalError: error,
+        };
+    }
+    if (message.includes("slack") || message.includes("api")) {
+        return {
+            category: ErrorCategory.API,
+            userMessage: USER_ERROR_MESSAGES.api,
+            isRetryable: true,
+            originalError: error,
+        };
+    }
+    return {
+        category: ErrorCategory.UNKNOWN,
+        userMessage: USER_ERROR_MESSAGES.unknown,
+        isRetryable: false,
+        originalError: error,
+    };
+}
+// =============================================================================
+// Safe Execution
+// =============================================================================
+/**
+ * Execute a function safely, catching and logging errors
+ */
+export async function safeExecute(fn, logger, context) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Error in ${context}: ${errorMessage}`);
+        return undefined;
+    }
+}
+/**
+ * Execute a function safely and reply with error message on failure
+ */
+export async function safeExecuteWithReply(fn, reply, logger, context) {
+    try {
+        await fn();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const classified = classifyError(err);
+        logger.error(`Error in ${context}: ${err.message}`);
+        try {
+            await reply(classified.userMessage);
+        }
+        catch (replyError) {
+            logger.error(`Failed to send error reply: ${replyError.message}`);
+        }
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Error classes for the Slack connector
+ *
+ * Provides typed errors for Slack connection and message handling failures.
+ */
+/**
+ * Error codes for Slack connector operations
+ */
+export declare enum SlackErrorCode {
+    CONNECTION_FAILED = "SLACK_CONNECTION_FAILED",
+    ALREADY_CONNECTED = "SLACK_ALREADY_CONNECTED",
+    MISSING_TOKEN = "SLACK_MISSING_TOKEN",
+    INVALID_TOKEN = "SLACK_INVALID_TOKEN",
+    MESSAGE_SEND_FAILED = "SLACK_MESSAGE_SEND_FAILED",
+    SOCKET_MODE_ERROR = "SLACK_SOCKET_MODE_ERROR"
+}
+/**
+ * Base error class for Slack connector operations
+ */
+export declare class SlackConnectorError extends Error {
+    readonly code: SlackErrorCode;
+    constructor(message: string, code: SlackErrorCode, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when connection to Slack fails
+ */
+export declare class SlackConnectionError extends SlackConnectorError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when attempting to connect while already connected
+ */
+export declare class AlreadyConnectedError extends SlackConnectorError {
+    constructor();
+}
+/**
+ * Error thrown when bot or app token is missing
+ */
+export declare class MissingTokenError extends SlackConnectorError {
+    readonly tokenType: "bot" | "app";
+    constructor(tokenType: "bot" | "app", envVar: string);
+}
+/**
+ * Error thrown when a token is invalid
+ */
+export declare class InvalidTokenError extends SlackConnectorError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Type guard to check if an error is a SlackConnectorError
+ */
+export declare function isSlackConnectorError(error: unknown): error is SlackConnectorError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,cAAc;IACxB,iBAAiB,4BAA4B;IAC7C,iBAAiB,4BAA4B;IAC7C,aAAa,wBAAwB;IACrC,aAAa,wBAAwB;IACrC,mBAAmB,8BAA8B;IACjD,iBAAiB,4BAA4B;CAC9C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,IAAI,EAAE,cAAc,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAM9B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAIzD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;;CAQ7D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;IACxD,SAAgB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;gBAE7B,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM;CAQrD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAIzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAE9B"}