@agentforge/core 0.15.8 → 0.15.9

package/dist/index.cjs

@@ -946,7 +946,7 @@ var LoggerImpl = class _LoggerImpl {
     if (this.options.includeContext && Object.keys(this.context).length > 0) {
       entry.context = this.context;
     }
-    if (data) {
+    if (data !== void 0) {
       entry.data = data;
     }
     const output = this.format(entry);
@@ -966,7 +966,7 @@ var LoggerImpl = class _LoggerImpl {
     if (entry.context) {
       parts.push(`context=${JSON.stringify(entry.context)}`);
     }
-    if (entry.data) {
+    if (entry.data !== void 0) {
       parts.push(`data=${JSON.stringify(entry.data)}`);
     }
     return parts.join(" ");
@@ -1299,7 +1299,7 @@ var ToolRegistry = class {
           logger.error("Event handler error", {
             event,
             error: error instanceof Error ? error.message : String(error),
-            stack: error instanceof Error ? error.stack : void 0
+            ...error instanceof Error && error.stack ? { stack: error.stack } : {}
           });
         }
       });
@@ -1766,7 +1766,7 @@ var ManagedTool = class {
           (err) => logger3.error("Cleanup failed", {
             toolName: this.name,
             error: err instanceof Error ? err.message : String(err),
-            stack: err instanceof Error ? err.stack : void 0
+            ...err instanceof Error && err.stack ? { stack: err.stack } : {}
           })
         );
       });
