codehere 0.1.0 → 0.3.0

package/dist/infrastructure/xai/interactive-xai.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Infrastructure: Interactive XAI System
+ *
+ * Allows users to click on code for explanations (interactive exploration)
+ * Research: Interactive XAI differentiates from competitors
+ *
+ * Features:
+ * - Code span explanations (why this code was generated/modified)
+ * - CoT step linking (which reasoning step led to this code)
+ * - Attention visualization (which context influenced this code)
+ * - Uncertainty indicators (confidence levels per code region)
+ */
+export interface CodeExplanation {
+    codeSpan: {
+        filepath: string;
+        startLine: number;
+        endLine: number;
+        content: string;
+    };
+    explanation: {
+        why: string;
+        how: string;
+        confidence: number;
+        uncertainty?: {
+            epistemic: number;
+            aleatoric?: number;
+            isHallucinationRisk: boolean;
+        };
+    };
+    reasoning: {
+        cotStepId?: string;
+        cotStepNumber?: number;
+        attentionSpans?: Array<{
+            filepath: string;
+            lines: number[];
+            relevanceScore: number;
+        }>;
+        decisionPoint?: string;
+    };
+    metadata: {
+        toolUsed?: string;
+        timestamp: number;
+        model?: string;
+    };
+}
+export interface InteractiveXAIState {
+    sessionId: string;
+    query: string;
+    explanations: Map<string, CodeExplanation>;
+    cotTrajectoryId?: string;
+    attentionMapId?: string;
+    createdAt: number;
+}
+/**
+ * Interactive XAI System
+ * Enables users to explore AI reasoning interactively
+ */
+export declare class InteractiveXAI {
+    private sessions;
+    /**
+     * Create new interactive XAI session
+     */
+    createSession(sessionId: string, query: string, options?: {
+        cotTrajectoryId?: string;
+        attentionMapId?: string;
+    }): InteractiveXAIState;
+    /**
+     * Get explanation for code span
+     */
+    getExplanation(sessionId: string, filepath: string, startLine: number, endLine: number): CodeExplanation | null;
+    /**
+     * Register code explanation
+     */
+    registerExplanation(sessionId: string, explanation: CodeExplanation): void;
+    /**
+     * Generate explanation for code span (on-demand)
+     */
+    generateExplanation(sessionId: string, filepath: string, startLine: number, endLine: number, code: string, context: {
+        query: string;
+        cotTrajectory?: any;
+        attentionMap?: any;
+        uncertainty?: any;
+    }): Promise<CodeExplanation>;
+    /**
+     * Get all explanations for a file
+     */
+    getFileExplanations(sessionId: string, filepath: string): CodeExplanation[];
+    /**
+     * Format explanation for display
+     */
+    formatExplanation(explanation: CodeExplanation, format: 'console' | 'json' | 'markdown'): string;
+    /**
+     * Get session state
+     */
+    getSession(sessionId: string): InteractiveXAIState | null;
+    private getExplanationKey;
+    private generateWhyExplanation;
+    private generateHowExplanation;
+    private calculateConfidence;
+    private findRelatedCoTStep;
+    private findRelatedAttentionSpans;
+    private findDecisionPoint;
+    private formatForConsole;
+    private formatForMarkdown;
+}
+//# sourceMappingURL=interactive-xai.d.ts.map

package/dist/infrastructure/xai/interactive-xai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-xai.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xai/interactive-xai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE;YACZ,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,mBAAmB,EAAE,OAAO,CAAC;SAC9B,CAAC;KACH,CAAC;IACF,SAAS,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,KAAK,CAAC;YACrB,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC,CAAC;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA+C;IAE/D;;OAEG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,mBAAmB;IActB;;OAEG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,GAAG,IAAI;IAUzB;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,eAAe,GAC3B,IAAI;IAeP;;OAEG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,GAAG,CAAC;QACpB,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,WAAW,CAAC,EAAE,GAAG,CAAC;KACnB,GACA,OAAO,CAAC,eAAe,CAAC;IAyC3B;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAgB3E;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM;IAWhG;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAMzD,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,yBAAyB;IA6BjC,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,iBAAiB;CAoC1B"}

