@oh-my-pi/pi-tui 18.8.8 → 18.9.0

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

@@ -1,5 +1,5 @@
 import type { Model } from "@oh-my-pi/pi-ai";
-import type { ModelKind } from "@oh-my-pi/pi-catalog/types";
+import { type ModelKind } from "@oh-my-pi/pi-catalog/types";
 import type { Component } from "../tui.js";
 import type { SgrMouseEvent } from "../mouse.js";
 import { type ConfiguredThinkingLevel } from "../thinking.js";
@@ -103,6 +103,14 @@ export type RoleAssignments = Record<string, RoleAssignment | undefined>;
  * the alt+p session picker.
  */
 export declare function resolveRoleAssignments(settings: ModelBrowserSource, allModels: ReadonlyArray<Model>, autoCandidates: ReadonlyArray<Model>): RoleAssignments;
+/**
+ * Role-resolution pool for a `--models`/`enabledModels` scope: the scoped
+ * models plus every available non-chat runner (judge, search, image, …). The
+ * scope only filters chat models (it feeds Ctrl+P cycling) and runtime role
+ * resolution ignores it for other kinds, so displayed role assignments must too.
+ * Shared by the /models hub and the session picker.
+ */
+export declare function scopedRolePool(scoped: ReadonlyArray<Model>, registry: ModelBrowserRegistry): Model[];
 /** Wrap raw models into browser items. */
 export declare function buildBrowserItems(models: ReadonlyArray<Model>): ModelBrowserItem[];
 /** Options for {@link sortModelItems}. */

package/dist/types/overlays/settings-defs.d.ts

@@ -44,6 +44,7 @@ export type AnyUiMetadata = UiBase & {
     options?: ReadonlyArray<SubmenuOption> | "runtime";
     secret?: boolean;
     ordered?: boolean;
+    editor?: "json";
 };
 /** Structural schema entries supplied by the application host. */
 export interface SettingsDisplayEntry {

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

@@ -1,4 +1,4 @@
-import type { UsageLimit, UsageReport, UsageResetCredits } from "@oh-my-pi/pi-ai";
+import type { UsageLimit, UsageReport, UsageResetCreditDetail, UsageResetCredits } from "@oh-my-pi/pi-ai";
 /** Include the usage tier in a limit title unless its label already names it. */
 export declare function formatLimitTitle(limit: UsageLimit): string;
 /** Human-readable quota scope for a normalized saved-reset window ID. */
@@ -10,6 +10,8 @@ export interface UsageResetSummary {
     soonestExpiry?: string;
     unavailableReason?: string;
 }
+/** Expiry (epoch ms) of a credit that still banks a reset, whether or not it can be spent now. */
+export declare function bankedResetCreditExpiryMs(credit: UsageResetCreditDetail): number | undefined;
 /**
  * Normalize old count-only and current provider reset metadata for display.
  * `availableCount` is banked inventory; `redeemableCount` is the subset that

package/dist/types/setup/scenes/types.d.ts

@@ -28,6 +28,7 @@ export interface SetupHost extends SetupUiHost {
     readonly disabledProviders: readonly string[];
     readonly authStorage: AuthStorage;
     readonly modelSource: ModelBrowserSource;
+    /** Available and catalog models of every kind; role chips resolve over all of them, rows list chat models. */
     getModels(): {
         available: Model[];
         all: Model[];

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

@@ -111,6 +111,8 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     setRecording(recording: boolean): void;
     /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
     setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
+    /** Set the callback that presents the first pool-wide saved-reset expiry warning, or clear it with `undefined`. */
+    setResetExpiryNoticeHandler(handler: ((notice: string) => void) | undefined): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;
     dispose(): void;

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

@@ -2,7 +2,7 @@ import type { AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Tool, UsageLimit, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Model } from "@oh-my-pi/pi-catalog/types";
 import type { CompactionBoundaries } from "./context-usage.js";
-import type { StatusLineSettings } from "./types.js";
+import type { StatusLineSettings, StatusResetExpiry } from "./types.js";
 export interface StatusAccountIdentity {
     accountId?: string;
     email?: string;
@@ -126,6 +126,9 @@ export interface StatusLineHost<TSession extends StatusLineSession = StatusLineS
     }>;
     calculateTokensPerSecond(messages: readonly AgentMessage[], isStreaming: boolean): number | null;
     limitMatchesActiveAccount(report: UsageReport, limit: UsageLimit, identity: StatusAccountIdentity): boolean;
+    classifyResetExpiry?(report: UsageReport, nowMs: number): StatusResetExpiry | undefined;
+    /** One-line warning for saved resets anywhere in the pool that expire within 24 hours. */
+    resetExpiryNotice?(reports: readonly UsageReport[], nowMs: number): string | undefined;
     computeCompactionBoundaries(session: TSession, contextWindow: number, model?: Model): CompactionBoundaries | null;
 }
 export interface FooterHost {

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

@@ -223,9 +223,18 @@ export interface SegmentContext {
             expiryHours?: number;
             expired?: boolean;
             unavailableReason?: string;
+            expiring?: StatusResetExpiry;
         };
     } | null;
 }
