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

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 ## [Unreleased]
 
+## [18.4.2] - 2026-09-28
+
+### Changed
+
+- Optimized activity clock rendering by caching timestamp formatting strings
+- Reduced CPU overhead during animated terminal redraws, transcript updates, inline-image bookkeeping, and status-line layout.
+- Reduced per-keystroke CPU in `^` model-mention autocomplete and per-frame CPU while streaming (status line, live transcript blocks, tool cards, frame writes).
+
+### Fixed
+
+- Fixed the `@` completion popup swallowing Tab and cursor-movement keys while a narrowed filter matched nothing: with no candidate to accept they now fall through to their normal completion and cursor roles instead of being trapped ([#13046](https://github.com/can1357/oh-my-pi/pull/13046) by [@jchanghong023](https://github.com/jchanghong023)).
+- Fixed the Esc-Esc rewind and fullscreen `/copy` selectors getting stuck at the oldest turn of a long session's recent tail; stepping past it now loads the earlier history
+- Fixed the composer attachment band showing chip `#1` (and other prefix IDs) as still present when only `#10` remained in the prompt ([#13605](https://github.com/can1357/oh-my-pi/issues/13605))
+
+## [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,11 +96,32 @@ 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;
+    /**
+     * Open one composed frame: every live-block measurement until this frame's
+     * {@link renderViewport} returns renders against `frame` and is taken once,
+     * so the retirement peek and the viewport share each block's render.
+     *
+     * Callers MUST call {@link renderViewport} with the same `frame` in the same
+     * synchronous composition, without mutating any transcript block in
+     * between: the shared rows are only as fresh as that first measurement.
+     */
+    beginFrame(frame: AnimationFrame): void;
+    /**
+     * 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. */
+    /**
+     * Render the live tail, constrained to the supplied transcript height.
+     * Closes the frame {@link beginFrame} opened; a different `frame` discards
+     * its measurements first.
+     */
     renderViewport(width: number, rows: number, frame: AnimationFrame): readonly string[];
     /** Offers stable-head emission or the shortest finalized prefix needed under pressure. */
     peekFinalizedBatch(width: number, capacity: number): HistoryBatch | undefined;

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/model-browser.d.ts

@@ -37,6 +37,11 @@ export interface ResolvedModelRoleValue {
 }
 /** Host-provided preferences and model-role resolution for the browser. */
 export interface ModelBrowserSource extends ModelRoleLookup {
+    /**
+     * Changes whenever any preference this source reads or resolves against changes,
+     * except the storage-backed `mruOrder` and `modelPerf`. Keys derived-scope caches.
+     */
+    readonly revision: number;
     readonly defaultThinkingLevel: string;
     readonly modelProviderOrder: readonly string[];
     readonly knownRoleIds: readonly string[];
@@ -104,6 +109,16 @@ export interface SessionModelScope {
 }
 /** Build the session picker's current scope without creating an interactive browser. */
 export declare function buildSessionModelScope(settings: ModelBrowserSource, registry: ModelBrowserRegistry, scopedModels: ReadonlyArray<Model>): SessionModelScope;
+/**
+ * {@link buildSessionModelScope} for per-keystroke callers: returns the same
+ * scope until the source revision, MRU order, scoped models, or the registry's
+ * available models, catalog, or load error change.
+ */
+export declare class SessionModelScopeCache {
+    #private;
+    constructor(settings: ModelBrowserSource, registry: ModelBrowserRegistry);
+    get(scopedModels: ReadonlyArray<Model>): SessionModelScope;
+}
 /** User affinity used to order search matches within one relevance tier. */
 export interface SearchAffinity {
     /** `provider/id` (lowercased) → rank; configured-role models first, then MRU. */

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

@@ -21,13 +21,14 @@
  * 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 (stepping above the oldest replayed
+ * turn loads them too), 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-attachments.d.ts

@@ -37,6 +37,13 @@ export declare function attachmentSgr(kind: ChipKind, n: number): string;
 export declare const PLACEHOLDER_REGEX: RegExp;
 /** Matches an expanded attachment marker, a compact attachment chip, or a skill chip. */
 export declare const COMPOSER_TOKEN_REGEX: RegExp;
+/**
+ * Attachment indices referenced by a composer buffer, per kind. Image/video count compact chips
+ * and expanded markers; paste counts compact chips only, since `[Paste #N]` markers number the
+ * base editor's separate paste buffer. Registered labels take precedence over theme glyphs so
+ * tokens created before a theme switch keep their kind; full numbers prevent `#1` matching `#10`.
+ */
+export declare function referencedAttachments(text: string, recorded: ReadonlyMap<string, ChipKind>): Record<ChipKind, Set<number>>;
 /** Add the registered model-chip labels to the composer placeholder matcher. */
 export declare function composerTokenRegex(mentionLabels: Iterable<string>): RegExp;
 /** Offsets image marker indices, including matching `attachment://` references. */

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/model-mention-autocomplete.d.ts

@@ -17,7 +17,10 @@ export declare function applyModelMentionCompletion(lines: string[], cursorLine:
     cursorLine: number;
     cursorCol: number;
 };
-/** Create a fresh session-scoped model candidate lookup using picker ordering. */
+/**
+ * Create a session-scoped model candidate lookup using picker ordering. The
+ * scope and search affinity are reused across queries until their inputs change.
+ */
 export declare function createModelMentionSource(host: {
     source: ModelBrowserSource;
     registry: ModelBrowserRegistry;

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/render/width-aware-text.d.ts

@@ -19,5 +19,11 @@ export declare class WidthAwareText implements Component {
     setCustomBgFn(customBgFn?: (text: string) => string): void;
     setIgnoreTight(ignore: boolean): this;
     invalidate(): void;
+    /**
+     * Re-run the formatter on the next render because its inputs changed.
+     * Unlike {@link invalidate}, the inner `Text` keeps its wrap cache, so a
+     * reformat that yields the same string skips re-wrapping and re-tinting.
+     */
+    reformat(): void;
     render(width: number): readonly string[];
 }

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/terminal.d.ts

@@ -276,6 +276,13 @@ export declare class ProcessTerminal implements Terminal {
     stop(): void;
     write(data: string): void;
     get columns(): number;
+    /**
+     * With the output pump, a backlog bound at or below
+     * {@link STDOUT_BACKLOG_CLEAR_BYTES} is reported as-is instead of re-read:
+     * both consumers (the render gate and the stall watchdog) act only on a
+     * backlog above that level, so the bound already decides them and spares a
+     * native read on every frame.
+     */
     get pendingOutputBytes(): number;
     get hostOwnsGridOnResize(): boolean;
     get rows(): number;

package/dist/types/theme/color.d.ts

@@ -5,6 +5,7 @@ export declare const FG_RESET = "\u001B[39m";
 export declare const BG_RESET = "\u001B[49m";
 /** Resolve theme color depth from the shared terminal capability model. */
 export declare function detectColorMode(env?: NodeJS.ProcessEnv): ColorMode;
+/** Convert a theme color to foreground SGR at the requested depth; throws for invalid colors. */
 export declare function colorToAnsi(color: string, mode: ColorMode): string;
 export declare function fgAnsi(color: string | number, mode: ColorMode): string;
 export declare function bgAnsi(color: string | number, mode: ColorMode): string;

package/dist/types/theme/session-color.d.ts

@@ -1,11 +1,11 @@
 /** Theme-derived inputs for {@link getSessionAccentHex}; see `Theme.sessionAccentInputs`. */
 export interface SessionAccentTheme {
     /** Theme accent hex; the session accent adopts its OKLCH lightness and chroma. */
-    accentHex: string;
+    readonly accentHex: string;
     /** Major theme color hexes checked for hue collision. */
-    colorHexes: string[];
+    readonly colorHexes: readonly string[];
     /** WCAG luminance of the status-line surface on light themes; undefined on dark themes. */
-    surfaceLuminance?: number;
+    readonly surfaceLuminance?: number;
 }
 /**
  * Derive a stable CSS hex accent color from a session name and the active theme.

package/dist/types/theme/shimmer.d.ts

@@ -1,6 +1,6 @@
 import type { Theme, ThemeColor } from "./theme.js";
 type ShimmerTheme = Pick<Theme, "bold" | "fg" | "getFgAnsi">;
-/** Sweep style for animated shimmer text; `disabled` renders every tier as the low color. */
+/** Sweep style for animated shimmer text; `disabled` renders every tier as the mid color. */
 export type ShimmerMode = "classic" | "kitt" | "disabled";
 /** Select the shimmer sweep style. The host pushes its `display.shimmer` preference here. */
 export declare function setShimmerMode(mode: ShimmerMode): void;