@herdctl/discord 0.0.1

package/dist/auto-mode-handler.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Auto mode handler for Discord DMs and dedicated channels
+ *
+ * Provides utilities for:
+ * - Checking if DMs should be processed (auto mode by default)
+ * - Filtering users via allowlist/blocklist
+ * - Determining channel mode configuration
+ */
+import type { DiscordDM, DiscordChannel, DiscordGuild } from "@herdctl/core";
+/**
+ * Result of checking if a user is allowed to DM the bot
+ */
+export interface DMFilterResult {
+    /** Whether the user is allowed to send DMs */
+    allowed: boolean;
+    /** Reason for filtering decision */
+    reason: "allowed" | "dm_disabled" | "not_in_allowlist" | "in_blocklist";
+}
+/**
+ * Configuration for DM handling
+ */
+export interface DMConfig {
+    /** Whether DMs are enabled */
+    enabled: boolean;
+    /** Mode for DM processing */
+    mode: "mention" | "auto";
+    /** User IDs that are explicitly allowed (if set, only these users can DM) */
+    allowlist?: string[];
+    /** User IDs that are explicitly blocked */
+    blocklist?: string[];
+}
+/**
+ * Result of resolving channel configuration
+ */
+export interface ResolvedChannelConfig {
+    /** The mode for this channel */
+    mode: "mention" | "auto";
+    /** Number of context messages to include */
+    contextMessages: number;
+    /** Whether this is a DM channel */
+    isDM: boolean;
+    /** The guild ID if applicable */
+    guildId: string | null;
+}
+/**
+ * Check if DMs are enabled based on configuration
+ *
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns true if DMs are enabled, false otherwise
+ */
+export declare function isDMEnabled(dmConfig?: DiscordDM): boolean;
+/**
+ * Get the mode for DM processing
+ *
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns The mode for DM processing (defaults to "auto")
+ */
+export declare function getDMMode(dmConfig?: DiscordDM): "mention" | "auto";
+/**
+ * Check if a user is allowed to send DMs to the bot
+ *
+ * Filtering rules:
+ * 1. If DMs are disabled, no users are allowed
+ * 2. If a blocklist is defined and user is on it, they are blocked
+ * 3. If an allowlist is defined, only users on it are allowed
+ * 4. If neither list is defined, all users are allowed
+ *
+ * @param userId - Discord user ID to check
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns Filter result with allowed status and reason
+ *
+ * @example
+ * ```typescript
+ * const result = checkDMUserFilter("123456789", dmConfig);
+ * if (!result.allowed) {
+ *   console.log(`User blocked: ${result.reason}`);
+ * }
+ * ```
+ */
+export declare function checkDMUserFilter(userId: string, dmConfig?: DiscordDM): DMFilterResult;
+/**
+ * Default number of context messages for DMs
+ */
+export declare const DEFAULT_DM_CONTEXT_MESSAGES = 10;
+/**
+ * Default number of context messages for channels
+ */
+export declare const DEFAULT_CHANNEL_CONTEXT_MESSAGES = 10;
+/**
+ * Find channel configuration from guild config
+ *
+ * @param channelId - Discord channel ID
+ * @param guilds - Array of guild configurations
+ * @returns Channel config and guild ID, or null if not found
+ */
+export declare function findChannelConfig(channelId: string, guilds: DiscordGuild[]): {
+    channel: DiscordChannel;
+    guildId: string;
+} | null;
+/**
+ * Resolve channel configuration for a message
+ *
+ * Determines the mode and context settings for a given channel,
+ * handling both guild channels and DMs appropriately.
+ *
+ * @param channelId - Discord channel ID
+ * @param guildId - Guild ID (null for DMs)
+ * @param guilds - Array of guild configurations
+ * @param dmConfig - Global DM configuration
+ * @returns Resolved channel configuration or null if channel not configured
+ *
+ * @example
+ * ```typescript
+ * const config = resolveChannelConfig(
+ *   message.channel.id,
+ *   message.guildId,
+ *   discordConfig.guilds,
+ *   discordConfig.dm
+ * );
+ *
+ * if (config) {
+ *   if (config.mode === 'auto') {
+ *     // Process all non-bot messages
+ *   } else {
+ *     // Only process mentions
+ *   }
+ * }
+ * ```
+ */
+export declare function resolveChannelConfig(channelId: string, guildId: string | null, guilds: DiscordGuild[], dmConfig?: DiscordDM): ResolvedChannelConfig | null;
+/**
+ * Check if a message should be processed in auto mode
+ *
+ * In auto mode:
+ * - All non-bot messages are processed
+ * - No mention is required
+ * - Full conversation context is maintained
+ *
+ * @param isBot - Whether the message author is a bot
+ * @param mode - The channel mode
+ * @param wasMentioned - Whether the bot was mentioned
+ * @returns true if the message should be processed
+ */
+export declare function shouldProcessInMode(isBot: boolean, mode: "mention" | "auto", wasMentioned: boolean): boolean;
+//# sourceMappingURL=auto-mode-handler.d.ts.map

