couchloop-eq-mcp 1.0.2 → 1.0.4

package/dist/governance/evaluationEngine.js

@@ -0,0 +1,265 @@
+/**
+ * CouchLoop Behavioral Governance Layer - Evaluation Engine
+ *
+ * Main evaluation pipeline that orchestrates all governance checks
+ * for draft LLM responses before delivery to users
+ */
+import { HallucinationDetector } from './detectors/hallucination.js';
+import { InconsistencyChecker } from './detectors/inconsistency.js';
+import { ToneDriftMonitor } from './detectors/toneDrift.js';
+import { UnsafeReasoningDetector } from './detectors/unsafeReasoning.js';
+import { loadConfig } from './config.js';
+// Core types for governance evaluations
+export var InterventionAction;
+(function (InterventionAction) {
+    InterventionAction["APPROVE"] = "approve";
+    InterventionAction["BLOCK"] = "block";
+    InterventionAction["MODIFY"] = "modify";
+    InterventionAction["FALLBACK"] = "fallback";
+})(InterventionAction || (InterventionAction = {}));
+export var RiskLevel;
+(function (RiskLevel) {
+    RiskLevel["NONE"] = "none";
+    RiskLevel["LOW"] = "low";
+    RiskLevel["MEDIUM"] = "medium";
+    RiskLevel["HIGH"] = "high";
+    RiskLevel["CRITICAL"] = "critical";
+})(RiskLevel || (RiskLevel = {}));
+/**
+ * Main evaluation engine that coordinates all governance checks
+ */
+export class EvaluationEngine {
+    hallucinationDetector;
+    inconsistencyChecker;
+    toneDriftMonitor;
+    unsafeReasoningDetector;
+    config;
+    constructor(config) {
+        this.config = config || loadConfig();
+        // Initialize all detectors
+        this.hallucinationDetector = new HallucinationDetector(this.config.criteria.hallucination);
+        this.inconsistencyChecker = new InconsistencyChecker(this.config.criteria.inconsistency);
+        this.toneDriftMonitor = new ToneDriftMonitor(this.config.criteria.toneDrift);
+        this.unsafeReasoningDetector = new UnsafeReasoningDetector(this.config.criteria.unsafeReasoning);
+    }
+    /**
+     * Main evaluation method - runs all enabled governance checks
+     */
+    async evaluate(draft, context) {
+        const evaluationId = this.generateEvaluationId();
+        const startTime = Date.now();
+        // Run all detectors in parallel for performance
+        const [hallucination, inconsistency, toneDrift, unsafeReasoning] = await Promise.all([
+            this.config.criteria.hallucination.enabled
+                ? this.hallucinationDetector.detect(draft, context)
+                : { detected: false, confidence: 0 },
+            this.config.criteria.inconsistency.enabled
+                ? this.inconsistencyChecker.check(draft, context)
+                : { detected: false, confidence: 0 },
+            this.config.criteria.toneDrift.enabled
+                ? this.toneDriftMonitor.monitor(draft, context)
+                : { detected: false, confidence: 0 },
+            this.config.criteria.unsafeReasoning.enabled
+                ? this.unsafeReasoningDetector.detect(draft, context)
+                : { detected: false, confidence: 0 }
+        ]);
+        // Calculate overall risk level and recommended action
+        const { overallRisk, recommendedAction, confidence } = this.aggregateResults(hallucination, inconsistency, toneDrift, unsafeReasoning);
+        const result = {
+            hallucination,
+            inconsistency,
+            toneDrift,
+            unsafeReasoning,
+            overallRisk,
+            recommendedAction,
+            confidence,
+            timestamp: new Date(),
+            evaluationId
+        };
+        // Log evaluation time for performance monitoring
+        const evaluationTime = Date.now() - startTime;
+        if (evaluationTime > 1000) {
+            console.warn(`[Governance] Evaluation took ${evaluationTime}ms (target: <1000ms)`);
+        }
+        return result;
+    }
+    /**
+     * Determine if evaluation is required based on context
+     */
+    shouldEvaluate(response, context) {
+        // Always evaluate if governance is enabled
+        if (!this.config.enabled) {
+            return false;
+        }
+        // Skip evaluation for certain response types
+        if (this.isSystemResponse(response)) {
+            return false;
+        }
+        // Always evaluate for crisis-prone sessions
+        if (context.metadata?.crisisHistory) {
+            return true;
+        }
+        return true;
+    }
+    /**
+     * Aggregate individual detection results into overall risk assessment
+     */
+    aggregateResults(hallucination, inconsistency, toneDrift, unsafeReasoning) {
+        // Weight different criteria based on severity
+        const weights = {
+            unsafeReasoning: 3.0,
+            hallucination: 2.0,
+            inconsistency: 1.5,
+            toneDrift: 1.0
+        };
+        // Calculate weighted risk score
+        let riskScore = 0;
+        let totalWeight = 0;
+        let maxConfidence = 0;
+        if (unsafeReasoning.detected) {
+            riskScore += unsafeReasoning.confidence * weights.unsafeReasoning;
+            totalWeight += weights.unsafeReasoning;
+            maxConfidence = Math.max(maxConfidence, unsafeReasoning.confidence);
+        }
+        if (hallucination.detected) {
+            riskScore += hallucination.confidence * weights.hallucination;
+            totalWeight += weights.hallucination;
+            maxConfidence = Math.max(maxConfidence, hallucination.confidence);
+        }
+        if (inconsistency.detected) {
+            riskScore += inconsistency.confidence * weights.inconsistency;
+            totalWeight += weights.inconsistency;
+            maxConfidence = Math.max(maxConfidence, inconsistency.confidence);
+        }
+        if (toneDrift.detected) {
+            riskScore += toneDrift.confidence * weights.toneDrift;
+            totalWeight += weights.toneDrift;
+            maxConfidence = Math.max(maxConfidence, toneDrift.confidence);
+        }
+        // Normalize risk score
+        const normalizedRisk = totalWeight > 0 ? riskScore / totalWeight : 0;
+        // Determine risk level
+        let overallRisk;
+        if (normalizedRisk === 0) {
+            overallRisk = RiskLevel.NONE;
+        }
+        else if (normalizedRisk < 0.25) {
+            overallRisk = RiskLevel.LOW;
+        }
+        else if (normalizedRisk < 0.5) {
+            overallRisk = RiskLevel.MEDIUM;
+        }
+        else if (normalizedRisk < 0.75) {
+            overallRisk = RiskLevel.HIGH;
+        }
+        else {
+            overallRisk = RiskLevel.CRITICAL;
+        }
+        // Determine recommended action based on thresholds
+        let recommendedAction;
+        if (unsafeReasoning.detected && unsafeReasoning.confidence > 0.8) {
+            // Always block high-confidence unsafe reasoning
+            recommendedAction = InterventionAction.BLOCK;
+        }
+        else if (maxConfidence > this.config.interventionThresholds.block) {
+            recommendedAction = InterventionAction.BLOCK;
+        }
+        else if (maxConfidence > this.config.interventionThresholds.modify) {
+            recommendedAction = InterventionAction.MODIFY;
+        }
+        else if (maxConfidence > this.config.interventionThresholds.warn) {
+            recommendedAction = InterventionAction.MODIFY;
+        }
+        else {
+            recommendedAction = InterventionAction.APPROVE;
+        }
+        return {
+            overallRisk,
+            recommendedAction,
+            confidence: maxConfidence
+        };
+    }
+    /**
+     * Check if response is a system message that shouldn't be evaluated
+     */
+    isSystemResponse(response) {
+        const systemPatterns = [
+            /^Error:/,
+            /^System:/,
+            /^Loading/,
+            /^Please wait/
+        ];
+        return systemPatterns.some(pattern => pattern.test(response));
+    }
+    /**
+     * Generate unique evaluation ID for audit trail
+     */
+    generateEvaluationId() {
+        return `eval_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Update configuration dynamically
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        // Update detector configurations
+        if (config.criteria?.hallucination) {
+            this.hallucinationDetector.updateConfig(config.criteria.hallucination);
+        }
+        if (config.criteria?.inconsistency) {
+            this.inconsistencyChecker.updateConfig(config.criteria.inconsistency);
+        }
+        if (config.criteria?.toneDrift) {
+            this.toneDriftMonitor.updateConfig(config.criteria.toneDrift);
+        }
+        if (config.criteria?.unsafeReasoning) {
+            this.unsafeReasoningDetector.updateConfig(config.criteria.unsafeReasoning);
+        }
+    }
+}
+/**
+ * Main governance pipeline that orchestrates evaluation and intervention
+ */
+export class GovernancePipeline {
+    evaluationEngine;
+    config;
+    constructor(config) {
+        this.config = config || loadConfig();
+        this.evaluationEngine = new EvaluationEngine(this.config);
+    }
+    /**
+     * Main entry point for governance evaluation
+     */
+    async evaluate(draftResponse, context) {
+        // Check if evaluation is required
+        if (!this.evaluationEngine.shouldEvaluate(draftResponse, context)) {
+            return this.createPassthroughResult();
+        }
+        // Run evaluation
+        return await this.evaluationEngine.evaluate(draftResponse, context);
+    }
+    /**
+     * Determine action based on evaluation results
+     */
+    determineAction(evaluation) {
+        return evaluation.recommendedAction;
+    }
+    /**
+     * Create a passthrough result for cases where evaluation is skipped
+     */
+    createPassthroughResult() {
+        return {
+            hallucination: { detected: false, confidence: 0 },
+            inconsistency: { detected: false, confidence: 0 },
+            toneDrift: { detected: false, confidence: 0 },
+            unsafeReasoning: { detected: false, confidence: 0 },
+            overallRisk: RiskLevel.NONE,
+            recommendedAction: InterventionAction.APPROVE,
+            confidence: 0,
+            timestamp: new Date(),
+            evaluationId: `passthrough_${Date.now()}`
+        };
+    }
+}
+export default GovernancePipeline;
+//# sourceMappingURL=evaluationEngine.js.map

package/dist/governance/evaluationEngine.js.map

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

package/dist/governance/intervention.d.ts

@@ -0,0 +1,81 @@
+/**
+ * CouchLoop Behavioral Governance Layer - Intervention Engine
+ *
+ * Handles response blocking, modification, rewriting, and fallback responses
+ * based on governance evaluation results
+ */
+import { type EvaluationResult, InterventionAction } from './evaluationEngine.js';
+import { type GovernanceConfig } from './config.js';
+export interface InterventionResult {
+    action: InterventionAction;
+    originalResponse: string;
+    finalResponse: string;
+    modified: boolean;
+    reason: string;
+    modifications?: ModificationDetail[];
+    confidence: number;
+}
+interface ModificationDetail {
+    type: 'removed' | 'replaced' | 'softened' | 'neutralized';
+    original: string;
+    modified: string;
+    reason: string;
+}
+export declare class InterventionEngine {
+    private config;
+    constructor(config?: GovernanceConfig);
+    /**
+     * Main intervention method - applies appropriate action based on evaluation
+     */
+    intervene(action: InterventionAction, originalResponse: string, evaluationResult: EvaluationResult): Promise<InterventionResult>;
+    /**
+     * Approve response without modification
+     */
+    private approve;
+    /**
+     * Block response and provide safe alternative
+     */
+    private block;
+    /**
+     * Modify response to remove or soften problematic content
+     */
+    private modify;
+    /**
+     * Replace with safe fallback response
+     */
+    private fallback;
+    /**
+     * Remove hallucinated content from response
+     */
+    private removeHallucinatedContent;
+    /**
+     * Remove unsafe content from response
+     */
+    private removeUnsafeContent;
+    /**
+     * Neutralize problematic tone in response
+     */
+    private neutralizeTone;
+    /**
+     * Soften claims to address inconsistencies
+     */
+    private softenClaims;
+    /**
+     * Check if too much content was removed
+     */
+    private tooMuchRemoved;
+    /**
+     * Apply intervention based on evaluation without explicit action
+     */
+    autoIntervene(originalResponse: string, evaluationResult: EvaluationResult): Promise<InterventionResult>;
+    /**
+     * Generate explanation for intervention
+     */
+    generateExplanation(result: InterventionResult): string;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: GovernanceConfig): void;
+}
+export default InterventionEngine;
+//# sourceMappingURL=intervention.d.ts.map

package/dist/governance/intervention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intervention.d.ts","sourceRoot":"","sources":["../../src/governance/intervention.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAoB9B;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,KAAK;IA0Cb;;OAEG;IACH,OAAO,CAAC,MAAM;IAyDd;;OAEG;IACH,OAAO,CAAC,QAAQ;IA6BhB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0DjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqEtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkDpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACG,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAM9B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAuBvD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;CAG7C;AAED,eAAe,kBAAkB,CAAC"}