@oh-my-pi/pi-tui 18.5.1 → 18.6.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [18.6.0] - 2026-10-03
+
+### Fixed
+
+- Fixed Alt+Up (restore queued steering), arrows and other escape-sequence keys on Windows acting as Esc (interrupting the turn) and typing `[1;3A` into the editor when the console host relays them one byte at a time ([#14216](https://github.com/can1357/oh-my-pi/pull/14216) by [@H4vC](https://github.com/H4vC)).
+
 ## [18.5.1] - 2026-10-03
 
 ### Added

package/dist/types/components/editor.d.ts

@@ -138,6 +138,9 @@ export declare class Editor implements Component, Focusable {
     onLargePaste?: (text: string, lineCount: number, options: PasteOptions) => boolean;
     onAutocompleteCancel?: () => void;
     disableSubmit: boolean;
+    /** Base editors accept native edits, not atomic sends. Implementations that
+     *  handle `send` override this readiness check for their submission path. */
+    protected get nativeSendable(): boolean;
     /** Placeholder painted right-aligned on the cursor row while the editor is empty and no
      *  autocomplete is open; hidden when it can't keep {@link PLACEHOLDER_MIN_GAP} cells from the
      *  cursor. The host styles it (ANSI allowed). Re-evaluated on every render, so hosts can derive

package/dist/types/overlays/model-hub.d.ts

@@ -12,6 +12,14 @@ export interface ModelHubSource extends ModelBrowserSource {
     getProjectModelRole(role: string): string | undefined;
     getGlobalModelRole(role: string): string | undefined;
     getModelRoleSource(role: string): "global" | "project" | "default";
+    /**
+     * Saved model presets (in switch order) and the one the current role setup
+     * matches, if any. Absent hosts have no presets to switch between.
+     */
+    getModelPresets?(): {
+        names: readonly string[];
+        active: string | undefined;
+    };
 }
 /** Catalog capabilities required by the model hub. */
 export interface ModelHubRegistry extends ModelBrowserRegistry {
@@ -48,6 +56,12 @@ export interface ModelHubCallbacks {
     onLoginRequest?: (providerId: string) => void;
     /** Save the current role assignments and default thinking level as a named model preset. */
     onSavePreset?: (name: string) => void;
+    /**
+     * Apply a saved model preset (ctrl+←/→ or p/⇧P in the Roles view) and report
+     * the outcome itself. A switch that writes nothing (a refused preset) still
+     * advances the hub's preset cursor, so the next press moves past it.
+     */
+    onSwitchPreset?: (name: string) => void | Promise<void>;
     /** Persist a new quick-switch cycle order (the ctrl+p role cycle). */
     onCycleOrderChange?: (order: string[]) => void;
     onCancel: () => void;

package/dist/types/prompt/custom-editor.d.ts

@@ -213,6 +213,8 @@ export declare class CustomEditor extends Editor {
      *  once after construction (and again after `setEditorComponent` swaps the
      *  editor). Passing `undefined` clears any pending frame. */
     setShimmerRepaintHandler(handler: (() => void) | undefined): void;
+    /** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled. */
+    protected get nativeSendable(): boolean;
     /** Viewing a subagent, the draft goes to it: the placeholder names it. */
     describePlaceholder: () => string;
     /** A shell-mode draft highlights as its language. */

package/dist/types/windows-input-mode.d.ts

@@ -16,10 +16,26 @@
  * terminal sends; chords legacy encoding loses (modified Enter/Tab/Escape,
  * Ctrl+Shift+letter, …) translate to kitty CSI-u, which key matching already
  * parses.
+ *
+ * A host terminal that writes VT instead of key records (any ConPTY host
+ * besides Windows Terminal's native path) reaches us as one `Vk = 0` text
+ * record per byte: Alt+Up arrives as `ESC`, `[`, `1`, `;`, `3`, `A`. Those
+ * bytes are reassembled into the escape sequence they spell; delivering them
+ * one at a time turns every such key into a bare Escape plus typed garbage.
+ */
+/**
+ * Stateful decoder: joins UTF-16 surrogate halves that arrive as separate
+ * records, and reassembles VT escape sequences relayed as text records.
  */
-/** Stateful decoder: joins UTF-16 surrogate halves that arrive as separate records. */
 export declare class Win32InputModeDecoder {
     #private;
+    /** Whether relayed VT text is held waiting for the rest of its sequence. */
+    get hasPendingSequence(): boolean;
+    /**
+     * Release held VT text as-is. The caller invokes this once no further bytes
+     * arrived in time, so a lone relayed ESC still acts as the Escape key.
+     */
+    flushPendingSequence(): string[];
     /**
      * Translate one stdin sequence. Returns `undefined` when `data` is not a
      * win32-input-mode record (pass it through unchanged), otherwise the key
@@ -42,7 +58,11 @@ export declare class Win32InputModeDecoder {
  */
 export declare class Win32PasteMarkerNormalizer {
     #private;
-    constructor(onInput: (data: string) => void);
+    /**
+     * `onExpired` runs after held records are released because their wait timed
+     * out, so a downstream holder can treat the same wait as already elapsed.
+     */
+    constructor(onInput: (data: string) => void, onExpired?: () => void);
     process(data: string): void;
     /** Release an incomplete marker as its original key records. */
     flush(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.5.1",
+	"version": "18.6.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.5.1",
-		"@oh-my-pi/pi-agent-core": "18.5.1",
-		"@oh-my-pi/pi-ai": "18.5.1",
-		"@oh-my-pi/pi-catalog": "18.5.1",
-		"@oh-my-pi/pi-natives": "18.5.1",
-		"@oh-my-pi/pi-utils": "18.5.1",
-		"@oh-my-pi/pi-wire": "18.5.1",
-		"@oh-my-pi/snapcompact": "18.5.1"
+		"@oh-my-pi/omptype": "18.6.0",
+		"@oh-my-pi/pi-agent-core": "18.6.0",
+		"@oh-my-pi/pi-ai": "18.6.0",
+		"@oh-my-pi/pi-catalog": "18.6.0",
+		"@oh-my-pi/pi-natives": "18.6.0",
+		"@oh-my-pi/pi-utils": "18.6.0",
+		"@oh-my-pi/pi-wire": "18.6.0",
+		"@oh-my-pi/snapcompact": "18.6.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/components/editor.ts

@@ -754,6 +754,11 @@ export class Editor implements Component, Focusable {
 	onLargePaste?: (text: string, lineCount: number, options: PasteOptions) => boolean;
 	onAutocompleteCancel?: () => void;
 	disableSubmit: boolean = false;
+	/** Base editors accept native edits, not atomic sends. Implementations that
+	 *  handle `send` override this readiness check for their submission path. */
+	protected get nativeSendable(): boolean {
+		return false;
+	}
 	/** Placeholder painted right-aligned on the cursor row while the editor is empty and no
 	 *  autocomplete is open; hidden when it can't keep {@link PLACEHOLDER_MIN_GAP} cells from the
 	 *  cursor. The host styles it (ANSI allowed). Re-evaluated on every render, so hosts can derive
@@ -1687,6 +1692,7 @@ export class Editor implements Component, Focusable {
 		const props: TspEditorProps = {
 			text,
 			cursor,
+			sendable: this.nativeSendable,
 			anchor: anchor ?? undefined,
 			decor: decor.decor,
 			ghost: ghost ? plainText(ghost) : undefined,

package/src/components/input.ts

@@ -583,6 +583,7 @@ export class Input implements Component, Focusable {
 		const props: TspInputProps = {
 			text: value,
 			cursor,
+			sendable: false,
 			prompt: prompt || undefined,
 			placeholder: this.placeholder,
 		};

package/src/overlays/model-hub.ts

@@ -109,6 +109,11 @@ export interface ModelHubSource extends ModelBrowserSource {
 	getProjectModelRole(role: string): string | undefined;
 	getGlobalModelRole(role: string): string | undefined;
 	getModelRoleSource(role: string): "global" | "project" | "default";
+	/**
+	 * Saved model presets (in switch order) and the one the current role setup
+	 * matches, if any. Absent hosts have no presets to switch between.
+	 */
+	getModelPresets?(): { names: readonly string[]; active: string | undefined };
 }
 
 /** Catalog capabilities required by the model hub. */
@@ -157,6 +162,12 @@ export interface ModelHubCallbacks {
 	onLoginRequest?: (providerId: string) => void;
 	/** Save the current role assignments and default thinking level as a named model preset. */
 	onSavePreset?: (name: string) => void;
+	/**
+	 * Apply a saved model preset (ctrl+←/→ or p/⇧P in the Roles view) and report
+	 * the outcome itself. A switch that writes nothing (a refused preset) still
+	 * advances the hub's preset cursor, so the next press moves past it.
+	 */
+	onSwitchPreset?: (name: string) => void | Promise<void>;
 	/** Persist a new quick-switch cycle order (the ctrl+p role cycle). */
 	onCycleOrderChange?: (order: string[]) => void;
 	onCancel: () => void;
@@ -216,7 +227,18 @@ type StripState =
 	  };
 
 /** A Roles-view command; keys and the picker's action bar both run {@link ModelHubComponent}'s `#runRolesAction`. */
-type RolesAction = "pick" | "clear" | "fallback" | "cycle" | "earlier" | "later" | "new" | "thinking" | "save";
+type RolesAction =
+	| "pick"
+	| "clear"
+	| "fallback"
+	| "cycle"
+	| "earlier"
+	| "later"
+	| "new"
+	| "thinking"
+	| "save"
+	| "nextPreset"
+	| "prevPreset";
 
 /** Printable keys of the Roles view and the command each runs. */
 const ROLES_ACTION_KEYS: Record<string, RolesAction> = {
@@ -228,6 +250,9 @@ const ROLES_ACTION_KEYS: Record<string, RolesAction> = {
 	n: "new",
 	t: "thinking",
 	s: "save",
+	// Letter twins of ctrl+←/→, which macOS reserves for switching Spaces.
+	p: "nextPreset",
+	P: "prevPreset",
 };
 
 /** Picker fact columns of the Roles view. */
@@ -345,6 +370,12 @@ export class ModelHubComponent implements Component {
 	#assigning: AssignTarget | null = null;
 	#strip: StripState | null = null;
 	#assignmentPending = false;
+	/**
+	 * Last preset ctrl+←/→ tried in this hub, with the settings revision after the
+	 * attempt; steps from it while nothing matches the setup or nothing changed since.
+	 */
+	#presetCursor: { name: string; revision: number } | undefined;
+	#presetsMemo: { revision: number; names: readonly string[]; active: string | undefined } | undefined;
 	#disposed = false;
 	/** Per-provider fuzzy match counts while a query is active; null when not searching. */
 	#searchCounts: Map<string, number> | null = null;
@@ -1536,10 +1567,13 @@ export class ModelHubComponent implements Component {
 		}
 	}
 
-	/** Switch the body into assign mode for `role`: full catalog, cleared query, current model preselected. */
+	/**
+	 * Switch the body into assign mode for `role`: full catalog, cleared query, current model preselected.
+	 * Arrows land on the model rows (the next step of the flow); ← still reaches the provider scopes.
+	 */
 	#startAssign(role: string): void {
 		this.#assigning = { kind: "role", role };
-		this.#focus = "scope";
+		this.#focus = "list";
 		this.#browser.setShowProvider(true);
 		this.#setCandidateItems(this.#availableItems);
 		this.#browser.setQuery("");
@@ -1552,7 +1586,7 @@ export class ModelHubComponent implements Component {
 	/** Browse the catalog to fill a fallback-chain slot: `index` replaces an entry, `null` appends. */
 	#startAssignFallback(role: string, index: number | null): void {
 		this.#assigning = { kind: "fallback", role, index };
-		this.#focus = "scope";
+		this.#focus = "list";
 		this.#browser.setShowProvider(true);
 		this.#setCandidateItems(this.#availableItems);
 		this.#browser.setQuery("");
@@ -1570,7 +1604,7 @@ export class ModelHubComponent implements Component {
 	/** Browse the catalog for the primary model a brand-new fallback chain protects. */
 	#startAssignFallbackKey(): void {
 		this.#assigning = { kind: "fallbackKey" };
-		this.#focus = "scope";
+		this.#focus = "list";
 		this.#browser.setShowProvider(true);
 		this.#setCandidateItems(this.#availableItems);
 		this.#browser.setQuery("");
@@ -1752,6 +1786,52 @@ export class ModelHubComponent implements Component {
 		this.#buildRolesRows();
 	}
 
+	/** Saved presets and the one the setup matches; empty unless the host can both list and switch. */
+	#presets(): { names: readonly string[]; active: string | undefined } {
+		if (!this.#callbacks.onSwitchPreset || !this.#settings.getModelPresets) return { names: [], active: undefined };
+		const revision = this.#settings.revision;
+		if (this.#presetsMemo?.revision !== revision) {
+			const { names, active } = this.#settings.getModelPresets();
+			this.#presetsMemo = { revision, names, active };
+		}
+		return this.#presetsMemo;
+	}
+
+	/**
+	 * The preset ctrl+←/→ steps from: the last one tried here while settings are
+	 * unchanged since (a refused switch writes nothing, so the next press moves
+	 * past it) or nothing matches; otherwise the preset the setup matches.
+	 */
+	#presetBase(active: string | undefined): string | undefined {
+		const cursor = this.#presetCursor;
+		if (cursor && (active === undefined || cursor.revision === this.#settings.revision)) return cursor.name;
+		return active;
+	}
+
+	/** Apply the previous/next saved preset (wrapping), as `/modelpreset switch` does. */
+	#switchPreset(delta: -1 | 1): void {
+		const onSwitchPreset = this.#callbacks.onSwitchPreset;
+		const { names, active } = this.#presets();
+		if (!onSwitchPreset || names.length === 0) return;
+		const base = this.#presetBase(active);
+		const current = base === undefined ? -1 : names.indexOf(base);
+		const next = current < 0 ? (delta > 0 ? 0 : names.length - 1) : (current + delta + names.length) % names.length;
+		const name = names[next];
+		if (name === undefined) return;
+		const settle = () => {
+			this.#presetCursor = { name, revision: this.#settings.revision };
+			this.#refreshAfterMutation();
+		};
+		// Stepping onto the preset already in effect has nothing to apply.
+		if (name === active) {
+			settle();
+			return;
+		}
+		// The host reports refusals itself, so the cursor moves once the switch
+		// resolves, refused or not (`#presetBase` sees a refusal left the revision alone).
+		this.#finishAssignment(onSwitchPreset(name), settle);
+	}
+
 	handleInput(data: string): void {
 		this.#nativeVersion++;
 		if (this.#assignmentPending) {
@@ -1787,6 +1867,11 @@ export class ModelHubComponent implements Component {
 			}
 			return;
 		}
+		// Ctrl+←/→ in the Roles view steps through saved model presets, wrapping.
+		if (rolesView && (matchesKey(data, "ctrl+left") || matchesKey(data, "ctrl+right"))) {
+			this.#switchPreset(matchesKey(data, "ctrl+left") ? -1 : 1);
+			return;
+		}
 		// Alt+←/→ cycles whichever tab strip is on screen: role tabs in the
 		// Roles view, kind tabs in every browser view. Ctrl+←/→ is unusable on
 		// macOS (Spaces shortcut). macOS terminals (ghostty, Terminal.app,
@@ -2067,6 +2152,10 @@ export class ModelHubComponent implements Component {
 			case "save":
 				if (this.#callbacks.onSavePreset) this.#openNameStrip("preset");
 				return;
+			case "nextPreset":
+			case "prevPreset":
+				this.#switchPreset(action === "nextPreset" ? 1 : -1);
+				return;
 			case "thinking":
 				if (role) {
 					const target = this.#roleThinkingTarget(role);
@@ -2265,8 +2354,13 @@ export class ModelHubComponent implements Component {
 			ROLE_TABS.map(tab => ({ label: tab === "kind" ? "kinds" : tab })),
 			Math.max(0, active),
 		);
+		const { names, active: activePreset } = this.#presets();
+		const preset =
+			names.length > 0
+				? `   ${theme.fg("dim", "Preset:")} ${activePreset ? theme.fg("accent", activePreset) : theme.fg("muted", "custom")}  ${theme.fg("dim", `${formatKeyHints(["ctrl+left", "ctrl+right"])} · ${formatKeyHints(["p", "shift+p"])}`)}`
+				: "";
 		return truncateToWidth(
-			` ${theme.fg("dim", "Roles:")} ${track}  ${theme.fg("dim", formatKeyHints(["alt+left", "alt+right"]))}`,
+			` ${theme.fg("dim", "Roles:")} ${track}  ${theme.fg("dim", formatKeyHints(["alt+left", "alt+right"]))}${preset}`,
 			width,
 		);
 	}
@@ -2563,7 +2657,9 @@ export class ModelHubComponent implements Component {
 		const entry = this.#activeEntry();
 		if (entry.kind === "roles") {
 			if (this.#focus !== "list") {
-				return `${upDown} providers · ${enterRight} roles · ${altLeftRight} tabs · ${cancel} close`;
+				const presets =
+					this.#presets().names.length > 0 ? ` · ${formatKeyHints(["ctrl+left", "ctrl+right"])} preset` : "";
+				return `${upDown} providers · ${enterRight} roles · ${altLeftRight} tabs${presets} · ${cancel} close`;
 			}
 			const row = this.#rolesRows[this.#roleIndex];
 			if (row?.kind === "fallback") {
@@ -2585,7 +2681,8 @@ export class ModelHubComponent implements Component {
 			const editable = row?.kind === "role" && this.#roleThinkingTarget(row.role) !== undefined;
 			const thinking = editable ? ` · ${formatKeyHint("t")} thinking` : "";
 			const savePreset = this.#callbacks.onSavePreset ? ` · ${formatKeyHint("s")} save preset` : "";
-			return `${upDown} rows · ${enter} pick · ${formatKeyHint("f")} fallback · ${formatKeyHint("x")} clear${thinking} · ${formatKeyHint("c")} cycle · [/] reorder · ${formatKeyHint("n")} new${savePreset}`;
+			const switchPreset = this.#presets().names.length > 0 ? ` · ${formatKeyHints(["p", "shift+p"])} preset` : "";
+			return `${upDown} rows · ${enter} pick · ${formatKeyHint("f")} fallback · ${formatKeyHint("x")} clear${thinking} · ${formatKeyHint("c")} cycle · [/] reorder · ${formatKeyHint("n")} new${savePreset}${switchPreset}`;
 		}
 		if (entry.kind === "provider" && entry.locked) {
 			return entry.oauth
@@ -3143,6 +3240,17 @@ export class ModelHubComponent implements Component {
 		if (entry.kind === "provider" && entry.providerId && this.#refreshingProviders.has(entry.providerId)) {
 			return `${entry.label} · refreshing model list…`;
 		}
+		const presets = rolesView ? this.#presets() : undefined;
+		if (presets && presets.names.length > 0) {
+			return [
+				span("Preset ", "muted"),
+				presets.active ? span(presets.active, "strong") : span("custom", "muted"),
+				span(
+					this.#scopedModels.length > 0 ? " · --models scope" : " · Cleared roles fall back to auto-selection",
+					"muted",
+				),
+			];
+		}
 		if (this.#scopedModels.length > 0) return "--models scope";
 		if (rolesView) return "Cleared roles fall back to auto-selection";
 		return undefined;
@@ -3296,6 +3404,7 @@ export class ModelHubComponent implements Component {
 						roleAction("cycle", this.#cycleOrder().includes(row.role) ? "Leave cycle" : "Add to cycle", "c"),
 						roleAction("new", "New role", "n"),
 						this.#callbacks.onSavePreset ? roleAction("save", "Save preset", "s") : undefined,
+						this.#presets().names.length > 0 ? roleAction("nextPreset", "Next preset", "p") : undefined,
 					);
 					break;
 				}
@@ -3782,6 +3891,7 @@ export class ModelHubComponent implements Component {
 						: "assign";
 			return [keys(pick, "enter"), upDown("models"), keys("providers", "left"), search, kind, cancel("cancel")];
 		}
+		const presetHint = this.#presets().names.length > 0 ? keys("preset", "ctrl+left", "ctrl+right") : undefined;
 		const entry = this.#activeEntry();
 		if (entry.kind === "roles") {
 			if (this.#focus !== "list") {
@@ -3789,6 +3899,7 @@ export class ModelHubComponent implements Component {
 					upDown("providers"),
 					keys("roles", "enter", "right"),
 					keys("tabs", "alt+left", "alt+right"),
+					presetHint,
 					cancel("close"),
 				];
 			}
@@ -3828,6 +3939,7 @@ export class ModelHubComponent implements Component {
 				reorder,
 				keys("new", "n"),
 				this.#callbacks.onSavePreset ? keys("save preset", "s") : undefined,
+				this.#presets().names.length > 0 ? keys("preset", "ctrl+left", "ctrl+right", "p", "shift+p") : undefined,
 			];
 		}
 		if (entry.kind === "provider" && entry.locked) {

package/src/prompt/custom-editor.ts

@@ -1001,6 +1001,10 @@ export class CustomEditor extends Editor {
 		}, CustomEditor.SHIMMER_FRAME_MS);
 		this.#shimmerTimer.unref?.();
 	}
+	/** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled. */
+	protected override get nativeSendable(): boolean {
+		return this.onSubmit !== undefined && !this.disableSubmit;
+	}
 	/** Viewing a subagent, the draft goes to it: the placeholder names it. */
 	override describePlaceholder = (): string => {
 		const agent = this.composerState().viewing?.at(-1);
@@ -1259,7 +1263,7 @@ export class CustomEditor extends Editor {
 		if (event.type === "send") {
 			// A send is its own prompt: never submit a stale draft for blank input,
 			// and retain a displaced draft (including its attachments) for recall.
-			if (!event.text.trim() || this.disableSubmit || !this.onSubmit) return;
+			if (!event.text.trim() || !this.nativeSendable) return;
 			if (this.#pasteInFlight > 0) {
 				this.#pendingInput.push(event);
 				return;

package/src/terminal.ts

@@ -38,6 +38,8 @@ const TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;
 const TERMINAL_PROGRESS_ACTIVE_SEQUENCE = "\x1b]9;4;3\x07";
 const TERMINAL_PROGRESS_CLEAR_SEQUENCE = "\x1b]9;4;0;\x07";
 const WINDOWS_TERMINAL_OSC11_POLL_MS = 30_000;
+/** How long a relayed ESC record waits for the rest of its sequence before acting as Escape (matches StdinBuffer). */
+const WIN32_RELAYED_ESCAPE_TIMEOUT_MS = 75;
 
 /**
  * Terminal → program TSP messages through a Windows ConPTY: its input parser
@@ -759,6 +761,8 @@ export class ProcessTerminal implements Terminal {
 	// win32-input-mode sequences and are decoded before reaching the handler.
 	#win32InputDecoder?: Win32InputModeDecoder;
 	#win32PasteNormalizer?: Win32PasteMarkerNormalizer;
+	// Releases a relayed lone ESC the decoder held for a sequence tail that never came.
+	#win32PendingFlushTimer?: Timer;
 	#stdinBuffer?: StdinBuffer;
 	#stdinDataHandler?: (data: string) => void;
 	#disconnectHandler?: () => void;
@@ -1570,9 +1574,18 @@ export class ProcessTerminal implements Terminal {
 				return;
 			}
 			if (this.#inputHandler) {
-				const win32Keys = this.#win32InputDecoder?.decode(sequence);
-				if (win32Keys !== undefined) {
+				const decoder = this.#win32InputDecoder;
+				const win32Keys = decoder?.decode(sequence);
+				if (decoder && win32Keys !== undefined) {
+					clearTimeout(this.#win32PendingFlushTimer);
+					this.#win32PendingFlushTimer = undefined;
 					for (const key of win32Keys) this.#inputHandler(key);
+					if (decoder.hasPendingSequence) {
+						this.#win32PendingFlushTimer = setTimeout(
+							() => this.#releaseWin32PendingSequence(),
+							WIN32_RELAYED_ESCAPE_TIMEOUT_MS,
+						);
+					}
 					return;
 				}
 				// Windows console hosts drop AltGr text under kitty (AltGr+F → `CSI 102;3u`);
@@ -1868,7 +1881,12 @@ export class ProcessTerminal implements Terminal {
 			// and the mode splits arrow keys into Escape plus literal text (#14034).
 			this.#safeWrite("\x1b[?9001h");
 			this.#win32InputDecoder = new Win32InputModeDecoder();
-			this.#win32PasteNormalizer = new Win32PasteMarkerNormalizer(data => this.#stdinBuffer?.process(data));
+			// The normalizer's expiry already spent the ESC wait; release the decoder's hold
+			// at once instead of starting a second window.
+			this.#win32PasteNormalizer = new Win32PasteMarkerNormalizer(
+				data => this.#stdinBuffer?.process(data),
+				() => this.#releaseWin32PendingSequence(),
+			);
 			return;
 		}
 		// A remote terminal with no identifying env may not understand the request.
@@ -1877,10 +1895,20 @@ export class ProcessTerminal implements Terminal {
 		this.#modifyOtherKeysActive = true;
 	}
 
+	/** Deliver relayed VT text the decoder is holding (a lone ESC becomes Escape). */
+	#releaseWin32PendingSequence(): void {
+		clearTimeout(this.#win32PendingFlushTimer);
+		this.#win32PendingFlushTimer = undefined;
+		const pending = this.#win32InputDecoder?.flushPendingSequence() ?? [];
+		for (const key of pending) this.#inputHandler?.(key);
+	}
+
 	#disableWin32InputMode(): void {
 		if (!this.#win32InputDecoder) return;
 		this.#win32PasteNormalizer?.flush();
 		this.#win32PasteNormalizer = undefined;
+		// Held input still belongs to the user (e.g. Escape before a late kitty reply).
+		this.#releaseWin32PendingSequence();
 		this.#safeWrite("\x1b[?9001l");
 		this.#win32InputDecoder = undefined;
 	}

package/src/windows-input-mode.ts

@@ -16,6 +16,12 @@
  * terminal sends; chords legacy encoding loses (modified Enter/Tab/Escape,
  * Ctrl+Shift+letter, …) translate to kitty CSI-u, which key matching already
  * parses.
+ *
+ * A host terminal that writes VT instead of key records (any ConPTY host
+ * besides Windows Terminal's native path) reaches us as one `Vk = 0` text
+ * record per byte: Alt+Up arrives as `ESC`, `[`, `1`, `;`, `3`, `A`. Those
+ * bytes are reassembled into the escape sequence they spell; delivering them
+ * one at a time turns every such key into a bare Escape plus typed garbage.
  */
 
 const W32IM_PATTERN = /^\x1b\[([\d;]*)_$/;
@@ -111,6 +117,31 @@ function baseCodepointForVk(vk: number): number {
 	return 0;
 }
 
+/** `split`: the leading ESC is a standalone Escape and the rest starts a new sequence. */
+type VtState = "partial" | "complete" | "invalid" | "split";
+
+/** Classify relayed VT text that starts with ESC. */
+function vtState(text: string): VtState {
+	if (text.length === 1) return "partial";
+	const introducer = text[1]!;
+	if (introducer === "\x1b") {
+		if (text.length === 2) return "partial";
+		// Only meta-CSI/SS3 (legacy Alt+Up is `ESC ESC [ A`) stays grouped; `ESC ESC d`
+		// is Escape followed by Alt+d, matching StdinBuffer.
+		return text[2] === "[" || text[2] === "O" ? vtState(text.slice(1)) : "split";
+	}
+	if (introducer === "[") {
+		if (/^\x1b\[[0-?]*[ -/]*[@-~]$/.test(text)) return "complete";
+		return /^\x1b\[[0-?]*[ -/]*$/.test(text) ? "partial" : "invalid";
+	}
+	if (introducer === "O") return text.length === 2 ? "partial" : text.length === 3 ? "complete" : "invalid";
+	if (introducer === "]" || introducer === "P" || introducer === "_") {
+		return text.endsWith("\x07") || (text.length > 3 && text.endsWith("\x1b\\")) ? "complete" : "partial";
+	}
+	// ESC + one character: Alt+character.
+	return text.length === 2 ? "complete" : "invalid";
+}
+
 function encodeKey(record: KeyRecord): string | null {
 	const { vk, uc, state } = record;
 	const shift = (state & SHIFT_PRESSED) !== 0;
@@ -165,9 +196,30 @@ function encodeKey(record: KeyRecord): string | null {
 	return uc === 0 ? null : text;
 }
 
-/** Stateful decoder: joins UTF-16 surrogate halves that arrive as separate records. */
+/**
+ * Stateful decoder: joins UTF-16 surrogate halves that arrive as separate
+ * records, and reassembles VT escape sequences relayed as text records.
+ */
 export class Win32InputModeDecoder {
 	#pendingHighSurrogate = 0;
+	/** Relayed VT text that starts with ESC and has not completed a sequence yet. */
+	#pendingVt = "";
+
+	/** Whether relayed VT text is held waiting for the rest of its sequence. */
+	get hasPendingSequence(): boolean {
+		return this.#pendingVt.length > 0;
+	}
+
+	/**
+	 * Release held VT text as-is. The caller invokes this once no further bytes
+	 * arrived in time, so a lone relayed ESC still acts as the Escape key.
+	 */
+	flushPendingSequence(): string[] {
+		if (this.#pendingVt.length === 0) return [];
+		const pending = this.#pendingVt;
+		this.#pendingVt = "";
+		return [pending];
+	}
 
 	/**
 	 * Translate one stdin sequence. Returns `undefined` when `data` is not a
@@ -180,17 +232,42 @@ export class Win32InputModeDecoder {
 
 		if (!record.down) {
 			// Alt+Numpad composition delivers its character on the Alt release.
-			if (record.vk === VK_MENU && record.uc !== 0) return this.#emitText(record.uc);
+			if (record.vk === VK_MENU && record.uc !== 0) return this.#assembleVt(this.#emitText(record.uc));
 			return [];
 		}
 		if (MODIFIER_VKS.has(record.vk)) return [];
-		if (record.vk === 0 || record.vk === VK_PACKET) return this.#emitText(record.uc, record.repeat);
-		if (record.uc >= 0xd800 && record.uc <= 0xdfff) return this.#emitText(record.uc);
+		if (record.vk === 0 || record.vk === VK_PACKET) return this.#assembleVt(this.#emitText(record.uc, record.repeat));
+		if (record.uc >= 0xd800 && record.uc <= 0xdfff) return this.#assembleVt(this.#emitText(record.uc));
 
 		this.#pendingHighSurrogate = 0;
 		const encoded = encodeKey(record);
-		if (encoded === null) return [];
-		return Array.from({ length: record.repeat }, () => encoded);
+		// A real key ends whatever relayed text was still incomplete.
+		const flushed = this.flushPendingSequence();
+		if (encoded === null) return flushed;
+		for (let i = 0; i < record.repeat; i++) flushed.push(encoded);
+		return flushed;
+	}
+
+	/** Group relayed text into whole escape sequences; other text passes through per character. */
+	#assembleVt(texts: string[]): string[] {
+		const out: string[] = [];
+		for (const text of texts) {
+			if (this.#pendingVt.length === 0 && text !== "\x1b") {
+				out.push(text);
+				continue;
+			}
+			this.#pendingVt += text;
+			let state = vtState(this.#pendingVt);
+			while (state === "split") {
+				out.push("\x1b");
+				this.#pendingVt = this.#pendingVt.slice(1);
+				state = vtState(this.#pendingVt);
+			}
+			if (state === "partial") continue;
+			out.push(this.#pendingVt);
+			this.#pendingVt = "";
+		}
+		return out;
 	}
 
 	/**
@@ -245,9 +322,15 @@ export class Win32PasteMarkerNormalizer {
 	#marker = "";
 	#timer?: NodeJS.Timeout;
 	readonly #onInput: (data: string) => void;
+	readonly #onExpired?: () => void;
 
-	constructor(onInput: (data: string) => void) {
+	/**
+	 * `onExpired` runs after held records are released because their wait timed
+	 * out, so a downstream holder can treat the same wait as already elapsed.
+	 */
+	constructor(onInput: (data: string) => void, onExpired?: () => void) {
 		this.#onInput = onInput;
+		this.#onExpired = onExpired;
 	}
 
 	process(data: string): void {
@@ -324,7 +407,12 @@ export class Win32PasteMarkerNormalizer {
 		}
 
 		if (output) this.#onInput(output);
-		if (this.#candidate || this.#pending) this.#timer = setTimeout(() => this.flush(), 75);
+		if (this.#candidate || this.#pending) {
+			this.#timer = setTimeout(() => {
+				this.flush();
+				this.#onExpired?.();
+			}, 75);
+		}
 	}
 
 	/** Release an incomplete marker as its original key records. */