@agentforge/core 0.15.7 → 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 } : {}
           })
         );
       });
@@ -2211,46 +2211,84 @@ function createToolSimulator(config) {
 
 // src/langgraph/state.ts
 var import_langgraph = require("@langchain/langgraph");
+function entriesOf(value) {
+  return Object.entries(value);
+}
+function keysOf(value) {
+  return Object.keys(value);
+}
+function hasOwnProperty(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function useLatestValue(_left, right) {
+  return right;
+}
+function setStateValue(target, key, value) {
+  target[key] = value;
+}
+function setStateDefinitionValue(target, key, value) {
+  target[key] = value;
+}
+function createChannel(channelConfig) {
+  if (channelConfig.reducer) {
+    return (0, import_langgraph.Annotation)({
+      reducer: channelConfig.reducer,
+      default: channelConfig.default
+    });
+  }
+  if (channelConfig.default) {
+    return (0, import_langgraph.Annotation)({
+      reducer: useLatestValue,
+      default: channelConfig.default
+    });
+  }
+  return (0, import_langgraph.Annotation)();
+}
 function createStateAnnotation(config) {
   const stateDefinition = {};
-  for (const [key, channelConfig] of Object.entries(config)) {
-    if (channelConfig.reducer) {
-      stateDefinition[key] = (0, import_langgraph.Annotation)({
-        reducer: channelConfig.reducer,
-        default: channelConfig.default
-      });
-    } else if (channelConfig.default) {
-      stateDefinition[key] = (0, import_langgraph.Annotation)({
-        reducer: (_left, right) => right,
-        default: channelConfig.default
-      });
-    } else {
-      stateDefinition[key] = (0, import_langgraph.Annotation)();
-    }
+  for (const [key, channelConfig] of entriesOf(config)) {
+    setStateDefinitionValue(
+      stateDefinition,
+      key,
+      createChannel(channelConfig)
+    );
   }
   return import_langgraph.Annotation.Root(stateDefinition);
 }
 function validateState(state, config) {
   const validated = {};
-  for (const [key, channelConfig] of Object.entries(config)) {
-    if (channelConfig.schema && key in state) {
-      validated[key] = channelConfig.schema.parse(state[key]);
-    } else if (key in state) {
-      validated[key] = state[key];
+  for (const [key, channelConfig] of entriesOf(config)) {
+    if (channelConfig.schema && hasOwnProperty(state, key)) {
+      setStateValue(
+        validated,
+        key,
+        channelConfig.schema.parse(state[key])
+      );
+    } else if (hasOwnProperty(state, key)) {
+      setStateValue(validated, key, state[key]);
     } else if (channelConfig.default) {
-      validated[key] = channelConfig.default();
+      setStateValue(validated, key, channelConfig.default());
     }
   }
   return validated;
 }
 function mergeState(currentState, update, config) {
   const merged = { ...currentState };
-  for (const [key, value] of Object.entries(update)) {
+  for (const key of keysOf(update)) {
+    const value = update[key];
     const channelConfig = config[key];
-    if (channelConfig?.reducer && key in merged) {
-      merged[key] = channelConfig.reducer(merged[key], value);
+    const reducer = channelConfig?.reducer;
+    if (reducer && hasOwnProperty(merged, key)) {
+      setStateValue(
+        merged,
+        key,
+        reducer(
+          merged[key],
+          value
+        )
+      );
     } else {
-      merged[key] = value;
+      setStateValue(merged, key, value);
     }
   }
   return merged;
@@ -2788,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) {
@@ -5236,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;
@@ -5249,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() {
@@ -5266,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) {
@@ -5287,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));
       }
     }
   }
@@ -5324,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

@@ -1,6 +1,6 @@
-import { z, ZodType, ZodTypeDef } from 'zod';
+import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, StateDefinition, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -1901,11 +1901,11 @@ declare function getToolDescription<TInput, TOutput>(tool: Tool<TInput, TOutput>
 /**
  * State channel configuration with optional Zod schema validation
  */
-interface StateChannelConfig<T = any, U = T> {
+interface StateChannelConfig<T = unknown, U = T> {
     /**
      * Optional Zod schema for runtime validation
      */
-    schema?: ZodType<T, ZodTypeDef, any>;
+    schema?: ZodType<T, ZodTypeDef, unknown>;
     /**
      * Optional reducer function for aggregating updates
      */
@@ -1919,6 +1919,52 @@ interface StateChannelConfig<T = any, U = T> {
      */
     description?: string;
 }
+type StateChannelConfigLike = {
+    schema?: ZodTypeAny;
+    reducer?: (left: never, right: never) => unknown;
+    default?: () => unknown;
+    description?: string;
+};
+type StateConfigMap = Record<string, StateChannelConfigLike>;
+type IsExact<TLeft, TRight> = [
+    TLeft
+] extends [TRight] ? ([TRight] extends [TLeft] ? true : false) : false;
+type HasReducer<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: unknown, right: unknown) => unknown;
+} ? true : false;
+type SchemaValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    schema: infer TSchema extends ZodTypeAny;
+} ? output<TSchema> : never;
+type DefaultValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    default: () => infer TValue;
+} ? TValue : never;
+type ReducerValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: infer TValue, right: unknown) => infer TResult;
+} ? IsExact<TValue, TResult> extends true ? TValue : never : never;
+type ReducerUpdate<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: unknown, right: infer TUpdate) => unknown;
+} ? TUpdate : never;
+type ChannelValue<TChannel extends StateChannelConfigLike> = HasReducer<TChannel> extends true ? ReducerValue<TChannel> : [SchemaValue<TChannel>] extends [never] ? [DefaultValue<TChannel>] extends [never] ? unknown : DefaultValue<TChannel> : SchemaValue<TChannel>;
+type ChannelUpdate<TChannel extends StateChannelConfigLike> = HasReducer<TChannel> extends true ? ReducerUpdate<TChannel> : ChannelValue<TChannel>;
+type StateShape<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]: ChannelValue<TConfig[K]>;
+};
+type StateUpdateShape<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]?: ChannelUpdate<TConfig[K]>;
+};
+type StateChannelDefinition<TChannel extends StateChannelConfigLike> = BaseChannel<ChannelValue<TChannel>, ChannelUpdate<TChannel>>;
+type StateAnnotationDefinition<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]: StateChannelDefinition<TConfig[K]>;
+};
+type DefaultedKeys<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]-?: TConfig[K] extends {
+        default: () => ChannelValue<TConfig[K]>;
+    } ? K : never;
+}[keyof TConfig];
+type InputStateKeys<TConfig extends StateConfigMap, TState> = Extract<keyof TConfig, keyof TState>;
+type ValidatedState<TConfig extends StateConfigMap, TState extends Partial<Record<keyof TConfig, unknown>>> = {
+    [K in InputStateKeys<TConfig, TState> | DefaultedKeys<TConfig>]: ChannelValue<TConfig[K]>;
+};
 /**
  * Create a type-safe state annotation with optional Zod validation
  *
@@ -1949,7 +1995,7 @@ interface StateChannelConfig<T = any, U = T> {
  * type State = typeof AgentState.State;
  * ```
  */
