attocode 0.1.0 → 0.1.3

package/dist/src/providers/llm-resilience.js

@@ -0,0 +1,261 @@
+/**
+ * LLM Resilience Utility
+ *
+ * Provides semantic-level resilience for LLM calls:
+ * - Empty response detection and retry
+ * - max_tokens truncation handling with continuation
+ * - Malformed response recovery
+ * - Graceful degradation with informative errors
+ *
+ * This complements resilient-fetch.ts (network level) with application-level resilience.
+ */
+// =============================================================================
+// DEFAULT CONFIG
+// =============================================================================
+const DEFAULT_CONFIG = {
+    maxEmptyRetries: 2,
+    maxContinuations: 3,
+    autoContinue: true,
+    minContentLength: 1,
+};
+// =============================================================================
+// RESILIENT LLM CALL
+// =============================================================================
+/**
+ * Wrap an LLM call with semantic resilience.
+ *
+ * Handles:
+ * 1. Empty responses - retries with slight prompt modification
+ * 2. max_tokens truncation - auto-continues to get complete response
+ * 3. Response validation - ensures response meets minimum quality bar
+ *
+ * @example
+ * ```typescript
+ * const result = await resilientLLMCall(
+ *   messages,
+ *   (msgs) => provider.chat(msgs, options),
+ *   { onEvent: (e) => console.log('Resilience:', e) }
+ * );
+ * ```
+ */
+export async function resilientLLMCall(messages, callFn, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const onEvent = config.onEvent || (() => { });
+    let emptyRetries = 0;
+    let continuations = 0;
+    let wasRecovered = false;
+    // Clone messages to avoid mutation
+    let currentMessages = [...messages];
+    // ==========================================================================
+    // PHASE 1: Handle empty responses
+    // ==========================================================================
+    let response = null;
+    for (let attempt = 1; attempt <= cfg.maxEmptyRetries + 1; attempt++) {
+        response = await callFn(currentMessages);
+        const hasContent = response.content && response.content.length >= cfg.minContentLength;
+        const hasToolCalls = response.toolCalls && response.toolCalls.length > 0;
+        // Valid response - has content or tool calls
+        if (hasContent || hasToolCalls) {
+            if (attempt > 1) {
+                onEvent({ type: 'empty_response_recovered', attempt: attempt - 1 });
+                wasRecovered = true;
+            }
+            break;
+        }
+        // Empty response - retry with nudge
+        if (attempt <= cfg.maxEmptyRetries) {
+            emptyRetries++;
+            onEvent({ type: 'empty_response', attempt, maxAttempts: cfg.maxEmptyRetries + 1 });
+            // Add a gentle nudge to encourage response
+            currentMessages = [
+                ...messages,
+                {
+                    role: 'user',
+                    content: '[System: Your previous response was empty. Please provide a response.]',
+                },
+            ];
+        }
+        else {
+            // Failed after all retries
+            onEvent({ type: 'empty_response_failed', attempts: attempt });
+            // Return what we have, but mark as potentially problematic
+            // Don't throw - let the agent decide what to do
+            break;
+        }
+    }
+    if (!response) {
+        throw new LLMResilienceError('No response received from LLM after retries', {
+            emptyRetries,
+            continuations: 0,
+        });
+    }
+    // ==========================================================================
+    // PHASE 2: Handle max_tokens truncation
+    // ==========================================================================
+    if (cfg.autoContinue && response.stopReason === 'max_tokens' && !response.toolCalls?.length) {
+        let accumulatedContent = response.content || '';
+        let accumulatedInputTokens = response.usage?.inputTokens || 0;
+        let accumulatedOutputTokens = response.usage?.outputTokens || 0;
+        let accumulatedCacheRead = response.usage?.cacheReadTokens || 0;
+        let accumulatedCacheWrite = response.usage?.cacheWriteTokens || 0;
+        let accumulatedCost = response.usage?.cost || 0;
+        while (continuations < cfg.maxContinuations) {
+            continuations++;
+            onEvent({
+                type: 'max_tokens_truncated',
+                continuation: continuations,
+                maxContinuations: cfg.maxContinuations,
+            });
+            // Create continuation request
+            const continuationMessages = [
+                ...messages,
+                {
+                    role: 'assistant',
+                    content: accumulatedContent,
+                },
+                {
+                    role: 'user',
+                    content: '[System: Please continue from where you left off. Do not repeat what you already said.]',
+                },
+            ];
+            const continuationResponse = await callFn(continuationMessages);
+            wasRecovered = true;
+            // Accumulate content
+            if (continuationResponse.content) {
+                accumulatedContent += continuationResponse.content;
+            }
+            // Accumulate usage
+            if (continuationResponse.usage) {
+                accumulatedInputTokens += continuationResponse.usage.inputTokens || 0;
+                accumulatedOutputTokens += continuationResponse.usage.outputTokens || 0;
+                accumulatedCacheRead += continuationResponse.usage.cacheReadTokens || 0;
+                accumulatedCacheWrite += continuationResponse.usage.cacheWriteTokens || 0;
+                accumulatedCost += continuationResponse.usage.cost || 0;
+            }
+            onEvent({
+                type: 'max_tokens_continued',
+                continuation: continuations,
+                totalContent: accumulatedContent.length,
+            });
+            // Check if we're done
+            if (continuationResponse.stopReason !== 'max_tokens') {
+                onEvent({
+                    type: 'max_tokens_completed',
+                    continuations,
+                    totalContent: accumulatedContent.length,
+                });
+                // Return combined response
+                response = {
+                    ...continuationResponse,
+                    content: accumulatedContent,
+                    usage: {
+                        inputTokens: accumulatedInputTokens,
+                        outputTokens: accumulatedOutputTokens,
+                        totalTokens: accumulatedInputTokens + accumulatedOutputTokens,
+                        cacheReadTokens: accumulatedCacheRead,
+                        cacheWriteTokens: accumulatedCacheWrite,
+                        cost: accumulatedCost,
+                    },
+                };
+                break;
+            }
+        }
+        // Hit continuation limit
+        if (continuations >= cfg.maxContinuations && response.stopReason === 'max_tokens') {
+            onEvent({ type: 'max_tokens_limit_reached', continuations });
+            // Still return what we have
+            response = {
+                ...response,
+                content: accumulatedContent,
+                usage: {
+                    inputTokens: accumulatedInputTokens,
+                    outputTokens: accumulatedOutputTokens,
+                    totalTokens: accumulatedInputTokens + accumulatedOutputTokens,
+                    cacheReadTokens: accumulatedCacheRead,
+                    cacheWriteTokens: accumulatedCacheWrite,
+                    cost: accumulatedCost,
+                },
+            };
+        }
+    }
+    // ==========================================================================
+    // PHASE 3: Final validation
+    // ==========================================================================
+    // At this point response is guaranteed non-null (we threw or broke with a value)
+    const finalResponse = response;
+    onEvent({
+        type: 'response_validated',
+        contentLength: finalResponse.content?.length || 0,
+        hasToolCalls: (finalResponse.toolCalls?.length || 0) > 0,
+    });
+    return {
+        response: finalResponse,
+        emptyRetries,
+        continuations,
+        wasRecovered,
+    };
+}
+// =============================================================================
+// ERROR TYPES
+// =============================================================================
+/**
+ * Error thrown when LLM resilience cannot recover.
+ */
+export class LLMResilienceError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'LLMResilienceError';
+    }
+}
+/**
+ * Check if an error is an LLM resilience error.
+ */
+export function isLLMResilienceError(error) {
+    return error instanceof LLMResilienceError;
+}
+// =============================================================================
+// VALIDATION UTILITIES
+// =============================================================================
+/**
+ * Validate that a response meets minimum quality criteria.
+ */
+export function validateResponse(response, options = {}) {
+    const issues = [];
+    const minLength = options.minContentLength ?? 1;
+    // Check for content or tool calls
+    const hasContent = response.content && response.content.length >= minLength;
+    const hasToolCalls = response.toolCalls && response.toolCalls.length > 0;
+    if (!hasContent && !hasToolCalls) {
+        issues.push('Response has no content and no tool calls');
+    }
+    // Check for truncation
+    if (response.stopReason === 'max_tokens') {
+        issues.push('Response was truncated due to max_tokens');
+    }
+    return {
+        valid: issues.length === 0,
+        issues,
+    };
+}
+/**
+ * Create a response summary for logging/debugging.
+ */
+export function summarizeResponse(response) {
+    const parts = [];
+    if (response.content) {
+        const preview = response.content.slice(0, 100);
+        parts.push(`content: ${preview}${response.content.length > 100 ? '...' : ''}`);
+    }
+    if (response.toolCalls?.length) {
+        const toolNames = response.toolCalls.map(tc => tc.name).join(', ');
+        parts.push(`tools: [${toolNames}]`);
+    }
+    parts.push(`stop: ${response.stopReason}`);
+    if (response.usage) {
+        parts.push(`tokens: ${response.usage.inputTokens}/${response.usage.outputTokens}`);
+    }
+    return parts.join(' | ');
+}
+//# sourceMappingURL=llm-resilience.js.map

