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

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## [Unreleased]
 
+## [18.8.9] - 2026-10-10
+
+### Breaking Changes
+
+- Removed the `isInsideTmux()`, `isInsideZellij()`, and `isInsideHerdr()` exports; use `hasTerminalMultiplexerSession("tmux" | "zellij" | "herdr", env)` instead ([#13620](https://github.com/can1357/oh-my-pi/pull/13620) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy))
+
+### Added
+
+- `classifyTerminalMultiplexer()` reports `"orca"` inside Orca terminals while `isInsideTerminalMultiplexer()` stays false there, so Orca keeps the direct-terminal render path; `TERMINAL_MULTIPLEXER_ENV_KEYS` lists every environment variable multiplexer detection reads ([#13620](https://github.com/can1357/oh-my-pi/pull/13620) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy))
+- Added `terminalMultiplexerSessions()`, `terminalMultiplexerForTerm()`, `classifyTerminalMultiplexerModule()`, and `routeTerminalMultiplexerNotification()`, driven by one multiplexer registry that now owns notification routing and per-multiplexer capability overrides ([#13620](https://github.com/can1357/oh-my-pi/pull/13620) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy))
+- Added `change` and `progress` table-chart kinds with `ChartSpec.baseline` and `TableColumn.scores`: a before/after table whose rows have their own units charts each metric as a factor of the baseline column (rows without two numbers are named in the caption), and `analyzeTable` reads whole-number scores (`12/12`, `154/160`) as the percent of their total, keeping `a / b` pairs and lists as written
+
+### Changed
+
+- `StatusLineComponent.describeComposerFacts()` includes the configured `git` segment among the composer's facts (branch and status, the `status.git` click action, pinned so it outlasts the other facts) instead of leaving the branch to Tern's pane header ([#15220](https://github.com/can1357/oh-my-pi/pull/15220) by [@H4vC](https://github.com/H4vC))
+- Small-multiple table charts with more than three panels and at most six categories draw as bands of per-metric panels with a color legend, and `worthCharting` counts their panels like categories
+- Table charts take the look of Apple's charts and Tern: a UI sans, hairline gridlines, rounded bars and cells, smooth lines over a soft area fill, dot legends, left-aligned category labels that never run off the edge, and axes labeled in one unit (`0, 5k, 10k`)
+- Line charts whose series differ 8× or more in size stack panels on their own axes instead of flattening the smaller lines, and their end labels no longer overlap
+- SVG figure series colors `--c1`…`--c6` are an even-weight palette led by the theme accent's hue instead of syntax colors
+
+### Fixed
+
+- Fixed `parseCell` throwing on table cells such as `3 constructor` or `2 valueOf calls`, and reading a `constructor` cell as a missing value
+
 ## [18.8.8] - 2026-10-10
 
 ### Breaking Changes
@@ -2982,26 +3006,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 - Added undo support to Editor with Ctrl+- hotkey. Undo coalesces consecutive word characters into one unit (fish-style). ([#831](https://github.com/badlogic/pi-mono/pull/831) by [@Perlence](https://github.com/Perlence))
 - Added legacy terminal support for Ctrl+symbol keys (Ctrl+\, Ctrl+], Ctrl+-) and their Ctrl+Alt variants. ([#831](https://github.com/badlogic/pi-mono/pull/831) by [@Perlence](https://github.com/Perlence))
 
-## [0.49.0] - 2026-01-17
-
-### Added
-
-- Added `showHardwareCursor` getter and setter to control cursor visibility while keeping IME positioning active. ([#800](https://github.com/badlogic/pi-mono/pull/800) by [@ghoulr](https://github.com/ghoulr))
-- Added Emacs-style kill ring editing with yank and yank-pop keybindings. ([#810](https://github.com/badlogic/pi-mono/pull/810) by [@Perlence](https://github.com/Perlence))
-- Added legacy Alt+letter handling and Alt+D delete word forward support in the editor keymap. ([#810](https://github.com/badlogic/pi-mono/pull/810) by [@Perlence](https://github.com/Perlence))
-
-## [0.48.0] - 2026-01-16
-
-### Added
-
-- `EditorOptions` with optional `paddingX` for horizontal content padding, plus `getPaddingX()`/`setPaddingX()` methods ([#791](https://github.com/badlogic/pi-mono/pull/791) by [@ferologics](https://github.com/ferologics))
-
-### Changed
-
-- Hardware cursor is now disabled by default for better terminal compatibility. Set `PI_HARDWARE_CURSOR=1` to enable (replaces `PI_NO_HARDWARE_CURSOR=1` which disabled it).
-
-### Fixed
-
-- Decode Kitty CSI-u printable sequences in the editor so shifted symbol keys (e.g., `@`, `?`) work in terminals that enable Kitty keyboard protocol ([#779](https://github.com/badlogic/pi-mono/pull/779) by [@iamd3vil](https://github.com/iamd3vil))
-
-Older entries are archived in [packages/tui/CHANGELOG.md@01e0b5c26e26](https://github.com/can1357/oh-my-pi/blob/01e0b5c26e267dff08c305f51d1ab56ec5a2f05d/packages/tui/CHANGELOG.md).
+Older entries are archived in [packages/tui/CHANGELOG.md@110bcbdfe908](https://github.com/can1357/oh-my-pi/blob/110bcbdfe908cbe2978e7607d4f2fe64a0c13de0/packages/tui/CHANGELOG.md).

package/dist/types/charts/chart-plan.d.ts

@@ -24,14 +24,16 @@ import { type Dimension, type TableAnalysis } from "./table-data.js";
  * - `share`: parts of a whole (percentages summing to 100).
  * - `diverging`: signed changes around zero.
  * - `scatter`: two continuous measures per item.
+ * - `change`: metrics in different units against a baseline column (before/after), as factors.
+ * - `progress`: scores out of a total (`12/12`), as filled tracks.
  */
-export type ChartKind = "bar" | "paired" | "grouped" | "line" | "heatmap" | "multiples" | "share" | "diverging" | "scatter";
+export type ChartKind = "bar" | "paired" | "grouped" | "line" | "heatmap" | "multiples" | "share" | "diverging" | "scatter" | "change" | "progress";
 /** What to draw from a table: the kind, the column naming each category, and the columns plotted. */
 export interface ChartPlan {
     readonly kind: ChartKind;
     /** Column naming each category (or holding the x values of a line); rows are numbered without one. */
     readonly label: number | undefined;
-    /** Plotted columns, in order. */
+    /** Plotted columns, in order; a `change` measures the rest against the first (or its `a → b` cells). */
     readonly series: readonly number[];
     /** Each data row is its own series (a metric with its own unit) and the plotted columns are the categories. */
     readonly transpose: boolean;
@@ -73,6 +75,8 @@ export interface ChartSpec {
     readonly caption?: string;
     /** Name of the category axis (the label column's header). */
     readonly axis: string;
+    /** What a `change` measures against (its baseline column); its points are factors of it. */
+    readonly baseline?: string;
 }
 /** The local best guess at a chart for `table`, or `undefined` when no chart fits. */
 export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
@@ -85,8 +89,10 @@ export declare function planChart(table: TableAnalysis): ChartPlan | undefined;
 export declare function buildChart(table: TableAnalysis, plan: ChartPlan): ChartSpec | undefined;
 /**
  * Whether a chart of `spec` reads faster than its table: at least four
- * categories, and either nine plotted values or a 3× spread within a series.
- * On a model-judged sample of assistant tables this gate kept 85% of the
- * tables a chart clearly helped while rejecting most two- and three-row ones.
+ * categories (or small-multiple panels), and either nine plotted values or a
+ * 3× spread within a series. On a model-judged sample of assistant tables this
+ * gate kept 85% of the tables a chart clearly helped while rejecting most two-
+ * and three-row ones. A `change` needs three metrics and one moving by
+ * {@link NOTABLE_FACTOR} either way: its factors are what the table lacks.
  */
 export declare function worthCharting(spec: ChartSpec): boolean;

package/dist/types/charts/chart-svg.d.ts

@@ -6,10 +6,12 @@
  * so the host resolves them against the live theme (`prepareSvg`) for both
  * the rasterized terminal image and the native TSP blob.
  *
- * Geometry follows the terminal: 16 user units per row and a monospace face,
- * so 13-unit labels land near the terminal's own glyph size. Marks are flat
- * and square (no rounding, gradients or shadows); bolded table cells draw at
- * full strength while their neighbours recede.
+ * Styled after Apple's charts and Tern's UI: a UI sans (Geist where Tern
+ * provides it), muted labels, hairline gridlines that recede behind the
+ * marks, bars and cells with rounded corners, smooth lines over a soft area
+ * fill, dot legends. 13-unit labels land near the terminal's own glyph size
+ * at 16 user units per row; bolded table cells draw at full strength while
+ * their neighbours recede.
  */
 import type { ChartSpec } from "./chart-plan.js";
 import type { Dimension } from "./table-data.js";
@@ -24,7 +26,9 @@ export declare function renderChartSvg(spec: ChartSpec): ChartSvg;
 /** One-line description of the chart, for screen readers and terminals that show the alt text. */
 export declare function chartAlt(spec: ChartSpec): string;
 /**
- * A value in base units as an axis label: durations and sizes in the unit
- * their magnitude reads best in, counts compacted (`12k`, `3.4M`).
+ * A value in base units as an axis label: durations and sizes in the unit,
+ * counts compacted under the suffix (`12k`, `3.4M`), that `magnitude` reads
+ * best in — the value's own size by default, an axis' largest tick to keep
+ * its labels in one unit.
  */
-export declare function formatValue(value: number, dim: Dimension, unit: string): string;
+export declare function formatValue(value: number, dim: Dimension, unit: string, magnitude?: number): string;

package/dist/types/charts/table-data.d.ts

@@ -42,7 +42,10 @@ export interface NumberCell {
     readonly toFigure?: string;
     /** `a–b`: `b`, in the same base units. */
     readonly upper?: number;
-    /** `a/b`: `b`. */
+    /**
+     * `a/b`: `b`. {@link analyzeTable} reads a score (`12/12`, `154/160`) as the
+     * percent of `b` reached; a pair (`85 / 147` under `Edit / read calls`) keeps `a`.
+     */
     readonly denominator?: number;
 }
 /** A cell that is not a quantity. */
@@ -70,6 +73,8 @@ export interface TableColumn {
     readonly unit: string;
     /** Numeric cells disagree on dimension (a metric-per-row table). */
     readonly mixed: boolean;
+    /** Numeric cells are mostly scores out of a total (`12/12`), read as percent of it. */
+    readonly scores: boolean;
     /** Every numeric data cell holds the same value: an echoed setting, not a measure. */
     readonly constant: boolean;
     /** Share of numeric cells written with an explicit sign. */

package/dist/types/kitty-graphics.d.ts

@@ -30,8 +30,8 @@ export interface KittyGraphicsFeatures {
  * cannot use cursor-positioned placements because the outer terminal does not
  * know pane scroll/reflow state. An explicit `PI_FORCE_IMAGE_PROTOCOL=kitty`
  * opts into placeholders under any multiplexer — matching `timg -pk`.
- * Automatic Herdr fallback stays off because its pane marker does not prove
- * that the experimental Kitty renderer is enabled.
+ * Automatic fallback stays off inside multiplexers whose pane marker does not
+ * prove that a Kitty renderer is enabled (Herdr's is experimental).
  *
  * `PI_NO_KITTY_PLACEHOLDERS=1` and `PI_KITTY_PLACEHOLDERS=0` remain hard
  * opt-outs; `PI_KITTY_PLACEHOLDERS=1` explicitly opts in anywhere else.

package/dist/types/multiplexers/cmux.d.ts

@@ -0,0 +1,16 @@
+export declare const cmuxMultiplexer: {
+    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;
+    /**
+     * Workspace/socket state alone is not enough: only the injected surface UUID
+     * identifies the pane that should receive the notification. Without a valid
+     * surface, or without the binary, delivery falls through unchanged.
+     */
+    readonly notifier: {
+        readonly tier: "surface";
+        readonly send: ({ message, env }: import("./types.js").TerminalMultiplexerNotificationRequest) => boolean;
+    };
+};

package/dist/types/multiplexers/herdr.d.ts

@@ -0,0 +1,26 @@
+export declare const herdrMultiplexer: {
+    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;
+    /**
+     * Herdr multiplexes panes like tmux but swallows bare OSC 9 / OSC 99 and has
+     * no DCS passthrough envelope, and its bell relay does not flag a
+     * backgrounded tab — so without its CLI a backgrounded pane gets no signal
+     * at all that the agent finished or is waiting for input.
+     *
+     * `sound` maps the notification kind onto what Herdr offers: a question
+     * waiting on the user and a turn that stopped with an error both need the
+     * human and ring `request`, a settled turn rings `done`, anything else stays
+     * silent. The exact pane ID addresses the CLI call; without a valid one, or
+     * without the binary, delivery falls through.
+     */
+    readonly notifier: {
+        readonly tier: "pane";
+        readonly send: ({ message, env }: import("./types.js").TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly hyperlinks: "render";
+    readonly honorsSynchronizedOutput: true;
+    readonly imagesRequireOverride: true;
+};

package/dist/types/multiplexers/notify.d.ts

@@ -0,0 +1,13 @@
+import type { TerminalNotification } from "../terminal-capabilities.js";
+/** Title for out-of-band multiplexer notifications that carry none of their own. */
+export declare const DEFAULT_NOTIFICATION_TITLE = "omp";
+/** Title and body for an out-of-band multiplexer notification (cmux, Herdr). */
+export declare function notificationTitleAndBody(message: string | TerminalNotification): {
+    title: string;
+    body: string;
+};
+/**
+ * Start a notifier CLI without waiting for or pinning it. Returns false when
+ * the binary cannot be spawned, which leaves delivery to the terminal fallback.
+ */
+export declare function spawnNotifier(cmd: string[]): boolean;

package/dist/types/multiplexers/orca.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Orca is an xterm.js-based IDE whose terminals expose paired pane/worktree IDs.
+ * It is recognized for launches, but it ranks below nested multiplexers and keeps
+ * the direct-terminal render path it used before it was recognized.
+ */
+export declare const orcaMultiplexer: {
+    readonly id: "orca";
+    readonly precedence: "outerApp";
+    readonly sessionEnvKeys: readonly ["ORCA_PANE_KEY", "ORCA_WORKTREE_ID"];
+    readonly ownsScreenGrid: false;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+};

package/dist/types/multiplexers/screen.d.ts

@@ -0,0 +1,9 @@
+export declare const screenMultiplexer: {
+    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";
+};

package/dist/types/multiplexers/tmux.d.ts

@@ -0,0 +1,29 @@
+/** Wrap a control sequence in tmux's DCS passthrough envelope. */
+export declare function wrapTmuxPassthrough(payload: string): string;
+export declare const tmuxMultiplexer: {
+    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 }: import("./types.js").TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly hyperlinks: {
+        readonly forward: {
+            readonly termProgram: "tmux";
+            readonly major: 3;
+            readonly minor: 4;
+        };
+    };
+    readonly backgroundColorCache: {
+        readonly passthrough: typeof wrapTmuxPassthrough;
+        readonly settleMs: 100;
+    };
+    readonly expandsRepPadding: true;
+    readonly expiresSynchronizedOutput: true;
+    readonly altRestoreEndsSynchronizedOutput: true;
+    readonly growsBeforeSigwinch: true;
+};

package/dist/types/multiplexers/types.d.ts

@@ -0,0 +1,100 @@
+import type { TerminalNotification } from "../terminal-capabilities.js";
+/**
+ * Classification tier. `session` markers outrank the TERM fallback; `outerApp`
+ * hosts rank below it so a multiplexer nested inside them still wins.
+ */
+export type TerminalMultiplexerPrecedence = "session" | "outerApp";
+/**
+ * Notification delivery tier, tried in this order so the innermost target wins:
+ * a `pane` notifier addresses the exact pane through the multiplexer's CLI, a
+ * `surface` notifier addresses the containing app surface, and an `inBand`
+ * notifier rewrites the terminal's own notification sequence.
+ */
+export type TerminalMultiplexerNotificationTier = "pane" | "surface" | "inBand";
+/** One notification offered to a multiplexer notifier. */
+export interface TerminalMultiplexerNotificationRequest {
+    readonly message: string | TerminalNotification;
+    readonly env: NodeJS.ProcessEnv;
+    /** The host terminal's formatted OSC notification, or `null` when it notifies with a bare BEL. */
+    readonly sequence: string | null;
+    /** Write a sequence through the active terminal. */
+    write(data: string): void;
+}
+export interface TerminalMultiplexerNotifier {
+    readonly tier: TerminalMultiplexerNotificationTier;
+    /** Deliver the notification. `false` leaves it to the next notifier and then the terminal fallback. */
+    send(request: TerminalMultiplexerNotificationRequest): boolean;
+}
+/**
+ * OSC 8 handling inside a multiplexer session:
+ * - `render`: the multiplexer draws and opens links itself, so links work
+ *   whatever the outer terminal supports, unless another session with a
+ *   hyperlink policy sits in the path.
+ * - `drop`: never forwards OSC 8; its session anywhere in the path disables links.
+ * - `forward`: forwards OSC 8 once it self-reports (`TERM_PROGRAM`/`TERM_PROGRAM_VERSION`)
+ *   at least `major.minor`; older or unreported versions stay off.
+ */
+export type TerminalMultiplexerHyperlinks = "render" | "drop" | {
+    readonly forward: {
+        /** Lowercase `TERM_PROGRAM` the multiplexer sets inside its panes. */
+        readonly termProgram: string;
+        readonly major: number;
+        readonly minor: number;
+    };
+};
+/** A multiplexer that answers OSC 11 from a cached copy of the outer terminal's background color. */
+export interface TerminalMultiplexerBackgroundColorCache {
+    /** Wrap a query so it reaches the outer terminal and refreshes the cache. */
+    passthrough(query: string): string;
+    /** How long the multiplexer needs to store the outer reply before the cache is re-read. */
+    readonly settleMs: number;
+}
+/** Everything omp needs to recognize one terminal multiplexer and adapt to it. */
+export interface TerminalMultiplexerModule<Id extends string = string> {
+    readonly id: Id;
+    readonly precedence: TerminalMultiplexerPrecedence;
+    /** Every environment variable `isInside()` reads. */
+    readonly sessionEnvKeys: readonly string[];
+    /** Lowercase TERM prefix that identifies the multiplexer when its session markers were stripped. */
+    readonly termPrefix?: string;
+    /**
+     * Whether the multiplexer owns the screen grid. When true, rendering takes the
+     * multiplexer path (no scrollback rebuild, anchored resize, skipped probes).
+     */
+    readonly ownsScreenGrid: boolean;
+    isInside(env?: NodeJS.ProcessEnv): boolean;
+    /** Routes notifications the multiplexer would otherwise swallow. */
+    readonly notifier?: TerminalMultiplexerNotifier;
+    /** OSC 8 policy inside a session; unset defers to the outer terminal. */
+    readonly hyperlinks?: TerminalMultiplexerHyperlinks;
+    /**
+     * The pane's VTE honors DEC 2026 even when DECRQM is unanswered or reports
+     * the mode unrecognized (status 0): synchronized output starts on inside a
+     * session, and an unrecognized report does not turn it off.
+     */
+    readonly honorsSynchronizedOutput?: boolean;
+    /**
+     * The session does not reveal whether its client renders graphics while
+     * outer-terminal identity variables leak in, so images and Kitty
+     * placeholders stay off unless the user forces them.
+     */
+    readonly imagesRequireOverride?: boolean;
+    /** Platforms where the multiplexer breaks OSC 11 passthrough, so host appearance is used instead. */
+    readonly backgroundQueryBrokenOn?: readonly NodeJS.Platform[];
+    /** Present when OSC 11 replies come from a cache an explicit refresh must update first. */
+    readonly backgroundColorCache?: TerminalMultiplexerBackgroundColorCache;
+    /** Expands REP into identical styled cells, so destructive replays REP-encode their padding. */
+    readonly expandsRepPadding?: boolean;
+    /** Expires a synchronized update after a deadline, so large rebuild replays renew DEC 2026 as they stream. */
+    readonly expiresSynchronizedOutput?: boolean;
+    /**
+     * Restoring the alternate buffer schedules a redraw that ends a synchronized
+     * update early, so a synchronized resize rebuild stays on the main buffer.
+     */
+    readonly altRestoreEndsSynchronizedOutput?: boolean;
+    /**
+     * May grow its grid before SIGWINCH reaches the app, so a rebuild-mode grow
+     * whose full viewport no longer reaches the bottom replays history.
+     */
+    readonly growsBeforeSigwinch?: boolean;
+}

package/dist/types/multiplexers/wmux.d.ts

@@ -0,0 +1,12 @@
+/**
+ * wmux is a Windows multiplexer (Electron + xterm.js) modeled on cmux/herdr that
+ * repaints its pane in place. WMUX_CLI / WMUX_PIPE are CLI path overrides and can
+ * be set outside a wmux terminal.
+ */
+export declare const wmuxMultiplexer: {
+    readonly id: "wmux";
+    readonly precedence: "session";
+    readonly sessionEnvKeys: readonly ["WMUX", "WMUX_SURFACE_ID"];
+    readonly ownsScreenGrid: true;
+    readonly isInside: (env?: NodeJS.ProcessEnv) => boolean;
+};

package/dist/types/multiplexers/zellij.d.ts

@@ -0,0 +1,12 @@
+export declare const zellijMultiplexer: {
+    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 }: import("./types.js").TerminalMultiplexerNotificationRequest) => boolean;
+    };
+    readonly backgroundQueryBrokenOn: readonly ["darwin"];
+};

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

@@ -245,8 +245,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;
 /**