-declare function createStateAnnotation<T extends Record<string, StateChannelConfig>>(config: T): AnnotationRoot<StateDefinition>;
+declare function createStateAnnotation<TConfig extends StateConfigMap>(config: TConfig): AnnotationRoot<StateAnnotationDefinition<TConfig>>;
 /**
  * Validate state against Zod schemas
  *
@@ -1971,7 +2017,7 @@ declare function createStateAnnotation<T extends Record<string, StateChannelConf
  * );
  * ```
  */
-declare function validateState<T extends Record<string, StateChannelConfig>>(state: Record<string, any>, config: T): Record<string, any>;
+declare function validateState<TConfig extends StateConfigMap, TState extends Partial<Record<keyof TConfig, unknown>>>(state: TState, config: TConfig): ValidatedState<TConfig, TState>;
 /**
  * Merge state updates using configured reducers
  *
@@ -1996,7 +2042,7 @@ declare function validateState<T extends Record<string, StateChannelConfig>>(sta
  * // Result: { messages: ['a', 'b', 'c'] }
  * ```
  */
-declare function mergeState<T extends Record<string, StateChannelConfig>>(currentState: Record<string, any>, update: Record<string, any>, config: T): Record<string, any>;
+declare function mergeState<TConfig extends StateConfigMap>(currentState: Partial<StateShape<TConfig>>, update: StateUpdateShape<TConfig>, config: TConfig): Partial<StateShape<TConfig>>;
 
 /**
  * Sequential Workflow Builder
@@ -2770,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
  */
@@ -2822,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
@@ -2832,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
@@ -2857,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.
@@ -5288,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
@@ -5502,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

