pi-crew 0.10.6 → 0.11.0

package/src/ui/dashboard-panes/agents-pane.ts

@@ -34,7 +34,7 @@ function alignMetric(value: string, width: number): string {
  * Scaffold-only agents (no tokens, no tools, no turns) are skipped in the agents pane —
  * they represent pipeline infrastructure steps, not actual agent execution.
  */
-function isRealAgent(agent: CrewAgentRecord, liveHandle?: LiveAgentHandle): boolean {
+function isRealAgent(agent: CrewAgentRecord, liveHandle?: LiveAgentHandle, nowMs?: number): boolean {
 	if (agent.runtime === "live-session" || agent.runtime === "child-process") return true;
 	// Scaffold agents with real work done are still worth showing
 	const tokens = (agent.usage?.input ?? 0) + (agent.usage?.output ?? 0) + (agent.usage?.cacheRead ?? 0) + (agent.usage?.cacheWrite ?? 0);
@@ -44,7 +44,7 @@ function isRealAgent(agent: CrewAgentRecord, liveHandle?: LiveAgentHandle): bool
 	if ((agent.progress?.toolCount ?? 0) > 0) return true;
 	// If it's still running and has been alive for > 30s, it might be real
 	if (liveHandle) {
-		const ms = Date.now() - liveHandle.activity.startedAtMs;
+		const ms = (nowMs ?? Date.now()) - liveHandle.activity.startedAtMs;
 		if (ms > 30_000) return true;
 	}
 	return false;
@@ -86,11 +86,14 @@ export function renderAgentsPane(snapshot: RunUiSnapshot | undefined, options: R
 	const { completed, total } = snapshot.progress;
 
 	const lines: string[] = [];
+	// One pinned clock (D6-T4) for the whole pane render.
+	const nowMs = options.nowMs ?? Date.now();
 
 	const realAgents = snapshot.agents.filter((a) =>
 		isRealAgent(
 			a,
 			liveForRun.find((h) => h.taskId === a.taskId),
+			nowMs,
 		),
 	);
 	const lineCount = Math.min(realAgents.length, 12);
@@ -141,13 +144,13 @@ export function renderAgentsPane(snapshot: RunUiSnapshot | undefined, options: R
 			// 0/undefined/bad, or a race set completedAtMs < startedAtMs. This
 			// fired for EVERY running live agent in the dashboard. Use the shared,
 			// validated computeLiveDurationMs (mirrors widget-formatters.ts).
-			const ms = computeLiveDurationMs(liveHandle.activity);
+			const ms = computeLiveDurationMs(liveHandle.activity, nowMs);
 			stats.push(alignMetric(`${(ms / 1000).toFixed(1)}s`, DURATION_METRIC_WIDTH));
 			if (options.showModel !== false && liveHandle.modelName && liveHandle.modelName !== "default") {
 				stats.push(liveHandle.modelName);
 			}
 		} else if (agent.startedAt) {
-			const ms = Date.now() - new Date(agent.startedAt).getTime();
+			const ms = nowMs - new Date(agent.startedAt).getTime();
 			if (Number.isFinite(ms)) stats.push(alignMetric(`${(ms / 1000).toFixed(1)}s`, DURATION_METRIC_WIDTH));
 		}
 

package/src/ui/dashboard-panes/schedules-pane.ts

@@ -0,0 +1,154 @@
+import { humanizeSchedule, type ScheduledJob } from "../../runtime/scheduling/scheduler.ts";
+import { formatRelativeTime } from "../../utils/relative-time.ts";
+import { sanitizeLine, truncate } from "../../utils/visual.ts";
+
+/**
+ * Schedules pane (tier A foundation) — pure string[] renderer following
+ * health-pane.ts conventions: no clock reads (D6-T4 — `now` is an injected,
+ * REQUIRED parameter), no color (the dashboard colorizes/truncates lines at
+ * the emit pipeline), no provider import (callers pass jobs read via
+ * getScheduledJobs() — the single source of truth, G17).
+ */
+export interface SchedulesPaneOptions {
+	/** Max visual width of the job-name column before truncation. */
+	nameWidth?: number;
+	/** Show the interactive key hint (T/N/V/X/R). Dashboard-only; the headless
+	 *  text block and non-foreground contexts pass false. Default true. */
+	foreground?: boolean;
+	/** Include the full job id in the sub line. The headless `/schedules`
+	 *  text block needs ids so users can address jobs in `subAction=...` and
+	 *  `/schedules log`. Default false. */
+	includeIds?: boolean;
+	/** Index of the cursor-selected job (dashboard pane 8). Prefixes the main
+	 *  line with `›` exactly like the run-list selection marker; undefined
+	 *  (headless / text-block callers) renders no marker. */
+	selectedIndex?: number;
+	/** P2-1 (B2 gate visibility): how many project-tier scheduledJobs the opt-in
+	 *  gate is hiding. > 0 renders EXACTLY ONE dim hint line (why + count + the
+	 *  opt-in path: BOTH flags in the USER-tier ~/.pi/crew-settings.json).
+	 *  Omitted/0 renders nothing — existing layouts stay byte-identical. */
+	hiddenCount?: number;
+}
+
+export const SCHEDULES_EMPTY_STATE = "No scheduled jobs — create via team tool action='schedule'";
+
+/** P2-1 hint line (single source of truth — pane table, empty state, and the
+ *  headless /schedules text block all render THIS text). Empty string when
+ *  there is nothing to hint (callers render no line). Pure: no clock, no I/O;
+ *  the count comes from the caller's provider read. */
+export function schedulesHiddenJobsHintLine(hiddenCount: number): string {
+	if (!Number.isFinite(hiddenCount) || hiddenCount <= 0) return "";
+	const n = Math.floor(hiddenCount);
+	return `⚠ ${n} project-tier job${n === 1 ? "" : "s"} hidden — opt in via ~/.pi/crew-settings.json: schedulingEnabled + allowProjectScheduledJobs`;
+}
+
+/**
+ * Render the schedules table: one main line per job
+ * (●/○ enabled · name · humanizeSchedule · next-run RELATIVE · last status
+ * ✓/✗/⟳ · runCount) plus a sub line (subagentType · lastRun · id when
+ * includeIds). Empty state is a single shared line.
+ */
+export function renderSchedulesPane(jobs: ScheduledJob[], now: Date, opts: SchedulesPaneOptions = {}): string[] {
+	const hint = schedulesHiddenJobsHintLine(opts.hiddenCount ?? 0);
+	if (jobs.length === 0) {
+		// P2-1: the all-hidden case is exactly when a bare empty state lied —
+		// the hint below it is the only signal project-tier jobs exist.
+		return hint ? [SCHEDULES_EMPTY_STATE, hint] : [SCHEDULES_EMPTY_STATE];
+	}
+	const lines = [`Scheduled jobs (${jobs.length}):`];
+	for (const [index, job] of jobs.entries()) {
+		lines.push(...renderJobLines(job, now, opts, index === opts.selectedIndex));
+	}
+	if (hint) lines.push(hint);
+	if (opts.foreground !== false) {
+		lines.push("Actions: T toggle · N run now · V details · X delete · R refresh");
+	}
+	return lines;
+}
+
+/**
+ * Plain text-block variant for the headless `/schedules` command (tier E).
+ * Reuses the SAME renderer (no copied table logic): identical table + empty
+ * state, interactive keys swapped for the non-interactive manage hint, and
+ * job ids included so headless users can address them.
+ */
+export function renderSchedulesTextBlock(jobs: ScheduledJob[], now: Date, opts: SchedulesPaneOptions = {}): string[] {
+	const lines = renderSchedulesPane(jobs, now, { ...opts, foreground: false, includeIds: true });
+	if (jobs.length > 0) {
+		lines.push("Manage: team action='schedule' subAction='enable|disable|remove|run-now' jobId='<id>'");
+	}
+	return lines;
+}
+
+function renderJobLines(job: ScheduledJob, now: Date, opts: SchedulesPaneOptions, selected: boolean): string[] {
+	const glyph = job.enabled ? "●" : "○";
+	const name = truncate(sanitizeLine(job.name), opts.nameWidth ?? 28);
+	// The humanized schedule embeds the RAW job.schedule ("cron …"/"once at …")
+	// — same untrusted persisted field the details view sanitizes, so the
+	// main line gets the identical treatment (headless /schedules notify path
+	// applies NO downstream sanitization — security review F-1).
+	const schedule = sanitizeLine(humanizeSchedule({ kind: job.scheduleType, spec: job.schedule }));
+	const next = job.nextRun ? formatRelativeTime(now, new Date(job.nextRun)) : "—";
+	// Cursor marker (dashboard pane 8): `›` on the selected job, two spaces on
+	// the others — mirroring runLabel's `›`/space marker. Callers that pass NO
+	// selectedIndex (headless text block, foundation tests) get the marker-free
+	// legacy layout byte-for-byte.
+	const marker = opts.selectedIndex === undefined ? "" : selected ? "› " : "  ";
+	const main = `${marker}${glyph} ${name}  ${schedule} · ${next} · ${statusGlyph(job.lastStatus)} · ${job.runCount} runs`;
+	return [main, renderSubLine(job, now, opts)];
+}
+
+function statusGlyph(status: ScheduledJob["lastStatus"]): string {
+	if (status === "success") return "✓";
+	if (status === "error") return "✗";
+	if (status === "running") return "⟳";
+	return "·";
+}
+
+function renderSubLine(job: ScheduledJob, now: Date, opts: SchedulesPaneOptions): string {
+	// Security review F-1: every persisted-field interpolation is sanitized —
+	// the dashboard emit pipeline sanitizes whole lines, but the headless
+	// /schedules text block goes to ui.notify verbatim, and subagentType/id
+	// from a crafted settings entry must not inject line breaks there.
+	const parts = [sanitizeLine(job.subagentType)];
+	parts.push(job.lastRun ? `last: ${formatRelativeTime(now, new Date(job.lastRun))}` : "last: never");
+	// Duration: rendered only when the job model carries one ("duration if
+	// available" in the approved design). ScheduledJob has no duration field
+	// today, so nothing is invented here — a future field slots in below.
+	if (opts.includeIds) parts.push(`id: ${sanitizeLine(job.id)}`);
+	return `  ◦ ${parts.join(" · ")}`;
+}
+
+/** Extract the full scheduling goal from a job's prompt payload. The create
+ *  path stores `{ action: 'run', team, goal }` as JSON; older/foreign jobs may
+ *  carry free text — fall back to description, then name. */
+function scheduleGoalOf(job: ScheduledJob): string {
+	try {
+		const parsed = JSON.parse(job.prompt) as { goal?: unknown };
+		if (parsed && typeof parsed === "object" && typeof parsed.goal === "string" && parsed.goal.length > 0) {
+			return parsed.goal;
+		}
+	} catch {
+		/* prompt is not JSON — fall through */
+	}
+	return job.description || job.name;
+}
+
+/**
+ * Details view for ONE job (dashboard pane 8, key V): full goal + schedule
+ * spec + spawnedRunIds — everything the approved design lists for "details".
+ * Pure, clock-injected (D6-T4), plain string[] like the table renderer; the
+ * dashboard emit pipeline truncates/sanitizes per line.
+ */
+export function renderScheduleDetails(job: ScheduledJob, now: Date): string[] {
+	const schedule = humanizeSchedule({ kind: job.scheduleType, spec: job.schedule });
+	const next = job.nextRun ? formatRelativeTime(now, new Date(job.nextRun)) : "—";
+	const last = job.lastRun ? formatRelativeTime(now, new Date(job.lastRun)) : "never";
+	return [
+		`▸ ${sanitizeLine(job.name)} — id ${sanitizeLine(job.id)}`,
+		`  goal: ${sanitizeLine(scheduleGoalOf(job))}`,
+		`  schedule: ${sanitizeLine(job.schedule)} (${sanitizeLine(job.scheduleType)}) · humanized: ${sanitizeLine(schedule)} · next: ${next}`,
+		`  agent: ${sanitizeLine(job.subagentType)} · runs: ${job.runCount} · last: ${last} · status: ${statusGlyph(job.lastStatus)}`,
+		`  spawned runs: ${job.spawnedRunIds?.length ? job.spawnedRunIds.map(sanitizeLine).join(", ") : "none"}`,
+	];
+}

package/src/ui/inline-panel/crew-editor.ts

@@ -42,6 +42,11 @@ export interface CrewEditorOptions {
 	onSteer: (target: PanelTarget, message: string) => void;
 	/** `x`: cancel a running agent's run, or dismiss a finished one. */
 	onAct: (target: PanelTarget, finished: boolean) => void;
+	/** Idle `↓`+`enter` at the MAIN row opens the Agents & Jobs browser —
+	 * the one-keystroke entry from the widget's status line (maintainer
+	 * design 2026-09-14: counts row → ↓ → enter → browser popup). When
+	 * absent, main-row enter stays a no-op (legacy behavior). */
+	onOpenBrowser?: () => void;
 }
 
 export class CrewInlineEditor extends CustomEditor {
@@ -86,6 +91,9 @@ export class CrewInlineEditor extends CustomEditor {
 				const target = result.action.target;
 				if (target) this.options.onOpenPane(target);
 				else if (closePaneOnMain) this.options.onClosePane();
+				// Idle `enter` at the MAIN row = the browser entry (↓ + enter from
+				// the status line). Legacy no-op preserved when unwired.
+				else this.options.onOpenBrowser?.();
 				return;
 			}
 			case "act": {
@@ -152,12 +160,15 @@ export class CrewInlineEditor extends CustomEditor {
 		}
 
 		// ── Idle: `↓` on an empty prompt enters the panel ──────────────────
+		// The browser extends the entry to the jobs-only state: `↓` works even
+		// with zero agent rows when the browser is wired (the state machine
+		// already lands at `main`; `enter` there opens the browser).
 		if (getPanelSelection() === null) {
-			if (matchesKey(data, "down") && this.getText() === "" && rows.length > 0) {
-				// dispatch enters at the MAIN row; the widget renders that row
-				// with its own ❯ marker so the very first press is visible
-				// (pi-subtask's selectRow(rows, 0)).
-				const result = dispatchPanelKey(this.panelKeys(data), rows, null);
+			if (matchesKey(data, "down") && this.getText() === "" && (rows.length > 0 || this.options.onOpenBrowser)) {
+				// SINGLE-LINE WIDGET: dispatch over EMPTY rows — the cursor
+				// lands on the ONE status line (rendered with its own ❯
+				// prefix by the widget), never on invisible agent rows.
+				const result = dispatchPanelKey(this.panelKeys(data), [], null);
 				setPanelSelection(result.selection);
 				return;
 			}
@@ -166,7 +177,9 @@ export class CrewInlineEditor extends CustomEditor {
 		}
 
 		// ── Navigating: consume or fall through ────────────────────────────
-		this.applyDispatch(data, rows, this.panelKeys(data), false);
+		// SINGLE-LINE WIDGET: navigating over [] keeps the cursor on the one
+		// status line (main); enter opens the browser, escape/up returns.
+		this.applyDispatch(data, [], this.panelKeys(data), false);
 	}
 
 	/**

package/src/ui/inline-panel/index.ts

@@ -237,6 +237,12 @@ export function installInlinePanel(pi: ExtensionAPI, ctx: ExtensionContext, uiCo
 					onScrollPane: (delta) => livePane?.scrollBy(delta),
 					onSteer: (target, message) => void steerAgent(ctx, target, message),
 					onAct: (target, finished) => void actOnAgent(ctx, target, finished),
+					// ↓ + enter at the main row = the Agents & Jobs browser
+					// (lazy import: viewers.ts pulls the state-store chain and must stay
+					// off this module's startup path — AGENTS.md lazy boundary).
+					onOpenBrowser: () => {
+						void import("../../extension/registration/viewers.ts").then((m) => m.openAgentsJobsBrowser(ctx));
+					},
 				});
 			});
 			editorInstalled = true;

package/src/ui/key-utils.ts

@@ -17,6 +17,9 @@ import { type KeyId, matchesKey } from "@earendil-works/pi-tui";
 
 export type PiKeyName = KeyId | string;
 
+/** Re-exported so overlays can import the normalizer from one place. */
+export { matchesKey };
+
 const COMMON_IDS: readonly KeyId[] = [
 	"up",
 	"down",

package/src/ui/keybinding-map.ts

@@ -45,6 +45,7 @@ export const DASHBOARD_KEYS = {
 		liveConversation: ["V"],
 		reload: ["r"],
 		progressToggle: ["p"],
+		browser: ["b"],
 	},
 	pane: {
 		agents: ["1"],
@@ -54,6 +55,7 @@ export const DASHBOARD_KEYS = {
 		health: ["5"],
 		metrics: ["6"],
 		plan: ["7"],
+		schedules: ["8"],
 	},
 	navigation: { up: ["k", "up"], down: ["j", "down"] },
 	mailbox: {
@@ -66,6 +68,8 @@ export const DASHBOARD_KEYS = {
 	},
 	health: { recovery: ["R"], killStale: ["K"], diagnosticExport: ["D"] },
 	plan: { approve: ["A"], deny: ["n"], diff: ["X"] },
+	/** Tier A (schedules pane, pane 8): pane-scoped action keys. */
+	schedules: { toggle: ["T"], runNow: ["N"], details: ["V"], delete: ["X"], refresh: ["R"] },
 	notification: { dismissAll: ["H"] },
 } as const;
 
@@ -73,7 +77,7 @@ export const DASHBOARD_KEYS = {
  * Pane identifiers that can scope a binding. `undefined` means the binding
  * fires in every pane.
  */
-export type ActivePane = "agents" | "progress" | "mailbox" | "output" | "health" | "metrics" | "plan";
+export type ActivePane = "agents" | "progress" | "mailbox" | "output" | "health" | "metrics" | "plan" | "schedules";
 
 /**
  * A single keybinding: the keys that trigger it, the action it produces, and
@@ -103,6 +107,7 @@ export type DashboardKeyAction =
 	| "live-conversation"
 	| "reload"
 	| "progressToggle"
+	| "browser"
 	| "pane-agents"
 	| "pane-progress"
 	| "pane-mailbox"
@@ -110,7 +115,13 @@ export type DashboardKeyAction =
 	| "pane-health"
 	| "pane-metrics"
 	| "pane-plan"
+	| "pane-schedules"
 	| "plan-diff"
+	| "schedule-toggle"
+	| "schedule-run-now"
+	| "schedule-details"
+	| "schedule-delete"
+	| "schedule-refresh"
 	| "up"
 	| "down"
 	| "mailbox-detail"
@@ -132,9 +143,12 @@ export type DashboardKeyAction =
  *   2. `mailbox-detail` (\r, \n) is pane-scoped to mailbox and MUST precede
  *      `select` (which also binds \r, \n) so Enter opens the detail instead of
  *      triggering select while in the mailbox pane.
- *   3. `health-*` and `plan-*` are pane-scoped (health / progress).
+ *   3. `health-*`, `schedule-*`, and `plan-*` are pane-scoped (health /
+ *      schedules / progress+plan).
  *   4. `notifications-dismiss` (H) is global.
  *   5. `select`, then the root actions, pane switches, and navigation.
+ *   6. `schedule-*` V precedes the unscoped root `liveConversation` (V) so the
+ *      schedules-scoped binding wins first-match-wins in pane 8.
  *
  * NOTE: mailbox action keys A/N/C/P/X (ack/nudge/compose/preview/ackAll) are
  * intentionally NOT dispatched for the mailbox pane by this table. They live
@@ -167,6 +181,39 @@ const DEFAULT_BINDINGS: readonly KeyBinding[] = [
 		action: "health-diagnostic-export",
 		pane: "health",
 	},
+	// Tier A: schedules-pane action keys (pane 8). ALL pane-scoped so they
+	// never leak into other panes. Collision analysis (explorer-verified):
+	//   T — unbound elsewhere; N — mailbox.nudge is overlay-owned, NOT dispatched
+	//   here; X — plan.diff is plan-scoped, mailbox.ackAll overlay-owned; R —
+	//   health.recovery is health-scoped; V — COLLIDES with the unscoped root
+	//   liveConversation ["V"]: this entry MUST stay above it (first-match-wins
+	//   pass-1 honors table order after paneScopeMatches), so V = details in
+	//   the schedules pane and live-conversation everywhere else.
+	{
+		keys: DASHBOARD_KEYS.schedules.toggle,
+		action: "schedule-toggle",
+		pane: "schedules",
+	},
+	{
+		keys: DASHBOARD_KEYS.schedules.runNow,
+		action: "schedule-run-now",
+		pane: "schedules",
+	},
+	{
+		keys: DASHBOARD_KEYS.schedules.details,
+		action: "schedule-details",
+		pane: "schedules",
+	},
+	{
+		keys: DASHBOARD_KEYS.schedules.delete,
+		action: "schedule-delete",
+		pane: "schedules",
+	},
+	{
+		keys: DASHBOARD_KEYS.schedules.refresh,
+		action: "schedule-refresh",
+		pane: "schedules",
+	},
 	{
 		keys: DASHBOARD_KEYS.plan.approve,
 		action: "plan-approve",
@@ -199,6 +246,11 @@ const DEFAULT_BINDINGS: readonly KeyBinding[] = [
 	{ keys: DASHBOARD_KEYS.root.liveConversation, action: "live-conversation" },
 	{ keys: DASHBOARD_KEYS.root.reload, action: "reload" },
 	{ keys: DASHBOARD_KEYS.root.progressToggle, action: "progressToggle" },
+	// Agents & Jobs browser (one-keypress overlay, mirrors live-conversation).
+	// Collision analysis: "b" is unbound everywhere else — root-unscoped is
+	// safe; inside the browser overlay itself "p" is free because overlays
+	// are mutually exclusive (see keybinding-map.ts header note).
+	{ keys: DASHBOARD_KEYS.root.browser, action: "browser" },
 	{ keys: DASHBOARD_KEYS.pane.agents, action: "pane-agents" },
 	{ keys: DASHBOARD_KEYS.pane.progress, action: "pane-progress" },
 	{ keys: DASHBOARD_KEYS.pane.mailbox, action: "pane-mailbox" },
@@ -206,6 +258,7 @@ const DEFAULT_BINDINGS: readonly KeyBinding[] = [
 	{ keys: DASHBOARD_KEYS.pane.health, action: "pane-health" },
 	{ keys: DASHBOARD_KEYS.pane.metrics, action: "pane-metrics" },
 	{ keys: DASHBOARD_KEYS.pane.plan, action: "pane-plan" },
+	{ keys: DASHBOARD_KEYS.pane.schedules, action: "pane-schedules" },
 	{ keys: DASHBOARD_KEYS.navigation.up, action: "up" },
 	{ keys: DASHBOARD_KEYS.navigation.down, action: "down" },
 ];
@@ -230,6 +283,7 @@ const KEY_RESERVED = new Set<string>([
 	...Object.values(DASHBOARD_KEYS.mailbox).flat(),
 	...Object.values(DASHBOARD_KEYS.health).flat(),
 	...Object.values(DASHBOARD_KEYS.plan).flat(),
+	...Object.values(DASHBOARD_KEYS.schedules).flat(),
 	...Object.values(DASHBOARD_KEYS.notification).flat(),
 ]);
 

package/src/ui/mascot.ts

@@ -1,3 +1,4 @@
+import { matchesKey } from "@earendil-works/pi-tui";
 import { pad } from "../utils/visual.ts";
 import { DynamicCrewBorder } from "./dynamic-border.ts";
 import type { CrewTheme } from "./theme-adapter.ts";
@@ -423,7 +424,7 @@ export class AnimatedMascot {
 	}
 
 	handleInput(data: string): void {
-		if (data === "q" || data === "\u001b" || data === "\u0003") {
+		if (matchesKey(data, "q") || matchesKey(data, "escape") || data === "\u0003") {
 			this.close();
 		}
 	}

package/src/ui/overlays/agent-picker-overlay.ts

@@ -2,7 +2,7 @@ import { readCrewAgents } from "../../runtime/crew-agent-records.ts";
 import type { CrewAgentRecord } from "../../runtime/crew-agent-runtime.ts";
 import { loadRunManifestById } from "../../state/stores/state-store.ts";
 import { pad, truncate } from "../../utils/visual.ts";
-import { keyOf } from "../key-utils.ts";
+import { keyOf, matchesKey } from "../key-utils.ts";
 import { asCrewTheme, type CrewTheme } from "../theme-adapter.ts";
 
 export interface AgentPickerSelection {
@@ -46,7 +46,7 @@ export class AgentPickerOverlay {
 	}
 
 	handleInput(data: string): void {
-		if (data === "\u001b" || data === "q") {
+		if (matchesKey(data, "escape") || data === "q") {
 			this.done(undefined);
 			return;
 		}
@@ -58,7 +58,7 @@ export class AgentPickerOverlay {
 			this.selected = Math.min(Math.max(0, this.agents.length - 1), this.selected + 1);
 			return;
 		}
-		if (data === "\r" || data === "\n") {
+		if (matchesKey(data, "return")) {
 			const agent = this.agents[this.selected];
 			this.done(agent ? { agentId: agent.taskId } : undefined);
 		}

package/src/ui/overlays/confirm-overlay.ts

@@ -1,4 +1,5 @@
 import { pad, truncate } from "../../utils/visual.ts";
+import { matchesKey } from "../key-utils.ts";
 import { Box, Text } from "../layout-primitives.ts";
 import { asCrewTheme, type CrewTheme } from "../theme-adapter.ts";
 
@@ -51,10 +52,10 @@ export class ConfirmOverlay {
 			this.done(true);
 			return;
 		}
-		if ((data === "\r" || data === "\n") && this.opts.defaultAction === "confirm") {
+		if (matchesKey(data, "return") && this.opts.defaultAction === "confirm") {
 			this.done(true);
 			return;
 		}
-		if (data === "n" || data === "N" || data === "\u001b" || data === "q" || data === "\r" || data === "\n") this.done(false);
+		if (data === "n" || data === "N" || matchesKey(data, "escape") || data === "q" || matchesKey(data, "return")) this.done(false);
 	}
 }

package/src/ui/overlays/mailbox-compose-overlay.ts

@@ -1,5 +1,6 @@
 import type { MailboxDirection } from "../../state/coordination/mailbox.ts";
 import { pad, truncate } from "../../utils/visual.ts";
+import { matchesKey } from "../key-utils.ts";
 import { asCrewTheme, type CrewTheme } from "../theme-adapter.ts";
 import { ConfirmOverlay } from "./confirm-overlay.ts";
 import { renderComposePreview } from "./mailbox-compose-preview.ts";
@@ -150,7 +151,7 @@ export class MailboxComposeOverlay {
 			this.confirm.handleInput(data);
 			return;
 		}
-		if (data === "\u001b") {
+		if (matchesKey(data, "escape")) {
 			this.cancel();
 			return;
 		}
@@ -167,11 +168,11 @@ export class MailboxComposeOverlay {
 			else this.appendText(data);
 			return;
 		}
-		if (data === "\b" || data === "\u007f") {
+		if (matchesKey(data, "backspace")) {
 			this.backspace();
 			return;
 		}
-		if (data === "\r" || data === "\n") {
+		if (matchesKey(data, "return")) {
 			if (this.activeName() === "body" || this.fields.body.trim()) this.submit();
 			else this.activeField = (this.activeField + 1) % FIELD_ORDER.length;
 			return;

package/src/ui/overlays/mailbox-detail-overlay.ts

@@ -1,7 +1,7 @@
 import { type MailboxMessage, readDeliveryState, readMailbox } from "../../state/coordination/mailbox.ts";
 import { loadRunManifestById } from "../../state/stores/state-store.ts";
 import { pad, truncate } from "../../utils/visual.ts";
-import { keyOf } from "../key-utils.ts";
+import { keyOf, matchesKey } from "../key-utils.ts";
 import { asCrewTheme, type CrewTheme } from "../theme-adapter.ts";
 
 export type MailboxAction =
@@ -113,7 +113,7 @@ export class MailboxDetailOverlay {
 	}
 
 	handleInput(data: string): void {
-		if (data === "\u001b" || data === "q") {
+		if (matchesKey(data, "escape") || data === "q") {
 			this.done({ type: "close" });
 			return;
 		}
@@ -130,7 +130,7 @@ export class MailboxDetailOverlay {
 			this.selected = Math.min(Math.max(0, this.current().length - 1), this.selected + 1);
 			return;
 		}
-		if (data === "\r" || data === "\n") {
+		if (matchesKey(data, "return")) {
 			this.expanded = !this.expanded;
 			return;
 		}