@ai-agent-forge/agent-forge 0.88.2 → 0.88.3

package/dist/modes/interactive/interactive-lifecycle.js

@@ -0,0 +1,177 @@
+import chalk from "chalk";
+import { APP_NAME } from "../../config.js";
+import { t } from "../../core/i18n/index.js";
+import { killTrackedDetachedChildren } from "../../utils/shell.js";
+import { isDeadTerminalError } from "./interactive-helpers.js";
+export function handleCtrlC(host) {
+    const now = Date.now();
+    if (now - host.lastSigintTime < 500) {
+        void host.shutdown();
+    }
+    else {
+        host.clearEditor();
+        host.lastSigintTime = now;
+    }
+}
+export function handleCtrlD(host) {
+    // Only called when editor is empty (enforced by CustomEditor)
+    void host.shutdown();
+}
+export async function shutdown(host, options) {
+    if (host.isShuttingDown)
+        return;
+    host.isShuttingDown = true;
+    // Keep signal handlers registered until terminal cleanup has completed.
+    // `signal-exit` checks the listener list during the same SIGTERM/SIGHUP
+    // dispatch and re-sends the signal if only its own listeners remain.
+    if (options?.fromSignal) {
+        // Signal-triggered shutdown (SIGTERM/SIGHUP). Emit extension cleanup
+        // (session_shutdown) BEFORE touching the terminal. Extension teardown
+        // such as removing sockets does not write to the tty, so it must not be
+        // skipped if a later terminal-restore write fails on a dead or stalled
+        // terminal. If the terminal is gone, the restore writes below emit EIO,
+        // which the stdout/stderr error handler turns into emergencyTerminalExit;
+        // the render loop is already idle, so this cannot hot-spin (see #4144).
+        await host.runtimeFacade.dispose();
+        host.themeController.disableAutoSync();
+        await host.ui.terminal.drainInput(1000);
+        host.stop();
+        process.exit(0);
+    }
+    // Interactive quit (Ctrl+D, Ctrl+C, /quit, extension shutdown()). Stop the
+    // TUI before emitting shutdown events so extension UI cleanup cannot repaint
+    // the final frame while the process is exiting.
+    // Drain any in-flight Kitty key release events before stopping.
+    // This prevents escape sequences from leaking to the parent shell over slow SSH.
+    host.themeController.disableAutoSync();
+    await host.ui.terminal.drainInput(1000);
+    host.stop();
+    await host.runtimeFacade.dispose();
+    const resumeCommand = host.formatResumeCommand(host.runtimeFacade);
+    if (resumeCommand) {
+        process.stdout.write(`${chalk.dim(t("To resume this session:"))} ${resumeCommand}\n`);
+    }
+    process.exit(0);
+}
+export function emergencyTerminalExit(host) {
+    host.isShuttingDown = true;
+    host.unregisterSignalHandlers();
+    killTrackedDetachedChildren();
+    // The terminal is gone. Do not run normal shutdown because TUI and
+    // extension cleanup can write restore sequences and re-trigger EIO.
+    process.exit(129);
+}
+/**
+ * Last-resort handler for uncaught exceptions. The TUI puts stdin into raw
+ * mode and hides the cursor; without this handler, an uncaught throw from
+ * anywhere (e.g. an extension's async `ChildProcess.on("exit")` callback)
+ * tears down the process while leaving the terminal in raw mode with no
+ * cursor, requiring `stty sane && reset` to recover.
+ *
+ * Unlike emergencyTerminalExit, the terminal is still alive here, so we
+ * call ui.stop() to restore cooked mode, the cursor, and disable bracketed
+ * paste / Kitty / modifyOtherKeys sequences.
+ */
+export function uncaughtCrash(host, error) {
+    if (host.isShuttingDown) {
+        process.exit(1);
+    }
+    host.isShuttingDown = true;
+    try {
+        host.unregisterSignalHandlers();
+    }
+    catch { }
+    try {
+        killTrackedDetachedChildren();
+    }
+    catch { }
+    try {
+        host.ui.stop();
+    }
+    catch { }
+    console.error(t("{app} exiting due to uncaughtException:", { app: APP_NAME }));
+    console.error(error);
+    process.exit(1);
+}
+/**
+ * Check if shutdown was requested and perform shutdown if so.
+ */
+export async function checkShutdownRequested(host) {
+    if (!host.shutdownRequested)
+        return;
+    await host.shutdown();
+}
+export function registerSignalHandlers(host) {
+    host.unregisterSignalHandlers();
+    const signals = ["SIGTERM"];
+    if (process.platform !== "win32") {
+        signals.push("SIGHUP");
+    }
+    for (const signal of signals) {
+        const handler = () => {
+            // SIGHUP no longer hard-exits: graceful shutdown emits session_shutdown
+            // first, then attempts terminal restore. A genuinely dead terminal
+            // surfaces as an EIO on the restore writes, which the stdout/stderr
+            // error handler converts into emergencyTerminalExit (see #4144, #5080).
+            killTrackedDetachedChildren();
+            void host.shutdown({ fromSignal: true });
+        };
+        process.prependListener(signal, handler);
+        host.signalCleanupHandlers.push(() => process.off(signal, handler));
+    }
+    const terminalErrorHandler = (error) => {
+        if (isDeadTerminalError(error)) {
+            host.emergencyTerminalExit();
+        }
+        throw error;
+    };
+    process.stdout.on("error", terminalErrorHandler);
+    process.stderr.on("error", terminalErrorHandler);
+    host.signalCleanupHandlers.push(() => process.stdout.off("error", terminalErrorHandler));
+    host.signalCleanupHandlers.push(() => process.stderr.off("error", terminalErrorHandler));
+    // Restore the terminal before the process dies on any uncaught throw.
+    // Without this, an unhandled exception from extension code (or anywhere
+    // in the application) leaves the terminal in raw mode with no cursor.
+    const uncaughtExceptionHandler = (error) => host.uncaughtCrash(error);
+    process.prependListener("uncaughtException", uncaughtExceptionHandler);
+    host.signalCleanupHandlers.push(() => process.off("uncaughtException", uncaughtExceptionHandler));
+}
+export function unregisterSignalHandlers(host) {
+    for (const cleanup of host.signalCleanupHandlers) {
+        cleanup();
+    }
+    host.signalCleanupHandlers = [];
+}
+export function handleCtrlZ(host) {
+    if (process.platform === "win32") {
+        host.showStatus(t("Suspend to background is not supported on Windows"));
+        return;
+    }
+    // Keep the event loop alive while suspended. Without this, stopping the TUI
+    // can leave Node with no ref'ed handles, causing the process to exit on fg
+    // before the SIGCONT handler gets a chance to restore the terminal.
+    const suspendKeepAlive = setInterval(() => { }, 2 ** 30);
+    // Ignore SIGINT while suspended so Ctrl+C in the terminal does not
+    // kill the backgrounded process. The handler is removed on resume.
+    const ignoreSigint = () => { };
+    process.on("SIGINT", ignoreSigint);
+    // Set up handler to restore TUI when resumed
+    process.once("SIGCONT", () => {
+        clearInterval(suspendKeepAlive);
+        process.removeListener("SIGINT", ignoreSigint);
+        host.ui.start();
+        host.ui.requestRender(true);
+    });
+    try {
+        // Stop the TUI (restore terminal to normal mode)
+        host.ui.stop();
+        // Send SIGTSTP to process group (pid=0 means all processes in group)
+        process.kill(0, "SIGTSTP");
+    }
+    catch (error) {
+        clearInterval(suspendKeepAlive);
+        process.removeListener("SIGINT", ignoreSigint);
+        throw error;
+    }
+}
+//# sourceMappingURL=interactive-lifecycle.js.map

