scream-code 0.18.7 → 0.18.8

package/README.md

@@ -31,7 +31,8 @@ npm install -g scream-code
 ```
 
 > [!NOTE]
-> Requires **Node.js >= 22**. Git recommended. Same command installs and updates.
+> Requires **Node.js >= 22**. Git recommended. Same command installs and updates. No native build steps and no dependency install scripts: the local embedding engine runs on WebAssembly.
+> The first use of the knowledge/memory vector features downloads a ~53MB model into `~/.scream-code/cache` (progress is shown, and the download verifies its checksum before use).
 
 ### Quick Start
 
@@ -42,7 +43,7 @@ scream --auto     # auto permission mode
 scream -y         # auto-approve mode
 ```
 
-On first launch Scream walks you through model setup (`/config`). 130+ providers built in — or point it at any OpenAI-compatible endpoint with `/config diy`. Switch models anytime with `/model`, no restart needed — or use `/model diy` to give each sub-agent its own model, letting every model do what it does best. Generate or edit images the same way: run `/config image` once, then just ask for a picture (the `/image` skill).
+On first launch Scream walks you through model setup (`/config` — pick the shortcut provider directory, a custom DIY setup, or image generation). 130+ providers built in — or point it at any OpenAI-compatible endpoint with `/config diy`. Switch models anytime with `/model`, no restart needed — or use `/model diy` to give each sub-agent its own model, letting every model do what it does best. Generate or edit images the same way: run `/config image` once, then just ask for a picture (the `/image` skill).
 
 When Scream wants to modify files or run commands, an approval panel pops up — pick a number, press Enter.
 
@@ -103,7 +104,7 @@ Type `/` in the input to browse. All 55 commands:
 | `/knowledge` (`/know`) `[query]` | Manage local knowledge base |
 | **Models & configuration** | |
 | `/model [alias]` | Switch LLM model |
-| `/config` (`/login`) | Browse and configure models |
+| `/config` (`/login`) | Configure model services: quick provider pick, custom DIY setup, or image generation |
 | `/config image` | Configure image generation (provider, URL, key, model) |
 | `/logout` (`/disconnect`) | Remove configured models |
 | `/language` (`/lang`) | Switch interface language |
@@ -136,6 +137,8 @@ Type `/` in the input to browse. All 55 commands:
 | `/cron` | View and manage scheduled tasks — list, create (pick a time + a task), delete |
 | `/like` | Set your preferences |
 | `/help` (`/h`) | Show commands and shortcuts |
+| `/hotkeys` (`/keys`) | Keyboard shortcut reference |
+| `/copy` (`/yank`) | Copy the last reply to the clipboard |
 | `/exit` (`/quit`, `/q`) | Exit application |
 
 </details>

package/dist/{app-IU7G9gs0.mjs → app-Db7f8Kja.mjs}

@@ -4,15 +4,15 @@ import { dirname as __cjsShimDirname } from 'node:path';
 const __filename = __cjsShimFileURLToPath(import.meta.url);
 const __dirname = __cjsShimDirname(__filename);
 import "./suppress-sqlite-warning-C2VB0doZ.mjs";
