agentic-qe 3.2.3 → 3.3.1

package/v3/dist/integrations/coherence/engines/spectral-adapter.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Agentic QE v3 - Spectral Engine Adapter
+ *
+ * Wraps the Prime Radiant SpectralEngine for spectral graph analysis.
+ * Used for predicting swarm collapse through Fiedler value analysis.
+ *
+ * Fiedler Value (Spectral Gap):
+ * The second-smallest eigenvalue of the Laplacian matrix.
+ * Low values indicate:
+ * - Weak connectivity
+ * - Potential for network fragmentation
+ * - False consensus risk
+ *
+ * @module integrations/coherence/engines/spectral-adapter
+ */
+import type { SwarmState, CollapseRisk, IWasmLoader, CoherenceLogger } from '../types';
+/**
+ * Interface for the spectral adapter
+ */
+export interface ISpectralAdapter {
+    /** Initialize the adapter */
+    initialize(): Promise<void>;
+    /** Check if initialized */
+    isInitialized(): boolean;
+    /** Add a node (agent) to the graph */
+    addNode(nodeId: string): void;
+    /** Add an edge (relationship) between nodes */
+    addEdge(source: string, target: string, weight: number): void;
+    /** Remove a node */
+    removeNode(nodeId: string): void;
+    /** Compute the Fiedler value */
+    computeFiedlerValue(): number;
+    /** Predict collapse risk */
+    predictCollapseRisk(): number;
+    /** Get weak vertices (at-risk nodes) */
+    getWeakVertices(count: number): string[];
+    /** Analyze swarm state for collapse risk */
+    analyzeSwarmState(state: SwarmState): CollapseRisk;
+    /** Clear the graph */
+    clear(): void;
+    /** Dispose of resources */
+    dispose(): void;
+}
+/**
+ * Adapter for the Prime Radiant SpectralEngine
+ *
+ * Provides spectral graph analysis for predicting swarm collapse
+ * and identifying weak points in the agent network.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new SpectralAdapter(wasmLoader, logger);
+ * await adapter.initialize();
+ *
+ * adapter.addNode('agent-1');
+ * adapter.addNode('agent-2');
+ * adapter.addEdge('agent-1', 'agent-2', 1.0);
+ *
+ * const fiedlerValue = adapter.computeFiedlerValue();
+ * const collapseRisk = adapter.predictCollapseRisk();
+ * const weakAgents = adapter.getWeakVertices(3);
+ * ```
+ */
+export declare class SpectralAdapter implements ISpectralAdapter {
+    private readonly wasmLoader;
+    private readonly logger;
+    private engine;
+    private initialized;
+    private readonly nodes;
+    private readonly edges;
+    /**
+     * Create a new SpectralAdapter
+     *
+     * @param wasmLoader - WASM module loader
+     * @param logger - Optional logger for diagnostics
+     */
+    constructor(wasmLoader: IWasmLoader, logger?: CoherenceLogger);
+    /**
+     * Initialize the adapter by loading the WASM module
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the adapter is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Ensure the adapter is initialized before use
+     */
+    private ensureInitialized;
+    /**
+     * Add a node (agent) to the spectral graph
+     *
+     * @param nodeId - Unique identifier for the node
+     */
+    addNode(nodeId: string): void;
+    /**
+     * Add an edge between two nodes
+     *
+     * @param source - Source node ID
+     * @param target - Target node ID
+     * @param weight - Edge weight (relationship strength)
+     */
+    addEdge(source: string, target: string, weight: number): void;
+    /**
+     * Remove a node from the graph
+     *
+     * @param nodeId - ID of the node to remove
+     */
+    removeNode(nodeId: string): void;
+    /**
+     * Compute the Fiedler value (algebraic connectivity)
+     *
+     * The Fiedler value is the second-smallest eigenvalue of the Laplacian.
+     * - Higher values indicate better connectivity
+     * - Low values suggest the network could easily split
+     * - Zero indicates disconnected components
+     *
+     * @returns The Fiedler value (>= 0)
+     */
+    computeFiedlerValue(): number;
+    /**
+     * Predict the risk of swarm collapse
+     *
+     * Based on spectral analysis of the agent connectivity graph.
+     *
+     * @returns Collapse risk (0-1, higher = more risk)
+     */
+    predictCollapseRisk(): number;
+    /**
+     * Get the nodes most at risk of causing collapse
+     *
+     * These are nodes whose removal would most significantly
+     * impact network connectivity.
+     *
+     * @param count - Number of weak vertices to return
+     * @returns Array of node IDs sorted by vulnerability
+     */
+    getWeakVertices(count: number): string[];
+    /**
+     * Analyze a swarm state for collapse risk
+     *
+     * Builds a spectral graph from the swarm state and analyzes it.
+     *
+     * @param state - Current swarm state
+     * @returns Collapse risk analysis
+     */
+    analyzeSwarmState(state: SwarmState): CollapseRisk;
+    /**
+     * Build edges between agents based on belief similarity
+     */
+    private buildEdgesFromAgents;
+    /**
+     * Compute similarity between two agents based on their states
+     */
+    private computeAgentSimilarity;
+    /**
+     * Compute overlap between belief sets using embedding similarity
+     */
+    private computeBeliefOverlap;
+    /**
+     * Compute cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Generate recommendations based on collapse analysis
+     */
+    private generateRecommendations;
+    /**
+     * Clear all nodes and edges from the graph
+     */
+    clear(): void;
+    /**
+     * Dispose of adapter resources
+     */
+    dispose(): void;
+    /**
+     * Get the number of nodes in the graph
+     */
+    getNodeCount(): number;
+    /**
+     * Get the number of edges in the graph
+     */
+    getEdgeCount(): number;
+}
+/**
+ * Create and initialize a SpectralAdapter
+ *
+ * @param wasmLoader - WASM module loader
+ * @param logger - Optional logger
+ * @returns Initialized adapter
+ */
+export declare function createSpectralAdapter(wasmLoader: IWasmLoader, logger?: CoherenceLogger): Promise<SpectralAdapter>;
+//# sourceMappingURL=spectral-adapter.d.ts.map

package/v3/dist/integrations/coherence/engines/spectral-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectral-adapter.d.ts","sourceRoot":"","sources":["../../../../src/integrations/coherence/engines/spectral-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EAGZ,WAAW,EACX,eAAe,EAChB,MAAM,UAAU,CAAC;AA2JlB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,2BAA2B;IAC3B,aAAa,IAAI,OAAO,CAAC;IACzB,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,oBAAoB;IACpB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gCAAgC;IAChC,mBAAmB,IAAI,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,mBAAmB,IAAI,MAAM,CAAC;IAC9B,wCAAwC;IACxC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzC,4CAA4C;IAC5C,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAAC;IACnD,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,2BAA2B;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAapD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiE;IAEvF;;;;;OAKG;gBAEgB,UAAU,EAAE,WAAW,EACvB,MAAM,GAAE,eAA0C;IAGrE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB7D;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBhC;;;;;;;;;OASG;IACH,mBAAmB,IAAI,MAAM;IAyB7B;;;;;;OAMG;IACH,mBAAmB,IAAI,MAAM;IAyB7B;;;;;;;;OAQG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAkCxC;;;;;;;OAOG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY;IA0ClD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgD/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAMD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,WAAW,EACvB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CAI1B"}