@stackbilt/llm-providers 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * LLM Provider Types
+ * Unified types for all LLM providers with v2 architecture support
+ */
+export interface LLMMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: string;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolResult {
+    id: string;
+    output: string;
+    error?: string;
+}
+export interface LLMRequest {
+    messages: LLMMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+    systemPrompt?: string;
+    tools?: Tool[];
+    toolChoice?: 'auto' | 'none' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    response_format?: {
+        type: 'json_object' | 'text';
+    };
+    tenantId?: string;
+    requestId?: string;
+    metadata?: Record<string, any>;
+}
+export interface Tool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, any>;
+            required?: string[];
+        };
+    };
+}
+export interface LLMResponse {
+    id?: string;
+    message: string;
+    content?: string;
+    usage: TokenUsage;
+    model: string;
+    provider: string;
+    responseTime: number;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    toolCalls?: ToolCall[];
+    metadata?: Record<string, any>;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cost?: number;
+}
+export interface LLMProvider {
+    name: string;
+    models: string[];
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    supportsBatching: boolean;
+    generateResponse(request: LLMRequest): Promise<LLMResponse>;
+    validateConfig(): boolean;
+    getModels(): string[];
+    estimateCost(request: LLMRequest): number;
+    healthCheck(): Promise<boolean>;
+    getMetrics(): ProviderMetrics;
+    resetMetrics(): void;
+}
+export interface LLMConfig {
+    provider: 'openai' | 'anthropic' | 'cloudflare' | 'cerebras' | 'groq' | 'auto';
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    apiKey?: string;
+    baseUrl?: string;
+    fallbackProvider?: 'openai' | 'anthropic' | 'cloudflare' | 'cerebras' | 'groq';
+    fallbackModel?: string;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+}
+export interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    rateLimitRpm?: number;
+    rateLimitRpd?: number;
+    organization?: string;
+    project?: string;
+}
+export interface OpenAIConfig extends ProviderConfig {
+    organization?: string;
+    project?: string;
+}
+export interface AnthropicConfig extends ProviderConfig {
+    version?: string;
+}
+export interface CloudflareConfig extends ProviderConfig {
+    accountId?: string;
+    ai?: Ai;
+}
+export interface CerebrasConfig extends ProviderConfig {
+}
+export interface GroqConfig extends ProviderConfig {
+}
+export interface LLMError extends Error {
+    code: string;
+    provider: string;
+    retryable: boolean;
+    statusCode?: number;
+    rateLimited?: boolean;
+    quotaExceeded?: boolean;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeout: number;
+    monitoringPeriod: number;
+    minRequests?: number;
+    degradationCurve?: number[];
+}
+export interface CircuitBreakerState {
+    state: 'CLOSED' | 'DEGRADED' | 'RECOVERING' | 'OPEN';
+    failures: number;
+    consecutiveFailures: number;
+    primaryTrafficPct: number;
+    totalFailures: number;
+    totalSuccesses: number;
+    totalRequests: number;
+    lastFailure?: number;
+    lastSuccess?: number;
+    lastRequest?: number;
+    nextAttempt?: number;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    retryableErrors: string[];
+}
+export interface CostConfig {
+    inputTokenCost: number;
+    outputTokenCost: number;
+    maxMonthlyCost?: number;
+    alertThreshold?: number;
+}
+export interface ProviderMetrics {
+    requestCount: number;
+    successCount: number;
+    errorCount: number;
+    averageLatency: number;
+    totalCost: number;
+    rateLimitHits: number;
+    lastUsed: number;
+}
+export interface FallbackRule {
+    condition: 'error' | 'rate_limit' | 'cost' | 'latency';
+    threshold?: number;
+    fallbackProvider: string;
+    fallbackModel?: string;
+}
+export interface ModelCapabilities {
+    maxContextLength: number;
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    toolCalling?: boolean;
+    supportsBatching: boolean;
+    inputTokenCost: number;
+    outputTokenCost: number;
+    description: string;
+}
+export interface ProviderCapabilities {
+    models: Record<string, ModelCapabilities>;
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    supportsBatching: boolean;
+    maxBatchSize?: number;
+    rateLimits: {
+        requestsPerMinute: number;
+        requestsPerDay: number;
+        tokensPerMinute: number;
+    };
+}
+export interface StreamChunk {
+    id: string;
+    content: string;
+    delta: string;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    usage?: Partial<TokenUsage>;
+}
+export interface StreamResponse {
+    stream: ReadableStream<StreamChunk>;
+    controller: ReadableStreamDefaultController<StreamChunk>;
+}
+export interface BatchRequest {
+    id: string;
+    request: LLMRequest;
+    priority?: 'low' | 'normal' | 'high';
+}
+export interface BatchResponse {
+    id: string;
+    response?: LLMResponse;
+    error?: LLMError;
+    processingTime: number;
+}
+export interface BatchJob {
+    id: string;
+    requests: BatchRequest[];
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    progress: number;
+    createdAt: number;
+    completedAt?: number;
+    results: BatchResponse[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * LLM Provider Types
+ * Unified types for all LLM providers with v2 architecture support
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/circuit-breaker.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Graduated Circuit Breaker
+ * Routes traffic away from failing providers with confidence-weighted degradation.
+ */
+import type { CircuitBreakerConfig, CircuitBreakerState } from '../types';
+export declare class CircuitBreaker {
+    readonly name: string;
+    private readonly config;
+    private consecutiveFailures;
+    private totalFailures;
+    private totalSuccesses;
+    private totalRequests;
+    private lastFailureAt?;
+    private lastSuccessAt?;
+    private lastRequestAt?;
+    private lastDecayAt;
+    private windowStart;
+    constructor(name: string, config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Backwards-compatible execute alias.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute the primary operation if the breaker allows traffic through.
+     * Rejected requests throw CircuitBreakerOpenError so callers can route elsewhere.
+     */
+    exec<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute with graduated fallback. Degraded traffic is routed to the fallback
+     * probabilistically, and primary failures immediately fail over.
+     */
+    execWithFallback<T>(primary: () => Promise<T>, fallback: () => Promise<T>): Promise<T>;
+    /**
+     * Current percentage of traffic that should be routed to the primary provider.
+     */
+    primaryTrafficPct(): number;
+    /**
+     * Get current state and breaker statistics.
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Alias for stats-oriented call sites.
+     */
+    getStats(): CircuitBreakerState;
+    /**
+     * Get current configuration.
+     */
+    getConfig(): CircuitBreakerConfig;
+    /**
+     * Manual reset for testing and operator intervention.
+     */
+    reset(): void;
+    /**
+     * Force the breaker into the fully open state.
+     */
+    forceOpen(): void;
+    isOpen(): boolean;
+    isClosed(): boolean;
+    /**
+     * Deprecated alias retained for compatibility with the prior state machine.
+     */
+    isHalfOpen(): boolean;
+    isDegraded(): boolean;
+    isRecovering(): boolean;
+    getHealth(): {
+        state: CircuitBreakerState['state'];
+        failures: number;
+        consecutiveFailures: number;
+        failureThreshold: number;
+        primaryTrafficPct: number;
+        healthy: boolean;
+        lastFailure?: number;
+        lastSuccess?: number;
+        nextAttempt?: number;
+        totalFailures: number;
+        totalSuccesses: number;
+        totalRequests: number;
+    };
+    private snapshot;
+    private currentState;
+    private currentPrimaryTrafficPct;
+    private buildOpenError;
+    private retryAfterSec;
+    private retryAt;
+    private syncState;
+    private markTraffic;
+    private onSuccess;
+    private onFailure;
+    private maybeDecayFailures;
+    private maybeRotateWindow;
+}
+/**
+ * Circuit breaker manager for multiple providers.
+ */
+export declare class CircuitBreakerManager {
+    private breakers;
+    private defaultConfig;
+    constructor(defaultConfig?: Partial<CircuitBreakerConfig>);
+    getBreaker(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+    execute<T>(name: string, fn: () => Promise<T>, config?: Partial<CircuitBreakerConfig>): Promise<T>;
+    execWithFallback<T>(name: string, primary: () => Promise<T>, fallback: () => Promise<T>, config?: Partial<CircuitBreakerConfig>): Promise<T>;
+    getAllStates(): Record<string, CircuitBreakerState>;
+    getHealthStatus(): Record<string, ReturnType<CircuitBreaker['getHealth']>>;
+    resetAll(): void;
+    reset(name: string): void;
+}
+/**
+ * Default circuit breaker manager instance.
+ */
+export declare const defaultCircuitBreakerManager: CircuitBreakerManager;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/utils/circuit-breaker.d.ts.map

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