@@ -1,6 +1,6 @@
-import { z, ZodType, ZodTypeDef } from 'zod';
+import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { AnnotationRoot, StateDefinition, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
+import { AnnotationRoot, BaseChannel, StateGraph, END, MemorySaver, BaseCheckpointSaver, CheckpointTuple } from '@langchain/langgraph';
 import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
@@ -1901,11 +1901,11 @@ declare function getToolDescription<TInput, TOutput>(tool: Tool<TInput, TOutput>
 /**
  * State channel configuration with optional Zod schema validation
  */
-interface StateChannelConfig<T = any, U = T> {
+interface StateChannelConfig<T = unknown, U = T> {
     /**
      * Optional Zod schema for runtime validation
      */
-    schema?: ZodType<T, ZodTypeDef, any>;
+    schema?: ZodType<T, ZodTypeDef, unknown>;
     /**
      * Optional reducer function for aggregating updates
      */
@@ -1919,6 +1919,52 @@ interface StateChannelConfig<T = any, U = T> {
      */
     description?: string;
 }
+type StateChannelConfigLike = {
+    schema?: ZodTypeAny;
+    reducer?: (left: never, right: never) => unknown;
+    default?: () => unknown;
+    description?: string;
+};
+type StateConfigMap = Record<string, StateChannelConfigLike>;
+type IsExact<TLeft, TRight> = [
+    TLeft
+] extends [TRight] ? ([TRight] extends [TLeft] ? true : false) : false;
+type HasReducer<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: unknown, right: unknown) => unknown;
+} ? true : false;
+type SchemaValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    schema: infer TSchema extends ZodTypeAny;
+} ? output<TSchema> : never;
+type DefaultValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    default: () => infer TValue;
+} ? TValue : never;
+type ReducerValue<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: infer TValue, right: unknown) => infer TResult;
+} ? IsExact<TValue, TResult> extends true ? TValue : never : never;
+type ReducerUpdate<TChannel extends StateChannelConfigLike> = TChannel extends {
+    reducer: (left: unknown, right: infer TUpdate) => unknown;
+} ? TUpdate : never;
+type ChannelValue<TChannel extends StateChannelConfigLike> = HasReducer<TChannel> extends true ? ReducerValue<TChannel> : [SchemaValue<TChannel>] extends [never] ? [DefaultValue<TChannel>] extends [never] ? unknown : DefaultValue<TChannel> : SchemaValue<TChannel>;
+type ChannelUpdate<TChannel extends StateChannelConfigLike> = HasReducer<TChannel> extends true ? ReducerUpdate<TChannel> : ChannelValue<TChannel>;
+type StateShape<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]: ChannelValue<TConfig[K]>;
+};
+type StateUpdateShape<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]?: ChannelUpdate<TConfig[K]>;
+};
+type StateChannelDefinition<TChannel extends StateChannelConfigLike> = BaseChannel<ChannelValue<TChannel>, ChannelUpdate<TChannel>>;
+type StateAnnotationDefinition<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]: StateChannelDefinition<TConfig[K]>;
+};
+type DefaultedKeys<TConfig extends StateConfigMap> = {
+    [K in keyof TConfig]-?: TConfig[K] extends {
+        default: () => ChannelValue<TConfig[K]>;
+    } ? K : never;
+}[keyof TConfig];
+type InputStateKeys<TConfig extends StateConfigMap, TState> = Extract<keyof TConfig, keyof TState>;
+type ValidatedState<TConfig extends StateConfigMap, TState extends Partial<Record<keyof TConfig, unknown>>> = {
+    [K in InputStateKeys<TConfig, TState> | DefaultedKeys<TConfig>]: ChannelValue<TConfig[K]>;
+};
 /**
  * Create a type-safe state annotation with optional Zod validation
  *
@@ -1949,7 +1995,7 @@ interface StateChannelConfig<T = any, U = T> {
  * type State = typeof AgentState.State;
  * ```
  */
-declare function createStateAnnotation<T extends Record<string, StateChannelConfig>>(config: T): AnnotationRoot<StateDefinition>;
+declare function createStateAnnotation<TConfig extends StateConfigMap>(config: TConfig): AnnotationRoot<StateAnnotationDefinition<TConfig>>;
 /**
  * Validate state against Zod schemas
  *
@@ -1971,7 +2017,7 @@ declare function createStateAnnotation<T extends Record<string, StateChannelConf
  * );
  * ```
  */
