@aiwayds/dsh-tui-pi 2.6.0 → 2.7.0

package/README.md

@@ -22,7 +22,7 @@ https://github.com/user-attachments/assets/6a7e00bb-1fd0-4bc5-9070-457f1e9fa54d
 - [**Dynamic context pruning (DCP)**](docs/features/dcp.md) — context stays within limits automatically, with zero LLM calls.
 - [**Persistent context**](docs/features/persistent-context.md) — your ground rules ride along on every request, hot-applied with no restart.
 - [**Model profiles & favorites**](docs/features/model-profiles.md) — switch a whole model setup per project and keep the picker small.
-- [**Agent preset switching**](docs/features/preset-switch.md) — `Tab` / `/preset` between the shipped agent compositions (`standard`, `minimal`, …); what a preset really gates, and exactly when a switch takes effect.
+- [**Agent preset switching**](docs/features/preset-switch.md) — `/preset` between the shipped agent compositions (`standard`, `minimal`, …); a switch is confirmed and starts a NEW session on the preset (the current one stays resumable); what a preset really gates.
 - [**Sessions & resume**](docs/features/sessions-resume.md) — sessions stay tidy automatically and resume in a few keystrokes; a cross-process writer guard keeps the log single-writer.
 - [**History browser**](docs/features/history.md) — `/history` opens a fixed two-pane look-back over the session: completed turns on the left, the selected turn's replies on the right; copy a prompt back to the editor, or cold-read any stored session without resuming it (read-only, no writer lock).
 - [**Themes**](docs/features/themes.md) — GitHub light/dark palettes, hot-switchable; `auto` follows your terminal.
@@ -85,7 +85,6 @@ dsh plugin --profile tui add @aiwayds/dsh-topics-memory
 | `Ctrl+G` | Open the subagent picker (viewer `Enter` opens steer) |
 | `Ctrl+O` | Pending-message queue (s steer now · d remove) |
 | `Ctrl+Shift+F` | Transcript search (`Enter`/`Ctrl+G` next · `Shift+Enter`/`Ctrl+Shift+G` previous · `Esc` close) |
-| `Tab` | Cycle agent presets |
 | `↑` / `↓` | Browse submitted-message history |
 
 Remap any app key through `~/.dsh/keybindings.json` (a partial JSON map, live-applied) or interactively with `/hotkeys`.

package/README.zh-CN.md

@@ -22,7 +22,7 @@ https://github.com/user-attachments/assets/6a7e00bb-1fd0-4bc5-9070-457f1e9fa54d
 - [**动态上下文修剪（DCP）**](docs/features/dcp.md) —— 上下文自动保持在窗口内，零 LLM 调用。
 - [**持久上下文**](docs/features/persistent-context.md) —— 你的基本规则随每个请求生效，热应用无需重启。
 - [**模型 profile 与收藏**](docs/features/model-profiles.md) —— 按项目切换整套模型配置，选择器保持精简。
-- [**Agent preset 切换**](docs/features/preset-switch.md) —— `Tab` / `/preset` 在内置 agent 组合（`standard`、`minimal`……）间切换；preset 到底管什么、切换何时生效。
+- [**Agent preset 切换**](docs/features/preset-switch.md) —— `/preset` 在内置 agent 组合（`standard`、`minimal`……）间切换；切换需确认并会开启新会话（当前会话仍可 /resume 恢复）；preset 到底管什么。
 - [**Sessions 会话与恢复**](docs/features/sessions-resume.md) —— 会话自动保持整洁、几次按键恢复；跨进程写者守卫保证日志单写者。
 - [**Themes 主题**](docs/features/themes.md) —— GitHub 明/暗配色热切换；`auto` 跟随终端。
 - [**搜索、选择与图片**](docs/features/search-selection-images.md) —— `Ctrl+Shift+F` 全文搜索、划选复制到系统剪贴板、web/飞书附件内联渲染、LaTeX 转 Unicode 数学。
