@oh-my-pi/pi-tui 18.4.0 → 18.4.1

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 ## [Unreleased]
 
+## [18.4.1] - 2026-09-28
+
+### Breaking Changes
+
+- Replaced `AgentsHubDeps.setDisabledAgents`/`setOverrides` with `setAgentDisabled(name, { disabled })` and `setAgentOverride(property, name, value)`, so each hub edit persists only the agent it changes; `PropertyKind` is exported ([#13308](https://github.com/can1357/oh-my-pi/pull/13308) by [@Vortex727](https://github.com/Vortex727))
+
+### Changed
+
+- LSP servers section is omitted from the welcome screen when LSP is disabled
+- Usage dashboards and provider cards can show connected accounts with unavailable usage separately from reported quotas, without treating missing reports as unused or unlimited ([#13476](https://github.com/can1357/oh-my-pi/pull/13476) by [@aktanazat](https://github.com/aktanazat)).
+
+### Fixed
+
+- Fixed sessions exiting as if the terminal hung up when it only stopped reading for a few seconds during a very large repaint (a long transcript's replay behind a busy tmux or container attach) ([#13576](https://github.com/can1357/oh-my-pi/pull/13576) by [@sjawhar](https://github.com/sjawhar))
+- Fixed fullscreen overlays rewriting the whole terminal on every change; each frame now repaints only the rows that changed ([#13568](https://github.com/can1357/oh-my-pi/pull/13568) by [@sjawhar](https://github.com/sjawhar))
+- Fixed the armed `/loop` status reading `Loop waiting`, which hid that the next prompt becomes the repeated loop body; it now reads `Loop: next prompt repeats` ([#13435](https://github.com/can1357/oh-my-pi/pull/13435) by [@Dante-dan](https://github.com/Dante-dan)).
+- Reduced memory held by long sessions: committed transcript blocks no longer keep their rendered-row caches ([#13242](https://github.com/can1357/oh-my-pi/pull/13242) by [@iliaal](https://github.com/iliaal)).
+- Fixed the results-limit notice advising `Use limit=` values the tool would clamp straight back; at the hard cap it now reports the reached count alone ([#13263](https://github.com/can1357/oh-my-pi/issues/13263))
+- Fixed the rewind filter finding nothing for query words in scripts without spaces (e.g. Chinese): non-Latin words now match as substrings while Latin words keep whole-word matching ([#13361](https://github.com/can1357/oh-my-pi/pull/13361) by [@jchanghong023](https://github.com/jchanghong023))
+- The Esc-Esc rewind selector opens on the recent tail of long sessions instead of replaying the whole branch; press `a` to load earlier turns ([#12819](https://github.com/can1357/oh-my-pi/pull/12819) by [@lemonleks](https://github.com/lemonleks)).
+- Fixed OSC 8 hyperlinks (file paths, URLs, GitHub refs) rendering as plain text in Herdr panes. Herdr reports `TERM=xterm-256color` without `TERM_PROGRAM`, so its panes were treated as an unknown terminal, although Herdr renders OSC 8 itself and opens links on Ctrl+click. Screen or tmux nested inside a pane still follow their own rules, and `PI_NO_HYPERLINKS=1` still opts out ([#13289](https://github.com/can1357/oh-my-pi/pull/13289) by [@andrebrait](https://github.com/andrebrait)).
+- Fixed native stderr output painting over the TUI on Linux ([#13176](https://github.com/can1357/oh-my-pi/issues/13176)).
+- Fixed heavy lag while output streams with inline images on SIXEL terminals such as Orca: each visible image was re-encoded on every render pass ([#12998](https://github.com/can1357/oh-my-pi/pull/12998) by [@wimjan123](https://github.com/wimjan123))
+- Fixed Kitty-protocol terminals re-encoding every non-PNG image on redelivery and transcript rebuilds ([#13118](https://github.com/can1357/oh-my-pi/issues/13118)).
+- Fixed the Windows Terminal taskbar progress animation restarting every second while the agent works ([#12940](https://github.com/can1357/oh-my-pi/pull/12940)).
+- Fixed resuming a long session freezing the TUI for several seconds; first paint is now spread across frames ([#12933](https://github.com/can1357/oh-my-pi/issues/12933)).
+- The model hub no longer opens a thinking strip or shows the `t` hint for models that cannot reason ([#13112](https://github.com/can1357/oh-my-pi/pull/13112)).
+
 ## [18.4.0] - 2026-09-28
 
 ### Fixed

package/dist/types/chat/image-loading.d.ts

@@ -43,4 +43,28 @@ export declare class InvalidImageDataError extends Error {
 export declare function imageDecodeFailureReason(image: ImageContent): Promise<string | null>;
 /** Converts an image to PNG, rejecting when the runtime cannot decode or encode it. */
 export declare function convertImageToPng(image: ImageContent): Promise<ImageContent>;
+/**
+ * Content-addressed identity of an image payload, stable across components and
+ * transcript rebuilds. Callers key their own per-image state by this instead of
+ * positional ids like `${toolCallId}:${index}`, which go stale when the images
+ * behind a position are replaced.
+ */
+export declare function imagePayloadKey(image: ImageContent): string;
+/**
+ * The PNG conversion of `image` when one is still resident, else `undefined`.
+ * Synchronous so renderers can use an already-converted image on the spot
+ * instead of scheduling another async re-render.
+ */
+export declare function cachedPngConversion(image: ImageContent): ImageContent | undefined;
+/**
+ * Converts `image` to PNG at most once per distinct payload: concurrent callers
+ * share one in-flight conversion and later callers hit {@link pngCache}.
+ * Kitty-graphics renderers use this because `convertImageToPng` is a full
+ * decode plus re-encode, and the same image is delivered repeatedly (read-result
+ * replay) and rebuilt from scratch on resume, rewind, and `/tree` navigation.
+ *
+ * Rejections are not cached — a payload that failed to decode is retried by the
+ * next caller, matching {@link convertImageToPng}'s contract.
+ */
+export declare function convertImageToPngShared(image: ImageContent): Promise<ImageContent>;
 export declare function ensureSupportedImageInput(image: ImageContent): Promise<ImageContent | null>;

package/dist/types/chat/transcript-entry.d.ts

@@ -31,6 +31,15 @@ export declare function transcriptEntryMessage(entry: TranscriptEntryLike): Agen
 export declare function isUserRequestEntry(entry: TranscriptEntryLike | {
     type: string;
 }): boolean;
+/**
+ * Recent transcript tail starting at a user-request boundary, so tool calls
+ * and results stay together. ChatTranscriptBuilder drops a tool result whose
+ * initiating call was sliced away, so a tail of orphaned results can leave
+ * the picker without any target.
+ *
+ * A whole user turn may exceed `limit`; paginate rendering if one turn grows too large.
+ */
+export declare function recentTranscriptEntries(entries: TranscriptEntryLike[], limit?: number): TranscriptEntryLike[];
 /** Editable user request text, preserving skill invocation syntax. */
 export declare function userTurnDraft(entry: TranscriptEntryLike): string | undefined;
 /** Extract text blocks verbatim, optionally separating block boundaries. */

package/dist/types/chrome/transcript-container.d.ts

@@ -96,8 +96,15 @@ export declare class TranscriptContainer extends Container {
      * quit is pure write volume. An already offered replay batch stays valid.
      */
     cancelReplay(): void;
-    /** Total rows the live, un-emitted tail occupies at `width`. */
-    liveRowCount(width: number): number;
+    /**
+     * Total rows the live, un-emitted tail occupies at `width`.
+     *
+     * `limit` stops the walk once the total passes it: measuring a resumed
+     * session's whole ledger costs one full render per block, and callers only
+     * compare the height against a viewport budget. Past `limit` the result is
+     * a lower bound, guaranteed only to be greater than `limit`.
+     */
+    liveRowCount(width: number, limit?: number): number;
     /** Block spans of the last `renderViewport` output, in output coordinates. Empty when the tail is empty. */
     getLastViewportSpans(): readonly TranscriptViewportSpan[];
     /** Render the live tail, constrained to the supplied transcript height. */

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

@@ -32,7 +32,7 @@ export interface HubAgent {
     advisorOverride?: string;
 }
 /** The per-agent knob a strip or the model browser is editing. */
-type PropertyKind = "model" | "prewalk" | "advisor";
+export type PropertyKind = "model" | "prewalk" | "advisor";
 export interface GeneratedAgentSpec {
     identifier: string;
     whenToUse: string;
@@ -47,8 +47,12 @@ export interface AgentsHubDeps {
     resolvePatterns: (patterns: string[]) => string | undefined;
     effectivePrewalkPattern: (agent: HubAgent) => string | undefined;
     effectiveAdvisorPattern: (agent: HubAgent) => string | undefined;
-    setDisabledAgents: (names: string[]) => void;
-    setOverrides: (property: PropertyKind, overrides: Record<string, string>) => void;
+    /** Persist one agent's enabled state; other agents are untouched. */
+    setAgentDisabled: (name: string, options: {
+        disabled: boolean;
+    }) => void;
+    /** Persist one agent's override for `property`; `undefined` clears it. Other agents are untouched. */
+    setAgentOverride: (property: PropertyKind, name: string, value: string | undefined) => void;
     generateAgent: (description: string, onText: (text: string) => void) => Promise<string>;
     saveAgent: (scope: "project" | "user", spec: GeneratedAgentSpec) => Promise<string>;
 }
@@ -69,4 +73,3 @@ export declare class AgentsHubComponent implements Component {
     handleInput(data: string): void;
     render(width: number): readonly string[];
 }
-export {};

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

@@ -21,13 +21,13 @@
  * active column when a strip is open), Left/Right slide between branch
  * variants at a fork and jump between user turns elsewhere, `f` opens a
  * filter (typing narrows the current path to matching items; Esc leaves the
- * filter with the selection kept), Enter rewinds to the outlined item, Esc
- * cancels.
+ * filter with the selection kept), Enter rewinds to the outlined item, A loads
+ * earlier turns without changing selection, Esc cancels.
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import { type Component, type TUI } from "../index.js";
 import type { MessageRenderer } from "../chat/extension-types.js";
-import type { TranscriptEntryLike as TranscriptEntry } from "../chat/transcript-entry.js";
+import { type TranscriptEntryLike as TranscriptEntry } from "../chat/transcript-entry.js";
 /** One alternate branch at a divergence: its root and message path root → most-recent leaf. */
 export interface BranchVariantPath {
     rootId: string;

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

@@ -20,12 +20,18 @@ export interface CardWindowRow {
     /** Absolute one-sided amount (e.g. `$12.34 used`, `100 credits left`) for limits without a fraction. */
     usedText?: string;
 }
+/** A connected account whose usage lookup produced no attributable report. */
+export interface UnavailableUsageAccount {
+    provider: string;
+    label: string;
+}
 /** Compact per-provider summary backing one card in the subscriptions grid. */
 export interface ProviderCard {
     provider: string;
     name: string;
-    /** Number of accounts reporting for this provider. */
+    /** Number of represented accounts, including unavailable usage lookups. */
     accounts: number;
+    unavailableAccounts: string[];
     /** Window rows sorted most-pressing first. */
     windows: CardWindowRow[];
     /** True when every account reports no limits (e.g. enterprise plans). */
@@ -48,7 +54,7 @@ export interface ProviderCard {
  * most-used account's reset countdown. Cards sort most-pressing first so
  * what's burning is on top-left; fully idle providers collapse into a tick.
  */
-export declare function buildProviderCards(reports: UsageReport[], nowMs: number): ProviderCard[];
+export declare function buildProviderCards(reports: UsageReport[], nowMs: number, unavailableAccounts?: readonly UnavailableUsageAccount[]): ProviderCard[];
 /** GitHub-style week-per-column heatmap grid derived from daily activity. */
 export interface HeatmapLayout {
     /** Per week column: short month name when the column starts a new month. */
@@ -71,6 +77,7 @@ export declare function buildHeatmapLayout(points: DailyActivityPoint[], weeks:
 /** Callbacks and data sources for {@link UsageDashboardComponent}. */
 export interface UsageDashboardOptions {
     reports: UsageReport[];
+    unavailableAccounts?: readonly UnavailableUsageAccount[];
     /**
      * Full classic `/usage` report for the expanded detail view; re-invoked per
      * terminal width.

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

@@ -1,6 +1,5 @@
-import "@oh-my-pi/pi-utils/env";
 import type { LspServerInfo, RecentSession } from "./welcome.js";
-import type { ComposerPreferences, ComposerStatusSnapshot } from "./composer.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. */
 export interface ComposerThemePreferences {
@@ -20,18 +19,37 @@ export interface ComposerStartupCache {
     readonly theme?: ComposerThemePreferences;
     readonly welcome?: ComposerWelcomeCache;
     readonly recentSessions: RecentSession[];
-    readonly lspServers: LspServerInfo[];
-    readonly status?: ComposerStatusSnapshot;
+    /** `null` when the last run had LSP disabled. */
+    readonly lspServers: LspServerInfo[] | null;
+    readonly status?: ComposerStatusCache;
+}
+/**
+ * Process-wide store at {@link getComposerCacheDbPath}, opened on first use and
+ * closed at exit. `undefined` when it cannot be opened (logged once; startup
+ * paints without speculation) and under the test runner, so tests never read
+ * or clobber the user's cache; tests open {@link ComposerCache.open} explicitly.
+ */
+export declare function sharedComposerCache(): ComposerCache | undefined;
+/** SQLite store of the composer state the next launch paints before its session exists. */
+export declare class ComposerCache {
+    #private;
+    private constructor();
+    /**
+     * Open (creating if needed) the store at `dbPath`, quarantining a corrupt one once.
+     * @throws when the directory or database cannot be created.
+     */
+    static open(dbPath?: string): ComposerCache;
+    /** Everything cached for `cwd`, with any-project rows as fallback for shared kinds. Never throws. */
+    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;
 }
-/** Read all speculative composer caches synchronously before the first terminal paint. */
-export declare function readComposerStartupCache(cwd: string): ComposerStartupCache;
-/** Persist resolved theme and composer settings for the next prepaint. */
-export declare function writeComposerUiCache(cwd: string, preferences: ComposerPreferences, theme: ComposerThemePreferences): Promise<void>;
-/** Persist authoritative model/provider labels for the next welcome prepaint. */
-export declare function writeComposerWelcomeCache(cwd: string, welcome: ComposerWelcomeCache): Promise<void>;
-/** Persist placeholder-only status chrome for speculative first-frame rendering. */
-export declare function writeComposerStatusCache(cwd: string, status: ComposerStatusSnapshot): Promise<void>;
-/** Persist the latest recent-session rows as a compact JSONL speculation cache. */
-export declare function writeComposerRecentSessionsCache(cwd: string, sessions: readonly RecentSession[]): Promise<void>;
-/** Persist the latest detected project LSP rows for the next prepaint. */
-export declare function writeComposerLspCache(cwd: string, servers: readonly LspServerInfo[]): Promise<void>;

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

@@ -1,3 +1,6 @@
+import type { StatusLineComponent } from "../status-line/component.js";
+import type { StatusLineSession } from "../status-line/host.js";
+import { type StatusLineStartupData } from "../status-line/startup.js";
 import { type Terminal } from "../terminal.js";
 import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
 import { CustomEditor } from "./custom-editor.js";
@@ -24,27 +27,21 @@ export interface ComposerWelcomeUpdate {
     readonly modelName?: string;
     readonly providerName?: string;
     readonly recentSessions?: readonly RecentSession[];
-    readonly lspServers?: readonly LspServerInfo[];
+    /** Detected project servers; `null` means LSP is disabled and hides the welcome section. */
+    readonly lspServers?: readonly LspServerInfo[] | null;
 }
 /**
- * Placeholder-only status chrome replayed on the next first frame so the
- * status band/border exists before the session-aware status line attaches.
- * Bound to the composer shape it was rendered for; a different shape drops it.
+ * Status-bar inputs persisted by the last session. The first frame renders
+ * them through a startup {@link StatusLineComponent} at the live width until
+ * the session-aware status line attaches.
  */
-export interface ComposerStatusSnapshot {
-    readonly shape: string;
-    /** ANSI wrapper of the editor border at snapshot time (session accent or thinking color). */
+export interface ComposerStatusCache {
+    /** ANSI wrapper of the editor border when persisted (session accent or thinking color). */
     readonly borderColor?: {
         readonly prefix: string;
         readonly suffix: string;
     };
-    /** Status content embedded in the editor's top chrome (`top-border`, `top-band`, `top-rule-chip`). */
-    readonly topBorder?: {
-        readonly content: string;
-        readonly width: number;
-    };
-    /** Standalone bottom-bar rows (`pi`/`claude` shapes), gap row included. */
-    readonly bottomLines: readonly string[];
+    readonly statusLine: StatusLineStartupData;
 }
 /** Optional dependencies and initial state for a standalone composer. */
 export interface ComposerOptions {
@@ -53,7 +50,7 @@ export interface ComposerOptions {
     readonly tuiOptions?: TUIOptions;
     readonly preferences?: Partial<ComposerPreferences>;
     readonly welcome?: ComposerWelcomeUpdate;
-    readonly status?: ComposerStatusSnapshot;
+    readonly status?: ComposerStatusCache;
     readonly exit?: (code: number) => void;
     readonly now?: () => number;
 }
@@ -155,11 +152,11 @@ export declare class Composer implements TerminalFrameProvider {
     /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */
     setEditor(editor: CustomEditor): void;
     /**
-     * Mount the session-aware status component into the slot below the editor.
-     * Drops the speculative snapshot; the caller installs the real top-border
+     * Mount the session-aware status component into the slot below the editor,
+     * retiring the startup status line; the caller installs the real top-border
      * provider through its composer-shape sync.
      */
-    setStatusComponent(component: Component): void;
+    setStatusComponent<TSession extends StatusLineSession>(component: StatusLineComponent<TSession>): void;
     /** Mount or replace session-aware root children while preserving the header and status hosts. */
     setRuntimeChildren(children: readonly Component[], options?: RuntimeChildrenOptions): void;
     /** Play or replay the welcome intro against the stable header render target. */

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

@@ -32,8 +32,11 @@ export declare class WelcomeComponent implements Component {
     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[], lspServers?: LspServerInfo[]);
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], 
+    /** Detected project servers; `null` means LSP is disabled and hides the section. */
+    lspServers?: LspServerInfo[] | null);
     get tip(): string | undefined;
     invalidate(): void;
     /** The intro keeps the welcome block mutable; settling lets it retire to history. */
@@ -56,7 +59,7 @@ export declare class WelcomeComponent implements Component {
     setVersion(version: string): void;
     setModel(modelName: string, providerName: string): void;
     setRecentSessions(sessions: RecentSession[]): void;
-    setLspServers(servers: LspServerInfo[]): 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/component.d.ts

@@ -1,9 +1,9 @@
 import { type Component, type ComposerStyle } from "../index.js";
 import type { StatusLineHost, StatusLineSession } from "./host.js";
+import type { Editor } from "../components/editor.js";
 import { type CodexResetFireworksEvent } from "../overlays/codex-reset-fireworks.js";
 import { type SegmentContext } from "./segments.js";
 import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types.js";
-type StatusLineLayout = "box" | "band" | "plain-full" | "plain-left" | "plain-right";
 export declare class StatusLineComponent<TSession extends StatusLineSession = StatusLineSession> implements Component {
     #private;
     private session;
@@ -114,6 +114,12 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
      * never retire the watcher or abort a live resolve.
      */
     applyCwdChange(): void;
+    /**
+     * Seed working-tree status from the status line this one replaces (the
+     * startup bar), so the dirty counts stay on screen instead of blanking until
+     * this instance's first fetch lands. Normal TTL refreshes follow.
+     */
+    adoptGitStatus(source: StatusLineComponent): void;
     /**
      * Startup redraws only arm a short-delayed task; timeout releases the render
      * cadence while a late successful fetch can still refresh the cached segment.
@@ -133,8 +139,12 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
         usedTokens: number;
         contextWindow: number;
     };
-    /** Render startup ellipses inside each segment's normal icon, color, and static chrome. */
-    renderStartupPlaceholder(width: number, layout: StatusLineLayout): string;
+    /**
+     * Wire this bar into `editor` for a composer layout: the matching top-border
+     * provider, the autocomplete probe, and the standalone bottom-bar placement.
+     * Callers re-run it whenever the composer shape changes.
+     */
+    attachToEditor(editor: Pick<Editor, "isAutocompleteActive" | "setTopBorderProvider" | "setTopBorder">, style: Pick<ComposerStyle, "statusAttachment" | "bottomBar" | "bottomBarGap">): void;
     getTopBorder(width: number, previewTitle?: string): {
         content: string;
         width: number;
@@ -181,4 +191,3 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     getPreviewLines(width: number, style?: Pick<ComposerStyle, "statusAttachment" | "bottomBar">): string[];
     render(width: number): readonly string[];
 }
-export {};

package/dist/types/status-line/metrics.d.ts

@@ -5,7 +5,6 @@ export interface BillingSummaryOptions {
     readonly usingSubscription: boolean;
     readonly premiumRequests: number;
     readonly fractionDigits: number;
-    readonly startupPlaceholder?: boolean;
     readonly pricingPeriod?: "peak" | "off-peak";
     readonly advisor?: {
         readonly cost: number;

package/dist/types/status-line/startup.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Status line for the speculative first frame, before any session exists.
+ *
+ * InteractiveMode persists {@link StatusLineStartupData} (settings plus the last
+ * session's model and thinking state); the next launch renders it through the
+ * real {@link StatusLineComponent} as a fresh, unnamed session at the live
+ * terminal width. Path and git branch are read live; context usage is reported
+ * unknown so the gauge shows the window without a percent.
+ *
+ * @example
+ * ```ts ignore
+ * const statusLine = createStartupStatusLine(cached.statusLine);
+ * statusLine.attachToEditor(editor, getComposerStyle(shape));
+ * ```
+ */
+import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Model } from "@oh-my-pi/pi-catalog/types";
+import { StatusLineComponent } from "./component.js";
+import type { CompactionBoundaries } from "./context-usage.js";
+import type { StatusLineSettings } from "./types.js";
+/** Session-independent inputs that reproduce a fresh session's status bar on the next launch. */
+export interface StatusLineStartupData {
+    readonly settings: StatusLineSettings;
+    readonly gitEnabled: boolean;
+    /** Model of the last session; the next fresh session usually starts on it too. */
+    readonly model?: Model;
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly autoThinking: boolean;
+    readonly fastMode: boolean;
+    /** Whether `model` bills through a subscription (drives the cost segment's prefix). */
+    readonly usingSubscription: boolean;
+    readonly autoCompactEnabled: boolean;
+    readonly compactionBoundaries: CompactionBoundaries | null;
+}
+/** Build the prepaint status line; the caller disposes it once the session-bound bar mounts. */
+export declare function createStartupStatusLine(data: StatusLineStartupData): StatusLineComponent;
+/** Validate persisted {@link StatusLineStartupData}; `undefined` for anything malformed. */
+export declare function readStatusLineStartupData(value: unknown): StatusLineStartupData | undefined;

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

@@ -82,8 +82,6 @@ export interface SegmentContext {
     sessionAccent?: boolean;
     /** Stand-in session title for previews; `session_name` renders it when the session is unnamed. */
     previewTitle?: string;
-    /** Replace dynamic values with ellipses while preserving each segment's icon, color, and static text. */
-    startupPlaceholder?: boolean;
     activeRepo: ActiveRepoContext | null;
     width: number;
     options: StatusLineSegmentOptions;

package/dist/types/terminal-capabilities.d.ts

@@ -154,11 +154,15 @@ export declare function hyperlinksUserOverride(env?: NodeJS.ProcessEnv): boolean
  * Policy (highest precedence first):
  *   1. Explicit user override (`PI_NO_HYPERLINKS=1` off, `PI_FORCE_HYPERLINKS=1`
  *      on). Opt-out wins ties.
- *   2. Static terminal capability — terminals whose {@link TerminalInfo} marks
+ *   2. Herdr pane with no nested screen/tmux: on. Herdr hides the outer
+ *      terminal (`TERM=xterm-256color`, no `TERM_PROGRAM`), but it renders
+ *      OSC 8 in its own grid and opens links itself on Ctrl+click, so the
+ *      outer terminal's support does not matter.
+ *   3. Static terminal capability — terminals whose {@link TerminalInfo} marks
  *      `hyperlinks: false` (e.g. `base`) stay off unless the user forced on.
- *   3. GNU screen's explicit session marker (`STY`) always off, even if tmux is
+ *   4. GNU screen's explicit session marker (`STY`) always off, even if tmux is
  *      also present: a screen layer anywhere in the path cannot forward OSC 8.
- *   4. tmux session (`TMUX` set): enabled when tmux self-reports >= 3.4 via
+ *   5. tmux session (`TMUX` set): enabled when tmux self-reports >= 3.4 via
  *      `TERM_PROGRAM_VERSION` (tmux 3.4 stores OSC 8 as a cell attribute and
  *      forwards it to outer terminals whose `terminal-features` include
  *      `hyperlinks`). Older or unknown versions stay off; on outer terminals
@@ -166,11 +170,11 @@ export declare function hyperlinksUserOverride(env?: NodeJS.ProcessEnv): boolean
  *      identical to today. Checked before the screen-family TERM heuristic
  *      because tmux's historical `default-terminal` is `screen-256color`, so
  *      `TERM=screen*` inside a tmux session must NOT short-circuit to off.
- *   5. screen-family TERM without `TMUX` always off: screen never gained OSC 8
+ *   6. screen-family TERM without `TMUX` always off: screen never gained OSC 8
  *      support.
- *   6. tmux-family TERM without `TMUX` env — unusual (e.g. inspection scripts);
+ *   7. tmux-family TERM without `TMUX` env — unusual (e.g. inspection scripts);
  *      no version available, so off.
- *   7. Otherwise honor the static terminal capability.
+ *   8. Otherwise honor the static terminal capability.
  */
 export declare function shouldEnableHyperlinksByDefault(env?: NodeJS.ProcessEnv, terminalId?: TerminalId): boolean;
 /**

package/dist/types/tools/output-meta.d.ts

@@ -73,9 +73,10 @@ export interface LimitsMeta {
         reached: number;
         suggestion: number;
     };
+    /** `suggestion` is omitted when the tool is already at its hard cap, so no larger usable limit exists to advise. */
     resultLimit?: {
         reached: number;
-        suggestion: number;
+        suggestion?: number;
     };
     headLimit?: {
         reached: number;

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

@@ -8,6 +8,8 @@ export interface VibeToolDetails {
     op: VibeOp;
     /** Live TV-wall snapshot of the owner's worker sessions at (or during) the call. */
     screens: VibeScreenSnapshot[];
+    /** Sessions the director killed, left off `screens`; shown as a count. */
+    hiddenKilled?: string[];
     spawned?: {
         id: string;
         cli: VibeCli;
@@ -38,6 +40,8 @@ export interface VibeScreenSnapshot {
     id: string;
     cli: VibeCli;
     state: VibeSessionState;
+    /** Terminated by the director (`vibe_kill`) or mode teardown; unset for workers that died on their own. */
+    killed?: boolean;
     model?: string;
     turns: number;
     queued: number;

package/package.json

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

package/src/chat/assistant-message.ts

@@ -12,7 +12,7 @@ import type { AssistantThinkingRenderer } from "./extension-types";
 import { ensureThemeSync, getMarkdownTheme, theme } from "../theme";
 import { EMPTY_LINK_TARGETS, resolveImageOptions } from "../render/render-utils";
 import { WidthAwareText } from "../render";
-import { convertImageToPng } from "./image-loading";
+import { cachedPngConversion, convertImageToPngShared, imagePayloadKey } from "./image-loading";
 import { canonicalizeMessage, formatThinkingForDisplay, hasDisplayableThinking } from "./thinking-display";
 import { resolveAssistantErrorPresentation } from "./transcript-render-helpers";
 import { type CacheInvalidation, CacheInvalidationMarkerComponent } from "./cache-invalidation-marker";
@@ -186,10 +186,20 @@ export class AssistantMessageComponent extends Container {
 	#lastMessage?: AssistantMessage;
 	#emergencyText?: Markdown;
 	#toolImagesByCallId = new Map<string, ImageContent[]>();
-	#convertedKittyImages = new Map<string, ImageContent>();
+	/**
+	 * Payload keys ({@link imagePayloadKey}) whose Kitty PNG conversion this
+	 * component already awaits, so a re-delivered image neither re-encodes nor
+	 * schedules a second {@link updateContent} cascade. The conversions
+	 * themselves are shared process-wide by {@link convertImageToPngShared}.
+	 */
+	#kittyConversionsAwaited = new Set<string>();
+	/**
+	 * Conversions this component displays, held so a later re-render (theme
+	 * invalidation) still finds them after the bounded shared cache evicts them.
+	 */
+	#kittyConverted = new Map<string, ImageContent>();
 	#showImages = true;
 	#showToolResultImages = true;
-	#kittyConversionsInFlight = new Set<string>();
 	#transcriptBlockFinalized: boolean;
 	/** See {@link setMidStreamPublication}; the wire's `stream-revision` axis decides it. */
 	#midStreamPublication = true;
@@ -832,16 +842,6 @@ export class AssistantMessageComponent extends Container {
 	setToolResultImages(toolCallId: string, images: ImageContent[]): void {
 		if (!toolCallId) return;
 		const validImages = images.filter(img => img.type === "image" && img.data && img.mimeType);
-		for (const key of Array.from(this.#convertedKittyImages.keys())) {
-			if (key.startsWith(`${toolCallId}:`)) {
-				this.#convertedKittyImages.delete(key);
-			}
-		}
-		for (const key of Array.from(this.#kittyConversionsInFlight)) {
-			if (key.startsWith(`${toolCallId}:`)) {
-				this.#kittyConversionsInFlight.delete(key);
-			}
-		}
 		if (validImages.length === 0) {
 			this.#toolImagesByCallId.delete(toolCallId);
 		} else {
@@ -855,21 +855,27 @@ export class AssistantMessageComponent extends Container {
 
 	#convertImagesForKitty(entries: Array<{ image: ImageContent; key: string }>): void {
 		if (TERMINAL.imageProtocol !== ImageProtocol.Kitty) return;
-		for (const { image, key } of entries) {
+		for (const { image } of entries) {
 			if (image.mimeType === "image/png") continue;
-			if (this.#convertedKittyImages.has(key) || this.#kittyConversionsInFlight.has(key)) continue;
-			this.#kittyConversionsInFlight.add(key);
-			convertImageToPng(image)
+			const key = imagePayloadKey(image);
+			if (this.#kittyConverted.has(key)) continue;
+			const cached = cachedPngConversion(image);
+			if (cached) {
+				this.#kittyConverted.set(key, cached);
+				continue;
+			}
+			if (this.#kittyConversionsAwaited.has(key)) continue;
+			this.#kittyConversionsAwaited.add(key);
+			convertImageToPngShared(image)
 				.then(converted => {
-					this.#kittyConversionsInFlight.delete(key);
-					this.#convertedKittyImages.set(key, converted);
+					this.#kittyConverted.set(key, converted);
 					if (this.#lastMessage) {
 						this.updateContent(this.#lastMessage, { transient: this.#lastUpdateTransient });
 					}
 					this.#onImageUpdate?.();
 				})
 				.catch(() => {
-					this.#kittyConversionsInFlight.delete(key);
+					this.#kittyConversionsAwaited.delete(key);
 				});
 		}
 	}
@@ -882,7 +888,7 @@ export class AssistantMessageComponent extends Container {
 		for (const { image, key } of entries) {
 			const displayImage =
 				TERMINAL.imageProtocol === ImageProtocol.Kitty && image.mimeType !== "image/png"
-					? this.#convertedKittyImages.get(key)
+					? this.#kittyConverted.get(imagePayloadKey(image))
 					: image;
 			if (TERMINAL.imageProtocol && displayImage) {
 				this.#contentContainer.addChild(