@herdctl/discord 0.0.1

package/dist/commands/command-manager.js

@@ -0,0 +1,191 @@
+/**
+ * Command Manager - Handles slash command registration and execution
+ *
+ * Registers commands per-bot (as application commands) and handles
+ * command interactions by routing them to the appropriate handler.
+ */
+import { REST, Routes, SlashCommandBuilder, } from "discord.js";
+import { helpCommand } from "./help.js";
+import { resetCommand } from "./reset.js";
+import { statusCommand } from "./status.js";
+import { ErrorHandler, withRetry, } from "../error-handler.js";
+// =============================================================================
+// Default Logger
+// =============================================================================
+function createDefaultLogger(agentName) {
+    const prefix = `[commands:${agentName}]`;
+    return {
+        debug: (msg, data) => console.debug(prefix, msg, data ? JSON.stringify(data) : ""),
+        info: (msg, data) => console.info(prefix, msg, data ? JSON.stringify(data) : ""),
+        warn: (msg, data) => console.warn(prefix, msg, data ? JSON.stringify(data) : ""),
+        error: (msg, data) => console.error(prefix, msg, data ? JSON.stringify(data) : ""),
+    };
+}
+// =============================================================================
+// Built-in Commands
+// =============================================================================
+/**
+ * Get all built-in commands
+ */
+function getBuiltInCommands() {
+    return [helpCommand, resetCommand, statusCommand];
+}
+// =============================================================================
+// Command Manager Implementation
+// =============================================================================
+/**
+ * CommandManager handles slash command registration and execution.
+ *
+ * Commands are registered per-bot using Discord's REST API. Each agent's
+ * bot has its own set of commands.
+ *
+ * @example
+ * ```typescript
+ * const commandManager = new CommandManager({
+ *   agentName: 'my-agent',
+ *   client: discordClient,
+ *   botToken: process.env.BOT_TOKEN,
+ *   sessionManager,
+ *   getConnectorState: () => connector.getState(),
+ * });
+ *
+ * // Register commands after client is ready
+ * await commandManager.registerCommands();
+ *
+ * // Handle interactions in your interaction handler
+ * client.on('interactionCreate', async (interaction) => {
+ *   if (interaction.isChatInputCommand()) {
+ *     await commandManager.handleInteraction(interaction);
+ *   }
+ * });
+ * ```
+ */
+export class CommandManager {
+    agentName;
+    client;
+    botToken;
+    sessionManager;
+    getConnectorState;
+    logger;
+    commands;
+    errorHandler;
+    constructor(options) {
+        this.agentName = options.agentName;
+        this.client = options.client;
+        this.botToken = options.botToken;
+        this.sessionManager = options.sessionManager;
+        this.getConnectorState = options.getConnectorState;
+        this.logger = options.logger ?? createDefaultLogger(options.agentName);
+        // Initialize error handler
+        this.errorHandler = new ErrorHandler({
+            logger: this.logger,
+            agentName: this.agentName,
+        });
+        // Initialize commands map
+        this.commands = new Map();
+        for (const command of getBuiltInCommands()) {
+            this.commands.set(command.name, command);
+        }
+    }
+    /**
+     * Register all commands with Discord
+     *
+     * Uses the Discord REST API to register application commands.
+     * Commands are registered globally for the bot application.
+     * Includes retry logic for transient failures.
+     */
+    async registerCommands() {
+        const rest = new REST({ version: "10" }).setToken(this.botToken);
+        // Build command data for Discord API
+        const commandData = Array.from(this.commands.values()).map((cmd) => new SlashCommandBuilder()
+            .setName(cmd.name)
+            .setDescription(cmd.description)
+            .toJSON());
+        const clientId = this.client.user?.id;
+        if (!clientId) {
+            this.logger.error("Cannot register commands: client user ID not available");
+            throw new Error("Client user ID not available for command registration");
+        }
+        this.logger.info("Registering slash commands...", {
+            commandCount: commandData.length,
+            commands: Array.from(this.commands.keys()),
+        });
+        // Use retry logic for command registration (handles rate limits, network issues)
+        const result = await withRetry(async () => {
+            await rest.put(Routes.applicationCommands(clientId), {
+                body: commandData,
+            });
+        }, {
+            maxAttempts: 3,
+            baseDelayMs: 2000,
+            operationName: "registerCommands",
+            logger: this.logger,
+        });
+        if (!result.success) {
+            const errorMessage = result.error?.message ?? "Unknown error";
+            this.logger.error("Failed to register slash commands after retries", {
+                error: errorMessage,
+                attempts: result.attempts,
+            });
+            throw result.error ?? new Error("Failed to register commands");
+        }
+        this.logger.info("Successfully registered slash commands");
+    }
+    /**
+     * Handle an incoming command interaction
+     *
+     * Routes the interaction to the appropriate command handler.
+     * Provides user-friendly error messages on failure.
+     */
+    async handleInteraction(interaction) {
+        const commandName = interaction.commandName;
+        const command = this.commands.get(commandName);
+        if (!command) {
+            this.logger.warn("Unknown command received", { commandName });
+            await interaction.reply({
+                content: "Unknown command.",
+                ephemeral: true,
+            });
+            return;
+        }
+        this.logger.debug("Executing command", {
+            commandName,
+            userId: interaction.user.id,
+            channelId: interaction.channelId,
+        });
+        const context = {
+            interaction,
+            client: this.client,
+            agentName: this.agentName,
+            sessionManager: this.sessionManager,
+            connectorState: this.getConnectorState(),
+        };
+        try {
+            await command.execute(context);
+        }
+        catch (error) {
+            // Use error handler for detailed logging
+            const userMessage = this.errorHandler.handleError(error, `executing command '${commandName}'`);
+            // Try to respond with user-friendly error if we haven't already replied
+            if (!interaction.replied && !interaction.deferred) {
+                await interaction.reply({
+                    content: userMessage,
+                    ephemeral: true,
+                });
+            }
+            else if (interaction.deferred && !interaction.replied) {
+                // If deferred but not replied, use editReply
+                await interaction.editReply({
+                    content: userMessage,
+                });
+            }
+        }
+    }
+    /**
+     * Get all registered commands
+     */
+    getCommands() {
+        return this.commands;
+    }
+}
+//# sourceMappingURL=command-manager.js.map

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

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