@@ -82,7 +82,6 @@ dsh plugin --profile tui add @aiwayds/dsh-topics-memory
 | `Ctrl+G` | 打开 subagent 选择器（查看器内 `Enter` 打开 steer） |
 | `Ctrl+O` | 待发消息队列（`s` 立即 steer · `d` 移除） |
 | `Ctrl+Shift+F` | 全文搜索（`Enter`/`Ctrl+G` 下一个 · `Shift+Enter`/`Ctrl+Shift+G` 上一个 · `Esc` 关闭） |
-| `Tab` | 循环切换 agent preset |
 | `↑` / `↓` | 浏览已提交消息历史 |
 
 通过 `~/.dsh/keybindings.json`（部分 JSON 映射，实时应用）或 `/hotkeys` 交互式重映射任意 app 按键。

package/lib/history-fork.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The fork-at-turn confirmation dialog — the /history browser's `f` key.
+ *
+ * Forking at a turn starts a NEW session seeded with the browsed session's
+ * events through the selected turn's `turn/end` (inclusive) and switches to
+ * it; the current session stays untouched and resumable via /resume. That is
+ * a user-visible, hard-to-reverse-looking action, so it is gated behind this
+ * confirmation (mirroring the /resume repair dialog's pure-reducer split,
+ * src/repair-dialog.ts, so the decision matrix stays unit-testable without a
+ * terminal). Two options — Fork now / Cancel — Esc = cancel.
+ *
+ * The dialog mounts as its own overlay ON TOP of the open browser (the
+ * browser stays mounted underneath and keeps the keyboard after the dialog
+ * resolves; the switch itself runs after confirmation).
+ */
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import { type TuiTheme } from './theme/index.ts';
+/** The two choices in display order; index 0 is preselected. */
+export declare const FORK_AT_TURN_OPTION_IDS: ReadonlyArray<'fork' | 'cancel'>;
+/** Accent-BOLD dialog title (`N` = the selected turn's number). */
+export declare function forkAtTurnTitle(turnLabel: string): string;
+/**
+ * The fixed body points, one entry per bullet — each wrapped to the terminal
+ * width by the panel before painting. `N` is the selected turn's number,
+ * `M` the session's total turn count (as listed). `detachedLiveId` is set
+ * when the browsed session is NOT the live one (a cold read): forking then
+ * detaches the LIVE session, and the body must say so — "the current
+ * session" alone would read as the browsed one and hide the live session's
+ * fate. Undefined = live browse (or nothing live at all), where the generic
+ * wording is exact.
+ */
+export declare function forkAtTurnBody(turnLabel: string, totalTurns: number, detachedLiveId?: string): readonly string[];
+/** The fixed option rows for one target turn. */
+export declare function forkAtTurnOptions(turnLabel: string): ReadonlyArray<{
+    id: 'fork' | 'cancel';
+    text: string;
+}>;
+/** Footer hint — hardcoded like every other panel footer (English-only). */
+export declare const FORK_AT_TURN_FOOTER = "\u2191\u2193 select \u00B7 1/2 pick \u00B7 Enter confirm \u00B7 Esc cancel";
+/** Pure dialog state: which row is highlighted, and the terminal outcome. */
+export interface ForkAtTurnState {
+    selected: number;
+    /**
+     * Set once by a terminal key: `'confirm'` (Enter on a selection) or
+     * `'cancel'` (Esc). Further input is ignored afterwards.
+     */
+    settled?: 'confirm' | 'cancel';
+}
+export declare function initialForkAtTurnState(): ForkAtTurnState;
+/**
+ * Apply one raw key sequence to the dialog state. Unknown keys are no-ops;
+ * anything after a settle is ignored (single terminal outcome guard).
+ */
+export declare function updateForkAtTurn(state: ForkAtTurnState, data: string): ForkAtTurnState;
+/** Resolved dialog outcome: the chosen action, or undefined on cancel. */
+export declare function forkAtTurnOutcome(state: ForkAtTurnState): 'fork' | 'cancel' | undefined;
+/**
+ * The framed overlay component. Renders the title, the wrapped body points
+ * and the two option rows; every key goes through {@link updateForkAtTurn},
+ * and the first terminal key fires `onFinish` exactly once.
+ */
+export declare class ForkAtTurnPanel implements Component {
+    private readonly theme;
+    private readonly turnLabel;
+    private readonly totalTurns;
+    private readonly detachedLiveId;
+    private readonly onFinish;
+    private readonly requestRenderFn;
+    private state;
+    constructor(theme: TuiTheme, turnLabel: string, totalTurns: number, detachedLiveId: string | undefined, onFinish: (outcome: 'fork' | 'cancel' | undefined) => void, requestRender: () => void);
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+}
+/**
+ * Open the fork-at-turn confirmation dialog over the OPEN browser (its own
+ * overlay — the browser stays mounted underneath and regains the keyboard
+ * when the dialog resolves). Resolves `'fork'` when the user explicitly
+ * confirmed, `'cancelled'` otherwise (Esc, or an overlay that failed to
+ * mount — treated as cancel so a half-mounted dialog can never imply
+ * consent). Closing hands focus back through `restoreFocus` first.
+ */
+export declare function openForkAtTurnDialog(tui: TUI, theme: TuiTheme, turnLabel: string, totalTurns: number, detachedLiveId: string | undefined, restoreFocus: () => void): Promise<'fork' | 'cancelled'>;

