@agentic-qe/v3 3.0.0-alpha.3

package/dist/strange-loop/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Strange Loop Self-Awareness Module
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Implements the self-observation -> self-modeling -> self-healing cycle
+ * that enables autonomous QE systems with genuine self-awareness.
+ *
+ * The Strange Loop Pattern:
+ * ```
+ *    Observe -> Model -> Decide -> Act
+ *       ^                          |
+ *       └──────────────────────────┘
+ *
+ *    "I see I'm weak here, so I strengthen"
+ * ```
+ *
+ * @module strange-loop
+ */
+export type { TopologyType, AgentNode, CommunicationEdge, SwarmTopology, AgentHealthMetrics, ConnectivityMetrics, SwarmVulnerability, SwarmHealthObservation, SerializedSwarmHealthObservation, TrendDirection, TrendAnalysis, BottleneckInfo, BottleneckAnalysis, PredictedVulnerability, SwarmModelDelta, SwarmModelState, SelfHealingActionType, ActionPriority, SelfHealingAction, ActionResult, ExecutedAction, SelfDiagnosis, StrangeLoopConfig, StrangeLoopStats, StrangeLoopEventType, StrangeLoopEvent, StrangeLoopEventListener, } from './types.js';
+export { DEFAULT_STRANGE_LOOP_CONFIG } from './types.js';
+export { SwarmObserver, createSwarmObserver, createInMemorySwarmObserver, InMemoryAgentProvider, type AgentProvider, } from './swarm-observer.js';
+export { TopologyAnalyzer, createTopologyAnalyzer, } from './topology-analyzer.js';
+export { SwarmSelfModel, createSwarmSelfModel, } from './self-model.js';
+export { SelfHealingController, createSelfHealingController, NoOpActionExecutor, type ActionExecutor, } from './healing-controller.js';
+export { StrangeLoopOrchestrator, createStrangeLoopOrchestrator, createInMemoryStrangeLoop, } from './strange-loop.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/strange-loop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strange-loop/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,YAAY,EAEV,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,aAAa,EAGb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAGlB,sBAAsB,EACtB,gCAAgC,EAGhC,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,eAAe,EAGf,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EAGd,aAAa,EAGb,iBAAiB,EAGjB,gBAAgB,EAGhB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/strange-loop/index.js