package/dist/infrastructure/xai/interactive-xai.js

@@ -0,0 +1,262 @@
+/**
+ * Infrastructure: Interactive XAI System
+ *
+ * Allows users to click on code for explanations (interactive exploration)
+ * Research: Interactive XAI differentiates from competitors
+ *
+ * Features:
+ * - Code span explanations (why this code was generated/modified)
+ * - CoT step linking (which reasoning step led to this code)
+ * - Attention visualization (which context influenced this code)
+ * - Uncertainty indicators (confidence levels per code region)
+ */
+/**
+ * Interactive XAI System
+ * Enables users to explore AI reasoning interactively
+ */
+export class InteractiveXAI {
+    sessions = new Map();
+    /**
+     * Create new interactive XAI session
+     */
+    createSession(sessionId, query, options) {
+        const state = {
+            sessionId,
+            query,
+            explanations: new Map(),
+            cotTrajectoryId: options?.cotTrajectoryId,
+            attentionMapId: options?.attentionMapId,
+            createdAt: Date.now(),
+        };
+        this.sessions.set(sessionId, state);
+        return state;
+    }
+    /**
+     * Get explanation for code span
+     */
+    getExplanation(sessionId, filepath, startLine, endLine) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return null;
+        }
+        const key = this.getExplanationKey(filepath, startLine, endLine);
+        return session.explanations.get(key) || null;
+    }
+    /**
+     * Register code explanation
+     */
+    registerExplanation(sessionId, explanation) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const key = this.getExplanationKey(explanation.codeSpan.filepath, explanation.codeSpan.startLine, explanation.codeSpan.endLine);
+        session.explanations.set(key, explanation);
+    }
+    /**
+     * Generate explanation for code span (on-demand)
+     */
+    async generateExplanation(sessionId, filepath, startLine, endLine, code, context) {
+        // Check if explanation already exists
+        const existing = this.getExplanation(sessionId, filepath, startLine, endLine);
+        if (existing) {
+            return existing;
+        }
+        // Generate explanation
+        const explanation = {
+            codeSpan: {
+                filepath,
+                startLine,
+                endLine,
+                content: code,
+            },
+            explanation: {
+                why: this.generateWhyExplanation(code, context.query),
+                how: this.generateHowExplanation(code, context.query),
+                confidence: this.calculateConfidence(context),
+                uncertainty: context.uncertainty ? {
+                    epistemic: context.uncertainty.epistemic?.value || 0,
+                    aleatoric: context.uncertainty.aleatoric?.value,
+                    isHallucinationRisk: context.uncertainty.isHallucinationRisk || false,
+                } : undefined,
+            },
+            reasoning: {
+                cotStepId: this.findRelatedCoTStep(context.cotTrajectory, code),
+                attentionSpans: this.findRelatedAttentionSpans(context.attentionMap, filepath, startLine, endLine),
+                decisionPoint: this.findDecisionPoint(context.cotTrajectory, code),
+            },
+            metadata: {
+                timestamp: Date.now(),
+            },
+        };
+        // Register explanation
+        this.registerExplanation(sessionId, explanation);
+        return explanation;
+    }
+    /**
+     * Get all explanations for a file
+     */
+    getFileExplanations(sessionId, filepath) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return [];
+        }
+        const explanations = [];
+        for (const explanation of session.explanations.values()) {
+            if (explanation.codeSpan.filepath === filepath) {
+                explanations.push(explanation);
+            }
+        }
+        return explanations.sort((a, b) => a.codeSpan.startLine - b.codeSpan.startLine);
+    }
+    /**
+     * Format explanation for display
+     */
+    formatExplanation(explanation, format) {
+        switch (format) {
+            case 'console':
+                return this.formatForConsole(explanation);
+            case 'json':
+                return JSON.stringify(explanation, null, 2);
+            case 'markdown':
+                return this.formatForMarkdown(explanation);
+        }
+    }
+    /**
+     * Get session state
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId) || null;
+    }
+    // Private helpers
+    getExplanationKey(filepath, startLine, endLine) {
+        return `${filepath}:${startLine}:${endLine}`;
+    }
+    generateWhyExplanation(code, query) {
+        // Simple heuristic-based explanation
+        // In production, this would use LLM to generate explanation
+        return `This code was generated to address: "${query.substring(0, 100)}". The implementation follows the requested functionality.`;
+    }
+    generateHowExplanation(code, query) {
+        // Simple heuristic-based explanation
+        // In production, this would use LLM to generate explanation
+        return `This code relates to the query by implementing the core logic requested.`;
+    }
+    calculateConfidence(context) {
+        // Calculate confidence based on uncertainty and context quality
+        let confidence = 0.8; // Default
+        if (context.uncertainty) {
+            const epistemic = context.uncertainty.epistemic?.value || 0;
+            confidence = 1 - epistemic; // Lower epistemic uncertainty = higher confidence
+        }
+        // Adjust based on attention map quality
+        if (context.attentionMap) {
+            const avgAttention = context.attentionMap.averageAttentionScore || 0;
+            confidence = (confidence + avgAttention) / 2;
+        }
+        return Math.max(0, Math.min(1, confidence));
+    }
+    findRelatedCoTStep(cotTrajectory, code) {
+        // Find CoT step that likely generated this code
+        // In production, this would analyze trajectory and code content
+        if (!cotTrajectory || !cotTrajectory.steps) {
+            return undefined;
+        }
+        // Find action steps that match code generation
+        for (const step of cotTrajectory.steps) {
+            if (step.type === 'action' && step.metadata?.tool === 'edit' || step.metadata?.tool === 'create') {
+                return step.stepId;
+            }
+        }
+        return undefined;
+    }
+    findRelatedAttentionSpans(attentionMap, filepath, startLine, endLine) {
+        if (!attentionMap || !attentionMap.spans) {
+            return undefined;
+        }
+        // Find attention spans related to this file/region
+        const related = [];
+        for (const span of attentionMap.spans) {
+            if (span.filepath === filepath) {
+                // Check if spans overlap
+                if (span.startLine <= endLine && span.endLine >= startLine) {
+                    related.push({
+                        filepath: span.filepath,
+                        lines: Array.from({ length: span.endLine - span.startLine + 1 }, (_, i) => span.startLine + i),
+                        relevanceScore: span.attentionScore,
+                    });
+                }
+            }
+        }
+        return related.length > 0 ? related : undefined;
+    }
+    findDecisionPoint(cotTrajectory, code) {
+        // Find decision point that led to this code
+        if (!cotTrajectory || !cotTrajectory.steps) {
+            return undefined;
+        }
+        for (const step of cotTrajectory.steps) {
+            if (step.type === 'decision') {
+                return step.metadata?.decision || step.content;
+            }
+        }
+        return undefined;
+    }
+    formatForConsole(explanation) {
+        let output = '';
+        output += `\n${'═'.repeat(80)}\n`;
+        output += `Code Explanation: ${explanation.codeSpan.filepath} (lines ${explanation.codeSpan.startLine}-${explanation.codeSpan.endLine})\n`;
+        output += `${'═'.repeat(80)}\n\n`;
+        output += `Why:\n  ${explanation.explanation.why}\n\n`;
+        output += `How:\n  ${explanation.explanation.how}\n\n`;
+        output += `Confidence: ${(explanation.explanation.confidence * 100).toFixed(1)}%\n`;
+        if (explanation.explanation.uncertainty) {
+            output += `\nUncertainty:\n`;
+            output += `  Epistemic: ${(explanation.explanation.uncertainty.epistemic * 100).toFixed(1)}%\n`;
+            if (explanation.explanation.uncertainty.isHallucinationRisk) {
+                output += `  ⚠️  Hallucination Risk Detected\n`;
+            }
+        }
+        if (explanation.reasoning.cotStepNumber) {
+            output += `\nRelated Reasoning Step: #${explanation.reasoning.cotStepNumber}\n`;
+        }
+        if (explanation.reasoning.attentionSpans && explanation.reasoning.attentionSpans.length > 0) {
+            output += `\nContext Influences:\n`;
+            for (const span of explanation.reasoning.attentionSpans.slice(0, 3)) {
+                output += `  - ${span.filepath} (lines ${span.lines[0]}-${span.lines[span.lines.length - 1]}) - Relevance: ${(span.relevanceScore * 100).toFixed(1)}%\n`;
+            }
+        }
+        output += `\n${'═'.repeat(80)}\n`;
+        return output;
+    }
+    formatForMarkdown(explanation) {
+        let output = '';
+        output += `## Code Explanation\n\n`;
+        output += `**File:** \`${explanation.codeSpan.filepath}\` (lines ${explanation.codeSpan.startLine}-${explanation.codeSpan.endLine})\n\n`;
+        output += `### Why\n\n${explanation.explanation.why}\n\n`;
+        output += `### How\n\n${explanation.explanation.how}\n\n`;
+        output += `**Confidence:** ${(explanation.explanation.confidence * 100).toFixed(1)}%\n\n`;
+        if (explanation.explanation.uncertainty) {
+            output += `### Uncertainty\n\n`;
+            output += `- Epistemic: ${(explanation.explanation.uncertainty.epistemic * 100).toFixed(1)}%\n`;
+            if (explanation.explanation.uncertainty.isHallucinationRisk) {
+                output += `- ⚠️  **Hallucination Risk Detected**\n`;
+            }
+            output += `\n`;
+        }
+        if (explanation.reasoning.cotStepNumber) {
+            output += `### Related Reasoning\n\n`;
+            output += `Part of reasoning step #${explanation.reasoning.cotStepNumber}\n\n`;
+        }
+        if (explanation.reasoning.attentionSpans && explanation.reasoning.attentionSpans.length > 0) {
+            output += `### Context Influences\n\n`;
+            for (const span of explanation.reasoning.attentionSpans.slice(0, 3)) {
+                output += `- \`${span.filepath}\` (lines ${span.lines[0]}-${span.lines[span.lines.length - 1]}) - Relevance: ${(span.relevanceScore * 100).toFixed(1)}%\n`;
+            }
+            output += `\n`;
+        }
+        output += `\`\`\`\n${explanation.codeSpan.content}\n\`\`\`\n`;
+        return output;
+    }
+}
+//# sourceMappingURL=interactive-xai.js.map

package/dist/infrastructure/xai/interactive-xai.js.map

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

package/dist/infrastructure/xai/uncertainty-quantifier.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Infrastructure: Uncertainty Quantifier
+ * Distinguishes Epistemic (reducible) vs Aleatoric (irreducible) uncertainty
+ *
+ * Research Finding: Epistemic uncertainty = hallucination risk
+ * Critical for preventing deployment of plausible but wrong code
+ *
+ * Based on research: Explainable AI (XAI) for Code Generation Agents
+ * - Epistemic uncertainty: Model lacks knowledge (can be reduced)
+ * - Aleatoric uncertainty: Inherent randomness (cannot be reduced)
+ * - High epistemic = high hallucination risk
+ * - Dropout method for estimation (Bayesian inference approximation)
+ */
+export type UncertaintyType = 'epistemic' | 'aleatoric' | 'combined';
+export interface UncertaintyScore {
+    type: UncertaintyType;
+    value: number;
+    explanation: string;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    recommendation?: string;
+}
+export interface UncertaintyResult {
+    epistemic: UncertaintyScore;
+    aleatoric?: UncertaintyScore;
+    combined: UncertaintyScore;
+    isHallucinationRisk: boolean;
+}
+/**
+ * Uncertainty Quantifier
+ * Quantifies and communicates model uncertainty
+ */
+export declare class UncertaintyQuantifier {
+    private epistemicThreshold;
+    /**
+     * Quantify uncertainty from LLM response
+     * Uses multiple sampling approach (dropout method)
+     */
+    quantifyUncertainty(query: string, response: string, context?: {
+        chunks?: any[];
+        memories?: any[];
+    }): Promise<UncertaintyResult>;
+    /**
+     * Estimate epistemic uncertainty (model knowledge gap)
+     * High epistemic = query outside training distribution
+     */
+    private estimateEpistemicUncertainty;
+    /**
+     * Estimate aleatoric uncertainty (inherent randomness)
+     */
+    private estimateAleatoricUncertainty;
+    /**
+     * Combine uncertainties
+     */
+    private combineUncertainties;
+    /**
+     * Check for unknown patterns (outside training distribution)
+     */
+    private hasUnknownPatterns;
+    /**
+     * Calculate context availability score
+     */
+    private calculateContextScore;
+    /**
+     * Check for hedging language (indicates uncertainty)
+     */
+    private hasHedgingLanguage;
+    /**
+     * Check for niche/proprietary APIs
+     */
+    private hasNicheAPIs;
+    /**
+     * Get risk level from uncertainty value
+     */
+    private getRiskLevel;
+    /**
+     * Set epistemic threshold
+     */
+    setEpistemicThreshold(threshold: number): void;
+}
+//# sourceMappingURL=uncertainty-quantifier.d.ts.map

