@agentic-qe/v3 3.0.0-alpha.10

package/dist/neural-optimizer/swarm-topology.js

@@ -0,0 +1,384 @@
+/**
+ * Agentic QE v3 - Swarm Topology Implementation
+ * ADR-034: RL-based swarm topology optimization
+ *
+ * Implements a mutable swarm topology for the neural optimizer to modify.
+ */
+// ============================================================================
+// Mutable Swarm Topology
+// ============================================================================
+/**
+ * Mutable implementation of SwarmTopology for the neural optimizer
+ */
+export class MutableSwarmTopology {
+    /** Mutable agent list */
+    _agents = [];
+    /** Mutable connection list */
+    _connections = [];
+    /** Topology type */
+    _type;
+    /** Topology metadata */
+    _metadata = {};
+    constructor(type = 'custom') {
+        this._type = type;
+    }
+    // ============================================================================
+    // Getters (readonly views)
+    // ============================================================================
+    get agents() {
+        return this._agents;
+    }
+    get connections() {
+        return this._connections;
+    }
+    get type() {
+        return this._type;
+    }
+    get metadata() {
+        return this._metadata;
+    }
+    // ============================================================================
+    // Agent Operations
+    // ============================================================================
+    /**
+     * Add an agent to the topology
+     */
+    addAgent(agent) {
+        // Check if agent already exists
+        if (this._agents.some((a) => a.id === agent.id)) {
+            return;
+        }
+        this._agents.push(agent);
+    }
+    /**
+     * Remove an agent and all its connections
+     */
+    removeAgent(agentId) {
+        const idx = this._agents.findIndex((a) => a.id === agentId);
+        if (idx === -1)
+            return false;
+        // Remove all connections involving this agent
+        this._connections = this._connections.filter((c) => c.from !== agentId && c.to !== agentId);
+        this._agents.splice(idx, 1);
+        return true;
+    }
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId) {
+        return this._agents.find((a) => a.id === agentId);
+    }
+    /**
+     * Update agent metrics
+     */
+    updateAgentMetrics(agentId, metrics) {
+        const agent = this._agents.find((a) => a.id === agentId);
+        if (agent && agent.metrics) {
+            Object.assign(agent.metrics, metrics);
+        }
+    }
+    /**
+     * Update agent status
+     */
+    updateAgentStatus(agentId, status) {
+        const idx = this._agents.findIndex((a) => a.id === agentId);
+        if (idx !== -1) {
+            // Create new agent with updated status (agents are readonly)
+            this._agents[idx] = {
+                ...this._agents[idx],
+                status,
+            };
+        }
+    }
+    // ============================================================================
+    // Connection Operations
+    // ============================================================================
+    /**
+     * Add a connection between agents
+     */
+    addConnection(from, to, weight = 1.0) {
+        // Check if connection already exists
+        if (this.hasConnection(from, to)) {
+            return;
+        }
+        // Verify both agents exist
+        if (!this.getAgent(from) || !this.getAgent(to)) {
+            return;
+        }
+        this._connections.push({
+            from,
+            to,
+            weight,
+            active: true,
+        });
+    }
+    /**
+     * Remove a connection
+     */
+    removeConnection(from, to) {
+        const idx = this._connections.findIndex((c) => (c.from === from && c.to === to) || (c.from === to && c.to === from));
+        if (idx === -1)
+            return false;
+        this._connections.splice(idx, 1);
+        return true;
+    }
+    /**
+     * Update connection weight
+     */
+    updateConnectionWeight(from, to, delta) {
+        const conn = this._connections.find((c) => (c.from === from && c.to === to) || (c.from === to && c.to === from));
+        if (conn) {
+            conn.weight = Math.max(0.01, Math.min(10, conn.weight + delta));
+        }
+    }
+    /**
+     * Set connection weight directly
+     */
+    setConnectionWeight(from, to, weight) {
+        const conn = this._connections.find((c) => (c.from === from && c.to === to) || (c.from === to && c.to === from));
+        if (conn) {
+            conn.weight = Math.max(0.01, Math.min(10, weight));
+        }
+    }
+    /**
+     * Check if connection exists
+     */
+    hasConnection(from, to) {
+        return this._connections.some((c) => (c.from === from && c.to === to) || (c.from === to && c.to === from));
+    }
+    /**
+     * Get connections for an agent
+     */
+    getAgentConnections(agentId) {
+        return this._connections.filter((c) => c.from === agentId || c.to === agentId);
+    }
+    /**
+     * Get degree of an agent
+     */
+    getAgentDegree(agentId) {
+        return this.getAgentConnections(agentId).length;
+    }
+    /**
+     * Get neighbors of an agent
+     */
+    getNeighbors(agentId) {
+        const neighbors = [];
+        for (const conn of this._connections) {
+            if (conn.from === agentId)
+                neighbors.push(conn.to);
+            else if (conn.to === agentId)
+                neighbors.push(conn.from);
+        }
+        return neighbors;
+    }
+    // ============================================================================
+    // Topology Metrics
+    // ============================================================================
+    /**
+     * Calculate graph density
+     */
+    getDensity() {
+        const n = this._agents.length;
+        if (n < 2)
+            return 0;
+        const maxConnections = (n * (n - 1)) / 2;
+        return this._connections.length / maxConnections;
+    }
+    /**
+     * Calculate average degree
+     */
+    getAverageDegree() {
+        if (this._agents.length === 0)
+            return 0;
+        const totalDegree = this._agents.reduce((sum, agent) => sum + this.getAgentDegree(agent.id), 0);
+        return totalDegree / this._agents.length;
+    }
+    /**
+     * Calculate minimum degree (approximates min-cut)
+     */
+    getMinDegree() {
+        if (this._agents.length === 0)
+            return 0;
+        let minDegree = Infinity;
+        for (const agent of this._agents) {
+            const degree = this.getAgentDegree(agent.id);
+            minDegree = Math.min(minDegree, degree);
+        }
+        return minDegree === Infinity ? 0 : minDegree;
+    }
+    /**
+     * Calculate average connection weight
+     */
+    getAverageWeight() {
+        if (this._connections.length === 0)
+            return 0;
+        const totalWeight = this._connections.reduce((sum, c) => sum + c.weight, 0);
+        return totalWeight / this._connections.length;
+    }
+    /**
+     * Calculate weight variance
+     */
+    getWeightVariance() {
+        if (this._connections.length === 0)
+            return 0;
+        const avg = this.getAverageWeight();
+        const squaredDiffs = this._connections.map((c) => (c.weight - avg) ** 2);
+        return squaredDiffs.reduce((sum, d) => sum + d, 0) / this._connections.length;
+    }
+    /**
+     * Calculate clustering coefficient
+     */
+    getClusteringCoefficient() {
+        if (this._agents.length < 3)
+            return 0;
+        let totalCoeff = 0;
+        for (const agent of this._agents) {
+            const neighbors = this.getNeighbors(agent.id);
+            const k = neighbors.length;
+            if (k < 2)
+                continue;
+            let triangles = 0;
+            for (let i = 0; i < neighbors.length; i++) {
+                for (let j = i + 1; j < neighbors.length; j++) {
+                    if (this.hasConnection(neighbors[i], neighbors[j])) {
+                        triangles++;
+                    }
+                }
+            }
+            const possibleTriangles = (k * (k - 1)) / 2;
+            totalCoeff += triangles / possibleTriangles;
+        }
+        return totalCoeff / this._agents.length;
+    }
+    /**
+     * Get load statistics
+     */
+    getLoadStats() {
+        if (this._agents.length === 0) {
+            return { avg: 0, variance: 0, idle: 0, overloaded: 0 };
+        }
+        const loads = this._agents.map((a) => a.metrics?.currentLoad ?? 0);
+        const avg = loads.reduce((sum, l) => sum + l, 0) / loads.length;
+        const variance = loads.reduce((sum, l) => sum + (l - avg) ** 2, 0) / loads.length;
+        const idle = this._agents.filter((a) => a.status === 'idle').length;
+        const overloaded = this._agents.filter((a) => (a.metrics?.currentLoad ?? 0) > 0.8).length;
+        return { avg, variance, idle, overloaded };
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    /**
+     * Export topology to JSON
+     */
+    toJSON() {
+        return {
+            type: this._type,
+            agents: [...this._agents],
+            connections: [...this._connections],
+            metadata: { ...this._metadata },
+        };
+    }
+    /**
+     * Import topology from JSON
+     */
+    static fromJSON(data) {
+        const topology = new MutableSwarmTopology(data.type || 'custom');
+        topology._agents = [...data.agents];
+        topology._connections = [...data.connections];
+        topology._metadata = data.metadata ? { ...data.metadata } : {};
+        return topology;
+    }
+    /**
+     * Create a copy of this topology
+     */
+    clone() {
+        return MutableSwarmTopology.fromJSON(this.toJSON());
+    }
+}
+// ============================================================================
+// Topology Builders
+// ============================================================================
+/**
+ * Build a mesh topology where every agent connects to every other
+ */
+export function buildMeshTopology(agents) {
+    const topology = new MutableSwarmTopology('mesh');
+    for (const agent of agents) {
+        topology.addAgent(agent);
+    }
+    for (let i = 0; i < agents.length; i++) {
+        for (let j = i + 1; j < agents.length; j++) {
+            topology.addConnection(agents[i].id, agents[j].id, 1.0);
+        }
+    }
+    return topology;
+}
+/**
+ * Build a ring topology
+ */
+export function buildRingTopology(agents) {
+    const topology = new MutableSwarmTopology('ring');
+    for (const agent of agents) {
+        topology.addAgent(agent);
+    }
+    for (let i = 0; i < agents.length; i++) {
+        const next = (i + 1) % agents.length;
+        topology.addConnection(agents[i].id, agents[next].id, 1.0);
+    }
+    return topology;
+}
+/**
+ * Build a star topology with a central hub
+ */
+export function buildStarTopology(agents, hubId) {
+    const topology = new MutableSwarmTopology('star');
+    for (const agent of agents) {
+        topology.addAgent(agent);
+    }
+    for (const agent of agents) {
+        if (agent.id !== hubId) {
+            topology.addConnection(hubId, agent.id, 1.0);
+        }
+    }
+    return topology;
+}
+/**
+ * Build a hierarchical topology with a coordinator and workers
+ */
+export function buildHierarchicalTopology(coordinator, workers) {
+    const topology = new MutableSwarmTopology('hierarchical');
+    topology.addAgent(coordinator);
+    for (const worker of workers) {
+        topology.addAgent(worker);
+        topology.addConnection(coordinator.id, worker.id, 1.0);
+    }
+    return topology;
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create an empty topology
+ */
+export function createTopology(type = 'custom') {
+    return new MutableSwarmTopology(type);
+}
+/**
+ * Create an agent with default metrics
+ */
+export function createAgent(id, type, options = {}) {
+    return {
+        id,
+        type,
+        status: options.status || 'idle',
+        domain: options.domain,
+        capabilities: options.capabilities || [],
+        metrics: options.metrics || {
+            tasksCompleted: 0,
+            avgTaskDurationMs: 0,
+            successRate: 1.0,
+            currentLoad: 0,
+        },
+    };
+}
+//# sourceMappingURL=swarm-topology.js.map

package/dist/neural-optimizer/swarm-topology.js.map

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

package/dist/neural-optimizer/topology-optimizer.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agentic QE v3 - Neural Topology Optimizer
+ * ADR-034: RL-based swarm topology optimization
+ *
+ * Implements reinforcement learning-based topology optimization:
+ * - Q-learning with value network for state evaluation
+ * - Experience replay for stable training
+ * - Epsilon-greedy exploration
+ * - Multi-objective reward (min-cut, efficiency, load balance)
+ */
+import type { SwarmTopology, TopologyOptimizerConfig, OptimizationResult, OptimizationStats, ExportedModel } from './types';
+/**
+ * Neural Topology Optimizer using reinforcement learning
+ *
+ * Uses a value network to estimate state values and learns to select
+ * topology modifications that improve overall swarm performance.
+ */
+export declare class NeuralTopologyOptimizer {
+    /** Primary value network */
+    private valueNetwork;
+    /** Target network for stable learning */
+    private targetNetwork;
+    /** Experience replay buffer */
+    private replayBuffer;
+    /** Optimizer configuration */
+    private config;
+    /** Reference to topology being optimized */
+    private topology;
+    /** Previous state for learning */
+    private prevState;
+    /** Previous min-cut estimate */
+    private prevMinCut;
+    /** Current exploration rate */
+    private epsilon;
+    /** Simulation time */
+    private time;
+    /** Total optimization steps */
+    private totalSteps;
+    /** Episode count */
+    private episodes;
+    /** Cumulative reward */
+    private cumulativeReward;
+    /** Action counts */
+    private actionCounts;
+    /** Min-cut history */
+    private minCutHistory;
+    /** Reward history */
+    private rewardHistory;
+    /** Last action taken (for feedback) */
+    private lastAction;
+    constructor(topology: SwarmTopology, config?: Partial<TopologyOptimizerConfig>);
+    /**
+     * Run one optimization step
+     */
+    optimizeStep(): OptimizationResult;
+    /**
+     * Run multiple optimization steps
+     */
+    optimize(steps: number): OptimizationResult[];
+    /**
+     * Provide external feedback (e.g., from task completion)
+     */
+    provideFeedback(reward: number): void;
+    /**
+     * Get skip regions (low activity areas)
+     */
+    getSkipRegions(): string[];
+    /**
+     * Get optimization statistics
+     */
+    getStats(): OptimizationStats;
+    /**
+     * Reset optimizer state
+     */
+    reset(): void;
+    /**
+     * Hard reset (clear learning)
+     */
+    hardReset(): void;
+    /**
+     * Export learned model
+     */
+    exportModel(): ExportedModel;
+    /**
+     * Import learned model
+     */
+    importModel(model: ExportedModel): void;
+    /**
+     * Extract features from topology for state representation
+     */
+    private extractFeatures;
+    /**
+     * Select action using epsilon-greedy policy
+     */
+    private selectAction;
+    /**
+     * Convert index to action
+     */
+    private indexToAction;
+    /**
+     * Generate random action
+     */
+    private randomAction;
+    /**
+     * Simulate action effect on state (for lookahead)
+     */
+    private simulateAction;
+    /**
+     * Apply action to topology
+     */
+    private applyAction;
+    /**
+     * Calculate multi-objective reward
+     */
+    private calculateReward;
+    /**
+     * Train from replay buffer
+     */
+    private trainFromReplay;
+    private estimateMinCut;
+    private hasConnection;
+    private getDensity;
+    private getAverageDegree;
+    private getMinDegree;
+    private getAverageWeight;
+    private getWeightVariance;
+    private getAverageLatency;
+    private measureCommunicationEfficiency;
+    private getClusteringCoefficient;
+    private getNeighbors;
+    private getLoadStats;
+}
+/**
+ * Create a neural topology optimizer
+ */
+export declare function createNeuralTopologyOptimizer(topology: SwarmTopology, config?: Partial<TopologyOptimizerConfig>): NeuralTopologyOptimizer;
+//# sourceMappingURL=topology-optimizer.d.ts.map

package/dist/neural-optimizer/topology-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-optimizer.d.ts","sourceRoot":"","sources":["../../src/neural-optimizer/topology-optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAIvB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EAEd,MAAM,SAAS,CAAC;AASjB;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAAe;IAEnC,yCAAyC;IACzC,OAAO,CAAC,aAAa,CAAe;IAEpC,+BAA+B;IAC/B,OAAO,CAAC,YAAY,CAA0B;IAE9C,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAA0B;IAExC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAgB;IAEhC,kCAAkC;IAClC,OAAO,CAAC,SAAS,CAAyB;IAE1C,gCAAgC;IAChC,OAAO,CAAC,UAAU,CAAa;IAE/B,+BAA+B;IAC/B,OAAO,CAAC,OAAO,CAAS;IAExB,sBAAsB;IACtB,OAAO,CAAC,IAAI,CAAa;IAEzB,+BAA+B;IAC/B,OAAO,CAAC,UAAU,CAAa;IAE/B,oBAAoB;IACpB,OAAO,CAAC,QAAQ,CAAa;IAE7B,wBAAwB;IACxB,OAAO,CAAC,gBAAgB,CAAa;IAErC,oBAAoB;IACpB,OAAO,CAAC,YAAY,CAA6B;IAEjD,sBAAsB;IACtB,OAAO,CAAC,aAAa,CAAgB;IAErC,qBAAqB;IACrB,OAAO,CAAC,aAAa,CAAgB;IAErC,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAA+B;gBAG/C,QAAQ,EAAE,aAAa,EACvB,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAsC/C;;OAEG;IACH,YAAY,IAAI,kBAAkB;IA0FlC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAS7C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsBrC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAW1B;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IAsB7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,SAAS,IAAI,IAAI;IAwBjB;;OAEG;IACH,WAAW,IAAI,aAAa;IAY5B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAuCvC;;OAEG;IACH,OAAO,CAAC,eAAe;IA8CvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;CAwBrB;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,uBAAuB,CAEzB"}