@@ -0,0 +1,30 @@
+/**
+ * Strange Loop Self-Awareness Module
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Implements the self-observation -> self-modeling -> self-healing cycle
+ * that enables autonomous QE systems with genuine self-awareness.
+ *
+ * The Strange Loop Pattern:
+ * ```
+ *    Observe -> Model -> Decide -> Act
+ *       ^                          |
+ *       └──────────────────────────┘
+ *
+ *    "I see I'm weak here, so I strengthen"
+ * ```
+ *
+ * @module strange-loop
+ */
+export { DEFAULT_STRANGE_LOOP_CONFIG } from './types.js';
+// Swarm Observer
+export { SwarmObserver, createSwarmObserver, createInMemorySwarmObserver, InMemoryAgentProvider, } from './swarm-observer.js';
+// Topology Analyzer
+export { TopologyAnalyzer, createTopologyAnalyzer, } from './topology-analyzer.js';
+// Self-Model
+export { SwarmSelfModel, createSwarmSelfModel, } from './self-model.js';
+// Self-Healing Controller
+export { SelfHealingController, createSelfHealingController, NoOpActionExecutor, } from './healing-controller.js';
+// Strange Loop Orchestrator
+export { StrangeLoopOrchestrator, createStrangeLoopOrchestrator, createInMemoryStrangeLoop, } from './strange-loop.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strange-loop/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkDH,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GAEtB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,aAAa;AACb,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,0BAA0B;AAC1B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAEjC,4BAA4B;AAC5B,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/strange-loop/self-model.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Swarm Self-Model
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Maintains an internal model of the swarm state, tracks history,
+ * and predicts future vulnerabilities based on trends.
+ */
+import type { SwarmHealthObservation, SwarmModelState, SwarmModelDelta, TrendAnalysis, TrendDirection, PredictedVulnerability, BottleneckAnalysis, AgentHealthMetrics, SerializedSwarmHealthObservation } from './types.js';
+/**
+ * Maintains an internal representation of the swarm state
+ * and provides trend analysis and vulnerability prediction.
+ */
+export declare class SwarmSelfModel {
+    private observationHistory;
+    private currentState;
+    private topologyAnalyzer;
+    private maxHistorySize;
+    constructor(maxHistorySize?: number);
+    /**
+     * Update the model with a new observation
+     */
+    updateModel(observation: SwarmHealthObservation): SwarmModelDelta;
+    /**
+     * Get the current model state
+     */
+    getCurrentState(): SwarmModelState | null;
+    /**
+     * Get the observation history
+     */
+    getHistory(): readonly SwarmHealthObservation[];
+    /**
+     * Find bottleneck agents using min-cut analysis
+     */
+    findBottlenecks(): BottleneckAnalysis;
+    /**
+     * Predict future vulnerabilities based on trends
+     */
+    predictVulnerabilities(): PredictedVulnerability[];
+    /**
+     * Analyze trend in a series of values
+     */
+    analyzeTrend(values: number[]): TrendAnalysis;
+    /**
+     * Estimate time until a threshold is reached
+     */
+    private estimateTimeToThreshold;
+    /**
+     * Get average time between observations
+     */
+    private getAverageObservationInterval;
+    /**
+     * Aggregate agent health across observations
+     */
+    aggregateAgentHealth(): Map<string, AgentHealthMetrics[]>;
+    /**
+     * Compute delta between previous state and new observation
+     */
+    private computeDelta;
+    /**
+     * Get health trend over recent observations
+     */
+    getHealthTrend(): TrendDirection;
+    /**
+     * Get current overall health
+     */
+    getCurrentHealth(): number;
+    /**
+     * Clear all history and state
+     */
+    clear(): void;
+    /**
+     * Export history for persistence
+     */
+    exportHistory(): SerializedSwarmHealthObservation[];
+    /**
+     * Import history from persistence
+     */
+    importHistory(history: SerializedSwarmHealthObservation[]): void;
+}
+/**
+ * Create a new swarm self-model
+ */
+export declare function createSwarmSelfModel(maxHistorySize?: number): SwarmSelfModel;
+//# sourceMappingURL=self-model.d.ts.map

package/dist/strange-loop/self-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-model.d.ts","sourceRoot":"","sources":["../../src/strange-loop/self-model.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAElB,kBAAkB,EAElB,gCAAgC,EACjC,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,GAAE,MAAY;IAKxC;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,sBAAsB,GAAG,eAAe;IA2BjE;;OAEG;IACH,eAAe,IAAI,eAAe,GAAG,IAAI;IAIzC;;OAEG;IACH,UAAU,IAAI,SAAS,sBAAsB,EAAE;IAI/C;;OAEG;IACH,eAAe,IAAI,kBAAkB;IAarC;;OAEG;IACH,sBAAsB,IAAI,sBAAsB,EAAE;IAmHlD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa;IAwD7C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAerC;;OAEG;IACH,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAezD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8EpB;;OAEG;IACH,cAAc,IAAI,cAAc;IAMhC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAO1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,IAAI,gCAAgC,EAAE;IAOnD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,gCAAgC,EAAE,GAAG,IAAI;CAmBjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,CAE5E"}

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