package/lib/history-fork.js

@@ -0,0 +1,182 @@
+/**
+ * The fork-at-turn confirmation dialog — the /history browser's `f` key.
+ *
+ * Forking at a turn starts a NEW session seeded with the browsed session's
+ * events through the selected turn's `turn/end` (inclusive) and switches to
+ * it; the current session stays untouched and resumable via /resume. That is
+ * a user-visible, hard-to-reverse-looking action, so it is gated behind this
+ * confirmation (mirroring the /resume repair dialog's pure-reducer split,
+ * src/repair-dialog.ts, so the decision matrix stays unit-testable without a
+ * terminal). Two options — Fork now / Cancel — Esc = cancel.
+ *
+ * The dialog mounts as its own overlay ON TOP of the open browser (the
+ * browser stays mounted underneath and keeps the keyboard after the dialog
+ * resolves; the switch itself runs after confirmation).
+ */
+import { getKeybindings } from '@earendil-works/pi-tui';
+import { PanelHost, panelThemeFns } from "./panels.js";
+import { BOLD, RESET, ansiFg } from "./theme/index.js";
+import { clipToWidth, wrapText } from "./text.js";
+/** The two choices in display order; index 0 is preselected. */
+export const FORK_AT_TURN_OPTION_IDS = ['fork', 'cancel'];
+/** Accent-BOLD dialog title (`N` = the selected turn's number). */
+export function forkAtTurnTitle(turnLabel) {
+    return `● Fork at turn ${turnLabel}?`;
+}
+/**
+ * The fixed body points, one entry per bullet — each wrapped to the terminal
+ * width by the panel before painting. `N` is the selected turn's number,
+ * `M` the session's total turn count (as listed). `detachedLiveId` is set
+ * when the browsed session is NOT the live one (a cold read): forking then
+ * detaches the LIVE session, and the body must say so — "the current
+ * session" alone would read as the browsed one and hide the live session's
+ * fate. Undefined = live browse (or nothing live at all), where the generic
+ * wording is exact.
+ */
+export function forkAtTurnBody(turnLabel, totalTurns, detachedLiveId) {
+    return [
+        `The new session carries turns through ${turnLabel} (of ${totalTurns}); later turns stay in the current session.`,
+        detachedLiveId === undefined
+            ? 'The current session stays resumable via /resume.'
+            : `Your live session ${detachedLiveId} will be detached — it stays resumable via /resume.`,
+    ];
+}
+/** The fixed option rows for one target turn. */
+export function forkAtTurnOptions(turnLabel) {
+    return [
+        { id: 'fork', text: `Fork now — new session through turn ${turnLabel}` },
+        { id: 'cancel', text: 'Cancel' },
+    ];
+}
+/** Footer hint — hardcoded like every other panel footer (English-only). */
+export const FORK_AT_TURN_FOOTER = '↑↓ select · 1/2 pick · Enter confirm · Esc cancel';
+export function initialForkAtTurnState() {
+    return { selected: 0 };
+}
+/**
+ * Apply one raw key sequence to the dialog state. Unknown keys are no-ops;
+ * anything after a settle is ignored (single terminal outcome guard).
+ */
+export function updateForkAtTurn(state, data) {
+    if (state.settled !== undefined)
+        return state;
+    const kb = getKeybindings();
+    if (kb.matches(data, 'tui.select.cancel'))
+        return { ...state, settled: 'cancel' };
+    if (kb.matches(data, 'tui.input.submit'))
+        return { ...state, settled: 'confirm' };
+    if (kb.matches(data, 'tui.select.up')) {
+        return { ...state, selected: Math.max(0, state.selected - 1) };
+    }
+    if (kb.matches(data, 'tui.select.down')) {
+        return { ...state, selected: Math.min(FORK_AT_TURN_OPTION_IDS.length - 1, state.selected + 1) };
+    }
+    // Digit direct-select (1-based): selects the row, Enter still confirms —
+    // same select-then-confirm split as the routing dialog.
+    const digit = /^([1-9])$/.exec(data);
+    if (digit !== null) {
+        const index = Number(digit[1]) - 1;
+        if (index < FORK_AT_TURN_OPTION_IDS.length)
+            return { ...state, selected: index };
+    }
+    return state;
+}
+/** Resolved dialog outcome: the chosen action, or undefined on cancel. */
+export function forkAtTurnOutcome(state) {
+    if (state.settled !== 'confirm')
+        return undefined;
+    return FORK_AT_TURN_OPTION_IDS[state.selected];
+}
+/**
+ * The framed overlay component. Renders the title, the wrapped body points
+ * and the two option rows; every key goes through {@link updateForkAtTurn},
+ * and the first terminal key fires `onFinish` exactly once.
+ */
+export class ForkAtTurnPanel {
+    theme;
+    turnLabel;
+    totalTurns;
+    detachedLiveId;
+    onFinish;
+    requestRenderFn;
+    state = initialForkAtTurnState();
+    constructor(theme, turnLabel, totalTurns, detachedLiveId, onFinish, requestRender) {
+        this.theme = theme;
+        this.turnLabel = turnLabel;
+        this.totalTurns = totalTurns;
+        this.detachedLiveId = detachedLiveId;
+        this.onFinish = onFinish;
+        this.requestRenderFn = requestRender;
+    }
+    invalidate() { }
+    render(width) {
+        const fns = panelThemeFns(this.theme);
+        const wrap = Math.max(2, width - 2);
+        // Word-wrap the body FIRST, then paint (iron rule: width math runs on
+        // plain text, ANSI goes on after clipping).
+        const lines = [
+            fns.accent(BOLD + clipToWidth(forkAtTurnTitle(this.turnLabel), wrap) + RESET),
+            ...forkAtTurnBody(this.turnLabel, this.totalTurns, this.detachedLiveId).flatMap(point => wrapText(point, wrap).map(segment => fns.muted(clipToWidth(segment, wrap)))),
+            '',
+        ];
+        const options = forkAtTurnOptions(this.turnLabel);
+        for (let i = 0; i < options.length; i++) {
+            const option = options[i];
+            const marker = i === this.state.selected ? '▸' : ' ';
+            const row = clipToWidth(`${marker} ${i + 1}. ${option.text}`, wrap);
+            lines.push(i === this.state.selected
+                ? ansiFg(this.theme.palette.accent) + BOLD + row + RESET
+                : fns.muted(row));
+        }
+        lines.push('');
+        lines.push(fns.subtle(clipToWidth(FORK_AT_TURN_FOOTER, wrap)));
+        return lines;
+    }
+    handleInput(data) {
+        const previous = this.state;
+        this.state = updateForkAtTurn(this.state, data);
+        if (this.state === previous)
+            return;
+        if (this.state.settled === undefined) {
+            this.requestRenderFn();
+            return;
+        }
+        this.onFinish(forkAtTurnOutcome(this.state));
+    }
+}
+/**
+ * Open the fork-at-turn confirmation dialog over the OPEN browser (its own
+ * overlay — the browser stays mounted underneath and regains the keyboard
+ * when the dialog resolves). Resolves `'fork'` when the user explicitly
+ * confirmed, `'cancelled'` otherwise (Esc, or an overlay that failed to
+ * mount — treated as cancel so a half-mounted dialog can never imply
+ * consent). Closing hands focus back through `restoreFocus` first.
+ */
+export function openForkAtTurnDialog(tui, theme, turnLabel, totalTurns, detachedLiveId, restoreFocus) {
+    return new Promise(resolve => {
+        let settled = false;
+        const settle = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(outcome);
+        };
+        // A half-mounted overlay must not strand the keyboard: PanelHost's
+        // onError closes + calls restoreFocus, then we settle as cancelled.
+        const host = new PanelHost(tui, theme, () => {
+            restoreFocus();
+            settle('cancelled');
+        });
+        const finish = (outcome) => {
+            host.close();
+            restoreFocus();
+            settle(outcome === 'fork' ? 'fork' : 'cancelled');
+        };
+        const panel = new ForkAtTurnPanel(theme, turnLabel, totalTurns, detachedLiveId, outcome => finish(outcome), () => tui.requestRender());
+        // maxHeight is a hard slice in pi-tui: title + 2 wrapped body points +
+        // 2 options + footer ≈ 8 content rows + 4 frame rows; 75% of the 24-row
+        // e2e floor is 18 (the /resume picker's headroom).
+        host.open(panel, '70%', '75%');
+    });
+}
+//# sourceMappingURL=history-fork.js.map

