@sparkleideas/providers 3.0.0-alpha.6-patch.26 → 3.0.0-alpha.6-patch.27

package/dist/types.d.ts

@@ -0,0 +1,280 @@
+/**
+ * V3 LLM Provider Types
+ *
+ * Unified type system for all LLM providers with enhanced
+ * cost tracking, model capabilities, and error handling.
+ *
+ * @module @sparkleideas/providers/types
+ */
+import { EventEmitter } from 'events';
+export type LLMProvider = 'anthropic' | 'openai' | 'google' | 'cohere' | 'ollama' | 'ruvector' | 'openrouter' | 'litellm' | 'custom';
+export type LLMModel = 'claude-3-5-sonnet-20241022' | 'claude-3-5-sonnet-latest' | 'claude-3-opus-20240229' | 'claude-3-sonnet-20240229' | 'claude-3-haiku-20240307' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4-turbo' | 'gpt-4' | 'gpt-3.5-turbo' | 'o1-preview' | 'o1-mini' | 'o3-mini' | 'gemini-2.0-flash' | 'gemini-1.5-pro' | 'gemini-1.5-flash' | 'gemini-pro' | 'command-r-plus' | 'command-r' | 'command-light' | 'command' | 'llama3.2' | 'llama3.1' | 'mistral' | 'mixtral' | 'codellama' | 'phi-4' | 'deepseek-coder' | 'custom-model' | string;
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | LLMContentPart[];
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: LLMToolCall[];
+}
+export interface LLMContentPart {
+    type: 'text' | 'image' | 'audio';
+    text?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    audioUrl?: string;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMTool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+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, unknown>;
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    enableStreaming?: boolean;
+    enableCaching?: boolean;
+    cacheTimeout?: number;
+    enableCostOptimization?: boolean;
+    maxCostPerRequest?: number;
+    fallbackModels?: LLMModel[];
+}
+export interface LLMRequest {
+    messages: LLMMessage[];
+    model?: LLMModel;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    stopSequences?: string[];
+    stream?: boolean;
+    tools?: LLMTool[];
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    providerOptions?: Record<string, unknown>;
+    costConstraints?: {
+        maxCost?: number;
+        preferredModels?: LLMModel[];
+    };
+    requestId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LLMResponse {
+    id: string;
+    model: LLMModel;
+    provider: LLMProvider;
+    content: string;
+    toolCalls?: LLMToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    cost?: {
+        promptCost: number;
+        completionCost: number;
+        totalCost: number;
+        currency: string;
+    };
+    latency?: number;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    metadata?: Record<string, unknown>;
+}
+export interface LLMStreamEvent {
+    type: 'content' | 'tool_call' | 'error' | 'done';
+    delta?: {
+        content?: string;
+        toolCall?: Partial<LLMToolCall>;
+    };
+    error?: Error;
+    usage?: LLMResponse['usage'];
+    cost?: LLMResponse['cost'];
+}
+export interface ProviderCapabilities {
+    supportedModels: LLMModel[];
+    maxContextLength: Record<string, number>;
+    maxOutputTokens: Record<string, number>;
+    supportsStreaming: boolean;
+    supportsToolCalling: boolean;
+    supportsSystemMessages: boolean;
+    supportsVision: boolean;
+    supportsAudio: boolean;
+    supportsFineTuning: boolean;
+    supportsEmbeddings: boolean;
+    supportsBatching: boolean;
+    rateLimit?: {
+        requestsPerMinute: number;
+        tokensPerMinute: number;
+        concurrentRequests: number;
+    };
+    pricing: Record<string, {
+        promptCostPer1k: number;
+        completionCostPer1k: number;
+        currency: string;
+    }>;
+}
+export declare class LLMProviderError extends Error {
+    code: string;
+    provider: LLMProvider;
+    statusCode?: number;
+    retryable: boolean;
+    details?: unknown;
+    constructor(message: string, code: string, provider: LLMProvider, statusCode?: number, retryable?: boolean, details?: unknown);
+}
+export declare class RateLimitError extends LLMProviderError {
+    retryAfter?: number;
+    constructor(message: string, provider: LLMProvider, retryAfter?: number, details?: unknown);
+}
+export declare class AuthenticationError extends LLMProviderError {
+    constructor(message: string, provider: LLMProvider, details?: unknown);
+}
+export declare class ModelNotFoundError extends LLMProviderError {
+    constructor(model: string, provider: LLMProvider, details?: unknown);
+}
+export declare class ProviderUnavailableError extends LLMProviderError {
+    constructor(provider: LLMProvider, details?: unknown);
+}
+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;
+    recommendedReplacement?: LLMModel;
+}
+export interface HealthCheckResult {
+    healthy: boolean;
+    latency?: number;
+    error?: string;
+    timestamp: Date;
+    details?: Record<string, unknown>;
+}
+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<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+}
+export type UsagePeriod = 'hour' | 'day' | 'week' | 'month' | 'all';
+export type LoadBalancingStrategy = 'round-robin' | 'least-loaded' | 'latency-based' | 'cost-based';
+export interface ProviderManagerConfig {
+    providers: LLMProviderConfig[];
+    defaultProvider?: LLMProvider;
+    loadBalancing?: {
+        enabled: boolean;
+        strategy: LoadBalancingStrategy;
+    };
+    fallback?: {
+        enabled: boolean;
+        maxAttempts: number;
+    };
+    cache?: {
+        enabled: boolean;
+        ttl: number;
+        maxSize: number;
+    };
+    costOptimization?: {
+        enabled: boolean;
+        maxCostPerRequest?: number;
+    };
+}
+export declare function isLLMResponse(obj: unknown): obj is LLMResponse;
+export declare function isLLMStreamEvent(obj: unknown): obj is LLMStreamEvent;
+export declare function isLLMProviderError(error: unknown): error is LLMProviderError;
+export declare function isRateLimitError(error: unknown): error is RateLimitError;
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,QAAQ,GAEhB,4BAA4B,GAC5B,0BAA0B,GAC1B,wBAAwB,GACxB,0BAA0B,GAC1B,yBAAyB,GAEzB,QAAQ,GACR,aAAa,GACb,aAAa,GACb,OAAO,GACP,eAAe,GACf,YAAY,GACZ,SAAS,GACT,SAAS,GAET,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,YAAY,GAEZ,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,SAAS,GAET,UAAU,GACV,UAAU,GACV,SAAS,GACT,SAAS,GACT,WAAW,GACX,OAAO,GACP,gBAAgB,GAEhB,cAAc,GACd,MAAM,CAAC;AAIX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAGhB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAGzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAG7F,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG1C,eAAe,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;KAC9B,CAAC;IAGF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IAGtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAG1B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAGF,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAGF,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAID,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGxC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IAGvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAG1B,SAAS,CAAC,EAAE;QACV,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IAGF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAID,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,UAAU,CAAC,EAAE,MAAM;IACnB,SAAS,EAAE,OAAO;IAClB,OAAO,CAAC,EAAE,OAAO;gBALxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,GAAE,OAAc,EACzB,OAAO,CAAC,EAAE,OAAO;CAK3B;AAED,qBAAa,cAAe,SAAQ,gBAAgB;IAIzC,UAAU,CAAC,EAAE,MAAM;gBAF1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EACd,UAAU,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;CAItE;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;CAIpE;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;gBAChD,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;CAIrD;AAID,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,MAAM,EAAE,iBAAiB,CAAC;IAG1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAGnE,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClC,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAGxC,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,SAAS,IAAI,cAAc,CAAC;IAG5B,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAGpD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB,CAAC,EAAE,QAAQ,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAIpE,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;AAEpG,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,qBAAqB,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAQ9D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAOpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE"}