@@ -0,0 +1,378 @@
+/**
+ * Swarm Self-Model
+ * ADR-031: Strange Loop Self-Awareness
+ *
+ * Maintains an internal model of the swarm state, tracks history,
+ * and predicts future vulnerabilities based on trends.
+ */
+import { TopologyAnalyzer } from './topology-analyzer.js';
+// ============================================================================
+// Swarm Self-Model
+// ============================================================================
+/**
+ * Maintains an internal representation of the swarm state
+ * and provides trend analysis and vulnerability prediction.
+ */
+export class SwarmSelfModel {
+    observationHistory = [];
+    currentState = null;
+    topologyAnalyzer;
+    maxHistorySize;
+    constructor(maxHistorySize = 100) {
+        this.maxHistorySize = maxHistorySize;
+        this.topologyAnalyzer = new TopologyAnalyzer();
+    }
+    /**
+     * Update the model with a new observation
+     */
+    updateModel(observation) {
+        const previousState = this.currentState;
+        // Compute delta before updating
+        const delta = this.computeDelta(previousState, observation);
+        // Update current state
+        this.currentState = {
+            topology: observation.topology,
+            connectivity: observation.connectivity,
+            agentHealth: observation.agentHealth,
+            activeVulnerabilities: observation.vulnerabilities,
+            lastUpdated: observation.timestamp,
+            version: previousState ? previousState.version + 1 : 1,
+        };
+        // Add to history
+        this.observationHistory.push(observation);
+        // Trim history if needed
+        while (this.observationHistory.length > this.maxHistorySize) {
+            this.observationHistory.shift();
+        }
+        return delta;
+    }
+    /**
+     * Get the current model state
+     */
+    getCurrentState() {
+        return this.currentState;
+    }
+    /**
+     * Get the observation history
+     */
+    getHistory() {
+        return this.observationHistory;
+    }
+    /**
+     * Find bottleneck agents using min-cut analysis
+     */
+    findBottlenecks() {
+        if (!this.currentState) {
+            return {
+                bottlenecks: [],
+                overallHealth: 1.0,
+                minCut: 0,
+                analyzedAt: Date.now(),
+            };
+        }
+        return this.topologyAnalyzer.analyzeBottlenecks(this.currentState.topology);
+    }
+    /**
+     * Predict future vulnerabilities based on trends
+     */
+    predictVulnerabilities() {
+        if (this.observationHistory.length < 3) {
+            return [];
+        }
+        const predictions = [];
+        // 1. Analyze connectivity trend
+        const minCutValues = this.observationHistory.map(o => o.connectivity.minCut);
+        const minCutTrend = this.analyzeTrend(minCutValues);
+        if (minCutTrend.direction === 'decreasing' && minCutTrend.rate > 0.1) {
+            const timeToThreshold = this.estimateTimeToThreshold(minCutValues, minCutTrend, 1 // Threshold: minCut = 1
+            );
+            predictions.push({
+                type: 'connectivity_degradation',
+                probability: Math.min(minCutTrend.rate * 2 * minCutTrend.confidence, 0.95),
+                timeToOccurrence: timeToThreshold,
+                suggestedAction: 'add_redundant_connections',
+                confidence: minCutTrend.confidence,
+            });
+        }
+        // 2. Analyze overall health trend
+        const healthValues = this.observationHistory.map(o => o.overallHealth);
+        const healthTrend = this.analyzeTrend(healthValues);
+        if (healthTrend.direction === 'decreasing' && healthTrend.rate > 0.05) {
+            const timeToThreshold = this.estimateTimeToThreshold(healthValues, healthTrend, 0.5 // Threshold: health = 0.5
+            );
+            predictions.push({
+                type: 'connectivity_degradation',
+                probability: Math.min(healthTrend.rate * 3 * healthTrend.confidence, 0.9),
+                timeToOccurrence: timeToThreshold,
+                suggestedAction: 'scale_up',
+                confidence: healthTrend.confidence,
+            });
+        }
+        // 3. Analyze agent-specific health trends
+        const agentHealthHistory = this.aggregateAgentHealth();
+        for (const [agentId, healthHistory] of agentHealthHistory) {
+            if (healthHistory.length < 3)
+                continue;
+            const responsivenessValues = healthHistory.map(h => h.responsiveness);
+            const responsivenessTrend = this.analyzeTrend(responsivenessValues);
+            if (responsivenessTrend.direction === 'decreasing' && responsivenessTrend.rate > 0.15) {
+                const timeToThreshold = this.estimateTimeToThreshold(responsivenessValues, responsivenessTrend, 0.5 // Threshold: responsiveness = 0.5
+                );
+                predictions.push({
+                    type: 'agent_degradation',
+                    agentId,
+                    probability: Math.min(responsivenessTrend.rate * 2.5 * responsivenessTrend.confidence, 0.9),
+                    timeToOccurrence: timeToThreshold,
+                    suggestedAction: 'spawn_backup_agent',
+                    confidence: responsivenessTrend.confidence,
+                });
+            }
+            // Check memory utilization trend
+            const memoryValues = healthHistory.map(h => h.memoryUtilization);
+            const memoryTrend = this.analyzeTrend(memoryValues);
+            if (memoryTrend.direction === 'increasing' && memoryTrend.rate > 0.1) {
+                const timeToThreshold = this.estimateTimeToThreshold(memoryValues, memoryTrend, 0.95 // Threshold: memory = 95%
+                );
+                predictions.push({
+                    type: 'overload_imminent',
+                    agentId,
+                    probability: Math.min(memoryTrend.rate * 2 * memoryTrend.confidence, 0.85),
+                    timeToOccurrence: timeToThreshold,
+                    suggestedAction: 'redistribute_load',
+                    confidence: memoryTrend.confidence,
+                });
+            }
+        }
+        // 4. Check for partition risk
+        const componentValues = this.observationHistory.map(o => o.connectivity.components);
+        const componentTrend = this.analyzeTrend(componentValues);
+        if (componentTrend.direction === 'increasing' && componentTrend.rate > 0) {
+            predictions.push({
+                type: 'partition_risk',
+                probability: Math.min(componentTrend.rate * 4 * componentTrend.confidence, 0.8),
+                timeToOccurrence: this.estimateTimeToThreshold(componentValues, componentTrend, 2),
+                suggestedAction: 'add_cross_component_connections',
+                confidence: componentTrend.confidence,
+            });
+        }
+        // Sort by probability descending
+        predictions.sort((a, b) => b.probability - a.probability);
+        return predictions;
+    }
+    /**
+     * Analyze trend in a series of values
+     */
+    analyzeTrend(values) {
+        if (values.length < 2) {
+            return {
+                direction: 'stable',
+                rate: 0,
+                confidence: 0,
+                dataPoints: values.length,
+            };
+        }
+        // Calculate linear regression
+        const n = values.length;
+        let sumX = 0;
+        let sumY = 0;
+        let sumXY = 0;
+        let sumX2 = 0;
+        let sumY2 = 0;
+        for (let i = 0; i < n; i++) {
+            sumX += i;
+            sumY += values[i];
+            sumXY += i * values[i];
+            sumX2 += i * i;
+            sumY2 += values[i] * values[i];
+        }
+        // Slope of the regression line
+        const slope = (n * sumXY - sumX * sumY) / (n * sumX2 - sumX * sumX);
+        // Correlation coefficient (R)
+        const denominator = Math.sqrt((n * sumX2 - sumX * sumX) * (n * sumY2 - sumY * sumY));
+        const r = denominator !== 0 ? (n * sumXY - sumX * sumY) / denominator : 0;
+        // Determine direction
+        let direction;
+        if (Math.abs(slope) < 0.01) {
+            direction = 'stable';
+        }
+        else if (slope > 0) {
+            direction = 'increasing';
+        }
+        else {
+            direction = 'decreasing';
+        }
+        // Confidence based on correlation strength
+        const confidence = Math.abs(r);
+        return {
+            direction,
+            rate: Math.abs(slope),
+            confidence,
+            dataPoints: n,
+        };
+    }
+    /**
+     * Estimate time until a threshold is reached
+     */
+    estimateTimeToThreshold(values, trend, threshold) {
+        if (values.length === 0 || trend.rate === 0) {
+            return Infinity;
+        }
+        const currentValue = values[values.length - 1];
+        const timeDelta = this.getAverageObservationInterval();
+        // Calculate how many observations until threshold
+        let valueDiff;
+        if (trend.direction === 'decreasing') {
+            valueDiff = currentValue - threshold;
+        }
+        else {
+            valueDiff = threshold - currentValue;
+        }
+        if (valueDiff <= 0) {
+            return 0; // Already past threshold
+        }
+        const observationsNeeded = valueDiff / trend.rate;
+        return observationsNeeded * timeDelta;
+    }
+    /**
+     * Get average time between observations
+     */
+    getAverageObservationInterval() {
+        if (this.observationHistory.length < 2) {
+            return 5000; // Default 5 seconds
+        }
+        let totalInterval = 0;
+        for (let i = 1; i < this.observationHistory.length; i++) {
+            totalInterval +=
+                this.observationHistory[i].timestamp -
+                    this.observationHistory[i - 1].timestamp;
+        }
+        return totalInterval / (this.observationHistory.length - 1);
+    }
+    /**
+     * Aggregate agent health across observations
+     */
+    aggregateAgentHealth() {
+        const healthByAgent = new Map();
+        for (const observation of this.observationHistory) {
+            for (const [agentId, health] of observation.agentHealth) {
+                if (!healthByAgent.has(agentId)) {
+                    healthByAgent.set(agentId, []);
+                }
+                healthByAgent.get(agentId).push(health);
+            }
+        }
+        return healthByAgent;
+    }
+    /**
+     * Compute delta between previous state and new observation
+     */
+    computeDelta(previousState, observation) {
+        if (!previousState) {
+            return {
+                agentsAdded: observation.topology.agents.map(a => a.id),
+                agentsRemoved: [],
+                edgesAdded: observation.topology.edgeCount,
+                edgesRemoved: 0,
+                connectivityDelta: observation.connectivity.minCut,
+                newVulnerabilities: observation.vulnerabilities,
+                resolvedVulnerabilities: [],
+                isSignificant: true,
+            };
+        }
+        // Find added and removed agents
+        const previousAgentIds = new Set(previousState.topology.agents.map(a => a.id));
+        const currentAgentIds = new Set(observation.topology.agents.map(a => a.id));
+        const agentsAdded = observation.topology.agents
+            .filter(a => !previousAgentIds.has(a.id))
+            .map(a => a.id);
+        const agentsRemoved = previousState.topology.agents
+            .filter(a => !currentAgentIds.has(a.id))
+            .map(a => a.id);
+        // Calculate edge changes
+        const edgeDelta = observation.topology.edgeCount - previousState.topology.edgeCount;
+        // Calculate connectivity change
+        const connectivityDelta = observation.connectivity.minCut - previousState.connectivity.minCut;
+        // Find new and resolved vulnerabilities
+        const previousVulnKeys = new Set(previousState.activeVulnerabilities.map(v => `${v.type}:${v.affectedAgents.sort().join(',')}`));
+        const currentVulnKeys = new Set(observation.vulnerabilities.map(v => `${v.type}:${v.affectedAgents.sort().join(',')}`));
+        const newVulnerabilities = observation.vulnerabilities.filter(v => !previousVulnKeys.has(`${v.type}:${v.affectedAgents.sort().join(',')}`));
+        const resolvedVulnerabilities = previousState.activeVulnerabilities.filter(v => !currentVulnKeys.has(`${v.type}:${v.affectedAgents.sort().join(',')}`));
+        // Determine if changes are significant
+        const isSignificant = agentsAdded.length > 0 ||
+            agentsRemoved.length > 0 ||
+            Math.abs(connectivityDelta) >= 1 ||
+            newVulnerabilities.length > 0 ||
+            resolvedVulnerabilities.length > 0;
+        return {
+            agentsAdded,
+            agentsRemoved,
+            edgesAdded: edgeDelta > 0 ? edgeDelta : 0,
+            edgesRemoved: edgeDelta < 0 ? -edgeDelta : 0,
+            connectivityDelta,
+            newVulnerabilities,
+            resolvedVulnerabilities,
+            isSignificant,
+        };
+    }
+    /**
+     * Get health trend over recent observations
+     */
+    getHealthTrend() {
+        const healthValues = this.observationHistory.map(o => o.overallHealth);
+        const trend = this.analyzeTrend(healthValues);
+        return trend.direction;
+    }
+    /**
+     * Get current overall health
+     */
+    getCurrentHealth() {
+        if (this.observationHistory.length === 0) {
+            return 1.0;
+        }
+        return this.observationHistory[this.observationHistory.length - 1].overallHealth;
+    }
+    /**
+     * Clear all history and state
+     */
+    clear() {
+        this.observationHistory = [];
+        this.currentState = null;
+    }
+    /**
+     * Export history for persistence
+     */
+    exportHistory() {
+        return this.observationHistory.map(o => ({
+            ...o,
+            agentHealth: Array.from(o.agentHealth.entries()),
+        }));
+    }
+    /**
+     * Import history from persistence
+     */
+    importHistory(history) {
+        this.observationHistory = history.map(o => ({
+            ...o,
+            agentHealth: new Map(o.agentHealth),
+        }));
+        // Rebuild current state from latest observation
+        if (this.observationHistory.length > 0) {
+            const latest = this.observationHistory[this.observationHistory.length - 1];
+            this.currentState = {
+                topology: latest.topology,
+                connectivity: latest.connectivity,
+                agentHealth: latest.agentHealth,
+                activeVulnerabilities: latest.vulnerabilities,
+                lastUpdated: latest.timestamp,
+                version: this.observationHistory.length,
+            };
+        }
+    }
+}
+/**
+ * Create a new swarm self-model
+ */
+export function createSwarmSelfModel(maxHistorySize) {
+    return new SwarmSelfModel(maxHistorySize);
+}
+//# sourceMappingURL=self-model.js.map

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

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

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