package/dist/modes/interactive/interactive-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-lifecycle.js","sourceRoot":"","sources":["../../../src/modes/interactive/interactive-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Exit and signal lifecycle for interactive mode (拆分 slice 4,\n * docs/plans/interactive-mode拆分计划.md): the Ctrl+C / Ctrl+D / Ctrl+Z\n * handlers, graceful shutdown, the dead-terminal emergency exit, the uncaught\n * exception crash handler, and signal-handler registration/unregistration.\n *\n * InteractiveMode implements LifecycleHost and keeps same-name delegate methods\n * so prototype-level tests and the editor key wiring keep working; the\n * functions below receive the mode through LifecycleHost. The main loop\n * (run/init) and the TUI teardown (stop) stay on the mode; formatResumeCommand\n * also stays resident in interactive-mode.ts (D-041 §3.5: the resume hint is\n * host TUI behavior, not a facade contract) and is reached here through the\n * host method.\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nimport type { TUI } from \"@agent-forge/tui\";\nimport chalk from \"chalk\";\nimport { APP_NAME } from \"../../config.ts\";\nimport type { CodingAgentRuntimeFacadeV1 } from \"../../core/facade/index.ts\";\nimport { t } from \"../../core/i18n/index.ts\";\nimport type { FullscreenExitOutput } from \"../../core/settings-manager.ts\";\nimport type { InteractiveThemeController } from \"../../theme/theme-controller.ts\";\nimport { killTrackedDetachedChildren } from \"../../utils/shell.ts\";\nimport { isDeadTerminalError } from \"./interactive-helpers.ts\";\n\n/**\n * Session read view the shutdown resume hint consumes (structural twin of the\n * reads formatResumeCommand takes; the real interface and function stay in\n * ./interactive-mode.ts, D-041 §3.5).\n */\ninterface ShutdownResumeSessionReads {\n\tisPersisted(): boolean;\n\tgetSessionFile(): string | undefined;\n\tusesDefaultSessionDir(): boolean;\n\tgetSessionDir(): string;\n\tgetSessionId(): string;\n}\n\n/**\n * Host surface InteractiveMode exposes to this module: the TUI, the runtime\n * facade (dispose), the theme controller, the shutdown state fields, and the\n * mode-owned surfaces shutdown drives (stop, editor clear, status line).\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nexport interface LifecycleHost {\n\tui: TUI;\n\t/** Stable runtime facade (阶段 4 slice 3): dispose on shutdown. */\n\truntimeFacade: CodingAgentRuntimeFacadeV1;\n\tthemeController: InteractiveThemeController;\n\t/** Timestamp of the last Ctrl+C clear; a second press inside 500ms exits. */\n\tlastSigintTime: number;\n\t/** Reentrancy guard shared by shutdown / emergencyTerminalExit / uncaughtCrash. */\n\tisShuttingDown: boolean;\n\t/** Set when the session asks the UI to exit once the agent settles. */\n\tshutdownRequested: boolean;\n\t/** Cleanup closures for every process-level listener this module registers. */\n\tsignalCleanupHandlers: Array<() => void>;\n\n\t/** TUI teardown; stays on the mode (also the /quit-adjacent stop path). */\n\tstop(fullscreenExitOutput?: FullscreenExitOutput): void;\n\tclearEditor(): void;\n\tshowStatus(message: string): void;\n\tshutdown(options?: { fromSignal?: boolean }): Promise<void>;\n\temergencyTerminalExit(): never;\n\tuncaughtCrash(error: Error): never;\n\tunregisterSignalHandlers(): void;\n\t/** D-041 §3.5: the function stays resident in interactive-mode.ts. */\n\tformatResumeCommand(session: ShutdownResumeSessionReads): string | undefined;\n}\n\nexport function handleCtrlC(host: LifecycleHost): void {\n\tconst now = Date.now();\n\tif (now - host.lastSigintTime < 500) {\n\t\tvoid host.shutdown();\n\t} else {\n\t\thost.clearEditor();\n\t\thost.lastSigintTime = now;\n\t}\n}\n\nexport function handleCtrlD(host: LifecycleHost): void {\n\t// Only called when editor is empty (enforced by CustomEditor)\n\tvoid host.shutdown();\n}\n\nexport async function shutdown(host: LifecycleHost, options?: { fromSignal?: boolean }): Promise<void> {\n\tif (host.isShuttingDown) return;\n\thost.isShuttingDown = true;\n\t// Keep signal handlers registered until terminal cleanup has completed.\n\t// `signal-exit` checks the listener list during the same SIGTERM/SIGHUP\n\t// dispatch and re-sends the signal if only its own listeners remain.\n\n\tif (options?.fromSignal) {\n\t\t// Signal-triggered shutdown (SIGTERM/SIGHUP). Emit extension cleanup\n\t\t// (session_shutdown) BEFORE touching the terminal. Extension teardown\n\t\t// such as removing sockets does not write to the tty, so it must not be\n\t\t// skipped if a later terminal-restore write fails on a dead or stalled\n\t\t// terminal. If the terminal is gone, the restore writes below emit EIO,\n\t\t// which the stdout/stderr error handler turns into emergencyTerminalExit;\n\t\t// the render loop is already idle, so this cannot hot-spin (see #4144).\n\t\tawait host.runtimeFacade.dispose();\n\t\thost.themeController.disableAutoSync();\n\t\tawait host.ui.terminal.drainInput(1000);\n\t\thost.stop();\n\t\tprocess.exit(0);\n\t}\n\n\t// Interactive quit (Ctrl+D, Ctrl+C, /quit, extension shutdown()). Stop the\n\t// TUI before emitting shutdown events so extension UI cleanup cannot repaint\n\t// the final frame while the process is exiting.\n\t// Drain any in-flight Kitty key release events before stopping.\n\t// This prevents escape sequences from leaking to the parent shell over slow SSH.\n\thost.themeController.disableAutoSync();\n\tawait host.ui.terminal.drainInput(1000);\n\n\thost.stop();\n\tawait host.runtimeFacade.dispose();\n\n\tconst resumeCommand = host.formatResumeCommand(host.runtimeFacade);\n\tif (resumeCommand) {\n\t\tprocess.stdout.write(`${chalk.dim(t(\"To resume this session:\"))} ${resumeCommand}\\n`);\n\t}\n\n\tprocess.exit(0);\n}\n\nexport function emergencyTerminalExit(host: LifecycleHost): never {\n\thost.isShuttingDown = true;\n\thost.unregisterSignalHandlers();\n\tkillTrackedDetachedChildren();\n\t// The terminal is gone. Do not run normal shutdown because TUI and\n\t// extension cleanup can write restore sequences and re-trigger EIO.\n\tprocess.exit(129);\n}\n\n/**\n * Last-resort handler for uncaught exceptions. The TUI puts stdin into raw\n * mode and hides the cursor; without this handler, an uncaught throw from\n * anywhere (e.g. an extension's async `ChildProcess.on(\"exit\")` callback)\n * tears down the process while leaving the terminal in raw mode with no\n * cursor, requiring `stty sane && reset` to recover.\n *\n * Unlike emergencyTerminalExit, the terminal is still alive here, so we\n * call ui.stop() to restore cooked mode, the cursor, and disable bracketed\n * paste / Kitty / modifyOtherKeys sequences.\n */\nexport function uncaughtCrash(host: LifecycleHost, error: Error): never {\n\tif (host.isShuttingDown) {\n\t\tprocess.exit(1);\n\t}\n\thost.isShuttingDown = true;\n\ttry {\n\t\thost.unregisterSignalHandlers();\n\t} catch {}\n\ttry {\n\t\tkillTrackedDetachedChildren();\n\t} catch {}\n\ttry {\n\t\thost.ui.stop();\n\t} catch {}\n\tconsole.error(t(\"{app} exiting due to uncaughtException:\", { app: APP_NAME }));\n\tconsole.error(error);\n\tprocess.exit(1);\n}\n\n/**\n * Check if shutdown was requested and perform shutdown if so.\n */\nexport async function checkShutdownRequested(host: LifecycleHost): Promise<void> {\n\tif (!host.shutdownRequested) return;\n\tawait host.shutdown();\n}\n\nexport function registerSignalHandlers(host: LifecycleHost): void {\n\thost.unregisterSignalHandlers();\n\n\tconst signals: NodeJS.Signals[] = [\"SIGTERM\"];\n\tif (process.platform !== \"win32\") {\n\t\tsignals.push(\"SIGHUP\");\n\t}\n\n\tfor (const signal of signals) {\n\t\tconst handler = () => {\n\t\t\t// SIGHUP no longer hard-exits: graceful shutdown emits session_shutdown\n\t\t\t// first, then attempts terminal restore. A genuinely dead terminal\n\t\t\t// surfaces as an EIO on the restore writes, which the stdout/stderr\n\t\t\t// error handler converts into emergencyTerminalExit (see #4144, #5080).\n\t\t\tkillTrackedDetachedChildren();\n\t\t\tvoid host.shutdown({ fromSignal: true });\n\t\t};\n\t\tprocess.prependListener(signal, handler);\n\t\thost.signalCleanupHandlers.push(() => process.off(signal, handler));\n\t}\n\n\tconst terminalErrorHandler = (error: Error) => {\n\t\tif (isDeadTerminalError(error)) {\n\t\t\thost.emergencyTerminalExit();\n\t\t}\n\t\tthrow error;\n\t};\n\tprocess.stdout.on(\"error\", terminalErrorHandler);\n\tprocess.stderr.on(\"error\", terminalErrorHandler);\n\thost.signalCleanupHandlers.push(() => process.stdout.off(\"error\", terminalErrorHandler));\n\thost.signalCleanupHandlers.push(() => process.stderr.off(\"error\", terminalErrorHandler));\n\n\t// Restore the terminal before the process dies on any uncaught throw.\n\t// Without this, an unhandled exception from extension code (or anywhere\n\t// in the application) leaves the terminal in raw mode with no cursor.\n\tconst uncaughtExceptionHandler = (error: Error) => host.uncaughtCrash(error);\n\tprocess.prependListener(\"uncaughtException\", uncaughtExceptionHandler);\n\thost.signalCleanupHandlers.push(() => process.off(\"uncaughtException\", uncaughtExceptionHandler));\n}\n\nexport function unregisterSignalHandlers(host: LifecycleHost): void {\n\tfor (const cleanup of host.signalCleanupHandlers) {\n\t\tcleanup();\n\t}\n\thost.signalCleanupHandlers = [];\n}\n\nexport function handleCtrlZ(host: LifecycleHost): void {\n\tif (process.platform === \"win32\") {\n\t\thost.showStatus(t(\"Suspend to background is not supported on Windows\"));\n\t\treturn;\n\t}\n\n\t// Keep the event loop alive while suspended. Without this, stopping the TUI\n\t// can leave Node with no ref'ed handles, causing the process to exit on fg\n\t// before the SIGCONT handler gets a chance to restore the terminal.\n\tconst suspendKeepAlive = setInterval(() => {}, 2 ** 30);\n\n\t// Ignore SIGINT while suspended so Ctrl+C in the terminal does not\n\t// kill the backgrounded process. The handler is removed on resume.\n\tconst ignoreSigint = () => {};\n\tprocess.on(\"SIGINT\", ignoreSigint);\n\n\t// Set up handler to restore TUI when resumed\n\tprocess.once(\"SIGCONT\", () => {\n\t\tclearInterval(suspendKeepAlive);\n\t\tprocess.removeListener(\"SIGINT\", ignoreSigint);\n\t\thost.ui.start();\n\t\thost.ui.requestRender(true);\n\t});\n\n\ttry {\n\t\t// Stop the TUI (restore terminal to normal mode)\n\t\thost.ui.stop();\n\n\t\t// Send SIGTSTP to process group (pid=0 means all processes in group)\n\t\tprocess.kill(0, \"SIGTSTP\");\n\t} catch (error) {\n\t\tclearInterval(suspendKeepAlive);\n\t\tprocess.removeListener(\"SIGINT\", ignoreSigint);\n\t\tthrow error;\n\t}\n}\n"]}