package/lib/history-fork.js.map

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

package/lib/history-turns.d.ts

@@ -83,3 +83,13 @@ export declare function matchesTurnFilter(turn: HistoryTurn, query: string): boo
  * in first-appearance order. Empty string for a tool-less turn.
  */
 export declare function toolCallSummary(names: readonly string[]): string;
+/**
+ * The fork-at-turn seed: the session events from seq 0 through the selected
+ * turn's `turn/end` (inclusive) — the state as that turn finished; later
+ * turns stay out of the new session. `seq === array index` holds for live
+ * snapshots and persisted `inspect` events alike (restore validates the same
+ * contiguity), so a plain slice is exact. Returns [] when the turn is
+ * unknown or never closed — only completed turns are forkable. The same
+ * balanced-prefix shape the host's fork subagent backend seeds with.
+ */
+export declare function turnSeedSlice(events: readonly SessionEvent[], turn: number): readonly SessionEvent[];

package/lib/history-turns.js

@@ -167,4 +167,20 @@ export function toolCallSummary(names) {
     const total = names.length;
     return `${total} tool call${total === 1 ? '' : 's'}: ${parts.join(', ')}`;
 }
+/**
+ * The fork-at-turn seed: the session events from seq 0 through the selected
+ * turn's `turn/end` (inclusive) — the state as that turn finished; later
+ * turns stay out of the new session. `seq === array index` holds for live
+ * snapshots and persisted `inspect` events alike (restore validates the same
+ * contiguity), so a plain slice is exact. Returns [] when the turn is
+ * unknown or never closed — only completed turns are forkable. The same
+ * balanced-prefix shape the host's fork subagent backend seeds with.
+ */
+export function turnSeedSlice(events, turn) {
+    for (const grouped of groupHistoryTurns(events)) {
+        if (grouped.turn === turn)
+            return events.slice(0, grouped.seqEnd + 1);
+    }
+    return [];
+}
 //# sourceMappingURL=history-turns.js.map