@@ -0,0 +1,112 @@
+/**
+ * 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 type { SwarmHealthObservation, SelfHealingAction, ActionResult, SelfDiagnosis, StrangeLoopConfig, StrangeLoopStats, StrangeLoopEventType, StrangeLoopEventListener, SwarmModelDelta } from './types.js';
+import { AgentProvider, InMemoryAgentProvider } from './swarm-observer.js';
+import { ActionExecutor, NoOpActionExecutor } from './healing-controller.js';
+/**
+ * Orchestrates the strange loop self-awareness cycle
+ */
+export declare class StrangeLoopOrchestrator {
+    private observer;
+    private model;
+    private healer;
+    private config;
+    private running;
+    private loopHandle;
+    private startTime;
+    private stats;
+    private eventListeners;
+    private myAgentId;
+    constructor(provider: AgentProvider, executor: ActionExecutor, config?: Partial<StrangeLoopConfig>);
+    /**
+     * Start the strange loop
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the strange loop
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the loop is running
+     */
+    isRunning(): boolean;
+    /**
+     * Run a single observation-model-decide-act cycle
+     */
+    runCycle(): Promise<{
+        observation: SwarmHealthObservation;
+        delta: SwarmModelDelta;
+        actions: SelfHealingAction[];
+        results: ActionResult[];
+    }>;
+    /**
+     * The agent observes itself being the bottleneck
+     */
+    selfDiagnose(): Promise<SelfDiagnosis>;
+    /**
+     * Trigger an immediate observation
+     */
+    triggerObservation(): Promise<SwarmHealthObservation>;
+    /**
+     * Get current statistics
+     */
+    getStats(): StrangeLoopStats;
+    /**
+     * Get the current model state
+     */
+    getModelState(): import("./types.js").SwarmModelState | null;
+    /**
+     * Get observation history
+     */
+    getObservationHistory(): readonly SwarmHealthObservation[];
+    /**
+     * Get action history
+     */
+    getActionHistory(): readonly import("./types.js").ExecutedAction[];
+    /**
+     * Register an event listener
+     */
+    on(eventType: StrangeLoopEventType, listener: StrangeLoopEventListener): void;
+    /**
+     * Remove an event listener
+     */
+    off(eventType: StrangeLoopEventType, listener: StrangeLoopEventListener): void;
+    /**
+     * Clear all state
+     */
+    clear(): void;
+    /**
+     * Emit an event to listeners
+     */
+    private emit;
+    /**
+     * Initialize statistics
+     */
+    private initializeStats;
+    /**
+     * Get default health metrics
+     */
+    private getDefaultHealthMetrics;
+}
+/**
+ * Create a strange loop orchestrator
+ */
+export declare function createStrangeLoopOrchestrator(provider: AgentProvider, executor: ActionExecutor, config?: Partial<StrangeLoopConfig>): StrangeLoopOrchestrator;
+/**
+ * Create a strange loop orchestrator with in-memory components (for testing)
+ */
+export declare function createInMemoryStrangeLoop(observerId?: string, config?: Partial<StrangeLoopConfig>): {
+    orchestrator: StrangeLoopOrchestrator;
+    provider: InMemoryAgentProvider;
+    executor: NoOpActionExecutor;
+};
+//# sourceMappingURL=strange-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strange-loop.d.ts","sourceRoot":"","sources":["../../src/strange-loop/strange-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAEhB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAiB,aAAa,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EAAyB,cAAc,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMpG;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAoB;IAElC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,cAAc,CAAoE;IAC1F,OAAO,CAAC,SAAS,CAAS;gBAGxB,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAYzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,WAAW,EAAE,sBAAsB,CAAC;QACpC,KAAK,EAAE,eAAe,CAAC;QACvB,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,CAAC;IAyGF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAmC5C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAI3D;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAO5B;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,qBAAqB;IAIrB;;OAEG;IACH,gBAAgB;IAIhB;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAO7E;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAU9E;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,CAAC,IAAI;IAsBZ;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAchC;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,uBAAuB,CAEzB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,GAAE,MAAqB,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC;IACD,YAAY,EAAE,uBAAuB,CAAC;IACtC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAMA"}