@herdctl/discord 0.2.2 → 1.0.0

package/dist/manager.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Discord Manager Module
+ *
+ * Manages Discord connectors for agents that have `chat.discord` configured.
+ * This module is responsible for:
+ * - Creating one DiscordConnector instance per Discord-enabled agent
+ * - Managing connector lifecycle (start/stop)
+ * - Providing access to connectors for status queries
+ *
+ * @module manager
+ */
+import type { FleetManagerContext, IChatManager, ChatManagerConnectorState } from "@herdctl/core";
+import { DiscordConnector } from "./discord-connector.js";
+/**
+ * DiscordManager handles Discord connections for agents
+ *
+ * This class encapsulates the creation and lifecycle management of
+ * DiscordConnector instances for agents that have Discord chat configured.
+ *
+ * Implements IChatManager so FleetManager can interact with it through
+ * the generic chat manager interface.
+ */
+export declare class DiscordManager implements IChatManager {
+    private ctx;
+    private connectors;
+    private initialized;
+    constructor(ctx: FleetManagerContext);
+    /**
+     * Initialize Discord connectors for all configured agents
+     *
+     * This method:
+     * 1. Iterates through agents to find those with Discord configured
+     * 2. Creates a DiscordConnector for each Discord-enabled agent
+     *
+     * Should be called during FleetManager initialization.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect all Discord connectors
+     *
+     * Connects each connector to the Discord gateway and subscribes to events.
+     * Errors are logged but don't stop other connectors from connecting.
+     */
+    start(): Promise<void>;
+    /**
+     * Disconnect all Discord connectors gracefully
+     *
+     * Sessions are automatically persisted to disk on every update,
+     * so they survive bot restarts. This method logs session state
+     * before disconnecting for monitoring purposes.
+     *
+     * Errors are logged but don't prevent other connectors from disconnecting.
+     */
+    stop(): Promise<void>;
+    /**
+     * Get a connector for a specific agent
+     *
+     * @param agentName - Name of the agent
+     * @returns The DiscordConnector instance, or undefined if not found
+     */
+    getConnector(agentName: string): DiscordConnector | undefined;
+    /**
+     * Get all connector names
+     *
+     * @returns Array of agent names that have Discord connectors
+     */
+    getConnectorNames(): string[];
+    /**
+     * Get the number of active connectors
+     *
+     * @returns Number of connectors that are currently connected
+     */
+    getConnectedCount(): number;
+    /**
+     * Check if the manager has been initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if a specific agent has a Discord connector
+     *
+     * @param agentName - Name of the agent
+     * @returns true if the agent has a Discord connector
+     */
+    hasConnector(agentName: string): boolean;
+    /**
+     * Check if a specific agent has a connector (alias for hasConnector)
+     *
+     * @param agentName - Name of the agent
+     * @returns true if the agent has a connector
+     */
+    hasAgent(agentName: string): boolean;
+    /**
+     * Get the state of a connector for a specific agent
+     *
+     * @param agentName - Name of the agent
+     * @returns The connector state, or undefined if not found
+     */
+    getState(agentName: string): ChatManagerConnectorState | undefined;
+    /**
+     * Handle an incoming Discord message
+     *
+     * This method:
+     * 1. Gets or creates a session for the channel
+     * 2. Builds job context from the message
+     * 3. Executes the job via trigger
+     * 4. Sends the response back to Discord
+     *
+     * @param agentName - Name of the agent handling the message
+     * @param event - The Discord message event
+     */
+    private handleMessage;
+    /** Maximum characters for tool output in Discord embed fields */
+    private static readonly TOOL_OUTPUT_MAX_CHARS;
+    /** Embed colors */
+    private static readonly EMBED_COLOR_DEFAULT;
+    private static readonly EMBED_COLOR_ERROR;
+    private static readonly EMBED_COLOR_SYSTEM;
+    private static readonly EMBED_COLOR_SUCCESS;
+    /** Tool title emojis */
+    private static readonly TOOL_EMOJIS;
+    /**
+     * Extract tool_use blocks from an assistant message's content blocks
+     *
+     * Returns id, name, and input for each tool_use block so we can
+     * track pending calls and pair them with results.
+     */
+    private extractToolUseBlocks;
+    /**
+     * Get a human-readable summary of tool input
+     */
+    private getToolInputSummary;
+    /**
+     * Extract tool results from a user message
+     *
+     * Returns output, error status, and the tool_use_id for matching
+     * to the pending tool_use that produced this result.
+     */
+    private extractToolResults;
+    /**
+     * Extract content from a top-level tool_use_result value
+     */
+    private extractToolResultContent;
+    /**
+     * Format duration in milliseconds to a human-readable string
+     */
+    private static formatDuration;
+    /**
+     * Build a Discord embed for a tool call result
+     *
+     * Combines the tool_use info (name, input) with the tool_result
+     * (output, error status) into a compact Discord embed.
+     *
+     * @param toolUse - The tool_use block info (name, input, startTime)
+     * @param toolResult - The tool result (output, isError)
+     * @param maxOutputChars - Maximum characters for output (defaults to TOOL_OUTPUT_MAX_CHARS)
+     */
+    private buildToolEmbed;
+    /**
+     * Handle errors from Discord connectors
+     *
+     * Logs errors without crashing the connector
+     *
+     * @param agentName - Name of the agent that encountered the error
+     * @param error - The error that occurred
+     */
+    private handleError;
+    /** Discord's maximum message length */
+    private static readonly MAX_MESSAGE_LENGTH;
+    /**
+     * Format an error message for Discord display
+     *
+     * Creates a user-friendly error message with guidance on how to proceed.
+     *
+     * @param error - The error that occurred
+     * @returns Formatted error message string
+     */
+    formatErrorMessage(error: Error): string;
+    /**
+     * Split a response into chunks that fit Discord's 2000 character limit
+     *
+     * Uses the shared splitMessage utility from @herdctl/chat.
+     *
+     * @param text - The text to split
+     * @returns Array of text chunks, each under 2000 characters
+     */
+    splitResponse(text: string): string[];
+    /**
+     * Send a response to Discord, splitting if necessary
+     *
+     * @param reply - The reply function from the message event
+     * @param content - The content to send
+     */
+    sendResponse(reply: (content: string) => Promise<void>, content: string): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EAI1B,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAuB1D;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,YAAY;IAIrC,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,WAAW,CAAkB;gBAEjB,GAAG,EAAE,mBAAmB;IAE5C;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0FjC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC5B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC3B;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7D;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAM3B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAoBlE;;;;;;;;;;;OAWG;YACW,aAAa;IAoT3B,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IAEpD,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAY;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAY;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAY;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAY;IAEvD,wBAAwB;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAUjC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgE1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAgEtB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAmBnB,uCAAuC;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAElD;;;;;;;OAOG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIxC;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAKrC;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACzC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;CAOjB"}