@stackbilt/llm-providers 1.0.0

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,365 @@
+/**
+ * Graduated Circuit Breaker
+ * Routes traffic away from failing providers with confidence-weighted degradation.
+ */
+import { CircuitBreakerOpenError } from '../errors';
+const DEFAULT_DEGRADATION_CURVE = [1.0, 0.9, 0.7, 0.4, 0.1];
+const DEFAULT_CONFIG = {
+    failureThreshold: DEFAULT_DEGRADATION_CURVE.length,
+    resetTimeout: 60_000,
+    monitoringPeriod: 300_000,
+    minRequests: 3,
+    degradationCurve: DEFAULT_DEGRADATION_CURVE
+};
+function clampTrafficPct(value) {
+    if (Number.isNaN(value))
+        return 0;
+    return Math.min(1, Math.max(0, value));
+}
+function normalizeConfig(config) {
+    const degradationCurve = (config.degradationCurve?.length
+        ? config.degradationCurve
+        : DEFAULT_DEGRADATION_CURVE).map(clampTrafficPct);
+    return {
+        failureThreshold: Math.max(1, config.failureThreshold ?? DEFAULT_CONFIG.failureThreshold),
+        resetTimeout: config.resetTimeout ?? DEFAULT_CONFIG.resetTimeout,
+        monitoringPeriod: config.monitoringPeriod ?? DEFAULT_CONFIG.monitoringPeriod,
+        minRequests: config.minRequests ?? DEFAULT_CONFIG.minRequests,
+        degradationCurve
+    };
+}
+export class CircuitBreaker {
+    name;
+    config;
+    consecutiveFailures = 0;
+    totalFailures = 0;
+    totalSuccesses = 0;
+    totalRequests = 0;
+    lastFailureAt;
+    lastSuccessAt;
+    lastRequestAt;
+    lastDecayAt = 0;
+    windowStart = Date.now();
+    constructor(name, config = {}) {
+        this.name = name;
+        this.config = normalizeConfig(config);
+    }
+    /**
+     * Backwards-compatible execute alias.
+     */
+    async execute(fn) {
+        return this.exec(fn);
+    }
+    /**
+     * Execute the primary operation if the breaker allows traffic through.
+     * Rejected requests throw CircuitBreakerOpenError so callers can route elsewhere.
+     */
+    async exec(fn) {
+        const now = Date.now();
+        this.syncState(now);
+        this.markTraffic(now);
+        const primaryPct = this.currentPrimaryTrafficPct();
+        if (primaryPct <= 0) {
+            throw this.buildOpenError(now);
+        }
+        if (primaryPct < 1 && Math.random() > primaryPct) {
+            console.log(`[CircuitBreaker] ${this.name}: degraded (${(primaryPct * 100).toFixed(0)}% primary), rejecting request for fallback`);
+            throw new CircuitBreakerOpenError(this.name, 0, this.consecutiveFailures);
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    /**
+     * Execute with graduated fallback. Degraded traffic is routed to the fallback
+     * probabilistically, and primary failures immediately fail over.
+     */
+    async execWithFallback(primary, fallback) {
+        const now = Date.now();
+        this.syncState(now);
+        this.markTraffic(now);
+        const primaryPct = this.currentPrimaryTrafficPct();
+        if (primaryPct <= 0) {
+            console.log(`[CircuitBreaker] ${this.name}: fully degraded (${this.consecutiveFailures} failures), using fallback`);
+            return fallback();
+        }
+        if (primaryPct < 1 && Math.random() > primaryPct) {
+            console.log(`[CircuitBreaker] ${this.name}: degraded (${(primaryPct * 100).toFixed(0)}% primary), routing to fallback`);
+            return fallback();
+        }
+        try {
+            const result = await primary();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            console.warn(`[CircuitBreaker] ${this.name}: primary failed (${this.consecutiveFailures} consecutive), trying fallback`);
+            return fallback();
+        }
+    }
+    /**
+     * Current percentage of traffic that should be routed to the primary provider.
+     */
+    primaryTrafficPct() {
+        this.syncState(Date.now());
+        return this.currentPrimaryTrafficPct();
+    }
+    /**
+     * Get current state and breaker statistics.
+     */
+    getState() {
+        this.syncState(Date.now());
+        return this.snapshot();
+    }
+    /**
+     * Alias for stats-oriented call sites.
+     */
+    getStats() {
+        return this.getState();
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return {
+            ...this.config,
+            degradationCurve: [...this.config.degradationCurve]
+        };
+    }
+    /**
+     * Manual reset for testing and operator intervention.
+     */
+    reset() {
+        this.consecutiveFailures = 0;
+        this.totalFailures = 0;
+        this.totalSuccesses = 0;
+        this.totalRequests = 0;
+        this.lastFailureAt = undefined;
+        this.lastSuccessAt = undefined;
+        this.lastRequestAt = undefined;
+        this.lastDecayAt = 0;
+        this.windowStart = Date.now();
+        console.log(`[CircuitBreaker] ${this.name}: circuit breaker reset`);
+    }
+    /**
+     * Force the breaker into the fully open state.
+     */
+    forceOpen() {
+        const now = Date.now();
+        this.consecutiveFailures = this.config.failureThreshold;
+        this.lastFailureAt = now;
+        this.lastRequestAt = now;
+        this.lastDecayAt = now;
+        console.log(`[CircuitBreaker] ${this.name}: circuit breaker force opened`);
+    }
+    isOpen() {
+        return this.getState().state === 'OPEN';
+    }
+    isClosed() {
+        return this.getState().state === 'CLOSED';
+    }
+    /**
+     * Deprecated alias retained for compatibility with the prior state machine.
+     */
+    isHalfOpen() {
+        return this.isRecovering();
+    }
+    isDegraded() {
+        return this.getState().state === 'DEGRADED';
+    }
+    isRecovering() {
+        return this.getState().state === 'RECOVERING';
+    }
+    getHealth() {
+        const state = this.getState();
+        return {
+            state: state.state,
+            failures: state.failures,
+            consecutiveFailures: state.consecutiveFailures,
+            failureThreshold: this.config.failureThreshold,
+            primaryTrafficPct: state.primaryTrafficPct,
+            healthy: state.state === 'CLOSED',
+            lastFailure: state.lastFailure,
+            lastSuccess: state.lastSuccess,
+            nextAttempt: state.nextAttempt,
+            totalFailures: state.totalFailures,
+            totalSuccesses: state.totalSuccesses,
+            totalRequests: state.totalRequests
+        };
+    }
+    snapshot(now = Date.now()) {
+        return {
+            state: this.currentState(),
+            failures: this.consecutiveFailures,
+            consecutiveFailures: this.consecutiveFailures,
+            primaryTrafficPct: this.currentPrimaryTrafficPct(),
+            totalFailures: this.totalFailures,
+            totalSuccesses: this.totalSuccesses,
+            totalRequests: this.totalRequests,
+            lastFailure: this.lastFailureAt,
+            lastSuccess: this.lastSuccessAt,
+            lastRequest: this.lastRequestAt,
+            nextAttempt: this.retryAt(now)
+        };
+    }
+    currentState() {
+        const primaryPct = this.currentPrimaryTrafficPct();
+        if (primaryPct >= 1)
+            return 'CLOSED';
+        if (primaryPct <= 0)
+            return 'OPEN';
+        if ((this.lastSuccessAt ?? 0) > (this.lastFailureAt ?? 0))
+            return 'RECOVERING';
+        return 'DEGRADED';
+    }
+    currentPrimaryTrafficPct() {
+        if (this.consecutiveFailures >= this.config.failureThreshold) {
+            return 0;
+        }
+        if (this.consecutiveFailures < this.config.degradationCurve.length) {
+            return this.config.degradationCurve[this.consecutiveFailures];
+        }
+        if (this.config.degradationCurve.length === 0) {
+            return this.consecutiveFailures === 0 ? 1 : 0;
+        }
+        return this.config.degradationCurve[this.config.degradationCurve.length - 1];
+    }
+    buildOpenError(now) {
+        return new CircuitBreakerOpenError(this.name, this.retryAfterSec(now), this.consecutiveFailures);
+    }
+    retryAfterSec(now) {
+        if (this.consecutiveFailures === 0 || this.lastDecayAt === 0) {
+            return 0;
+        }
+        return Math.max(0, Math.ceil((this.config.resetTimeout - (now - this.lastDecayAt)) / 1000));
+    }
+    retryAt(now) {
+        if (this.consecutiveFailures === 0 || this.lastDecayAt === 0) {
+            return undefined;
+        }
+        return Math.max(now, this.lastDecayAt + this.config.resetTimeout);
+    }
+    syncState(now) {
+        this.maybeDecayFailures(now);
+        this.maybeRotateWindow(now);
+    }
+    markTraffic(now) {
+        this.lastRequestAt = now;
+        this.lastDecayAt = now;
+    }
+    onSuccess() {
+        this.totalRequests++;
+        this.totalSuccesses++;
+        this.lastSuccessAt = Date.now();
+        if (this.consecutiveFailures > 0) {
+            this.consecutiveFailures--;
+            console.log(`[CircuitBreaker] ${this.name}: success -> recovering (${this.consecutiveFailures} failures, ${(this.currentPrimaryTrafficPct() * 100).toFixed(0)}% primary)`);
+        }
+    }
+    onFailure() {
+        this.totalRequests++;
+        this.totalFailures++;
+        this.consecutiveFailures++;
+        this.lastFailureAt = Date.now();
+        const primaryPct = this.currentPrimaryTrafficPct();
+        if (primaryPct <= 0) {
+            console.log(`[CircuitBreaker] ${this.name}: OPEN (${this.consecutiveFailures} consecutive failures)`);
+            return;
+        }
+        if (primaryPct < 1) {
+            console.log(`[CircuitBreaker] ${this.name}: degraded -> ${(primaryPct * 100).toFixed(0)}% primary (${this.consecutiveFailures} failures)`);
+        }
+    }
+    maybeDecayFailures(now) {
+        if (this.consecutiveFailures === 0 || this.lastDecayAt === 0) {
+            return;
+        }
+        const elapsed = now - this.lastDecayAt;
+        if (elapsed < this.config.resetTimeout) {
+            return;
+        }
+        const steps = Math.floor(elapsed / this.config.resetTimeout);
+        const before = this.consecutiveFailures;
+        this.consecutiveFailures = Math.max(0, this.consecutiveFailures - steps);
+        this.lastDecayAt += steps * this.config.resetTimeout;
+        if (before !== this.consecutiveFailures) {
+            console.log(`[CircuitBreaker] ${this.name}: time-decay ${before} -> ${this.consecutiveFailures} failures (${(this.currentPrimaryTrafficPct() * 100).toFixed(0)}% primary)`);
+        }
+    }
+    maybeRotateWindow(now) {
+        if (now - this.windowStart >= this.config.monitoringPeriod) {
+            this.windowStart = now;
+        }
+    }
+}
+/**
+ * Circuit breaker manager for multiple providers.
+ */
+export class CircuitBreakerManager {
+    breakers = new Map();
+    defaultConfig;
+    constructor(defaultConfig) {
+        this.defaultConfig = {
+            failureThreshold: defaultConfig?.failureThreshold ?? DEFAULT_CONFIG.failureThreshold,
+            resetTimeout: defaultConfig?.resetTimeout ?? DEFAULT_CONFIG.resetTimeout,
+            monitoringPeriod: defaultConfig?.monitoringPeriod ?? DEFAULT_CONFIG.monitoringPeriod,
+            minRequests: defaultConfig?.minRequests ?? DEFAULT_CONFIG.minRequests,
+            degradationCurve: defaultConfig?.degradationCurve
+                ? [...defaultConfig.degradationCurve]
+                : [...DEFAULT_DEGRADATION_CURVE]
+        };
+    }
+    getBreaker(name, config) {
+        if (!this.breakers.has(name)) {
+            const breakerConfig = {
+                ...this.defaultConfig,
+                ...config,
+                degradationCurve: config?.degradationCurve
+                    ? [...config.degradationCurve]
+                    : [...(this.defaultConfig.degradationCurve ?? DEFAULT_DEGRADATION_CURVE)]
+            };
+            this.breakers.set(name, new CircuitBreaker(name, breakerConfig));
+        }
+        return this.breakers.get(name);
+    }
+    async execute(name, fn, config) {
+        return this.getBreaker(name, config).execute(fn);
+    }
+    async execWithFallback(name, primary, fallback, config) {
+        return this.getBreaker(name, config).execWithFallback(primary, fallback);
+    }
+    getAllStates() {
+        const states = {};
+        for (const [name, breaker] of this.breakers) {
+            states[name] = breaker.getState();
+        }
+        return states;
+    }
+    getHealthStatus() {
+        const health = {};
+        for (const [name, breaker] of this.breakers) {
+            health[name] = breaker.getHealth();
+        }
+        return health;
+    }
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+    reset(name) {
+        this.breakers.get(name)?.reset();
+    }
+}
+/**
+ * Default circuit breaker manager instance.
+ */
+export const defaultCircuitBreakerManager = new CircuitBreakerManager();
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

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

package/dist/utils/cost-tracker.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Cost Tracker
+ * Tracks and optimizes LLM usage costs across providers
+ */
+import type { LLMRequest, LLMResponse, CostConfig, ModelCapabilities } from '../types';
+import type { CreditLedger } from './credit-ledger';
+export interface ProviderCostEntry {
+    totalCost: number;
+    requestCount: number;
+    inputTokens: number;
+    outputTokens: number;
+    lastRecordedAt: number;
+}
+export interface ProviderCostBreakdownEntry extends ProviderCostEntry {
+    cost: number;
+    requests: number;
+    tokens: {
+        input: number;
+        output: number;
+    };
+    averageCostPerRequest: number;
+}
+export declare class CostTracker {
+    private providers;
+    private config;
+    private ledger?;
+    constructor(config?: Partial<CostConfig>, ledger?: CreditLedger);
+    /**
+     * Calculate cost for a request
+     */
+    calculateRequestCost(request: LLMRequest, capabilities: ModelCapabilities): number;
+    /**
+     * Track actual cost from response
+     */
+    trackCost(provider: string, response: LLMResponse): void;
+    /**
+     * Get the attached CreditLedger (if any)
+     */
+    getLedger(): CreditLedger | undefined;
+    /**
+     * Get total cost across all providers
+     */
+    getTotalCost(): number;
+    /**
+     * Get cost for specific provider
+     */
+    getProviderCost(provider: string): number;
+    /**
+     * Get cost breakdown by provider
+     */
+    getCostBreakdown(): Record<string, ProviderCostBreakdownEntry>;
+    /**
+     * Get a provider snapshot aligned with Workers usage reporting.
+     */
+    breakdown(): Record<string, ProviderCostEntry>;
+    /**
+     * Get total cost across all providers.
+     */
+    total(): number;
+    /**
+     * Get most cost-effective provider for a request
+     */
+    getMostCostEffectiveProvider(providers: Record<string, ModelCapabilities>, request: LLMRequest): string;
+    /**
+     * Check if we're approaching cost limits
+     */
+    shouldRouteBasedOnCost(provider: string): boolean;
+    /**
+     * Reset cost tracking (e.g., monthly reset)
+     */
+    reset(): void;
+    /**
+     * Reset tracking for specific provider
+     */
+    resetProvider(provider: string): void;
+    /**
+     * Drain and reset provider tracking for periodic reporting.
+     */
+    drain(): Record<string, ProviderCostEntry>;
+    /**
+     * Export cost data for analytics
+     */
+    exportData(): {
+        totalCost: number;
+        breakdown: Record<string, ProviderCostBreakdownEntry>;
+        period: {
+            start: number;
+            end: number;
+        };
+    };
+    /**
+     * Estimate input tokens from request
+     */
+    private estimateInputTokens;
+    /**
+     * Check for cost alerts
+     */
+    private checkCostAlerts;
+    /**
+     * Update cost configuration
+     */
+    updateConfig(config: Partial<CostConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): CostConfig;
+    private createProviderEntry;
+}
+/**
+ * Default cost tracker instance
+ */
+export declare const defaultCostTracker: CostTracker;
+/**
+ * Cost optimization utilities
+ */
+export declare class CostOptimizer {
+    /**
+     * Choose optimal provider based on cost and performance
+     */
+    static chooseOptimalProvider(providers: Record<string, ModelCapabilities>, request: LLMRequest, costTracker: CostTracker, performanceWeights?: {
+        cost: number;
+        latency: number;
+        quality: number;
+    }): string;
+    /**
+     * Suggest cost reduction strategies
+     */
+    static suggestOptimizations(costBreakdown: Record<string, any>): string[];
+}
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/utils/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/cost-tracker.ts"],"names":[],"mappings":"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"}