@herdctl/discord 0.0.1

package/dist/discord-connector.d.ts

@@ -0,0 +1,154 @@
+/**
+ * DiscordConnector - Connects an agent to Discord
+ *
+ * Each agent has its own DiscordConnector instance with its own bot identity.
+ * The connector uses discord.js v14 to connect to the Discord gateway and
+ * handles connection lifecycle events.
+ */
+import { EventEmitter } from "events";
+import { Client } from "discord.js";
+import type { DiscordConnectorOptions, DiscordConnectorState, IDiscordConnector, DiscordConnectorEventMap, DiscordConnectorEventName } from "./types.js";
+import { type ICommandManager } from "./commands/index.js";
+import type { ISessionManager } from "./session-manager/index.js";
+/**
+ * DiscordConnector class - Connects a single agent to Discord
+ *
+ * Each agent has its own connector instance with:
+ * - Its own discord.js Client
+ * - Its own bot token and identity
+ * - Connection lifecycle management
+ * - Event emission for monitoring
+ *
+ * @example
+ * ```typescript
+ * const connector = new DiscordConnector({
+ *   agentConfig,
+ *   discordConfig: agentConfig.chat.discord,
+ *   botToken: process.env.MY_BOT_TOKEN,
+ *   fleetManager,
+ * });
+ *
+ * await connector.connect();
+ * console.log(`Connected as ${connector.getState().botUser?.username}`);
+ *
+ * // Later...
+ * await connector.disconnect();
+ * ```
+ */
+export declare class DiscordConnector extends EventEmitter implements IDiscordConnector {
+    private readonly _agentConfig;
+    private readonly _discordConfig;
+    private readonly _botToken;
+    private readonly _fleetManager;
+    private readonly _logger;
+    private readonly _sessionManager;
+    private readonly _errorHandler;
+    private _client;
+    private _commandManager;
+    private _status;
+    private _connectedAt;
+    private _disconnectedAt;
+    private _reconnectAttempts;
+    private _lastError;
+    private _botUser;
+    private _rateLimitCount;
+    private _lastRateLimitAt;
+    private _rateLimitResetTime;
+    private _rateLimitResetTimer;
+    private _messagesReceived;
+    private _messagesSent;
+    private _messagesIgnored;
+    constructor(options: DiscordConnectorOptions);
+    /**
+     * Get the session manager instance
+     */
+    get sessionManager(): ISessionManager;
+    /**
+     * Get the command manager instance (available after connect)
+     */
+    get commandManager(): ICommandManager | null;
+    /**
+     * Name of the agent this connector is for
+     */
+    get agentName(): string;
+    /**
+     * Get the discord.js Client instance (for testing)
+     */
+    get client(): Client | null;
+    /**
+     * Connect to Discord gateway
+     *
+     * Creates a new discord.js Client and connects to the gateway.
+     * Registers event handlers for connection lifecycle events.
+     *
+     * @throws AlreadyConnectedError if already connected
+     * @throws DiscordConnectionError on connection failure
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Discord gateway
+     *
+     * Performs graceful shutdown by destroying the client.
+     * Does not throw on failure - logs errors and completes.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if currently connected to Discord
+     *
+     * @returns true if connected and ready, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Get current connector state
+     *
+     * @returns Current state including connection status and metadata
+     */
+    getState(): DiscordConnectorState;
+    /**
+     * Set up event handlers for the discord.js client
+     */
+    private _setupEventHandlers;
+    /**
+     * Initialize and register slash commands
+     */
+    private _initializeCommands;
+    /**
+     * Handle an incoming interaction (slash command)
+     */
+    private _handleInteraction;
+    /**
+     * Handle an incoming message
+     *
+     * Determines if the message should be processed based on channel configuration
+     * and mention mode settings. If the message should be processed, builds
+     * conversation context and emits a 'message' event.
+     *
+     * For DMs:
+     * - DMs default to auto mode (no mention required)
+     * - Allowlist/blocklist filtering is applied
+     *
+     * For guild channels:
+     * - Mode is determined by channel configuration
+     * - Only configured channels are processed
+     */
+    private _handleMessage;
+    /**
+     * Set bot presence based on configuration
+     */
+    private _setPresence;
+    /**
+     * Handle rate limit events from discord.js REST client
+     *
+     * Discord.js automatically queues and retries requests when rate limited.
+     * This method tracks rate limit occurrences and emits events for monitoring.
+     */
+    private _handleRateLimit;
+    /**
+     * Type-safe event emitter methods
+     */
+    emit<K extends DiscordConnectorEventName>(event: K, payload: DiscordConnectorEventMap[K]): boolean;
+    on<K extends DiscordConnectorEventName>(event: K, listener: (payload: DiscordConnectorEventMap[K]) => void): this;
+    once<K extends DiscordConnectorEventName>(event: K, listener: (payload: DiscordConnectorEventMap[K]) => void): this;
+    off<K extends DiscordConnectorEventName>(event: K, listener: (payload: DiscordConnectorEventMap[K]) => void): this;
+}
+//# sourceMappingURL=discord-connector.d.ts.map

package/dist/discord-connector.d.ts.map

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