nexus-agents 2.82.0 → 2.83.1

package/dist/{chunk-SBZVRH4S.js → chunk-JA6ON2RP.js}

@@ -10,7 +10,7 @@ import {
   getTokenEstimator,
   isRateLimitLikeError,
   ok
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-6UI4NKT4.js";
 
 // src/adapters/base-adapter.ts
 var AdapterModelError = class extends ModelError {
@@ -707,4 +707,4 @@ export {
   DEFAULT_COLLECT_STREAM_MAX_CHUNKS,
   collectStream
 };
-//# sourceMappingURL=chunk-SBZVRH4S.js.map
+//# sourceMappingURL=chunk-JA6ON2RP.js.map

package/dist/{chunk-QHL4KGNB.js → chunk-LM2S2QWO.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-6UI4NKT4.js";
 
 // src/cli-adapters/circuit-breaker-types.ts
 var CircuitErrorCode = {
@@ -353,4 +353,4 @@ export {
   CircuitBreakerRegistry,
   mapCliErrorToCategory
 };
-//# sourceMappingURL=chunk-QHL4KGNB.js.map
+//# sourceMappingURL=chunk-LM2S2QWO.js.map

package/dist/{chunk-QHL4KGNB.js.map → chunk-LM2S2QWO.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli-adapters/circuit-breaker-types.ts","../src/cli-adapters/circuit-breaker.ts"],"sourcesContent":["/**\n * nexus-agents/cli-adapters - Circuit Breaker Types\n *\n * Type definitions and error classes for the circuit breaker pattern.\n *\n * (Source: Issue #81 - Circuit breaker for CLI failures)\n */\n\nimport { NexusError, ErrorCode } from '../core/errors.js';\nimport type { CliName } from './types.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Circuit breaker states.\n */\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\n/**\n * Categories of failures for circuit breaker decisions.\n */\nexport type FailureCategory =\n  | 'timeout' // CLI didn't respond in time\n  | 'crash' // Process crashed or exited unexpectedly\n  | 'authentication' // OAuth/auth failure\n  | 'rate_limit' // Rate limit exceeded\n  | 'connection' // MCP connection failed\n  | 'unknown'; // Uncategorized failure\n\n/**\n * Configuration options for circuit breaker.\n */\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit (default: 5) */\n  readonly failureThreshold: number;\n  /** Time in ms before attempting recovery (default: 30000) */\n  readonly resetTimeoutMs: number;\n  /** Successful calls needed in half-open to close (default: 2) */\n  readonly halfOpenSuccessThreshold: number;\n  /** Whether to count timeouts as failures (default: true) */\n  readonly countTimeoutsAsFailures: boolean;\n  /** Whether to count auth failures as failures (default: false) */\n  readonly countAuthFailuresAsFailures: boolean;\n  /** Whether to count rate limit errors as failures (default: false) */\n  readonly countRateLimitsAsFailures: boolean;\n  /** Maximum number of requests allowed in half-open state (default: 3) */\n  readonly halfOpenMaxRequests: number;\n}\n\n/**\n * Circuit breaker state snapshot.\n */\nexport interface CircuitBreakerSnapshot {\n  /** Current state */\n  readonly state: CircuitState;\n  /** Total failure count since last closed */\n  readonly failureCount: number;\n  /** Success count in half-open state */\n  readonly successCount: number;\n  /** Timestamp of last failure */\n  readonly lastFailureTime: number | null;\n  /** Timestamp of last state change */\n  readonly lastStateChange: number;\n  /** Requests in current half-open window */\n  readonly halfOpenRequests: number;\n  /** Configuration */\n  readonly config: CircuitBreakerConfig;\n}\n\n/**\n * Event emitted on circuit state changes.\n */\nexport interface CircuitStateChangeEvent {\n  /** CLI name */\n  readonly cliName: CliName;\n  /** Previous state */\n  readonly previousState: CircuitState;\n  /** New state */\n  readonly newState: CircuitState;\n  /** Timestamp of change */\n  readonly timestamp: number;\n  /** Failure count at time of change */\n  readonly failureCount: number;\n  /** Reason for state change */\n  readonly reason: string;\n}\n\n/**\n * Event listener for circuit state changes.\n */\nexport type CircuitStateChangeListener = (event: CircuitStateChangeEvent) => void;\n\n/**\n * Interface for circuit breaker operations.\n */\nexport interface ICircuitBreaker {\n  /**\n   * Executes a function with circuit breaker protection.\n   */\n  execute<T>(fn: () => Promise<T>): Promise<import('../core/index.js').Result<T, CircuitError>>;\n\n  /**\n   * Gets the current circuit state.\n   */\n  getState(): CircuitState;\n\n  /**\n   * Gets a full snapshot of circuit breaker state.\n   */\n  getSnapshot(): CircuitBreakerSnapshot;\n\n  /**\n   * Manually resets the circuit breaker to closed state.\n   */\n  reset(): void;\n\n  /**\n   * Records a failure manually (for external failure detection).\n   */\n  recordFailure(category: FailureCategory): void;\n\n  /**\n   * Records a success manually (for external success detection).\n   */\n  recordSuccess(): void;\n}\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error codes specific to circuit breaker.\n */\nexport const CircuitErrorCode = {\n  CIRCUIT_OPEN: 'CIRCUIT_OPEN',\n  CIRCUIT_HALF_OPEN_REJECTED: 'CIRCUIT_HALF_OPEN_REJECTED',\n  EXECUTION_FAILED: 'EXECUTION_FAILED',\n} as const;\n\nexport type CircuitErrorCode = (typeof CircuitErrorCode)[keyof typeof CircuitErrorCode];\n\n// ============================================================================\n// Error Class\n// ============================================================================\n\n/**\n * Error thrown when circuit breaker blocks a request.\n */\nexport class CircuitError extends NexusError {\n  readonly circuitErrorCode: CircuitErrorCode;\n  readonly cliName: CliName;\n  readonly circuitState: CircuitState;\n  readonly failureCategory?: FailureCategory;\n\n  constructor(\n    message: string,\n    options: {\n      circuitErrorCode: CircuitErrorCode;\n      cliName: CliName;\n      circuitState: CircuitState;\n      failureCategory?: FailureCategory;\n      cause?: Error;\n    }\n  ) {\n    const baseOptions: { code: ErrorCode; cause?: Error; context: Record<string, unknown> } = {\n      code: ErrorCode.INTERNAL_ERROR,\n      context: {\n        circuitErrorCode: options.circuitErrorCode,\n        cliName: options.cliName,\n        circuitState: options.circuitState,\n      },\n    };\n    if (options.cause !== undefined) {\n      baseOptions.cause = options.cause;\n    }\n    if (options.failureCategory !== undefined) {\n      baseOptions.context['failureCategory'] = options.failureCategory;\n    }\n    super(message, baseOptions);\n    this.name = 'CircuitError';\n    this.circuitErrorCode = options.circuitErrorCode;\n    this.cliName = options.cliName;\n    this.circuitState = options.circuitState;\n    if (options.failureCategory !== undefined) {\n      this.failureCategory = options.failureCategory;\n    }\n  }\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\n/**\n * Default circuit breaker configuration.\n */\nexport const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeoutMs: 30_000,\n  halfOpenSuccessThreshold: 2,\n  countTimeoutsAsFailures: true,\n  countAuthFailuresAsFailures: false,\n  countRateLimitsAsFailures: true,\n  halfOpenMaxRequests: 3,\n} as const;\n\n// ============================================================================\n// Error Categorization Patterns\n// ============================================================================\n\n/**\n * Pattern matchers for categorizing errors.\n */\nconst TIMEOUT_PATTERNS = ['timeout', 'timed out'];\nconst AUTH_PATTERNS = ['auth', 'unauthorized', 'forbidden', 'oauth'];\nconst RATE_LIMIT_PATTERNS = ['rate limit', 'too many requests', '429'];\nconst CONNECTION_PATTERNS = [\n  'connection',\n  'econnrefused',\n  'enotfound',\n  'mcp',\n  'eaddrinuse',\n  'address already in use',\n];\nconst CRASH_PATTERNS = ['crash', 'exited', 'killed', 'sigterm', 'sigkill'];\n\n/**\n * Checks if text contains any of the patterns.\n */\nfunction matchesPatterns(text: string, patterns: string[]): boolean {\n  return patterns.some((pattern) => text.includes(pattern));\n}\n\n/**\n * Categorizes an error into a failure category.\n */\nexport function categorizeError(error: unknown): FailureCategory {\n  if (!(error instanceof Error)) {\n    return 'unknown';\n  }\n\n  const message = error.message.toLowerCase();\n  const name = error.name.toLowerCase();\n  const combined = `${message} ${name}`;\n\n  if (matchesPatterns(combined, TIMEOUT_PATTERNS)) return 'timeout';\n  if (matchesPatterns(combined, AUTH_PATTERNS)) return 'authentication';\n  if (matchesPatterns(combined, RATE_LIMIT_PATTERNS)) return 'rate_limit';\n  if (matchesPatterns(combined, CONNECTION_PATTERNS)) return 'connection';\n  if (matchesPatterns(combined, CRASH_PATTERNS)) return 'crash';\n\n  return 'unknown';\n}\n","/**\n * nexus-agents/cli-adapters - Circuit Breaker Implementation\n *\n * Implements the circuit breaker pattern to handle CLI failures gracefully\n * and prevent cascade failures in the multi-CLI mesh.\n *\n * (Source: Issue #81 - Circuit breaker for CLI failures)\n * (Source: Martin Fowler's Circuit Breaker pattern)\n */\n\nimport type { Result } from '../core/index.js';\nimport { getErrorMessage, err, ok, getTimeProvider } from '../core/index.js';\n\nimport type { CliName, CliErrorCode } from './types.js';\nimport {\n  CircuitError,\n  CircuitErrorCode,\n  DEFAULT_CIRCUIT_BREAKER_CONFIG,\n  categorizeError,\n  type CircuitState,\n  type FailureCategory,\n  type CircuitBreakerConfig,\n  type CircuitBreakerSnapshot,\n  type CircuitStateChangeEvent,\n  type CircuitStateChangeListener,\n  type ICircuitBreaker,\n} from './circuit-breaker-types.js';\n\n// Re-export all types for convenience\nexport {\n  CircuitError,\n  CircuitErrorCode,\n  DEFAULT_CIRCUIT_BREAKER_CONFIG,\n  categorizeError,\n  type CircuitState,\n  type FailureCategory,\n  type CircuitBreakerConfig,\n  type CircuitBreakerSnapshot,\n  type CircuitStateChangeEvent,\n  type CircuitStateChangeListener,\n  type ICircuitBreaker,\n} from './circuit-breaker-types.js';\n\n// ============================================================================\n// Circuit Breaker Implementation\n// ============================================================================\n\n/**\n * Circuit breaker implementation for CLI adapters.\n *\n * Provides protection against cascading failures by:\n * 1. Tracking failure counts\n * 2. Opening circuit when threshold exceeded\n * 3. Allowing gradual recovery through half-open state\n */\nexport class CliCircuitBreaker implements ICircuitBreaker {\n  private state: CircuitState = 'closed';\n  private failureCount = 0;\n  private successCount = 0;\n  private lastFailureTime: number | null = null;\n  private lastStateChange: number;\n  private halfOpenRequests = 0;\n  private readonly listeners: Set<CircuitStateChangeListener> = new Set();\n\n  constructor(\n    private readonly cliName: CliName,\n    private readonly config: CircuitBreakerConfig = DEFAULT_CIRCUIT_BREAKER_CONFIG\n  ) {\n    this.lastStateChange = getTimeProvider().now();\n  }\n\n  /**\n   * Executes a function with circuit breaker protection.\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<Result<T, CircuitError>> {\n    const canExecute = this.canExecute();\n    if (!canExecute.ok) {\n      return canExecute;\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return ok(result);\n    } catch (error) {\n      const category = categorizeError(error);\n      if (this.shouldCountFailure(category)) {\n        this.onFailure(category);\n      }\n      return err(this.createExecutionError(error, category));\n    }\n  }\n\n  getState(): CircuitState {\n    this.checkStateTransition();\n    return this.state;\n  }\n\n  getSnapshot(): CircuitBreakerSnapshot {\n    this.checkStateTransition();\n    return {\n      state: this.state,\n      failureCount: this.failureCount,\n      successCount: this.successCount,\n      lastFailureTime: this.lastFailureTime,\n      lastStateChange: this.lastStateChange,\n      halfOpenRequests: this.halfOpenRequests,\n      config: this.config,\n    };\n  }\n\n  reset(): void {\n    const previousState = this.state;\n    this.state = 'closed';\n    this.failureCount = 0;\n    this.successCount = 0;\n    this.lastFailureTime = null;\n    this.halfOpenRequests = 0;\n    this.lastStateChange = getTimeProvider().now();\n\n    if (previousState !== 'closed') {\n      this.emitStateChange(previousState, 'closed', 'Manual reset');\n    }\n  }\n\n  recordFailure(category: FailureCategory): void {\n    if (this.shouldCountFailure(category)) {\n      this.onFailure(category);\n    }\n  }\n\n  recordSuccess(): void {\n    this.onSuccess();\n  }\n\n  addStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.listeners.add(listener);\n  }\n\n  removeStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.listeners.delete(listener);\n  }\n\n  // -------------------------------------------------------------------------\n  // Private Methods\n  // -------------------------------------------------------------------------\n\n  private canExecute(): Result<true, CircuitError> {\n    this.checkStateTransition();\n\n    if (this.state === 'closed') {\n      return ok(true);\n    }\n\n    if (this.state === 'open') {\n      return err(\n        new CircuitError(`Circuit is open for CLI: ${this.cliName}`, {\n          circuitErrorCode: CircuitErrorCode.CIRCUIT_OPEN,\n          cliName: this.cliName,\n          circuitState: this.state,\n        })\n      );\n    }\n\n    // half-open state\n    if (this.halfOpenRequests >= this.config.halfOpenMaxRequests) {\n      return err(\n        new CircuitError(`Circuit half-open request limit reached for CLI: ${this.cliName}`, {\n          circuitErrorCode: CircuitErrorCode.CIRCUIT_HALF_OPEN_REJECTED,\n          cliName: this.cliName,\n          circuitState: this.state,\n        })\n      );\n    }\n    this.halfOpenRequests++;\n    return ok(true);\n  }\n\n  private checkStateTransition(): void {\n    if (this.state === 'open' && this.lastFailureTime !== null) {\n      const elapsed = getTimeProvider().now() - this.lastFailureTime;\n      if (elapsed >= this.config.resetTimeoutMs) {\n        this.transitionTo('half-open', 'Reset timeout elapsed');\n      }\n    }\n  }\n\n  private onSuccess(): void {\n    if (this.state === 'closed') {\n      this.failureCount = 0;\n    } else if (this.state === 'half-open') {\n      this.successCount++;\n      if (this.successCount >= this.config.halfOpenSuccessThreshold) {\n        const reason = `${String(this.successCount)} consecutive successes in half-open state`;\n        this.transitionTo('closed', reason);\n      }\n    }\n  }\n\n  private onFailure(category: FailureCategory): void {\n    this.failureCount++;\n    this.lastFailureTime = getTimeProvider().now();\n\n    if (this.state === 'closed' && this.failureCount >= this.config.failureThreshold) {\n      const reason = `Failure threshold (${String(this.config.failureThreshold)}) exceeded`;\n      this.transitionTo('open', reason);\n    } else if (this.state === 'half-open') {\n      this.transitionTo('open', `Failure during half-open recovery (category: ${category})`);\n    }\n  }\n\n  private transitionTo(newState: CircuitState, reason: string): void {\n    const previousState = this.state;\n    this.state = newState;\n    this.lastStateChange = getTimeProvider().now();\n\n    if (newState === 'closed') {\n      this.failureCount = 0;\n      this.successCount = 0;\n      this.halfOpenRequests = 0;\n    } else if (newState === 'half-open') {\n      this.successCount = 0;\n      this.halfOpenRequests = 0;\n    }\n\n    this.emitStateChange(previousState, newState, reason);\n  }\n\n  private emitStateChange(\n    previousState: CircuitState,\n    newState: CircuitState,\n    reason: string\n  ): void {\n    const event: CircuitStateChangeEvent = {\n      cliName: this.cliName,\n      previousState,\n      newState,\n      timestamp: this.lastStateChange,\n      failureCount: this.failureCount,\n      reason,\n    };\n\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch {\n        // Ignore listener errors to prevent cascade\n      }\n    }\n  }\n\n  private shouldCountFailure(category: FailureCategory): boolean {\n    if (category === 'timeout') return this.config.countTimeoutsAsFailures;\n    if (category === 'authentication') return this.config.countAuthFailuresAsFailures;\n    if (category === 'rate_limit') return this.config.countRateLimitsAsFailures;\n    return true;\n  }\n\n  private createExecutionError(error: unknown, category: FailureCategory): CircuitError {\n    const message = getErrorMessage(error);\n    const cause = error instanceof Error ? error : new Error(String(error));\n    return new CircuitError(`CLI execution failed: ${message}`, {\n      circuitErrorCode: CircuitErrorCode.EXECUTION_FAILED,\n      cliName: this.cliName,\n      circuitState: this.state,\n      failureCategory: category,\n      cause,\n    });\n  }\n}\n\n// ============================================================================\n// Registry\n// ============================================================================\n\n/**\n * Registry for managing per-CLI circuit breakers.\n */\nexport class CircuitBreakerRegistry {\n  private readonly breakers: Map<CliName, CliCircuitBreaker> = new Map();\n  private readonly globalListeners: Set<CircuitStateChangeListener> = new Set();\n\n  constructor(private readonly defaultConfig: Partial<CircuitBreakerConfig> = {}) {}\n\n  getBreaker(cliName: CliName, config?: Partial<CircuitBreakerConfig>): CliCircuitBreaker {\n    let breaker = this.breakers.get(cliName);\n\n    if (!breaker) {\n      const mergedConfig: CircuitBreakerConfig = {\n        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,\n        ...this.defaultConfig,\n        ...config,\n      };\n      breaker = new CliCircuitBreaker(cliName, mergedConfig);\n\n      for (const listener of this.globalListeners) {\n        breaker.addStateChangeListener(listener);\n      }\n\n      this.breakers.set(cliName, breaker);\n    }\n\n    return breaker;\n  }\n\n  isOpen(cliName: CliName): boolean {\n    return this.breakers.get(cliName)?.getState() === 'open';\n  }\n\n  getAllSnapshots(): Map<CliName, CircuitBreakerSnapshot> {\n    const snapshots = new Map<CliName, CircuitBreakerSnapshot>();\n    for (const [name, breaker] of this.breakers) {\n      snapshots.set(name, breaker.getSnapshot());\n    }\n    return snapshots;\n  }\n\n  resetAll(): void {\n    for (const breaker of this.breakers.values()) {\n      breaker.reset();\n    }\n  }\n\n  reset(cliName: CliName): void {\n    this.breakers.get(cliName)?.reset();\n  }\n\n  addGlobalStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.globalListeners.add(listener);\n    for (const breaker of this.breakers.values()) {\n      breaker.addStateChangeListener(listener);\n    }\n  }\n\n  removeGlobalStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.globalListeners.delete(listener);\n    for (const breaker of this.breakers.values()) {\n      breaker.removeStateChangeListener(listener);\n    }\n  }\n\n  getHealthyClis(): CliName[] {\n    const healthy: CliName[] = [];\n    for (const [name, breaker] of this.breakers) {\n      if (breaker.getState() === 'closed') {\n        healthy.push(name);\n      }\n    }\n    return healthy;\n  }\n\n  getUnhealthyClis(): CliName[] {\n    const unhealthy: CliName[] = [];\n    for (const [name, breaker] of this.breakers) {\n      const state = breaker.getState();\n      if (state === 'open' || state === 'half-open') {\n        unhealthy.push(name);\n      }\n    }\n    return unhealthy;\n  }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Maps CLI error codes to failure categories.\n */\nexport function mapCliErrorToCategory(errorCode: CliErrorCode): FailureCategory {\n  const mapping: Record<string, FailureCategory> = {\n    TIMEOUT: 'timeout',\n    NOT_AUTHENTICATED: 'authentication',\n    RATE_LIMITED: 'rate_limit',\n    CONNECTION_ERROR: 'connection',\n  };\n  return mapping[errorCode] ?? 'unknown';\n}\n\n/**\n * Creates a circuit breaker registry with metrics logging.\n */\nexport function createCircuitBreakerRegistryWithMetrics(\n  logger: { info: (message: string, context?: Record<string, unknown>) => void },\n  config?: Partial<CircuitBreakerConfig>\n): CircuitBreakerRegistry {\n  const registry = new CircuitBreakerRegistry(config);\n\n  registry.addGlobalStateChangeListener((event) => {\n    logger.info('Circuit breaker state change', {\n      cliName: event.cliName,\n      previousState: event.previousState,\n      newState: event.newState,\n      failureCount: event.failureCount,\n      reason: event.reason,\n      timestamp: new Date(event.timestamp).toISOString(),\n    });\n  });\n\n  return registry;\n}\n\n// ============================================================================\n// Capacity Monitor Integration\n// ============================================================================\n\n/**\n * Configuration for capacity monitor integration.\n */\nexport interface CapacityMonitorIntegrationConfig {\n  /** Token threshold below which to trip circuit (default: 1000) */\n  readonly criticalTokenThreshold?: number;\n  /** Provider name to CLI name mapping */\n  readonly providerToCliMapping?: Record<string, CliName>;\n}\n\nconst DEFAULT_CAPACITY_INTEGRATION_CONFIG: Required<CapacityMonitorIntegrationConfig> = {\n  criticalTokenThreshold: 1000,\n  providerToCliMapping: {\n    anthropic: 'claude',\n    openai: 'codex',\n    google: 'gemini',\n  },\n} as const;\n\n/**\n * Integrates a CapacityMonitor with CircuitBreakerRegistry to trip circuits\n * when provider capacity is critically low.\n *\n * This addresses Issue #543: Wire up onLowCapacity callback.\n *\n * @param monitor - The capacity monitor to integrate\n * @param registry - The circuit breaker registry\n * @param config - Optional configuration\n * @param logger - Optional logger for diagnostics\n * @returns Unsubscribe function to remove the callback\n *\n * @example\n * ```typescript\n * const monitor = createCapacityMonitor();\n * const registry = new CircuitBreakerRegistry();\n *\n * // Wire up capacity signals to circuit breaker\n * const unsubscribe = integrateCapacityMonitorWithCircuitBreaker(\n *   monitor,\n *   registry,\n *   { criticalTokenThreshold: 500 }\n * );\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport function integrateCapacityMonitorWithCircuitBreaker(\n  monitor: {\n    onLowCapacity: (callback: (provider: string, remaining: number) => void) => () => void;\n  },\n  registry: CircuitBreakerRegistry,\n  config?: CapacityMonitorIntegrationConfig,\n  logger?: { warn: (message: string, context?: Record<string, unknown>) => void }\n): () => void {\n  const mergedConfig = { ...DEFAULT_CAPACITY_INTEGRATION_CONFIG, ...config };\n\n  return monitor.onLowCapacity((provider: string, remaining: number) => {\n    // Map provider name to CLI name\n    const cliName = mergedConfig.providerToCliMapping[provider];\n    if (cliName === undefined) {\n      logger?.warn('Unknown provider for capacity monitoring', { provider, remaining });\n      return;\n    }\n\n    // Trip the circuit if capacity is critically low\n    // Use 'connection' category since exhausted capacity is an availability issue,\n    // not a transient rate limit (which is exempt from circuit breaker counting).\n    if (remaining < mergedConfig.criticalTokenThreshold) {\n      const breaker = registry.getBreaker(cliName);\n      breaker.recordFailure('connection');\n      logger?.warn('Circuit tripped due to low capacity', {\n        provider,\n        cliName,\n        remaining,\n        threshold: mergedConfig.criticalTokenThreshold,\n      });\n    }\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli-adapters/circuit-breaker-types.ts","../src/cli-adapters/circuit-breaker.ts"],"sourcesContent":["/**\n * nexus-agents/cli-adapters - Circuit Breaker Types\n *\n * Type definitions and error classes for the circuit breaker pattern.\n *\n * (Source: Issue #81 - Circuit breaker for CLI failures)\n */\n\nimport { NexusError, ErrorCode } from '../core/errors.js';\nimport type { CliName } from './types.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Circuit breaker states.\n */\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\n/**\n * Categories of failures for circuit breaker decisions.\n */\nexport type FailureCategory =\n  | 'timeout' // CLI didn't respond in time\n  | 'crash' // Process crashed or exited unexpectedly\n  | 'authentication' // OAuth/auth failure\n  | 'rate_limit' // Rate limit exceeded\n  | 'connection' // MCP connection failed\n  | 'unknown'; // Uncategorized failure\n\n/**\n * Configuration options for circuit breaker.\n */\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit (default: 5) */\n  readonly failureThreshold: number;\n  /** Time in ms before attempting recovery (default: 30000) */\n  readonly resetTimeoutMs: number;\n  /** Successful calls needed in half-open to close (default: 2) */\n  readonly halfOpenSuccessThreshold: number;\n  /** Whether to count timeouts as failures (default: true) */\n  readonly countTimeoutsAsFailures: boolean;\n  /** Whether to count auth failures as failures (default: false) */\n  readonly countAuthFailuresAsFailures: boolean;\n  /** Whether to count rate limit errors as failures (default: false) */\n  readonly countRateLimitsAsFailures: boolean;\n  /** Maximum number of requests allowed in half-open state (default: 3) */\n  readonly halfOpenMaxRequests: number;\n}\n\n/**\n * Circuit breaker state snapshot.\n */\nexport interface CircuitBreakerSnapshot {\n  /** Current state */\n  readonly state: CircuitState;\n  /** Total failure count since last closed */\n  readonly failureCount: number;\n  /** Success count in half-open state */\n  readonly successCount: number;\n  /** Timestamp of last failure */\n  readonly lastFailureTime: number | null;\n  /** Timestamp of last state change */\n  readonly lastStateChange: number;\n  /** Requests in current half-open window */\n  readonly halfOpenRequests: number;\n  /** Configuration */\n  readonly config: CircuitBreakerConfig;\n}\n\n/**\n * Event emitted on circuit state changes.\n */\nexport interface CircuitStateChangeEvent {\n  /** CLI name */\n  readonly cliName: CliName;\n  /** Previous state */\n  readonly previousState: CircuitState;\n  /** New state */\n  readonly newState: CircuitState;\n  /** Timestamp of change */\n  readonly timestamp: number;\n  /** Failure count at time of change */\n  readonly failureCount: number;\n  /** Reason for state change */\n  readonly reason: string;\n}\n\n/**\n * Event listener for circuit state changes.\n */\nexport type CircuitStateChangeListener = (event: CircuitStateChangeEvent) => void;\n\n/**\n * Interface for circuit breaker operations.\n */\nexport interface ICircuitBreaker {\n  /**\n   * Executes a function with circuit breaker protection.\n   */\n  execute<T>(fn: () => Promise<T>): Promise<import('../core/index.js').Result<T, CircuitError>>;\n\n  /**\n   * Gets the current circuit state.\n   */\n  getState(): CircuitState;\n\n  /**\n   * Gets a full snapshot of circuit breaker state.\n   */\n  getSnapshot(): CircuitBreakerSnapshot;\n\n  /**\n   * Manually resets the circuit breaker to closed state.\n   */\n  reset(): void;\n\n  /**\n   * Records a failure manually (for external failure detection).\n   */\n  recordFailure(category: FailureCategory): void;\n\n  /**\n   * Records a success manually (for external success detection).\n   */\n  recordSuccess(): void;\n}\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\n/**\n * Error codes specific to circuit breaker.\n */\nexport const CircuitErrorCode = {\n  CIRCUIT_OPEN: 'CIRCUIT_OPEN',\n  CIRCUIT_HALF_OPEN_REJECTED: 'CIRCUIT_HALF_OPEN_REJECTED',\n  EXECUTION_FAILED: 'EXECUTION_FAILED',\n} as const;\n\nexport type CircuitErrorCode = (typeof CircuitErrorCode)[keyof typeof CircuitErrorCode];\n\n// ============================================================================\n// Error Class\n// ============================================================================\n\n/**\n * Error thrown when circuit breaker blocks a request.\n */\nexport class CircuitError extends NexusError {\n  readonly circuitErrorCode: CircuitErrorCode;\n  readonly cliName: CliName;\n  readonly circuitState: CircuitState;\n  readonly failureCategory?: FailureCategory;\n\n  constructor(\n    message: string,\n    options: {\n      circuitErrorCode: CircuitErrorCode;\n      cliName: CliName;\n      circuitState: CircuitState;\n      failureCategory?: FailureCategory;\n      cause?: Error;\n    }\n  ) {\n    const baseOptions: { code: ErrorCode; cause?: Error; context: Record<string, unknown> } = {\n      code: ErrorCode.INTERNAL_ERROR,\n      context: {\n        circuitErrorCode: options.circuitErrorCode,\n        cliName: options.cliName,\n        circuitState: options.circuitState,\n      },\n    };\n    if (options.cause !== undefined) {\n      baseOptions.cause = options.cause;\n    }\n    if (options.failureCategory !== undefined) {\n      baseOptions.context['failureCategory'] = options.failureCategory;\n    }\n    super(message, baseOptions);\n    this.name = 'CircuitError';\n    this.circuitErrorCode = options.circuitErrorCode;\n    this.cliName = options.cliName;\n    this.circuitState = options.circuitState;\n    if (options.failureCategory !== undefined) {\n      this.failureCategory = options.failureCategory;\n    }\n  }\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\n/**\n * Default circuit breaker configuration.\n */\nexport const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeoutMs: 30_000,\n  halfOpenSuccessThreshold: 2,\n  countTimeoutsAsFailures: true,\n  countAuthFailuresAsFailures: false,\n  countRateLimitsAsFailures: true,\n  halfOpenMaxRequests: 3,\n} as const;\n\n// ============================================================================\n// Error Categorization Patterns\n// ============================================================================\n\n/**\n * Pattern matchers for categorizing errors.\n */\nconst TIMEOUT_PATTERNS = ['timeout', 'timed out'];\nconst AUTH_PATTERNS = ['auth', 'unauthorized', 'forbidden', 'oauth'];\nconst RATE_LIMIT_PATTERNS = ['rate limit', 'too many requests', '429'];\nconst CONNECTION_PATTERNS = [\n  'connection',\n  'econnrefused',\n  'enotfound',\n  'mcp',\n  'eaddrinuse',\n  'address already in use',\n];\nconst CRASH_PATTERNS = ['crash', 'exited', 'killed', 'sigterm', 'sigkill'];\n\n/**\n * Checks if text contains any of the patterns.\n */\nfunction matchesPatterns(text: string, patterns: string[]): boolean {\n  return patterns.some((pattern) => text.includes(pattern));\n}\n\n/**\n * Categorizes an error into a failure category.\n */\nexport function categorizeError(error: unknown): FailureCategory {\n  if (!(error instanceof Error)) {\n    return 'unknown';\n  }\n\n  const message = error.message.toLowerCase();\n  const name = error.name.toLowerCase();\n  const combined = `${message} ${name}`;\n\n  if (matchesPatterns(combined, TIMEOUT_PATTERNS)) return 'timeout';\n  if (matchesPatterns(combined, AUTH_PATTERNS)) return 'authentication';\n  if (matchesPatterns(combined, RATE_LIMIT_PATTERNS)) return 'rate_limit';\n  if (matchesPatterns(combined, CONNECTION_PATTERNS)) return 'connection';\n  if (matchesPatterns(combined, CRASH_PATTERNS)) return 'crash';\n\n  return 'unknown';\n}\n","/**\n * nexus-agents/cli-adapters - Circuit Breaker Implementation\n *\n * Implements the circuit breaker pattern to handle CLI failures gracefully\n * and prevent cascade failures in the multi-CLI mesh.\n *\n * (Source: Issue #81 - Circuit breaker for CLI failures)\n * (Source: Martin Fowler's Circuit Breaker pattern)\n */\n\nimport type { Result } from '../core/index.js';\nimport { getErrorMessage, err, ok, getTimeProvider } from '../core/index.js';\n\nimport type { CliName, CliErrorCode } from './types.js';\nimport {\n  CircuitError,\n  CircuitErrorCode,\n  DEFAULT_CIRCUIT_BREAKER_CONFIG,\n  categorizeError,\n  type CircuitState,\n  type FailureCategory,\n  type CircuitBreakerConfig,\n  type CircuitBreakerSnapshot,\n  type CircuitStateChangeEvent,\n  type CircuitStateChangeListener,\n  type ICircuitBreaker,\n} from './circuit-breaker-types.js';\n\n// Re-export all types for convenience\nexport {\n  CircuitError,\n  CircuitErrorCode,\n  DEFAULT_CIRCUIT_BREAKER_CONFIG,\n  categorizeError,\n  type CircuitState,\n  type FailureCategory,\n  type CircuitBreakerConfig,\n  type CircuitBreakerSnapshot,\n  type CircuitStateChangeEvent,\n  type CircuitStateChangeListener,\n  type ICircuitBreaker,\n} from './circuit-breaker-types.js';\n\n// ============================================================================\n// Circuit Breaker Implementation\n// ============================================================================\n\n/**\n * Circuit breaker implementation for CLI adapters.\n *\n * Provides protection against cascading failures by:\n * 1. Tracking failure counts\n * 2. Opening circuit when threshold exceeded\n * 3. Allowing gradual recovery through half-open state\n */\nexport class CliCircuitBreaker implements ICircuitBreaker {\n  private state: CircuitState = 'closed';\n  private failureCount = 0;\n  private successCount = 0;\n  private lastFailureTime: number | null = null;\n  private lastStateChange: number;\n  private halfOpenRequests = 0;\n  private readonly listeners: Set<CircuitStateChangeListener> = new Set();\n\n  constructor(\n    private readonly cliName: CliName,\n    private readonly config: CircuitBreakerConfig = DEFAULT_CIRCUIT_BREAKER_CONFIG\n  ) {\n    this.lastStateChange = getTimeProvider().now();\n  }\n\n  /**\n   * Executes a function with circuit breaker protection.\n   */\n  async execute<T>(fn: () => Promise<T>): Promise<Result<T, CircuitError>> {\n    const canExecute = this.canExecute();\n    if (!canExecute.ok) {\n      return canExecute;\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return ok(result);\n    } catch (error) {\n      const category = categorizeError(error);\n      if (this.shouldCountFailure(category)) {\n        this.onFailure(category);\n      }\n      return err(this.createExecutionError(error, category));\n    }\n  }\n\n  getState(): CircuitState {\n    this.checkStateTransition();\n    return this.state;\n  }\n\n  getSnapshot(): CircuitBreakerSnapshot {\n    this.checkStateTransition();\n    return {\n      state: this.state,\n      failureCount: this.failureCount,\n      successCount: this.successCount,\n      lastFailureTime: this.lastFailureTime,\n      lastStateChange: this.lastStateChange,\n      halfOpenRequests: this.halfOpenRequests,\n      config: this.config,\n    };\n  }\n\n  reset(): void {\n    const previousState = this.state;\n    this.state = 'closed';\n    this.failureCount = 0;\n    this.successCount = 0;\n    this.lastFailureTime = null;\n    this.halfOpenRequests = 0;\n    this.lastStateChange = getTimeProvider().now();\n\n    if (previousState !== 'closed') {\n      this.emitStateChange(previousState, 'closed', 'Manual reset');\n    }\n  }\n\n  recordFailure(category: FailureCategory): void {\n    if (this.shouldCountFailure(category)) {\n      this.onFailure(category);\n    }\n  }\n\n  recordSuccess(): void {\n    this.onSuccess();\n  }\n\n  addStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.listeners.add(listener);\n  }\n\n  removeStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.listeners.delete(listener);\n  }\n\n  // -------------------------------------------------------------------------\n  // Private Methods\n  // -------------------------------------------------------------------------\n\n  private canExecute(): Result<true, CircuitError> {\n    this.checkStateTransition();\n\n    if (this.state === 'closed') {\n      return ok(true);\n    }\n\n    if (this.state === 'open') {\n      return err(\n        new CircuitError(`Circuit is open for CLI: ${this.cliName}`, {\n          circuitErrorCode: CircuitErrorCode.CIRCUIT_OPEN,\n          cliName: this.cliName,\n          circuitState: this.state,\n        })\n      );\n    }\n\n    // half-open state\n    if (this.halfOpenRequests >= this.config.halfOpenMaxRequests) {\n      return err(\n        new CircuitError(`Circuit half-open request limit reached for CLI: ${this.cliName}`, {\n          circuitErrorCode: CircuitErrorCode.CIRCUIT_HALF_OPEN_REJECTED,\n          cliName: this.cliName,\n          circuitState: this.state,\n        })\n      );\n    }\n    this.halfOpenRequests++;\n    return ok(true);\n  }\n\n  private checkStateTransition(): void {\n    if (this.state === 'open' && this.lastFailureTime !== null) {\n      const elapsed = getTimeProvider().now() - this.lastFailureTime;\n      if (elapsed >= this.config.resetTimeoutMs) {\n        this.transitionTo('half-open', 'Reset timeout elapsed');\n      }\n    }\n  }\n\n  private onSuccess(): void {\n    if (this.state === 'closed') {\n      this.failureCount = 0;\n    } else if (this.state === 'half-open') {\n      this.successCount++;\n      if (this.successCount >= this.config.halfOpenSuccessThreshold) {\n        const reason = `${String(this.successCount)} consecutive successes in half-open state`;\n        this.transitionTo('closed', reason);\n      }\n    }\n  }\n\n  private onFailure(category: FailureCategory): void {\n    this.failureCount++;\n    this.lastFailureTime = getTimeProvider().now();\n\n    if (this.state === 'closed' && this.failureCount >= this.config.failureThreshold) {\n      const reason = `Failure threshold (${String(this.config.failureThreshold)}) exceeded`;\n      this.transitionTo('open', reason);\n    } else if (this.state === 'half-open') {\n      this.transitionTo('open', `Failure during half-open recovery (category: ${category})`);\n    }\n  }\n\n  private transitionTo(newState: CircuitState, reason: string): void {\n    const previousState = this.state;\n    this.state = newState;\n    this.lastStateChange = getTimeProvider().now();\n\n    if (newState === 'closed') {\n      this.failureCount = 0;\n      this.successCount = 0;\n      this.halfOpenRequests = 0;\n    } else if (newState === 'half-open') {\n      this.successCount = 0;\n      this.halfOpenRequests = 0;\n    }\n\n    this.emitStateChange(previousState, newState, reason);\n  }\n\n  private emitStateChange(\n    previousState: CircuitState,\n    newState: CircuitState,\n    reason: string\n  ): void {\n    const event: CircuitStateChangeEvent = {\n      cliName: this.cliName,\n      previousState,\n      newState,\n      timestamp: this.lastStateChange,\n      failureCount: this.failureCount,\n      reason,\n    };\n\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch {\n        // Ignore listener errors to prevent cascade\n      }\n    }\n  }\n\n  private shouldCountFailure(category: FailureCategory): boolean {\n    if (category === 'timeout') return this.config.countTimeoutsAsFailures;\n    if (category === 'authentication') return this.config.countAuthFailuresAsFailures;\n    if (category === 'rate_limit') return this.config.countRateLimitsAsFailures;\n    return true;\n  }\n\n  private createExecutionError(error: unknown, category: FailureCategory): CircuitError {\n    const message = getErrorMessage(error);\n    const cause = error instanceof Error ? error : new Error(String(error));\n    return new CircuitError(`CLI execution failed: ${message}`, {\n      circuitErrorCode: CircuitErrorCode.EXECUTION_FAILED,\n      cliName: this.cliName,\n      circuitState: this.state,\n      failureCategory: category,\n      cause,\n    });\n  }\n}\n\n// ============================================================================\n// Registry\n// ============================================================================\n\n/**\n * Registry for managing per-CLI circuit breakers.\n */\nexport class CircuitBreakerRegistry {\n  private readonly breakers: Map<CliName, CliCircuitBreaker> = new Map();\n  private readonly globalListeners: Set<CircuitStateChangeListener> = new Set();\n\n  constructor(private readonly defaultConfig: Partial<CircuitBreakerConfig> = {}) {}\n\n  getBreaker(cliName: CliName, config?: Partial<CircuitBreakerConfig>): CliCircuitBreaker {\n    let breaker = this.breakers.get(cliName);\n\n    if (!breaker) {\n      const mergedConfig: CircuitBreakerConfig = {\n        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,\n        ...this.defaultConfig,\n        ...config,\n      };\n      breaker = new CliCircuitBreaker(cliName, mergedConfig);\n\n      for (const listener of this.globalListeners) {\n        breaker.addStateChangeListener(listener);\n      }\n\n      this.breakers.set(cliName, breaker);\n    }\n\n    return breaker;\n  }\n\n  isOpen(cliName: CliName): boolean {\n    return this.breakers.get(cliName)?.getState() === 'open';\n  }\n\n  getAllSnapshots(): Map<CliName, CircuitBreakerSnapshot> {\n    const snapshots = new Map<CliName, CircuitBreakerSnapshot>();\n    for (const [name, breaker] of this.breakers) {\n      snapshots.set(name, breaker.getSnapshot());\n    }\n    return snapshots;\n  }\n\n  resetAll(): void {\n    for (const breaker of this.breakers.values()) {\n      breaker.reset();\n    }\n  }\n\n  reset(cliName: CliName): void {\n    this.breakers.get(cliName)?.reset();\n  }\n\n  addGlobalStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.globalListeners.add(listener);\n    for (const breaker of this.breakers.values()) {\n      breaker.addStateChangeListener(listener);\n    }\n  }\n\n  removeGlobalStateChangeListener(listener: CircuitStateChangeListener): void {\n    this.globalListeners.delete(listener);\n    for (const breaker of this.breakers.values()) {\n      breaker.removeStateChangeListener(listener);\n    }\n  }\n\n  getHealthyClis(): CliName[] {\n    const healthy: CliName[] = [];\n    for (const [name, breaker] of this.breakers) {\n      if (breaker.getState() === 'closed') {\n        healthy.push(name);\n      }\n    }\n    return healthy;\n  }\n\n  getUnhealthyClis(): CliName[] {\n    const unhealthy: CliName[] = [];\n    for (const [name, breaker] of this.breakers) {\n      const state = breaker.getState();\n      if (state === 'open' || state === 'half-open') {\n        unhealthy.push(name);\n      }\n    }\n    return unhealthy;\n  }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Maps CLI error codes to failure categories.\n */\nexport function mapCliErrorToCategory(errorCode: CliErrorCode): FailureCategory {\n  const mapping: Record<string, FailureCategory> = {\n    TIMEOUT: 'timeout',\n    NOT_AUTHENTICATED: 'authentication',\n    RATE_LIMITED: 'rate_limit',\n    CONNECTION_ERROR: 'connection',\n  };\n  return mapping[errorCode] ?? 'unknown';\n}\n\n// `createCircuitBreakerRegistryWithMetrics` and the\n// `Capacity Monitor Integration` section\n// (`integrateCapacityMonitorWithCircuitBreaker` + the\n// `CapacityMonitorIntegrationConfig` interface and its default config)\n// were removed in #3018 — both had only test-file callers in the tree.\n// The `CircuitBreakerRegistry` above is what production adapters use;\n// if metrics-logging or capacity-monitor integration come back as real\n// requirements, reintroduce them alongside the consumer code in the\n// same PR (activation-or-delete YAGNI — same pattern as #2937–#2940).\n"],"mappings":"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","names":[]}

package/dist/{chunk-C7P2HLJX.js → chunk-MATFDJRW.js}

@@ -1,14 +1,14 @@
 import {
   resolveToken
-} from "./chunk-G2DZBEMU.js";
+} from "./chunk-XODXYOFN.js";
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-PZESEBD3.js";
+} from "./chunk-ZLGU7T6J.js";
 import {
   err,
   ok
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-6UI4NKT4.js";
 
 // src/scm/factory.ts
 async function createScmProvider(config) {
@@ -41,4 +41,4 @@ export {
   createScmProvider,
   createGitHubProvider
 };
-//# sourceMappingURL=chunk-C7P2HLJX.js.map
+//# sourceMappingURL=chunk-MATFDJRW.js.map

package/dist/{chunk-XGUDCUMB.js → chunk-O3XJLOEX.js}

@@ -2,7 +2,7 @@ import {
   TASK_CATEGORIES,
   getAdaptiveBonus,
   getOutcomeStore
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-6UI4NKT4.js";
 
 // src/cli/doctor-deep.ts
 var CLI_NAMES = ["claude", "gemini", "codex", "opencode"];
@@ -106,4 +106,4 @@ export {
   runDeepDiagnostics,
   formatDeepDiagnostics
 };
-//# sourceMappingURL=chunk-XGUDCUMB.js.map
+//# sourceMappingURL=chunk-O3XJLOEX.js.map

package/dist/{chunk-FTT2IYYX.js → chunk-ODKIRXN7.js}

@@ -1,24 +1,24 @@
-import {
-  CUSTOM_API_BASE_URL_ENV,
-  PROVIDER_ENV_KEYS,
-  validateCustomApiBaseUrl
-} from "./chunk-NTLJ3INA.js";
 import {
   AdapterModelError,
   BaseAdapter,
   createStream,
   requireApiKey,
   validateApiKeyPresence
-} from "./chunk-SBZVRH4S.js";
+} from "./chunk-JA6ON2RP.js";
+import {
+  CUSTOM_API_BASE_URL_ENV,
+  PROVIDER_ENV_KEYS,
+  validateCustomApiBaseUrl
+} from "./chunk-6XRNFLPI.js";
 import {
   getToolMemory
-} from "./chunk-U7JXQSEM.js";
+} from "./chunk-7V367KT4.js";
 import {
   getDefaultAvailableModelsCache
-} from "./chunk-WUUEKFKG.js";
+} from "./chunk-VXIHHHLQ.js";
 import {
   CUSTOM_API_DEFAULT_MODEL
-} from "./chunk-SHWGK7X6.js";
+} from "./chunk-DWOSFYI2.js";
 import {
   createCliAdapter,
   createCliDetectionCache,
@@ -27,7 +27,7 @@ import {
   isCliAvailable,
   sanitizeOutput,
   withTimeout
-} from "./chunk-2SQXJQTA.js";
+} from "./chunk-ELRNVADA.js";
 import {
   AgentError,
   CACHE_TIMEOUTS,
@@ -70,7 +70,7 @@ import {
   resolveCliAlias,
   resolveVoteTimeout,
   toRateLimitError
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-6UI4NKT4.js";
 import {
   ensureLearningDir,
   getNexusDataDir,
@@ -1345,11 +1345,15 @@ function toSdkCallback(handler) {
 }
 var MCP_SDK_DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
 var TIMEOUT_MISMATCH_TELEMETRY_REL_PATH = "mcp-telemetry/timeout-mismatch-events.jsonl";
+var ensuredDirs = /* @__PURE__ */ new Set();
 function appendTimeoutMismatchEvent(event) {
   try {
     const path = join(getNexusDataDir(), TIMEOUT_MISMATCH_TELEMETRY_REL_PATH);
     const dir = dirname(path);
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+    if (!ensuredDirs.has(dir)) {
+      if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+      ensuredDirs.add(dir);
+    }
     appendFileSync(path, JSON.stringify(event) + "\n", "utf-8");
   } catch (err2) {
     wrapperLogger.debug("Best-effort timeout-mismatch event recording failed", {
@@ -3635,12 +3639,24 @@ async function pickFallback(retiredModelId, cache, registry) {
 }
 function wrapResilientWithFallback(inner, options = {}) {
   const wrapped = withModelNotFoundFallback(inner, options);
-  return Object.assign(wrapped, {
+  const surface = {
     getHealth: inner.getHealth.bind(inner),
     refresh: inner.refresh.bind(inner),
     setPreferredCli: inner.setPreferredCli.bind(inner),
     onFailover: inner.onFailover.bind(inner),
     dispose: inner.dispose.bind(inner)
+  };
+  const explicit = Object.assign(wrapped, surface);
+  const innerAsRecord = inner;
+  return new Proxy(explicit, {
+    get(target, prop, receiver) {
+      if (prop in target) return Reflect.get(target, prop, receiver);
+      const innerProp = innerAsRecord[prop];
+      if (typeof innerProp === "function") {
+        return innerProp.bind(inner);
+      }
+      return innerProp;
+    }
   });
 }
 
@@ -8114,31 +8130,6 @@ var PersistentOutcomeStore = class extends OutcomeStore {
 };
 registerPersistentOutcomeStoreFactory(() => new PersistentOutcomeStore());
 
-// src/orchestration/outcomes/learning-events.ts
-function emitThresholdUpdate(bus, detail) {
-  const event = {
-    type: "learning.threshold_updated",
-    timestamp: Date.now(),
-    cli: detail.cli,
-    category: detail.category,
-    oldBaseline: detail.oldBaseline,
-    newBaseline: detail.newBaseline,
-    trend: detail.trend
-  };
-  bus.emit(event);
-}
-function emitTrendDetected(bus, detail) {
-  const event = {
-    type: "learning.trend_detected",
-    timestamp: Date.now(),
-    cli: detail.cli,
-    category: detail.category,
-    trend: detail.trend,
-    confidence: detail.confidence
-  };
-  bus.emit(event);
-}
-
 // src/mcp/tools/consensus-vote-recording.ts
 var logger7 = createLogger({ tool: "consensus-vote" });
 function recordVoteSuccess(proposal, strategy, outcome, duration, votes) {
@@ -8705,7 +8696,7 @@ async function processVotesWithCascade(engineVotes, opts) {
 var CONTRARIAN_ESCALATION_THRESHOLD = 0.8;
 async function runContrarianCheck(proposal, log) {
   try {
-    const { executeExpert } = await import("./expert-bridge-DJM5GAWZ.js");
+    const { executeExpert } = await import("./expert-bridge-7LPGCPPR.js");
     const prompt = [
       "You are a contrarian analyst. Your job is to find reasons this proposal should be REJECTED.",
       "Look for: YAGNI (not needed), MISALIGNED (wrong tech/architecture), SECURITY_RISK, SCOPE_CREEP.",
@@ -8733,7 +8724,9 @@ async function runContrarianCheck(proposal, log) {
       return { shouldEscalate: true, reason: reasoning, confidence };
     }
     return { shouldEscalate: false, reason: "", confidence };
-  } catch {
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    log.warn("Contrarian check failed; defaulting to no escalation", { error: message });
     return { shouldEscalate: false, reason: "", confidence: 0 };
   }
 }
@@ -9051,8 +9044,6 @@ export {
   toSdkCallbackWithBudgetCheck,
   getToolAnnotations,
   PersistentOutcomeStore,
-  emitThresholdUpdate,
-  emitTrendDetected,
   DEFAULT_VOTE_TIMEOUT_MS,
   isRateLimitError,
   VOTER_ROLES,
@@ -9122,4 +9113,4 @@ export {
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-FTT2IYYX.js.map
+//# sourceMappingURL=chunk-ODKIRXN7.js.map