package/dist/commands/help.d.ts

@@ -0,0 +1,8 @@
+/**
+ * /help command - Show available commands
+ *
+ * Responds ephemerally with a list of available commands and their descriptions.
+ */
+import type { SlashCommand } from "./types.js";
+export declare const helpCommand: SlashCommand;
+//# 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;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAE,YAuBzB,CAAC"}

package/dist/commands/help.js

@@ -0,0 +1,27 @@
+/**
+ * /help command - Show available commands
+ *
+ * Responds ephemerally with a list of available commands and their descriptions.
+ */
+export const helpCommand = {
+    name: "help",
+    description: "Show available commands",
+    async execute(context) {
+        const { interaction, agentName } = 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:**
+- Mention the bot in a channel to start a conversation
+- In configured channels, the bot may respond automatically
+- DMs are supported based on configuration`;
+        await interaction.reply({
+            content: helpMessage,
+            ephemeral: true,
+        });
+    },
+};
+//# 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;;;;GAIG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yBAAyB;IAEtC,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAE3C,MAAM,WAAW,GAAG,KAAK,SAAS;;;;;;;;;2CASK,CAAC;QAExC,MAAM,WAAW,CAAC,KAAK,CAAC;YACtB,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Slash commands module for Discord bot
+ *
+ * Provides command registration, handling, and built-in commands
+ * for controlling the bot via Discord slash commands.
+ */
+export { CommandManager } from "./command-manager.js";
+export type { CommandContext, SlashCommand, CommandManagerLogger, CommandManagerOptions, ICommandManager, } from "./types.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;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,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,13 @@
+/**
+ * Slash commands module for Discord bot
+ *
+ * Provides command registration, handling, and built-in commands
+ * for controlling the bot via Discord slash commands.
+ */
+// Command Manager
+export { CommandManager } from "./command-manager.js";
+// Built-in Commands
+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;;;;;GAKG;AAEH,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAWtD,oBAAoB;AACpB,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,9 @@
+/**
+ * /reset command - Clear conversation context
+ *
+ * Clears the session for the current channel, starting a fresh conversation.
+ * Responds ephemerally with confirmation.
+ */
+import type { SlashCommand } from "./types.js";
+export declare const resetCommand: SlashCommand;
+//# 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;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,YAAY,EAAE,YAsB1B,CAAC"}

package/dist/commands/reset.js

@@ -0,0 +1,28 @@
+/**
+ * /reset command - Clear conversation context
+ *
+ * Clears the session for the current channel, starting a fresh conversation.
+ * Responds ephemerally with confirmation.
+ */
+export const resetCommand = {
+    name: "reset",
+    description: "Clear conversation context (start fresh session)",
+    async execute(context) {
+        const { interaction, sessionManager, agentName } = context;
+        const channelId = interaction.channelId;
+        const wasCleared = await sessionManager.clearSession(channelId);
+        if (wasCleared) {
+            await interaction.reply({
+                content: `Conversation context cleared for **${agentName}**. Starting fresh!`,
+                ephemeral: true,
+            });
+        }
+        else {
+            await interaction.reply({
+                content: `No active session found for **${agentName}** in this channel. You're already starting fresh!`,
+                ephemeral: true,
+            });
+        }
+    },
+};
+//# 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;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,kDAAkD;IAE/D,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QAExC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEhE,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,KAAK,CAAC;gBACtB,OAAO,EAAE,sCAAsC,SAAS,qBAAqB;gBAC7E,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,CAAC,KAAK,CAAC;gBACtB,OAAO,EAAE,iCAAiC,SAAS,oDAAoD;gBACvG,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,9 @@
+/**
+ * /status command - Show agent status and session info
+ *
+ * Responds ephemerally with the current agent status, connection info,
+ * and session information for the current channel.
+ */
+import type { SlashCommand } from "./types.js";
+export declare const statusCommand: SlashCommand;
+//# 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;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AA6D/D,eAAO,MAAM,aAAa,EAAE,YAgD3B,CAAC"}

