agentic-qe 2.1.1 → 2.2.0

package/dist/providers/ILLMProvider.d.ts

@@ -0,0 +1,287 @@
+/**
+ * LLM Provider Abstraction Layer
+ *
+ * Unified interface for multiple LLM providers (Claude API, local ruvllm, etc.)
+ * Enables hybrid routing between local and cloud inference.
+ *
+ * @module providers/ILLMProvider
+ */
+/**
+ * Message parameter for LLM requests
+ */
+export interface LLMMessageParam {
+    role: 'user' | 'assistant' | 'system';
+    content: string | Array<{
+        type: 'text' | 'image';
+        text?: string;
+        source?: {
+            type: 'base64';
+            media_type: string;
+            data: string;
+        };
+    }>;
+}
+/**
+ * Text block parameter for system prompts
+ */
+export interface LLMTextBlockParam {
+    type: 'text';
+    text: string;
+    cache_control?: {
+        type: 'ephemeral';
+    };
+}
+/**
+ * Options for LLM completion requests
+ */
+export interface LLMCompletionOptions {
+    /** Model identifier (e.g., 'claude-sonnet-4', 'ruvllm-7b') */
+    model: string;
+    /** System prompts (supports caching with cache_control) */
+    system?: LLMTextBlockParam[];
+    /** Conversation messages */
+    messages: LLMMessageParam[];
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Temperature for sampling (0.0-1.0) */
+    temperature?: number;
+    /** Enable streaming responses */
+    stream?: boolean;
+    /** Additional provider-specific options */
+    metadata?: Record<string, any>;
+}
+/**
+ * Response from LLM completion
+ */
+export interface LLMCompletionResponse {
+    /** Response content */
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    /** Token usage statistics */
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
+    };
+    /** Model used for completion */
+    model: string;
+    /** Stop reason */
+    stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence';
+    /** Unique request ID */
+    id: string;
+    /** Response metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Stream event from LLM
+ */
+export interface LLMStreamEvent {
+    type: 'content_block_start' | 'content_block_delta' | 'content_block_stop' | 'message_start' | 'message_delta' | 'message_stop';
+    delta?: {
+        type: 'text_delta';
+        text: string;
+    };
+    content_block?: {
+        type: 'text';
+        text: string;
+    };
+    message?: Partial<LLMCompletionResponse>;
+}
+/**
+ * Options for embedding generation
+ */
+export interface LLMEmbeddingOptions {
+    /** Text to embed */
+    text: string;
+    /** Model for embedding (optional, provider may have default) */
+    model?: string;
+    /** Dimensions for embedding (optional) */
+    dimensions?: number;
+}
+/**
+ * Response from embedding generation
+ */
+export interface LLMEmbeddingResponse {
+    /** Embedding vector */
+    embedding: number[];
+    /** Model used */
+    model: string;
+    /** Token count */
+    tokens: number;
+}
+/**
+ * Provider health status
+ */
+export interface LLMHealthStatus {
+    /** Provider is healthy and ready */
+    healthy: boolean;
+    /** Latency in milliseconds */
+    latency?: number;
+    /** Error message if unhealthy */
+    error?: string;
+    /** Last check timestamp */
+    timestamp: Date;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Provider capabilities and metadata
+ */
+export interface LLMProviderMetadata {
+    /** Provider name (e.g., 'claude', 'ruvllm') */
+    name: string;
+    /** Provider version */
+    version: string;
+    /** Supported models */
+    models: string[];
+    /** Capabilities */
+    capabilities: {
+        /** Supports streaming */
+        streaming: boolean;
+        /** Supports prompt caching */
+        caching: boolean;
+        /** Supports embeddings */
+        embeddings: boolean;
+        /** Supports vision/multimodal */
+        vision: boolean;
+    };
+    /** Cost per million tokens (input/output) */
+    costs: {
+        inputPerMillion: number;
+        outputPerMillion: number;
+        cacheWriteMultiplier?: number;
+        cacheReadMultiplier?: number;
+    };
+    /** Local or cloud provider */
+    location: 'local' | 'cloud';
+}
+/**
+ * Token counting options
+ */
+export interface LLMTokenCountOptions {
+    /** Text to count tokens for */
+    text: string;
+    /** Model to use for counting (may affect tokenization) */
+    model?: string;
+}
+/**
+ * ILLMProvider - Unified interface for LLM providers
+ *
+ * Abstracts differences between providers (Claude API, ruvllm, etc.)
+ * to enable hybrid routing and provider switching at runtime.
+ *
+ * @example
+ * ```typescript
+ * const provider = new ClaudeProvider({ apiKey: 'sk-...' });
+ * await provider.initialize();
+ *
+ * const response = await provider.complete({
+ *   model: 'claude-sonnet-4',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   maxTokens: 1024
+ * });
+ * ```
+ */
+export interface ILLMProvider {
+    /**
+     * Initialize the provider
+     *
+     * Sets up connections, validates credentials, loads models, etc.
+     *
+     * @throws {Error} If initialization fails
+     */
+    initialize(): Promise<void>;
+    /**
+     * Complete a prompt with the LLM
+     *
+     * @param options - Completion options
+     * @returns Completion response
+     * @throws {Error} If request fails
+     */
+    complete(options: LLMCompletionOptions): Promise<LLMCompletionResponse>;
+    /**
+     * Complete a prompt with streaming
+     *
+     * @param options - Completion options (stream enabled)
+     * @returns Async iterator of stream events
+     * @throws {Error} If request fails
+     */
+    streamComplete(options: LLMCompletionOptions): AsyncIterableIterator<LLMStreamEvent>;
+    /**
+     * Generate embeddings for text
+     *
+     * @param options - Embedding options
+     * @returns Embedding response
+     * @throws {Error} If embeddings not supported or request fails
+     */
+    embed(options: LLMEmbeddingOptions): Promise<LLMEmbeddingResponse>;
+    /**
+     * Count tokens in text
+     *
+     * @param options - Token counting options
+     * @returns Token count
+     */
+    countTokens(options: LLMTokenCountOptions): Promise<number>;
+    /**
+     * Health check
+     *
+     * Verifies provider is operational and responsive.
+     *
+     * @returns Health status
+     */
+    healthCheck(): Promise<LLMHealthStatus>;
+    /**
+     * Get provider metadata
+     *
+     * Returns information about the provider's capabilities, costs, and models.
+     *
+     * @returns Provider metadata
+     */
+    getMetadata(): LLMProviderMetadata;
+    /**
+     * Gracefully shutdown the provider
+     *
+     * Closes connections, releases resources, etc.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Track cost for a request
+     *
+     * Internal method to track token usage and calculate costs.
+     *
+     * @param usage - Token usage from response
+     * @returns Cost in dollars
+     */
+    trackCost(usage: LLMCompletionResponse['usage']): number;
+}
+/**
+ * Provider configuration base
+ */
+export interface LLMProviderConfig {
+    /** Provider name for logging/identification */
+    name?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Maximum retries on failure */
+    maxRetries?: number;
+}
+/**
+ * Error thrown by LLM providers
+ */
+export declare class LLMProviderError extends Error {
+    readonly provider: string;
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly cause?: Error | undefined;
+    constructor(message: string, provider: string, code: string, retryable?: boolean, cause?: Error | undefined);
+}
+/**
+ * Type guard for checking if error is LLMProviderError
+ */
+export declare function isLLMProviderError(error: unknown): error is LLMProviderError;
+//# sourceMappingURL=ILLMProvider.d.ts.map

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

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

package/dist/providers/ILLMProvider.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * LLM Provider Abstraction Layer
+ *
+ * Unified interface for multiple LLM providers (Claude API, local ruvllm, etc.)
+ * Enables hybrid routing between local and cloud inference.
+ *
+ * @module providers/ILLMProvider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMProviderError = void 0;
+exports.isLLMProviderError = isLLMProviderError;
+/**
+ * Error thrown by LLM providers
+ */
+class LLMProviderError extends Error {
+    constructor(message, provider, code, retryable = false, cause) {
+        super(message);
+        this.provider = provider;
+        this.code = code;
+        this.retryable = retryable;
+        this.cause = cause;
+        this.name = 'LLMProviderError';
+    }
+}
+exports.LLMProviderError = LLMProviderError;
+/**
+ * Type guard for checking if error is LLMProviderError
+ */
+function isLLMProviderError(error) {
+    return error instanceof LLMProviderError;
+}
+//# sourceMappingURL=ILLMProvider.js.map

package/dist/providers/ILLMProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILLMProvider.js","sourceRoot":"","sources":["../../src/providers/ILLMProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA8SH,gDAEC;AArBD;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YACE,OAAe,EACC,QAAgB,EAChB,IAAY,EACZ,YAAqB,KAAK,EAC1B,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAAiB;QAC1B,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAXD,4CAWC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC"}

package/dist/providers/LLMProviderFactory.d.ts

@@ -0,0 +1,154 @@
+/**
+ * LLMProviderFactory - Factory for creating and managing LLM providers
+ *
+ * Provides centralized creation and routing of LLM providers with support for:
+ * - Provider registration and discovery
+ * - Automatic provider selection based on capabilities/cost
+ * - Hybrid routing between local and cloud providers
+ * - Fallback chains for reliability
+ * - Health-based routing
+ *
+ * @module providers/LLMProviderFactory
+ * @version 1.0.0
+ */
+import { ILLMProvider, LLMProviderMetadata } from './ILLMProvider';
+import { ClaudeProviderConfig } from './ClaudeProvider';
+import { RuvllmProviderConfig } from './RuvllmProvider';
+/**
+ * Provider type enumeration
+ */
+export type ProviderType = 'claude' | 'ruvllm' | 'auto';
+/**
+ * Provider selection criteria
+ */
+export interface ProviderSelectionCriteria {
+    /** Prefer local providers */
+    preferLocal?: boolean;
+    /** Prefer low-cost providers */
+    preferLowCost?: boolean;
+    /** Required capabilities */
+    requiredCapabilities?: Array<keyof LLMProviderMetadata['capabilities']>;
+    /** Maximum cost per million tokens */
+    maxCostPerMillion?: number;
+    /** Required models */
+    requiredModels?: string[];
+}
+/**
+ * Factory configuration
+ */
+export interface LLMProviderFactoryConfig {
+    /** Claude provider configuration */
+    claude?: ClaudeProviderConfig;
+    /** Ruvllm provider configuration */
+    ruvllm?: RuvllmProviderConfig;
+    /** Default provider to use */
+    defaultProvider?: ProviderType;
+    /** Enable automatic fallback */
+    enableFallback?: boolean;
+    /** Health check interval in milliseconds */
+    healthCheckInterval?: number;
+    /** Maximum consecutive failures before marking unhealthy */
+    maxConsecutiveFailures?: number;
+}
+/**
+ * Provider usage statistics
+ */
+export interface ProviderUsageStats {
+    requestCount: number;
+    successCount: number;
+    failureCount: number;
+    totalCost: number;
+    averageLatency: number;
+}
+/**
+ * LLMProviderFactory - Central factory for LLM provider management
+ *
+ * This factory provides:
+ * - Unified provider creation and initialization
+ * - Intelligent provider selection based on criteria
+ * - Automatic health monitoring and fallback
+ * - Cost and usage tracking
+ * - Hybrid local/cloud routing
+ */
+export declare class LLMProviderFactory {
+    private readonly logger;
+    private config;
+    private providers;
+    private usageStats;
+    private healthCheckTimer?;
+    private isInitialized;
+    constructor(config?: LLMProviderFactoryConfig);
+    /**
+     * Initialize the factory and all configured providers
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a provider by type
+     */
+    getProvider(type: ProviderType): ILLMProvider | undefined;
+    /**
+     * Select best provider based on criteria
+     */
+    selectBestProvider(criteria?: ProviderSelectionCriteria): ILLMProvider | undefined;
+    /**
+     * Execute with automatic fallback
+     */
+    executeWithFallback<T>(operation: (provider: ILLMProvider) => Promise<T>, preferredProvider?: ProviderType): Promise<T>;
+    /**
+     * Get all available provider types
+     */
+    getAvailableProviders(): ProviderType[];
+    /**
+     * Get provider metadata
+     */
+    getProviderMetadata(type: ProviderType): LLMProviderMetadata | undefined;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(type?: ProviderType): Map<ProviderType, ProviderUsageStats> | ProviderUsageStats | undefined;
+    /**
+     * Get combined usage cost
+     */
+    getTotalCost(): number;
+    /**
+     * Shutdown all providers
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Register a custom provider
+     */
+    registerProvider(type: ProviderType, provider: ILLMProvider): Promise<void>;
+    /**
+     * Initialize a specific provider
+     */
+    private initializeProvider;
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Perform health checks on all providers
+     */
+    private performHealthChecks;
+    /**
+     * Get provider order for fallback
+     */
+    private getProviderOrder;
+    /**
+     * Update usage statistics
+     */
+    private updateUsageStats;
+    /**
+     * Create a hybrid router that automatically selects the best provider
+     */
+    createHybridRouter(): ILLMProvider;
+}
+/**
+ * Get the global LLM provider factory instance
+ */
+export declare function getGlobalLLMFactory(): LLMProviderFactory;
+/**
+ * Set the global LLM provider factory instance
+ */
+export declare function setGlobalLLMFactory(factory: LLMProviderFactory): void;
+//# sourceMappingURL=LLMProviderFactory.d.ts.map

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

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