package/dist/src/providers/llm-resilience.js.map

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

package/dist/src/providers/resilient-provider.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Resilient Provider Factory
+ *
+ * Creates providers wrapped with circuit breaker and fallback chain support.
+ * Provides production-grade reliability for LLM API calls.
+ *
+ * @example
+ * ```typescript
+ * // Single provider with circuit breaker
+ * const provider = await getResilientProvider('anthropic');
+ *
+ * // Fallback chain across multiple providers
+ * const chain = await createResilientFallbackChain({
+ *   providers: ['anthropic', 'openrouter', 'openai'],
+ *   circuitBreaker: { failureThreshold: 3, resetTimeout: 30000 },
+ * });
+ * ```
+ */
+import { CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerMetrics } from './circuit-breaker.js';
+import { FallbackChain, type FallbackChainConfig, type ProviderHealth } from './fallback-chain.js';
+import type { LLMProvider, LLMProviderWithTools } from './types.js';
+/**
+ * Configuration for a resilient provider.
+ */
+export interface ResilientProviderConfig {
+    /** Circuit breaker configuration (enabled by default) */
+    circuitBreaker?: CircuitBreakerConfig | false;
+}
+/**
+ * Configuration for creating a resilient fallback chain.
+ */
+export interface ResilientChainConfig {
+    /** Provider names in priority order (lower index = higher priority) */
+    providers?: string[];
+    /** Circuit breaker config to wrap each provider */
+    circuitBreaker?: CircuitBreakerConfig | false;
+    /** Fallback chain config overrides */
+    fallback?: Partial<Omit<FallbackChainConfig, 'providers'>>;
+    /** Callback when falling back between providers */
+    onFallback?: (from: string, to: string, error: Error) => void;
+    /** Callback when provider health changes */
+    onHealthChange?: (name: string, health: ProviderHealth) => void;
+}
+/**
+ * Get a provider wrapped with a circuit breaker.
+ *
+ * The circuit breaker prevents cascading failures by:
+ * - Tracking consecutive failures
+ * - Opening the circuit after a threshold is reached
+ * - Rejecting requests immediately when open
+ * - Periodically testing if the service has recovered
+ *
+ * @example
+ * ```typescript
+ * const provider = await getResilientProvider('anthropic', {
+ *   circuitBreaker: {
+ *     failureThreshold: 3,
+ *     resetTimeout: 60000,
+ *   },
+ * });
+ *
+ * // Provider will throw CircuitBreakerError when circuit is open
+ * const response = await provider.chat(messages);
+ * ```
+ */
+export declare function getResilientProvider(preferred?: string, config?: ResilientProviderConfig): Promise<LLMProvider | LLMProviderWithTools>;
+/**
+ * Get the circuit breaker for a provider (if it exists).
+ */
+export declare function getCircuitBreaker(providerName: string): CircuitBreaker | null;
+/**
+ * Get metrics for all circuit breakers.
+ */
+export declare function getAllCircuitBreakerMetrics(): Record<string, CircuitBreakerMetrics>;
+/**
+ * Reset all circuit breakers.
+ */
+export declare function resetAllCircuitBreakers(): void;
+/**
+ * Create a fallback chain with circuit breaker protection.
+ *
+ * Combines multiple providers into a resilient chain that:
+ * - Tries providers in priority order
+ * - Skips providers that are in cooldown
+ * - Wraps each provider with a circuit breaker
+ * - Tracks health and success rates
+ *
+ * @example
+ * ```typescript
+ * const chain = await createResilientFallbackChain({
+ *   providers: ['anthropic', 'openrouter', 'openai'],
+ *   circuitBreaker: {
+ *     failureThreshold: 3,
+ *     resetTimeout: 30000,
+ *   },
+ *   fallback: {
+ *     cooldownMs: 60000,
+ *     failureThreshold: 2,
+ *   },
+ *   onFallback: (from, to, error) => {
+ *     console.log(`Falling back from ${from} to ${to}: ${error.message}`);
+ *   },
+ * });
+ *
+ * // Chain automatically handles failures and fallbacks
+ * const response = await chain.chat(messages);
+ * ```
+ */
+export declare function createResilientFallbackChain(config?: ResilientChainConfig): Promise<FallbackChain>;
+/**
+ * Create a fallback chain from all configured providers.
+ *
+ * Convenience function that creates a chain with sensible defaults.
+ */
+export declare function createAutoFallbackChain(): Promise<FallbackChain>;
+/**
+ * Format resilience status for display.
+ */
+export declare function formatResilienceStatus(): string;
+/**
+ * Check if resilient provider features are available.
+ */
+export declare function hasResilientProviderSupport(): boolean;
+//# sourceMappingURL=resilient-provider.d.ts.map

