@herdctl/core 4.0.0 → 4.1.0

package/dist/fleet-manager/slack-manager.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Slack Manager Module
+ *
+ * Manages a single Slack connector shared across agents that have `chat.slack` configured.
+ * This module is responsible for:
+ * - Creating ONE SlackConnector instance for the workspace
+ * - Building channel→agent routing from agent configs
+ * - Managing connector lifecycle (start/stop)
+ *
+ * Key difference from Discord:
+ * - DiscordManager has Map<string, IDiscordConnector> (N connectors, one per agent)
+ * - SlackManager has one connector + Map<string, string> (channel→agent routing)
+ *
+ * Note: This module dynamically imports @herdctl/slack at runtime to avoid
+ * a hard dependency. The @herdctl/core package can be used without Slack support.
+ *
+ * @module slack-manager
+ */
+import type { FleetManagerContext } from "./context.js";
+/**
+ * Slack connection status (mirrors @herdctl/slack types)
+ */
+export type SlackConnectionStatus = "disconnected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "error";
+/**
+ * Slack connector state (mirrors @herdctl/slack types)
+ */
+export interface SlackConnectorState {
+    status: SlackConnectionStatus;
+    connectedAt: string | null;
+    disconnectedAt: string | null;
+    reconnectAttempts: number;
+    lastError: string | null;
+    botUser: {
+        id: string;
+        username: string;
+    } | null;
+    messageStats: {
+        received: number;
+        sent: number;
+        ignored: number;
+    };
+}
+/**
+ * Message event payload from SlackConnector
+ */
+export interface SlackMessageEvent {
+    agentName: string;
+    prompt: string;
+    metadata: {
+        channelId: string;
+        messageTs: string;
+        userId: string;
+        wasMentioned: boolean;
+    };
+    reply: (content: string) => Promise<void>;
+    startProcessingIndicator: () => () => void;
+}
+/**
+ * Error event payload from SlackConnector
+ *
+ * Note: No agentName — the connector is shared across agents.
+ */
+export interface SlackErrorEvent {
+    error: Error;
+}
+/**
+ * Minimal interface for a Slack connector
+ */
+interface ISlackConnector {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getState(): SlackConnectorState;
+    uploadFile(params: {
+        channelId: string;
+        fileBuffer: Buffer;
+        filename: string;
+        message?: string;
+    }): Promise<{
+        fileId: string;
+    }>;
+    on(event: "message", listener: (payload: SlackMessageEvent) => void): this;
+    on(event: "error", listener: (payload: SlackErrorEvent) => void): this;
+    on(event: "ready", listener: (payload: {
+        botUser: {
+            id: string;
+            username: string;
+        };
+    }) => void): this;
+    on(event: "disconnect", listener: (payload: {
+        reason: string;
+    }) => void): this;
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener: (...args: unknown[]) => void): this;
+}
+/**
+ * SlackManager handles Slack connections for agents
+ *
+ * Unlike DiscordManager which creates N connectors (one per agent),
+ * SlackManager creates ONE connector shared across all Slack-enabled agents,
+ * with channel→agent routing.
+ */
+export declare class SlackManager {
+    private ctx;
+    private connector;
+    private sessionManagers;
+    private channelAgentMap;
+    private channelConfigs;
+    private initialized;
+    constructor(ctx: FleetManagerContext);
+    /**
+     * Initialize the Slack connector for all configured agents
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect the Slack connector and subscribe to events
+     */
+    start(): Promise<void>;
+    /**
+     * Disconnect the Slack connector gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the connector (if any)
+     */
+    getConnector(): ISlackConnector | null;
+    /**
+     * Check if the connector is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the state of the connector
+     */
+    getState(): SlackConnectorState | null;
+    /**
+     * Get the channel→agent routing map
+     */
+    getChannelAgentMap(): Map<string, string>;
+    /**
+     * Check if a specific agent has Slack configured
+     */
+    hasAgent(agentName: string): boolean;
+    private handleMessage;
+    /**
+     * Extract text content from an SDK message
+     */
+    private extractMessageContent;
+    /**
+     * Handle errors from the Slack connector
+     */
+    private handleError;
+    private static readonly MAX_MESSAGE_LENGTH;
+    formatErrorMessage(error: Error): string;
+    splitResponse(text: string): string[];
+    private findNaturalBreak;
+}
+export {};
+//# sourceMappingURL=slack-manager.d.ts.map

package/dist/fleet-manager/slack-manager.d.ts.map

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