package/dist/auto-mode-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mode-handler.d.ts","sourceRoot":"","sources":["../src/auto-mode-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAM7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,kBAAkB,GAAG,cAAc,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAMlE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,SAAS,GACnB,cAAc,CA4ChB;AAMD;;GAEG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EAAE,GACrB;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,YAAY,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,GACnB,qBAAqB,GAAG,IAAI,CAiC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,SAAS,GAAG,MAAM,EACxB,YAAY,EAAE,OAAO,GACpB,OAAO,CAaT"}

package/dist/auto-mode-handler.js

@@ -0,0 +1,211 @@
+/**
+ * Auto mode handler for Discord DMs and dedicated channels
+ *
+ * Provides utilities for:
+ * - Checking if DMs should be processed (auto mode by default)
+ * - Filtering users via allowlist/blocklist
+ * - Determining channel mode configuration
+ */
+// =============================================================================
+// DM Filtering
+// =============================================================================
+/**
+ * Check if DMs are enabled based on configuration
+ *
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns true if DMs are enabled, false otherwise
+ */
+export function isDMEnabled(dmConfig) {
+    // If no DM config provided, DMs are enabled by default
+    if (!dmConfig) {
+        return true;
+    }
+    return dmConfig.enabled;
+}
+/**
+ * Get the mode for DM processing
+ *
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns The mode for DM processing (defaults to "auto")
+ */
+export function getDMMode(dmConfig) {
+    // DMs default to auto mode (no mention required)
+    if (!dmConfig) {
+        return "auto";
+    }
+    return dmConfig.mode;
+}
+/**
+ * Check if a user is allowed to send DMs to the bot
+ *
+ * Filtering rules:
+ * 1. If DMs are disabled, no users are allowed
+ * 2. If a blocklist is defined and user is on it, they are blocked
+ * 3. If an allowlist is defined, only users on it are allowed
+ * 4. If neither list is defined, all users are allowed
+ *
+ * @param userId - Discord user ID to check
+ * @param dmConfig - DM configuration from agent's Discord config
+ * @returns Filter result with allowed status and reason
+ *
+ * @example
+ * ```typescript
+ * const result = checkDMUserFilter("123456789", dmConfig);
+ * if (!result.allowed) {
+ *   console.log(`User blocked: ${result.reason}`);
+ * }
+ * ```
+ */
+export function checkDMUserFilter(userId, dmConfig) {
+    // If DMs are disabled, no users are allowed
+    if (!isDMEnabled(dmConfig)) {
+        return {
+            allowed: false,
+            reason: "dm_disabled",
+        };
+    }
+    // If no config, all users are allowed
+    if (!dmConfig) {
+        return {
+            allowed: true,
+            reason: "allowed",
+        };
+    }
+    const { allowlist, blocklist } = dmConfig;
+    // Check blocklist first (takes precedence)
+    if (blocklist && blocklist.length > 0) {
+        if (blocklist.includes(userId)) {
+            return {
+                allowed: false,
+                reason: "in_blocklist",
+            };
+        }
+    }
+    // Check allowlist (if defined, only users on it are allowed)
+    if (allowlist && allowlist.length > 0) {
+        if (!allowlist.includes(userId)) {
+            return {
+                allowed: false,
+                reason: "not_in_allowlist",
+            };
+        }
+    }
+    // User is allowed
+    return {
+        allowed: true,
+        reason: "allowed",
+    };
+}
+// =============================================================================
+// Channel Configuration
+// =============================================================================
+/**
+ * Default number of context messages for DMs
+ */
+export const DEFAULT_DM_CONTEXT_MESSAGES = 10;
+/**
+ * Default number of context messages for channels
+ */
+export const DEFAULT_CHANNEL_CONTEXT_MESSAGES = 10;
+/**
+ * Find channel configuration from guild config
+ *
+ * @param channelId - Discord channel ID
+ * @param guilds - Array of guild configurations
+ * @returns Channel config and guild ID, or null if not found
+ */
+export function findChannelConfig(channelId, guilds) {
+    for (const guild of guilds) {
+        const channel = guild.channels?.find((c) => c.id === channelId);
+        if (channel) {
+            return { channel, guildId: guild.id };
+        }
+    }
+    return null;
+}
+/**
+ * Resolve channel configuration for a message
+ *
+ * Determines the mode and context settings for a given channel,
+ * handling both guild channels and DMs appropriately.
+ *
+ * @param channelId - Discord channel ID
+ * @param guildId - Guild ID (null for DMs)
+ * @param guilds - Array of guild configurations
+ * @param dmConfig - Global DM configuration
+ * @returns Resolved channel configuration or null if channel not configured
+ *
+ * @example
+ * ```typescript
+ * const config = resolveChannelConfig(
+ *   message.channel.id,
+ *   message.guildId,
+ *   discordConfig.guilds,
+ *   discordConfig.dm
+ * );
+ *
+ * if (config) {
+ *   if (config.mode === 'auto') {
+ *     // Process all non-bot messages
+ *   } else {
+ *     // Only process mentions
+ *   }
+ * }
+ * ```
+ */
+export function resolveChannelConfig(channelId, guildId, guilds, dmConfig) {
+    // Handle DMs
+    if (!guildId) {
+        // Check if DMs are enabled
+        if (!isDMEnabled(dmConfig)) {
+            return null;
+        }
+        return {
+            mode: getDMMode(dmConfig),
+            contextMessages: DEFAULT_DM_CONTEXT_MESSAGES,
+            isDM: true,
+            guildId: null,
+        };
+    }
+    // Handle guild channels
+    const guildConfig = guilds.find((g) => g.id === guildId);
+    if (!guildConfig) {
+        return null;
+    }
+    const channelConfig = guildConfig.channels?.find((c) => c.id === channelId);
+    if (!channelConfig) {
+        return null;
+    }
+    return {
+        mode: channelConfig.mode,
+        contextMessages: channelConfig.context_messages,
+        isDM: false,
+        guildId,
+    };
+}
+/**
+ * Check if a message should be processed in auto mode
+ *
+ * In auto mode:
+ * - All non-bot messages are processed
+ * - No mention is required
+ * - Full conversation context is maintained
+ *
+ * @param isBot - Whether the message author is a bot
+ * @param mode - The channel mode
+ * @param wasMentioned - Whether the bot was mentioned
+ * @returns true if the message should be processed
+ */
+export function shouldProcessInMode(isBot, mode, wasMentioned) {
+    // Never process bot messages
+    if (isBot) {
+        return false;
+    }
+    // In auto mode, process all non-bot messages
+    if (mode === "auto") {
+        return true;
+    }
+    // In mention mode, only process if mentioned
+    return wasMentioned;
+}
+//# sourceMappingURL=auto-mode-handler.js.map

