agentic-qe 2.5.6 → 2.5.8

package/dist/agents/BaseAgent.d.ts

@@ -1,6 +1,7 @@
 /**
  * BaseAgent - Abstract base class for all QE agents
  * Phase 2 B1.2: Decomposed with strategy pattern (~500 LOC target)
+ * Phase 0: LLM Provider integration with RuvLLM support
  */
 import { EventEmitter } from 'events';
 import { AgentId, QEAgentType as AgentType, AgentStatus, AgentContext, AgentCapability, EventHandler, MemoryStore, QETask, TaskAssignment, PreTaskData, PostTaskData, TaskErrorData } from '../types';
@@ -10,12 +11,44 @@ import { SwarmMemoryManager } from '../core/memory/SwarmMemoryManager';
 import { LearningEngine } from '../learning/LearningEngine';
 import { LearningConfig, StrategyRecommendation } from '../learning/types';
 import { AgentDBConfig } from '../core/memory/AgentDBManager';
+import { FederatedManager, FederatedConfig, LearnedPattern, EphemeralAgent } from '../learning/FederatedManager';
 import { AgentLifecycleManager } from './lifecycle/AgentLifecycleManager';
 import { AgentCoordinator } from './coordination/AgentCoordinator';
 import { AgentMemoryService } from './memory/AgentMemoryService';
+import type { ILLMProvider, LLMCompletionOptions } from '../providers/ILLMProvider';
+import { RuvllmProviderConfig } from '../providers/RuvllmProvider';
+import { LLMProviderFactory, LLMProviderFactoryConfig, ProviderType } from '../providers/LLMProviderFactory';
 import type { AgentLifecycleStrategy, AgentMemoryStrategy, AgentLearningStrategy, AgentCoordinationStrategy } from '../core/strategies';
 import { isSwarmMemoryManager, validateLearningConfig } from './utils';
 export { isSwarmMemoryManager, validateLearningConfig };
+/**
+ * LLM configuration for agents
+ */
+export interface AgentLLMConfig {
+    /** Enable LLM capabilities for this agent */
+    enabled?: boolean;
+    /** Preferred provider type (auto, ruvllm, claude, openrouter) */
+    preferredProvider?: ProviderType;
+    /** RuvLLM specific configuration */
+    ruvllm?: Partial<RuvllmProviderConfig>;
+    /** Full factory configuration for advanced setups */
+    factoryConfig?: LLMProviderFactoryConfig;
+    /** Pre-configured LLM provider instance (for injection) */
+    provider?: ILLMProvider;
+    /** Enable session management for multi-turn conversations */
+    enableSessions?: boolean;
+    /** Enable batch processing for parallel requests */
+    enableBatch?: boolean;
+    /**
+     * Enable federated learning for team-wide pattern sharing
+     * Phase 0 M0.5 - Reduces Claude Code dependency through collective learning
+     */
+    enableFederated?: boolean;
+    /** Shared FederatedManager instance (for fleet-wide coordination) */
+    federatedManager?: FederatedManager;
+    /** Federated learning configuration */
+    federatedConfig?: Partial<FederatedConfig>;
+}
 /**
  * Configuration for BaseAgent
  */