-import { A as sharedMemoStore } from "./src-CQwXASmd.mjs";
-import { $ as refineGoal, $n as ScreamHarness, $t as FooterComponent, A as renderDiffLinesClustered, An as setExperimentalFlags, At as isEmptySessionHintDismissed, B as AssistantMessageComponent, Bn as saveTuiConfig, Bt as ENABLE_TERMINAL_FOCUS_REPORTING, C as readJsonlFile, Cn as getCtrlDHint, Ct as supportsBalance, D as UserMessageComponent, Dn as BUILTIN_SLASH_COMMANDS, Dt as resolveThemeSync, En as buildSkillSlashCommands, F as NoticeMessageComponent, Fn as PIXEL_PULSE_FRAMES, Ft as getColorPalette, G as BackgroundAgentStatusComponent, Gn as detectInstallSource, Gt as OSC11_RESPONSE_PREFIX_NO_ESC, H as charsForTokenBudget, Hn as getDataDir, Ht as OSC11_QUERY, I as StatusMessageComponent, In as PULSE_WAVE_FRAMES, It as detectTerminalTheme, J as BREATHE_CYCLE_MS, Jn as CLI_USER_AGENT_PRODUCT, Jt as TERMINAL_FOCUS_OUT, K as AgentGroupComponent, Kn as CLI_COMMAND_NAME, Kt as QUERY_TERMINAL_THEME, L as replaceTabs, Ln as TuiConfigParseError, Lt as parseOsc11BackgroundTheme, M as langFromPath, Mn as getKnowledgeStore, Mt as toggleEmptySessionHint, N as CachedContainer, Nn as hasEmbeddingModelCache, Nt as createThemeStyles, O as ToolCallComponent, On as sortSlashCommands, Ot as createEditorTheme, P as ThinkingComponent, Pn as startManualEmbeddingDownload, Pt as contrastTextHex, Q as clearGoalState, Qn as saveCatalogCache, Qt as isStreaming, R as sanitizeShellOutput, Rn as TuiLikePreferencesSchema, Rt as DISABLE_TERMINAL_FOCUS_REPORTING, S as appendJsonlLine, Sn as getCtrlCHint, St as refreshProviderBalance, T as getDaemonInstructions, Tn as getNoActiveSessionMessage, U as estimateTokens, Un as getInputHistoryFile, Ut as OSC11_RESPONSE, V as ActivityGroupComponent, Vn as detectShellEnvironment, Vt as ENABLE_TERMINAL_THEME_REPORTING, W as getSharedSpeedTracker, Wn as getLogDir, Wt as OSC11_RESPONSE_PREFIX, X as resetBreathingClock, Xn as DEFAULT_CATALOG_URL, Xt as TERMINAL_THEME_LIGHT, Y as getBreathingFrame, Yn as PRODUCT_NAME, Yt as TERMINAL_THEME_DARK, Z as CompactionComponent, Zn as fetchCatalog, Zt as isBusy, a as buildRoleAdditionalText, at as isInternalMessage, b as refreshUpdateCache, bn as SESSION_TIPS, cn as appendSessionHeaderHint, cr as resolveScreamHome, ct as getModelCycleLevel, d as isExpandable, dn as formatErrorMessage, dr as resolveGlobalLogPath, en as lerpGradient, er as encodeWorkDirKey, f as isPlanExpandable, fn as isTodoItemShape, fr as isScreamError, gn as truncateErrorMessage, hn as stringValue, hr as SCREAM_ERROR_INFO, ht as handlePlanCommand, i as openUrl, ir as removeSessionIndexEntry, j as highlightLines, jn as embeddingFailureDetail, jt as isTurnElapsedEnabled, k as renderDiffLines, kn as isExperimentalFlagEnabled, kt as createMarkdownTheme, l as disposeChildren, ln as appendStreamingArgsPreview, lr as flushDiagnosticLogs, m as formatMemoryMemoForInjection, mn as serializeToolResultOutput, mr as ErrorCodes, n as clearEvalPanelState, nr as appendSessionIndexEntry, o as syncDiagramCapabilityPrompt, on as printableChar, or as isRealUserPrompt, ot as toTerminalHyperlink, p as MoonLoader, pn as parseStreamingArgs, pr as isOrphanedToolCallError, pt as handleFusionPlanCommand, q as WelcomeComponent, qn as CLI_UI_MODE, qt as TERMINAL_FOCUS_IN, rr as readSessionIndex, sn as STATUS_BULLET, sr as parseRlmMaxDepthArg, st as changeThinkingLevel, t as dispatchInput, tn as SubagentSlots, tr as normalizeWorkDir, u as hasDispose, un as argsRecord, ur as log, vn as EXIT_CONFIRM_WINDOW_MS, wn as getLlmNotSetMessage, wt as clearInfoPanelState, x as readUpdateCache, xn as TIP_ROTATION_INTERVAL_MS, y as selectUpdateTarget, yn as MAIN_AGENT_ID, z as SkillActivationComponent, zn as loadTuiConfig, zt as DISABLE_TERMINAL_THEME_REPORTING } from "./dispatch-7Mas_Tvb.mjs";
-import { i as t, n as getLocale, r as setLocale } from "./text-input-dialog-gDr3i7xz.mjs";
+import { A as sharedMemoStore } from "./src-ClB_Hzp9.mjs";
+import { $ as clearGoalState, $n as fetchCatalog, $t as isStreaming, A as renderDiffLines, An as isExperimentalFlagEnabled, At as createMarkdownTheme, B as SkillActivationComponent, Bn as TuiLikePreferencesSchema, Bt as DISABLE_TERMINAL_THEME_REPORTING, C as appendJsonlLine, Cn as getCtrlCHint, Ct as refreshProviderBalance, Dn as buildSkillSlashCommands, E as getDaemonInstructions, En as getNoActiveSessionMessage, F as ThinkingComponent, Fn as hasEmbeddingModelCache, Ft as contrastTextHex, G as getSharedSpeedTracker, Gn as getInputHistoryFile, Gt as OSC11_RESPONSE_PREFIX, H as ActivityGroupComponent, Hn as saveTuiConfig, Ht as ENABLE_TERMINAL_THEME_REPORTING, I as NoticeMessageComponent, In as startManualEmbeddingDownload, It as getColorPalette, J as WelcomeComponent, Jn as CLI_COMMAND_NAME, Jt as TERMINAL_FOCUS_IN, K as BackgroundAgentStatusComponent, Kn as getLogDir, Kt as OSC11_RESPONSE_PREFIX_NO_ESC, L as StatusMessageComponent, Ln as PIXEL_PULSE_FRAMES, Lt as detectTerminalTheme, M as highlightLines, Mn as embeddingProgressLabel, Mt as isTurnElapsedEnabled, N as langFromPath, Nn as embeddingFailureDetail, Nt as toggleEmptySessionHint, O as UserMessageComponent, On as BUILTIN_SLASH_COMMANDS, Ot as resolveThemeSync, P as CachedContainer, Pn as getKnowledgeStore, Pt as createThemeStyles, Q as CompactionComponent, Qn as DEFAULT_CATALOG_URL, Qt as isBusy, R as replaceTabs, Rn as PULSE_WAVE_FRAMES, Rt as parseOsc11BackgroundTheme, S as readUpdateCache, Sn as TIP_ROTATION_INTERVAL_MS, Tn as getLlmNotSetMessage, Tt as clearInfoPanelState, U as charsForTokenBudget, Un as detectShellEnvironment, Ut as OSC11_QUERY, V as AssistantMessageComponent, Vn as loadTuiConfig, Vt as ENABLE_TERMINAL_FOCUS_REPORTING, W as estimateTokens, Wn as getDataDir, Wt as OSC11_RESPONSE, X as getBreathingFrame, Xn as CLI_USER_AGENT_PRODUCT, Xt as TERMINAL_THEME_DARK, Y as BREATHE_CYCLE_MS, Yn as CLI_UI_MODE, Yt as TERMINAL_FOCUS_OUT, Z as resetBreathingClock, Zn as PRODUCT_NAME, Zt as TERMINAL_THEME_LIGHT, _n as truncateErrorMessage, _r as SCREAM_ERROR_INFO, a as buildRoleAdditionalText, ar as readSessionIndex, b as selectUpdateTarget, bn as MAIN_AGENT_ID, cn as STATUS_BULLET, cr as isRealUserPrompt, ct as changeThinkingLevel, d as hasDispose, dn as argsRecord, dr as flushDiagnosticLogs, en as FooterComponent, er as saveCatalogCache, et as refineGoal, f as isExpandable, fn as formatErrorMessage, fr as log, gn as stringValue, gr as ErrorCodes, gt as handlePlanCommand, h as formatMemoryMemoForInjection, hn as serializeToolResultOutput, hr as isOrphanedToolCallError, i as openUrl, ir as appendSessionIndexEntry, j as renderDiffLinesClustered, jn as setExperimentalFlags, jt as isEmptySessionHintDismissed, k as ToolCallComponent, kn as sortSlashCommands, kt as createEditorTheme, ln as appendSessionHeaderHint, lr as parseRlmMaxDepthArg, lt as getModelCycleLevel, m as MoonLoader, mn as parseStreamingArgs, mr as isScreamError, mt as handleFusionPlanCommand, n as clearEvalPanelState, nn as SubagentSlots, nr as encodeWorkDirKey, o as writeTextClipboard, or as removeSessionIndexEntry, ot as isInternalMessage, p as isPlanExpandable, pn as isTodoItemShape, pr as resolveGlobalLogPath, q as AgentGroupComponent, qn as detectInstallSource, qt as QUERY_TERMINAL_THEME, rr as normalizeWorkDir, s as syncDiagramCapabilityPrompt, sn as printableChar, st as toTerminalHyperlink, t as dispatchInput, tn as lerpGradient, tr as ScreamHarness, u as disposeChildren, un as appendStreamingArgsPreview, ur as resolveScreamHome, w as readJsonlFile, wn as getCtrlDHint, wt as supportsBalance, x as refreshUpdateCache, xn as SESSION_TIPS, yn as EXIT_CONFIRM_WINDOW_MS, z as sanitizeShellOutput, zn as TuiConfigParseError, zt as DISABLE_TERMINAL_FOCUS_REPORTING } from "./dispatch-BPfUTccZ.mjs";
+import { i as t, n as getLocale, r as setLocale } from "./text-input-dialog-DHDsHCqR.mjs";
 import { createRequire } from "node:module";
 import { randomBytes, randomUUID, scryptSync, timingSafeEqual } from "node:crypto";
 import { access, appendFile, chmod, mkdir, mkdtemp, readFile, readdir, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { Writable } from "node:stream";
 import { WebSocket, WebSocketServer } from "ws";
-import { appendFileSync, constants, existsSync, mkdirSync, readFileSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import * as path$1 from "node:path";
 import path, { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { homedir, networkInterfaces, tmpdir } from "node:os";
@@ -33,7 +33,7 @@ function optionalBuildString(value) {
 	return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 const SCREAM_BUILD_INFO = {
-	version: optionalBuildString("0.18.7"),
+	version: optionalBuildString("0.18.8"),
 	channel: optionalBuildString(""),
 	commit: optionalBuildString(""),
 	buildTarget: optionalBuildString("darwin-arm64")
@@ -948,6 +948,91 @@ function wrapText$1(text, width) {
 	return lines.length > 0 ? lines : [""];
 }
 //#endregion
+//#region src/tui/utils/runtime-marker.ts
+const MARKER_VERSION = 1;
+/** Directory holding one marker per live TUI process. */
+function runtimeMarkerDir(homeDir) {
+	return join(homeDir, "runtime", "instances");
+}
+function markerPath(homeDir, pid) {
+	return join(runtimeMarkerDir(homeDir), `${pid}.json`);
+}
+/** True when `pid` exists and we may signal it (EPERM means it is alive). */
+function isProcessAlive(pid) {
+	if (!Number.isInteger(pid) || pid <= 0) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error?.code === "EPERM";
+	}
+}
+/**
+* Register this process as running. Written atomically (tmp + rename) so a
+* crash mid-write cannot leave a torn JSON file behind.
+*/
+function writeRuntimeMarker(homeDir, info) {
+	mkdirSync(runtimeMarkerDir(homeDir), { recursive: true });
+	const payload = {
+		version: MARKER_VERSION,
+		...info
+	};
+	const target = markerPath(homeDir, info.pid);
+	const staged = `${target}.tmp`;
+	writeFileSync(staged, JSON.stringify(payload), "utf-8");
+	renameSync(staged, target);
+}
+/** Remove this process's marker. Best effort: never blocks shutdown. */
+function clearRuntimeMarker(homeDir, pid = process.pid) {
+	try {
+		rmSync(markerPath(homeDir, pid), { force: true });
+	} catch {}
+}
+/**
+* Collect markers left by processes that are gone, newest first, and delete
+* them. Unreadable files are removed too: they can only be leftovers, and
+* keeping them would make the hint repeat forever.
+*/
+function collectStaleMarkers(homeDir) {
+	const dir = runtimeMarkerDir(homeDir);
+	if (!existsSync(dir)) return [];
+	const stale = [];
+	const now = Date.now();
+	for (const fileName of readdirSync(dir)) {
+		if (fileName.endsWith(".json.tmp")) {
+			const draft = join(dir, fileName);
+			try {
+				if (now - statSync(draft).mtimeMs > 5 * 6e4) rmSync(draft, { force: true });
+			} catch {
+				rmSync(draft, { force: true });
+			}
+			continue;
+		}
+		if (!fileName.endsWith(".json")) continue;
+		const filePath = join(dir, fileName);
+		let marker;
+		try {
+			marker = JSON.parse(readFileSync(filePath, "utf-8"));
+		} catch {
+			rmSync(filePath, { force: true });
+			continue;
+		}
+		if (marker === null || typeof marker !== "object" || typeof marker.pid !== "number" || marker.version !== MARKER_VERSION) {
+			rmSync(filePath, { force: true });
+			continue;
+		}
+		if (isProcessAlive(marker.pid)) continue;
+		stale.push({
+			pid: marker.pid,
+			startedAt: typeof marker.startedAt === "number" ? marker.startedAt : 0,
+			...typeof marker.sessionId === "string" ? { sessionId: marker.sessionId } : {},
+			...typeof marker.title === "string" ? { title: marker.title } : {}
+		});
+		rmSync(filePath, { force: true });
+	}
+	return stale.toSorted((a, b) => b.startedAt - a.startedAt);
+}
+//#endregion
 //#region src/tui/controllers/auth-flow.ts
 var AuthFlowController = class {
 	host;
@@ -10368,116 +10453,6 @@ var QuestionController = class extends ReverseRpcController {
 	}
 };
 //#endregion
-//#region src/utils/clipboard/clipboard-text.ts
-/**
-* Write plain text to the system clipboard with platform-specific commands.
-*
-* scream-core's clipboard layer is read-only (clipboard-native / clipboard-image),
-* so the TUI's "copy selected text" needs its own writer. Used to back the
-* pi-tui `copySelection` hook — return true/false so the TUI can flash
-* "Copied!" or "Copy failed".
-*
-* Platform mapping:
-*   macOS  -> pbcopy
-*   Windows-> powershell Set-Clipboard (base64 payload, avoids quoting issues)
-*   Linux  -> wl-copy (Wayland) / xclip or xsel (X11), tried in a candidate
-*             chain so a missing tool (Ubuntu ships neither by default)
-*             falls through to the next one instead of failing outright.
-*/
-var ClipboardTextError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "ClipboardTextError";
-	}
-};
-const defaultRunCommand = (command, args, input) => {
-	const result = spawnSync(command, args, {
-		input,
-		encoding: "utf8",
-		timeout: 3e3
-	});
-	if (result.status === 0) return { ok: true };
-	return {
-		ok: false,
-		error: result.error?.message ?? result.stderr?.toString() ?? `exit ${result.status}`
-	};
-};
-function detectPlatform() {
-	if (process.platform === "darwin") return "macos";
-	if (process.platform === "win32") return "windows";
-	if (process.platform === "linux") return process.env["WAYLAND_DISPLAY"] ? "linux-wayland" : "linux-x11";
-	return "unsupported";
-}
-function linuxCandidates(platform) {
-	const wl = {
-		command: "wl-copy",
-		args: []
-	};
-	const xclip = {
-		command: "xclip",
-		args: [
-			"-selection",
-			"clipboard",
-			"-i"
-		]
-	};
-	const xsel = {
-		command: "xsel",
-		args: ["--clipboard", "--input"]
-	};
-	return platform === "linux-wayland" ? [
-		wl,
-		xclip,
-		xsel
-	] : [
-		xclip,
-		xsel,
-		wl
-	];
-}
-/**
-* Write `text` to the system clipboard. Throws ClipboardTextError when the
-* platform is unsupported or every candidate command fails, so callers can
-* surface a "Copy failed" indicator.
-*/
-async function writeTextClipboard(text, runCommand = defaultRunCommand) {
-	const platform = detectPlatform();
-	let command;
-	let args;
-	let input;
-	switch (platform) {
-		case "macos":
-			command = "pbcopy";
-			args = [];
-			input = text;
-			break;
-		case "windows": {
-			const base64 = Buffer.from(text, "utf8").toString("base64");
-			command = "powershell";
-			args = [
-				"-NoProfile",
-				"-Command",
-				`[System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${base64}')) | Set-Clipboard`
-			];
-			input = "";
-			break;
-		}
-		case "linux-wayland":
-		case "linux-x11": {
-			const failures = [];
-			for (const candidate of linuxCandidates(platform)) {
-				const result = runCommand(candidate.command, candidate.args, text);
-				if (result.ok) return;
-				failures.push(`${candidate.command}: ${result.error ?? "unknown error"}`);
-			}
-			throw new ClipboardTextError(`failed to copy to clipboard (${failures.join(" | ")}). Install wl-clipboard (Wayland: sudo apt install wl-clipboard) or xclip/xsel (X11: sudo apt install xclip xsel)`);
-		}
-		default: throw new ClipboardTextError(`unsupported clipboard platform: ${process.platform}`);
-	}
-	const result = runCommand(command, args, input);
-	if (!result.ok) throw new ClipboardTextError(`failed to copy to clipboard: ${command} ${result.error ?? "unknown error"}`);
-}
-//#endregion
 //#region src/tui/utils/render-batcher.ts
 function createRenderBatcher(doRender) {
 	let scheduled = false;
@@ -12998,69 +12973,86 @@ function stripLeadingSpace(s) {
 * it as the focused component, and tears it down on the `onClose`
 * callback (fired on Esc / Enter / q).
 */
-/** Static list — keep in sync with the global editor bindings. */
-const DEFAULT_KEYBOARD_SHORTCUTS = [
-	{
-		keys: "Shift-Tab",
-		description: t("help.toggle_plan")
-	},
-	{
-		keys: "Tab",
-		description: t("help.cycle_thinking")
-	},
-	{
-		keys: "Ctrl-G",
-		description: t("help.external_editor")
-	},
-	{
-		keys: "Ctrl-O",
-		description: t("help.toggle_output")
-	},
-	{
-		keys: "Ctrl-E",
-		description: t("help.toggle_plan_view")
-	},
-	{
-		keys: "Ctrl-S",
-		description: t("help.interrupt")
-	},
-	{
-		keys: "Ctrl-X",
-		description: t("help.toggle_sidebar")
-	},
-	{
-		keys: "Ctrl-B",
-		description: t("help.toggle_hint")
-	},
-	{
-		keys: "Ctrl-W",
-		description: t("help.cancel_memory")
-	},
-	{
-		keys: "Shift-Enter / Ctrl-J",
-		description: t("help.newline")
-	},
-	{
-		keys: "Ctrl-C",
-		description: t("help.cancel_stream")
-	},
-	{
-		keys: "Ctrl-D",
-		description: t("help.exit")
-	},
-	{
-		keys: "Esc",
-		description: t("help.close_dialog")
-	},
-	{
-		keys: "↑ / ↓",
-		description: t("help.browse_history")
-	},
-	{
-		keys: "Enter",
-		description: t("help.submit")
-	}
-];
+/**
+* Keyboard shortcut reference — keep in sync with the global editor bindings.
+*
+* A function, not a constant: `t()` must run on every call. As a module-level
+* constant the descriptions were evaluated once at import time and froze to
+* whichever locale happened to be active then, so a Chinese session showed an
+* English shortcut list (and vice versa).
+*/
+function defaultKeyboardShortcuts() {
+	return [
+		{
+			keys: "Shift-Tab",
+			description: t("help.toggle_plan")
+		},
+		{
+			keys: "Tab",
+			description: t("help.cycle_thinking")
+		},
+		{
+			keys: "Ctrl-G",
+			description: t("help.external_editor")
+		},
+		{
+			keys: "Ctrl-O",
+			description: t("help.toggle_output")
+		},
+		{
+			keys: "Ctrl-E",
+			description: t("help.toggle_plan_view")
+		},
+		{
+			keys: "Ctrl-S",
+			description: t("help.interrupt")
+		},
+		{
+			keys: "Ctrl-X",
+			description: t("help.toggle_sidebar")
+		},
+		{
+			keys: "Ctrl-B",
+			description: t("help.toggle_hint")
+		},
+		{
+			keys: "Ctrl-W",
+			description: t("help.cancel_memory")
+		},
+		{
+			keys: "↑",
+			description: t("help.recall_queued")
+		},
+		{
+			keys: "Ctrl-V / Alt-V",
+			description: t("help.paste_image")
+		},
+		{
+			keys: "Shift-Enter / Ctrl-J",
+			description: t("help.newline")
+		},
+		{
+			keys: "Ctrl-C",
+			description: t("help.cancel_stream")
+		},
+		{
+			keys: "Ctrl-D",
+			description: t("help.exit")
+		},
+		{
+			keys: "Esc",
+			description: t("help.close_dialog")
+		},
+		{
+			keys: "↑ / ↓",
+			description: t("help.browse_history")
+		},
+		{
+			keys: "Enter",
+			description: t("help.submit")
+		}
+	];
+}
 var HelpPanelComponent = class extends Container {
 	focused = false;
 	opts;
@@ -13096,33 +13088,42 @@ var HelpPanelComponent = class extends Container {
 		const muted = chalk.hex(colors.textMuted);
 		const kbdColor = chalk.hex(colors.warning);
 		const slashColor = chalk.hex(colors.primary);
-		const shortcuts = this.opts.shortcuts ?? DEFAULT_KEYBOARD_SHORTCUTS;
-		const kbdWidth = Math.max(8, ...shortcuts.map((s) => s.keys.length));
+		const shortcuts = this.opts.shortcuts ?? defaultKeyboardShortcuts();
+		const padToWidth = (text, width) => {
+			const pad = width - visibleWidth(text);
+			return pad > 0 ? text + " ".repeat(pad) : text;
+		};
+		const kbdWidth = Math.max(8, ...shortcuts.map((s) => visibleWidth(s.keys)));
 		const sortedCmds = [...this.opts.commands].toSorted((a, b) => a.name.localeCompare(b.name));
 		const cmdLabels = sortedCmds.map((c) => {
 			const aliases = c.aliases.length > 0 ? ` (${c.aliases.map((a) => "/" + a).join(", ")})` : "";
 			return `/${c.name}${aliases}`;
 		});
 		const cmdWidth = Math.max(12, ...cmdLabels.map((l) => l.length));
+		const hasCommands = sortedCmds.length > 0;
 		const lines = [
 			accent("─".repeat(width)),
-			accent.bold(t("help.title")) + muted(` · ${t("help.close_hint")}`),
-			"",
-			`  ${dim(t("help.welcome_msg"))}`,
-			`  ${muted(t("help.hidden_commands"))}`,
+			accent.bold(this.opts.title ?? t("help.title")) + muted(` · ${t("help.close_hint")}`),
 			"",
+			...hasCommands ? [
+				`  ${dim(t("help.welcome_msg"))}`,
+				`  ${muted(t("help.hidden_commands"))}`,
+				""
+			] : [],
 			`  ${chalk.bold(t("help.shortcuts"))}`,
-			...shortcuts.map((s) => `    ${kbdColor(s.keys.padEnd(kbdWidth))}  ${dim(s.description)}`),
-			"",
-			`  ${chalk.bold(t("help.slash_commands"))}`,
-			...sortedCmds.map((cmd, i) => {
-				return `    ${slashColor((cmdLabels[i] ?? `/${cmd.name}`).padEnd(cmdWidth))}  ${dim(t(cmd.description))}`;
-			}),
+			...shortcuts.map((s) => `    ${kbdColor(padToWidth(s.keys, kbdWidth))}  ${dim(s.description)}`),
 			"",
+			...hasCommands ? [
+				`  ${chalk.bold(t("help.slash_commands"))}`,
+				...sortedCmds.map((cmd, i) => {
+					return `    ${slashColor((cmdLabels[i] ?? `/${cmd.name}`).padEnd(cmdWidth))}  ${dim(t(cmd.description))}`;
+				}),
+				""
+			] : [],
 			accent("─".repeat(width))
 		];
 		const content = lines.slice(1, lines.length - 1);
-		const maxVisible = Math.max(5, this.opts.maxVisible ?? 24);
+		const maxVisible = Math.max(5, this.opts.maxVisible ?? 30);
 		if (content.length > maxVisible) {
 			this.scrollTop = Math.max(0, Math.min(this.scrollTop, content.length - maxVisible));
 			const slice = content.slice(this.scrollTop, this.scrollTop + maxVisible);
@@ -14477,6 +14478,22 @@ var DialogManager = class {
 		this.host.state.activeDialog = null;
 		this.restoreEditor();
 	}
+	showHotkeysPanel() {
+		this.host.state.activeDialog = "hotkeys";
+		this.mountEditorReplacement(new HelpPanelComponent({
+			commands: [],
+			shortcuts: defaultKeyboardShortcuts(),
+			colors: this.host.state.theme.colors,
+			title: t("help.hotkeys_title"),
+			onClose: () => {
+				this.hideHotkeysPanel();
+			}
+		}));
+	}
+	hideHotkeysPanel() {
+		this.host.state.activeDialog = null;
+		this.restoreEditor();
+	}
 	async showSessionPicker() {
 		await this.host.fetchSessions();
 		this.host.state.activeDialog = "session-picker";
@@ -14750,6 +14767,7 @@ var ScreamTUI = class {
 	deferUserMessages = false;
 	aborted = false;
 	isShuttingDown = false;
+	startedAt = Date.now();
 	reverseRpcDisposers = [];
 	startupNotice;
 	/** Interval handle for the periodic provider-balance refresh. */
@@ -14856,6 +14874,8 @@ var ScreamTUI = class {
 			this.lifecycleController.startEventLoop();
 			try {
 				await this.finishStartup(shouldReplayHistory);
+				this.refreshRuntimeMarker();
+				this.reportStaleSessions();
 				this.lifecycleController.startCcConnectPolling();
 				this.startBalancePolling();
 			} catch (error) {
@@ -14940,6 +14960,34 @@ var ScreamTUI = class {
 			throw error;
 		}
 	}
+	/** Keep this instance's crash marker in sync with the running session. */
+	refreshRuntimeMarker() {
+		try {
+			writeRuntimeMarker(getDataDir(), {
+				pid: process.pid,
+				startedAt: this.startedAt,
+				...this.state.appState.sessionId ? { sessionId: this.state.appState.sessionId } : {},
+				...this.state.appState.sessionTitle ? { title: this.state.appState.sessionTitle } : {}
+			});
+		} catch {}
+	}
+	/** Report a previous instance that never shut down, exactly once. */
+	reportStaleSessions() {
+		let stale = [];
+		try {
+			stale = collectStaleMarkers(getDataDir());
+		} catch {
+			return;
+		}
+		const latest = stale[0];
+		if (latest === void 0) return;
+		const label = latest.title ?? (latest.sessionId !== void 0 ? latest.sessionId.slice(0, 8) : "");
+		if (label.length === 0) {
+			this.showNotice(t("tui.crash_recovery_title"));
+			return;
+		}
+		this.showNotice(t("tui.crash_recovery_title"), t("tui.crash_recovery_detail", { title: label }));
+	}
 	async stop(exitCode) {
 		if (this.isShuttingDown) return;
 		this.isShuttingDown = true;
@@ -14960,6 +15008,7 @@ var ScreamTUI = class {
 		this.inputController.dispose();
 		this.state.footer.dispose();
 		this.state.sidebarContainer.dispose();
+		clearRuntimeMarker(getDataDir());
 		await this.closeSession();
 		await this.harness.close();
 		this.sessionEventHandler.stopAllMcpServerStatusSpinners();
@@ -14990,6 +15039,7 @@ var ScreamTUI = class {
 	onEmergencyExit(exitCode = 129) {
 		this.isShuttingDown = true;
 		this.lifecycleController.uninstallSignalHandlers();
+		clearRuntimeMarker(getDataDir());
 		process.exit(exitCode);
 	}
 	stopMemoryIdleTimer() {
@@ -15139,6 +15189,7 @@ var ScreamTUI = class {
 		const planModeChanged = "planMode" in patch && prevPlanMode !== this.state.appState.planMode;
 		const sessionChanged = "sessionId" in patch && this.state.appState.sessionId !== prevSessionId;
 		if (sessionChanged) {
+			this.refreshRuntimeMarker();
 			if (!("sessionUsage" in patch)) this.state.appState.sessionUsage = {
 				inputOther: 0,
 				output: 0,
@@ -15270,7 +15321,7 @@ var ScreamTUI = class {
 		const card = new OnboardingCardComponent({
 			colors: this.state.theme.colors,
 			onConfigure: () => {
-				import("./dispatch-BqBnrIMj.mjs").then(({ handleConnectCommand }) => handleConnectCommand(this, "")).finally(() => {
+				import("./dispatch-zsFzFFoY.mjs").then(({ handleConnectCommand }) => handleConnectCommand(this, "")).finally(() => {
 					this.restoreEditor();
 					onDone?.();
 				});
@@ -15308,7 +15359,9 @@ var ScreamTUI = class {
 					let error;
 					let failureKind;
 					try {
-						({ok, error, failureKind} = await startManualEmbeddingDownload());
+						({ok, error, failureKind} = await startManualEmbeddingDownload((progress) => {
+							spinner.setLabel(embeddingProgressLabel(progress));
+						}));
 					} catch (error) {
 						error = error instanceof Error ? error.message : String(error);
 					}
@@ -15396,6 +15449,9 @@ var ScreamTUI = class {
 	showHelpPanel() {
 		this.dialogManager.showHelpPanel(this.getSlashCommands());
 	}
+	showHotkeysPanel() {
+		this.dialogManager.showHotkeysPanel();
+	}
 	hideHelpPanel() {
 		this.dialogManager.hideHelpPanel();
 	}