package/lib/history-turns.js.map

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

package/lib/history.d.ts

@@ -121,6 +121,23 @@ export interface HistoryBrowserDeps {
     getLiveEvents(): readonly SessionEvent[] | undefined;
     /** Copy target: a plain editor setText (never submitted). */
     copyToEditor(text: string): void;
+    /**
+     * Show the fork-at-turn confirmation over the open browser; resolves true
+     * = fork now. `turnLabel` is the selected turn's number (as displayed),
+     * `totalTurns` the session's listed turn count; `cold` is true when the
+     * browsed session is not the live one — the fork then detaches the LIVE
+     * session, and the dialog must say so instead of hiding it.
+     */
+    confirmForkAtTurn(turnLabel: string, totalTurns: number, cold: boolean): Promise<boolean>;
+    /**
+     * Fork-and-switch at the turn boundary: start a new session on the CURRENT
+     * preset selection seeded with `seed` (the browsed session's prefix), and
+     * switch to it. Resolves when the new session is live; a rejection leaves
+     * every existing binding untouched (the browser stays open).
+     */
+    forkAtTurn(seed: readonly SessionEvent[], parentSessionId: string): Promise<unknown>;
+    /** Buffered channel for fork failures (a transcript notice). */
+    reportError(message: string): void;
     restoreFocus(): void;
     requestRender(): void;
 }
