@oh-my-pi/pi-tui 18.13.1 → 18.13.3

package/CHANGELOG.md

@@ -2,12 +2,54 @@
 
 ## [Unreleased]
 
+## [18.13.3] - 2026-10-28
+
+### Added
+
+- The resume picker renames the selected session in place: F2 opens a dialog prefilled with the current title, Enter commits, Esc cancels ([#17262](https://github.com/can1357/oh-my-pi/pull/17262) by [@Twilight0](https://github.com/Twilight0))
+
+### Changed
+
+- Updated Bun engine requirement to ≥1.4.4
+
+### Fixed
+
+- Restored WebP and JPEG images stay visible in Kitty scrollback after resuming a session ([#17220](https://github.com/can1357/oh-my-pi/issues/17220)).
+- Escape in an annotation note no longer discards it: the overlay closes and `getDraft()`/`restoreDraft()` let the host keep and reopen the note; **Discard notes and close** (confirmed by a second press) clears them instead, and code review's actions start on Paste so a stray Enter never sends the LLM review ([#17271](https://github.com/can1357/oh-my-pi/pull/17271) by [@H4vC](https://github.com/H4vC), based on [#17230](https://github.com/can1357/oh-my-pi/pull/17230) by [@Shadorain](https://github.com/Shadorain)).
+- Fixed terminal replies such as Tern's `tsp;e;{"ev":"ack",…}` showing up in the shell prompt after quitting omp; the exit drain now waits for the terminal to answer a final DA1 sentinel
+- Fixed the plan review sheet in Tern squeezing the "continue with" model tiers under a long plan, so the model name overlapped the tier buttons
+- `/usage` in Tern shows when each quota resets as a countdown (`resets in 2h30m`) instead of a clock time; hovering shows the date and time
+- Fixed extension `ui.select` dialogs treating unconfigured `j`/`k` keys as navigation, which could turn a default No into Yes when typing `ok` then Enter ([#17255](https://github.com/can1357/oh-my-pi/pull/17255) by [@SAKANA-MOONLIGHT](https://github.com/SAKANA-MOONLIGHT)).
+
+### Removed
+
+- Removed support for the TSP `t` (theme) verb, as surface theme synchronization is no longer required
+
+## [18.13.2] - 2026-10-27
+
+### Added
+
+- Added a frame-write listener (`TUI.addFrameWriteListener`) for terminal integrations that need to react to emitted ANSI output, including resize paints ([#17145](https://github.com/can1357/oh-my-pi/issues/17145))
+- `HookInputComponent` (`showHookInput`) now accepts `{ secret: true }` to mask typed characters as bullets (`•`) in input overlays ([#17080](https://github.com/can1357/oh-my-pi/pull/17080) by [@GTanger](https://github.com/GTanger))
+- Added an ANSI and native `/context` viewer with category navigation, content inspection, token-usage and compaction estimates, and keyboard/mouse controls that adapt across Tern and other terminals ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+
+### Fixed
+
+- Fixed `AskDialogComponent`'s draft input guard holding the keyboard until the draft was cleared; Up/Down (or a pointer action) now release it so the question can be answered with the draft parked, and `syncPresentation` receives the effective blocked state ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed the prompt editor's autocomplete popup (e.g. emoji suggestions after `:D`) staying open and following the cursor after Shift/Ctrl/Alt+Enter inserted a newline, so the next Enter submitted past a stale list; newlines and cursor motion (arrows, Home/End, word jumps, character jumps) now close it ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed `run_watch` failed-job rows hiding why a job's logs are unavailable; multiline `gh` errors now stay on one row ([#17173](https://github.com/can1357/oh-my-pi/pull/17173) by [@alphastorm](https://github.com/alphastorm))
+
+### Removed
+
+- Removed the static context usage report (`ContextUsageView`, `renderContextUsage`, `describeContextUsage`), `contextUsageHead()`, and the `glyph` and `color` fields of `ContextBreakdown` categories; use `ContextViewer` ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+- Fixed Markdown tables inside list items disappearing from the terminal transcript ([#17165](https://github.com/can1357/oh-my-pi/issues/17165)).
+
 ## [18.13.1] - 2026-10-27
 
 ### Added
 
 - ANSI and TSP `/pause` screens show unsettled turns and jobs, hide settled counters, and preserve counts and resume controls on short terminals ([#17073](https://github.com/can1357/oh-my-pi/pull/17073) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
-- Added `noteOption` to `ExtensionAskDialogResultItem` and `QuestionResult`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+- Added `noteOption` to `ExtensionAskDialogResultItem`, `QuestionResult`, and single-question `AskToolDetails`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
 
 ### Changed
 
@@ -2456,17 +2498,4 @@
 - Fixed TUI shutdown placing the parent shell prompt one row below short rendered content instead of directly on the next line ([#1620](https://github.com/can1357/oh-my-pi/issues/1620)).
 - Stopped painting inline color swatches for 4-digit hex runs in Markdown rendering. The `#RGBA` CSS form collides with hashline `#TAG` snapshot tags (4 hex digits, e.g. `#6C5E`), which were sprouting spurious RGB swatches in prose and codespans. Only `#RGB`, `#RRGGBB`, and `#RRGGBBAA` qualify now.
 
-## [15.7.6] - 2026-06-01
-
-### Fixed
-
-- Fixed native Windows + Windows Terminal freezing the editor on the wrap keystroke, on `/plan`/`/resume`/model-switch/status-line toggles, and on any other offscreen structural mutation until the next prompt submit. The `15.7.5` `#1635` fix routed every viewport-saturating pure-append and structural mutation through `deferredMutation` (a literal no-op) whenever `isNativeViewportAtBottom()` returned `undefined` — which it always does under `WT_SESSION` because the kernel32 probe can't see WT host scrollback. The deferral was only ever meant for the *confirmed-scrolled* case; an unknown viewport now falls back to a non-destructive `viewportRepaint` instead, so the live UI keeps updating without emitting `\x1b[3J` and without yanking a possibly-scrolled reader. Confirmed-scrolled frames (probe returns `false`) still defer.
-- Removed the hard-coded 20-result cap on `@`-prefixed fuzzy file completion in `CombinedAutocompleteProvider.#getFuzzyFileSuggestions`. The dropdown now honors the existing `maxResults: 100` ceiling already configured for `fuzzyFind`, so projects with many files sharing a common stem (e.g. `@controller`, `@test`) surface all relevant matches instead of being silently truncated. ([#1652](https://github.com/can1357/oh-my-pi/issues/1652))
-
-## [15.7.5] - 2026-06-01
-
-### Fixed
-
-- Fixed native Windows + Windows Terminal scrollback being yanked to the top when a streaming response triggered a TUI full redraw. Under ConPTY the `kernel32` `GetConsoleScreenBufferInfo` probe answers about the pseudo-console (always at the buffer tail) and not about WT's host scrollback, so `isNativeViewportAtBottom()` falsely returned `true` while the user was scrolled up and the shrink-across-viewport branch issued a destructive `historyRebuild` (`\x1b[2J\x1b[H\x1b[3J`). The probe now short-circuits to `undefined` whenever `WT_SESSION` is set, letting the existing deferred-rebuild path keep streaming-time mutations non-destructive and reconcile native history at the next prompt-submit checkpoint. ([#1635](https://github.com/can1357/oh-my-pi/issues/1635))
-
-Older entries are archived in [packages/tui/CHANGELOG.md@3d45d8557cd7](https://github.com/can1357/oh-my-pi/blob/3d45d8557cd7493221b69c7ed3c6b6a2307f46e7/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@3deb6751027b](https://github.com/can1357/oh-my-pi/blob/3deb6751027b11b10ac14b2a5c07303817276505/packages/tui/CHANGELOG.md).

package/dist/types/apps/session-picker.d.ts

@@ -4,6 +4,8 @@ export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelec
     loadPinnedIds?(): Promise<ReadonlySet<string>>;
     loadHistoryMatcher?(): SessionHistoryMatcher;
     deleteSession?(session: T): Promise<boolean>;
+    /** Rename the session and resolve with the title as stored, or null when it did not happen. */
+    renameSession?(session: T, title: string): Promise<string | null>;
     loadAllSessions?(): Promise<T[]>;
 }
 /** Presentation and capability controls for the standalone session picker. */
@@ -13,6 +15,8 @@ export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSe
     scopeLabel?: string | false;
     showCwd?: boolean;
     allowDelete?: boolean;
+    /** Rename the selected session; resolve with the title as stored, or null when it did not happen. */
+    onRename?: (session: T, title: string) => Promise<string | null>;
     allowGlobalScope?: boolean;
     historySearch?: boolean;
     pinnedIds?: ReadonlySet<string>;

package/dist/types/chat/assistant-message.d.ts

@@ -87,7 +87,7 @@ export declare class AssistantMessageComponent extends Container {
      */
     setExpanded(expanded: boolean): void;
     isTranscriptBlockFinalized(): boolean;
-    /** Whether a figure still waits for the raster of its final source; the transcript holds retirement meanwhile. */
+    /** Hold image and figure rendering until the completed block can enter immutable scrollback. */
     isTranscriptBlockPending(): boolean;
     render(width: number): readonly string[];
     /**

package/dist/types/chat/bash-execution.d.ts

@@ -37,6 +37,8 @@ export declare class BashExecutionComponent extends Container {
     appendOutput(chunk: string): void;
     /** Switch to PTY rendering and feed raw terminal bytes through the vterm replay. */
     appendPtyChunk(chunk: string): void;
+    /** Bytes a terminal would send for a key event, honoring the command's cursor-key mode; "" for key releases. */
+    encodePtyInput(data: string): string;
     setComplete(exitCode: number | undefined, cancelled: boolean, options?: {
         output?: string;
         truncation?: TruncationMeta;

package/dist/types/chat/display-preferences.d.ts

@@ -6,6 +6,8 @@ export interface ChatTranscriptDisplayPreferences {
     cacheMissMarker: boolean;
     showTokenUsage: boolean;
     showTurnTime: boolean;
+    /** Max rows a collapsed advisor card shows below its header; 0 = no cap. */
+    advisorCollapsedLines: number;
 }
 /** Current transcript display preferences. */
 export declare const chatTranscriptDisplayPreferences: ChatTranscriptDisplayPreferences;

package/dist/types/chat/tool-execution.d.ts

@@ -102,7 +102,7 @@ export declare class ToolExecutionComponent extends Container {
      * component-scoped so the TUI reuses every other root subtree (issue #4377).
      */
     tickSpinner(frame: number): void;
-    /** Whether the result's figure still waits for its raster; the transcript holds retirement meanwhile. */
+    /** Hold visible results until their figures and Kitty images are ready for immutable scrollback. */
     isTranscriptBlockPending(): boolean;
     /**
      * Whether this block is ready to retire as immutable history. Partial

package/dist/types/chrome/context-map.d.ts

@@ -0,0 +1,15 @@
+/** Pure occupancy calculations for contiguous token segments, independent of themes and renderers. */
+export interface ContextMapSegment<T> {
+    readonly id: T;
+    readonly tokens: number;
+}
+export interface ContextMapCell<T> {
+    readonly id: T;
+    readonly full: boolean;
+}
+/**
+ * Lays `segments` out in order over a `columns` × `rows` grid representing `windowTokens`; each cell takes the
+ * segment covering most of it and is `full` at 70% coverage or more. Returns `[]` when the window or grid
+ * size is unusable, and omits cells no segment touches.
+ */
+export declare function planContextMap<T>(segments: readonly ContextMapSegment<T>[], windowTokens: number, columns: number, rows: number): ContextMapCell<T>[];

package/dist/types/chrome/context-presentation.d.ts

@@ -0,0 +1,48 @@
+import type { ContextCategoryId } from "./context-view-model.js";
+export declare const CONTEXT_PRESENTATION: {
+    readonly "system-prompt": {
+        readonly color: "accent";
+        readonly symbol: "context.content";
+    };
+    readonly skills: {
+        readonly color: "success";
+        readonly symbol: "context.content";
+    };
+    readonly "built-in-tools": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "custom-tools": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "user-messages": {
+        readonly color: "accent";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-messages": {
+        readonly color: "userMessageText";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-thinking": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-calls": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-output": {
+        readonly color: "muted";
+        readonly symbol: "context.messages";
+    };
+    readonly buffer: {
+        readonly color: "warning";
+        readonly symbol: "context.buffer";
+    };
+    readonly free: {
+        readonly color: "dim";
+        readonly symbol: "context.free";
+    };
+};
+export type ContextPresentationId = ContextCategoryId | "buffer" | "free";

package/dist/types/chrome/context-view-model.d.ts

@@ -0,0 +1,77 @@
+/** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+interface ContextCategoryDescriptor {
+    readonly id: string;
+    readonly label: string;
+    /** Overview row label when the Overview weight differs from the category's content. */
+    readonly overviewLabel?: string;
+    /** Listed with its weight but never opened. */
+    readonly openable?: false;
+}
+/** Context categories in display order. */
+export declare const CONTEXT_CATEGORIES: readonly [{
+    readonly id: "system-prompt";
+    readonly label: "System Prompt";
+    readonly overviewLabel: "System Prompt (excluding Skills)";
+}, {
+    readonly id: "skills";
+    readonly label: "Skills";
+    readonly openable: false;
+}, {
+    readonly id: "built-in-tools";
+    readonly label: "Built-in Tools";
+}, {
+    readonly id: "custom-tools";
+    readonly label: "Custom Tools";
+}, {
+    readonly id: "user-messages";
+    readonly label: "User / Developer Messages";
+}, {
+    readonly id: "assistant-messages";
+    readonly label: "Assistant Messages";
+}, {
+    readonly id: "assistant-thinking";
+    readonly label: "Assistant Thinking";
+}, {
+    readonly id: "tool-calls";
+    readonly label: "Tool Calls";
+}, {
+    readonly id: "tool-output";
+    readonly label: "Tool Output";
+}];
+export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
+/** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
+export declare function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor;
+export interface ContextThinkingGroup {
+    readonly id: string;
+    readonly label: string;
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+}
+export interface ContextViewEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly text: string;
+    /** Aggregation weight for the unscaled replay estimate; shared blocks contribute through their group. */
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+    readonly thinkingGroup?: ContextThinkingGroup;
+    readonly path?: string;
+    readonly info?: string;
+    readonly timestamp?: number;
+    readonly callId?: string;
+}
+export interface ContextViewCategory {
+    id: ContextCategoryId;
+    key?: string;
+    label: string;
+    /** Overview attribution weight, not reported usage; may differ from the entry sum (e.g. Skills subtraction). */
+    tokens: number;
+    entries: ContextViewEntry[];
+    children?: ContextViewCategory[];
+}
+export interface ContextViewData {
+    readonly breakdown: ContextBreakdown;
+    readonly categories: readonly ContextViewCategory[];
+}
+export {};

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

@@ -98,6 +98,8 @@ export declare class Editor implements Component, Focusable {
     describeDecorations: ((lines: readonly string[]) => readonly TspEditorDecoration[]) | undefined;
     /** TSP code language of the buffer (`python`, `bash`): the terminal highlights it in the mono face. */
     describeLanguage: (() => string | undefined) | undefined;
+    /** Label the TSP field to disable host-side editing while another input owner handles raw keys. */
+    nativeKeyPassthrough: boolean;
     /**
      * TSP chrome around the `editor` node (the prompt composer's chips, mode
      * chip, send/stop): the root role, the children with `input` placed where

package/dist/types/overlays/advisor-config.d.ts

@@ -22,8 +22,10 @@ import { type ModelBrowserSource } from "./model-browser.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 export declare const ADVISOR_REVIEW_MODES: readonly ["turn", "agent-end"];
 export declare const ADVISOR_SYNC_BACKLOG_MODES: readonly ["off", "1", "3", "5", "strict"];
+export declare const ADVISOR_SESSION_SCOPES: readonly ["main", "subagent", "all"];
 export type AdvisorReviewMode = (typeof ADVISOR_REVIEW_MODES)[number];
 export type AdvisorSyncBacklog = (typeof ADVISOR_SYNC_BACKLOG_MODES)[number];
+export type AdvisorSessionScope = (typeof ADVISOR_SESSION_SCOPES)[number];
 /** One advisor declared in `WATCHDOG.yml`; its instructions specialize the shared baseline. */
 export interface AdvisorConfig {
     name: string;
@@ -39,6 +41,10 @@ export interface AdvisorConfig {
     reviewMode?: AdvisorReviewMode;
     reviewInterval?: number;
     syncBacklog?: AdvisorSyncBacklog;
+    /** Which session kinds this advisor attaches to (`main`, `subagent`, or `all`; defaults to `all`). */
+    scope?: AdvisorSessionScope;
+    /** Whether primary assistant thinking blocks are included in updates sent to this advisor (defaults to `true`). */
+    includeReasoning?: boolean;
 }
 /** Which level a `WATCHDOG.yml` lives at: the project root or the user agent dir. */
 export type AdvisorConfigScope = "project" | "user";

package/dist/types/overlays/annotation-overlay.d.ts

@@ -1,7 +1,7 @@
 import { type Focusable, type TUI } from "../index.js";
 import { type KeybindingsManager } from "../app-keybindings.js";
 import { type Theme } from "../theme/theme.js";
-import type { CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
+import type { AnnotationOverlayDraft, CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
 import type { TspSpan } from "@oh-my-pi/pi-wire";
 import { type NativeNode, type NativeUiEvent } from "../native/node.js";
 export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
@@ -20,6 +20,8 @@ export interface CodeReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
 export interface TextReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
     onComplete(result: TextReviewOverlayResult | undefined): void;
 }
+/** Clears every note and closes; the host then has nothing to keep. Needs a second confirm. */
+export declare const DISCARD_ANNOTATIONS_ACTION = "Discard notes and close";
 /** Splits a text source into the overlay's 1-based annotatable lines. */
 export declare function splitTextLines(text: string): string[];
 /** The native sheet: full-pane glass, titled by the review kind with what is under review after it. */
@@ -38,6 +40,10 @@ export declare class AnnotationOverlay implements Focusable {
     setUseTerminalCursor(useTerminalCursor: boolean): void;
     invalidate(): void;
     dispose(): void;
+    /** Notes, the unfinished note, and any source edit, in the form {@link restoreDraft} replays. */
+    getDraft(): AnnotationOverlayDraft;
+    /** Replay a draft taken from this same source; anything anchored outside it is dropped. */
+    restoreDraft(draft: AnnotationOverlayDraft): void;
     getAnnotations(): CodeReviewAnnotation[];
     getTextAnnotations(): TextReviewAnnotation[];
     /** Repo-relative path of the diff file under the cursor, if this is a code review. */

package/dist/types/overlays/annotation-types.d.ts

@@ -84,3 +84,31 @@ export interface TextReviewOverlayResult {
     /** Source text after an external-editor edit; absent when the source was not edited. */
     editedText?: string;
 }
+export type AnnotationOverlayDraft = {
+    kind: "diff";
+    annotations: {
+        fileIndex: number;
+        sourceIndex: number;
+        annotation: CodeReviewAnnotation;
+    }[];
+    editor?: {
+        fileIndex: number;
+        sourceIndex: number;
+        scope: "file" | "line";
+        editingAnnotationIndex?: number;
+        text: string;
+    };
+} | {
+    kind: "text";
+    annotations: {
+        sourceIndex: number;
+        annotation: TextReviewAnnotation;
+    }[];
+    editedText?: string;
+    editor?: {
+        sourceIndex: number;
+        scope: "text" | "line";
+        editingAnnotationIndex?: number;
+        text: string;
+    };
+};

package/dist/types/overlays/ask-dialog.d.ts

@@ -61,14 +61,21 @@ interface AskDialogCallbacks {
     /** Prompt that accepts pasted images; without it, prompts use `onPrompt`. */
     onImagePrompt?(prompt: AskDialogPrompt, prefill: AskDialogPromptValue | undefined): Promise<AskDialogPromptValue | undefined>;
 }
+/**
+ * Routes typing to a composer draft that was in progress when the dialog
+ * opened, so in-flight keystrokes never answer by accident. The up/down select
+ * keys are the explicit hand-off: they release the guard for the rest of the
+ * dialog's life and the draft stays parked (intact) beneath it.
+ */
 interface AskDialogInputGuard {
     isBlocked(): boolean;
     handleInput(keyData: string): void;
+    /** Shown after the release keys while the guard holds input. */
     hint: string;
     /** Mirror the guard's blocked state onto the proxied draft surface each
      *  render, so a draft that owns input shows a visible insertion cursor even
-     *  though this dialog holds TUI focus. */
-    syncPresentation?(): void;
+     *  though this dialog holds TUI focus, and drops it once the dialog takes over. */
+    syncPresentation?(blocked: boolean): void;
 }
 interface AskDialogOptions {
     timeout?: number;

package/dist/types/overlays/context-viewer-format.d.ts

@@ -0,0 +1,42 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextCategoryId, ContextThinkingGroup, ContextViewEntry } from "../chrome/context-view-model.js";
+/** Normalized newlines, control characters removed, tabs expanded. */
+export declare function safeContent(value: string): string;
+/** {@link safeContent} with embedded home paths shortened, for labels and metadata. */
+export declare function safeText(value: string): string;
+/** {@link safeText} collapsed to one row. */
+export declare function safeLine(value: string): string;
+/** Token label of an entry or group: `—` for a grouped entry, `N/A · Interrupted`, else `N token(s)` (unscaled estimate). */
+export declare function tokenEstimate(item: ContextViewEntry | ContextThinkingGroup): string;
+/** `[label] N tokens` as ANSI. */
+export declare function entryHeaderLine(entry: ContextViewEntry, category: ContextCategoryId): string;
+/** `[label] N tokens` as spans. */
+export declare function entryHeaderSpans(entry: ContextViewEntry, category: ContextCategoryId): TspSpan[];
+/** Heading for a shared thinking group: label plus its token estimate. */
+export declare function groupHeaderLine(group: ContextThinkingGroup, category: ContextCategoryId): string;
+/** Truncation marker under a preview; the selected preview also advertises the open key. */
+export declare function previewHint(selected: boolean): string;
+/**
+ * Metadata rows: info and path, call id, timestamp. The full-content view also
+ * lists the thinking group, which previews show as a shared heading instead.
+ */
+export declare function entryMetadata(entry: ContextViewEntry, options: {
+    hour12: boolean | undefined;
+    withGroup: boolean;
+}): string[];
+/** Preview row budget for a list of `height` rows: room for the entry heading, hint, and group heading. */
+export declare function previewRows(entry: ContextViewEntry, height: number): number;
+export interface EntryPreviewOptions {
+    /** Wrap width of preview rows. */
+    readonly width: number;
+    /** Maximum preview rows. */
+    readonly rows: number;
+    /** Viewport width; bounds the source read to `sourceWidth × rows × 2` characters before sanitizing and wrapping. */
+    readonly sourceWidth: number;
+    readonly hour12: boolean | undefined;
+}
+/** Dim metadata rows, then the indented body, cut to `rows`; `complete` is false when anything was omitted. */
+export declare function entryPreview(entry: ContextViewEntry, options: EntryPreviewOptions): {
+    lines: string[];
+    complete: boolean;
+};

package/dist/types/overlays/context-viewer-overview.d.ts

@@ -0,0 +1,70 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+import { type ContextMapCell } from "../chrome/context-map.js";
+import { type ContextPresentationId } from "../chrome/context-presentation.js";
+import type { NativeNode } from "../native/node.js";
+import type { ThemeColor } from "../theme/index.js";
+import { type ContextViewCategory, type ContextViewData } from "../chrome/context-view-model.js";
+/** Columns between the map and the legend. */
+export declare const MAP_LEGEND_GAP = 3;
+export interface OverviewRow {
+    readonly key: string;
+    readonly id: ContextPresentationId;
+    readonly label: string;
+    /** Attributed usage; undefined when the weights cannot scale current usage. */
+    readonly tokens: number | undefined;
+    /** Category opened on confirm; undefined rows are listed but not selectable. */
+    readonly category?: ContextViewCategory;
+    readonly child?: boolean;
+    /** Right-aligned token column. */
+    readonly tokenColumn: string;
+    /** Right-aligned share column, including its leading separator. */
+    readonly shareColumn: string;
+}
+export interface MapGeometry {
+    readonly columns: number;
+    readonly rows: number;
+    readonly cellWidth: number;
+    readonly gap: string;
+    readonly width: number;
+}
+/**
+ * Attribute current usage to categories by weight, then each category's share to its children.
+ * Attributed values are not entry sums: entries keep their unscaled content/replay estimates.
+ * Undefined when the top-level weights cannot scale; unscalable children stay unattributed.
+ */
+export declare function allocateUsage(categories: readonly ContextViewCategory[], usage: number): Map<ContextViewCategory, number> | undefined;
+/** Overview row label for a category: its Overview-specific label when the weight differs from its content. */
+export declare function overviewLabel(category: ContextViewCategory): string;
+/** Category and child rows, then buffer and free space, with aligned token and share columns. */
+export declare function buildOverviewRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number> | undefined): OverviewRow[];
+/** ANSI legend row: cursor, swatch, label padded to `width`, token and share columns. */
+export declare function legendLine(row: OverviewRow, selected: boolean, width: number): string;
+/** Native legend item; `meterGlyphs` swaps map glyphs for the meter's bar glyphs. */
+export declare function legendItem(row: OverviewRow, selected: boolean, meterGlyphs: boolean, window: number): NativeNode;
+/** Map size beside a legend in a `width` × `height` body; undefined when either would not fit. */
+export declare function mapGeometry(width: number, height: number): MapGeometry | undefined;
+/** Map cells per row, in window order: categories, free space, then buffer. */
+export declare function planMapRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number>, geometry: MapGeometry): ContextMapCell<ContextPresentationId>[][];
+/** ANSI map row; partially filled cells are dim. */
+export declare function mapRowLine(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): string;
+/** Native map row; partially filled cells are dim. */
+export declare function mapRowSpans(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): TspSpan[];
+/** Snapcompact savings lines of the Overview; empty when no snapcompact setting is on. */
+export declare function contextSnapcompactLines(breakdown: ContextBreakdown): string[];
+interface ContextMeterData extends Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "autoCompactBufferTokens" | "thresholdTokens"> {
+    categories: readonly {
+        label: string;
+        tokens: number;
+        color: ThemeColor;
+    }[];
+}
+/** Shared usage and compaction labels for ANSI and native context views. */
+export declare function contextUsageSummary(breakdown: Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "thresholdTokens">): {
+    used: string;
+    detail: string;
+    room: string;
+};
+/** Native usage summary and stacked bar; callers provide the category list. */
+export declare function describeContextMeter(breakdown: ContextMeterData): [NativeNode, NativeNode];
+export {};

package/dist/types/overlays/context-viewer.d.ts

@@ -0,0 +1,25 @@
+import type { ContextViewData } from "../chrome/context-view-model.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { Component } from "../tui.js";
+/**
+ * Read-only context snapshot with three states: Overview → category previews → full entry content.
+ * Navigation state is shared; `render` (ANSI) and `describe` (native) each draw every state,
+ * via `#render<State>` and `#describe<State>` respectively.
+ */
+export declare class ContextViewer implements Component {
+    #private;
+    constructor(data: ContextViewData, options: {
+        onClose: () => void;
+        requestRender: () => void;
+        getRows: () => number;
+    });
+    invalidate(): void;
+    dispose(): void;
+    get nativeOverlay(): NonNullable<Component["nativeOverlay"]>;
+    /** Capture only handled navigation keys; the focus path consumes other modal input. */
+    capturesInput(data: string): boolean;
+    handleInput(data: string): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    render(width: number): readonly string[];
+    describe(cx: DescribeContext): NativeNode;
+}

package/dist/types/overlays/hook-input.d.ts

@@ -8,6 +8,7 @@ export interface HookInputOptions {
     tui?: TUI;
     timeout?: number;
     onTimeout?: () => void;
+    secret?: boolean;
 }
 export declare class HookInputComponent extends OverlayPanel {
     #private;

package/dist/types/overlays/plan-review-overlay.d.ts

@@ -74,6 +74,8 @@ export interface PlanReviewOverlayOptions {
     slider?: HookSelectorSlider;
     /** Display label for the external-editor key, surfaced in the footer help. */
     externalEditorLabel?: string;
+    /** The external editor's name ("Notepad", "nvim") for the native Edit button; `$EDITOR` when unset. */
+    externalEditorName?: string;
     /** Serializable annotations restored into this overlay instance. */
     annotationState?: PlanReviewAnnotationState;
 }

package/dist/types/overlays/running-subagent-badge.d.ts

@@ -1,6 +1,12 @@
-import type { AgentHubRegistry } from "./agent-hub-types.js";
+import { type AgentHubRegistry } from "./agent-hub-types.js";
 export interface RunningSubagentRegistrySource<T extends AgentHubRegistry = AgentHubRegistry> {
     agentRegistry: T;
 }
 export declare function getRunningSubagentBadgeRegistry<T extends AgentHubRegistry>(collabGuest: RunningSubagentRegistrySource<T> | undefined, localRegistry: T): T;
 export declare function getRunningSubagentBadgeAgentIds(registry: AgentHubRegistry): string[];
+/**
+ * Agents the Agent Hub roster can show (every registry ref but the main
+ * session), whatever their status: finished, parked and killed subagents
+ * stay inspectable after the last one stops running.
+ */
+export declare function getInspectableSubagentCount(registry: AgentHubRegistry): number;

package/dist/types/overlays/session-selector.d.ts

@@ -71,6 +71,7 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     onExit: () => void;
     onToggleScope?: () => void;
     onDeleteRequest?: (session: T) => void;
+    onRenameRequest?: (session: T) => void;
     /** Re-render hook for async list updates (fuzzy scan completion, history merge). */
     onRequestRender?: () => void;
     constructor(sessions: T[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number, pinnedIds?: ReadonlySet<string>, currentSessionPath?: string | (() => string | undefined));
@@ -79,6 +80,8 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     /** Cancel pending async search work; idempotent, called on every picker exit path. */
     dispose(): void;
     removeSession(sessionPath: string): void;
+    /** Update a session's title in place and refresh the visible list, keeping the selection. */
+    renameSessionTitle(sessionPath: string, title: string): void;
     /** Resolve a list-local rendered-line index to a filtered-session index. */
     hitTestSession(line: number): number | undefined;
     /** Wheel notch: move the selection one step (clamped, no wrap). */
@@ -93,6 +96,8 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
     resumeSelected(): void;
     /** Delete / Backspace on an empty query: ask the parent to confirm deleting the selected session. */
     requestDelete(): void;
+    /** F2: ask the parent to rename the selected session. */
+    requestRename(): void;
     /** Empty the search query (the empty state's "Clear search"). */
     clearSearch(): void;
     get selectedSession(): T | undefined;
@@ -120,6 +125,12 @@ declare class SessionList<T extends SessionSelectorEntry> implements Component {
 }
 export interface SessionSelectorOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
     onDelete?: (session: T) => Promise<boolean>;
+    /**
+     * Rename the selected session to a user-supplied title; resolve with the
+     * title as stored (the session canonicalizes it) or null when the rename
+     * did not happen.
+     */
+    onRename?: (session: T, title: string) => Promise<string | null>;
     historyMatcher?: SessionHistoryMatcher;
     /** Loads sessions across all projects for the all-projects scope toggle (Tab). */
     loadAllSessions?: () => Promise<T[]>;
@@ -188,8 +199,8 @@ export declare class SessionSelectorComponent<T extends SessionSelectorEntry = S
     /**
      * With the `picker` kind: the data-first session picker (§4.7). Otherwise
      * scope `tabs`, loading/error message, then the search `input` and session
-     * `list` — or the delete-confirmation dialog in their place, as on the ANSI
-     * path — and the key-hint footer.
+     * `list` — or the delete-confirmation / rename dialog in their place, as on
+     * the ANSI path — and the key-hint footer.
      */
     describe(cx: DescribeContext): NativeNode;
     /** Picker events (root keypath); fallback: scope tab → toggle scope, click on a session → resume it, exactly like a mouse click. */