agentic-qe 2.6.0 → 2.6.2

package/dist/agents/adapters/AgentLLMAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentLLMAdapter.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/AgentLLMAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,YAAY,EAKb,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EACV,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,cAAc,EACf,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;IAEvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0H;IACjJ,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,KAAK,CASX;gBAEU,MAAM,EAAE,qBAAqB;IA+BzC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBjF;;OAEG;IACI,cAAc,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAAC,MAAM,CAAC;IA2ChC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS5C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAwBrD;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACH,aAAa,IAAI,eAAe;IAwBhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAqBlB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAsClB;;OAEG;IACH,OAAO,CAAC,cAAc;CAwCvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC,GACxD,SAAS,CAKX"}

package/dist/agents/adapters/AgentLLMAdapter.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * Agent LLM Adapter - Bridges ILLMProvider to IAgentLLM
+ *
+ * Phase 1.2.2: Provides the implementation that wraps any ILLMProvider
+ * and presents the simplified IAgentLLM interface to agents.
+ *
+ * Features:
+ * - Wraps any ILLMProvider (RuvllmProvider, ClaudeProvider, HybridRouter)
+ * - Tracks usage statistics per agent
+ * - Handles complexity-based routing when using HybridRouter
+ * - Integrates with RuVector caching automatically
+ * - Provides clear error handling
+ *
+ * @module agents/adapters/AgentLLMAdapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLLMAdapter = void 0;
+exports.createAgentLLM = createAgentLLM;
+const IAgentLLM_1 = require("../interfaces/IAgentLLM");
+/**
+ * AgentLLMAdapter - Implementation of IAgentLLM
+ *
+ * This adapter wraps any ILLMProvider and exposes the simplified IAgentLLM interface.
+ * It handles:
+ * - Message construction from simple prompts
+ * - Usage statistics tracking
+ * - Complexity-based routing (when HybridRouter is available)
+ * - Error translation to AgentLLMError
+ * - Model management
+ */
+class AgentLLMAdapter {
+    constructor(config) {
+        this.provider = config.provider;
+        this.hybridRouter = config.hybridRouter;
+        this.agentId = config.agentId || 'unknown-agent';
+        // Get provider metadata for defaults
+        const metadata = this.provider.getMetadata();
+        this.config = {
+            defaultModel: config.defaultModel || metadata.models[0] || 'auto',
+            defaultTemperature: config.defaultTemperature ?? 0.7,
+            defaultMaxTokens: config.defaultMaxTokens ?? 2048,
+            debug: config.debug ?? false,
+            agentId: config.agentId,
+        };
+        this.currentModel = this.config.defaultModel;
+        // Initialize stats
+        this.stats = {
+            requestCount: 0,
+            tokensUsed: 0,
+            costIncurred: 0,
+            totalLatency: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            localRequests: 0,
+            cloudRequests: 0,
+        };
+    }
+    /**
+     * Complete a prompt
+     */
+    async complete(prompt, options) {
+        const startTime = Date.now();
+        try {
+            // Build LLM completion options
+            const completionOptions = this.buildCompletionOptions(prompt, options);
+            // Execute completion
+            const response = await this.provider.complete(completionOptions);
+            // Track usage
+            this.trackUsage(response, Date.now() - startTime);
+            // Extract and return text
+            return this.extractText(response);
+        }
+        catch (error) {
+            throw this.translateError(error);
+        }
+    }
+    /**
+     * Stream a completion
+     */
+    async *streamComplete(prompt, options) {
+        const startTime = Date.now();
+        try {
+            // Build completion options with streaming enabled
+            const completionOptions = this.buildCompletionOptions(prompt, {
+                ...options,
+                stream: true,
+            });
+            // Stream from provider
+            let totalTokens = 0;
+            let fullText = '';
+            for await (const event of this.provider.streamComplete(completionOptions)) {
+                // Extract text delta
+                if (event.type === 'content_block_delta' && event.delta?.type === 'text_delta') {
+                    const chunk = event.delta.text;
+                    fullText += chunk;
+                    yield chunk;
+                }
+                // Track final usage
+                if (event.type === 'message_stop' && event.message) {
+                    if (event.message.usage) {
+                        totalTokens = event.message.usage.input_tokens + event.message.usage.output_tokens;
+                    }
+                }
+            }
+            // Track completion stats
+            this.stats.requestCount++;
+            this.stats.tokensUsed += totalTokens;
+            this.stats.totalLatency += Date.now() - startTime;
+            if (this.config.debug) {
+                console.log(`[${this.agentId}] Stream completed: ${totalTokens} tokens, ${Date.now() - startTime}ms`);
+            }
+        }
+        catch (error) {
+            throw this.translateError(error);
+        }
+    }
+    /**
+     * Generate embeddings
+     */
+    async embed(text) {
+        try {
+            const response = await this.provider.embed({ text });
+            return response.embedding;
+        }
+        catch (error) {
+            throw this.translateError(error);
+        }
+    }
+    /**
+     * Get available models
+     */
+    async getAvailableModels() {
+        try {
+            const metadata = this.provider.getMetadata();
+            return metadata.models.map(modelId => ({
+                id: modelId,
+                name: modelId,
+                provider: metadata.name,
+                capabilities: {
+                    maxTokens: 4096, // Default, could be model-specific
+                    streaming: metadata.capabilities.streaming,
+                    vision: metadata.capabilities.vision,
+                    functionCalling: false, // Not exposed yet
+                },
+                cost: metadata.location === 'cloud' ? {
+                    inputPerMillion: metadata.costs.inputPerMillion,
+                    outputPerMillion: metadata.costs.outputPerMillion,
+                } : undefined,
+            }));
+        }
+        catch (error) {
+            throw this.translateError(error);
+        }
+    }
+    /**
+     * Get current model
+     */
+    getCurrentModel() {
+        return this.currentModel;
+    }
+    /**
+     * Switch model
+     */
+    async switchModel(model) {
+        // Validate model exists
+        const metadata = this.provider.getMetadata();
+        if (!metadata.models.includes(model)) {
+            throw new IAgentLLM_1.AgentLLMError(`Model '${model}' not available. Available models: ${metadata.models.join(', ')}`, 'MODEL_NOT_FOUND', false);
+        }
+        this.currentModel = model;
+        if (this.config.debug) {
+            console.log(`[${this.agentId}] Switched to model: ${model}`);
+        }
+    }
+    /**
+     * Health check
+     */
+    async isHealthy() {
+        try {
+            const health = await this.provider.healthCheck();
+            return health.healthy;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get usage statistics
+     */
+    getUsageStats() {
+        const avgLatency = this.stats.requestCount > 0
+            ? this.stats.totalLatency / this.stats.requestCount
+            : 0;
+        const totalCacheRequests = this.stats.cacheHits + this.stats.cacheMisses;
+        const cacheHitRate = totalCacheRequests > 0
+            ? this.stats.cacheHits / totalCacheRequests
+            : undefined;
+        return {
+            requestCount: this.stats.requestCount,
+            tokensUsed: this.stats.tokensUsed,
+            costIncurred: this.stats.costIncurred,
+            averageLatency: avgLatency,
+            cacheHitRate,
+            routingBreakdown: {
+                local: this.stats.localRequests,
+                cloud: this.stats.cloudRequests,
+                cache: this.stats.cacheHits,
+            },
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            requestCount: 0,
+            tokensUsed: 0,
+            costIncurred: 0,
+            totalLatency: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            localRequests: 0,
+            cloudRequests: 0,
+        };
+        if (this.config.debug) {
+            console.log(`[${this.agentId}] Stats reset`);
+        }
+    }
+    // ============================================
+    // Private Helper Methods
+    // ============================================
+    /**
+     * Build LLMCompletionOptions from simplified AgentCompletionOptions
+     */
+    buildCompletionOptions(prompt, options) {
+        const systemPrompt = options?.systemPrompt;
+        const system = systemPrompt ? [
+            {
+                type: 'text',
+                text: systemPrompt,
+                ...(options?.cacheKey ? { cache_control: { type: 'ephemeral' } } : {}),
+            },
+        ] : undefined;
+        const completionOptions = {
+            model: this.currentModel,
+            system,
+            messages: [
+                {
+                    role: 'user',
+                    content: prompt,
+                },
+            ],
+            maxTokens: options?.maxTokens ?? this.config.defaultMaxTokens,
+            temperature: options?.temperature ?? this.config.defaultTemperature,
+            stream: options?.stream ?? false,
+            metadata: {
+                agentId: this.agentId,
+                cacheKey: options?.cacheKey,
+                complexity: options?.complexity,
+                ...options?.metadata,
+            },
+        };
+        return completionOptions;
+    }
+    /**
+     * Extract text from LLMCompletionResponse
+     */
+    extractText(response) {
+        return response.content
+            .filter(block => block.type === 'text')
+            .map(block => block.text)
+            .join('\n');
+    }
+    /**
+     * Track usage from response
+     */
+    trackUsage(response, latency) {
+        this.stats.requestCount++;
+        this.stats.totalLatency += latency;
+        // Track tokens
+        const tokens = response.usage.input_tokens + response.usage.output_tokens;
+        this.stats.tokensUsed += tokens;
+        // Track cost (if available)
+        if (this.provider.trackCost) {
+            const cost = this.provider.trackCost(response.usage);
+            this.stats.costIncurred += cost;
+        }
+        // Track cache hits/misses
+        if (response.usage.cache_read_input_tokens && response.usage.cache_read_input_tokens > 0) {
+            this.stats.cacheHits++;
+        }
+        else if (response.usage.input_tokens > 0) {
+            this.stats.cacheMisses++;
+        }
+        // Track routing (if metadata available from HybridRouter)
+        if (response.metadata?.source === 'cache' || response.model === 'ruvector-cache') {
+            this.stats.cacheHits++;
+        }
+        else if (response.metadata?.routingDecision) {
+            const decision = response.metadata.routingDecision;
+            if (decision.provider === 'local') {
+                this.stats.localRequests++;
+            }
+            else if (decision.provider === 'cloud') {
+                this.stats.cloudRequests++;
+            }
+        }
+        if (this.config.debug) {
+            console.log(`[${this.agentId}] Request completed: ${tokens} tokens, ${latency}ms, cost: $${this.stats.costIncurred.toFixed(6)}`);
+        }
+    }
+    /**
+     * Translate provider errors to AgentLLMError
+     */
+    translateError(error) {
+        if (error instanceof IAgentLLM_1.AgentLLMError) {
+            return error;
+        }
+        // Check if it's an LLMProviderError
+        const providerError = error;
+        if (providerError.name === 'LLMProviderError') {
+            let code;
+            switch (providerError.code) {
+                case 'PROVIDER_UNAVAILABLE':
+                case 'NO_PROVIDERS':
+                case 'NOT_INITIALIZED':
+                    code = 'UNAVAILABLE';
+                    break;
+                case 'UNSUPPORTED':
+                    code = 'UNSUPPORTED';
+                    break;
+                default:
+                    code = 'REQUEST_FAILED';
+            }
+            return new IAgentLLM_1.AgentLLMError(providerError.message, code, providerError.retryable, providerError.cause);
+        }
+        // Generic error
+        const message = error instanceof Error ? error.message : String(error);
+        return new IAgentLLM_1.AgentLLMError(`LLM request failed: ${message}`, 'REQUEST_FAILED', false, error instanceof Error ? error : undefined);
+    }
+}
+exports.AgentLLMAdapter = AgentLLMAdapter;
+/**
+ * Factory function to create AgentLLMAdapter
+ *
+ * @param provider - The LLM provider to wrap
+ * @param config - Optional configuration
+ * @returns IAgentLLM instance
+ *
+ * @example
+ * ```typescript
+ * const llm = createAgentLLM(ruvllmProvider, {
+ *   agentId: 'test-generator-1',
+ *   defaultModel: 'llama-3.2-3b-instruct',
+ *   defaultTemperature: 0.2
+ * });
+ * ```
+ */
+function createAgentLLM(provider, config) {
+    return new AgentLLMAdapter({
+        provider,
+        ...config,
+    });
+}
+//# sourceMappingURL=AgentLLMAdapter.js.map

package/dist/agents/adapters/AgentLLMAdapter.js.map

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

package/dist/agents/adapters/index.d.ts

@@ -11,4 +11,5 @@ export { LifecycleManagerAdapter, createLifecycleAdapter, } from './LifecycleMan
 export { MemoryServiceAdapter, createMemoryAdapter, type AgentLocalMemoryStrategy, } from './MemoryServiceAdapter';
 export { LearningEngineAdapter, createLearningAdapter, } from './LearningEngineAdapter';
 export { CoordinatorAdapter, createCoordinationAdapter, } from './CoordinatorAdapter';
+export { AgentLLMAdapter, createAgentLLM, type AgentLLMAdapterConfig, } from './AgentLLMAdapter';
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/agents/adapters/index.js

@@ -9,7 +9,7 @@
  * @version 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCoordinationAdapter = exports.CoordinatorAdapter = exports.createLearningAdapter = exports.LearningEngineAdapter = exports.createMemoryAdapter = exports.MemoryServiceAdapter = exports.createLifecycleAdapter = exports.LifecycleManagerAdapter = void 0;
+exports.createAgentLLM = exports.AgentLLMAdapter = exports.createCoordinationAdapter = exports.CoordinatorAdapter = exports.createLearningAdapter = exports.LearningEngineAdapter = exports.createMemoryAdapter = exports.MemoryServiceAdapter = exports.createLifecycleAdapter = exports.LifecycleManagerAdapter = void 0;
 var LifecycleManagerAdapter_1 = require("./LifecycleManagerAdapter");
 Object.defineProperty(exports, "LifecycleManagerAdapter", { enumerable: true, get: function () { return LifecycleManagerAdapter_1.LifecycleManagerAdapter; } });
 Object.defineProperty(exports, "createLifecycleAdapter", { enumerable: true, get: function () { return LifecycleManagerAdapter_1.createLifecycleAdapter; } });
@@ -22,4 +22,8 @@ Object.defineProperty(exports, "createLearningAdapter", { enumerable: true, get:
 var CoordinatorAdapter_1 = require("./CoordinatorAdapter");
 Object.defineProperty(exports, "CoordinatorAdapter", { enumerable: true, get: function () { return CoordinatorAdapter_1.CoordinatorAdapter; } });
 Object.defineProperty(exports, "createCoordinationAdapter", { enumerable: true, get: function () { return CoordinatorAdapter_1.createCoordinationAdapter; } });
+// LLM Adapter (Phase 1.2.2 - LLM Independence)
+var AgentLLMAdapter_1 = require("./AgentLLMAdapter");
+Object.defineProperty(exports, "AgentLLMAdapter", { enumerable: true, get: function () { return AgentLLMAdapter_1.AgentLLMAdapter; } });
+Object.defineProperty(exports, "createAgentLLM", { enumerable: true, get: function () { return AgentLLMAdapter_1.createAgentLLM; } });
 //# sourceMappingURL=index.js.map

package/dist/agents/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,qEAGmC;AAFjC,kIAAA,uBAAuB,OAAA;AACvB,iIAAA,sBAAsB,OAAA;AAGxB,+DAIgC;AAH9B,4HAAA,oBAAoB,OAAA;AACpB,2HAAA,mBAAmB,OAAA;AAIrB,iEAGiC;AAF/B,8HAAA,qBAAqB,OAAA;AACrB,8HAAA,qBAAqB,OAAA;AAGvB,2DAG8B;AAF5B,wHAAA,kBAAkB,OAAA;AAClB,+HAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,qEAGmC;AAFjC,kIAAA,uBAAuB,OAAA;AACvB,iIAAA,sBAAsB,OAAA;AAGxB,+DAIgC;AAH9B,4HAAA,oBAAoB,OAAA;AACpB,2HAAA,mBAAmB,OAAA;AAIrB,iEAGiC;AAF/B,8HAAA,qBAAqB,OAAA;AACrB,8HAAA,qBAAqB,OAAA;AAGvB,2DAG8B;AAF5B,wHAAA,kBAAkB,OAAA;AAClB,+HAAA,yBAAyB,OAAA;AAG3B,+CAA+C;AAC/C,qDAI2B;AAHzB,kHAAA,eAAe,OAAA;AACf,iHAAA,cAAc,OAAA"}

package/dist/agents/interfaces/IAgentLLM.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Agent LLM Interface - Simplified API for QE Agents
+ *
+ * Phase 1.2.2: Provides a clean, agent-friendly abstraction over LLM providers
+ * Agents should ONLY import this interface, never specific provider implementations.
+ *
+ * Benefits:
+ * - Simple, focused API for agent needs
+ * - LLM provider independence (swap providers without changing agent code)
+ * - Automatic complexity-based routing
+ * - Built-in usage tracking
+ * - Cache-aware operations
+ *
+ * @module agents/interfaces/IAgentLLM
+ */
+/**
+ * Agent completion options - simplified from LLMCompletionOptions
+ */
+export interface AgentCompletionOptions {
+    /** Sampling temperature (0.0-1.0, default: 0.7) */
+    temperature?: number;
+    /** Maximum tokens to generate (default: provider-specific) */
+    maxTokens?: number;
+    /** System prompt to set context */
+    systemPrompt?: string;
+    /** Cache key for prompt caching (improves latency) */
+    cacheKey?: string;
+    /** Task complexity hint for intelligent routing */
+    complexity?: 'simple' | 'moderate' | 'complex' | 'very_complex';
+    /** Enable streaming for long responses */
+    stream?: boolean;
+    /** Additional metadata for tracking */
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent usage statistics
+ */
+export interface AgentUsageStats {
+    /** Total number of requests made */
+    requestCount: number;
+    /** Total tokens used (input + output) */
+    tokensUsed: number;
+    /** Estimated cost incurred (in dollars) */
+    costIncurred: number;
+    /** Average latency per request (in milliseconds) */
+    averageLatency: number;
+    /** Cache hit rate (0-1) */
+    cacheHitRate?: number;
+    /** Local vs cloud request breakdown */
+    routingBreakdown?: {
+        local: number;
+        cloud: number;
+        cache: number;
+    };
+}
+/**
+ * Model information
+ */
+export interface AgentModelInfo {
+    /** Model identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Model provider (local, claude, openrouter, etc.) */
+    provider: string;
+    /** Model capabilities */
+    capabilities: {
+        maxTokens: number;
+        streaming: boolean;
+        vision: boolean;
+        functionCalling: boolean;
+    };
+    /** Cost per million tokens (if applicable) */
+    cost?: {
+        inputPerMillion: number;
+        outputPerMillion: number;
+    };
+}
+/**
+ * IAgentLLM - Simplified LLM interface for QE agents
+ *
+ * This interface provides a clean abstraction over complex LLM providers,
+ * allowing agents to make LLM calls without coupling to specific implementations.
+ *
+ * @example
+ * ```typescript
+ * // Agent using IAgentLLM
+ * class TestGeneratorAgent extends BaseAgent {
+ *   async generateTests(sourceCode: string): Promise<string> {
+ *     // Simple completion - provider abstracted away
+ *     const tests = await this.llm.complete(
+ *       `Generate Jest tests for:\n${sourceCode}`,
+ *       { complexity: 'moderate', temperature: 0.2 }
+ *     );
+ *     return tests;
+ *   }
+ * }
+ * ```
+ */
+export interface IAgentLLM {
+    /**
+     * Complete a prompt with the LLM
+     *
+     * This is the primary method agents should use for LLM interactions.
+     * The underlying provider is automatically selected based on complexity
+     * and availability.
+     *
+     * @param prompt - The prompt to complete
+     * @param options - Optional completion parameters
+     * @returns The completion text
+     * @throws {Error} If no provider is available or request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await llm.complete(
+     *   "Explain this error: TypeError: undefined is not a function",
+     *   { complexity: 'simple', maxTokens: 500 }
+     * );
+     * ```
+     */
+    complete(prompt: string, options?: AgentCompletionOptions): Promise<string>;
+    /**
+     * Stream a completion for long responses
+     *
+     * Useful for interactive scenarios where partial results are valuable.
+     *
+     * @param prompt - The prompt to complete
+     * @param options - Optional completion parameters
+     * @returns Async iterator yielding text chunks
+     * @throws {Error} If streaming not supported or request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const chunk of llm.streamComplete(prompt, { temperature: 0.7 })) {
+     *   process.stdout.write(chunk);
+     * }
+     * ```
+     */
+    streamComplete(prompt: string, options?: AgentCompletionOptions): AsyncIterableIterator<string>;
+    /**
+     * Generate embeddings for semantic tasks
+     *
+     * Use this for similarity search, clustering, or semantic analysis.
+     * Always uses local provider for privacy and cost efficiency.
+     *
+     * @param text - Text to embed
+     * @returns Embedding vector (typically 384-1536 dimensions)
+     * @throws {Error} If embeddings not supported
+     *
+     * @example
+     * ```typescript
+     * const embedding = await llm.embed("test pattern for login validation");
+     * await patternStore.store(embedding, metadata);
+     * ```
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Get list of available models
+     *
+     * Returns models that are currently accessible based on configured providers.
+     *
+     * @returns Array of available model information
+     *
+     * @example
+     * ```typescript
+     * const models = await llm.getAvailableModels();
+     * console.log(`Available: ${models.map(m => m.name).join(', ')}`);
+     * ```
+     */
+    getAvailableModels(): Promise<AgentModelInfo[]>;
+    /**
+     * Get currently selected model
+     *
+     * @returns Current model identifier
+     *
+     * @example
+     * ```typescript
+     * const current = llm.getCurrentModel();
+     * console.log(`Using model: ${current}`);
+     * ```
+     */
+    getCurrentModel(): string;
+    /**
+     * Switch to a different model
+     *
+     * Changes the active model for subsequent completions.
+     *
+     * @param model - Model identifier to switch to
+     * @throws {Error} If model is not available
+     *
+     * @example
+     * ```typescript
+     * await llm.switchModel('claude-sonnet-4');
+     * ```
+     */
+    switchModel(model: string): Promise<void>;
+    /**
+     * Health check for LLM availability
+     *
+     * Verifies that at least one LLM provider is operational.
+     *
+     * @returns True if LLM is available and healthy
+     *
+     * @example
+     * ```typescript
+     * if (await llm.isHealthy()) {
+     *   // Proceed with LLM-based approach
+     * } else {
+     *   // Fallback to algorithmic approach
+     * }
+     * ```
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Get usage statistics for this agent's LLM calls
+     *
+     * Provides insights into token usage, costs, and performance.
+     *
+     * @returns Aggregated usage statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = llm.getUsageStats();
+     * console.log(`Tokens used: ${stats.tokensUsed}`);
+     * console.log(`Cost: $${stats.costIncurred.toFixed(4)}`);
+     * console.log(`Cache hit rate: ${(stats.cacheHitRate * 100).toFixed(1)}%`);
+     * ```
+     */
+    getUsageStats(): AgentUsageStats;
+    /**
+     * Reset usage statistics
+     *
+     * Useful for per-task or per-session tracking.
+     *
+     * @example
+     * ```typescript
+     * llm.resetStats();
+     * await performTask();
+     * const taskStats = llm.getUsageStats();
+     * ```
+     */
+    resetStats(): void;
+}
+/**
+ * Error thrown by AgentLLM operations
+ */
+export declare class AgentLLMError extends Error {
+    readonly code: 'UNAVAILABLE' | 'MODEL_NOT_FOUND' | 'REQUEST_FAILED' | 'UNSUPPORTED';
+    readonly retryable: boolean;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: 'UNAVAILABLE' | 'MODEL_NOT_FOUND' | 'REQUEST_FAILED' | 'UNSUPPORTED', retryable?: boolean, cause?: Error | undefined);
+}
+/**
+ * Type guard for AgentLLMError
+ */
+export declare function isAgentLLMError(error: unknown): error is AgentLLMError;
+//# sourceMappingURL=IAgentLLM.d.ts.map