@agentforge/core 0.16.69 → 0.16.71

package/dist/index.cjs

@@ -143,6 +143,7 @@ __export(index_exports, {
   reduce: () => reduce,
   renderTemplate: () => renderTemplate,
   retry: () => retry,
+  runMockExecution: () => runMockExecution,
   safeValidateSchemaDescriptions: () => safeValidateSchemaDescriptions,
   sanitizeValue: () => sanitizeValue,
   sendMessage: () => sendMessage,
@@ -1947,6 +1948,36 @@ function cache(tool, ttl) {
   };
 }
 
+// src/tools/testing-runtime.ts
+function resolveLatency(latency) {
+  if (typeof latency === "function") {
+    return latency();
+  }
+  if (typeof latency === "number") {
+    return latency;
+  }
+  if (latency) {
+    return Math.random() * (latency.max - latency.min) + latency.min;
+  }
+  return 0;
+}
+function shouldThrowMockError(shouldError, input) {
+  if (typeof shouldError === "function") {
+    return shouldError(input);
+  }
+  return shouldError ?? false;
+}
+async function runMockExecution(input, execute, options = {}) {
+  const delay = resolveLatency(options.latency);
+  if (delay > 0) {
+    await new Promise((resolve) => setTimeout(resolve, delay));
+  }
+  if (shouldThrowMockError(options.shouldError, input)) {
+    throw options.errorFactory?.(input) ?? new Error("Mock tool error");
+  }
+  return Promise.resolve(execute());
+}
+
 // src/tools/testing.ts
 function matchesMockInput(matcher, input) {
   if (typeof matcher === "function") {
@@ -1969,56 +2000,47 @@ function createMockTool(config) {
     description,
     invoke: async (input) => {
       const startTime = Date.now();
-      if (latency) {
-        const delay = typeof latency === "number" ? latency : Math.random() * (latency.max - latency.min) + latency.min;
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-      if (errorRate > 0 && Math.random() < errorRate) {
-        const error2 = new Error(`Random error from ${name}`);
-        invocations.push({
+      try {
+        const result = await runMockExecution(
           input,
-          error: error2,
-          timestamp: startTime,
-          duration: Date.now() - startTime
-        });
-        throw error2;
-      }
-      const matchingResponse = responses.find((response) => matchesMockInput(response.input, input));
-      if (matchingResponse) {
-        if (matchingResponse.error) {
-          invocations.push({
-            input,
-            error: matchingResponse.error,
-            timestamp: startTime,
-            duration: Date.now() - startTime
-          });
-          throw matchingResponse.error;
-        }
+          () => {
+            const matchingResponse = responses.find(
+              (response) => matchesMockInput(response.input, input)
+            );
+            if (matchingResponse) {
+              if (matchingResponse.error) {
+                throw matchingResponse.error;
+              }
+              return matchingResponse.output;
+            }
+            if (defaultResponse !== void 0) {
+              return defaultResponse;
+            }
+            throw new Error(`No mock response configured for input: ${JSON.stringify(input)}`);
+          },
+          {
+            latency,
+            shouldError: errorRate > 0 ? () => Math.random() < errorRate : false,
+            errorFactory: () => new Error(`Random error from ${name}`)
+          }
+        );
         invocations.push({
           input,
-          output: matchingResponse.output,
+          output: result,
           timestamp: startTime,
           duration: Date.now() - startTime
         });
-        return matchingResponse.output;
-      }
-      if (defaultResponse !== void 0) {
+        return result;
+      } catch (error) {
+        const recordedError = error instanceof Error ? error : new Error(String(error));
         invocations.push({
           input,
-          output: defaultResponse,
+          error: recordedError,
           timestamp: startTime,
           duration: Date.now() - startTime
         });
-        return defaultResponse;
+        throw recordedError;
       }
-      const error = new Error(`No mock response configured for input: ${JSON.stringify(input)}`);
-      invocations.push({
-        input,
-        error,
-        timestamp: startTime,
-        duration: Date.now() - startTime
-      });
-      throw error;
     },
     getInvocations: () => [...invocations],
     clearInvocations: () => {
@@ -2047,24 +2069,12 @@ function createToolSimulator(config) {
         throw new Error(`Tool ${toolName} not found in simulator`);
       }
       const startTime = Date.now();
-      if (latency) {
-        const delay = generateLatency();
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-      if (errorRate > 0 && Math.random() < errorRate) {
-        const error = new Error(`Simulated error from ${toolName}`);
-        if (recordInvocations) {
-          invocations.get(toolName).push({
-            input,
-            error,
-            timestamp: startTime,
-            duration: Date.now() - startTime
-          });
-        }
-        throw error;
-      }
       try {
-        const result = await tool.invoke(input);
+        const result = await runMockExecution(input, () => tool.invoke(input), {
+          latency: latency ? generateLatency : void 0,
+          shouldError: errorRate > 0 ? () => Math.random() < errorRate : false,
+          errorFactory: () => new Error(`Simulated error from ${toolName}`)
+        });
         if (recordInvocations) {
           invocations.get(toolName).push({
             input,
@@ -2075,15 +2085,16 @@ function createToolSimulator(config) {
         }
         return result;
       } catch (error) {
+        const recordedError = error instanceof Error ? error : new Error(String(error));
         if (recordInvocations) {
           invocations.get(toolName).push({
             input,
-            error,
+            error: recordedError,
             timestamp: startTime,
             duration: Date.now() - startTime
           });
         }
-        throw error;
+        throw recordedError;
       }
     },
     getInvocations: (toolName) => {
@@ -5856,6 +5867,7 @@ function loadPrompt(promptName, options = {}, promptsDir) {
   reduce,
   renderTemplate,
   retry,
+  runMockExecution,
   safeValidateSchemaDescriptions,
   sanitizeValue,
   sendMessage,

package/dist/index.d.cts

@@ -985,6 +985,16 @@ declare function createToolSimulator<const TTools extends readonly SimulatedTool
     clearInvocations: (toolName?: ToolName<TTools>) => void;
 };
 
+interface MockExecutionRuntimeOptions<TInput> {
+    latency?: number | {
+        min: number;
+        max: number;
+    } | (() => number);
+    shouldError?: boolean | ((input: TInput) => boolean);
+    errorFactory?: (input: TInput) => Error;
+}
+declare function runMockExecution<TInput, TOutput>(input: TInput, execute: () => Promise<TOutput> | TOutput, options?: MockExecutionRuntimeOptions<TInput>): Promise<TOutput>;
+
 /**
  * LangChain Integration - Tool Converter
  *
@@ -4690,4 +4700,4 @@ declare function renderTemplate(template: string, options: RenderTemplateOptions
  */
 declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, 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 CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DatabaseQueryParams, type DatabaseQueryResult, 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 PromptVariableMap, type PromptVariableValue, 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 WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, 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 };
+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 DatabaseQueryParams, type DatabaseQueryResult, 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 MockExecutionRuntimeOptions, 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 PromptVariableMap, type PromptVariableValue, 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 WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, 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, runMockExecution, 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

@@ -985,6 +985,16 @@ declare function createToolSimulator<const TTools extends readonly SimulatedTool
     clearInvocations: (toolName?: ToolName<TTools>) => void;
 };
 
+interface MockExecutionRuntimeOptions<TInput> {
+    latency?: number | {
+        min: number;
+        max: number;
+    } | (() => number);
+    shouldError?: boolean | ((input: TInput) => boolean);
+    errorFactory?: (input: TInput) => Error;
+}
+declare function runMockExecution<TInput, TOutput>(input: TInput, execute: () => Promise<TOutput> | TOutput, options?: MockExecutionRuntimeOptions<TInput>): Promise<TOutput>;
+
 /**
  * LangChain Integration - Tool Converter
  *
@@ -4690,4 +4700,4 @@ declare function renderTemplate(template: string, options: RenderTemplateOptions
  */
 declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, 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 CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DatabaseQueryParams, type DatabaseQueryResult, 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 PromptVariableMap, type PromptVariableValue, 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 WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, 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 };
+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 DatabaseQueryParams, type DatabaseQueryResult, 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 MockExecutionRuntimeOptions, 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 PromptVariableMap, type PromptVariableValue, 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 WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, 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, runMockExecution, 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

@@ -1772,6 +1772,36 @@ function cache(tool, ttl) {
   };
 }
 
+// src/tools/testing-runtime.ts
+function resolveLatency(latency) {
+  if (typeof latency === "function") {
+    return latency();
+  }
+  if (typeof latency === "number") {
+    return latency;
+  }
+  if (latency) {
+    return Math.random() * (latency.max - latency.min) + latency.min;
+  }
+  return 0;
+}
+function shouldThrowMockError(shouldError, input) {
+  if (typeof shouldError === "function") {
+    return shouldError(input);
+  }
+  return shouldError ?? false;
+}
+async function runMockExecution(input, execute, options = {}) {
+  const delay = resolveLatency(options.latency);
+  if (delay > 0) {
+    await new Promise((resolve) => setTimeout(resolve, delay));
+  }
+  if (shouldThrowMockError(options.shouldError, input)) {
+    throw options.errorFactory?.(input) ?? new Error("Mock tool error");
+  }
+  return Promise.resolve(execute());
+}
+
 // src/tools/testing.ts
 function matchesMockInput(matcher, input) {
   if (typeof matcher === "function") {
@@ -1794,56 +1824,47 @@ function createMockTool(config) {
     description,
     invoke: async (input) => {
       const startTime = Date.now();
-      if (latency) {
-        const delay = typeof latency === "number" ? latency : Math.random() * (latency.max - latency.min) + latency.min;
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-      if (errorRate > 0 && Math.random() < errorRate) {
-        const error2 = new Error(`Random error from ${name}`);
-        invocations.push({
+      try {
+        const result = await runMockExecution(
           input,
-          error: error2,
-          timestamp: startTime,
-          duration: Date.now() - startTime
-        });
-        throw error2;
-      }
-      const matchingResponse = responses.find((response) => matchesMockInput(response.input, input));
-      if (matchingResponse) {
-        if (matchingResponse.error) {
-          invocations.push({
-            input,
-            error: matchingResponse.error,
-            timestamp: startTime,
-            duration: Date.now() - startTime
-          });
-          throw matchingResponse.error;
-        }
+          () => {
+            const matchingResponse = responses.find(
+              (response) => matchesMockInput(response.input, input)
+            );
+            if (matchingResponse) {
+              if (matchingResponse.error) {
+                throw matchingResponse.error;
+              }
+              return matchingResponse.output;
+            }
+            if (defaultResponse !== void 0) {
+              return defaultResponse;
+            }
+            throw new Error(`No mock response configured for input: ${JSON.stringify(input)}`);
+          },
+          {
+            latency,
+            shouldError: errorRate > 0 ? () => Math.random() < errorRate : false,
+            errorFactory: () => new Error(`Random error from ${name}`)
+          }
+        );
         invocations.push({
           input,
-          output: matchingResponse.output,
+          output: result,
           timestamp: startTime,
           duration: Date.now() - startTime
         });
-        return matchingResponse.output;
-      }
-      if (defaultResponse !== void 0) {
+        return result;
+      } catch (error) {
+        const recordedError = error instanceof Error ? error : new Error(String(error));
         invocations.push({
           input,
-          output: defaultResponse,
+          error: recordedError,
           timestamp: startTime,
           duration: Date.now() - startTime
         });
-        return defaultResponse;
+        throw recordedError;
       }
-      const error = new Error(`No mock response configured for input: ${JSON.stringify(input)}`);
-      invocations.push({
-        input,
-        error,
-        timestamp: startTime,
-        duration: Date.now() - startTime
-      });
-      throw error;
     },
     getInvocations: () => [...invocations],
     clearInvocations: () => {
@@ -1872,24 +1893,12 @@ function createToolSimulator(config) {
         throw new Error(`Tool ${toolName} not found in simulator`);
       }
       const startTime = Date.now();
-      if (latency) {
-        const delay = generateLatency();
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-      if (errorRate > 0 && Math.random() < errorRate) {
-        const error = new Error(`Simulated error from ${toolName}`);
-        if (recordInvocations) {
-          invocations.get(toolName).push({
-            input,
-            error,
-            timestamp: startTime,
-            duration: Date.now() - startTime
-          });
-        }
-        throw error;
-      }
       try {
-        const result = await tool.invoke(input);
+        const result = await runMockExecution(input, () => tool.invoke(input), {
+          latency: latency ? generateLatency : void 0,
+          shouldError: errorRate > 0 ? () => Math.random() < errorRate : false,
+          errorFactory: () => new Error(`Simulated error from ${toolName}`)
+        });
         if (recordInvocations) {
           invocations.get(toolName).push({
             input,
@@ -1900,15 +1909,16 @@ function createToolSimulator(config) {
         }
         return result;
       } catch (error) {
+        const recordedError = error instanceof Error ? error : new Error(String(error));
         if (recordInvocations) {
           invocations.get(toolName).push({
             input,
-            error,
+            error: recordedError,
             timestamp: startTime,
             duration: Date.now() - startTime
           });
         }
-        throw error;
+        throw recordedError;
       }
     },
     getInvocations: (toolName) => {
@@ -5680,6 +5690,7 @@ export {
   reduce,
   renderTemplate,
   retry,
+  runMockExecution,
   safeValidateSchemaDescriptions,
   sanitizeValue,
   sendMessage,

package/package.json

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