@deepseekdev/coder 1.0.74

package/dist/core/hallucinationGuard.js

@@ -0,0 +1,237 @@
+/**
+ * Hallucination Guard - Advanced validation to minimize AI hallucinations
+ *
+ * Features:
+ * 1. Content validation before edits
+ * 2. Fact verification for web search results
+ * 3. Confidence scoring for AI outputs
+ * 4. Cross-referencing with existing knowledge
+ */
+import { existsSync } from 'node:fs';
+/**
+ * Validate AI content for hallucinations before execution
+ */
+export class HallucinationGuard {
+    workingDir;
+    knownFacts = new Map();
+    constructor(options = {}) {
+        this.workingDir = options.workingDir ?? process.cwd();
+    }
+    /**
+     * Validate file operations for hallucinations
+     */
+    validateFileOperation(toolName, args, existingContent) {
+        const checks = [];
+        const toolLower = toolName.toLowerCase();
+        // === Edit Tool Validation ===
+        if (toolLower === 'edit') {
+            const oldString = args['old_string'];
+            const filePath = args['file_path'];
+            // Check 1: Edit without existing content reference
+            if (oldString && existingContent) {
+                const similarity = this.calculateContentSimilarity(oldString, existingContent);
+                if (similarity < 0.5) {
+                    checks.push({
+                        type: 'content_guess',
+                        confidence: 'high',
+                        riskLevel: 'critical',
+                        message: `Low content similarity (${Math.round(similarity * 100)}%) - AI may be guessing file content`,
+                        suggestion: 'Verify exact file content matches old_string. Use Read tool to confirm.',
+                    });
+                }
+            }
+            // Check 2: File existence validation
+            if (filePath && !existsSync(filePath) && oldString) {
+                checks.push({
+                    type: 'file_existence',
+                    confidence: 'high',
+                    riskLevel: 'warning',
+                    message: `Editing non-existent file: ${filePath}`,
+                    suggestion: 'Check if file exists before editing. Use empty old_string for new file creation.',
+                });
+            }
+        }
+        // === Search Operations ===
+        if (toolLower.includes('search') || toolLower.includes('grep')) {
+            const pattern = args['pattern'];
+            if (pattern && this.isOverlyBroadPattern(pattern)) {
+                checks.push({
+                    type: 'code_pattern',
+                    confidence: 'medium',
+                    riskLevel: 'warning',
+                    message: `Search pattern '${pattern}' is very broad and may produce overwhelming results`,
+                    suggestion: 'Use more specific patterns or add file type filters.',
+                });
+            }
+        }
+        // === Web Operations ===
+        if (toolLower.includes('web') || toolLower.includes('search')) {
+            const query = args['query'];
+            if (query && this.containsFactClaim(query)) {
+                checks.push({
+                    type: 'fact_claim',
+                    confidence: 'low',
+                    riskLevel: 'info',
+                    message: 'Query contains factual claims that should be verified',
+                    suggestion: 'Cross-reference results with authoritative sources.',
+                });
+            }
+        }
+        return this.generateReport(checks);
+    }
+    /**
+     * Validate AI-generated code for common hallucination patterns
+     */
+    validateGeneratedCode(code, _context) {
+        const checks = [];
+        // Check for placeholder patterns
+        const placeholderPatterns = [
+            /\{\{.*?\}\}/g, // {{variable}}
+            /\[\[.*?\]\]/g, // [[placeholder]]
+            /<TODO>/gi, // <TODO>
+            /FIXME/gi, // FIXME (in generated code)
+        ];
+        for (const pattern of placeholderPatterns) {
+            const matches = code.match(pattern);
+            if (matches) {
+                checks.push({
+                    type: 'content_guess',
+                    confidence: 'high',
+                    riskLevel: 'critical',
+                    message: `Placeholder patterns found in generated code: ${matches.slice(0, 3).join(', ')}`,
+                    suggestion: 'Replace placeholders with actual implementation based on context.',
+                });
+            }
+        }
+        // Check for unrealistic imports
+        const importPatterns = [
+            /import\s+.*\s+from\s+['"][@\w\-/]+['"]/g,
+        ];
+        const imports = code.match(importPatterns[0]) || [];
+        for (const imp of imports) {
+            if (imp.includes('undefined-package') || imp.includes('example-library')) {
+                checks.push({
+                    type: 'code_pattern',
+                    confidence: 'medium',
+                    riskLevel: 'warning',
+                    message: `Suspicious import pattern: ${imp}`,
+                    suggestion: 'Verify package names and availability in the project.',
+                });
+            }
+        }
+        return this.generateReport(checks);
+    }
+    /**
+     * Register known facts from previous operations to cross-reference
+     */
+    registerFact(fact, source, confidence) {
+        const key = `${source}:${fact}`;
+        this.knownFacts.set(key, confidence);
+    }
+    /**
+     * Check if a claim contradicts known facts
+     */
+    checkFactContradiction(claim) {
+        const claimLower = claim.toLowerCase();
+        for (const [key, confidence] of this.knownFacts.entries()) {
+            const [, fact] = key.split(':');
+            const factLower = fact.toLowerCase();
+            // Simple contradiction detection
+            if (this.areContradictory(claimLower, factLower)) {
+                return {
+                    type: 'fact_claim',
+                    confidence: confidence > 0.7 ? 'high' : 'medium',
+                    riskLevel: 'warning',
+                    message: `Claim contradicts previously established fact: ${fact}`,
+                    suggestion: 'Verify information consistency across operations.',
+                };
+            }
+        }
+        return null;
+    }
+    calculateContentSimilarity(a, b) {
+        // Simple similarity calculation for validation
+        const wordsA = new Set(a.toLowerCase().split(/\s+/));
+        const wordsB = new Set(b.toLowerCase().split(/\s+/));
+        const intersection = new Set([...wordsA].filter(x => wordsB.has(x)));
+        const union = new Set([...wordsA, ...wordsB]);
+        return union.size > 0 ? intersection.size / union.size : 0;
+    }
+    isOverlyBroadPattern(pattern) {
+        // Patterns that match everything
+        const broadPatterns = [
+            /^.*$/,
+            /^\.*$/,
+            /^\w*$/,
+            /^[a-zA-Z]*$/,
+        ];
+        return broadPatterns.some(p => p.test(pattern));
+    }
+    containsFactClaim(text) {
+        const factIndicators = [
+            'is', 'are', 'was', 'were', 'will be',
+            'has', 'have', 'had',
+            'can', 'cannot', 'could', 'would',
+            'always', 'never', 'every', 'all',
+            'true', 'false', 'correct', 'incorrect',
+        ];
+        const words = text.toLowerCase().split(/\s+/);
+        return words.some(word => factIndicators.includes(word));
+    }
+    areContradictory(claim, fact) {
+        // Simple contradiction detection
+        const contradictions = [
+            ['is', 'is not'],
+            ['has', 'has no'],
+            ['can', 'cannot'],
+            ['true', 'false'],
+            ['always', 'never'],
+        ];
+        return contradictions.some(([a, b]) => (claim.includes(a) && fact.includes(b)) ||
+            (claim.includes(b) && fact.includes(a)));
+    }
+    generateReport(checks) {
+        if (checks.length === 0) {
+            return {
+                checks: [],
+                overallRisk: 'safe',
+                confidenceScore: 100,
+            };
+        }
+        const riskScores = {
+            'critical': 3,
+            'warning': 2,
+            'info': 1,
+        };
+        const confidenceScores = {
+            'high': 1.0,
+            'medium': 0.7,
+            'low': 0.3,
+        };
+        let totalRisk = 0;
+        let maxRisk = 0;
+        for (const check of checks) {
+            const riskScore = riskScores[check.riskLevel];
+            const confidence = confidenceScores[check.confidence];
+            totalRisk += riskScore * confidence;
+            maxRisk = Math.max(maxRisk, riskScore * confidence);
+        }
+        const averageRisk = totalRisk / checks.length;
+        const overallRisk = averageRisk >= 2.5 ? 'critical' : averageRisk >= 1.5 ? 'warning' : 'safe';
+        // Confidence score: 100 - (risk * 20)
+        const confidenceScore = Math.max(0, Math.min(100, 100 - (averageRisk * 20)));
+        return {
+            checks,
+            overallRisk,
+            confidenceScore,
+        };
+    }
+}
+/**
+ * Enhanced validation that integrates with existing tool runtime
+ */
+export function enhanceWithHallucinationGuard(toolName, args, existingContent) {
+    const guard = new HallucinationGuard();
+    return guard.validateFileOperation(toolName, args, existingContent);
+}
+//# sourceMappingURL=hallucinationGuard.js.map

package/dist/core/hallucinationGuard.js.map

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

package/dist/core/hitl.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Human-in-the-Loop (HITL) System
+ * Pauses AI execution and prompts users for important decision paths
+ * This is the ONLY HITL system in the repository
+ */
+export interface DecisionOption {
+    id: string;
+    label: string;
+    description: string;
+    shortcut?: string;
+}
+export interface DecisionRequest {
+    id: string;
+    title: string;
+    description: string;
+    context: string;
+    options: DecisionOption[];
+    defaultOptionId?: string;
+    requiresExplicitChoice: boolean;
+    metadata?: Record<string, any>;
+}
+export interface DecisionResponse {
+    requestId: string;
+    selectedOptionId: string;
+    userInput?: string;
+    timestamp: Date;
+}
+export interface HITLConfig {
+    /**
+     * Whether to automatically pause execution for decisions
+     * If false, decisions will be logged but execution continues
+     */
+    autoPause: boolean;
+    /**
+     * Timeout in milliseconds before auto-proceeding with default
+     * 0 means no timeout (wait indefinitely)
+     */
+    timeoutMs: number;
+    /**
+     * Default option to choose if timeout occurs
+     */
+    timeoutDefaultOptionId?: string;
+    /**
+     * Log level: 'none' | 'minimal' | 'detailed'
+     */
+    logLevel: 'none' | 'minimal' | 'detailed';
+}
+export declare class HITLSystem {
+    private config;
+    private pendingDecisions;
+    private decisionHistory;
+    private rl?;
+    constructor(config?: Partial<HITLConfig>);
+    /**
+     * Request a human decision
+     * @returns Promise that resolves with the selected option ID
+     */
+    requestDecision(request: DecisionRequest): Promise<string>;
+    /**
+     * Present decision to user and wait for input using interactive arrow-key selection
+     */
+    private promptUserForDecision;
+    /**
+     * Restore terminal to normal mode
+     */
+    private restoreTerminal;
+    private cleanupReadline;
+    private getOptionLabel;
+    private logDecisionRequest;
+    private recordDecision;
+    /**
+     * Get decision history
+     */
+    getHistory(): DecisionResponse[];
+    /**
+     * Clear decision history
+     */
+    clearHistory(): void;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<HITLConfig>): void;
+}
+/**
+ * Get the global HITL instance
+ */
+export declare function getHITL(config?: Partial<HITLConfig>): HITLSystem;
+/**
+ * Helper function for common decision patterns
+ */
+export declare const hitl: {
+    /**
+     * Request a yes/no decision
+     */
+    askYesNo(title: string, description: string, context?: string, defaultYes?: boolean): Promise<boolean>;
+    /**
+     * Request selection from multiple options
+     */
+    selectOption(title: string, description: string, options: Array<{
+        id: string;
+        label: string;
+        description: string;
+    }>, context?: string, defaultOptionId?: string): Promise<string>;
+    /**
+     * Request approval for a risky operation
+     */
+    requestApproval(title: string, riskDescription: string, operationDetails: string): Promise<boolean>;
+};
+//# sourceMappingURL=hitl.d.ts.map

package/dist/core/hitl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../src/core/hitl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CAC3C;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,EAAE,CAAC,CAAqB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IASxC;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAoChE;;OAEG;YACW,qBAAqB;IA2MnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,UAAU,IAAI,gBAAgB,EAAE;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;CAGhD;AAKD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAUhE;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;OAEG;oBACmB,MAAM,eAAe,MAAM,YAAW,MAAM,eAAmB,OAAO,GAAU,OAAO,CAAC,OAAO,CAAC;IA6BtH;;OAEG;wBACuB,MAAM,eAAe,MAAM,WAAW,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,YAAW,MAAM,oBAAyB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBzL;;OAEG;2BAC0B,MAAM,mBAAmB,MAAM,oBAAoB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ1G,CAAC"}