package/dist/commands/status.js

@@ -0,0 +1,102 @@
+/**
+ * /status command - Show agent status and session info
+ *
+ * Responds ephemerally with the current agent status, connection info,
+ * and session information for the current channel.
+ */
+/**
+ * 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 session info",
+    async execute(context) {
+        const { interaction, agentName, connectorState, sessionManager } = context;
+        const channelId = interaction.channelId;
+        // Get session info for this channel
+        const session = await sessionManager.getSession(channelId);
+        // Build status message
+        const statusEmoji = getStatusEmoji(connectorState.status);
+        const botUsername = connectorState.botUser?.username ?? "Unknown";
+        let statusMessage = `**${agentName} Status**
+
+${statusEmoji} **Connection:** ${connectorState.status}
+**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 interaction.reply({
+            content: statusMessage,
+            ephemeral: true,
+        });
+    },
+};
+//# 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/commands/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Type definitions for Discord slash commands
+ *
+ * Provides interfaces for command registration, execution context,
+ * and command handler definitions.
+ */
+import type { ChatInputCommandInteraction, Client } from "discord.js";
+import type { DiscordConnectorState } from "../types.js";
+import type { ISessionManager } from "../session-manager/index.js";
+/**
+ * Context provided to command handlers when executing
+ */
+export interface CommandContext {
+    /** The Discord interaction object */
+    interaction: ChatInputCommandInteraction;
+    /** The Discord client */
+    client: Client;
+    /** Name of the agent this command is being executed for */
+    agentName: string;
+    /** Session manager for conversation context management */
+    sessionManager: ISessionManager;
+    /** Current connector state */
+    connectorState: DiscordConnectorState;
+}
+/**
+ * Definition of a slash command
+ */
+export interface SlashCommand {
+    /** Command name (lowercase, no spaces) */
+    name: string;
+    /** Command description shown in Discord's command picker */
+    description: string;
+    /**
+     * Execute the command
+     *
+     * @param context - Command execution context
+     */
+    execute(context: CommandContext): Promise<void>;
+}
+/**
+ * Logger interface for command manager operations
+ */
+export interface CommandManagerLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Options for the command manager
+ */
+export interface CommandManagerOptions {
+    /** Name of the agent */
+    agentName: string;
+    /** Discord client for registering commands */
+    client: Client;
+    /** Bot token for REST API authentication */
+    botToken: string;
+    /** Session manager for conversation context */
+    sessionManager: ISessionManager;
+    /** Function to get current connector state */
+    getConnectorState: () => DiscordConnectorState;
+    /** Optional logger */
+    logger?: CommandManagerLogger;
+}
+/**
+ * Interface for command managers
+ */
+export interface ICommandManager {
+    /**
+     * Register all commands with Discord
+     *
+     * Commands are registered per-bot (application commands), not globally.
+     */
+    registerCommands(): Promise<void>;
+    /**
+     * Handle an incoming command interaction
+     *
+     * @param interaction - The command interaction to handle
+     */
+    handleInteraction(interaction: ChatInputCommandInteraction): Promise<void>;
+    /**
+     * Get all registered commands
+     */
+    getCommands(): ReadonlyMap<string, SlashCommand>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAQ,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAMnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,WAAW,EAAE,2BAA2B,CAAC;IAEzC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAElB,0DAA0D;IAC1D,cAAc,EAAE,eAAe,CAAC;IAEhC,8BAA8B;IAC9B,cAAc,EAAE,qBAAqB,CAAC;CACvC;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,cAAc,EAAE,eAAe,CAAC;IAEhC,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;IAE/C,sBAAsB;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;OAEG;IACH,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAClD"}

package/dist/commands/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for Discord slash commands
+ *
+ * Provides interfaces for command registration, execution context,
+ * and command handler definitions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}