package/dist/types.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * V3 LLM Provider Types
+ *
+ * Unified type system for all LLM providers with enhanced
+ * cost tracking, model capabilities, and error handling.
+ *
+ * @module @sparkleideas/providers/types
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderUnavailableError = exports.ModelNotFoundError = exports.AuthenticationError = exports.RateLimitError = exports.LLMProviderError = void 0;
+exports.isLLMResponse = isLLMResponse;
+exports.isLLMStreamEvent = isLLMStreamEvent;
+exports.isLLMProviderError = isLLMProviderError;
+exports.isRateLimitError = isRateLimitError;
+// ===== ERROR TYPES =====
+var LLMProviderError = /** @class */ (function (_super) {
+    __extends(LLMProviderError, _super);
+    function LLMProviderError(message, code, provider, statusCode, retryable, details) {
+        if (retryable === void 0) { retryable = true; }
+        var _this = _super.call(this, message) || this;
+        _this.code = code;
+        _this.provider = provider;
+        _this.statusCode = statusCode;
+        _this.retryable = retryable;
+        _this.details = details;
+        _this.name = 'LLMProviderError';
+        return _this;
+    }
+    return LLMProviderError;
+}(Error));
+exports.LLMProviderError = LLMProviderError;
+var RateLimitError = /** @class */ (function (_super) {
+    __extends(RateLimitError, _super);
+    function RateLimitError(message, provider, retryAfter, details) {
+        var _this = _super.call(this, message, 'RATE_LIMIT', provider, 429, true, details) || this;
+        _this.retryAfter = retryAfter;
+        _this.name = 'RateLimitError';
+        return _this;
+    }
+    return RateLimitError;
+}(LLMProviderError));
+exports.RateLimitError = RateLimitError;
+var AuthenticationError = /** @class */ (function (_super) {
+    __extends(AuthenticationError, _super);
+    function AuthenticationError(message, provider, details) {
+        var _this = _super.call(this, message, 'AUTHENTICATION', provider, 401, false, details) || this;
+        _this.name = 'AuthenticationError';
+        return _this;
+    }
+    return AuthenticationError;
+}(LLMProviderError));
+exports.AuthenticationError = AuthenticationError;
+var ModelNotFoundError = /** @class */ (function (_super) {
+    __extends(ModelNotFoundError, _super);
+    function ModelNotFoundError(model, provider, details) {
+        var _this = _super.call(this, "Model ".concat(model, " not found"), 'MODEL_NOT_FOUND', provider, 404, false, details) || this;
+        _this.name = 'ModelNotFoundError';
+        return _this;
+    }
+    return ModelNotFoundError;
+}(LLMProviderError));
+exports.ModelNotFoundError = ModelNotFoundError;
+var ProviderUnavailableError = /** @class */ (function (_super) {
+    __extends(ProviderUnavailableError, _super);
+    function ProviderUnavailableError(provider, details) {
+        var _this = _super.call(this, "Provider ".concat(provider, " is unavailable"), 'PROVIDER_UNAVAILABLE', provider, 503, true, details) || this;
+        _this.name = 'ProviderUnavailableError';
+        return _this;
+    }
+    return ProviderUnavailableError;
+}(LLMProviderError));
+exports.ProviderUnavailableError = ProviderUnavailableError;
+// ===== TYPE GUARDS =====
+function isLLMResponse(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'id' in obj &&
+        'content' in obj &&
+        'provider' in obj);
+}
+function isLLMStreamEvent(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'type' in obj &&
+        ['content', 'tool_call', 'error', 'done'].includes(obj.type));
+}
+function isLLMProviderError(error) {
+    return error instanceof LLMProviderError;
+}
+function isRateLimitError(error) {
+    return error instanceof RateLimitError;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkleideas/providers",
-  "version": "3.0.0-alpha.6-patch.26",
+  "version": "3.0.0-alpha.6-patch.27",
   "description": "Multi-LLM Provider System for Claude Flow V3",
   "main": "dist/index.js",
   "module": "dist/index.js",