+/** How close an account's saved resets are to expiring, when it is worth a warning. */
+export interface StatusResetExpiry {
+    /** `soon`: within 7 days; `imminent`: within 24 hours. */
+    tier: "soon" | "imminent";
+    count: number;
+    /** Expiry of the reset the warning is about (epoch ms); it can be later than the soonest banked one. */
+    expiresAtMs: number;
+}
 export interface RenderedSegment {
     content: string;
     visible: boolean;
@@ -245,8 +254,8 @@ export interface SegmentView {
 }
 /**
  * The status line's facts for the native composer. A TSP terminal shows no
- * status strip: the tab title carries the session, the pane header the path
- * and branch, and the composer the rest.
+ * status strip: the tab title carries the session, the pane header the path,
+ * and the composer the rest (the git branch among its facts).
  */
 export interface ComposerFacts {
     /**

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

@@ -1,6 +1,6 @@
 import type { HangulCompatibilityJamoWidth } from "./utils.js";
 export * from "./terminal-multiplexer.js";
-export { isInsideTmux, wrapTmuxPassthrough } from "./tmux.js";
+export { wrapTmuxPassthrough } from "./tmux.js";
 export declare enum ImageProtocol {
     Kitty = "\u001B_G",
     Iterm2 = "\u001B]1337;File=",
@@ -55,12 +55,6 @@ export declare class TerminalInfo {
     formatNotification(message: string | TerminalNotification): string;
     sendNotification(message: string | TerminalNotification): void;
 }
-/**
- * Whether the agent process is running inside a Zellij session. Read fresh on
- * each call (like {@link isInsideTmux}) so a session attached/detached mid-run
- * is observed and tests can toggle `Bun.env.ZELLIJ` per case.
- */
-export declare function isInsideZellij(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Whether the agent process runs in an SSH session, so the terminal emulator
  * is remote and host-local input/keyboard modes cannot be assumed.
@@ -96,12 +90,12 @@ export declare function synchronizedOutputUserOverride(env?: NodeJS.ProcessEnv):
  *   2. Positive `TERM_FEATURES` advertisement (`Sy`) — survives SSH/mux wrapping.
  *   3. Windows Terminal (1.24+) via `WT_SESSION`, on native win32 and the
  *      WSL/SSH-fronted host alike.
- *   4. Herdr panes. Herdr is otherwise treated as a multiplexer so leaked
- *      kitty/ghostty identities cannot enable placeholder graphics, but its
- *      pane VTE is libghostty and already suppresses compositing while DEC 2026
- *      is set. Leaving sync off lets CUP-diff paints and split write(2) chunks
- *      composite as dirty-row patches — the live viewport tears, with the top
- *      frozen while only the bottom refreshes.
+ *   4. A multiplexer session whose pane VTE honors DEC 2026 regardless of its
+ *      DECRQM reply (Herdr's libghostty pane). Such a multiplexer still owns
+ *      the grid, so leaked kitty/ghostty identities cannot enable placeholder
+ *      graphics, but leaving sync off lets CUP-diff paints and split write(2)
+ *      chunks composite as dirty-row patches — the live viewport tears, with
+ *      the top frozen while only the bottom refreshes.
  *   5. Known direct terminals with confirmed support. SSH does *not* disable —
  *      DEC 2026 passes through SSH when the outer terminal honors it.
  *   6. Everything else starts off, including risky multiplexers; the runtime
@@ -159,27 +153,25 @@ 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. 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.
+ *   2. Every multiplexer session with a hyperlink policy renders OSC 8 itself
+ *      (`render`, e.g. Herdr): on. Herdr hides the outer terminal
+ *      (`TERM=xterm-256color`, no `TERM_PROGRAM`), 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.
- *   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.
- *   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
- *      without the feature configured, tmux silently drops the sequence —
- *      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.
- *   6. screen-family TERM without `TMUX` always off: screen never gained OSC 8
- *      support.
- *   7. tmux-family TERM without `TMUX` env — unusual (e.g. inspection scripts);
- *      no version available, so off.
- *   8. Otherwise honor the static terminal capability.
+ *   4. A session that never forwards OSC 8 (`drop`, e.g. GNU screen's `STY`)
+ *      always off, even when a forwarding multiplexer is also present.
+ *   5. Forwarding sessions (`forward`, e.g. `TMUX`): enabled when every one
+ *      self-reports at least its forwarding version via `TERM_PROGRAM` /
+ *      `TERM_PROGRAM_VERSION` (tmux 3.4). Older or unknown versions stay off;
+ *      on outer terminals without the feature configured, tmux silently drops
+ *      the sequence. Checked before the TERM heuristic because tmux's
+ *      historical `default-terminal` is `screen-256color`, so `TERM=screen*`
+ *      inside a tmux session must NOT short-circuit to off.
+ *   6. TERM naming a multiplexer whose session markers were stripped: off,
+ *      since no session proves the multiplexer forwards OSC 8 (screen never
+ *      does; tmux has no version to check).
+ *   7. Otherwise honor the static terminal capability.
  */
 export declare function shouldEnableHyperlinksByDefault(env?: NodeJS.ProcessEnv, terminalId?: TerminalId): boolean;
 /**

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

@@ -1,20 +1,133 @@
-/** True when this process is running inside a Herdr pane. */
-export declare function isInsideHerdr(env?: NodeJS.ProcessEnv): boolean;
-/** Terminal multiplexers omp recognizes as owning the screen grid. */
-export type TerminalMultiplexer = "herdr" | "tmux" | "screen" | "zellij" | "cmux" | "wmux";
+import type { TerminalMultiplexerModule, TerminalMultiplexerNotificationRequest } from "./multiplexers/types.js";
 /**
- * Classify which terminal multiplexer owns the current screen grid, or `null`
- * for a direct terminal. Single source of truth for both the render-path gate
+ * Every multiplexer omp recognizes, in classification order within each
+ * precedence tier. Adding a multiplexer means adding its module here.
+ */
+declare const registry: readonly [{
+    readonly id: "herdr";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["HERDR_ENV", "HERDR_PANE_ID", "HERDR_TAB_ID", "HERDR_WORKSPACE_ID"];
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+    readonly notifier: {
+        readonly tier: "pane";
+        readonly send: ({ message, env }: TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly hyperlinks: "render";
+    readonly honorsSynchronizedOutput: true;
+    readonly imagesRequireOverride: true;
+}, {
+    readonly id: "tmux";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["TMUX"];
+    readonly termPrefix: "tmux";
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+    readonly notifier: {
+        readonly tier: "inBand";
+        readonly send: ({ sequence, write }: TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly hyperlinks: {
+        readonly forward: {
+            readonly termProgram: "tmux";
+            readonly major: 3;
+            readonly minor: 4;
+        };
+    };
+    readonly backgroundColorCache: {
+        readonly passthrough: typeof import("./tmux.js").wrapTmuxPassthrough;
+        readonly settleMs: 100;
+    };
+    readonly expandsRepPadding: true;
+    readonly expiresSynchronizedOutput: true;
+    readonly altRestoreEndsSynchronizedOutput: true;
+    readonly growsBeforeSigwinch: true;
+}, {
+    readonly id: "screen";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["STY"];
+    readonly termPrefix: "screen";
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+    readonly hyperlinks: "drop";
+}, {
+    readonly id: "zellij";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["ZELLIJ"];
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+    readonly notifier: {
+        readonly tier: "inBand";
+        readonly send: ({ sequence, write }: TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly backgroundQueryBrokenOn: readonly ["darwin"];
+}, {
+    readonly id: "cmux";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["CMUX_WORKSPACE_ID", "CMUX_SURFACE_ID", "CMUX_REMOTE_TRANSPORT"];
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+    readonly notifier: {
+        readonly tier: "surface";
+        readonly send: ({ message, env }: TerminalMultiplexerNotificationRequest) => boolean;
+    };
+}, {
+    readonly id: "wmux";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["WMUX", "WMUX_SURFACE_ID"];
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+}, {
+    readonly id: "orca";
+    readonly precedence: "outerApp";
+    readonly sessionEnvKeys: readonly ["ORCA_PANE_KEY", "ORCA_WORKTREE_ID"];
+    readonly ownsScreenGrid: false;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+}];
+/** Terminal multiplexers omp recognizes. */
+export type TerminalMultiplexer = (typeof registry)[number]["id"];
+/** Every environment variable multiplexer classification reads, including the TERM fallback. */
+export declare const TERMINAL_MULTIPLEXER_ENV_KEYS: readonly string[];
+/**
+ * Whether an explicit session marker identifies the current provider.
+ *
+ * TERM is intentionally excluded: it is a classification fallback, not proof
+ * that a particular multiplexer session owns the current grid.
+ */
+export declare function hasTerminalMultiplexerSession(multiplexer: TerminalMultiplexer, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Every multiplexer whose explicit session markers are present, in registry
+ * order. Nested sessions all appear; TERM is not consulted.
+ */
+export declare function terminalMultiplexerSessions(env?: NodeJS.ProcessEnv): TerminalMultiplexerModule<TerminalMultiplexer>[];
+/**
+ * The multiplexer TERM names, whether or not its session markers survived.
+ * This is classification's TERM fallback; session markers are not consulted.
+ */
+export declare function terminalMultiplexerForTerm(env?: NodeJS.ProcessEnv): TerminalMultiplexerModule<TerminalMultiplexer> | undefined;
+/**
+ * Registry entry for the multiplexer hosting the current process, or
+ * `undefined` for a direct terminal. Same precedence as
+ * {@link classifyTerminalMultiplexer}.
+ */
+export declare function classifyTerminalMultiplexerModule(env?: NodeJS.ProcessEnv): TerminalMultiplexerModule<TerminalMultiplexer> | undefined;
+/**
+ * Classify which terminal multiplexer hosts the current process, or `null` for
+ * a direct terminal. Single source of truth for both the render-path gate
  * (`isInsideTerminalMultiplexer`) and the debug snapshot label.
  *
- * TMUX/STY/ZELLIJ, Herdr, and the CMUX/WMUX workspace/surface/remote-transport
- * markers are authoritative session signals. TERM can also survive when those
- * are stripped (`sudo` without -E, `su`, env-sanitizing launchers/ssh). Do not
- * use CMUX_SOCKET_PATH / WMUX_CLI / WMUX_PIPE here: they are CLI socket/path
- * overrides and can be set outside a CMUX/WMUX terminal. wmux is a Windows
- * multiplexer (Electron + xterm.js) modeled on cmux/herdr that repaints its
- * pane in place and exports WMUX=1 plus a native WMUX_SURFACE_ID.
+ * Session markers are authoritative. TERM can also survive when those markers
+ * are stripped (`sudo` without -E, `su`, env-sanitizing launchers/ssh), so a
+ * `tmux`/`screen` TERM prefix comes next. Outer applications such as Orca rank
+ * last so a multiplexer running inside them wins.
  */
 export declare function classifyTerminalMultiplexer(env?: NodeJS.ProcessEnv): TerminalMultiplexer | null;
-/** True when a terminal multiplexer owns the current screen grid. */
+/** True when the classified multiplexer owns the current screen grid. */
 export declare function isInsideTerminalMultiplexer(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Offer a notification to every active session's notifier, innermost tier
+ * first. Returns whether one delivered it; otherwise the terminal fallback
+ * applies unchanged.
+ */
+export declare function routeTerminalMultiplexerNotification(request: TerminalMultiplexerNotificationRequest): boolean;
+export {};

package/dist/types/terminal.d.ts

@@ -230,6 +230,12 @@ export interface Terminal {
      * `status` is the DECRPM value when the terminal answered DECRQM.
      */
     onPrivateModeReport?(callback: PrivateModeReportHandler): void;
+    /**
+     * Report whether DA1 advertises SIXEL (attribute 4), replaying the latest
+     * advertisement to late subscribers. A missing attribute does not rule out
+     * support discovered through another graphics query.
+     */
+    onSixelSupport?(callback: (supported: boolean) => void): void;
     /**
      * Register a callback fired once the startup Glyph Protocol handshake
      * resolves (see {@link GlyphProtocolReportHandler}). A subscriber that
@@ -298,10 +304,11 @@ export declare class ProcessTerminal implements Terminal {
     onAppearanceReport(callback: (appearance: TerminalAppearance, requestToken?: TerminalAppearanceRequestToken) => void): () => void;
     /**
      * Re-query the terminal background through the startup DA1-sentinel FIFO,
-     * pending/queued gating, parsing, dedup, and appearance callbacks. Inside
-     * tmux, only this explicit path first passes an OSC 11 query to the outer
-     * terminal, waits briefly for tmux to consume the response into its cache,
-     * then reads that cache with a direct query. The outer query deliberately has
+     * pending/queued gating, parsing, dedup, and appearance callbacks. Inside a
+     * multiplexer that answers OSC 11 from a cache (tmux), only this explicit
+     * path first passes an OSC 11 query to the outer terminal, waits briefly for
+     * the multiplexer to consume the response into its cache, then reads that
+     * cache with a direct query. The outer query deliberately has
      * no DA1 sentinel: multiplexers can decode a fragmented DA1 response as a key
      * sequence and leak the remaining bytes into the editor. Startup and Mode 2031
      * probes remain direct. Suppressed while inactive, headless, or after teardown.
@@ -309,6 +316,7 @@ export declare class ProcessTerminal implements Terminal {
     refreshAppearance(requestToken?: TerminalAppearanceRequestToken): TerminalAppearanceRequestToken | void;
     onPrivateModeReport(callback: PrivateModeReportHandler): void;
     onGlyphProtocolReport(callback: GlyphProtocolReportHandler): void;
+    onSixelSupport(callback: (supported: boolean) => void): void;
     onTspHello(callback: TspHelloHandler): void;
     get tspProbePending(): boolean;
     get tspExpected(): boolean;

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

@@ -1,10 +1,19 @@
 import type { SpinnerFramesOverride } from "./symbols.js";
 export type ColorValue = string | number;
+/**
+ * Tokens a theme is allowed to omit. They resolve to the terminal default
+ * foreground, so `Theme.fg()` stays total for callers that paint a token a theme
+ * never declared (e.g. a `modelTags.<role>.color` reference) while
+ * `Theme.hasColor()` still reports them as unset.
+ */
+export declare const OPTIONAL_THEME_COLOR_RECORD: {
+    assistantMessageText: true;
+};
 export interface ThemeJson {
     $schema?: string;
     name: string;
     vars?: Record<string, ColorValue>;
-    colors: Omit<Record<ThemeColor | ThemeBg, ColorValue>, "thinkingMax"> & {
+    colors: Omit<Record<ThemeColor | ThemeBg, ColorValue>, "thinkingMax" | keyof typeof OPTIONAL_THEME_COLOR_RECORD> & Partial<Record<keyof typeof OPTIONAL_THEME_COLOR_RECORD, ColorValue>> & {
         thinkingMax?: ColorValue;
     };
     export?: {
@@ -36,7 +45,7 @@ export interface ThemeJson {
         spinnerFrames?: SpinnerFramesOverride;
     };
 }
-export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "assistantMessageText" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
 export declare function isValidThemeColor(color: string): color is ThemeColor;
 export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";

package/dist/types/theme/theme-class.d.ts

@@ -54,6 +54,13 @@ export declare class Theme {
      * against. Built once per instance and frozen; callers share the object.
      */
     get sessionAccentInputs(): SessionAccentTheme;
+    /**
+     * True when the theme paints `color` with a real foreground — i.e. the token
+     * exists and is not the empty string (terminal default, `\x1b[39m`). Optional
+     * tokens absent from the theme JSON are also false. Callers use this to keep
+     * terminal-default behavior byte-for-byte when an optional token is unset.
+     */
+    hasColor(color: ThemeColor): boolean;
     fg(color: ThemeColor, text: string): string;
     /** Apply a foreground, replacing terminal-default tokens with the theme's contrast-safe fallback. */
     fgResolved(color: ThemeColor, text: string): string;

package/dist/types/tmux.d.ts

@@ -1,7 +1,4 @@
-/** Whether the process is running inside a tmux session. */
-export declare function isInsideTmux(env?: NodeJS.ProcessEnv): boolean;
-/** Wrap a control sequence in tmux's DCS passthrough envelope. */
-export declare function wrapTmuxPassthrough(payload: string): string;
+export { wrapTmuxPassthrough } from "./multiplexers/tmux.js";
 /** Pass a control sequence through tmux, leaving direct-terminal output unchanged. */
 export declare function wrapTmuxPassthroughIfNeeded(payload: string, env?: NodeJS.ProcessEnv): string;
 /**

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

@@ -24,6 +24,8 @@ export interface EvalCellResult {
     durationMs?: number;
     exitCode?: number;
     statusEvents?: EvalStatusEvent[];
+    /** Discrete events dropped from the front of `statusEvents` (see {@link recordStatusEvent}). */
+    statusEventsElided?: number;
     hasMarkdown?: boolean;
 }
 /** Tool result detail object surfaced to the UI/transcript. */
@@ -32,6 +34,8 @@ export interface EvalToolDetails {
     jsonOutputs?: unknown[];
     images?: ImageContent[];
     statusEvents?: EvalStatusEvent[];
+    /** Discrete events dropped from the front of `statusEvents` (see {@link recordStatusEvent}). */
+    statusEventsElided?: number;
     isError?: boolean;
     meta?: OutputMeta;
     /** First backend that produced cells. Kept for transcript compatibility. */
@@ -74,13 +78,28 @@ export declare function statusEventKey(event: {
     op: string;
     [key: string]: unknown;
 }): string | undefined;
+/**
+ * Discrete status events a log keeps. A cell polling a helper in a loop emits
+ * one event per call (hundreds of thousands), and every live update and the
+ * persisted tool result would otherwise carry them all.
+ */
+export declare const MAX_STATUS_EVENTS = 200;
+/** A status event list plus the count of discrete events dropped from its front. */
+export type StatusEventLog = Pick<EvalCellResult, "statusEvents" | "statusEventsElided">;
 /**
  * Append or replace a status event. Progress snapshots (see
  * {@link statusEventKey}) coalesce in place, preserving first-seen order; every
- * other op is a discrete action and simply appends. Keeps the persisted event
- * list bounded even when a subagent or batch emits hundreds of progress ticks.
+ * other op is a discrete action and simply appends.
  */
 export declare function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void;
+/**
+ * {@link upsertStatusEvent} into a bounded log. Past {@link MAX_STATUS_EVENTS},
+ * the oldest discrete event is dropped and counted. Snapshots stay, since agent
+ * cards read them, and so does the newest committed `todo` result, which the
+ * session todo panel refreshes from. Renderers already show only the newest
+ * events behind an "… N earlier" row.
+ */
+export declare function recordStatusEvent(log: StatusEventLog, event: EvalStatusEvent): void;
 /** Render eval code cells, structured display output, and progress events. */
 export declare const evalToolRenderer: {
     animatedPendingPreview: true;

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

@@ -84,12 +84,22 @@ export interface LimitsMeta {
         reached: number;
         suggestion: number;
     };
-    /** `unit` may be absent in sessions persisted before it was recorded. */
+    /**
+     * `unit` may be absent in sessions persisted before it was recorded. `lines` is
+     * the first-to-last range of cut lines, and `selectorBase` the target a
+     * `:raw:<line>-<line>` selector reads one of them whole from (an artifact's
+     * `artifact://<id>` stands in when absent).
+     */
     columnTruncated?: {
         maxColumn: number;
         unit?: "bytes" | "chars";
         artifactId?: string;
         artifactElidedBytes?: number;
+        lines?: {
+            first: number;
+            last: number;
+        };
+        selectorBase?: string;
     };
 }
 /**

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

@@ -31,6 +31,15 @@ export interface OutputSummary {
     columnDroppedBytes?: number;
     /** Number of distinct lines that hit the per-line column cap. */
     columnTruncatedLines?: number;
+    /**
+     * 1-indexed first and last lines the column cap cut, numbered as in the
+     * artifact. Absent when the numbering cannot match the artifact (an inline
+     * substitute was capped, or `replace()` rewrote the buffer).
+     */
+    columnTruncatedRange?: {
+        first: number;
+        last: number;
+    };
     /** Configured per-line column cap in effect (UTF-8 bytes), when > 0. */
     columnMax?: number;
     /** Artifact ID for internal URL access (artifact://<id>) when truncated */

package/package.json

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