@oh-my-pi/pi-tui 18.4.12 → 18.5.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## [Unreleased]
 
+## [18.5.0] - 2026-10-03
+
+### Breaking Changes
+
+- `WelcomeComponent` no longer takes a model or provider: its constructor is `(version)`, and `setModel()`, `setRecentSessions()`, `setLspServers()`, `handleNativeEvent()`, `RecentSession`, `LspServerInfo`, `WELCOME_SESSION_SLOTS` and `WELCOME_LSP_SLOTS` are gone; `ComposerWelcomeUpdate` drops `modelName`/`providerName`/`recentSessions`/`lspServers`, and `ComposerCache` drops `writeWelcome()`, `writeRecentSessions()`, `writeLspServers()`, `ComposerWelcomeCache` and the `welcome`/`recentSessions`/`lspServers` fields of `ComposerStartupCache`.
+- `renderWelcomeTip()` returns its lines without an indent, `Tip:` and the body wrapped together, for the caller to place.
+
+### Added
+
+- Added `ReportPanel`, a read-only command report: a `/btw`-style titled box with an Esc hint in text mode (above the editor, or as a full-screen page whose body scrolls on the arrow/page/Home/End keys and the wheel), and natively a `/usage`-style sheet whose body the terminal scrolls once it is long, with a Close button ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `contextUsageHead()`, the `/context` title naming the model and its window ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `Composer.rowsBelow()`, the rows the chrome under a below-transcript root took in the last frame ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added `Composer.pinInputToBottom()`, which keeps the input on the bottom row after chrome above the editor closes when rows it displaced went to scrollback ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- Added a repeatable native `reveal` (`{ at, n }`): a described node scrolls into view again whenever its `n` changes, without being re-added.
+
+### Changed
+
+- `ContextUsageView` is now a bare report body without its own title, rules or card; `setBreakdown()` was removed ([#14136](https://github.com/can1357/oh-my-pi/pull/14136) by [@H4vC](https://github.com/H4vC)).
+- The terminal welcome banner is the gradient logo beside the `omp` wordmark with the version under it and the tip, centered in the terminal; the logo stands alone when the lockup does not fit, and the tip drops below 50 columns. It no longer greets with "Welcome back!", natively either.
+
+### Fixed
+
+- Fixed tool previews on Windows showing a working directory on another drive as a raw absolute path instead of its home-shortened `~/…` form.
+- Fixed pasted drive-less `file:///…` URLs (forwarded from a macOS pasteboard or remote session) staying undecoded on Windows instead of loading as image paths.
+- Fixed an output artifact whose file cannot be opened (e.g. a directory in the way) being reported on Windows as a write failure and retried later, instead of a terminal open failure.
+- Fixed plan review's Contents in Tern: clicking an entry, or moving through them with the arrow keys, now scrolls the plan to that section.
+
+### Removed
+
+- Removed `JobsPanel`, the `/jobs` transcript block; `/jobs` now opens `JobsSheet` natively ([#14138](https://github.com/can1357/oh-my-pi/pull/14138) by [@H4vC](https://github.com/H4vC)).
+
 ## [18.4.12] - 2026-10-02
 
 ### Changed

package/dist/types/native/node.d.ts

@@ -28,10 +28,12 @@ export type NativeNode = {
          */
         readonly key?: string;
         /**
-         * Scroll the node into view, placed like the `reveal` op, when it is
-         * added. Key a node by what it points at to reveal it again on a move.
+         * Scroll the node into view, placed like the `reveal` op. A placement
+         * reveals it when it is added: key a node by what it points at to
+         * reveal it again on a move. A {@link NativeReveal} reveals it whenever
+         * its `n` differs from the previous description of the same node.
          */
-        readonly reveal?: "start" | "end" | "nearest";
+        readonly reveal?: NativeRevealAt | NativeReveal;
         /**
          * Keyboard scrolling forwarded to the terminal (PgUp/PgDn/End reach the
          * program): moves the scroller at or above the node by `by` whenever
@@ -42,6 +44,17 @@ export type NativeNode = {
         readonly scroll?: NativeScroll;
     };
 }[TspKind];
+/** Where a revealed node lands in its scroller. */
+export type NativeRevealAt = "start" | "end" | "nearest";
+/**
+ * A repeatable {@link NativeNode.reveal}: bump `n` to bring an existing node
+ * into view again (a Contents entry jumping to its section). A freshly added
+ * node is not revealed.
+ */
+export interface NativeReveal {
+    readonly at: NativeRevealAt;
+    readonly n: number;
+}
 /** A {@link NativeNode.scroll} request. */
 export interface NativeScroll {
     readonly by: TspScrollBy;

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

@@ -1,4 +1,4 @@
-import { type Component, Container } from "../tui.js";
+import type { Component } from "../tui.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** One async job as the session snapshots it. */
 export interface JobsPanelJob {
@@ -40,12 +40,6 @@ export interface JobsSheetSource {
     /** Dismiss the sheet. */
     close(): void;
 }
-/** The `/jobs` block: `ansi` renders in the terminal, the snapshot describes the native frame. */
-export declare class JobsPanel extends Container {
-    #private;
-    constructor(snapshot: JobsPanelSnapshot, nowMs: number, ansi: readonly Component[]);
-    describe(cx: DescribeContext): NativeNode;
-}
 /**
  * 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

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

@@ -0,0 +1,68 @@
+import type { TspText } from "@oh-my-pi/pi-wire";
+import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { Component } from "../tui.js";
+/** Options of a {@link ReportPanel}. */
+export interface ReportPanelOptions {
+    /** Plain title: the text-mode border title, and the native sheet head unless {@link head} is given. */
+    readonly title: string;
+    /** Styled native sheet head. */
+    readonly head?: TspText;
+    /** The read-only report; it draws no frame or title of its own. */
+    readonly body: Component;
+    /**
+     * Display form of the key that dismisses the report while it sits above the
+     * editor (the editor's interrupt key, which routes to it). Once the panel
+     * holds focus ({@link ReportPanel.holdFocus}) the hint shows the key its own
+     * input closes on instead.
+     */
+    readonly closeKey: string;
+    /** The focused panel (native sheet, text-mode full-screen page) closes on Esc / its Close button: this runs. */
+    readonly onClose: () => void;
+    /**
+     * Most rows the text-mode panel may take, borders included (the screen rows
+     * left above the editor); a taller report scrolls inside it. `undefined`
+     * leaves it uncapped.
+     */
+    readonly maxRows?: () => number | undefined;
+}
+/**
+ * A read-only command report (`/changelog`, `/context`, `/tools`, …).
+ *
+ * Text mode draws a titled box with the body and an Esc hint: above the editor
+ * like the `/btw` panel while it fits there (the editor keeps focus and its
+ * Esc takes it away), or as a full-screen page on the alternate screen when it
+ * is taller, whose body scrolls on the arrow/page/Home/End keys and the wheel.
+ * Natively it is a sheet like `/usage`: a centred `lg` glass sheet titled by
+ * the report whose body the terminal scrolls (wheel, and the same keys
+ * forwarded as scroll requests), then a Close button; Esc closes it.
+ */
+export declare class ReportPanel extends OverlayPanel {
+    #private;
+    readonly nativeOverlay: NonNullable<Component["nativeOverlay"]>;
+    constructor(options: ReportPanelOptions);
+    /**
+     * The panel is shown with focus (native sheet, text-mode full-screen page):
+     * its own {@link handleInput} closes it, so the hint names that key.
+     */
+    holdFocus(): void;
+    /**
+     * Text mode: cap the box to {@link ReportPanelOptions.maxRows}, scrolling a
+     * taller body. The cap is a hard limit: when a resize leaves fewer rows than
+     * the box's chrome needs, its bottom (the hint and closing border) is cut
+     * rather than spilling over the editor.
+     */
+    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). */
+    describe(): NativeNode;
+    invalidate(): void;
+    /**
+     * Focused (the native sheet, or the text-mode full-screen page): Esc closes;
+     * the arrow, page, Home and End keys and the wheel scroll the body.
+     */
+    handleInput(data: string): void;
+    /** Close runs what Esc runs. */
+    handleNativeEvent(event: NativeUiEvent): void;
+}

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

@@ -1,4 +1,4 @@
-import type { Effort } from "@oh-my-pi/pi-ai";
+import { type ConfiguredThinkingLevel } from "../thinking.js";
 import { SelectList, type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
@@ -7,7 +7,7 @@ import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.
  */
 export declare class ThinkingSelectorComponent extends OverlayPanel {
     #private;
-    constructor(currentLevel: Effort, availableLevels: Effort[], onSelect: (level: Effort) => void, onCancel: () => void);
+    constructor(currentLevel: ConfiguredThinkingLevel | undefined, availableLevels: ConfiguredThinkingLevel[], onSelect: (level: ConfiguredThinkingLevel) => void, onCancel: () => void);
     describe(cx: DescribeContext): NativeNode | null;
     /** Picker pointer events drive the list exactly as its keys do. */
     handleNativeEvent(event: NativeUiEvent): void;

package/dist/types/prompt/composer-cache.d.ts

@@ -1,4 +1,3 @@
-import type { LspServerInfo, RecentSession } from "./welcome.js";
 import type { ComposerPreferences, ComposerStatusCache } from "./composer.js";
 import type { SymbolPreset } from "../theme/theme.js";
 /** Theme inputs cached from the last resolved settings load for stable prepaint colors. */
@@ -8,19 +7,10 @@ export interface ComposerThemePreferences {
     readonly darkTheme?: string;
     readonly lightTheme?: string;
 }
-/** Last authoritative model labels shown in the welcome component. */
-export interface ComposerWelcomeCache {
-    readonly modelName: string;
-    readonly providerName: string;
-}
 /** Speculative composer state read before the settings/session graph is available. */
 export interface ComposerStartupCache {
     readonly preferences?: ComposerPreferences;
     readonly theme?: ComposerThemePreferences;
-    readonly welcome?: ComposerWelcomeCache;
-    readonly recentSessions: RecentSession[];
-    /** `null` when the last run had LSP disabled. */
-    readonly lspServers: LspServerInfo[] | null;
     readonly status?: ComposerStatusCache;
 }
 /**
@@ -43,12 +33,6 @@ export declare class ComposerCache {
     read(cwd: string): ComposerStartupCache;
     /** Resolved theme and composer settings for the next prepaint. */
     writeUi(cwd: string, preferences: ComposerPreferences, theme: ComposerThemePreferences): void;
-    /** Authoritative model/provider labels for the next welcome prepaint. */
-    writeWelcome(cwd: string, welcome: ComposerWelcomeCache): void;
-    /** The latest recent-session rows (first four). */
-    writeRecentSessions(cwd: string, sessions: readonly RecentSession[]): void;
-    /** The latest detected project LSP rows; `null` records that LSP is disabled. */
-    writeLspServers(cwd: string, servers: readonly LspServerInfo[] | null): void;
     /** Status-bar inputs for the next prepaint's startup status line. */
     writeStatus(cwd: string, status: ComposerStatusCache): void;
     close(): void;

package/dist/types/prompt/composer.d.ts

@@ -6,7 +6,7 @@ import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type
 import type { NativeSurface, NativeSurfaceProvider } from "../native/node.js";
 import { CustomEditor } from "./custom-editor.js";
 import type { WordCompletionMethod } from "./word-completion.js";
-import { type LspServerInfo, type RecentSession, WelcomeComponent } from "./welcome.js";
+import { WelcomeComponent } from "./welcome.js";
 /** Live settings that affect the composer before and after session adoption. */
 export interface ComposerPreferences {
     readonly quiet: boolean;
@@ -25,11 +25,6 @@ export declare const COMPOSER_DEFAULTS: ComposerPreferences;
 /** Welcome data that can be supplied initially or patched as startup resolves it. */
 export interface ComposerWelcomeUpdate {
     readonly version?: string;
-    readonly modelName?: string;
-    readonly providerName?: string;
-    readonly recentSessions?: readonly RecentSession[];
-    /** Detected project servers; `null` means LSP is disabled and hides the welcome section. */
-    readonly lspServers?: readonly LspServerInfo[] | null;
 }
 /**
  * Status-bar inputs persisted by the last session. The first frame renders
@@ -122,6 +117,21 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     #private;
     readonly ui: TUI;
     constructor(options?: ComposerOptions);
+    /**
+     * Rows the below-transcript chrome under `root` (editor, status line, …)
+     * took in the last frame, so a root that grows upward can cap itself to
+     * the screen rows left above them; `undefined` before `root` was laid out.
+     */
+    rowsBelow(root: Component): number | undefined;
+    /**
+     * Keep the input on the bottom row while the live rows cannot fill the
+     * screen, as after an inline decision panel closes. A tall block that just
+     * left the chrome above the editor (a command report) may have scrolled
+     * rows into native history that cannot be pulled back; without the pin the
+     * editor would jump up to where the shorter frame now ends. The pin lifts
+     * once live rows fill the screen again.
+     */
+    pinInputToBottom(): void;
     /** Compose the bounded mutable viewport and the next ordered history append. */
     renderFrame(viewport: ViewportSize): TerminalFramePlan;
     /**
@@ -164,7 +174,7 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     enableInput(): void;
     /** Apply settings changes without replacing the editor or welcome component. */
     setPreferences(update: Partial<ComposerPreferences>): void;
-    /** Patch welcome data in place as model, session, and project discovery complete. */
+    /** Patch welcome data in place as version, session, and project discovery complete. */
     updateWelcome(update: ComposerWelcomeUpdate): void;
     /** Replace optional header content around the stable welcome scene. */
     setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;

package/dist/types/prompt/welcome.d.ts

@@ -1,58 +1,36 @@
-import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
-/**
- * Fixed number of session rows in the welcome box so its height stays stable
- * across recent-session updates.
- */
-export declare const WELCOME_SESSION_SLOTS = 4;
-/**
- * Fixed number of LSP-server rows, for the same reason. Overflow is sliced so
- * the box height is constant regardless of how many servers a project has.
- */
-export declare const WELCOME_LSP_SLOTS = 4;
 /** Pick a tip from `tips`, biased toward "[NEW]" tips by {@link NEW_TIP_WEIGHT};
  *  `r` is a uniform sample in [0, 1). Returns "" when `tips` is empty.
  *  Exported for tests. */
 export declare function pickWeightedTip(tips: readonly string[], r: number): string;
-export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?: number): string[];
-export interface RecentSession {
-    name: string;
-    timeAgo: string;
-    /** Session file; a native click on the row resumes it. */
-    path?: string;
-}
-export interface LspServerInfo {
-    name: string;
-    status: "ready" | "error" | "connecting" | "available";
-    fileTypes: string[];
-}
 /**
- * Premium welcome screen with block-based OMP logo and two-column layout.
+ * The welcome tip as lines of at most `width` columns: `Tip:` and the body
+ * wrapped together, with no indent, so the banner can center each line.
+ * `[]` when `width` leaves no room for a useful line.
+ */
+export declare function renderWelcomeTip(tip: string, width: number, phase?: number): string[];
+/**
+ * The session's welcome banner. In a terminal: the gradient logo beside the
+ * `omp` wordmark with the version under it (the logo alone when the lockup does
+ * not fit) and the tip of the session (dropped below {@link TIP_MIN_COLUMNS}
+ * columns). Natively: a card with the same logo, wordmark, version and tip
+ * ({@link WelcomeComponent.describe}).
  */
 export declare class WelcomeComponent implements Component {
     #private;
     private version;
-    private modelName;
-    private providerName;
-    private recentSessions;
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    private lspServers;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], 
-    /** Detected project servers; `null` means LSP is disabled and hides the section. */
-    lspServers?: LspServerInfo[] | null);
+    constructor(version: string);
     get tip(): string | undefined;
     invalidate(): void;
     /**
-     * A `card` (`omp.welcome`) titled with the app version. The brand column
-     * (`omp.welcome.brand`: greeting and the terminal's builtin `omp` mark, which
-     * it animates) sits beside the info column (`omp.welcome.info`: prompt-sigil
-     * keycaps, LSP servers, recent sessions); the tip of the session closes the card. Roles
-     * carry the look (gradient logo, type scale, column hairline); a "[NEW]" tip
+     * A `card` (`omp.welcome`) mirroring the terminal banner: the lockup
+     * (`omp.welcome.lockup`: the terminal's builtin `omp` mark, which it animates,
+     * beside the wordmark with the version under it) and the tip of the session.
+     * Roles carry the look (gradient logo, type scale); a "[NEW]" tip
      * carries a terminal-clocked shimmering tag.
      */
     describe(_cx: DescribeContext): NativeNode;
-    /** A click on a recent session resumes it. */
-    handleNativeEvent(event: NativeUiEvent): void;
     /** The intro keeps the welcome block mutable; settling lets it retire to history. */
     isTranscriptBlockFinalized(): boolean;
     /**
@@ -71,9 +49,6 @@ export declare class WelcomeComponent implements Component {
     stopIntro(): void;
     /** Update the version embedded in the welcome border title. */
     setVersion(version: string): void;
-    setModel(modelName: string, providerName: string): void;
-    setRecentSessions(sessions: RecentSession[]): void;
-    setLspServers(servers: LspServerInfo[] | null): void;
     render(termWidth: number): readonly string[];
 }
 /** Block-grid brand mark shared by the welcome and setup surfaces. */

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

@@ -3,6 +3,7 @@ import type { CompactionSettings } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Tool as AiTool, Model } from "@oh-my-pi/pi-ai";
 import type { Theme } from "../theme/index.js";
 import { Container } from "../tui.js";
+import type { TspText } from "@oh-my-pi/pi-wire";
 import type { DescribeContext, NativeNode } from "../native/node.js";
 interface ContextSkill {
     readonly name: string;
@@ -154,6 +155,8 @@ 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. */
+export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
 /**
  * Native context-usage panel for terminals without `meter`: the cell grid as
  * unwrapped styled rows beside the legend. The terminal places the legend
@@ -161,15 +164,14 @@ export declare function computeContextBreakdown(session: ContextUsageSession, op
  */
 export declare function describeContextUsage(breakdown: ContextBreakdown): NativeNode;
 /**
- * The `/context` transcript block: ANSI renders the titled cell grid between
- * rules; natively it is one frame, drawn with `meter`s where the terminal
- * has them and as the glyph grid otherwise.
+ * The `/context` report body, without a frame or title of its own (the panel
+ * showing it is titled {@link contextUsageHead}): ANSI renders the cell grid
+ * beside the legend; natively it is drawn with `meter`s where the terminal has
+ * them and as the glyph grid otherwise.
  */
 export declare class ContextUsageView extends Container {
     #private;
     constructor(breakdown: ContextBreakdown, theme: Theme);
-    /** Replace the shown breakdown in place, refreshing both the ANSI and native views. */
-    setBreakdown(breakdown: ContextBreakdown): void;
     describe(cx: DescribeContext): NativeNode;
 }
 /**

package/dist/types/thinking.d.ts

@@ -4,7 +4,7 @@ import { ThinkingLevel } from "@oh-my-pi/pi-agent-core/thinking";
 import { Effort } from "@oh-my-pi/pi-catalog/effort";
 import type { Model } from "@oh-my-pi/pi-catalog/types";
 /** Thinking selectors accepted by CLI inputs, in display order. */
-export declare const CLI_THINKING_LEVELS: readonly string[];
+export declare const CLI_THINKING_LEVELS: readonly ConfiguredThinkingLevel[];
 /**
  * Metadata used to render thinking selector values in the coding-agent UI.
  */

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

@@ -108,6 +108,8 @@ export interface TaskItem {
     solutionSpace?: string;
     /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
     effort?: "lo" | "med" | "hi";
+    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
+    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -134,6 +136,8 @@ export interface TaskParams {
     solutionSpace?: string;
     /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
     effort?: "lo" | "med" | "hi";
+    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
+    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -255,7 +259,7 @@ export interface AgentProgress {
     resolvedModelRoute?: string;
     /** True when a live advisor was attached to this run's session, not merely enabled in settings. */
     advisor?: boolean;
-    /** The agent's latest self-estimate of task completion (0–100), from the periodic `task.completionProbeMs` side request. */
+    /** The agent's latest self-estimate of task completion (0–100), from the periodic `task.completionProbe` side request. */
     completionPercent?: number;
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
     extractedToolData?: Record<string, unknown[]>;

package/package.json

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

package/src/desktop-notify.ts

@@ -50,7 +50,8 @@ export function hasLinuxDesktopSession(
 	if (platform !== "linux") return false;
 	if (env.DBUS_SESSION_BUS_ADDRESS) return true;
 	const runtimeDir = env.XDG_RUNTIME_DIR;
-	return Boolean(runtimeDir && fileExists(path.join(runtimeDir, "bus")));
+	// Only reached for Linux, so join with POSIX separators regardless of the host.
+	return Boolean(runtimeDir && fileExists(path.posix.join(runtimeDir, "bus")));
 }
 
 /**

package/src/native/node.ts

@@ -29,10 +29,12 @@ export type NativeNode = {
 		 */
 		readonly key?: string;
 		/**
-		 * Scroll the node into view, placed like the `reveal` op, when it is
-		 * added. Key a node by what it points at to reveal it again on a move.
+		 * Scroll the node into view, placed like the `reveal` op. A placement
+		 * reveals it when it is added: key a node by what it points at to
+		 * reveal it again on a move. A {@link NativeReveal} reveals it whenever
+		 * its `n` differs from the previous description of the same node.
 		 */
-		readonly reveal?: "start" | "end" | "nearest";
+		readonly reveal?: NativeRevealAt | NativeReveal;
 		/**
 		 * Keyboard scrolling forwarded to the terminal (PgUp/PgDn/End reach the
 		 * program): moves the scroller at or above the node by `by` whenever
@@ -44,6 +46,19 @@ export type NativeNode = {
 	};
 }[TspKind];
 
+/** Where a revealed node lands in its scroller. */
+export type NativeRevealAt = "start" | "end" | "nearest";
+
+/**
+ * A repeatable {@link NativeNode.reveal}: bump `n` to bring an existing node
+ * into view again (a Contents entry jumping to its section). A freshly added
+ * node is not revealed.
+ */
+export interface NativeReveal {
+	readonly at: NativeRevealAt;
+	readonly n: number;
+}
+
 /** A {@link NativeNode.scroll} request. */
 export interface NativeScroll {
 	readonly by: TspScrollBy;

package/src/native/reconcile.ts

@@ -31,7 +31,7 @@ import * as logger from "@oh-my-pi/pi-utils/logger";
 import { TSP_TEXT_KINDS, type TspKind, type TspNode, type TspOp, type TspScrollBy } from "@oh-my-pi/pi-wire";
 import { type Component, Container, CURSOR_MARKER } from "../tui";
 import { normalizeIconProps } from "./icons";
-import type { DescribeContext, NativeChild, NativeNode } from "./node";
+import type { DescribeContext, NativeChild, NativeNode, NativeRevealAt } from "./node";
 import { isNativeSettled } from "./settle";
 
 /** The regions a frame fills. */
@@ -213,8 +213,11 @@ export class Reconciler {
 	#ops: TspOp[] = [];
 	#dels: Entry[] = [];
 	#settles: string[] = [];
-	/** Selected list items and added `reveal` nodes sent this frame, revealed once the frame's adds have landed. */
-	#reveals: [id: string, at: "start" | "end" | "nearest"][] = [];
+	/**
+	 * Selected list items, added `reveal` nodes and nodes whose reveal `n` moved this frame,
+	 * revealed once the frame's adds have landed.
+	 */
+	#reveals: [id: string, at: NativeRevealAt][] = [];
 	/** `scroll` requests whose `n` moved this frame, sent after the reveals. */
 	#scrolls: [id: string, by: TspScrollBy][] = [];
 	/** Wire ids `list.selected` keys resolved to (an unresolved key names no node to reveal). */
@@ -595,6 +598,11 @@ export class Reconciler {
 			this.#revisitNode(next, inner);
 			return;
 		}
+		const reveal = next.node.reveal;
+		if (typeof reveal === "object") {
+			const was = old.node.reveal;
+			if (reveal.n !== (typeof was === "object" ? was.n : undefined)) this.#reveals.push([next.id, reveal.at]);
+		}
 		if (old.node.k !== next.node.k) {
 			this.#dropSubtree(old);
 			this.#ops.push(["del", next.id]);
@@ -743,7 +751,7 @@ export class Reconciler {
 
 	/** A full wire subtree for an entry; nested components get states (or pending moves when mounted elsewhere). */
 	#materialize(entry: NodeEntry, walk: Walk): TspNode {
-		if (entry.node.reveal) this.#reveals.push([entry.id, entry.node.reveal]);
+		if (typeof entry.node.reveal === "string") this.#reveals.push([entry.id, entry.node.reveal]);
 		const entries = this.#entries(entry.node.c, entry.keypath, entry.owner, entry.hoist, walk);
 		const children: TspNode[] = [];
 		for (let i = 0; i < entries.length; i++) {

package/src/overlays/jobs-panel.ts

@@ -1,14 +1,13 @@
 /**
- * The async background jobs of a session, twice: {@link JobsPanel} is the
- * `/jobs` transcript block (ANSI keeps the caller's text report; natively one
- * frame), {@link JobsSheet} the dismissable sheet the native jobs pill opens.
- * The panel draws task jobs as `agent` nodes and the others as a status dot,
- * the one-line label and a live `elapsed`; the sheet lists every job and
- * inspects the selected one (command, cwd, live pids, exit code, output tail).
+ * The async background jobs of a session as {@link JobsSheet}: the dismissable
+ * sheet the native jobs pill and `/jobs` open. It draws task jobs as `agent`
+ * nodes and the others as a status dot, the one-line label and a live
+ * `elapsed`, lists every job and inspects the selected one (command, cwd, live
+ * pids, exit code, output tail).
  */
 import type { TspAgentProps, TspSpan } from "@oh-my-pi/pi-wire";
 import { formatDuration } from "@oh-my-pi/pi-utils";
-import { type Component, Container } from "../tui";
+import type { Component } from "../tui";
 import { matchesSelectCancel, matchesSelectDown, matchesSelectUp } from "../keybinding-matchers";
 import { matchesKey } from "../keys";
 import { truncateToWidth } from "../utils";
@@ -92,31 +91,6 @@ const DOT: Record<JobsPanelJob["status"], TspSpan> = {
 /** Output tail rows the terminal fallback shows under the selected job. */
 const FALLBACK_TAIL_LINES = 8;
 
-/** The `/jobs` block: `ansi` renders in the terminal, the snapshot describes the native frame. */
-export class JobsPanel extends Container {
-	readonly #snapshot: JobsPanelSnapshot;
-	readonly #nowMs: number;
-	#native: { agent: boolean; node: NativeNode } | undefined;
-
-	constructor(snapshot: JobsPanelSnapshot, nowMs: number, ansi: readonly Component[]) {
-		super();
-		this.#snapshot = snapshot;
-		this.#nowMs = nowMs;
-		for (const child of ansi) this.addChild(child);
-	}
-
-	override describe(cx: DescribeContext): NativeNode {
-		const agent = cx.supports("agent");
-		if (this.#native?.agent === agent) return this.#native.node;
-		const head: TspSpan[] = [span("Background jobs", "strong")];
-		const running = this.#snapshot.running.length;
-		if (running > 0) head.push(span(` · ${running} running`, "muted"));
-		const described = card({ role: "omp.jobs", head }, describeJobs(this.#snapshot, this.#nowMs, agent));
-		this.#native = { agent, node: described };
-		return described;
-	}
-}
-
 /**
  * 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
@@ -254,27 +228,6 @@ function jobAge(job: JobsPanelJob, nowMs: number): number {
 	return Math.max(0, (job.endTime ?? nowMs) - job.startTime);
 }
 
-/** The body the `/jobs` panel draws: running rows, then a Recent section; an empty note when there are none. */
-function describeJobs(snapshot: JobsPanelSnapshot, nowMs: number, agent: boolean): NativeChild[] {
-	const { running, recent } = snapshot;
-	const children: NativeChild[] = [];
-	if (running.length === 0 && recent.length === 0) {
-		children.push(node("text", { text: "No background jobs", role: "omp.jobs.empty" }, undefined, "empty"));
-	}
-	for (const job of running) children.push(describeJob(job, nowMs, agent));
-	if (recent.length > 0) {
-		children.push(
-			node(
-				"section",
-				{ head: [span("Recent", "muted")] },
-				recent.map(job => describeJob(job, nowMs, agent)),
-				"recent",
-			),
-		);
-	}
-	return children;
-}
-
 /** A task job as an `agent` node when the terminal draws them, else a one-line dot row. */
 function describeJob(job: JobsPanelJob, nowMs: number, agent: boolean): NativeNode {
 	const settled = job.status !== "running";