package/dist/infrastructure/xai/uncertainty-quantifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncertainty-quantifier.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/xai/uncertainty-quantifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,kBAAkB,CAAe;IAEzC;;;OAGG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,GAC7C,OAAO,CAAC,iBAAiB,CAAC;IAqB7B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAmDpC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAG/C"}

package/dist/infrastructure/xai/uncertainty-quantifier.js

@@ -0,0 +1,201 @@
+/**
+ * Infrastructure: Uncertainty Quantifier
+ * Distinguishes Epistemic (reducible) vs Aleatoric (irreducible) uncertainty
+ *
+ * Research Finding: Epistemic uncertainty = hallucination risk
+ * Critical for preventing deployment of plausible but wrong code
+ *
+ * Based on research: Explainable AI (XAI) for Code Generation Agents
+ * - Epistemic uncertainty: Model lacks knowledge (can be reduced)
+ * - Aleatoric uncertainty: Inherent randomness (cannot be reduced)
+ * - High epistemic = high hallucination risk
+ * - Dropout method for estimation (Bayesian inference approximation)
+ */
+/**
+ * Uncertainty Quantifier
+ * Quantifies and communicates model uncertainty
+ */
+export class UncertaintyQuantifier {
+    epistemicThreshold = 0.7; // High epistemic = hallucination risk
+    /**
+     * Quantify uncertainty from LLM response
+     * Uses multiple sampling approach (dropout method)
+     */
+    async quantifyUncertainty(query, response, context) {
+        // For now, use heuristics based on response characteristics
+        // In production, would use multiple sampling (dropout method)
+        // 1. Epistemic Uncertainty (model knowledge gap)
+        const epistemic = this.estimateEpistemicUncertainty(query, response, context);
+        // 2. Aleatoric Uncertainty (inherent randomness)
+        const aleatoric = this.estimateAleatoricUncertainty(response);
+        // 3. Combined Uncertainty
+        const combined = this.combineUncertainties(epistemic, aleatoric);
+        return {
+            epistemic,
+            aleatoric,
+            combined,
+            isHallucinationRisk: epistemic.value > this.epistemicThreshold,
+        };
+    }
+    /**
+     * Estimate epistemic uncertainty (model knowledge gap)
+     * High epistemic = query outside training distribution
+     */
+    estimateEpistemicUncertainty(query, response, context) {
+        let epistemicValue = 0;
+        const factors = [];
+        // Factor 1: Query complexity (unknown patterns)
+        if (this.hasUnknownPatterns(query)) {
+            epistemicValue += 0.3;
+            factors.push('Query contains unknown patterns');
+        }
+        // Factor 2: Context availability (low context = high uncertainty)
+        const contextScore = this.calculateContextScore(context);
+        if (contextScore < 0.3) {
+            epistemicValue += 0.3;
+            factors.push('Low context availability');
+        }
+        // Factor 3: Response confidence markers (hedging language)
+        if (this.hasHedgingLanguage(response)) {
+            epistemicValue += 0.2;
+            factors.push('Response contains hedging language');
+        }
+        // Factor 4: Niche/proprietary API usage (outside training)
+        if (this.hasNicheAPIs(response)) {
+            epistemicValue += 0.4;
+            factors.push('Niche or proprietary API usage detected');
+        }
+        epistemicValue = Math.min(epistemicValue, 1.0);
+        const riskLevel = this.getRiskLevel(epistemicValue);
+        const recommendation = epistemicValue > this.epistemicThreshold
+            ? 'High epistemic uncertainty detected. This may indicate hallucination risk. Verify output carefully, especially for niche APIs or proprietary patterns.'
+            : undefined;
+        return {
+            type: 'epistemic',
+            value: epistemicValue,
+            explanation: factors.length > 0
+                ? `Epistemic uncertainty factors: ${factors.join('; ')}`
+                : 'Low epistemic uncertainty - query appears within model knowledge',
+            riskLevel,
+            recommendation,
+        };
+    }
+    /**
+     * Estimate aleatoric uncertainty (inherent randomness)
+     */
+    estimateAleatoricUncertainty(response) {
+        // Aleatoric uncertainty is harder to estimate from single response
+        // Would require multiple samples in production
+        // For now, estimate based on response variability markers
+        let aleatoricValue = 0;
+        // Multiple valid solutions increase aleatoric uncertainty
+        if (response.includes('alternative') || response.includes('could also')) {
+            aleatoricValue += 0.2;
+        }
+        // Default to low aleatoric (assuming deterministic generation)
+        aleatoricValue = Math.min(aleatoricValue, 0.3);
+        return {
+            type: 'aleatoric',
+            value: aleatoricValue,
+            explanation: 'Inherent randomness in generation process',
+            riskLevel: aleatoricValue < 0.2 ? 'low' : 'medium',
+        };
+    }
+    /**
+     * Combine uncertainties
+     */
+    combineUncertainties(epistemic, aleatoric) {
+        const aleatoricValue = aleatoric?.value || 0;
+        const combinedValue = Math.max(epistemic.value, aleatoricValue);
+        return {
+            type: 'combined',
+            value: combinedValue,
+            explanation: `Combined uncertainty: ${epistemic.value.toFixed(2)} epistemic, ${aleatoricValue.toFixed(2)} aleatoric`,
+            riskLevel: this.getRiskLevel(combinedValue),
+            recommendation: epistemic.recommendation,
+        };
+    }
+    /**
+     * Check for unknown patterns (outside training distribution)
+     */
+    hasUnknownPatterns(query) {
+        // Heuristic: Very specific, niche terminology
+        const nichePatterns = [
+            /internal.*?api/i,
+            /proprietary/i,
+            /custom.*?framework/i,
+            /company.*?specific/i,
+        ];
+        return nichePatterns.some(pattern => pattern.test(query));
+    }
+    /**
+     * Calculate context availability score
+     */
+    calculateContextScore(context) {
+        if (!context) {
+            return 0;
+        }
+        const chunkCount = context.chunks?.length || 0;
+        const memoryCount = context.memories?.length || 0;
+        // More context = lower epistemic uncertainty
+        if (chunkCount > 5 && memoryCount > 2) {
+            return 0.8;
+        }
+        if (chunkCount > 3 || memoryCount > 1) {
+            return 0.5;
+        }
+        if (chunkCount > 0 || memoryCount > 0) {
+            return 0.3;
+        }
+        return 0;
+    }
+    /**
+     * Check for hedging language (indicates uncertainty)
+     */
+    hasHedgingLanguage(response) {
+        const hedging = [
+            /might/i,
+            /could/i,
+            /possibly/i,
+            /may/i,
+            /perhaps/i,
+            /probably/i,
+            /likely/i,
+        ];
+        return hedging.some(pattern => pattern.test(response));
+    }
+    /**
+     * Check for niche/proprietary APIs
+     */
+    hasNicheAPIs(response) {
+        const nichePatterns = [
+            /internal.*?sdk/i,
+            /company.*?api/i,
+            /custom.*?service/i,
+            /proprietary.*?library/i,
+        ];
+        return nichePatterns.some(pattern => pattern.test(response));
+    }
+    /**
+     * Get risk level from uncertainty value
+     */
+    getRiskLevel(value) {
+        if (value >= 0.8) {
+            return 'critical';
+        }
+        if (value >= 0.6) {
+            return 'high';
+        }
+        if (value >= 0.4) {
+            return 'medium';
+        }
+        return 'low';
+    }
+    /**
+     * Set epistemic threshold
+     */
+    setEpistemicThreshold(threshold) {
+        this.epistemicThreshold = threshold;
+    }
+}
+//# sourceMappingURL=uncertainty-quantifier.js.map