agentic-qe 2.5.3 → 2.5.5

package/dist/agents/SONALifecycleManager.d.ts

@@ -0,0 +1,226 @@
+/**
+ * SONA Lifecycle Manager - Phase 2 Integration
+ *
+ * Wires SONA's self-organizing capabilities into agent execution lifecycle.
+ * Provides hooks for:
+ * - Agent spawn: Initialize SONA state and activate relevant LoRA adapters
+ * - Task completion: Collect feedback and consolidate successful patterns
+ * - Task feedback: Record execution events and trigger learning
+ * - EWC weight consolidation: Prevent catastrophic forgetting
+ *
+ * Architecture:
+ * - Wraps SONALearningStrategy for lifecycle events
+ * - Manages per-agent SONA contexts
+ * - Coordinates LoRA adapter activation based on agent/task types
+ * - Triggers EWC consolidation on successful patterns
+ *
+ * @module agents/SONALifecycleManager
+ * @version 2.5.4
+ */
+import { SONALearningStrategy, type SONALearningConfig, type SONAMetrics } from '../core/strategies/SONALearningStrategy';
+import { SONAFeedbackLoop, type FeedbackLoopConfig, type FeedbackEvent } from '../learning/SONAFeedbackLoop';
+import type { LearnedPattern, TrainingResult } from '../core/strategies';
+import type { QETask, QEAgentType } from '../types';
+/**
+ * SONA lifecycle configuration
+ */
+export interface SONALifecycleConfig {
+    /** Enable SONA lifecycle integration */
+    enabled?: boolean;
+    /** Enable automatic EWC consolidation */
+    autoConsolidate?: boolean;
+    /** Consolidation interval (default: 100 successful tasks) */
+    consolidationInterval?: number;
+    /** Enable LoRA adapter management */
+    enableLoraAdapters?: boolean;
+    /** SONA learning configuration */
+    sonaConfig?: SONALearningConfig;
+    /** Feedback loop configuration */
+    feedbackConfig?: FeedbackLoopConfig;
+    /** Minimum success rate for consolidation (default: 0.7) */
+    minSuccessRateForConsolidation?: number;
+    /** Enable performance-based adapter selection */
+    enableAdaptiveAdapters?: boolean;
+}
+/**
+ * Agent-specific SONA context
+ */
+export interface AgentSONAContext {
+    /** Agent ID */
+    agentId: string;
+    /** Agent type */
+    agentType: QEAgentType;
+    /** SONA learning strategy */
+    strategy: SONALearningStrategy;
+    /** Feedback loop */
+    feedbackLoop?: SONAFeedbackLoop;
+    /** Active LoRA adapter name */
+    activeAdapter?: string;
+    /** Successful task count */
+    successfulTasks: number;
+    /** Failed task count */
+    failedTasks: number;
+    /** Last consolidation timestamp */
+    lastConsolidation: Date;
+    /** Patterns pending consolidation */
+    pendingPatterns: LearnedPattern[];
+    /** Created timestamp */
+    createdAt: Date;
+}
+/**
+ * Task completion feedback
+ */
+export interface TaskCompletionFeedback {
+    /** Task that was executed */
+    task: QETask;
+    /** Whether execution was successful */
+    success: boolean;
+    /** Execution duration in ms */
+    duration: number;
+    /** Quality score (0-1) if available */
+    quality?: number;
+    /** Result data */
+    result?: unknown;
+    /** Error if failed */
+    error?: Error;
+    /** Patterns used during execution */
+    patternsUsed?: string[];
+}
+/**
+ * SONA Lifecycle Manager
+ *
+ * Manages SONA learning contexts for all agents in the fleet.
+ * Coordinates lifecycle hooks and learning consolidation.
+ */
+export declare class SONALifecycleManager {
+    private contexts;
+    private config;
+    private logger;
+    private ruvLLMAvailable;
+    constructor(config?: SONALifecycleConfig);
+    /**
+     * Check if ruvLLM is available for advanced SONA features
+     */
+    private checkRuvLLMAvailability;
+    /**
+     * Hook: Agent Spawn
+     *
+     * Called when a new agent is spawned. Initializes SONA state and
+     * activates relevant LoRA adapter based on agent type.
+     *
+     * @param agentId - Unique agent identifier
+     * @param agentType - Type of agent being spawned
+     * @returns Agent SONA context
+     */
+    onAgentSpawn(agentId: string, agentType: QEAgentType): Promise<AgentSONAContext>;
+    /**
+     * Hook: Task Complete
+     *
+     * Called when an agent completes a task. Collects feedback and
+     * triggers EWC weight consolidation on successful patterns.
+     *
+     * @param agentId - Agent identifier
+     * @param feedback - Task completion feedback
+     */
+    onTaskComplete(agentId: string, feedback: TaskCompletionFeedback): Promise<void>;
+    /**
+     * Hook: Task Feedback
+     *
+     * Generic feedback recording hook. Can be called at any point during
+     * or after task execution to record events and trigger learning.
+     *
+     * @param agentId - Agent identifier
+     * @param event - Feedback event
+     */
+    onFeedback(agentId: string, event: FeedbackEvent): Promise<void>;
+    /**
+     * Get agent SONA context
+     *
+     * @param agentId - Agent identifier
+     * @returns Agent SONA context or undefined
+     */
+    getContext(agentId: string): AgentSONAContext | undefined;
+    /**
+     * Get SONA metrics for an agent
+     *
+     * @param agentId - Agent identifier
+     * @returns SONA metrics or undefined
+     */
+    getMetrics(agentId: string): Promise<SONAMetrics | undefined>;
+    /**
+     * Manually trigger training for an agent
+     *
+     * @param agentId - Agent identifier
+     * @param iterations - Number of training iterations
+     * @returns Training result
+     */
+    train(agentId: string, iterations?: number): Promise<TrainingResult | undefined>;
+    /**
+     * Cleanup agent SONA context
+     *
+     * @param agentId - Agent identifier
+     */
+    cleanupAgent(agentId: string): Promise<void>;
+    /**
+     * Get all active agent contexts
+     *
+     * @returns Array of agent SONA contexts
+     */
+    getAllContexts(): AgentSONAContext[];
+    /**
+     * Get lifecycle statistics
+     *
+     * @returns Lifecycle statistics
+     */
+    getStatistics(): {
+        totalAgents: number;
+        totalSuccessfulTasks: number;
+        totalFailedTasks: number;
+        averageSuccessRate: number;
+        totalConsolidations: number;
+        ruvLLMAvailable: boolean;
+    };
+    /**
+     * Determine LoRA adapter for agent type
+     */
+    private determineLoraAdapter;
+    /**
+     * Activate LoRA adapter for strategy
+     */
+    private activateLoraAdapter;
+    /**
+     * Record feedback to strategy
+     */
+    private recordFeedback;
+    /**
+     * Check if weight consolidation should be triggered
+     */
+    private shouldConsolidate;
+    /**
+     * Consolidate weights using EWC++
+     *
+     * Stores successful patterns and prevents catastrophic forgetting
+     * by consolidating weights of high-confidence patterns.
+     */
+    private consolidateWeights;
+    /**
+     * Check if adapter should be changed based on performance
+     */
+    private checkAdapterPerformance;
+}
+/**
+ * Create SONA lifecycle manager with default configuration
+ */
+export declare function createSONALifecycleManager(config?: SONALifecycleConfig): SONALifecycleManager;
+/**
+ * Get or create global SONA lifecycle manager
+ *
+ * @param config - Optional configuration (only used on first call)
+ * @returns Global SONA lifecycle manager
+ */
+export declare function getSONALifecycleManager(config?: SONALifecycleConfig): SONALifecycleManager;
+/**
+ * Reset global SONA lifecycle manager (for testing)
+ */
+export declare function resetSONALifecycleManager(): void;
+//# sourceMappingURL=SONALifecycleManager.d.ts.map

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

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