deepseek-coder-agent-cli 1.0.25

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,105 @@
+/**
+ * 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
+     */
+    private promptUserForDecision;
+    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;AAMH,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;IA8HnC,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"}

package/dist/core/hitl.js

@@ -0,0 +1,291 @@
+/**
+ * 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
+ */
+import { stdin, stdout } from 'node:process';
+import * as readline from 'node:readline';
+import chalk from 'chalk';
+export class HITLSystem {
+    config;
+    pendingDecisions = new Map();
+    decisionHistory = [];
+    rl;
+    constructor(config) {
+        this.config = {
+            autoPause: true,
+            timeoutMs: 0,
+            logLevel: 'detailed',
+            ...config
+        };
+    }
+    /**
+     * Request a human decision
+     * @returns Promise that resolves with the selected option ID
+     */
+    async requestDecision(request) {
+        // If request already has an ID, use it, otherwise generate one
+        const requestId = request.id || `DECISION-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const fullRequest = {
+            ...request,
+            id: requestId
+        };
+        this.pendingDecisions.set(requestId, fullRequest);
+        if (this.config.logLevel !== 'none') {
+            this.logDecisionRequest(fullRequest);
+        }
+        // If auto-pause is disabled, return default or first option
+        if (!this.config.autoPause) {
+            const selectedOptionId = request.defaultOptionId || request.options[0]?.id;
+            if (selectedOptionId) {
+                const response = {
+                    requestId,
+                    selectedOptionId,
+                    timestamp: new Date()
+                };
+                this.recordDecision(response);
+                if (this.config.logLevel === 'detailed') {
+                    console.log(chalk.yellow(`⚠️  Auto-proceeding with option: ${this.getOptionLabel(request, selectedOptionId)}`));
+                }
+                return selectedOptionId;
+            }
+        }
+        // Show decision prompt to user
+        return this.promptUserForDecision(fullRequest);
+    }
+    /**
+     * Present decision to user and wait for input
+     */
+    async promptUserForDecision(request) {
+        console.log('\n' + chalk.bold.cyan('╔═══════════════════════════════════════════════════════════╗'));
+        console.log(chalk.bold.cyan('║                     HUMAN DECISION REQUIRED                    ║'));
+        console.log(chalk.bold.cyan('╚═══════════════════════════════════════════════════════════╝\n'));
+        console.log(chalk.bold.white(`📋 ${request.title}`));
+        console.log(chalk.dim(request.description));
+        console.log('');
+        if (request.context) {
+            console.log(chalk.blue('📝 Context:'));
+            console.log(chalk.dim(request.context));
+            console.log('');
+        }
+        console.log(chalk.bold.green('🔘 Available options:'));
+        request.options.forEach((option, index) => {
+            const shortcut = option.shortcut || String(index + 1);
+            const isDefault = request.defaultOptionId === option.id;
+            const defaultMarker = isDefault ? chalk.dim(' (default)') : '';
+            console.log(`  ${chalk.bold.cyan(`${shortcut}.`)} ${chalk.bold.white(option.label)}${defaultMarker}`);
+            console.log(`     ${chalk.dim(option.description)}`);
+            console.log('');
+        });
+        console.log(chalk.yellow('💡 You can also:'));
+        console.log(chalk.dim('  • Type a custom plan or instruction'));
+        console.log(chalk.dim('  • Press Enter to accept the default option'));
+        console.log(chalk.dim('  • Type "cancel" to abort the current operation'));
+        console.log('');
+        const prompt = chalk.bold.magenta('👉 Your choice: ');
+        return new Promise((resolve) => {
+            // Create readline interface if not exists
+            if (!this.rl) {
+                this.rl = readline.createInterface({
+                    input: stdin,
+                    output: stdout
+                });
+            }
+            const timeoutId = this.config.timeoutMs > 0
+                ? setTimeout(() => {
+                    if (this.config.timeoutDefaultOptionId) {
+                        console.log(chalk.yellow(`\n⏰ Timeout - auto-selecting default option`));
+                        this.cleanupReadline();
+                        resolve(this.config.timeoutDefaultOptionId);
+                    }
+                }, this.config.timeoutMs)
+                : undefined;
+            this.rl.question(prompt, (answer) => {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                const trimmedAnswer = answer.trim().toLowerCase();
+                // Handle cancellation
+                if (trimmedAnswer === 'cancel' || trimmedAnswer === 'abort') {
+                    console.log(chalk.red('❌ Operation cancelled by user'));
+                    this.cleanupReadline();
+                    process.exit(0);
+                }
+                // Handle empty input (use default)
+                if (!trimmedAnswer && request.defaultOptionId) {
+                    console.log(chalk.green(`✅ Using default option: ${this.getOptionLabel(request, request.defaultOptionId)}`));
+                    this.cleanupReadline();
+                    resolve(request.defaultOptionId);
+                    return;
+                }
+                // Check for shortcut matches
+                for (const option of request.options) {
+                    if (option.shortcut && option.shortcut.toLowerCase() === trimmedAnswer) {
+                        console.log(chalk.green(`✅ Selected: ${option.label}`));
+                        this.cleanupReadline();
+                        resolve(option.id);
+                        return;
+                    }
+                }
+                // Check for numeric selection
+                const numericMatch = trimmedAnswer.match(/^\d+$/);
+                if (numericMatch) {
+                    const index = parseInt(numericMatch[0], 10) - 1;
+                    if (index >= 0 && index < request.options.length) {
+                        const selectedOption = request.options[index];
+                        console.log(chalk.green(`✅ Selected: ${selectedOption.label}`));
+                        this.cleanupReadline();
+                        resolve(selectedOption.id);
+                        return;
+                    }
+                }
+                // Check for option ID match
+                for (const option of request.options) {
+                    if (option.id.toLowerCase() === trimmedAnswer) {
+                        console.log(chalk.green(`✅ Selected: ${option.label}`));
+                        this.cleanupReadline();
+                        resolve(option.id);
+                        return;
+                    }
+                }
+                // If we get here, it's custom input
+                console.log(chalk.green(`✅ Using custom input: "${answer}"`));
+                // Create a custom option response
+                const customOptionId = `custom-${Date.now()}`;
+                const response = {
+                    requestId: request.id,
+                    selectedOptionId: customOptionId,
+                    userInput: answer,
+                    timestamp: new Date()
+                };
+                this.recordDecision(response);
+                this.cleanupReadline();
+                resolve(customOptionId);
+            });
+        });
+    }
+    cleanupReadline() {
+        if (this.rl) {
+            this.rl.close();
+            this.rl = undefined;
+        }
+    }
+    getOptionLabel(request, optionId) {
+        const option = request.options.find(opt => opt.id === optionId);
+        return option ? option.label : optionId;
+    }
+    logDecisionRequest(request) {
+        if (this.config.logLevel === 'minimal') {
+            console.log(chalk.yellow(`⚠️  Decision required: ${request.title}`));
+            return;
+        }
+        console.log(chalk.yellow(`\n⚠️  Decision Point: ${request.title}`));
+        console.log(chalk.dim(`   ${request.description}`));
+        console.log(chalk.dim(`   Options: ${request.options.map(o => o.label).join(', ')}`));
+    }
+    recordDecision(response) {
+        this.decisionHistory.push(response);
+        this.pendingDecisions.delete(response.requestId);
+        // Log the decision
+        if (this.config.logLevel === 'detailed') {
+            const request = this.pendingDecisions.get(response.requestId);
+            const optionLabel = request ? this.getOptionLabel(request, response.selectedOptionId) : response.selectedOptionId;
+            console.log(chalk.green(`📝 Decision recorded: ${optionLabel}`));
+            if (response.userInput) {
+                console.log(chalk.dim(`   Custom input: ${response.userInput}`));
+            }
+        }
+    }
+    /**
+     * Get decision history
+     */
+    getHistory() {
+        return [...this.decisionHistory];
+    }
+    /**
+     * Clear decision history
+     */
+    clearHistory() {
+        this.decisionHistory = [];
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+// Singleton instance
+let hitlInstance = null;
+/**
+ * Get the global HITL instance
+ */
+export function getHITL(config) {
+    if (!hitlInstance) {
+        hitlInstance = new HITLSystem(config);
+    }
+    if (config) {
+        hitlInstance.updateConfig(config);
+    }
+    return hitlInstance;
+}
+/**
+ * Helper function for common decision patterns
+ */
+export const hitl = {
+    /**
+     * Request a yes/no decision
+     */
+    async askYesNo(title, description, context = '', defaultYes = true) {
+        const hitl = getHITL();
+        const decision = await hitl.requestDecision({
+            id: `yesno-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+            title,
+            description,
+            context,
+            options: [
+                {
+                    id: 'yes',
+                    label: 'Yes',
+                    description: 'Proceed with the suggested plan',
+                    shortcut: 'y'
+                },
+                {
+                    id: 'no',
+                    label: 'No',
+                    description: 'Do not proceed',
+                    shortcut: 'n'
+                }
+            ],
+            defaultOptionId: defaultYes ? 'yes' : 'no',
+            requiresExplicitChoice: true
+        });
+        return decision === 'yes';
+    },
+    /**
+     * Request selection from multiple options
+     */
+    async selectOption(title, description, options, context = '', defaultOptionId) {
+        const hitl = getHITL();
+        const decision = await hitl.requestDecision({
+            id: `select-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+            title,
+            description,
+            context,
+            options: options.map((opt, index) => ({
+                ...opt,
+                shortcut: String(index + 1)
+            })),
+            defaultOptionId,
+            requiresExplicitChoice: true
+        });
+        return decision;
+    },
+    /**
+     * Request approval for a risky operation
+     */
+    async requestApproval(title, riskDescription, operationDetails) {
+        return hitl.askYesNo(`APPROVAL REQUIRED: ${title}`, riskDescription, operationDetails, false // Default to "no" for safety
+        );
+    }
+};
+//# sourceMappingURL=hitl.js.map

package/dist/core/hitl.js.map

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