-declare function validateState<T extends Record<string, StateChannelConfig>>(state: Record<string, any>, config: T): Record<string, any>;
+declare function validateState<TConfig extends StateConfigMap, TState extends Partial<Record<keyof TConfig, unknown>>>(state: TState, config: TConfig): ValidatedState<TConfig, TState>;
 /**
  * Merge state updates using configured reducers
  *
@@ -1996,7 +2042,7 @@ declare function validateState<T extends Record<string, StateChannelConfig>>(sta
  * // Result: { messages: ['a', 'b', 'c'] }
  * ```
  */
-declare function mergeState<T extends Record<string, StateChannelConfig>>(currentState: Record<string, any>, update: Record<string, any>, config: T): Record<string, any>;
+declare function mergeState<TConfig extends StateConfigMap>(currentState: Partial<StateShape<TConfig>>, update: StateUpdateShape<TConfig>, config: TConfig): Partial<StateShape<TConfig>>;
 
 /**
  * Sequential Workflow Builder
@@ -2770,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
  */
@@ -2822,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
@@ -2832,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
@@ -2857,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.
@@ -5288,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
@@ -5502,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 } : {}
           })
         );
       });
@@ -2036,46 +2036,84 @@ function createToolSimulator(config) {
 
 // src/langgraph/state.ts
 import { Annotation } from "@langchain/langgraph";
+function entriesOf(value) {
+  return Object.entries(value);
+}
+function keysOf(value) {
+  return Object.keys(value);
+}
+function hasOwnProperty(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+function useLatestValue(_left, right) {
+  return right;
+}
+function setStateValue(target, key, value) {
+  target[key] = value;
+}
+function setStateDefinitionValue(target, key, value) {
+  target[key] = value;
+}
+function createChannel(channelConfig) {
+  if (channelConfig.reducer) {
+    return Annotation({
+      reducer: channelConfig.reducer,
+      default: channelConfig.default
+    });
+  }
+  if (channelConfig.default) {
+    return Annotation({
+      reducer: useLatestValue,
+      default: channelConfig.default
+    });
+  }
+  return Annotation();
+}
 function createStateAnnotation(config) {
   const stateDefinition = {};
-  for (const [key, channelConfig] of Object.entries(config)) {
-    if (channelConfig.reducer) {
-      stateDefinition[key] = Annotation({
-        reducer: channelConfig.reducer,
-        default: channelConfig.default
-      });
-    } else if (channelConfig.default) {
-      stateDefinition[key] = Annotation({
-        reducer: (_left, right) => right,
-        default: channelConfig.default
-      });
-    } else {
-      stateDefinition[key] = Annotation();
-    }
+  for (const [key, channelConfig] of entriesOf(config)) {
+    setStateDefinitionValue(
+      stateDefinition,
+      key,
+      createChannel(channelConfig)
+    );
   }
   return Annotation.Root(stateDefinition);
 }
 function validateState(state, config) {
   const validated = {};
-  for (const [key, channelConfig] of Object.entries(config)) {
-    if (channelConfig.schema && key in state) {
-      validated[key] = channelConfig.schema.parse(state[key]);
-    } else if (key in state) {
-      validated[key] = state[key];
+  for (const [key, channelConfig] of entriesOf(config)) {
+    if (channelConfig.schema && hasOwnProperty(state, key)) {
+      setStateValue(
+        validated,
+        key,
+        channelConfig.schema.parse(state[key])
+      );
+    } else if (hasOwnProperty(state, key)) {
+      setStateValue(validated, key, state[key]);
     } else if (channelConfig.default) {
-      validated[key] = channelConfig.default();
+      setStateValue(validated, key, channelConfig.default());
     }
   }
   return validated;
 }
 function mergeState(currentState, update, config) {
   const merged = { ...currentState };
-  for (const [key, value] of Object.entries(update)) {
+  for (const key of keysOf(update)) {
+    const value = update[key];
     const channelConfig = config[key];
-    if (channelConfig?.reducer && key in merged) {
-      merged[key] = channelConfig.reducer(merged[key], value);
+    const reducer = channelConfig?.reducer;
+    if (reducer && hasOwnProperty(merged, key)) {
+      setStateValue(
+        merged,
+        key,
+        reducer(
+          merged[key],
+          value
+        )
+      );
     } else {
-      merged[key] = value;
+      setStateValue(merged, key, value);
     }
   }
   return merged;
@@ -2613,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) {
@@ -5061,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;
@@ -5074,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() {
@@ -5091,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) {
@@ -5112,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));
       }
     }
   }
@@ -5149,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.7",
+  "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",