agentic-qe 1.9.4 → 2.1.0

package/dist/core/optimization/SwarmOptimizer.d.ts

@@ -0,0 +1,190 @@
+/**
+ * SwarmOptimizer - Stream D Implementation
+ *
+ * Provides topology recommendation, agent allocation, bottleneck detection,
+ * and performance optimization for agent swarms.
+ */
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+import { PerformanceTracker } from '../../learning/PerformanceTracker';
+import { LearningEngine } from '../../learning/LearningEngine';
+import { QEEventBus } from '../events/QEEventBus';
+import { OptimizationConfig, TopologyRecommendation, WorkloadProfile, AgentAllocation, PerformanceMetrics, Bottleneck, OptimizationResult } from './types';
+/**
+ * Task definition for allocation
+ */
+export interface Task {
+    id: string;
+    type: string;
+    complexity: number;
+    estimatedDuration: number;
+    dependencies: string[];
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    requiredCapabilities?: string[];
+}
+/**
+ * Agent definition for allocation
+ */
+export interface Agent {
+    id: string;
+    type: string;
+    capabilities: string[];
+    currentLoad: number;
+    performanceScore: number;
+    isAvailable: boolean;
+}
+/**
+ * SwarmOptimizer - Optimize swarm topology and agent allocation
+ */
+export declare class SwarmOptimizer {
+    private readonly logger;
+    private readonly memoryStore;
+    private readonly eventBus?;
+    private performanceTrackers;
+    private learningEngines;
+    private currentTopology?;
+    private optimizationHistory;
+    private readonly TOPOLOGY_WEIGHTS;
+    constructor(memoryStore: SwarmMemoryManager, eventBus?: QEEventBus);
+    /**
+     * Initialize optimizer
+     */
+    initialize(): Promise<void>;
+    /**
+     * Recommend optimal topology based on workload profile
+     *
+     * Analyzes task characteristics and recommends:
+     * - hierarchical: High coordination, moderate parallelization
+     * - mesh: High parallelization, moderate coordination
+     * - ring: Balanced but limited scalability
+     * - star: Centralized coordination, limited parallelization
+     */
+    recommendTopology(workload: WorkloadProfile): Promise<TopologyRecommendation>;
+    /**
+     * Allocate agents to tasks optimally
+     *
+     * Matches tasks to agents based on:
+     * - Capability matching
+     * - Load balancing
+     * - Performance history
+     * - Task dependencies
+     */
+    allocateAgents(tasks: Task[], agents: Agent[]): Promise<AgentAllocation>;
+    /**
+     * Detect performance bottlenecks
+     *
+     * Analyzes metrics to identify:
+     * - Agent bottlenecks (overloaded, underperforming)
+     * - Memory bottlenecks (high usage, slow queries)
+     * - Coordination bottlenecks (high latency, contention)
+     * - IO bottlenecks (disk, network)
+     */
+    detectBottlenecks(metrics: PerformanceMetrics[]): Promise<Bottleneck[]>;
+    /**
+     * Optimize swarm performance
+     *
+     * Applies optimizations based on configuration:
+     * - Topology adjustment
+     * - Agent reallocation
+     * - Parameter tuning
+     * - Resource scaling
+     */
+    optimize(config: OptimizationConfig): Promise<OptimizationResult>;
+    /**
+     * Register performance tracker for an agent
+     */
+    registerPerformanceTracker(agentId: string, tracker: PerformanceTracker): void;
+    /**
+     * Register learning engine for an agent
+     */
+    registerLearningEngine(agentId: string, engine: LearningEngine): void;
+    /**
+     * Calculate agent distribution for topology
+     */
+    private calculateAgentDistribution;
+    /**
+     * Generate reasoning explanation for topology recommendation
+     */
+    private generateTopologyReasoning;
+    /**
+     * Find suitable agents for a task
+     */
+    private findSuitableAgents;
+    /**
+     * Get compatible agent types for a task type
+     */
+    private getCompatibleAgentTypes;
+    /**
+     * Map task type to agent type
+     */
+    private mapTaskTypeToAgentType;
+    /**
+     * Calculate expected duration (critical path)
+     */
+    private calculateExpectedDuration;
+    /**
+     * Calculate variance
+     */
+    private calculateVariance;
+    /**
+     * Calculate improvement percentage
+     */
+    private calculateImprovement;
+    /**
+     * Calculate composite performance score
+     */
+    private calculateCompositeScore;
+    /**
+     * Collect current performance metrics
+     */
+    private collectCurrentMetrics;
+    /**
+     * Analyze current workload profile
+     */
+    private analyzeWorkload;
+    /**
+     * Load pending tasks
+     */
+    private loadPendingTasks;
+    /**
+     * Load active agents
+     */
+    private loadActiveAgents;
+    /**
+     * Apply bottleneck-specific fix
+     */
+    private applyBottleneckFix;
+    /**
+     * Store optimization result
+     */
+    private storeOptimizationResult;
+    /**
+     * Load optimization history
+     */
+    private loadOptimizationHistory;
+    /**
+     * Handle agent completed event
+     */
+    private handleAgentCompleted;
+    /**
+     * Handle test completed event
+     */
+    private handleTestCompleted;
+    /**
+     * Get optimization history
+     */
+    getOptimizationHistory(): OptimizationResult[];
+    /**
+     * Get current topology
+     */
+    getCurrentTopology(): string | undefined;
+    /**
+     * Get the latest optimization recommendation
+     * Returns the most recent topology recommendation from optimization history
+     */
+    getLatestRecommendation(): TopologyRecommendation | null;
+    /**
+     * Shutdown optimizer
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=SwarmOptimizer.d.ts.map

package/dist/core/optimization/SwarmOptimizer.d.ts.map

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