package/dist/auto-mode-handler.js.map

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

package/dist/commands/__tests__/command-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-manager.test.d.ts.map

package/dist/commands/__tests__/command-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-manager.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/command-manager.test.ts"],"names":[],"mappings":""}

package/dist/commands/__tests__/command-manager.test.js

@@ -0,0 +1,307 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// =============================================================================
+// Mock discord.js REST and Routes
+// =============================================================================
+const mockRestPut = vi.fn().mockResolvedValue([]);
+vi.mock("discord.js", async () => {
+    const actual = await vi.importActual("discord.js");
+    // Create a mock REST class
+    class MockREST {
+        setToken() {
+            return this;
+        }
+        put = mockRestPut;
+    }
+    return {
+        ...actual,
+        REST: MockREST,
+        Routes: {
+            applicationCommands: (clientId) => `/applications/${clientId}/commands`,
+        },
+    };
+});
+// Import after mock
+import { CommandManager } from "../command-manager.js";
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+function createMockClient() {
+    return {
+        user: {
+            id: "bot-123",
+            username: "TestBot",
+        },
+    };
+}
+function createMockSessionManager() {
+    return {
+        agentName: "test-agent",
+        getOrCreateSession: vi.fn(),
+        touchSession: vi.fn(),
+        getSession: vi.fn(),
+        clearSession: vi.fn(),
+        cleanupExpiredSessions: vi.fn(),
+    };
+}
+function createMockConnectorState() {
+    return {
+        status: "connected",
+        connectedAt: new Date().toISOString(),
+        disconnectedAt: null,
+        reconnectAttempts: 0,
+        lastError: null,
+        botUser: {
+            id: "bot-123",
+            username: "TestBot",
+            discriminator: "0001",
+        },
+        rateLimits: {
+            totalCount: 0,
+            lastRateLimitAt: null,
+            isRateLimited: false,
+            currentResetTime: 0,
+        },
+        messageStats: {
+            received: 0,
+            sent: 0,
+            ignored: 0,
+        },
+    };
+}
+function createMockInteraction(commandName, channelId = "channel-123") {
+    return {
+        commandName,
+        channelId,
+        reply: vi.fn().mockResolvedValue(undefined),
+        replied: false,
+        deferred: false,
+        user: {
+            id: "user-123",
+            username: "TestUser",
+        },
+    };
+}
+function createMockLogger() {
+    return {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    };
+}
+// =============================================================================
+// Tests
+// =============================================================================
+describe("CommandManager", () => {
+    let client;
+    let sessionManager;
+    let connectorState;
+    let logger;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        client = createMockClient();
+        sessionManager = createMockSessionManager();
+        connectorState = createMockConnectorState();
+        logger = createMockLogger();
+    });
+    describe("constructor", () => {
+        it("creates command manager with valid options", () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            expect(manager).toBeDefined();
+        });
+        it("registers built-in commands", () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const commands = manager.getCommands();
+            expect(commands.has("help")).toBe(true);
+            expect(commands.has("reset")).toBe(true);
+            expect(commands.has("status")).toBe(true);
+        });
+    });
+    describe("registerCommands", () => {
+        it("registers commands with Discord API", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            await manager.registerCommands();
+            expect(mockRestPut).toHaveBeenCalledTimes(1);
+            expect(mockRestPut).toHaveBeenCalledWith(expect.stringContaining("bot-123"), expect.objectContaining({
+                body: expect.any(Array),
+            }));
+        });
+        it("logs successful registration", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            await manager.registerCommands();
+            expect(logger.info).toHaveBeenCalledWith(expect.stringContaining("Registering"), expect.any(Object));
+            expect(logger.info).toHaveBeenCalledWith(expect.stringContaining("Successfully"));
+        });
+        it("throws when client user ID not available", async () => {
+            const clientWithoutUser = {
+                user: null,
+            };
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client: clientWithoutUser,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            await expect(manager.registerCommands()).rejects.toThrow("Client user ID not available");
+        });
+        it("logs error on registration failure", async () => {
+            mockRestPut.mockRejectedValueOnce(new Error("API Error"));
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            await expect(manager.registerCommands()).rejects.toThrow("API Error");
+            expect(logger.error).toHaveBeenCalledWith(expect.stringContaining("Failed"), expect.any(Object));
+        });
+    });
+    describe("handleInteraction", () => {
+        it("executes known commands", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const interaction = createMockInteraction("help");
+            await manager.handleInteraction(interaction);
+            const reply = interaction.reply;
+            expect(reply).toHaveBeenCalledTimes(1);
+        });
+        it("responds with error for unknown commands", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const interaction = createMockInteraction("unknown-command");
+            await manager.handleInteraction(interaction);
+            const reply = interaction.reply;
+            expect(reply).toHaveBeenCalledWith({
+                content: "Unknown command.",
+                ephemeral: true,
+            });
+        });
+        it("logs warning for unknown commands", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const interaction = createMockInteraction("unknown-command");
+            await manager.handleInteraction(interaction);
+            expect(logger.warn).toHaveBeenCalledWith(expect.stringContaining("Unknown command"), expect.any(Object));
+        });
+        it("logs command execution", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const interaction = createMockInteraction("help");
+            await manager.handleInteraction(interaction);
+            expect(logger.debug).toHaveBeenCalledWith(expect.stringContaining("Executing"), expect.objectContaining({
+                commandName: "help",
+            }));
+        });
+        it("handles command execution errors gracefully", async () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            // Create an interaction that will fail when executing
+            const interaction = createMockInteraction("reset");
+            sessionManager.clearSession.mockRejectedValueOnce(new Error("Session error"));
+            await manager.handleInteraction(interaction);
+            // ErrorHandler logs with different format
+            expect(logger.error).toHaveBeenCalledWith(expect.stringContaining("Error during"), expect.any(Object));
+            const reply = interaction.reply;
+            // User-friendly error message (no stack traces)
+            expect(reply).toHaveBeenCalledWith({
+                content: "Sorry, I encountered an error processing your request. Please try again.",
+                ephemeral: true,
+            });
+        });
+        it("provides correct context to command handler", async () => {
+            const manager = new CommandManager({
+                agentName: "my-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const interaction = createMockInteraction("help");
+            await manager.handleInteraction(interaction);
+            const reply = interaction.reply;
+            // Help command should include agent name in response
+            expect(reply).toHaveBeenCalledWith(expect.objectContaining({
+                content: expect.stringContaining("my-agent"),
+            }));
+        });
+    });
+    describe("getCommands", () => {
+        it("returns readonly map of commands", () => {
+            const manager = new CommandManager({
+                agentName: "test-agent",
+                client,
+                botToken: "test-token",
+                sessionManager,
+                getConnectorState: () => connectorState,
+                logger,
+            });
+            const commands = manager.getCommands();
+            expect(commands).toBeInstanceOf(Map);
+            expect(commands.size).toBe(3);
+        });
+    });
+});
+//# sourceMappingURL=command-manager.test.js.map