claude-flow 2.0.0-alpha.65 → 2.0.0-alpha.67

package/dist/providers/types.d.ts

@@ -0,0 +1,356 @@
+/**
+ * Multi-LLM Provider Types and Interfaces
+ * Unified type system for all LLM providers
+ */
+import { EventEmitter } from 'events';
+export type LLMProvider = 'openai' | 'anthropic' | 'google' | 'cohere' | 'ollama' | 'llama-cpp' | 'custom';
+export type LLMModel = 'gpt-4-turbo-preview' | 'gpt-4' | 'gpt-4-32k' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'claude-3-opus-20240229' | 'claude-3-sonnet-20240229' | 'claude-3-haiku-20240307' | 'claude-2.1' | 'claude-2.0' | 'claude-instant-1.2' | 'gemini-pro' | 'gemini-pro-vision' | 'palm-2' | 'bison' | 'command' | 'command-light' | 'command-nightly' | 'generate-xlarge' | 'generate-medium' | 'llama-2-7b' | 'llama-2-13b' | 'llama-2-70b' | 'mistral-7b' | 'mixtral-8x7b' | 'custom-model';
+export interface LLMProviderConfig {
+    provider: LLMProvider;
+    apiKey?: string;
+    apiUrl?: string;
+    model: LLMModel;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stopSequences?: string[];
+    providerOptions?: Record<string, any>;
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    enableStreaming?: boolean;
+    enableCaching?: boolean;
+    cacheTimeout?: number;
+    enableCostOptimization?: boolean;
+    maxCostPerRequest?: number;
+    fallbackModels?: LLMModel[];
+}
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'function';
+    content: string;
+    name?: string;
+    functionCall?: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMRequest {
+    messages: LLMMessage[];
+    model?: LLMModel;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stopSequences?: string[];
+    stream?: boolean;
+    functions?: LLMFunction[];
+    functionCall?: 'auto' | 'none' | {
+        name: string;
+    };
+    providerOptions?: Record<string, any>;
+    costConstraints?: {
+        maxCost?: number;
+        preferredModels?: LLMModel[];
+    };
+}
+export interface LLMFunction {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface LLMResponse {
+    id: string;
+    model: LLMModel;
+    provider: LLMProvider;
+    content: string;
+    functionCall?: {
+        name: string;
+        arguments: string;
+    };
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    cost?: {
+        promptCost: number;
+        completionCost: number;
+        totalCost: number;
+        currency: string;
+    };
+    latency?: number;
+    finishReason?: 'stop' | 'length' | 'function_call' | 'content_filter';
+    metadata?: Record<string, any>;
+}
+export interface LLMStreamEvent {
+    type: 'content' | 'function_call' | 'error' | 'done';
+    delta?: {
+        content?: string;
+        functionCall?: {
+            name?: string;
+            arguments?: string;
+        };
+    };
+    error?: Error;
+    usage?: LLMResponse['usage'];
+    cost?: LLMResponse['cost'];
+}
+export interface ProviderCapabilities {
+    supportedModels: LLMModel[];
+    maxContextLength: Record<LLMModel, number>;
+    maxOutputTokens: Record<LLMModel, number>;
+    supportsStreaming: boolean;
+    supportsFunctionCalling: boolean;
+    supportsSystemMessages: boolean;
+    supportsVision: boolean;
+    supportsAudio: boolean;
+    supportsTools: boolean;
+    supportsFineTuning: boolean;
+    supportsEmbeddings: boolean;
+    supportsLogprobs: boolean;
+    supportsBatching: boolean;
+    rateLimit?: {
+        requestsPerMinute: number;
+        tokensPerMinute: number;
+        concurrentRequests: number;
+    };
+    pricing?: {
+        [model: string]: {
+            promptCostPer1k: number;
+            completionCostPer1k: number;
+            currency: string;
+        };
+    };
+}
+export declare class LLMProviderError extends Error {
+    code: string;
+    provider: LLMProvider;
+    statusCode?: number | undefined;
+    retryable: boolean;
+    details?: any | undefined;
+    constructor(message: string, code: string, provider: LLMProvider, statusCode?: number | undefined, retryable?: boolean, details?: any | undefined);
+}
+export declare class RateLimitError extends LLMProviderError {
+    retryAfter?: number | undefined;
+    constructor(message: string, provider: LLMProvider, retryAfter?: number | undefined, details?: any);
+}
+export declare class AuthenticationError extends LLMProviderError {
+    constructor(message: string, provider: LLMProvider, details?: any);
+}
+export declare class ModelNotFoundError extends LLMProviderError {
+    constructor(model: string, provider: LLMProvider, details?: any);
+}
+export declare class ProviderUnavailableError extends LLMProviderError {
+    constructor(provider: LLMProvider, details?: any);
+}
+export interface ILLMProvider extends EventEmitter {
+    readonly name: LLMProvider;
+    readonly capabilities: ProviderCapabilities;
+    config: LLMProviderConfig;
+    initialize(): Promise<void>;
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    streamComplete(request: LLMRequest): AsyncIterable<LLMStreamEvent>;
+    listModels(): Promise<LLMModel[]>;
+    getModelInfo(model: LLMModel): Promise<ModelInfo>;
+    validateModel(model: LLMModel): boolean;
+    healthCheck(): Promise<HealthCheckResult>;
+    getStatus(): ProviderStatus;
+    estimateCost(request: LLMRequest): Promise<CostEstimate>;
+    getUsage(period?: UsagePeriod): Promise<UsageStats>;
+    destroy(): void;
+}
+export interface ModelInfo {
+    model: LLMModel;
+    name: string;
+    description: string;
+    contextLength: number;
+    maxOutputTokens: number;
+    supportedFeatures: string[];
+    pricing?: {
+        promptCostPer1k: number;
+        completionCostPer1k: number;
+        currency: string;
+    };
+    deprecated?: boolean;
+    deprecationDate?: Date;
+    recommendedReplacement?: LLMModel;
+}
+export interface HealthCheckResult {
+    healthy: boolean;
+    latency?: number;
+    error?: string;
+    timestamp: Date;
+    details?: Record<string, any>;
+}
+export interface ProviderStatus {
+    available: boolean;
+    currentLoad: number;
+    queueLength: number;
+    activeRequests: number;
+    rateLimitRemaining?: number;
+    rateLimitReset?: Date;
+}
+export interface CostEstimate {
+    estimatedPromptTokens: number;
+    estimatedCompletionTokens: number;
+    estimatedTotalTokens: number;
+    estimatedCost: {
+        prompt: number;
+        completion: number;
+        total: number;
+        currency: string;
+    };
+    confidence: number;
+}
+export interface UsageStats {
+    period: {
+        start: Date;
+        end: Date;
+    };
+    requests: number;
+    tokens: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+    cost: {
+        prompt: number;
+        completion: number;
+        total: number;
+        currency: string;
+    };
+    errors: number;
+    averageLatency: number;
+    modelBreakdown: Record<LLMModel, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+}
+export type UsagePeriod = 'hour' | 'day' | 'week' | 'month' | 'all';
+export interface FallbackStrategy {
+    name: string;
+    enabled: boolean;
+    rules: FallbackRule[];
+    maxAttempts: number;
+}
+export interface FallbackRule {
+    condition: 'error' | 'rate_limit' | 'timeout' | 'cost' | 'unavailable';
+    errorCodes?: string[];
+    fallbackProviders: LLMProvider[];
+    fallbackModels?: LLMModel[];
+    retryOriginal: boolean;
+    retryDelay?: number;
+}
+export interface RetryStrategy {
+    maxAttempts: number;
+    initialDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    jitter: boolean;
+    retryableErrors: string[];
+}
+export interface CacheConfig {
+    enabled: boolean;
+    ttl: number;
+    maxSize: number;
+    strategy: 'lru' | 'lfu' | 'ttl';
+    keyGenerator?: (request: LLMRequest) => string;
+}
+export interface CacheEntry {
+    key: string;
+    request: LLMRequest;
+    response: LLMResponse;
+    timestamp: Date;
+    hits: number;
+    size: number;
+}
+export interface RateLimiter {
+    checkLimit(provider: LLMProvider, model?: LLMModel): Promise<boolean>;
+    consumeToken(provider: LLMProvider, tokens: number): Promise<void>;
+    getRemainingTokens(provider: LLMProvider): Promise<number>;
+    getResetTime(provider: LLMProvider): Promise<Date | null>;
+    waitForCapacity(provider: LLMProvider, tokens: number): Promise<void>;
+}
+export interface LoadBalancer {
+    selectProvider(request: LLMRequest, availableProviders: ILLMProvider[]): Promise<ILLMProvider>;
+    updateProviderMetrics(provider: LLMProvider, metrics: ProviderMetrics): void;
+    rebalance(): Promise<void>;
+}
+export interface ProviderMetrics {
+    provider: LLMProvider;
+    timestamp: Date;
+    latency: number;
+    errorRate: number;
+    successRate: number;
+    load: number;
+    cost: number;
+    availability: number;
+}
+export interface ProviderMonitor {
+    trackRequest(provider: LLMProvider, request: LLMRequest, response: LLMResponse | Error): void;
+    getMetrics(provider?: LLMProvider, period?: UsagePeriod): Promise<ProviderMetrics[]>;
+    getAlerts(): Alert[];
+    setAlertThreshold(metric: string, threshold: number): void;
+}
+export interface Alert {
+    id: string;
+    timestamp: Date;
+    provider: LLMProvider;
+    type: 'error_rate' | 'latency' | 'cost' | 'rate_limit' | 'availability';
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    message: string;
+    value: number;
+    threshold: number;
+}
+export interface CostOptimizer {
+    selectOptimalModel(request: LLMRequest, constraints: CostConstraints): Promise<OptimizationResult>;
+    analyzeCostTrends(period: UsagePeriod): Promise<CostAnalysis>;
+    suggestOptimizations(): Promise<OptimizationSuggestion[]>;
+}
+export interface CostConstraints {
+    maxCostPerRequest?: number;
+    maxCostPerToken?: number;
+    preferredProviders?: LLMProvider[];
+    requiredFeatures?: string[];
+    minQuality?: number;
+}
+export interface OptimizationResult {
+    provider: LLMProvider;
+    model: LLMModel;
+    estimatedCost: number;
+    estimatedQuality: number;
+    reasoning: string;
+}
+export interface CostAnalysis {
+    period: UsagePeriod;
+    totalCost: number;
+    costByProvider: Record<LLMProvider, number>;
+    costByModel: Record<LLMModel, number>;
+    trends: {
+        dailyAverage: number;
+        weeklyGrowth: number;
+        projection30Days: number;
+    };
+}
+export interface OptimizationSuggestion {
+    type: 'model_switch' | 'provider_switch' | 'parameter_tuning' | 'caching' | 'batching';
+    description: string;
+    estimatedSavings: number;
+    implementation: string;
+    impact: 'low' | 'medium' | 'high';
+}
+export declare function isLLMResponse(obj: any): obj is LLMResponse;
+export declare function isLLMStreamEvent(obj: any): obj is LLMStreamEvent;
+export declare function isLLMProviderError(error: any): error is LLMProviderError;
+export declare function isRateLimitError(error: any): error is RateLimitError;
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

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

package/dist/providers/types.js

@@ -0,0 +1,61 @@
+/**
+ * Multi-LLM Provider Types and Interfaces
+ * Unified type system for all LLM providers
+ */
+// ===== ERROR HANDLING =====
+export class LLMProviderError extends Error {
+    code;
+    provider;
+    statusCode;
+    retryable;
+    details;
+    constructor(message, code, provider, statusCode, retryable = true, details) {
+        super(message);
+        this.code = code;
+        this.provider = provider;
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+        this.details = details;
+        this.name = 'LLMProviderError';
+    }
+}
+export class RateLimitError extends LLMProviderError {
+    retryAfter;
+    constructor(message, provider, retryAfter, details) {
+        super(message, 'RATE_LIMIT', provider, 429, true, details);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+export class AuthenticationError extends LLMProviderError {
+    constructor(message, provider, details) {
+        super(message, 'AUTHENTICATION', provider, 401, false, details);
+        this.name = 'AuthenticationError';
+    }
+}
+export class ModelNotFoundError extends LLMProviderError {
+    constructor(model, provider, details) {
+        super(`Model ${model} not found`, 'MODEL_NOT_FOUND', provider, 404, false, details);
+        this.name = 'ModelNotFoundError';
+    }
+}
+export class ProviderUnavailableError extends LLMProviderError {
+    constructor(provider, details) {
+        super(`Provider ${provider} is unavailable`, 'PROVIDER_UNAVAILABLE', provider, 503, true, details);
+        this.name = 'ProviderUnavailableError';
+    }
+}
+// ===== TYPE GUARDS =====
+export function isLLMResponse(obj) {
+    return obj && typeof obj.id === 'string' && typeof obj.content === 'string';
+}
+export function isLLMStreamEvent(obj) {
+    return obj && typeof obj.type === 'string';
+}
+export function isLLMProviderError(error) {
+    return error instanceof LLMProviderError;
+}
+export function isRateLimitError(error) {
+    return error instanceof RateLimitError;
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0NH,6BAA6B;AAE7B,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGhC;IACA;IACA;IACA;IACA;IANT,YACE,OAAe,EACR,IAAY,EACZ,QAAqB,EACrB,UAAmB,EACnB,YAAqB,IAAI,EACzB,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QANR,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAa;QACrB,eAAU,GAAV,UAAU,CAAS;QACnB,cAAS,GAAT,SAAS,CAAgB;QACzB,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAIzC;IAHT,YACE,OAAe,EACf,QAAqB,EACd,UAAmB,EAC1B,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAHpD,eAAU,GAAV,UAAU,CAAS;QAI1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YAAY,OAAe,EAAE,QAAqB,EAAE,OAAa;QAC/D,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,KAAa,EAAE,QAAqB,EAAE,OAAa;QAC7D,KAAK,CAAC,SAAS,KAAK,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC5D,YAAY,QAAqB,EAAE,OAAa;QAC9C,KAAK,CAAC,YAAY,QAAQ,iBAAiB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACnG,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAsPD,0BAA0B;AAE1B,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAU;IAC3C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAU;IACzC,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC"}

package/dist/providers/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Utility functions for multi-LLM provider system
+ */
+import { ILogger } from '../core/logger.js';
+import { ConfigManager } from '../config/config-manager.js';
+import { ProviderManager, ProviderManagerConfig } from './provider-manager.js';
+import { LLMProvider, LLMProviderConfig } from './types.js';
+/**
+ * Create a provider manager with default configuration
+ */
+export declare function createProviderManager(logger: ILogger, configManager: ConfigManager, customConfig?: Partial<ProviderManagerConfig>): ProviderManager;
+/**
+ * Get default provider configuration
+ */
+export declare function getDefaultProviderConfig(): ProviderManagerConfig;
+/**
+ * Validate provider configuration
+ */
+export declare function validateProviderConfig(config: LLMProviderConfig): string[];
+/**
+ * Get model recommendations based on use case
+ */
+export declare function getModelRecommendations(useCase: string): {
+    provider: LLMProvider;
+    model: string;
+    reasoning: string;
+}[];
+/**
+ * Calculate estimated monthly cost based on usage
+ */
+export declare function estimateMonthlyCost(provider: LLMProvider, model: string, estimatedRequests: number, avgTokensPerRequest: number): {
+    promptCost: number;
+    completionCost: number;
+    totalCost: number;
+    currency: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/providers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,aAAa,EAC5B,YAAY,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAC5C,eAAe,CAQjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAmFhE;AAyED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAoC1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,EAAE,CAiEF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,mBAAmB,EAAE,MAAM,GAC1B;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA0BA"}