package/dist/src/providers/resilient-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/resilient-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,cAAc,EAEd,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EAEb,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,cAAc,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,mDAAmD;IACnD,cAAc,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IAE9C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC;IAE3D,mDAAmD;IACnD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAE9D,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE;AAkCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,uBAA4B,GACnC,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC,CAwB7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAQnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,aAAa,CAAC,CAyDxB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC,CAStE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAiC/C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD"}

package/dist/src/providers/resilient-provider.js

@@ -0,0 +1,242 @@
+/**
+ * Resilient Provider Factory
+ *
+ * Creates providers wrapped with circuit breaker and fallback chain support.
+ * Provides production-grade reliability for LLM API calls.
+ *
+ * @example
+ * ```typescript
+ * // Single provider with circuit breaker
+ * const provider = await getResilientProvider('anthropic');
+ *
+ * // Fallback chain across multiple providers
+ * const chain = await createResilientFallbackChain({
+ *   providers: ['anthropic', 'openrouter', 'openai'],
+ *   circuitBreaker: { failureThreshold: 3, resetTimeout: 30000 },
+ * });
+ * ```
+ */
+import { getProvider, listProviders } from './provider.js';
+import { createCircuitBreaker, } from './circuit-breaker.js';
+import { createFallbackChain, } from './fallback-chain.js';
+// =============================================================================
+// GLOBAL STATE
+// =============================================================================
+/**
+ * Global registry of circuit breakers per provider.
+ * Reused across calls to maintain state.
+ */
+const circuitBreakers = new Map();
+/**
+ * Default circuit breaker configuration.
+ */
+const DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5,
+    resetTimeout: 30000,
+    halfOpenRequests: 1,
+    tripOnErrors: ['RATE_LIMITED', 'SERVER_ERROR', 'NETWORK_ERROR', 'TIMEOUT'],
+};
+// =============================================================================
+// RESILIENT PROVIDER
+// =============================================================================
+/**
+ * Get a provider wrapped with a circuit breaker.
+ *
+ * The circuit breaker prevents cascading failures by:
+ * - Tracking consecutive failures
+ * - Opening the circuit after a threshold is reached
+ * - Rejecting requests immediately when open
+ * - Periodically testing if the service has recovered
+ *
+ * @example
+ * ```typescript
+ * const provider = await getResilientProvider('anthropic', {
+ *   circuitBreaker: {
+ *     failureThreshold: 3,
+ *     resetTimeout: 60000,
+ *   },
+ * });
+ *
+ * // Provider will throw CircuitBreakerError when circuit is open
+ * const response = await provider.chat(messages);
+ * ```
+ */
+export async function getResilientProvider(preferred, config = {}) {
+    const provider = await getProvider(preferred);
+    // Check if circuit breaker is disabled
+    if (config.circuitBreaker === false) {
+        return provider;
+    }
+    // Get or create circuit breaker for this provider
+    const breakerConfig = {
+        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,
+        ...(typeof config.circuitBreaker === 'object' ? config.circuitBreaker : {}),
+    };
+    let entry = circuitBreakers.get(provider.name);
+    if (!entry) {
+        const breaker = createCircuitBreaker(breakerConfig);
+        entry = { breaker, provider };
+        circuitBreakers.set(provider.name, entry);
+    }
+    // Wrap the provider with circuit breaker
+    return entry.breaker.wrap(provider);
+}
+/**
+ * Get the circuit breaker for a provider (if it exists).
+ */
+export function getCircuitBreaker(providerName) {
+    return circuitBreakers.get(providerName)?.breaker ?? null;
+}
+/**
+ * Get metrics for all circuit breakers.
+ */
+export function getAllCircuitBreakerMetrics() {
+    const metrics = {};
+    for (const [name, entry] of circuitBreakers) {
+        metrics[name] = entry.breaker.getMetrics();
+    }
+    return metrics;
+}
+/**
+ * Reset all circuit breakers.
+ */
+export function resetAllCircuitBreakers() {
+    for (const entry of circuitBreakers.values()) {
+        entry.breaker.reset();
+    }
+}
+// =============================================================================
+// RESILIENT FALLBACK CHAIN
+// =============================================================================
+/**
+ * Create a fallback chain with circuit breaker protection.
+ *
+ * Combines multiple providers into a resilient chain that:
+ * - Tries providers in priority order
+ * - Skips providers that are in cooldown
+ * - Wraps each provider with a circuit breaker
+ * - Tracks health and success rates
+ *
+ * @example
+ * ```typescript
+ * const chain = await createResilientFallbackChain({
+ *   providers: ['anthropic', 'openrouter', 'openai'],
+ *   circuitBreaker: {
+ *     failureThreshold: 3,
+ *     resetTimeout: 30000,
+ *   },
+ *   fallback: {
+ *     cooldownMs: 60000,
+ *     failureThreshold: 2,
+ *   },
+ *   onFallback: (from, to, error) => {
+ *     console.log(`Falling back from ${from} to ${to}: ${error.message}`);
+ *   },
+ * });
+ *
+ * // Chain automatically handles failures and fallbacks
+ * const response = await chain.chat(messages);
+ * ```
+ */
+export async function createResilientFallbackChain(config = {}) {
+    // Get available providers
+    const available = listProviders().filter(p => p.configured);
+    // Determine provider order
+    let providerNames;
+    if (config.providers && config.providers.length > 0) {
+        // Use specified order, but only include configured providers
+        providerNames = config.providers.filter(name => available.some(p => p.name === name));
+    }
+    else {
+        // Use default priority order
+        providerNames = available.map(p => p.name);
+    }
+    if (providerNames.length === 0) {
+        throw new Error('No configured providers available for fallback chain');
+    }
+    // Create wrapped providers
+    const chainedProviders = [];
+    for (let i = 0; i < providerNames.length; i++) {
+        const name = providerNames[i];
+        try {
+            // Get provider with circuit breaker (if enabled)
+            const provider = await getResilientProvider(name, {
+                circuitBreaker: config.circuitBreaker,
+            });
+            chainedProviders.push({
+                provider,
+                priority: i + 1, // Priority based on position
+            });
+        }
+        catch (error) {
+            // Skip providers that fail to initialize
+            console.warn(`[ResilientProvider] Failed to initialize ${name}:`, error);
+        }
+    }
+    if (chainedProviders.length === 0) {
+        throw new Error('No providers could be initialized for fallback chain');
+    }
+    // Create fallback chain
+    return createFallbackChain({
+        providers: chainedProviders,
+        cooldownMs: config.fallback?.cooldownMs ?? 60000,
+        failureThreshold: config.fallback?.failureThreshold ?? 3,
+        onFallback: config.onFallback,
+        onHealthChange: config.onHealthChange,
+    });
+}
+/**
+ * Create a fallback chain from all configured providers.
+ *
+ * Convenience function that creates a chain with sensible defaults.
+ */
+export async function createAutoFallbackChain() {
+    return createResilientFallbackChain({
+        // Use default provider priority
+        circuitBreaker: DEFAULT_CIRCUIT_BREAKER_CONFIG,
+        fallback: {
+            cooldownMs: 60000,
+            failureThreshold: 3,
+        },
+    });
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/**
+ * Format resilience status for display.
+ */
+export function formatResilienceStatus() {
+    const metrics = getAllCircuitBreakerMetrics();
+    const lines = ['Provider Resilience Status:', ''];
+    if (Object.keys(metrics).length === 0) {
+        lines.push('  No circuit breakers active');
+        return lines.join('\n');
+    }
+    for (const [name, m] of Object.entries(metrics)) {
+        const stateIcon = {
+            CLOSED: '✓',
+            OPEN: '✗',
+            'HALF_OPEN': '◐',
+        }[m.state] ?? '?';
+        lines.push(`  ${stateIcon} ${name}: ${m.state}`);
+        lines.push(`      Requests: ${m.totalRequests} (${m.rejectedRequests} rejected)`);
+        lines.push(`      Failures: ${m.failures}`);
+        if (m.resetAt) {
+            const remaining = Math.max(0, m.resetAt - Date.now());
+            lines.push(`      Reset in: ${(remaining / 1000).toFixed(1)}s`);
+        }
+        if (m.lastError) {
+            lines.push(`      Last error: ${m.lastError}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if resilient provider features are available.
+ */
+export function hasResilientProviderSupport() {
+    return true; // Always available now that modules are wired
+}
+//# sourceMappingURL=resilient-provider.js.map

package/dist/src/providers/resilient-provider.js.map

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