@deepseekdev/coder 1.0.74

package/dist/core/shutdown.js

@@ -0,0 +1,173 @@
+/**
+ * Centralized shutdown and signal handling for the CLI.
+ * Ensures Ctrl+C always works and process exits cleanly.
+ */
+import { stdin, stdout } from 'node:process';
+import { reportStatusError } from '../utils/statusReporter.js';
+// Track shutdown state
+let isShuttingDown = false;
+let shutdownReason;
+let signalHandlersInstalled = false;
+let cleanupCallbacks = [];
+let forceExitTimeout = null;
+// Ctrl+C counter for double-press detection at process level
+let processCtrlCCount = 0;
+let lastProcessCtrlCTime = 0;
+/**
+ * Register a cleanup callback to run on shutdown
+ */
+export function onShutdown(callback) {
+    cleanupCallbacks.push(callback);
+    // Return unregister function
+    return () => {
+        const index = cleanupCallbacks.indexOf(callback);
+        if (index !== -1) {
+            cleanupCallbacks.splice(index, 1);
+        }
+    };
+}
+/**
+ * Run all cleanup callbacks
+ */
+async function runCleanup() {
+    const callbacks = [...cleanupCallbacks];
+    cleanupCallbacks = [];
+    for (const callback of callbacks) {
+        try {
+            await callback();
+        }
+        catch {
+            // Ignore cleanup errors during shutdown
+        }
+    }
+}
+/**
+ * Initiate authorized shutdown with cleanup
+ */
+export async function authorizedShutdown(codeOrReason) {
+    const exitCode = typeof codeOrReason === 'number' ? codeOrReason : 0;
+    const reason = typeof codeOrReason === 'string' ? codeOrReason : `exit(${exitCode})`;
+    if (isShuttingDown) {
+        // Already shutting down - force exit if called again
+        process.exit(exitCode);
+    }
+    isShuttingDown = true;
+    shutdownReason = reason;
+    // Set a force exit timeout in case cleanup hangs
+    forceExitTimeout = setTimeout(() => {
+        process.exit(exitCode);
+    }, 3000);
+    try {
+        // Restore terminal state
+        if (stdin.isTTY && stdin.setRawMode) {
+            try {
+                stdin.setRawMode(false);
+            }
+            catch {
+                // Ignore - may not be in raw mode
+            }
+        }
+        // Run cleanup callbacks
+        await runCleanup();
+        // Clear the force exit timeout since we completed normally
+        if (forceExitTimeout) {
+            clearTimeout(forceExitTimeout);
+        }
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+    process.exit(exitCode);
+}
+/**
+ * Check if shutdown is in progress
+ */
+export function isShutdownInProgress() {
+    return isShuttingDown;
+}
+/**
+ * Get the shutdown reason if shutting down
+ */
+export function getShutdownReason() {
+    return shutdownReason;
+}
+/**
+ * Handle SIGINT at process level - this is the fallback when input interception fails
+ */
+function handleSIGINT() {
+    const now = Date.now();
+    // Reset count if more than 2 seconds since last
+    if (now - lastProcessCtrlCTime > 2000) {
+        processCtrlCCount = 0;
+    }
+    lastProcessCtrlCTime = now;
+    processCtrlCCount++;
+    if (processCtrlCCount >= 2) {
+        // Double Ctrl+C - force exit
+        stdout.write('\n');
+        void authorizedShutdown(130); // Standard SIGINT exit code
+    }
+    else {
+        // Single Ctrl+C - show hint
+        stdout.write('\n');
+        stdout.write('\x1b[2m(Press Ctrl+C again to exit)\x1b[0m\n');
+    }
+}
+/**
+ * Handle SIGTERM - graceful shutdown request
+ */
+function handleSIGTERM() {
+    void authorizedShutdown('SIGTERM');
+}
+/**
+ * Install process-level signal handlers as fallback
+ * This ensures Ctrl+C always works even if input handling fails
+ */
+export function installSignalHandlers() {
+    if (signalHandlersInstalled) {
+        return;
+    }
+    signalHandlersInstalled = true;
+    // SIGINT (Ctrl+C) - with double-press detection
+    process.on('SIGINT', handleSIGINT);
+    // SIGTERM - graceful shutdown
+    process.on('SIGTERM', handleSIGTERM);
+    // Handle uncaught errors during shutdown
+    process.on('uncaughtException', (error) => {
+        if (!isShuttingDown) {
+            reportStatusError(error, 'Uncaught exception');
+            void authorizedShutdown(1);
+        }
+    });
+    // Handle unhandled promise rejections during shutdown
+    process.on('unhandledRejection', (reason) => {
+        if (!isShuttingDown) {
+            reportStatusError(reason, 'Unhandled rejection');
+            void authorizedShutdown(1);
+        }
+    });
+    // Ensure terminal is restored on exit
+    process.on('exit', () => {
+        if (stdin.isTTY && stdin.setRawMode) {
+            try {
+                stdin.setRawMode(false);
+            }
+            catch {
+                // Ignore
+            }
+        }
+    });
+}
+/**
+ * Reset Ctrl+C counter (call when input is processed to prevent double-counting)
+ */
+export function resetCtrlCCounter() {
+    processCtrlCCount = 0;
+}
+/**
+ * Get current Ctrl+C count (for coordination with input handlers)
+ */
+export function getCtrlCCount() {
+    return processCtrlCCount;
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/core/shutdown.js.map

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

package/dist/core/sudoPasswordManager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Sudo Password Manager - handles sudo password caching and prompting
+ *
+ * This module provides a singleton manager for sudo passwords, allowing
+ * bash commands to run with sudo privileges by prompting the user for
+ * their password when needed.
+ */
+import { EventEmitter } from 'node:events';
+declare class SudoPasswordManager extends EventEmitter {
+    private cachedPassword;
+    private passwordValidUntil;
+    private readonly CACHE_DURATION_MS;
+    private pendingRequest;
+    /**
+     * Get the cached sudo password if still valid
+     */
+    getCachedPassword(): string | null;
+    /**
+     * Cache a sudo password
+     */
+    cachePassword(password: string): void;
+    /**
+     * Invalidate the cached password (e.g., if sudo fails)
+     */
+    invalidatePassword(): void;
+    /**
+     * Request a sudo password - emits 'password-needed' event
+     * Returns the password or null if cancelled
+     */
+    requestPassword(): Promise<string | null>;
+    /**
+     * Provide the password in response to a 'password-needed' event
+     */
+    providePassword(password: string | null): void;
+    /**
+     * Cancel the pending password request
+     */
+    cancelRequest(): void;
+    /**
+     * Check if there's a pending password request
+     */
+    hasPendingRequest(): boolean;
+}
+export declare const sudoPasswordManager: SudoPasswordManager;
+export declare function getSudoPassword(): Promise<string | null>;
+export declare function setCachedSudoPassword(password: string): void;
+export declare function invalidateSudoPassword(): void;
+export declare function onSudoPasswordNeeded(callback: () => void): void;
+export declare function offSudoPasswordNeeded(callback: () => void): void;
+export declare function provideSudoPassword(password: string | null): void;
+export {};
+//# sourceMappingURL=sudoPasswordManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sudoPasswordManager.d.ts","sourceRoot":"","sources":["../../src/core/sudoPasswordManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,cAAM,mBAAoB,SAAQ,YAAY;IAC5C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IACnD,OAAO,CAAC,cAAc,CAAoC;IAE1D;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAOlC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAK1B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA0B/C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAY9C;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;OAEG;IACH,iBAAiB,IAAI,OAAO;CAG7B;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAG7D,wBAAgB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjE"}

package/dist/core/sudoPasswordManager.js

@@ -0,0 +1,115 @@
+/**
+ * Sudo Password Manager - handles sudo password caching and prompting
+ *
+ * This module provides a singleton manager for sudo passwords, allowing
+ * bash commands to run with sudo privileges by prompting the user for
+ * their password when needed.
+ */
+import { EventEmitter } from 'node:events';
+class SudoPasswordManager extends EventEmitter {
+    cachedPassword = null;
+    passwordValidUntil = 0;
+    CACHE_DURATION_MS = 5 * 60 * 1000; // 5 minutes (matches typical sudo timeout)
+    pendingRequest = null;
+    /**
+     * Get the cached sudo password if still valid
+     */
+    getCachedPassword() {
+        if (this.cachedPassword && Date.now() < this.passwordValidUntil) {
+            return this.cachedPassword;
+        }
+        return null;
+    }
+    /**
+     * Cache a sudo password
+     */
+    cachePassword(password) {
+        this.cachedPassword = password;
+        this.passwordValidUntil = Date.now() + this.CACHE_DURATION_MS;
+    }
+    /**
+     * Invalidate the cached password (e.g., if sudo fails)
+     */
+    invalidatePassword() {
+        this.cachedPassword = null;
+        this.passwordValidUntil = 0;
+    }
+    /**
+     * Request a sudo password - emits 'password-needed' event
+     * Returns the password or null if cancelled
+     */
+    async requestPassword() {
+        // Check cache first
+        const cached = this.getCachedPassword();
+        if (cached) {
+            return cached;
+        }
+        // If there's already a pending request, wait for it
+        if (this.pendingRequest) {
+            return new Promise((resolve, reject) => {
+                // Subscribe to the same request
+                const originalResolve = this.pendingRequest.resolve;
+                this.pendingRequest.resolve = (password) => {
+                    originalResolve(password);
+                    resolve(password);
+                };
+            });
+        }
+        // Create new request
+        return new Promise((resolve, reject) => {
+            this.pendingRequest = { resolve, reject };
+            this.emit('password-needed');
+        });
+    }
+    /**
+     * Provide the password in response to a 'password-needed' event
+     */
+    providePassword(password) {
+        if (this.pendingRequest) {
+            const request = this.pendingRequest;
+            this.pendingRequest = null;
+            if (password) {
+                this.cachePassword(password);
+            }
+            request.resolve(password);
+        }
+    }
+    /**
+     * Cancel the pending password request
+     */
+    cancelRequest() {
+        if (this.pendingRequest) {
+            const request = this.pendingRequest;
+            this.pendingRequest = null;
+            request.resolve(null);
+        }
+    }
+    /**
+     * Check if there's a pending password request
+     */
+    hasPendingRequest() {
+        return this.pendingRequest !== null;
+    }
+}
+// Singleton instance
+export const sudoPasswordManager = new SudoPasswordManager();
+// Convenience exports
+export function getSudoPassword() {
+    return sudoPasswordManager.requestPassword();
+}
+export function setCachedSudoPassword(password) {
+    sudoPasswordManager.cachePassword(password);
+}
+export function invalidateSudoPassword() {
+    sudoPasswordManager.invalidatePassword();
+}
+export function onSudoPasswordNeeded(callback) {
+    sudoPasswordManager.on('password-needed', callback);
+}
+export function offSudoPasswordNeeded(callback) {
+    sudoPasswordManager.off('password-needed', callback);
+}
+export function provideSudoPassword(password) {
+    sudoPasswordManager.providePassword(password);
+}
+//# sourceMappingURL=sudoPasswordManager.js.map

package/dist/core/sudoPasswordManager.js.map

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

package/dist/core/taskCompletionDetector.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Intelligent Task Completion Detector
+ *
+ * This module provides robust detection of whether a continuous task is truly complete,
+ * rather than just pattern-matching keywords like "done" in responses.
+ *
+ * Key features:
+ * - Multi-signal analysis (tool usage, response content, state changes)
+ * - AI verification round before final completion
+ * - Confidence scoring
+ * - Work-in-progress detection
+ *
+ * @license MIT
+ * @author Bo Shang
+ */
+export interface ToolActivity {
+    toolName: string;
+    timestamp: number;
+    success: boolean;
+    hasOutput: boolean;
+}
+export interface CompletionSignals {
+    hasExplicitCompletionStatement: boolean;
+    hasIncompleteWorkIndicators: boolean;
+    hasPendingActionIndicators: boolean;
+    hasErrorIndicators: boolean;
+    hasFollowUpQuestions: boolean;
+    hasDocumentationSpam: boolean;
+    toolsUsedInLastResponse: number;
+    lastToolWasReadOnly: boolean;
+    consecutiveResponsesWithoutTools: number;
+    hasRecentFileWrites: boolean;
+    hasRecentCommits: boolean;
+    todoItemsPending: number;
+    todoItemsCompleted: number;
+    mentionsFutureWork: boolean;
+    completionConfidence: number;
+}
+export interface CompletionAnalysis {
+    isComplete: boolean;
+    confidence: number;
+    signals: CompletionSignals;
+    reason: string;
+    shouldVerify: boolean;
+    verificationPrompt?: string;
+}
+export declare const WRITE_TOOLS: Set<string>;
+export declare class TaskCompletionDetector {
+    private toolHistory;
+    private responseHistory;
+    private lastToolNames;
+    private consecutiveNoTools;
+    private todoStats;
+    constructor();
+    /**
+     * Reset the detector state for a new task
+     */
+    reset(): void;
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName: string, success: boolean, hasOutput: boolean): void;
+    /**
+     * Record a response (call after each AI response)
+     */
+    recordResponse(response: string, toolsUsed: string[]): void;
+    /**
+     * Update todo statistics
+     */
+    updateTodoStats(pending: number, completed: number): void;
+    /**
+     * Analyze the current state and determine if the task is complete
+     */
+    analyzeCompletion(currentResponse: string, toolsUsedThisRound: string[]): CompletionAnalysis;
+    /**
+     * Gather all completion signals from the current state
+     */
+    private gatherSignals;
+    /**
+     * Calculate confidence score for task completion
+     */
+    private calculateConfidence;
+    /**
+     * Generate a verification prompt to ask the AI if the task is truly complete
+     */
+    private generateVerificationPrompt;
+    /**
+     * Generate a verification prompt for stagnation cases
+     */
+    private generateStagnationVerificationPrompt;
+    /**
+     * Get a human-readable reason for low confidence
+     */
+    private getLowConfidenceReason;
+    /**
+     * Check if a verification response confirms completion
+     */
+    isVerificationConfirmed(verificationResponse: string): boolean;
+    /**
+     * Check if a response contradicts itself by saying "complete" but also indicating incomplete work.
+     * This comprehensive list catches many ways AI might admit work isn't done while claiming completion.
+     */
+    private responseContainsIncompleteIndicators;
+    /**
+     * Check if response contains simulation/fake indicators that should prevent completion.
+     * Simulated results mean the task was NOT actually completed.
+     */
+    containsSimulationIndicators(response: string): boolean;
+}
+export declare function getTaskCompletionDetector(): TaskCompletionDetector;
+export declare function resetTaskCompletionDetector(): void;
+//# sourceMappingURL=taskCompletionDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskCompletionDetector.d.ts","sourceRoot":"","sources":["../../src/core/taskCompletionDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAEhC,8BAA8B,EAAE,OAAO,CAAC;IACxC,2BAA2B,EAAE,OAAO,CAAC;IACrC,0BAA0B,EAAE,OAAO,CAAC;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;IAG9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gCAAgC,EAAE,MAAM,CAAC;IACzC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAG1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAG5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6ED,eAAO,MAAM,WAAW,aAWtB,CAAC;AAEH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,SAAS,CAAgC;;IAMjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAkB5E;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAgB3D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzD;;OAEG;IACH,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,kBAAkB;IAoD5F;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAgClC;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAW5C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,uBAAuB,CAAC,oBAAoB,EAAE,MAAM,GAAG,OAAO;IAc9D;;;OAGG;IACH,OAAO,CAAC,oCAAoC;IAoF5C;;;OAGG;IACH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAoBxD;AAOD,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}