@agentic-qe/v3 3.0.0-alpha.10

package/dist/strange-loop/strange-loop.js

@@ -0,0 +1,354 @@
+/**
+ * Strange Loop Orchestrator
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Orchestrates the complete self-awareness cycle:
+ * Observe -> Model -> Decide -> Act -> (repeat)
+ *
+ * "You look in a mirror. You see yourself looking.
+ *  You adjust your hair *because* you saw it was messy.
+ *  The act of observing changed what you observed."
+ */
+import { DEFAULT_STRANGE_LOOP_CONFIG } from './types.js';
+import { SwarmObserver, InMemoryAgentProvider } from './swarm-observer.js';
+import { SwarmSelfModel } from './self-model.js';
+import { SelfHealingController, NoOpActionExecutor } from './healing-controller.js';
+// ============================================================================
+// Strange Loop Orchestrator
+// ============================================================================
+/**
+ * Orchestrates the strange loop self-awareness cycle
+ */
+export class StrangeLoopOrchestrator {
+    observer;
+    model;
+    healer;
+    config;
+    running = false;
+    loopHandle = null;
+    startTime = 0;
+    stats;
+    eventListeners = new Map();
+    myAgentId;
+    constructor(provider, executor, config = {}) {
+        this.config = { ...DEFAULT_STRANGE_LOOP_CONFIG, ...config };
+        this.myAgentId = provider.getObserverId();
+        this.observer = new SwarmObserver(provider);
+        this.model = new SwarmSelfModel(this.config.historySize);
+        this.healer = new SelfHealingController(this.model, executor, this.config);
+        this.stats = this.initializeStats();
+    }
+    /**
+     * Start the strange loop
+     */
+    async start() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        this.startTime = Date.now();
+        this.emit('loop_started', { config: this.config });
+        if (this.config.verboseLogging) {
+            console.log('[StrangeLoop] Starting self-observation cycle');
+        }
+        // Run first cycle immediately
+        await this.runCycle();
+        // Schedule subsequent cycles
+        this.loopHandle = setInterval(() => this.runCycle(), this.config.observationIntervalMs);
+    }
+    /**
+     * Stop the strange loop
+     */
+    async stop() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        if (this.loopHandle) {
+            clearInterval(this.loopHandle);
+            this.loopHandle = null;
+        }
+        this.emit('loop_stopped', { stats: this.getStats() });
+        if (this.config.verboseLogging) {
+            console.log('[StrangeLoop] Stopped self-observation cycle');
+        }
+    }
+    /**
+     * Check if the loop is running
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * Run a single observation-model-decide-act cycle
+     */
+    async runCycle() {
+        const cycleStart = Date.now();
+        try {
+            // OBSERVE: Gather swarm state
+            const observation = await this.observer.observe();
+            const observationDuration = Date.now() - cycleStart;
+            this.stats.totalObservations++;
+            this.stats.avgObservationDurationMs =
+                (this.stats.avgObservationDurationMs * (this.stats.totalObservations - 1) +
+                    observationDuration) /
+                    this.stats.totalObservations;
+            this.stats.lastObservationAt = observation.timestamp;
+            this.stats.currentHealth = observation.overallHealth;
+            this.emit('observation_complete', { observation, durationMs: observationDuration });
+            // MODEL: Update internal representation
+            const delta = this.model.updateModel(observation);
+            // Emit events for vulnerabilities
+            for (const vuln of delta.newVulnerabilities) {
+                this.stats.vulnerabilitiesDetected++;
+                this.emit('vulnerability_detected', { vulnerability: vuln });
+            }
+            for (const vuln of delta.resolvedVulnerabilities) {
+                this.stats.vulnerabilitiesResolved++;
+                this.emit('vulnerability_resolved', { vulnerability: vuln });
+            }
+            // Track health changes
+            const previousHealth = this.stats.currentHealth;
+            this.stats.currentHealth = observation.overallHealth;
+            this.stats.healthTrend = this.model.getHealthTrend();
+            if (observation.overallHealth < previousHealth - 0.1) {
+                this.emit('health_degraded', {
+                    previousHealth,
+                    currentHealth: observation.overallHealth,
+                });
+            }
+            else if (observation.overallHealth > previousHealth + 0.1) {
+                this.emit('health_improved', {
+                    previousHealth,
+                    currentHealth: observation.overallHealth,
+                });
+            }
+            // DECIDE: Determine if healing is needed
+            const actions = await this.healer.decide(observation);
+            const results = [];
+            if (actions.length > 0) {
+                if (this.config.verboseLogging) {
+                    console.log(`[StrangeLoop] Detected ${actions.length} healing opportunities`);
+                }
+                // ACT: Execute healing actions
+                for (const action of actions) {
+                    if (action.priority === 'critical' || action.priority === 'high') {
+                        this.emit('healing_action_started', { action });
+                        const result = await this.healer.act(action);
+                        results.push(result);
+                        this.stats.totalActionsExecuted++;
+                        if (result.success) {
+                            this.stats.successfulActions++;
+                            this.emit('healing_action_completed', { action, result });
+                        }
+                        else {
+                            this.stats.failedActions++;
+                            this.emit('healing_action_failed', { action, result });
+                        }
+                        this.stats.avgActionDurationMs =
+                            (this.stats.avgActionDurationMs * (this.stats.totalActionsExecuted - 1) +
+                                result.durationMs) /
+                                this.stats.totalActionsExecuted;
+                        if (this.config.verboseLogging) {
+                            console.log(`[StrangeLoop] Executed ${action.type}: ${result.message}`);
+                        }
+                    }
+                }
+            }
+            // Track predictions
+            const predictions = this.model.predictVulnerabilities();
+            for (const prediction of predictions) {
+                if (prediction.probability > this.config.predictionThreshold) {
+                    this.stats.predictionsMade++;
+                    this.emit('prediction_made', { prediction });
+                }
+            }
+            return { observation, delta, actions, results };
+        }
+        catch (error) {
+            if (this.config.verboseLogging) {
+                console.error('[StrangeLoop] Error in self-observation cycle:', error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * The agent observes itself being the bottleneck
+     */
+    async selfDiagnose() {
+        const observation = await this.observer.observe();
+        const myId = this.myAgentId;
+        const myHealth = observation.agentHealth.get(myId);
+        const amIBottleneck = observation.connectivity.bottlenecks.includes(myId);
+        const recommendations = [];
+        if (amIBottleneck) {
+            recommendations.push('Request backup agent');
+            recommendations.push('Reduce task queue');
+            recommendations.push('Offload connections');
+        }
+        if (myHealth) {
+            if (myHealth.memoryUtilization > 0.8) {
+                recommendations.push('Clear caches');
+                recommendations.push('Reduce memory usage');
+            }
+            if (myHealth.queuedTasks > 10) {
+                recommendations.push('Redistribute queued tasks');
+            }
+        }
+        return {
+            agentId: myId,
+            isHealthy: myHealth ? myHealth.responsiveness > 0.8 : true,
+            isBottleneck: amIBottleneck,
+            metrics: myHealth || this.getDefaultHealthMetrics(),
+            recommendations,
+            overallSwarmHealth: observation.overallHealth,
+            diagnosedAt: Date.now(),
+        };
+    }
+    /**
+     * Trigger an immediate observation
+     */
+    async triggerObservation() {
+        return this.observer.observe();
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            uptimeMs: this.running ? Date.now() - this.startTime : 0,
+        };
+    }
+    /**
+     * Get the current model state
+     */
+    getModelState() {
+        return this.model.getCurrentState();
+    }
+    /**
+     * Get observation history
+     */
+    getObservationHistory() {
+        return this.model.getHistory();
+    }
+    /**
+     * Get action history
+     */
+    getActionHistory() {
+        return this.healer.getActionHistory();
+    }
+    /**
+     * Register an event listener
+     */
+    on(eventType, listener) {
+        if (!this.eventListeners.has(eventType)) {
+            this.eventListeners.set(eventType, []);
+        }
+        this.eventListeners.get(eventType).push(listener);
+    }
+    /**
+     * Remove an event listener
+     */
+    off(eventType, listener) {
+        const listeners = this.eventListeners.get(eventType);
+        if (listeners) {
+            const index = listeners.indexOf(listener);
+            if (index !== -1) {
+                listeners.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Clear all state
+     */
+    clear() {
+        this.model.clear();
+        this.healer.clearHistory();
+        this.stats = this.initializeStats();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Emit an event to listeners
+     */
+    emit(type, data) {
+        const event = {
+            type,
+            timestamp: Date.now(),
+            data,
+            observerId: this.myAgentId,
+        };
+        const listeners = this.eventListeners.get(type);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(event);
+                }
+                catch (error) {
+                    if (this.config.verboseLogging) {
+                        console.error(`[StrangeLoop] Event listener error:`, error);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Initialize statistics
+     */
+    initializeStats() {
+        return {
+            totalObservations: 0,
+            totalActionsExecuted: 0,
+            successfulActions: 0,
+            failedActions: 0,
+            avgObservationDurationMs: 0,
+            avgActionDurationMs: 0,
+            vulnerabilitiesDetected: 0,
+            vulnerabilitiesResolved: 0,
+            predictionsMade: 0,
+            accuratePredictions: 0,
+            currentHealth: 1.0,
+            healthTrend: 'stable',
+            uptimeMs: 0,
+            lastObservationAt: 0,
+        };
+    }
+    /**
+     * Get default health metrics
+     */
+    getDefaultHealthMetrics() {
+        return {
+            responsiveness: 1.0,
+            taskCompletionRate: 1.0,
+            memoryUtilization: 0.3,
+            cpuUtilization: 0.3,
+            activeConnections: 0,
+            isBottleneck: false,
+            degree: 0,
+            queuedTasks: 0,
+            lastHeartbeat: Date.now(),
+            errorRate: 0,
+        };
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a strange loop orchestrator
+ */
+export function createStrangeLoopOrchestrator(provider, executor, config) {
+    return new StrangeLoopOrchestrator(provider, executor, config);
+}
+/**
+ * Create a strange loop orchestrator with in-memory components (for testing)
+ */
+export function createInMemoryStrangeLoop(observerId = 'observer-0', config) {
+    const provider = new InMemoryAgentProvider(observerId);
+    const executor = new NoOpActionExecutor();
+    const orchestrator = new StrangeLoopOrchestrator(provider, executor, config);
+    return { orchestrator, provider, executor };
+}
+//# sourceMappingURL=strange-loop.js.map

package/dist/strange-loop/strange-loop.js.map

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

package/dist/strange-loop/swarm-observer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Swarm Observer
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Collects swarm state through self-observation. This is the "Observe" step
+ * in the strange loop: Observe -> Model -> Decide -> Act
+ */
+import type { SwarmHealthObservation, AgentHealthMetrics, AgentNode, CommunicationEdge } from './types.js';
+/**
+ * Interface for retrieving agent information from the swarm
+ */
+export interface AgentProvider {
+    /** Get all active agents */
+    getAgents(): Promise<AgentNode[]>;
+    /** Get communication edges between agents */
+    getEdges(): Promise<CommunicationEdge[]>;
+    /** Get health metrics for a specific agent */
+    getAgentHealth(agentId: string): Promise<AgentHealthMetrics>;
+    /** Get the current observer's agent ID */
+    getObserverId(): string;
+}
+/**
+ * Default in-memory agent provider for testing and simple deployments
+ */
+export declare class InMemoryAgentProvider implements AgentProvider {
+    private agents;
+    private edges;
+    private healthMetrics;
+    private observerId;
+    constructor(observerId?: string);
+    getAgents(): Promise<AgentNode[]>;
+    getEdges(): Promise<CommunicationEdge[]>;
+    getAgentHealth(agentId: string): Promise<AgentHealthMetrics>;
+    getObserverId(): string;
+    addAgent(agent: AgentNode): void;
+    removeAgent(agentId: string): void;
+    addEdge(edge: CommunicationEdge): void;
+    setHealthMetrics(agentId: string, metrics: AgentHealthMetrics): void;
+    clear(): void;
+}
+/**
+ * Observes the swarm state and produces health observations
+ */
+export declare class SwarmObserver {
+    private provider;
+    private topologyAnalyzer;
+    private lastObservation;
+    constructor(provider: AgentProvider);
+    /**
+     * Perform a complete observation of the swarm state
+     */
+    observe(): Promise<SwarmHealthObservation>;
+    /**
+     * Get the last observation (if any)
+     */
+    getLastObservation(): SwarmHealthObservation | null;
+    /**
+     * Detect the type of topology based on structure
+     */
+    private detectTopologyType;
+    /**
+     * Calculate degree (number of connections) for an agent
+     */
+    private calculateDegree;
+    /**
+     * Detect vulnerabilities in the swarm
+     */
+    private detectVulnerabilities;
+    /**
+     * Find agents that depend on a given agent
+     */
+    private findDependentAgents;
+    /**
+     * Calculate overall swarm health score (0-1)
+     */
+    private calculateOverallHealth;
+}
+/**
+ * Create a swarm observer with the given provider
+ */
+export declare function createSwarmObserver(provider: AgentProvider): SwarmObserver;
+/**
+ * Create a swarm observer with an in-memory provider
+ */
+export declare function createInMemorySwarmObserver(observerId?: string): {
+    observer: SwarmObserver;
+    provider: InMemoryAgentProvider;
+};
+//# sourceMappingURL=swarm-observer.d.ts.map

package/dist/strange-loop/swarm-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-observer.d.ts","sourceRoot":"","sources":["../../src/strange-loop/swarm-observer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,sBAAsB,EAGtB,kBAAkB,EAElB,SAAS,EACT,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAElC,6CAA6C;IAC7C,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEzC,8CAA8C;IAC9C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7D,0CAA0C;IAC1C,aAAa,IAAI,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAqB;IAIvC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIjC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBlE,aAAa,IAAI,MAAM;IAKvB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIhC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASlC,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAItC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIpE,KAAK,IAAI,IAAI;CAKd;AAMD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAAuC;gBAElD,QAAQ,EAAE,aAAa;IAKnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAiEhD;;OAEG;IACH,kBAAkB,IAAI,sBAAsB,GAAG,IAAI;IAInD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmD1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0F7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAqC/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAE1E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,GAAE,MAAqB,GAChC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,CAI9D"}