@oh-my-pi/pi-tui 18.10.0 → 18.10.2

package/dist/types/overlays/jobs-panel.d.ts

@@ -42,12 +42,13 @@ export interface JobsSheetSource {
 }
 /**
  * The jobs pill's sheet: a centred `lg` glass sheet titled Background jobs.
- * A selectable list of every job (running first) sits over the selected
- * job's detail: status and live elapsed (a task job's `agent` node), cwd,
- * live pids, exit code, the full command and a tail-following output pane.
- * It re-reads the session every frame, so the caller re-renders it on a
- * timer while it is open. ↑/↓ select, X cancels the selected running job,
- * Esc or Close dismisses; nothing enters the transcript.
+ * A master–detail split (it stacks in a narrow pane): the selectable job list,
+ * grouped Running / Recent, beside the selected job's detail — a status pill
+ * with live elapsed and Cancel job, its command or task, facts (agent, cwd,
+ * live pids, exit code, artifact) and a tail-following output pane. With no
+ * jobs it shows an empty state. It re-reads the session every frame, so the
+ * caller re-renders it on a timer while it is open. ↑/↓ select, X cancels the
+ * selected running job, Esc or Close dismisses; nothing enters the transcript.
  */
 export declare class JobsSheet implements Component {
     #private;
@@ -58,7 +59,7 @@ export declare class JobsSheet implements Component {
         readonly head: "Background jobs";
     };
     constructor(source: JobsSheetSource);
-    describe(cx: DescribeContext): NativeNode;
+    describe(_cx: DescribeContext): NativeNode;
     /** Rows for a terminal without the native surface: one per job, then the selected job's facts and output tail. */
     render(width: number): readonly string[];
     invalidate(): void;

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

@@ -40,9 +40,14 @@ export declare class LoginDialogComponent extends OverlayPanel {
     showProgress(message: string): void;
     /**
      * A glass sheet over the composer (the dialog replaces the editor in the
-     * dock; the `overlay` hoists into the terminal's layer): numbered steps —
-     * open or copy the sign-in link, the device code, the live wait, the paste
-     * field — and Cancel.
+     * dock; the `overlay` hoists into the terminal's layer). Top to bottom: one
+     * sentence saying what to do, the device code as a large click-to-copy
+     * well, the sign-in link as a read-only field with Copy, the questions
+     * (answered ones as label/value lines, the live one as a field), and the
+     * flow's status — finished stages checked, the current one spinning. The
+     * footer holds Cancel and one primary action: Continue while a field waits
+     * for an answer (Open sign-in page then leads the footer as a plain
+     * button), else Open sign-in page.
      */
     describe(): NativeNode;
     /** Cancel and Continue run what Esc and Enter run. */

package/dist/types/overlays/mcp-add-wizard.d.ts

@@ -83,8 +83,16 @@ interface MCPAddWizardOAuthOptions {
 export declare class MCPAddWizard extends OverlayPanel {
     #private;
     constructor(deps: MCPAddWizardDeps, onComplete: (name: string, config: MCPAddWizardConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string, options?: MCPAddWizardOAuthOptions) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPAddWizardConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    /**
+     * The sheet: the phase strip, the step's title and lead, its body (field,
+     * status, summary), its choices, and a footer whose buttons run what
+     * Escape, Enter and Ctrl+C run.
+     */
     describe(_cx: DescribeContext): NativeNode;
-    /** A click on a choice is Enter on it, exactly as highlighting it with the arrows and pressing Enter. */
+    /**
+     * A click on a choice is Enter on it, exactly as highlighting it with the
+     * arrows and pressing Enter; the footer's buttons run what their keys run.
+     */
     handleNativeEvent(event: NativeUiEvent): void;
     handleInput(keyData: string): void;
 }

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

@@ -4,7 +4,7 @@ import type { Component } from "../tui.js";
 import type { SgrMouseEvent } from "../mouse.js";
 import { type ConfiguredThinkingLevel } from "../thinking.js";
 import { type ThemeColor } from "../theme/theme.js";
-import type { TspPickerColumn, TspPickerGroup, TspPickerItem } from "@oh-my-pi/pi-wire";
+import type { TspPickerColumn, TspPickerGroup, TspPickerItem, TspPickerMark } from "@oh-my-pi/pi-wire";
 import type { NativeChild, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Canonical display ordering of built-in model roles. */
 export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "commit" | "tiny" | "memory" | "task" | "advisor" | "image" | "web" | "speech" | "dictation" | "judge";
@@ -198,6 +198,11 @@ export declare function rankModelItems(query: string, items: ReadonlyArray<Model
 export declare function formatRoleChip(role: string, assignment: RoleAssignment, settings: ModelBrowserSource): string;
 /** Fact columns of a model picker (Stencil `NATIVE_REDESIGN.md` §4.7); the lowest priority hides first. */
 export declare const MODEL_PICKER_COLUMNS: readonly TspPickerColumn[];
+/**
+ * A provider's picker mark: the terminal's logo for it, else its initials
+ * (`amazon-bedrock` → `AB`, `anthropic` → `An`) on its own gradient.
+ */
+export declare function providerMark(providerId: string): TspPickerMark;
 /** The omp theme token of a thinking level's dot (`thinkingHigh`); none for inherit and auto. */
 export declare function thinkingDotToken(level: ConfiguredThinkingLevel): string | undefined;
 /**

package/dist/types/overlays/pause-screen.d.ts

@@ -41,6 +41,11 @@ export declare class PauseScreenComponent implements Component, OverlayFocusOwne
         readonly anchor: "center";
         readonly head: "Paused";
     };
+    /**
+     * The sheet: a hero (the pause glyph beside the live hold clock and the
+     * session it holds), what the hold means as four facts, and a footer that
+     * reassures and resumes. The resume keys live in the button's tooltip.
+     */
     describe(): NativeNode;
     /** Resume runs what Esc/Enter/Space run. */
     handleNativeEvent(event: NativeUiEvent): void;

package/dist/types/overlays/report-panel.d.ts

@@ -55,7 +55,11 @@ export declare class ReportPanel extends OverlayPanel {
     render(width: number): readonly string[];
     /** Text mode: rows the whole box takes at `width` when nothing caps it. */
     heightAt(width: number): number;
-    /** The sheet body (the overlay is the frame, and its body the scroller): the report, then Close (Esc). */
+    /**
+     * The sheet body (the overlay is the frame, and its body the scroller): the
+     * report as `omp.report.body`, which the terminal sets on the reading
+     * measure, then Close (Esc) as the sheet's footer.
+     */
     describe(): NativeNode;
     invalidate(): void;
     /**

package/dist/types/overlays/reset-usage-selector.d.ts

@@ -1,6 +1,6 @@
 import type { UsageResetCreditDetail } from "@oh-my-pi/pi-ai";
 import { OverlayPanel } from "../chrome/overlay-box.js";
-import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** One account row with its redeemable rate-limit reset credits. */
 export interface ResetUsageAccount {
     label: string;
@@ -33,11 +33,13 @@ export declare class ResetUsageSelectorComponent extends OverlayPanel {
     #private;
     constructor(accounts: ResetUsageAccount[], onSelect: (account: ResetUsageAccount) => void, onCancel: () => void);
     handleInput(keyData: string): void;
-    describe(): NativeNode;
+    describe(cx: DescribeContext): NativeNode;
     /**
-     * A click (or double-click) on an account highlights it and presses Enter:
-     * moving to another account drops a pending confirmation, so spending a
-     * reset still takes a second activation of the same account.
+     * Picker: a row click selects, a double-click or `Spend reset` presses
+     * Enter (so spending still takes a second activation, on the confirm
+     * strip), the strip's `Keep` drops the confirmation and `Close` cancels.
+     * Card list: a click (or double-click) on an account highlights it and
+     * presses Enter.
      */
     handleNativeEvent(event: NativeUiEvent): void;
 }

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

@@ -1,5 +1,6 @@
 import { type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Stored account identity rendered and matched by the session account picker. */
 export interface SessionPinAccount {
     position: number;
@@ -17,6 +18,9 @@ export interface SessionPinAccount {
 export declare class SessionAccountSelectorComponent extends OverlayPanel {
     #private;
     constructor(providerName: string, accounts: readonly SessionPinAccount[], onSelect: (account: SessionPinAccount) => void, onCancel: () => void);
+    describe(cx: DescribeContext): NativeNode | null;
+    /** Picker pointer events drive the list exactly as its keys do. */
+    handleNativeEvent(event: NativeUiEvent): void;
     /** Forward keyboard navigation and cancellation when the wrapper owns focus. */
     handleInput(keyData: string): void;
     /** Route mouse selection through the title rows into the account list. */

package/dist/types/overlays/session-info-overlay.d.ts

@@ -24,9 +24,13 @@ export declare class SessionInfoOverlay implements Component {
     setIgnoreTight(ignore: boolean): this;
     dispose(): void;
     /**
-     * The sheet body (the overlay is the frame): the session id in mono
-     * (click copies), each report heading as a section of key/value rows, a
-     * context meter after the leading block, and a Close button (Esc).
+     * The sheet body (the overlay is the frame), in three tiers: who the session
+     * is (the id and file as copyable mono fields), how full its context window
+     * is (a meter under a right-aligned figure), then the report's sections as
+     * headed groups. Groups of plain counts (Messages, Tokens, Cost) share a
+     * two-column stats grid with right-aligned figures and their Total set off
+     * last; the rest (Provider, servers) are key/value rows. A Close button (Esc)
+     * ends it.
      */
     describe(cx: DescribeContext): NativeNode;
     /** The Close button runs Esc's path. */

package/dist/types/overlays/usage-dashboard.d.ts

@@ -122,12 +122,12 @@ export declare class UsageDashboardComponent implements Component {
     dispose(): void;
     render(width: number): readonly string[];
     /**
-     * The sheet body (the terminal's `lg` overlay is the frame): a head row
-     * (checked ago, Overview/Details tabs, Refresh), then either the provider
-     * grid of frames with window meters and the activity heatmap, or the
-     * per-provider detail tables, then Close like the other report sheets.
-     * `meter`/`chart` fall back to `progress`/`table` on terminals without
-     * them. Rebuilt only when its inputs change.
+     * The sheet body (the terminal's `lg` overlay is the frame): a toolbar
+     * (Overview/Details, freshness, Refresh), then either the overview — a
+     * strip of headline figures, the quota rows per provider, the activity
+     * calendar — or the per-provider detail tables, then Close like the other
+     * report sheets. `meter`/`chart` fall back to `progress`/`table` on
+     * terminals without them. Rebuilt only when its inputs change.
      */
     describe(cx: DescribeContext): NativeNode;
     /** Tab clicks switch views like Enter/Esc; the Refresh button runs `r`; Close closes from either view. */

package/dist/types/status-line/context-usage.d.ts

@@ -155,7 +155,7 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
-/** The `/context` title: the model and its window once a model is selected. */
+/** The `/context` title: the model once one is selected (the body leads with its window). */
 export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
 /**
  * Native context-usage panel for terminals without `meter`: the cell grid as

package/dist/types/tools/bash.d.ts

@@ -31,8 +31,9 @@ export interface BashToolDetails {
         timedOut: boolean;
         pid?: number;
     };
+    /** Background job behind the call; `cancelled`: killed (`proc://<id>/kill`) before it finished. */
     async?: {
-        state: "running" | "completed" | "failed";
+        state: "running" | "completed" | "failed" | "cancelled";
         jobId: string;
         type: "bash";
     };

package/dist/types/tools/eval.d.ts

@@ -44,9 +44,9 @@ export interface EvalToolDetails {
     languages?: EvalLanguage[];
     /** Optional human-readable notice (e.g. fallback explanation). */
     notice?: string;
-    /** Present when the cell was auto-backgrounded as an async job. */
+    /** Present when the cell was auto-backgrounded as an async job; `cancelled`: killed before it finished. */
     async?: {
-        state: "running" | "completed" | "failed";
+        state: "running" | "completed" | "failed" | "cancelled";
         jobId: string;
         type: "eval";
     };

package/dist/types/tools/grouped-file-output.d.ts

@@ -121,9 +121,12 @@ export declare function numberedCode(lines: readonly NumberedLine[], opts?: {
  * header's suffix or the match count as a chip), then its lines as
  * {@link numberedCode} with match lines marked and `…` between non-adjacent
  * runs. Unnumbered body lines stay plain `code`. `maxFiles` keeps only the
- * first files (the caller says how many were left out).
+ * first files (the caller says how many were left out). `file` owns the lines
+ * before any header: a single-file search prints none, yet its lines get the
+ * same file row as a directory search's.
  */
 export declare function describeGroupedOutput(lines: readonly string[], options?: {
     lang?: (path: string) => string | undefined;
     maxFiles?: number;
+    file?: string;
 }): NativeNode[];

package/dist/types/tools/native-view.d.ts

@@ -85,7 +85,7 @@ export interface RunFootInput {
     readonly state: RunState;
     /** Exit code of a `failed` run; a non-zero code names the state `exit N`. */
     readonly exitCode?: number;
-    /** Milliseconds run so far (`running`) or in total; the time is omitted when undefined. */
+    /** Milliseconds run so far (`running`, a live `background` job) or in total; omitted when undefined. */
     readonly elapsedMs?: number;
     /** Quiet facts (job id, service state, artifact), muted and ` · `-joined. */
     readonly facts?: readonly string[];

package/dist/types/tools/read.d.ts

@@ -20,6 +20,12 @@ export interface ReadToolDetails {
     truncation?: ReadTruncationStats;
     isDirectory?: boolean;
     resolvedPath?: string;
+    /**
+     * Absolute path of the disk file whose image this read returned. A native TSP host that
+     * supports `media` shows the file by path instead of the uploaded image bytes. Unset for
+     * screenshots, URL reads and other images not backed by a file. Display-only.
+     */
+    mediaPath?: string;
     suffixResolution?: {
         from: string;
         to: string;
@@ -140,7 +146,7 @@ export declare const readToolRenderer: {
         }>;
         details?: ReadToolDetails;
         isError?: boolean;
-    }, _options: RenderResultOptions, args?: ReadRenderArgs): NativeToolView;
+    }, options: RenderResultOptions, args?: ReadRenderArgs): NativeToolView;
     mergeCallAndResult: true;
 };
 /** Inclusive line range describing one elided span in a structural summary. */

package/dist/types/tools/renderer.d.ts

@@ -33,6 +33,8 @@ export interface RenderResultOptions {
     elapsedMs?: number;
     /** The call was abandoned without a final result (turn aborted, sealed). Native describe hooks only. */
     cancelled?: boolean;
+    /** The native host shows files by path (`cx.supports("media")`). Native describe hooks only. */
+    media?: boolean;
 }
 /** Render options for a result, plus the tool-specific context the transcript threads through. */
 export type RenderResultContextOptions = RenderResultOptions & {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.10.0",
+	"version": "18.10.2",
 	"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.10.0",
-		"@oh-my-pi/pi-agent-core": "18.10.0",
-		"@oh-my-pi/pi-ai": "18.10.0",
-		"@oh-my-pi/pi-catalog": "18.10.0",
-		"@oh-my-pi/pi-natives": "18.10.0",
-		"@oh-my-pi/pi-utils": "18.10.0",
-		"@oh-my-pi/pi-wire": "18.10.0",
-		"@oh-my-pi/snapcompact": "18.10.0"
+		"@oh-my-pi/omptype": "18.10.2",
+		"@oh-my-pi/pi-agent-core": "18.10.2",
+		"@oh-my-pi/pi-ai": "18.10.2",
+		"@oh-my-pi/pi-catalog": "18.10.2",
+		"@oh-my-pi/pi-natives": "18.10.2",
+		"@oh-my-pi/pi-utils": "18.10.2",
+		"@oh-my-pi/pi-wire": "18.10.2",
+		"@oh-my-pi/snapcompact": "18.10.2"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/app-keybindings.ts

@@ -57,8 +57,8 @@ interface AppKeybindings {
 	"app.session.rename": true;
 	"app.session.delete": true;
 	"app.session.deleteNoninvasive": true;
-	"app.tree.foldOrUp": true;
-	"app.tree.unfoldOrDown": true;
+	"app.tree.previousBranch": true;
+	"app.tree.nextBranch": true;
 	"app.plan.toggle": true;
 	"app.history.search": true;
 	"app.stt.pushToTalk": true;
@@ -227,13 +227,13 @@ export const KEYBINDINGS = {
 		defaultKeys: "ctrl+backspace",
 		description: "Delete session (non-invasive)",
 	},
-	"app.tree.foldOrUp": {
-		defaultKeys: ["ctrl+left", "alt+left"],
-		description: "Fold or move up",
+	"app.tree.previousBranch": {
+		defaultKeys: [],
+		description: "Jump to the previous branch in /tree",
 	},
-	"app.tree.unfoldOrDown": {
-		defaultKeys: ["ctrl+right", "alt+right"],
-		description: "Unfold or move down",
+	"app.tree.nextBranch": {
+		defaultKeys: [],
+		description: "Jump to the next branch in /tree",
 	},
 	"app.plan.toggle": {
 		defaultKeys: "alt+shift+p",