@@ -34,6 +67,8 @@ export interface BaseAgentConfig {
     memoryStrategy?: AgentMemoryStrategy;
     learningStrategy?: AgentLearningStrategy;
     coordinationStrategy?: AgentCoordinationStrategy;
+    /** LLM configuration - enables agents to make LLM calls via RuvLLM */
+    llm?: AgentLLMConfig;
 }
 export declare abstract class BaseAgent extends EventEmitter {
     protected readonly agentId: AgentId;
@@ -55,6 +90,13 @@ export declare abstract class BaseAgent extends EventEmitter {
     };
     private taskStartTime?;
     private initializationMutex?;
+    protected llmProvider?: ILLMProvider;
+    protected llmFactory?: LLMProviderFactory;
+    protected readonly llmConfig: AgentLLMConfig;
+    private llmSessionId?;
+    protected federatedManager?: FederatedManager;
+    protected ephemeralAgent?: EphemeralAgent;
+    private federatedInitialized;
     protected readonly lifecycleManager: AgentLifecycleManager;
     protected readonly coordinator: AgentCoordinator;
     protected readonly memoryService: AgentMemoryService;
@@ -138,6 +180,106 @@ export declare abstract class BaseAgent extends EventEmitter {
     private updatePerformanceMetrics;
     protected extractTaskMetrics(result: any): Record<string, number>;
     private saveState;
+    /**
+     * Initialize LLM provider for agent use
+     * Supports RuvLLM (local), Claude, and OpenRouter providers
+     */
+    private initializeLLMProvider;
+    /**
+     * Initialize Federated Learning for team-wide pattern sharing
+     * Phase 0 M0.5 - Reduces Claude Code dependency through collective learning
+     */
+    private initializeFederatedLearning;
+    /**
+     * Check if federated learning is available
+     */
+    hasFederatedLearning(): boolean;
+    /**
+     * Share a learned pattern with the team via federated learning
+     * Call this when the agent learns something useful (e.g., after successful task)
+     *
+     * @param pattern - The pattern to share (embedding, quality score, category)
+     */
+    protected shareLearnedPattern(pattern: Omit<LearnedPattern, 'id' | 'sourceAgent' | 'timestamp'>): Promise<void>;
+    /**
+     * Sync this agent with team-wide learned knowledge
+     * Call this periodically or before complex tasks
+     */
+    protected syncWithTeam(): Promise<void>;
+    /**
+     * Submit this agent's learning updates to the team
+     * Call after completing a batch of tasks
+     */
+    protected submitLearningUpdate(): Promise<void>;
+    /**
+     * Get federated learning metrics
+     */
+    getFederatedMetrics(): ReturnType<FederatedManager['getMetrics']> | null;
+    /**
+     * Check if LLM is available for this agent
+     */
+    hasLLM(): boolean;
+    /**
+     * Get LLM provider (for advanced usage)
+     */
+    getLLMProvider(): ILLMProvider | undefined;
+    /**
+     * Make an LLM completion call
+     * Uses RuvLLM's session management for 50% latency reduction on multi-turn
+     *
+     * @param prompt - The prompt to send to the LLM
+     * @param options - Additional completion options
+     * @returns The LLM response text
+     * @throws Error if LLM is not available
+     */
+    protected llmComplete(prompt: string, options?: Partial<LLMCompletionOptions>): Promise<string>;
+    /**
+     * Make a batch LLM completion call (4x throughput)
+     * Uses RuvLLM's native batch API for parallel processing
+     *
+     * @param prompts - Array of prompts to process in parallel
+     * @param options - Shared completion options
+     * @returns Array of response texts in same order as prompts
+     */
+    protected llmBatchComplete(prompts: string[], options?: Partial<LLMCompletionOptions>): Promise<string[]>;
+    /**
+     * Generate embeddings for text
+     * Uses RuvLLM's SIMD-optimized embedding generation
+     *
+     * @param text - Text to embed
+     * @returns Embedding vector
+     */
+    protected llmEmbed(text: string): Promise<number[]>;
+    /**
+     * Chat within agent's session (50% faster for multi-turn)
+     * Only works with RuvLLM provider with sessions enabled
+     *
+     * @param input - User input to chat
+     * @returns Assistant response
+     */
+    protected llmChat(input: string): Promise<string>;
+    /**
+     * Get routing decision for observability
+     * Shows which model was selected and why
+     */
+    protected getLLMRoutingDecision(input: string): any;
+    /**
+     * Get LLM usage statistics for this agent
+     */
+    getLLMStats(): {
+        available: boolean;
+        sessionId?: string;
+        provider?: string;
+    };
+    /**
+     * Cleanup LLM resources on agent termination
+     */
+    private cleanupLLM;
+    /**
+     * Cleanup federated learning resources on agent termination
+     * Submits final learning updates and unregisters from the coordinator
+     */
+    private cleanupFederated;
 }
 export interface AgentFactory {
     createAgent(type: AgentType, config: BaseAgentConfig): Promise<BaseAgent>;

package/dist/agents/BaseAgent.d.ts.map

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

package/dist/agents/BaseAgent.js

@@ -2,6 +2,7 @@
 /**
  * BaseAgent - Abstract base class for all QE agents
  * Phase 2 B1.2: Decomposed with strategy pattern (~500 LOC target)
+ * Phase 0: LLM Provider integration with RuvLLM support
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseAgentFactory = exports.BaseAgent = exports.validateLearningConfig = exports.isSwarmMemoryManager = void 0;
@@ -12,9 +13,13 @@ const MemoryStoreAdapter_1 = require("../adapters/MemoryStoreAdapter");
 const PerformanceTracker_1 = require("../learning/PerformanceTracker");
 const SwarmMemoryManager_1 = require("../core/memory/SwarmMemoryManager");
 const LearningEngine_1 = require("../learning/LearningEngine");
+// Federated Learning (Phase 0 M0.5 - Team-wide pattern sharing)
+const FederatedManager_1 = require("../learning/FederatedManager");
 const AgentLifecycleManager_1 = require("./lifecycle/AgentLifecycleManager");
 const AgentCoordinator_1 = require("./coordination/AgentCoordinator");
 const AgentMemoryService_1 = require("./memory/AgentMemoryService");
+const RuvllmProvider_1 = require("../providers/RuvllmProvider");
+const LLMProviderFactory_1 = require("../providers/LLMProviderFactory");
 const adapters_1 = require("./adapters");
 // Extracted utilities (B1.2)
 const utils_1 = require("./utils");
@@ -24,6 +29,7 @@ class BaseAgent extends events_1.EventEmitter {
     constructor(config) {
         super();
         this.performanceMetrics = { tasksCompleted: 0, averageExecutionTime: 0, errorCount: 0, lastActivity: new Date() };
+        this.federatedInitialized = false;
         this.agentId = { id: config.id || (0, utils_1.generateAgentId)(config.type), type: config.type, created: new Date() };
         this.capabilities = new Map(config.capabilities.map(cap => [cap.name, cap]));
         this.context = config.context;
@@ -31,6 +37,8 @@ class BaseAgent extends events_1.EventEmitter {
         this.eventBus = config.eventBus;
         this.enableLearning = config.enableLearning ?? true;
         this.learningConfig = config.learningConfig;
+        // LLM configuration (Phase 0 - default enabled with RuvLLM)
+        this.llmConfig = config.llm ?? { enabled: true, preferredProvider: 'ruvllm' };
         // Early validation (Issue #137)
         const validation = (0, utils_1.validateLearningConfig)(config);
         if (!validation.valid && validation.warning) {
@@ -91,6 +99,10 @@ class BaseAgent extends events_1.EventEmitter {
                     else if (this.enableLearning) {
                         console.warn(`[${this.agentId.id}] Learning disabled: memoryStore is ${this.memoryStore.constructor.name}`);
                     }
+                    // Initialize LLM Provider (Phase 0 - RuvLLM Integration)
+                    await this.initializeLLMProvider();
+                    // Initialize Federated Learning (Phase 0 M0.5)
+                    await this.initializeFederatedLearning();
                     await this.initializeComponents();
                     await this.executeHook('post-initialization');
                     this.coordinator.emitEvent('agent.initialized', { agentId: this.agentId });
@@ -144,6 +156,8 @@ class BaseAgent extends events_1.EventEmitter {
                     await this.executeHook('pre-termination');
                     await this.saveState();
                     await this.cleanup();
+                    await this.cleanupLLM(); // Phase 0: Cleanup LLM resources
+                    await this.cleanupFederated(); // Phase 0 M0.5: Cleanup federated learning
                     this.coordinator.clearAllHandlers();
                 },
                 onPostTermination: async () => {
@@ -356,18 +370,34 @@ class BaseAgent extends events_1.EventEmitter {
                 duration: executionTime, metadata: { taskId: data.assignment.id, accuracy: result.accuracy, metrics: this.extractTaskMetrics(data.result) }
             });
         }
+        // Share successful patterns with team via federated learning (Phase 0 M0.5)
+        if (result.valid && this.federatedInitialized && this.llmProvider) {
+            try {
+                // Generate embedding for the task pattern
+                const taskDescription = `${data.assignment.task.type}: ${JSON.stringify(data.assignment.task.payload || {}).slice(0, 200)}`;
+                const embedding = await this.llmEmbed(taskDescription);
+                await this.shareLearnedPattern({
+                    embedding,
+                    quality: result.accuracy ?? 0.8,
+                    category: data.assignment.task.type,
+                });
+            }
+            catch {
+                // Pattern sharing failed - non-critical, continue
+            }
+        }
         this.emitEvent('hook.post-task.completed', { agentId: this.agentId, result });
     }
     async onTaskError(data) {
         const executionTime = this.taskStartTime ? Date.now() - this.taskStartTime : 0;
         await this.storeMemory(`error:${data.assignment.id}`, {
             error: { message: data.error.message, name: data.error.name },
-            assignment: { id: data.assignment.id, taskType: data.assignment.task.type },
+            assignment: { id: data.assignment.id, taskType: data.assignment.task?.type ?? 'unknown' },
             timestamp: new Date(), agentId: this.agentId.id
         });
         if (this.strategies.lifecycle.onTaskError)
             await this.strategies.lifecycle.onTaskError(data);
-        if (this.strategies.learning?.recordExecution) {
+        if (this.strategies.learning?.recordExecution && data.assignment.task) {
             await this.strategies.learning.recordExecution({
                 task: data.assignment.task, error: data.error, success: false,
                 duration: executionTime, metadata: { taskId: data.assignment.id }
@@ -437,6 +467,346 @@ class BaseAgent extends events_1.EventEmitter {
     async saveState() {
         await this.memoryService.saveState({ performanceMetrics: this.performanceMetrics, timestamp: new Date() });
     }
+    // ============================================
+    // LLM Provider Methods (Phase 0 - RuvLLM Integration)
+    // ============================================
+    /**
+     * Initialize LLM provider for agent use
+     * Supports RuvLLM (local), Claude, and OpenRouter providers
+     */
+    async initializeLLMProvider() {
+        if (!this.llmConfig.enabled) {
+            console.log(`[${this.agentId.id}] LLM disabled by configuration`);
+            return;
+        }
+        try {
+            // If a provider was injected, use it directly
+            if (this.llmConfig.provider) {
+                this.llmProvider = this.llmConfig.provider;
+                console.log(`[${this.agentId.id}] Using injected LLM provider`);
+                return;
+            }
+            // Create RuvLLM provider directly (preferred for local inference)
+            if (this.llmConfig.preferredProvider === 'ruvllm' || !this.llmConfig.preferredProvider) {
+                const ruvllmConfig = {
+                    name: `${this.agentId.id}-ruvllm`,
+                    enableSessions: this.llmConfig.enableSessions ?? true,
+                    enableTRM: true,
+                    enableSONA: true,
+                    debug: false,
+                    ...this.llmConfig.ruvllm
+                };
+                this.llmProvider = new RuvllmProvider_1.RuvllmProvider(ruvllmConfig);
+                await this.llmProvider.initialize();
+                // Create session for this agent if sessions enabled
+                if (this.llmConfig.enableSessions) {
+                    const ruvllm = this.llmProvider;
+                    const session = ruvllm.createSession();
+                    this.llmSessionId = session.id;
+                    console.log(`[${this.agentId.id}] LLM session created: ${this.llmSessionId}`);
+                }
+                console.log(`[${this.agentId.id}] RuvLLM provider initialized`);
+                return;
+            }
+            // Use factory for other providers (Claude, OpenRouter)
+            this.llmFactory = new LLMProviderFactory_1.LLMProviderFactory(this.llmConfig.factoryConfig || {});
+            await this.llmFactory.initialize();
+            this.llmProvider = this.llmFactory.getProvider(this.llmConfig.preferredProvider);
+            if (!this.llmProvider) {
+                console.warn(`[${this.agentId.id}] Preferred provider ${this.llmConfig.preferredProvider} not available, trying auto-select`);
+                this.llmProvider = this.llmFactory.selectBestProvider();
+            }
+            if (this.llmProvider) {
+                console.log(`[${this.agentId.id}] LLM provider initialized: ${this.llmConfig.preferredProvider}`);
+            }
+            else {
+                console.warn(`[${this.agentId.id}] No LLM provider available`);
+            }
+        }
+        catch (error) {
+            console.error(`[${this.agentId.id}] LLM initialization failed:`, error.message);
+            // Don't throw - agent can still work without LLM (algorithmic fallback)
+        }
+    }
+    /**
+     * Initialize Federated Learning for team-wide pattern sharing
+     * Phase 0 M0.5 - Reduces Claude Code dependency through collective learning
+     */
+    async initializeFederatedLearning() {
+        if (!this.llmConfig.enableFederated) {
+            return;
+        }
+        try {
+            // Use shared FederatedManager or create new one
+            if (this.llmConfig.federatedManager) {
+                this.federatedManager = this.llmConfig.federatedManager;
+            }
+            else {
+                this.federatedManager = new FederatedManager_1.FederatedManager(this.llmConfig.federatedConfig);
+                await this.federatedManager.initialize();
+            }
+            // Register this agent for federated learning
+            this.ephemeralAgent = this.federatedManager.registerAgent(this.agentId.id);
+            this.federatedInitialized = true;
+            console.log(`[${this.agentId.id}] Federated learning initialized`);
+            // Sync with existing team knowledge on startup
+            try {
+                await this.federatedManager.syncFromTeam(this.agentId.id);
+                console.log(`[${this.agentId.id}] Synced with team knowledge`);
+            }
+            catch {
+                // First agent or no prior knowledge - expected
+            }
+        }
+        catch (error) {
+            console.error(`[${this.agentId.id}] Federated learning initialization failed:`, error.message);
+            // Don't throw - agent can work without federated learning
+        }
+    }
+    /**
+     * Check if federated learning is available
+     */
+    hasFederatedLearning() {
+        return this.federatedInitialized && this.federatedManager !== undefined;
+    }
+    /**
+     * Share a learned pattern with the team via federated learning
+     * Call this when the agent learns something useful (e.g., after successful task)
+     *
+     * @param pattern - The pattern to share (embedding, quality score, category)
+     */
+    async shareLearnedPattern(pattern) {
+        if (!this.federatedManager || !this.federatedInitialized) {
+            return;
+        }
+        const fullPattern = {
+            ...pattern,
+            id: `pattern-${this.agentId.id}-${Date.now()}`,
+            sourceAgent: this.agentId.id,
+            timestamp: Date.now(),
+        };
+        await this.federatedManager.sharePattern(this.agentId.id, fullPattern);
+    }
+    /**
+     * Sync this agent with team-wide learned knowledge
+     * Call this periodically or before complex tasks
+     */
+    async syncWithTeam() {
+        if (!this.federatedManager || !this.federatedInitialized) {
+            return;
+        }
+        await this.federatedManager.syncFromTeam(this.agentId.id);
+    }
+    /**
+     * Submit this agent's learning updates to the team
+     * Call after completing a batch of tasks
+     */
+    async submitLearningUpdate() {
+        if (!this.federatedManager || !this.federatedInitialized) {
+            return;
+        }
+        await this.federatedManager.submitAgentUpdate(this.agentId.id);
+    }
+    /**
+     * Get federated learning metrics
+     */
+    getFederatedMetrics() {
+        if (!this.federatedManager) {
+            return null;
+        }
+        return this.federatedManager.getMetrics();
+    }
+    /**
+     * Check if LLM is available for this agent
+     */
+    hasLLM() {
+        return this.llmProvider !== undefined;
+    }
+    /**
+     * Get LLM provider (for advanced usage)
+     */
+    getLLMProvider() {
+        return this.llmProvider;
+    }
+    /**
+     * Make an LLM completion call
+     * Uses RuvLLM's session management for 50% latency reduction on multi-turn
+     *
+     * @param prompt - The prompt to send to the LLM
+     * @param options - Additional completion options
+     * @returns The LLM response text
+     * @throws Error if LLM is not available
+     */
+    async llmComplete(prompt, options) {
+        if (!this.llmProvider) {
+            throw new Error(`[${this.agentId.id}] LLM not available - initialize agent first`);
+        }
+        const completionOptions = {
+            model: options?.model || this.llmConfig.ruvllm?.defaultModel || 'llama-3.2-3b-instruct',
+            messages: [{ role: 'user', content: prompt }],
+            maxTokens: options?.maxTokens,
+            temperature: options?.temperature,
+            stream: options?.stream,
+            metadata: {
+                ...options?.metadata,
+                sessionId: this.llmSessionId, // Use session for faster multi-turn
+                agentId: this.agentId.id,
+                agentType: this.agentId.type
+            }
+        };
+        const response = await this.llmProvider.complete(completionOptions);
+        // Extract text from response
+        const text = response.content
+            .filter(block => block.type === 'text')
+            .map(block => block.text)
+            .join('\n');
+        return text;
+    }
+    /**
+     * Make a batch LLM completion call (4x throughput)
+     * Uses RuvLLM's native batch API for parallel processing
+     *
+     * @param prompts - Array of prompts to process in parallel
+     * @param options - Shared completion options
+     * @returns Array of response texts in same order as prompts
+     */
+    async llmBatchComplete(prompts, options) {
+        if (!this.llmProvider) {
+            throw new Error(`[${this.agentId.id}] LLM not available - initialize agent first`);
+        }
+        // Check if provider supports batch (RuvLLM does)
+        const ruvllm = this.llmProvider;
+        if (typeof ruvllm.batchComplete === 'function') {
+            const defaultModel = options?.model || this.llmConfig.ruvllm?.defaultModel || 'llama-3.2-3b-instruct';
+            const requests = prompts.map(prompt => ({
+                model: defaultModel,
+                messages: [{ role: 'user', content: prompt }],
+                maxTokens: options?.maxTokens,
+                temperature: options?.temperature,
+                metadata: {
+                    ...options?.metadata,
+                    agentId: this.agentId.id,
+                    agentType: this.agentId.type
+                }
+            }));
+            const responses = await ruvllm.batchComplete(requests);
+            return responses.map(response => response.content
+                .filter(block => block.type === 'text')
+                .map(block => block.text)
+                .join('\n'));
+        }
+        // Fallback: sequential processing for non-batch providers
+        console.warn(`[${this.agentId.id}] Provider doesn't support batch, using sequential`);
+        const results = [];
+        for (const prompt of prompts) {
+            results.push(await this.llmComplete(prompt, options));
+        }
+        return results;
+    }
+    /**
+     * Generate embeddings for text
+     * Uses RuvLLM's SIMD-optimized embedding generation
+     *
+     * @param text - Text to embed
+     * @returns Embedding vector
+     */
+    async llmEmbed(text) {
+        if (!this.llmProvider) {
+            throw new Error(`[${this.agentId.id}] LLM not available - initialize agent first`);
+        }
+        const response = await this.llmProvider.embed({ text });
+        return response.embedding || [];
+    }
+    /**
+     * Chat within agent's session (50% faster for multi-turn)
+     * Only works with RuvLLM provider with sessions enabled
+     *
+     * @param input - User input to chat
+     * @returns Assistant response
+     */
+    async llmChat(input) {
+        if (!this.llmProvider) {
+            throw new Error(`[${this.agentId.id}] LLM not available`);
+        }
+        if (!this.llmSessionId) {
+            // Fallback to regular complete if no session
+            return this.llmComplete(input);
+        }
+        const ruvllm = this.llmProvider;
+        if (typeof ruvllm.sessionChat === 'function') {
+            return ruvllm.sessionChat(this.llmSessionId, input);
+        }
+        // Fallback
+        return this.llmComplete(input);
+    }
+    /**
+     * Get routing decision for observability
+     * Shows which model was selected and why
+     */
+    getLLMRoutingDecision(input) {
+        if (!this.llmProvider) {
+            return null;
+        }
+        const ruvllm = this.llmProvider;
+        if (typeof ruvllm.getRoutingDecision === 'function') {
+            return ruvllm.getRoutingDecision(input);
+        }
+        return null;
+    }
+    /**
+     * Get LLM usage statistics for this agent
+     */
+    getLLMStats() {
+        return {
+            available: this.hasLLM(),
+            sessionId: this.llmSessionId,
+            provider: this.llmProvider ? 'ruvllm' : undefined
+        };
+    }
+    /**
+     * Cleanup LLM resources on agent termination
+     */
+    async cleanupLLM() {
+        if (this.llmSessionId && this.llmProvider) {
+            const ruvllm = this.llmProvider;
+            if (typeof ruvllm.endSession === 'function') {
+                ruvllm.endSession(this.llmSessionId);
+                console.log(`[${this.agentId.id}] LLM session ended: ${this.llmSessionId}`);
+            }
+        }
+        if (this.llmProvider) {
+            await this.llmProvider.shutdown();
+        }
+        if (this.llmFactory) {
+            await this.llmFactory.shutdown();
+        }
+    }
+    /**
+     * Cleanup federated learning resources on agent termination
+     * Submits final learning updates and unregisters from the coordinator
+     */
+    async cleanupFederated() {
+        if (!this.federatedManager || !this.federatedInitialized) {
+            return;
+        }
+        try {
+            // Submit final learning updates before terminating
+            await this.submitLearningUpdate();
+            // Unregister this agent from federated learning
+            this.federatedManager.unregisterAgent(this.agentId.id);
+            console.log(`[${this.agentId.id}] Federated learning cleanup complete`);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Federated cleanup error:`, error.message);
+        }
+        this.federatedInitialized = false;
+        this.ephemeralAgent = undefined;
+        // Only shutdown the manager if we created it (not if it was shared)
+        if (!this.llmConfig.federatedManager && this.federatedManager) {
+            await this.federatedManager.shutdown();
+            this.federatedManager = undefined;
+        }
+    }
 }
 exports.BaseAgent = BaseAgent;
 class BaseAgentFactory {