agentic-qe 3.2.3 → 3.3.1

package/v3/dist/mcp/tools/coherence/check.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Agentic QE v3 - Coherence Check MCP Tool
+ * ADR-052: Phase 4 Action A4.1
+ *
+ * qe/coherence/check - Check coherence of beliefs/facts using Prime Radiant
+ *
+ * Uses the CoherenceService to verify mathematical coherence of a set of nodes,
+ * detecting contradictions and computing the overall coherence energy.
+ */
+import { MCPToolBase, MCPToolConfig, MCPToolContext } from '../base.js';
+import { ToolResult } from '../../types.js';
+import { type ComputeLane } from '../../../integrations/coherence/index.js';
+/**
+ * Parameters for coherence check
+ */
+export interface CoherenceCheckParams {
+    /** Nodes to check for coherence - each node has id, embedding, and optional weight/metadata */
+    nodes: Array<{
+        /** Unique identifier for the node */
+        id: string;
+        /** Embedding vector (array of numbers) */
+        embedding: number[];
+        /** Optional weight (0-1, defaults to 1.0) */
+        weight?: number;
+        /** Optional metadata */
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Optional custom energy threshold for contradiction detection (default: 0.4) */
+    energyThreshold?: number;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Result of coherence check
+ */
+export interface CoherenceCheckResult {
+    /** Whether the nodes are coherent */
+    isCoherent: boolean;
+    /** Computed coherence energy (lower = more coherent) */
+    energy: number;
+    /** Compute lane based on energy threshold */
+    lane: ComputeLane;
+    /** Detected contradictions */
+    contradictions: Array<{
+        /** IDs of the contradicting nodes */
+        nodeIds: [string, string];
+        /** Severity of the contradiction */
+        severity: string;
+        /** Human-readable description */
+        description: string;
+    }>;
+    /** Recommendations for resolving incoherence */
+    recommendations: string[];
+    /** Number of nodes analyzed */
+    nodeCount: number;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Whether fallback logic was used */
+    usedFallback: boolean;
+}
+/**
+ * Coherence Check Tool
+ *
+ * Uses Prime Radiant's sheaf cohomology engine to verify mathematical
+ * coherence of a set of nodes/beliefs.
+ *
+ * @example
+ * ```typescript
+ * const result = await tool.invoke({
+ *   nodes: [
+ *     { id: 'belief-1', embedding: [0.1, 0.2, ...], weight: 0.9 },
+ *     { id: 'belief-2', embedding: [0.3, 0.1, ...], weight: 0.8 },
+ *   ],
+ *   energyThreshold: 0.4,
+ * });
+ *
+ * if (!result.data.isCoherent) {
+ *   console.log('Contradictions found:', result.data.contradictions);
+ * }
+ * ```
+ */
+export declare class CoherenceCheckTool extends MCPToolBase<CoherenceCheckParams, CoherenceCheckResult> {
+    readonly config: MCPToolConfig;
+    private coherenceService;
+    /**
+     * Get or create the CoherenceService instance
+     */
+    private getService;
+    /**
+     * Reset instance cache (called when fleet is disposed)
+     */
+    resetInstanceCache(): void;
+    /**
+     * Execute the coherence check
+     */
+    execute(params: CoherenceCheckParams, context: MCPToolContext): Promise<ToolResult<CoherenceCheckResult>>;
+    /**
+     * Generate additional recommendations based on coherence results
+     */
+    private generateAdditionalRecommendations;
+}
+/**
+ * Create a CoherenceCheckTool instance
+ */
+export declare function createCoherenceCheckTool(): CoherenceCheckTool;
+//# sourceMappingURL=check.d.ts.map

package/v3/dist/mcp/tools/coherence/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,0CAA0C,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+FAA+F;IAC/F,KAAK,EAAE,KAAK,CAAC;QACX,qCAAqC;QACrC,EAAE,EAAE,MAAM,CAAC;QACX,0CAA0C;QAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,6CAA6C;QAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,wBAAwB;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,cAAc,EAAE,KAAK,CAAC;QACpB,qCAAqC;QACrC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,oCAAoC;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,iCAAiC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,gDAAgD;IAChD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AA6BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CACjD,oBAAoB,EACpB,oBAAoB,CACrB;IACC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAS5B;IAEF,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;OAEG;YACW,UAAU;IAOxB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAuG5C;;OAEG;IACH,OAAO,CAAC,iCAAiC;CAiC1C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/v3/dist/mcp/tools/coherence/check.js

@@ -0,0 +1,205 @@
+/**
+ * Agentic QE v3 - Coherence Check MCP Tool
+ * ADR-052: Phase 4 Action A4.1
+ *
+ * qe/coherence/check - Check coherence of beliefs/facts using Prime Radiant
+ *
+ * Uses the CoherenceService to verify mathematical coherence of a set of nodes,
+ * detecting contradictions and computing the overall coherence energy.
+ */
+import { MCPToolBase, } from '../base.js';
+import { createCoherenceService, wasmLoader, } from '../../../integrations/coherence/index.js';
+// ============================================================================
+// Schema
+// ============================================================================
+const COHERENCE_CHECK_SCHEMA = {
+    type: 'object',
+    properties: {
+        nodes: {
+            type: 'array',
+            description: 'Array of nodes to check for coherence. Each node must have an id and embedding vector.',
+        },
+        energyThreshold: {
+            type: 'number',
+            description: 'Custom energy threshold for contradiction detection (default: 0.4)',
+            minimum: 0,
+            maximum: 1,
+        },
+    },
+    required: ['nodes'],
+};
+// ============================================================================
+// Tool Implementation
+// ============================================================================
+/**
+ * Coherence Check Tool
+ *
+ * Uses Prime Radiant's sheaf cohomology engine to verify mathematical
+ * coherence of a set of nodes/beliefs.
+ *
+ * @example
+ * ```typescript
+ * const result = await tool.invoke({
+ *   nodes: [
+ *     { id: 'belief-1', embedding: [0.1, 0.2, ...], weight: 0.9 },
+ *     { id: 'belief-2', embedding: [0.3, 0.1, ...], weight: 0.8 },
+ *   ],
+ *   energyThreshold: 0.4,
+ * });
+ *
+ * if (!result.data.isCoherent) {
+ *   console.log('Contradictions found:', result.data.contradictions);
+ * }
+ * ```
+ */
+export class CoherenceCheckTool extends MCPToolBase {
+    config = {
+        name: 'qe/coherence/check',
+        description: 'Check mathematical coherence of beliefs/facts using Prime Radiant sheaf cohomology. ' +
+            'Detects contradictions and computes coherence energy for multi-agent coordination.',
+        domain: 'learning-optimization',
+        schema: COHERENCE_CHECK_SCHEMA,
+        streaming: false,
+        timeout: 30000,
+    };
+    coherenceService = null;
+    /**
+     * Get or create the CoherenceService instance
+     */
+    async getService() {
+        if (!this.coherenceService) {
+            this.coherenceService = await createCoherenceService(wasmLoader);
+        }
+        return this.coherenceService;
+    }
+    /**
+     * Reset instance cache (called when fleet is disposed)
+     */
+    resetInstanceCache() {
+        if (this.coherenceService) {
+            this.coherenceService.dispose();
+            this.coherenceService = null;
+        }
+    }
+    /**
+     * Execute the coherence check
+     */
+    async execute(params, context) {
+        const startTime = Date.now();
+        const { nodes, energyThreshold = 0.4 } = params;
+        // Validate nodes
+        if (!nodes || nodes.length === 0) {
+            return {
+                success: false,
+                error: 'At least one node is required for coherence check',
+            };
+        }
+        // Validate embeddings
+        for (const node of nodes) {
+            if (!node.embedding || !Array.isArray(node.embedding)) {
+                return {
+                    success: false,
+                    error: `Node ${node.id} has invalid embedding - must be an array of numbers`,
+                };
+            }
+        }
+        try {
+            // Get service (initializes WASM if needed)
+            const service = await this.getService();
+            // Convert to CoherenceNode format
+            const coherenceNodes = nodes.map((node) => ({
+                id: node.id,
+                embedding: node.embedding,
+                weight: node.weight ?? 1.0,
+                metadata: node.metadata,
+            }));
+            // Perform coherence check
+            const result = await service.checkCoherence(coherenceNodes);
+            // Generate recommendations based on results
+            const recommendations = [
+                ...result.recommendations,
+                ...this.generateAdditionalRecommendations(result, energyThreshold),
+            ];
+            // Format contradictions for output (convert Severity enum to string)
+            const contradictions = result.contradictions.map((c) => ({
+                nodeIds: c.nodeIds,
+                severity: String(c.severity),
+                description: c.description ||
+                    `Contradiction between nodes ${c.nodeIds[0]} and ${c.nodeIds[1]}`,
+            }));
+            const executionTimeMs = Date.now() - startTime;
+            this.markAsRealData();
+            return {
+                success: true,
+                data: {
+                    isCoherent: result.isCoherent,
+                    energy: result.energy,
+                    lane: result.lane,
+                    contradictions,
+                    recommendations,
+                    nodeCount: nodes.length,
+                    executionTimeMs,
+                    usedFallback: result.usedFallback,
+                },
+            };
+        }
+        catch (error) {
+            // Check if WASM is unavailable - provide graceful fallback
+            if (error instanceof Error &&
+                error.message.includes('WASM')) {
+                this.markAsDemoData(context, 'WASM module unavailable');
+                return {
+                    success: true,
+                    data: {
+                        isCoherent: true,
+                        energy: 0.1,
+                        lane: 'reflex',
+                        contradictions: [],
+                        recommendations: [
+                            'WASM module unavailable - coherence check running in fallback mode',
+                            'Install prime-radiant-advanced-wasm for full coherence verification',
+                        ],
+                        nodeCount: nodes.length,
+                        executionTimeMs: Date.now() - startTime,
+                        usedFallback: true,
+                    },
+                };
+            }
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Generate additional recommendations based on coherence results
+     */
+    generateAdditionalRecommendations(result, threshold) {
+        const recommendations = [];
+        if (result.energy > threshold) {
+            recommendations.push(`High coherence energy (${result.energy.toFixed(3)}) detected - review contradicting beliefs`);
+        }
+        switch (result.lane) {
+            case 'reflex':
+                recommendations.push('Low energy - safe for immediate execution');
+                break;
+            case 'retrieval':
+                recommendations.push('Moderate energy - consider fetching additional context');
+                break;
+            case 'heavy':
+                recommendations.push('High energy - deep analysis recommended');
+                break;
+            case 'human':
+                recommendations.push('Critical energy - escalate to Queen coordinator');
+                break;
+        }
+        return recommendations;
+    }
+}
+/**
+ * Create a CoherenceCheckTool instance
+ */
+export function createCoherenceCheckTool() {
+    return new CoherenceCheckTool();
+}
+//# sourceMappingURL=check.js.map

package/v3/dist/mcp/tools/coherence/check.js.map

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

package/v3/dist/mcp/tools/coherence/collapse.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Agentic QE v3 - Coherence Predict Collapse MCP Tool
+ * ADR-052: Phase 4 Action A4.1
+ *
+ * qe/coherence/collapse - Predict swarm collapse risk
+ *
+ * Uses the CoherenceService's spectral analysis to predict potential
+ * swarm collapse before it happens, enabling proactive mitigation.
+ */
+import { MCPToolBase, MCPToolConfig, MCPToolContext } from '../base.js';
+import { ToolResult } from '../../types.js';
+/**
+ * Parameters for collapse prediction
+ */
+export interface CoherenceCollapseParams {
+    /** Current swarm state - simplified input format */
+    swarmState: {
+        /** Agent health information */
+        agents: Array<{
+            agentId: string;
+            agentType?: string;
+            health: number;
+            errorCount?: number;
+            successRate?: number;
+        }>;
+        /** Total active tasks */
+        activeTasks: number;
+        /** Pending tasks */
+        pendingTasks: number;
+        /** System-wide error rate (0-1) */
+        errorRate: number;
+        /** Resource utilization (0-1) */
+        utilization: number;
+    };
+    /** Risk threshold for warning (0-1, default: 0.5) */
+    riskThreshold?: number;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Result of collapse prediction
+ */
+export interface CoherenceCollapseResult {
+    /** Overall collapse risk (0-1, higher = more risk) */
+    risk: number;
+    /** Whether the swarm is at significant risk */
+    isAtRisk: boolean;
+    /** Risk level category */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Fiedler value (spectral gap - lower = more vulnerable) */
+    fiedlerValue: number;
+    /** Whether collapse is imminent */
+    collapseImminent: boolean;
+    /** Agents most vulnerable to failure */
+    weakVertices: string[];
+    /** Recommendations for mitigation */
+    recommendations: string[];
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+    /** Whether fallback logic was used */
+    usedFallback: boolean;
+}
+/**
+ * Coherence Predict Collapse Tool
+ *
+ * Uses Prime Radiant's spectral analysis to predict swarm collapse risk
+ * before it happens, enabling proactive mitigation.
+ *
+ * @example
+ * ```typescript
+ * const result = await tool.invoke({
+ *   swarmState: {
+ *     agents: [
+ *       { agentId: 'agent-1', health: 0.9, errorCount: 2 },
+ *       { agentId: 'agent-2', health: 0.7, errorCount: 5 },
+ *     ],
+ *     activeTasks: 10,
+ *     pendingTasks: 3,
+ *     errorRate: 0.05,
+ *     utilization: 0.6,
+ *   },
+ *   riskThreshold: 0.6,
+ * });
+ *
+ * if (result.data.isAtRisk) {
+ *   console.log('Collapse risk detected:', result.data.riskLevel);
+ *   console.log('Recommendations:', result.data.recommendations);
+ * }
+ * ```
+ */
+export declare class CoherenceCollapseTool extends MCPToolBase<CoherenceCollapseParams, CoherenceCollapseResult> {
+    readonly config: MCPToolConfig;
+    private coherenceService;
+    /**
+     * Get or create the CoherenceService instance
+     */
+    private getService;
+    /**
+     * Reset instance cache (called when fleet is disposed)
+     */
+    resetInstanceCache(): void;
+    /**
+     * Execute collapse prediction
+     */
+    execute(params: CoherenceCollapseParams, context: MCPToolContext): Promise<ToolResult<CoherenceCollapseResult>>;
+    /**
+     * Categorize risk level
+     */
+    private categorizeRisk;
+    /**
+     * Generate additional recommendations based on context
+     */
+    private generateAdditionalRecommendations;
+    /**
+     * Heuristic analysis fallback when WASM is unavailable
+     */
+    private heuristicAnalysis;
+}
+/**
+ * Create a CoherenceCollapseTool instance
+ */
+export declare function createCoherenceCollapseTool(): CoherenceCollapseTool;
+//# sourceMappingURL=collapse.d.ts.map

package/v3/dist/mcp/tools/coherence/collapse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapse.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/coherence/collapse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgB5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,UAAU,EAAE;QACV,+BAA+B;QAC/B,MAAM,EAAE,KAAK,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;QACH,yBAAyB;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,mCAAmC;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;CACvB;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,qBAAsB,SAAQ,WAAW,CACpD,uBAAuB,EACvB,uBAAuB,CACxB;IACC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAS5B;IAEF,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;OAEG;YACW,UAAU;IAOxB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IA0G/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,iCAAiC;IA6CzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA4D1B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}