@herdctl/discord 0.0.1

package/dist/errors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Error classes for the Discord connector
+ *
+ * Provides typed errors for Discord connection and operation failures.
+ */
+/**
+ * Error codes for Discord connector operations
+ */
+export declare enum DiscordErrorCode {
+    CONNECTION_FAILED = "DISCORD_CONNECTION_FAILED",
+    ALREADY_CONNECTED = "DISCORD_ALREADY_CONNECTED",
+    NOT_CONNECTED = "DISCORD_NOT_CONNECTED",
+    INVALID_TOKEN = "DISCORD_INVALID_TOKEN",
+    MISSING_TOKEN = "DISCORD_MISSING_TOKEN",
+    GATEWAY_ERROR = "DISCORD_GATEWAY_ERROR",
+    RATE_LIMITED = "DISCORD_RATE_LIMITED"
+}
+/**
+ * Base error class for Discord connector operations
+ *
+ * Note: This extends Error directly rather than FleetManagerError
+ * because Discord connector errors have their own error code type.
+ */
+export declare class DiscordConnectorError extends Error {
+    readonly code: DiscordErrorCode;
+    readonly agentName: string;
+    constructor(message: string, code: DiscordErrorCode, agentName: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when connection to Discord fails
+ */
+export declare class DiscordConnectionError extends DiscordConnectorError {
+    constructor(agentName: string, message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when attempting to connect while already connected
+ */
+export declare class AlreadyConnectedError extends DiscordConnectorError {
+    constructor(agentName: string);
+}
+/**
+ * Error thrown when bot token is missing or invalid
+ */
+export declare class InvalidTokenError extends DiscordConnectorError {
+    constructor(agentName: string, reason: string);
+}
+/**
+ * Error thrown when bot token is not provided
+ */
+export declare class MissingTokenError extends DiscordConnectorError {
+    constructor(agentName: string, envVar: string);
+}
+/**
+ * Type guard to check if an error is a DiscordConnectorError
+ */
+export declare function isDiscordConnectorError(error: unknown): error is DiscordConnectorError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,iBAAiB,8BAA8B;IAC/C,iBAAiB,8BAA8B;IAC/C,aAAa,0BAA0B;IACvC,aAAa,0BAA0B;IACvC,aAAa,0BAA0B;IACvC,aAAa,0BAA0B;IACvC,YAAY,yBAAyB;CACtC;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IACvC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAO9B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,qBAAqB;gBACnD,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAS5E;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,qBAAqB;gBAClD,SAAS,EAAE,MAAM;CAQ9B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,qBAAqB;gBAC9C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ9C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,qBAAqB;gBAC9C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAEhC"}

package/dist/errors.js

@@ -0,0 +1,77 @@
+/**
+ * Error classes for the Discord connector
+ *
+ * Provides typed errors for Discord connection and operation failures.
+ */
+/**
+ * Error codes for Discord connector operations
+ */
+export var DiscordErrorCode;
+(function (DiscordErrorCode) {
+    DiscordErrorCode["CONNECTION_FAILED"] = "DISCORD_CONNECTION_FAILED";
+    DiscordErrorCode["ALREADY_CONNECTED"] = "DISCORD_ALREADY_CONNECTED";
+    DiscordErrorCode["NOT_CONNECTED"] = "DISCORD_NOT_CONNECTED";
+    DiscordErrorCode["INVALID_TOKEN"] = "DISCORD_INVALID_TOKEN";
+    DiscordErrorCode["MISSING_TOKEN"] = "DISCORD_MISSING_TOKEN";
+    DiscordErrorCode["GATEWAY_ERROR"] = "DISCORD_GATEWAY_ERROR";
+    DiscordErrorCode["RATE_LIMITED"] = "DISCORD_RATE_LIMITED";
+})(DiscordErrorCode || (DiscordErrorCode = {}));
+/**
+ * Base error class for Discord connector operations
+ *
+ * Note: This extends Error directly rather than FleetManagerError
+ * because Discord connector errors have their own error code type.
+ */
+export class DiscordConnectorError extends Error {
+    code;
+    agentName;
+    constructor(message, code, agentName, options) {
+        super(message, options);
+        this.name = "DiscordConnectorError";
+        this.code = code;
+        this.agentName = agentName;
+    }
+}
+/**
+ * Error thrown when connection to Discord fails
+ */
+export class DiscordConnectionError extends DiscordConnectorError {
+    constructor(agentName, message, options) {
+        super(`Discord connection failed for agent '${agentName}': ${message}`, DiscordErrorCode.CONNECTION_FAILED, agentName, options);
+        this.name = "DiscordConnectionError";
+    }
+}
+/**
+ * Error thrown when attempting to connect while already connected
+ */
+export class AlreadyConnectedError extends DiscordConnectorError {
+    constructor(agentName) {
+        super(`Discord connector for agent '${agentName}' is already connected`, DiscordErrorCode.ALREADY_CONNECTED, agentName);
+        this.name = "AlreadyConnectedError";
+    }
+}
+/**
+ * Error thrown when bot token is missing or invalid
+ */
+export class InvalidTokenError extends DiscordConnectorError {
+    constructor(agentName, reason) {
+        super(`Invalid Discord bot token for agent '${agentName}': ${reason}`, DiscordErrorCode.INVALID_TOKEN, agentName);
+        this.name = "InvalidTokenError";
+    }
+}
+/**
+ * Error thrown when bot token is not provided
+ */
+export class MissingTokenError extends DiscordConnectorError {
+    constructor(agentName, envVar) {
+        super(`Missing Discord bot token for agent '${agentName}': environment variable '${envVar}' is not set`, DiscordErrorCode.MISSING_TOKEN, agentName);
+        this.name = "MissingTokenError";
+    }
+}
+/**
+ * Type guard to check if an error is a DiscordConnectorError
+ */
+export function isDiscordConnectorError(error) {
+    return error instanceof DiscordConnectorError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAQX;AARD,WAAY,gBAAgB;IAC1B,mEAA+C,CAAA;IAC/C,mEAA+C,CAAA;IAC/C,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IACvC,yDAAqC,CAAA;AACvC,CAAC,EARW,gBAAgB,KAAhB,gBAAgB,QAQ3B;AAED;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9B,IAAI,CAAmB;IACvB,SAAS,CAAS;IAElC,YACE,OAAe,EACf,IAAsB,EACtB,SAAiB,EACjB,OAA2B;QAE3B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,qBAAqB;IAC/D,YAAY,SAAiB,EAAE,OAAe,EAAE,OAA2B;QACzE,KAAK,CACH,wCAAwC,SAAS,MAAM,OAAO,EAAE,EAChE,gBAAgB,CAAC,iBAAiB,EAClC,SAAS,EACT,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,qBAAqB;IAC9D,YAAY,SAAiB;QAC3B,KAAK,CACH,gCAAgC,SAAS,wBAAwB,EACjE,gBAAgB,CAAC,iBAAiB,EAClC,SAAS,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;IAC1D,YAAY,SAAiB,EAAE,MAAc;QAC3C,KAAK,CACH,wCAAwC,SAAS,MAAM,MAAM,EAAE,EAC/D,gBAAgB,CAAC,aAAa,EAC9B,SAAS,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;IAC1D,YAAY,SAAiB,EAAE,MAAc;QAC3C,KAAK,CACH,wCAAwC,SAAS,4BAA4B,MAAM,cAAc,EACjG,gBAAgB,CAAC,aAAa,EAC9B,SAAS,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,KAAK,YAAY,qBAAqB,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @herdctl/discord
+ *
+ * Discord connector for herdctl - Autonomous Agent Fleet Management for Claude Code
+ *
+ * This package provides:
+ * - DiscordConnector class for connecting agents to Discord
+ * - Per-agent Discord bot support
+ * - Connection lifecycle management
+ * - Event-driven architecture for monitoring
+ * - SessionManager for per-channel conversation context
+ */
+export declare const VERSION = "0.0.1";
+export { DiscordConnector } from "./discord-connector.js";
+export { DiscordLogger, createLoggerFromConfig, createDefaultDiscordLogger, } from "./logger.js";
+export type { DiscordLogLevel, DiscordLoggerOptions, } from "./logger.js";
+export { SessionManager } from "./session-manager/index.js";
+export type { DiscordConnectorOptions, DiscordConnectorState, DiscordConnectionStatus, DiscordConnectorLogger, IDiscordConnector, DiscordConnectorEventMap, DiscordConnectorEventName, DiscordConnectorEventPayload, } from "./types.js";
+export type { SessionManagerOptions, SessionManagerLogger, ISessionManager, SessionResult, ChannelSession, DiscordSessionState, } from "./session-manager/index.js";
+export { DiscordSessionStateSchema, ChannelSessionSchema, createInitialSessionState, createChannelSession, } from "./session-manager/index.js";
+export { isBotMentioned, shouldProcessMessage, stripBotMention, stripMentions, processMessage, fetchMessageHistory, buildConversationContext, formatContextForPrompt, } from "./mention-handler.js";
+export type { TextBasedChannel, ContextMessage, ContextBuildOptions, ConversationContext, } from "./mention-handler.js";
+export { isDMEnabled, getDMMode, checkDMUserFilter, findChannelConfig, resolveChannelConfig, shouldProcessInMode, DEFAULT_DM_CONTEXT_MESSAGES, DEFAULT_CHANNEL_CONTEXT_MESSAGES, } from "./auto-mode-handler.js";
+export type { DMFilterResult, DMConfig, ResolvedChannelConfig, } from "./auto-mode-handler.js";
+export { DiscordErrorCode, DiscordConnectorError, DiscordConnectionError, AlreadyConnectedError, InvalidTokenError, MissingTokenError, isDiscordConnectorError, } from "./errors.js";
+export { USER_ERROR_MESSAGES, ErrorCategory, classifyError, withRetry, ErrorHandler, safeExecute, safeExecuteWithReply, } from "./error-handler.js";
+export type { UserErrorMessageKey, ClassifiedError, RetryOptions, RetryResult, ErrorHandlerOptions, } from "./error-handler.js";
+export { SessionErrorCode, SessionManagerError, SessionStateReadError, SessionStateWriteError, SessionDirectoryCreateError, isSessionManagerError, } from "./session-manager/index.js";
+export { CommandManager } from "./commands/index.js";
+export { helpCommand, resetCommand, statusCommand } from "./commands/index.js";
+export type { CommandContext, SlashCommand, CommandManagerLogger, CommandManagerOptions, ICommandManager, } from "./commands/index.js";
+export { DISCORD_MAX_MESSAGE_LENGTH, DEFAULT_MESSAGE_DELAY_MS, MIN_CHUNK_SIZE, findSplitPoint, splitMessage, needsSplit, startTypingIndicator, sendSplitMessage, sendWithTyping, truncateMessage, formatCodeBlock, escapeMarkdown, } from "./utils/index.js";
+export type { SendableChannel, MessageSplitOptions, SendSplitOptions, SplitResult, TypingController, } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,cAAc,EACd,QAAQ,EACR,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/E,YAAY,EACV,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @herdctl/discord
+ *
+ * Discord connector for herdctl - Autonomous Agent Fleet Management for Claude Code
+ *
+ * This package provides:
+ * - DiscordConnector class for connecting agents to Discord
+ * - Per-agent Discord bot support
+ * - Connection lifecycle management
+ * - Event-driven architecture for monitoring
+ * - SessionManager for per-channel conversation context
+ */
+export const VERSION = "0.0.1";
+// Main connector class
+export { DiscordConnector } from "./discord-connector.js";
+// Logger
+export { DiscordLogger, createLoggerFromConfig, createDefaultDiscordLogger, } from "./logger.js";
+// Session manager
+export { SessionManager } from "./session-manager/index.js";
+export { DiscordSessionStateSchema, ChannelSessionSchema, createInitialSessionState, createChannelSession, } from "./session-manager/index.js";
+// Mention handling
+export { isBotMentioned, shouldProcessMessage, stripBotMention, stripMentions, processMessage, fetchMessageHistory, buildConversationContext, formatContextForPrompt, } from "./mention-handler.js";
+// Auto mode handling (DMs and dedicated channels)
+export { isDMEnabled, getDMMode, checkDMUserFilter, findChannelConfig, resolveChannelConfig, shouldProcessInMode, DEFAULT_DM_CONTEXT_MESSAGES, DEFAULT_CHANNEL_CONTEXT_MESSAGES, } from "./auto-mode-handler.js";
+// Errors
+export { DiscordErrorCode, DiscordConnectorError, DiscordConnectionError, AlreadyConnectedError, InvalidTokenError, MissingTokenError, isDiscordConnectorError, } from "./errors.js";
+// Error handling utilities
+export { USER_ERROR_MESSAGES, ErrorCategory, classifyError, withRetry, ErrorHandler, safeExecute, safeExecuteWithReply, } from "./error-handler.js";
+// Session manager errors
+export { SessionErrorCode, SessionManagerError, SessionStateReadError, SessionStateWriteError, SessionDirectoryCreateError, isSessionManagerError, } from "./session-manager/index.js";
+// Commands
+export { CommandManager } from "./commands/index.js";
+export { helpCommand, resetCommand, statusCommand } from "./commands/index.js";
+// Formatting utilities
+export { DISCORD_MAX_MESSAGE_LENGTH, DEFAULT_MESSAGE_DELAY_MS, MIN_CHUNK_SIZE, findSplitPoint, splitMessage, needsSplit, startTypingIndicator, sendSplitMessage, sendWithTyping, truncateMessage, formatCodeBlock, escapeMarkdown, } from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,uBAAuB;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,SAAS;AACT,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAOrB,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAwB5D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAS9B,kDAAkD;AAClD,OAAO,EACL,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAQhC,SAAS;AACT,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAU5B,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAU/E,uBAAuB;AACvB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Configurable logger for Discord connector operations
+ *
+ * Implements log level filtering based on configuration:
+ * - minimal: Only errors and critical state changes
+ * - standard: Connection events, message counts, session operations (default)
+ * - verbose: All messages logged with optional content redaction
+ */
+import type { AgentChatDiscord } from "@herdctl/core";
+import type { DiscordConnectorLogger } from "./types.js";
+/**
+ * Log level hierarchy for filtering
+ * Higher number = more severe = always logged
+ */
+export type DiscordLogLevel = "minimal" | "standard" | "verbose";
+/**
+ * Options for configuring the Discord logger
+ */
+export interface DiscordLoggerOptions {
+    /**
+     * Name of the agent this logger is for
+     */
+    agentName: string;
+    /**
+     * Log level setting from config
+     * @default "standard"
+     */
+    logLevel?: DiscordLogLevel;
+    /**
+     * Whether to redact message content in verbose mode
+     * @default true
+     */
+    redactContent?: boolean;
+    /**
+     * Custom prefix for log messages
+     * @default "[discord:agentName]"
+     */
+    prefix?: string;
+}
+/**
+ * Configurable logger for Discord connector operations
+ *
+ * Implements log level filtering based on configuration:
+ * - minimal: Only errors and critical state changes (warn/error)
+ * - standard: Connection events, message counts, session operations (info/warn/error)
+ * - verbose: All messages logged with optional content redaction (debug/info/warn/error)
+ *
+ * @example
+ * ```typescript
+ * const logger = new DiscordLogger({
+ *   agentName: 'my-agent',
+ *   logLevel: 'standard',
+ *   redactContent: true,
+ * });
+ *
+ * logger.info('Connected to Discord', { username: 'Bot#1234' });
+ * logger.debug('Debug message', { sensitive: 'data' }); // Filtered out in standard mode
+ * ```
+ */
+export declare class DiscordLogger implements DiscordConnectorLogger {
+    private readonly agentName;
+    private readonly logLevel;
+    private readonly redactContent;
+    private readonly prefix;
+    private readonly levelValue;
+    constructor(options: DiscordLoggerOptions);
+    /**
+     * Check if a log method should output based on current log level
+     */
+    private shouldLog;
+    /**
+     * Process data for logging, applying redaction if needed
+     */
+    private processData;
+    /**
+     * Format and output a log message
+     */
+    private log;
+    /**
+     * Log a debug message (only visible in verbose mode)
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an info message (visible in standard and verbose modes)
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a warning message (always visible)
+     */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an error message (always visible)
+     */
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Get the current log level
+     */
+    getLogLevel(): DiscordLogLevel;
+    /**
+     * Check if redaction is enabled
+     */
+    isRedactionEnabled(): boolean;
+}
+/**
+ * Create a DiscordLogger from agent Discord configuration
+ *
+ * @param agentName - Name of the agent
+ * @param discordConfig - Discord configuration from agent config
+ * @returns Configured DiscordLogger instance
+ */
+export declare function createLoggerFromConfig(agentName: string, discordConfig: AgentChatDiscord): DiscordLogger;
+/**
+ * Create a default logger for an agent (standard log level)
+ *
+ * @param agentName - Name of the agent
+ * @returns DiscordLogger with default settings
+ */
+export declare function createDefaultDiscordLogger(agentName: string): DiscordLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAqBjE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,oBAAoB;IAQzC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,GAAG;IAoBX;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,WAAW,IAAI,eAAe;IAI9B;;OAEG;IACH,kBAAkB,IAAI,OAAO;CAG9B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,GAC9B,aAAa,CAMf;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAM3E"}

package/dist/logger.js

@@ -0,0 +1,198 @@
+/**
+ * Configurable logger for Discord connector operations
+ *
+ * Implements log level filtering based on configuration:
+ * - minimal: Only errors and critical state changes
+ * - standard: Connection events, message counts, session operations (default)
+ * - verbose: All messages logged with optional content redaction
+ */
+/**
+ * Maps log level names to numeric values for comparison
+ */
+const LOG_LEVEL_VALUES = {
+    verbose: 0, // Most permissive - logs everything
+    standard: 1, // Default - logs info and above
+    minimal: 2, // Most restrictive - logs errors only
+};
+/**
+ * Maps method names to their required log levels
+ */
+const METHOD_LEVELS = {
+    debug: 0, // Only in verbose
+    info: 1, // Standard and above
+    warn: 2, // Always logged
+    error: 2, // Always logged
+};
+/**
+ * Keys that should be redacted in data objects when redactContent is true
+ */
+const REDACTABLE_KEYS = [
+    "content",
+    "message",
+    "prompt",
+    "text",
+    "body",
+    "token",
+    "secret",
+    "password",
+];
+/**
+ * Redact sensitive content from a data object
+ */
+function redactData(data, keysToRedact = REDACTABLE_KEYS) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (keysToRedact.includes(key.toLowerCase())) {
+            if (typeof value === "string") {
+                result[key] = `[REDACTED ${value.length} chars]`;
+            }
+            else if (Array.isArray(value)) {
+                result[key] = `[REDACTED ${value.length} items]`;
+            }
+            else {
+                result[key] = "[REDACTED]";
+            }
+        }
+        else if (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value)) {
+            result[key] = redactData(value, keysToRedact);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Configurable logger for Discord connector operations
+ *
+ * Implements log level filtering based on configuration:
+ * - minimal: Only errors and critical state changes (warn/error)
+ * - standard: Connection events, message counts, session operations (info/warn/error)
+ * - verbose: All messages logged with optional content redaction (debug/info/warn/error)
+ *
+ * @example
+ * ```typescript
+ * const logger = new DiscordLogger({
+ *   agentName: 'my-agent',
+ *   logLevel: 'standard',
+ *   redactContent: true,
+ * });
+ *
+ * logger.info('Connected to Discord', { username: 'Bot#1234' });
+ * logger.debug('Debug message', { sensitive: 'data' }); // Filtered out in standard mode
+ * ```
+ */
+export class DiscordLogger {
+    agentName;
+    logLevel;
+    redactContent;
+    prefix;
+    levelValue;
+    constructor(options) {
+        this.agentName = options.agentName;
+        this.logLevel = options.logLevel ?? "standard";
+        this.redactContent = options.redactContent ?? true;
+        this.prefix = options.prefix ?? `[discord:${options.agentName}]`;
+        this.levelValue = LOG_LEVEL_VALUES[this.logLevel];
+    }
+    /**
+     * Check if a log method should output based on current log level
+     */
+    shouldLog(methodLevel) {
+        return methodLevel >= this.levelValue;
+    }
+    /**
+     * Process data for logging, applying redaction if needed
+     */
+    processData(data) {
+        if (!data)
+            return undefined;
+        if (this.redactContent && this.logLevel === "verbose") {
+            return redactData(data);
+        }
+        return data;
+    }
+    /**
+     * Format and output a log message
+     */
+    log(level, message, data) {
+        const methodLevel = METHOD_LEVELS[level];
+        if (!this.shouldLog(methodLevel)) {
+            return;
+        }
+        const processedData = this.processData(data);
+        const logFn = console[level];
+        if (processedData) {
+            logFn(this.prefix, message, processedData);
+        }
+        else {
+            logFn(this.prefix, message);
+        }
+    }
+    /**
+     * Log a debug message (only visible in verbose mode)
+     */
+    debug(message, data) {
+        this.log("debug", message, data);
+    }
+    /**
+     * Log an info message (visible in standard and verbose modes)
+     */
+    info(message, data) {
+        this.log("info", message, data);
+    }
+    /**
+     * Log a warning message (always visible)
+     */
+    warn(message, data) {
+        this.log("warn", message, data);
+    }
+    /**
+     * Log an error message (always visible)
+     */
+    error(message, data) {
+        this.log("error", message, data);
+    }
+    /**
+     * Get the current log level
+     */
+    getLogLevel() {
+        return this.logLevel;
+    }
+    /**
+     * Check if redaction is enabled
+     */
+    isRedactionEnabled() {
+        return this.redactContent;
+    }
+}
+/**
+ * Create a DiscordLogger from agent Discord configuration
+ *
+ * @param agentName - Name of the agent
+ * @param discordConfig - Discord configuration from agent config
+ * @returns Configured DiscordLogger instance
+ */
+export function createLoggerFromConfig(agentName, discordConfig) {
+    return new DiscordLogger({
+        agentName,
+        logLevel: discordConfig.log_level,
+        redactContent: true,
+    });
+}
+/**
+ * Create a default logger for an agent (standard log level)
+ *
+ * @param agentName - Name of the agent
+ * @returns DiscordLogger with default settings
+ */
+export function createDefaultDiscordLogger(agentName) {
+    return new DiscordLogger({
+        agentName,
+        logLevel: "standard",
+        redactContent: true,
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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