@@ -167,11 +184,14 @@ export declare class HistoryBrowserPanel implements Component {
     private sessionId;
     private live;
     private turns;
+    /** The browsed session's raw events — the fork-at-turn slice source. */
+    private events;
     private query;
     private rows;
     private status;
     private closed;
     private pickerLoading;
+    private forkInProgress;
     /**
      * Where the keyboard lives: the left list (default) or the right detail
      * pane. `→` hands focus to the detail pane, `←`/Esc step back; only the
@@ -219,6 +239,15 @@ export declare class HistoryBrowserPanel implements Component {
      * picker-local — reset on every `s` (CONTEXT.md "Filter").
      */
     buildSessionPickerPanel(rows: readonly SessionPickRow[]): TablePanel<SessionPickRow>;
+    /**
+     * Fork at the selected turn (`f`): confirm over the open browser, then
+     * hand the turn-bounded seed to the fork-and-switch seam. The browsed
+     * session's events are the slice source — live snapshots and cold-read
+     * (`inspect`) events fork alike. Cancel or an empty slice (nothing
+     * completed to carry) changes nothing; a failed fork keeps the browser
+     * open with the failure on the status line plus a buffered notice.
+     */
+    private forkAtSelectedTurn;
     /** Open the session picker overlay (the browser stays mounted underneath). */
     private openSessionPicker;
     /** Live query swap: rebuild rows, keep the cursor on its turn when visible. */

package/lib/history.js

@@ -57,7 +57,7 @@
  */
 import { SessionId } from '@deepseek-ai/dsh-session';
 import { Container, getKeybindings, HStack, matchesKey, Markdown, Spacer, Text, VStack, } from '@earendil-works/pi-tui';
-import { groupHistoryTurns, matchesTurnFilter, toolCallSummary, turnPrimaryUserText, } from "./history-turns.js";
+import { groupHistoryTurns, matchesTurnFilter, toolCallSummary, turnPrimaryUserText, turnSeedSlice, } from "./history-turns.js";
 import { stopIcon } from "./icons.js";
 import { isCorruptLogError } from "./log-repair.js";
 import { autoColumns, PanelHost, panelThemeFns, TablePanel } from "./panels.js";
@@ -71,7 +71,7 @@ export const LEFT_PANE_MIN_COLUMNS = 30;
 /** Rendered-line cap of one user bubble in the detail pane (spec: truncated). */
 export const MAX_USER_BUBBLE_LINES = 40;
 /** List footer hint (the detail pane carries the scroll hints). */
-const HISTORY_FOOTER = '↑↓ navigate · Enter/c copy · → detail · s session · / filter · Esc close';
+const HISTORY_FOOTER = '↑↓ navigate · Enter/c copy · f fork · → detail · s session · / filter · Esc close';
 /**
  * Content-row budget inside the framed overlay: showOverlay slices the
  * component's lines at maxHeight ('85%' of the terminal — pi-tui floors the
@@ -372,11 +372,14 @@ export class HistoryBrowserPanel {
     sessionId;
     live;
     turns;
+    /** The browsed session's raw events — the fork-at-turn slice source. */
+    events;
     query = '';
     rows;
     status;
     closed = false;
     pickerLoading = false;
+    forkInProgress = false;
     /**
      * Where the keyboard lives: the left list (default) or the right detail
      * pane. `→` hands focus to the detail pane, `←`/Esc step back; only the
@@ -397,6 +400,7 @@ export class HistoryBrowserPanel {
         this.sessionId = loaded.sessionId;
         this.live = loaded.live;
         this.turns = groupHistoryTurns(loaded.events);
+        this.events = loaded.events;
         this.rows = historyRows(this.turns, '');
         this.listMax = listMaxVisible();
         this.builtBudget = overlayContentBudget();
@@ -434,6 +438,8 @@ export class HistoryBrowserPanel {
             shortcuts: {
                 c: () => this.copySelected(),
                 s: () => { void this.openSessionPicker(); },
+                // Fork at the selected turn (confirmed in a dialog over the browser).
+                f: () => { void this.forkAtSelectedTurn(); },
                 // Detail paging rides the list's shortcut map: the TablePanel checks
                 // shortcuts only OUTSIDE filter-input mode (the engaged input returns
                 // before the shortcut lookup), so `[`/`]` type into the query while
@@ -527,6 +533,12 @@ export class HistoryBrowserPanel {
                 this.detail.scrollByPage(1);
                 return;
             }
+            // The selection is the same whichever pane is keyed: `f` forks at it
+            // from the detail focus too.
+            if (data === 'f') {
+                void this.forkAtSelectedTurn();
+                return;
+            }
             return;
         }
         // List focus: `→` hands focus to the detail pane — except while the
@@ -607,6 +619,7 @@ export class HistoryBrowserPanel {
         this.sessionId = loaded.sessionId;
         this.live = loaded.live;
         this.turns = groupHistoryTurns(loaded.events);
+        this.events = loaded.events;
         this.query = '';
         this.status = undefined;
         this.rows = historyRows(this.turns, '');
@@ -669,6 +682,41 @@ export class HistoryBrowserPanel {
         picker = new TablePanel(this.deps.theme, options);
         return picker;
     }
+    /**
+     * Fork at the selected turn (`f`): confirm over the open browser, then
+     * hand the turn-bounded seed to the fork-and-switch seam. The browsed
+     * session's events are the slice source — live snapshots and cold-read
+     * (`inspect`) events fork alike. Cancel or an empty slice (nothing
+     * completed to carry) changes nothing; a failed fork keeps the browser
+     * open with the failure on the status line plus a buffered notice.
+     */
+    async forkAtSelectedTurn() {
+        if (this.closed || this.forkInProgress)
+            return;
+        const row = this.list.selectedRow();
+        if (row === undefined)
+            return;
+        const seed = turnSeedSlice(this.events, row.turn.turn);
+        if (seed.length === 0)
+            return;
+        this.forkInProgress = true;
+        try {
+            const outcome = await this.deps.confirmForkAtTurn(row.turnLabel, this.turns.length, !this.live);
+            if (outcome !== true)
+                return;
+            await this.deps.forkAtTurn(seed, this.sessionId);
+            this.finish(`Forked at turn ${row.turnLabel} — new session opened.`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.status = `Fork failed: ${message}`;
+            this.deps.reportError(`Fork at turn ${row.turnLabel} failed: ${message}`);
+            this.deps.requestRender();
+        }
+        finally {
+            this.forkInProgress = false;
+        }
+    }
     /** Open the session picker overlay (the browser stays mounted underneath). */
     async openSessionPicker() {
         if (this.pickerLoading || this.closed)