@@ -2826,7 +2826,7 @@ var withLogging = (options) => {
         if (logErrors) {
           logger5.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
-            stack: err.stack
+            ...err.stack ? { stack: err.stack } : {}
           });
         }
         if (onError) {
@@ -5274,6 +5274,40 @@ function createProfiler(options) {
 
 // src/monitoring/alerts.ts
 var logger4 = createLogger("agentforge:core:monitoring:alerts", { level: "info" /* INFO */ });
+function toAlertSummary(alert) {
+  return {
+    name: alert.name,
+    severity: alert.severity,
+    message: alert.message
+  };
+}
+function toRuleErrorPayload(ruleName, error) {
+  return {
+    ruleName,
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
+function toAlertDispatchErrorPayload(ruleName, error) {
+  return {
+    stage: "alert-dispatch",
+    ...toRuleErrorPayload(ruleName, error)
+  };
+}
+function toAlertCallbackErrorPayload(error) {
+  return {
+    stage: "alert-callback",
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
+function toMetricsProviderErrorPayload(error) {
+  return {
+    stage: "metrics-provider",
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
 var AlertManager = class {
   constructor(options) {
     this.options = options;
@@ -5287,8 +5321,12 @@ var AlertManager = class {
     }
     this.running = true;
     this.monitorTimer = setInterval(() => {
-      const currentMetrics = metrics();
-      this.checkRules(currentMetrics);
+      try {
+        const currentMetrics = metrics();
+        this.checkRules(currentMetrics);
+      } catch (error) {
+        logger4.error("Metrics collection failed", toMetricsProviderErrorPayload(error));
+      }
     }, interval);
   }
   stop() {
@@ -5304,18 +5342,22 @@ var AlertManager = class {
   async alert(alert) {
     const fullAlert = {
       ...alert,
-      timestamp: alert.timestamp || Date.now()
+      timestamp: alert.timestamp ?? Date.now()
     };
     if (this.isThrottled(alert.name)) {
       return;
     }
     this.lastAlertTime.set(alert.name, Date.now());
-    this.options.onAlert?.(fullAlert);
+    try {
+      await this.options.onAlert?.(fullAlert);
+    } catch (error) {
+      logger4.error("Alert callback failed", toAlertCallbackErrorPayload(error));
+    }
     logger4.warn("Alert triggered", {
       name: alert.name,
       severity: alert.severity,
       message: alert.message,
-      data: alert.data
+      ...alert.data ? { data: alert.data } : {}
     });
   }
   checkRules(metrics) {
@@ -5325,19 +5367,17 @@ var AlertManager = class {
     for (const rule of this.options.rules) {
       try {
         if (rule.condition(metrics)) {
-          this.alert({
+          void this.alert({
             name: rule.name,
             severity: rule.severity,
             message: rule.message || `Alert triggered: ${rule.name}`,
             data: { metrics }
+          }).catch((error) => {
+            logger4.error("Alert dispatch failed", toAlertDispatchErrorPayload(rule.name, error));
           });
         }
       } catch (error) {
-        logger4.error("Rule check failed", {
-          ruleName: rule.name,
-          error: error instanceof Error ? error.message : String(error),
-          stack: error instanceof Error ? error.stack : void 0
-        });
+        logger4.error("Rule check failed", toRuleErrorPayload(rule.name, error));
       }
     }
   }
@@ -5362,32 +5402,32 @@ var AlertManager = class {
         logger4.info("Alert sent to email", {
           channel: channelName,
           to: channel.config.to,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       case "slack":
         logger4.info("Alert sent to Slack", {
           channel: channelName,
           webhookUrl: channel.config.webhookUrl,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       case "webhook":
         logger4.info("Alert sent to webhook", {
           channel: channelName,
           url: channel.config.url,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       default:
         logger4.info("Alert sent", {
           channel: channelName,
           channelType: channel.type,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
     }
   }
-  getAlertHistory(name, limit = 100) {
+  getAlertHistory(_name, _limit = 100) {
     return [];
   }
   clearAlertHistory(name) {

package/dist/index.d.cts

@@ -2816,11 +2816,21 @@ interface ErrorHandlerOptions<State> {
  */
 declare function withErrorHandler<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: ErrorHandlerOptions<State>): (state: State) => Promise<State | Partial<State>>;
 
+/**
+ * Shared JSON-safe payload contracts for observability and monitoring paths.
+ */
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+
 /**
  * Structured Logging Utilities
  *
  * Provides consistent, structured logging for LangGraph agents.
  */
+
 /**
  * Log levels
  */
@@ -2868,8 +2878,8 @@ interface LogEntry {
     name: string;
     message: string;
     timestamp?: string;
-    context?: Record<string, any>;
-    data?: Record<string, any>;
+    context?: JsonObject;
+    data?: JsonValue;
 }
 /**
  * Logger interface
@@ -2878,19 +2888,19 @@ interface Logger {
     /**
      * Log a debug message
      */
-    debug(message: string, data?: Record<string, any>): void;
+    debug(message: string, data?: JsonValue): void;
     /**
      * Log an info message
      */
-    info(message: string, data?: Record<string, any>): void;
+    info(message: string, data?: JsonValue): void;
     /**
      * Log a warning message
      */
-    warn(message: string, data?: Record<string, any>): void;
+    warn(message: string, data?: JsonValue): void;
     /**
      * Log an error message
      */
-    error(message: string, data?: Record<string, any>): void;
+    error(message: string, data?: JsonValue): void;
     /**
      * Check if debug logging is enabled
      * Useful for avoiding expensive computations when debug is disabled
@@ -2903,7 +2913,7 @@ interface Logger {
     /**
      * Create a child logger with additional context
      */
-    withContext(context: Record<string, any>): Logger;
+    withContext(context: JsonObject): Logger;
 }
 /**
  * Create a structured logger.
@@ -5334,47 +5344,80 @@ declare function createProfiler(options?: ProfilerOptions): Profiler;
 /**
  * Alert system for production monitoring
  */
+
 type AlertSeverity = 'info' | 'warning' | 'error' | 'critical';
-interface Alert {
+interface Alert<TData extends JsonObject = JsonObject> {
     name: string;
     severity: AlertSeverity;
     message: string;
     timestamp?: number;
-    data?: Record<string, any>;
-}
-interface AlertChannel {
-    type: string;
-    config: Record<string, any>;
+    data?: TData;
 }
-interface AlertRule {
+type BuiltInAlertChannelType = 'email' | 'slack' | 'webhook';
+type EmailAlertChannelConfig = JsonObject & {
+    to: string | string[];
+};
+type SlackAlertChannelConfig = JsonObject & {
+    webhookUrl: string;
+};
+type WebhookAlertChannelConfig = JsonObject & {
+    url: string;
+};
+interface EmailAlertChannel {
+    type: 'email';
+    config: EmailAlertChannelConfig;
+}
+interface SlackAlertChannel {
+    type: 'slack';
+    config: SlackAlertChannelConfig;
+}
+interface WebhookAlertChannel {
+    type: 'webhook';
+    config: WebhookAlertChannelConfig;
+}
+interface GenericAlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> {
+    type: TType;
+    config: TConfig;
+}
+type CustomAlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> = GenericAlertChannel<Exclude<TType, BuiltInAlertChannelType>, TConfig>;
+type AlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> = TType extends 'email' ? EmailAlertChannel : TType extends 'slack' ? SlackAlertChannel : TType extends 'webhook' ? WebhookAlertChannel : GenericAlertChannel<TType, TConfig>;
+type AlertChannelMap = Record<string, GenericAlertChannel>;
+type ValidatedAlertChannels<TChannels extends AlertChannelMap> = {
+    [TName in keyof TChannels]: TChannels[TName] extends GenericAlertChannel<infer TType, infer TConfig> ? AlertChannel<TType, TConfig> : never;
+};
+type AlertChannelName<TChannels extends AlertChannelMap> = keyof ValidatedAlertChannels<TChannels> & string;
+interface AlertRule<TMetrics extends JsonObject = JsonObject, TChannelName extends string = string> {
     name: string;
-    condition: (metrics: any) => boolean;
+    condition: (metrics: TMetrics) => boolean;
     severity: AlertSeverity;
-    channels: string[];
+    channels: TChannelName[];
     throttle?: number;
     message?: string;
 }
-interface AlertManagerOptions {
-    channels: Record<string, AlertChannel>;
-    rules?: AlertRule[];
-    onAlert?: (alert: Alert) => void;
+type AlertCallbackData<TMetrics extends JsonObject> = JsonObject & {
+    metrics?: TMetrics;
+};
+interface AlertManagerOptions<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>> {
+    channels: ValidatedAlertChannels<TChannels>;
+    rules?: AlertRule<TMetrics, AlertChannelName<TChannels>>[];
+    onAlert?: (alert: Alert<AlertCallbackData<TMetrics>>) => void | Promise<void>;
 }
-declare class AlertManager {
+declare class AlertManager<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>> {
     private options;
     private lastAlertTime;
     private monitorTimer?;
     private running;
-    constructor(options: AlertManagerOptions);
-    start(metrics?: () => any, interval?: number): void;
+    constructor(options: AlertManagerOptions<TMetrics, TChannels>);
+    start(metrics?: () => TMetrics, interval?: number): void;
     stop(): void;
-    alert(alert: Alert): Promise<void>;
+    alert(alert: Alert<AlertCallbackData<TMetrics>>): Promise<void>;
     private checkRules;
     private isThrottled;
-    sendToChannel(channelName: string, alert: Alert): Promise<void>;
-    getAlertHistory(name?: string, limit?: number): Alert[];
+    sendToChannel(channelName: keyof TChannels & string, alert: Alert<AlertCallbackData<TMetrics>>): Promise<void>;
+    getAlertHistory(_name?: string, _limit?: number): Alert<AlertCallbackData<TMetrics>>[];
     clearAlertHistory(name?: string): void;
 }
-declare function createAlertManager(options: AlertManagerOptions): AlertManager;
+declare function createAlertManager<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>>(options: AlertManagerOptions<TMetrics, TChannels>): AlertManager<TMetrics, TChannels>;
 
 /**
  * Audit logging for compliance and tracking
@@ -5548,4 +5591,4 @@ declare function renderTemplate(template: string, options: RenderTemplateOptions
  */
 declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | Record<string, any>, promptsDir?: string): string;
 
-export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DevelopmentPresetOptions, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketHandlerOptions, type WebSocketMessage, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };
+export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DevelopmentPresetOptions, type EmailAlertChannel, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type GenericAlertChannel, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type JsonObject, type JsonPrimitive, type JsonValue, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SlackAlertChannel, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketHandlerOptions, type WebSocketMessage, type WebhookAlertChannel, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };

package/dist/index.d.ts

@@ -2816,11 +2816,21 @@ interface ErrorHandlerOptions<State> {
  */
 declare function withErrorHandler<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: ErrorHandlerOptions<State>): (state: State) => Promise<State | Partial<State>>;
 
+/**
+ * Shared JSON-safe payload contracts for observability and monitoring paths.
+ */
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+
 /**
  * Structured Logging Utilities
  *
  * Provides consistent, structured logging for LangGraph agents.
  */
+
 /**
  * Log levels
  */
@@ -2868,8 +2878,8 @@ interface LogEntry {
     name: string;
     message: string;
     timestamp?: string;
-    context?: Record<string, any>;
-    data?: Record<string, any>;
+    context?: JsonObject;
+    data?: JsonValue;
 }
 /**
  * Logger interface
@@ -2878,19 +2888,19 @@ interface Logger {
     /**
      * Log a debug message
      */
-    debug(message: string, data?: Record<string, any>): void;
+    debug(message: string, data?: JsonValue): void;
     /**
      * Log an info message
      */
-    info(message: string, data?: Record<string, any>): void;
+    info(message: string, data?: JsonValue): void;
     /**
      * Log a warning message
      */
-    warn(message: string, data?: Record<string, any>): void;
+    warn(message: string, data?: JsonValue): void;
     /**
      * Log an error message
      */
-    error(message: string, data?: Record<string, any>): void;
+    error(message: string, data?: JsonValue): void;
     /**
      * Check if debug logging is enabled
      * Useful for avoiding expensive computations when debug is disabled
@@ -2903,7 +2913,7 @@ interface Logger {
     /**
      * Create a child logger with additional context
      */
-    withContext(context: Record<string, any>): Logger;
+    withContext(context: JsonObject): Logger;
 }
 /**
  * Create a structured logger.
@@ -5334,47 +5344,80 @@ declare function createProfiler(options?: ProfilerOptions): Profiler;
 /**
  * Alert system for production monitoring
  */
+
 type AlertSeverity = 'info' | 'warning' | 'error' | 'critical';
-interface Alert {
+interface Alert<TData extends JsonObject = JsonObject> {
     name: string;
     severity: AlertSeverity;
     message: string;
     timestamp?: number;
-    data?: Record<string, any>;
-}
-interface AlertChannel {
-    type: string;
-    config: Record<string, any>;
+    data?: TData;
 }
-interface AlertRule {
+type BuiltInAlertChannelType = 'email' | 'slack' | 'webhook';
+type EmailAlertChannelConfig = JsonObject & {
+    to: string | string[];
+};
+type SlackAlertChannelConfig = JsonObject & {
+    webhookUrl: string;
+};
+type WebhookAlertChannelConfig = JsonObject & {
+    url: string;
+};
+interface EmailAlertChannel {
+    type: 'email';
+    config: EmailAlertChannelConfig;
+}
+interface SlackAlertChannel {
+    type: 'slack';
+    config: SlackAlertChannelConfig;
+}
+interface WebhookAlertChannel {
+    type: 'webhook';
+    config: WebhookAlertChannelConfig;
+}
+interface GenericAlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> {
+    type: TType;
+    config: TConfig;
+}
+type CustomAlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> = GenericAlertChannel<Exclude<TType, BuiltInAlertChannelType>, TConfig>;
+type AlertChannel<TType extends string = string, TConfig extends JsonObject = JsonObject> = TType extends 'email' ? EmailAlertChannel : TType extends 'slack' ? SlackAlertChannel : TType extends 'webhook' ? WebhookAlertChannel : GenericAlertChannel<TType, TConfig>;
+type AlertChannelMap = Record<string, GenericAlertChannel>;
+type ValidatedAlertChannels<TChannels extends AlertChannelMap> = {
+    [TName in keyof TChannels]: TChannels[TName] extends GenericAlertChannel<infer TType, infer TConfig> ? AlertChannel<TType, TConfig> : never;
+};
+type AlertChannelName<TChannels extends AlertChannelMap> = keyof ValidatedAlertChannels<TChannels> & string;
+interface AlertRule<TMetrics extends JsonObject = JsonObject, TChannelName extends string = string> {
     name: string;
-    condition: (metrics: any) => boolean;
+    condition: (metrics: TMetrics) => boolean;
     severity: AlertSeverity;
-    channels: string[];
+    channels: TChannelName[];
     throttle?: number;
     message?: string;
 }
-interface AlertManagerOptions {
-    channels: Record<string, AlertChannel>;
-    rules?: AlertRule[];
-    onAlert?: (alert: Alert) => void;
+type AlertCallbackData<TMetrics extends JsonObject> = JsonObject & {
+    metrics?: TMetrics;
+};
+interface AlertManagerOptions<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>> {
+    channels: ValidatedAlertChannels<TChannels>;
+    rules?: AlertRule<TMetrics, AlertChannelName<TChannels>>[];
+    onAlert?: (alert: Alert<AlertCallbackData<TMetrics>>) => void | Promise<void>;
 }
-declare class AlertManager {
+declare class AlertManager<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>> {
     private options;
     private lastAlertTime;
     private monitorTimer?;
     private running;
-    constructor(options: AlertManagerOptions);
-    start(metrics?: () => any, interval?: number): void;
+    constructor(options: AlertManagerOptions<TMetrics, TChannels>);
+    start(metrics?: () => TMetrics, interval?: number): void;
     stop(): void;
-    alert(alert: Alert): Promise<void>;
+    alert(alert: Alert<AlertCallbackData<TMetrics>>): Promise<void>;
     private checkRules;
     private isThrottled;
-    sendToChannel(channelName: string, alert: Alert): Promise<void>;
-    getAlertHistory(name?: string, limit?: number): Alert[];
+    sendToChannel(channelName: keyof TChannels & string, alert: Alert<AlertCallbackData<TMetrics>>): Promise<void>;
+    getAlertHistory(_name?: string, _limit?: number): Alert<AlertCallbackData<TMetrics>>[];
     clearAlertHistory(name?: string): void;
 }
-declare function createAlertManager(options: AlertManagerOptions): AlertManager;
+declare function createAlertManager<TMetrics extends JsonObject = JsonObject, TChannels extends AlertChannelMap = Record<string, GenericAlertChannel>>(options: AlertManagerOptions<TMetrics, TChannels>): AlertManager<TMetrics, TChannels>;
 
 /**
  * Audit logging for compliance and tracking
@@ -5548,4 +5591,4 @@ declare function renderTemplate(template: string, options: RenderTemplateOptions
  */
 declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | Record<string, any>, promptsDir?: string): string;
 
-export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DevelopmentPresetOptions, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketHandlerOptions, type WebSocketMessage, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };
+export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DevelopmentPresetOptions, type EmailAlertChannel, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type GenericAlertChannel, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type JsonObject, type JsonPrimitive, type JsonValue, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SlackAlertChannel, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketHandlerOptions, type WebSocketMessage, type WebhookAlertChannel, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };

package/dist/index.js

@@ -771,7 +771,7 @@ var LoggerImpl = class _LoggerImpl {
     if (this.options.includeContext && Object.keys(this.context).length > 0) {
       entry.context = this.context;
     }
-    if (data) {
+    if (data !== void 0) {
       entry.data = data;
     }
     const output = this.format(entry);
@@ -791,7 +791,7 @@ var LoggerImpl = class _LoggerImpl {
     if (entry.context) {
       parts.push(`context=${JSON.stringify(entry.context)}`);
     }
-    if (entry.data) {
+    if (entry.data !== void 0) {
       parts.push(`data=${JSON.stringify(entry.data)}`);
     }
     return parts.join(" ");
@@ -1124,7 +1124,7 @@ var ToolRegistry = class {
           logger.error("Event handler error", {
             event,
             error: error instanceof Error ? error.message : String(error),
-            stack: error instanceof Error ? error.stack : void 0
+            ...error instanceof Error && error.stack ? { stack: error.stack } : {}
           });
         }
       });
@@ -1591,7 +1591,7 @@ var ManagedTool = class {
           (err) => logger3.error("Cleanup failed", {
             toolName: this.name,
             error: err instanceof Error ? err.message : String(err),
-            stack: err instanceof Error ? err.stack : void 0
+            ...err instanceof Error && err.stack ? { stack: err.stack } : {}
           })
         );
       });
@@ -2651,7 +2651,7 @@ var withLogging = (options) => {
         if (logErrors) {
           logger5.error(`Node execution failed (${duration}ms)`, {
             error: err.message,
-            stack: err.stack
+            ...err.stack ? { stack: err.stack } : {}
           });
         }
         if (onError) {
@@ -5099,6 +5099,40 @@ function createProfiler(options) {
 
 // src/monitoring/alerts.ts
 var logger4 = createLogger("agentforge:core:monitoring:alerts", { level: "info" /* INFO */ });
+function toAlertSummary(alert) {
+  return {
+    name: alert.name,
+    severity: alert.severity,
+    message: alert.message
+  };
+}
+function toRuleErrorPayload(ruleName, error) {
+  return {
+    ruleName,
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
+function toAlertDispatchErrorPayload(ruleName, error) {
+  return {
+    stage: "alert-dispatch",
+    ...toRuleErrorPayload(ruleName, error)
+  };
+}
+function toAlertCallbackErrorPayload(error) {
+  return {
+    stage: "alert-callback",
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
+function toMetricsProviderErrorPayload(error) {
+  return {
+    stage: "metrics-provider",
+    error: error instanceof Error ? error.message : String(error),
+    ...error instanceof Error && error.stack ? { stack: error.stack } : {}
+  };
+}
 var AlertManager = class {
   constructor(options) {
     this.options = options;
@@ -5112,8 +5146,12 @@ var AlertManager = class {
     }
     this.running = true;
     this.monitorTimer = setInterval(() => {
-      const currentMetrics = metrics();
-      this.checkRules(currentMetrics);
+      try {
+        const currentMetrics = metrics();
+        this.checkRules(currentMetrics);
+      } catch (error) {
+        logger4.error("Metrics collection failed", toMetricsProviderErrorPayload(error));
+      }
     }, interval);
   }
   stop() {
@@ -5129,18 +5167,22 @@ var AlertManager = class {
   async alert(alert) {
     const fullAlert = {
       ...alert,
-      timestamp: alert.timestamp || Date.now()
+      timestamp: alert.timestamp ?? Date.now()
     };
     if (this.isThrottled(alert.name)) {
       return;
     }
     this.lastAlertTime.set(alert.name, Date.now());
-    this.options.onAlert?.(fullAlert);
+    try {
+      await this.options.onAlert?.(fullAlert);
+    } catch (error) {
+      logger4.error("Alert callback failed", toAlertCallbackErrorPayload(error));
+    }
     logger4.warn("Alert triggered", {
       name: alert.name,
       severity: alert.severity,
       message: alert.message,
-      data: alert.data
+      ...alert.data ? { data: alert.data } : {}
     });
   }
   checkRules(metrics) {
@@ -5150,19 +5192,17 @@ var AlertManager = class {
     for (const rule of this.options.rules) {
       try {
         if (rule.condition(metrics)) {
-          this.alert({
+          void this.alert({
             name: rule.name,
             severity: rule.severity,
             message: rule.message || `Alert triggered: ${rule.name}`,
             data: { metrics }
+          }).catch((error) => {
+            logger4.error("Alert dispatch failed", toAlertDispatchErrorPayload(rule.name, error));
           });
         }
       } catch (error) {
-        logger4.error("Rule check failed", {
-          ruleName: rule.name,
-          error: error instanceof Error ? error.message : String(error),
-          stack: error instanceof Error ? error.stack : void 0
-        });
+        logger4.error("Rule check failed", toRuleErrorPayload(rule.name, error));
       }
     }
   }
@@ -5187,32 +5227,32 @@ var AlertManager = class {
         logger4.info("Alert sent to email", {
           channel: channelName,
           to: channel.config.to,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       case "slack":
         logger4.info("Alert sent to Slack", {
           channel: channelName,
           webhookUrl: channel.config.webhookUrl,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       case "webhook":
         logger4.info("Alert sent to webhook", {
           channel: channelName,
           url: channel.config.url,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
         break;
       default:
         logger4.info("Alert sent", {
           channel: channelName,
           channelType: channel.type,
-          alert: { name: alert.name, severity: alert.severity, message: alert.message }
+          alert: toAlertSummary(alert)
         });
     }
   }
-  getAlertHistory(name, limit = 100) {
+  getAlertHistory(_name, _limit = 100) {
     return [];
   }
   clearAlertHistory(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/core",
-  "version": "0.15.8",
+  "version": "0.15.9",
   "description": "Production-ready TypeScript agent framework built on LangGraph with orchestration, middleware, and typed abstractions.",
   "type": "module",
   "main": "./dist/index.cjs",