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

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## [Unreleased]
 
+## [18.4.3] - 2026-09-28
+
+### Changed
+
+- Reduced frame spikes and memory while long assistant replies retire into scrollback mid-stream: retiring rows no longer re-renders the whole published reply once per row, and the transcript no longer rescans the entire session history every frame ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
+- Reduced memory held by finished messages: streamed Markdown blocks release their streaming row caches, frozen lex tokens, and syntax-highlight streams when they finalize, and the Mermaid render cache is now size-bounded ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
+- Reduced per-frame CPU while streaming Markdown, edit previews (header facts are reused across frames; replace previews process only the visible lines), bash previews (highlighting is deferred to paint and the highlight cache is size-bounded), interleaved thinking blocks, and the live bash/ssh output tail ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
+- Changed git status refresh interval to 10 seconds and added generation tracking to avoid stale counts after HEAD moves
+
+### Fixed
+
+- Fixed streaming bash previews showing fields that follow the `env` object (e.g. `command`) as environment assignments ([#13650](https://github.com/can1357/oh-my-pi/pull/13650) by [@H4vC](https://github.com/H4vC)).
+- Fixed model picker latency by avoiding unnecessary catalog rebuilds
+- Fixed the `@` completion popup showing a `Searching…` placeholder while a refreshed file search is pending; the popup now stays hidden until results arrive, and Escape is no longer swallowed by it
+- Fixed multi-line IME and dictation input (for example, voice input in Ghostty or cmux) being sent as one message per line; it now lands in the prompt as a single multi-line draft, while Enter typed during a UI freeze still submits ([#13378](https://github.com/can1357/oh-my-pi/pull/13378) by [@goransh-walia](https://github.com/goransh-walia))
+
+### Removed
+
+- Removed the setup wizard's "Web search" tab; the providers scene is now sign-in only, and web search is chosen through the `web` model role like other kind roles.
+
+## [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

package/dist/types/chat/thinking-display.d.ts

@@ -1,4 +1,6 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+/** Drop every memo slot so the next call recomputes from scratch. Tests only. */
+export declare function resetThinkingDisplayCacheForTests(): void;
 export declare function canonicalizeMessage(text: string | null | undefined): string;
 /**
  * Thinking text prepared for display. Both modes drop empty `<!-- -->`

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

@@ -96,6 +96,16 @@ export declare class TranscriptContainer extends Container {
      * quit is pure write volume. An already offered replay batch stays valid.
      */
     cancelReplay(): void;
+    /**
+     * 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`.
      *
@@ -107,7 +117,11 @@ export declare class TranscriptContainer extends Container {
     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/components/editor.d.ts

@@ -278,5 +278,10 @@ export declare class Editor implements Component, Focusable {
      *  {@link getExpandedText}). Hosts that intercept large pastes through {@link onLargePaste} use
      *  this to re-insert a (possibly transformed) paste without re-triggering the interception hook. */
     insertPaste(content: string): void;
+    /**
+     * Whether an autocomplete popup is on screen. An `@` list narrowed to no match
+     * while its refresh is pending stays open internally but is hidden, so it does
+     * not claim keys (Escape, Vim mode switches) meant for the editor or app.
+     */
     isShowingAutocomplete(): boolean;
 }

package/dist/types/loop-watchdog.d.ts

@@ -45,5 +45,14 @@ export declare class LoopWatchdog {
     constructor(options?: LoopWatchdogOptions);
     start(): void;
     stop(): void;
+    /**
+     * Whether the loop is blocked right now — the armed tick is already more
+     * than `thresholdMs` overdue — or a detected block ended within the last
+     * `thresholdMs`. Input read at such a moment may be keystrokes the block
+     * batched into one read. Resolves both orders in which a resumed loop can
+     * run the late tick and the queued stdin read. A suspended-process gap is
+     * not a stall, and a stopped watchdog never reports one.
+     */
+    isStalled(): boolean;
 }
 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/model-picker.d.ts

@@ -19,7 +19,8 @@ export interface ResolvedRoleModel {
 }
 /** Catalog refresh capability used by the session picker. */
 export interface ModelPickerRegistry extends ModelBrowserRegistry {
-    refresh(strategy: "offline"): Promise<void>;
+    /** Bring the catalog up to date without rebuilding a current one; `true` when the picker must re-read it. */
+    refreshIfStale(): Promise<boolean>;
 }
 export interface ModelPickerCallbacks {
     /**

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

@@ -22,7 +22,8 @@
  * 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, A loads
- * earlier turns without changing selection, Esc cancels.
+ * 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";

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/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/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/setup/scenes/sign-in.d.ts

@@ -1,17 +1,15 @@
 import { type SgrMouseEvent } from "../../mouse.js";
-import type { SetupSceneHost, SetupTab } from "./types.js";
+import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
 /**
- * "Sign in" panel: lets the user authenticate one or more model providers via
- * OAuth. Unlike a standalone scene it never auto-advances the wizard — the user
- * may sign in to several providers and then continue with Esc.
+ * "Sign in" scene: lets the user authenticate one or more model providers via
+ * OAuth. It never auto-advances the wizard — the user may sign in to several
+ * providers and then continue with Esc.
  */
-export declare class SignInTab implements SetupTab {
+export declare class SignInScene implements SetupSceneController {
     #private;
-    readonly id = "sign-in";
-    readonly label = "Sign in";
+    readonly title = "Sign in to your providers";
+    get subtitle(): string;
     constructor(host: SetupSceneHost);
-    /** Modal while an OAuth flow is running so the scene won't switch tabs or finish. */
-    get modal(): boolean;
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
@@ -19,3 +17,5 @@ export declare class SignInTab implements SetupTab {
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
     render(width: number, maxLines?: number): readonly string[];
 }
+/** Onboarding scene for provider sign-in. */
+export declare const providersSetupScene: SetupScene;

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

@@ -5,7 +5,6 @@ import type { ComposerPreviewStatusSource } from "../../overlays/composer-shape-
 import type { ComposerShape } from "../../overlays/composer-shape-registry.js";
 import type { ModelBrowserSource } from "../../overlays/model-browser.js";
 import type { SymbolPreset } from "../../theme/theme.js";
-import type { SearchProviderId } from "../../tools/web-search.js";
 import type { Component, TUI } from "../../tui.js";
 /** Terminal capabilities used by setup overlays and the startup splash. */
 export interface SetupUiHost {
@@ -21,7 +20,6 @@ export interface SetupHost extends SetupUiHost {
     readonly composerShape: ComposerShape;
     readonly symbolPreset: SymbolPreset;
     readonly colorBlindMode: boolean;
-    readonly webSearchOrder: readonly string[];
     readonly disabledProviders: readonly string[];
     readonly authStorage: AuthStorage;
     readonly modelSource: ModelBrowserSource;
@@ -37,8 +35,6 @@ export interface SetupHost extends SetupUiHost {
     saveSymbolPreset(preset: SymbolPreset): void;
     saveColorBlindMode(enabled: boolean): void;
     saveTheme(mode: "dark" | "light", name: string): void;
-    isSearchProviderAvailable(id: SearchProviderId): Promise<boolean>;
-    saveSearchProvider(id: SearchProviderId | "auto"): void;
     captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
     copyToClipboard(text: string): Promise<void>;
     openInBrowser(url: string): void;
@@ -78,28 +74,6 @@ export interface SetupSceneController extends Component {
      */
     routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
-/**
- * A single panel inside a tabbed setup scene. The host scene owns the tab bar
- * and forwards rendering/input to the active tab.
- */
-export interface SetupTab {
-    readonly id: string;
-    readonly label: string;
-    /**
-     * While `true` the tab owns all keyboard input (e.g. an in-progress OAuth
-     * login). The parent scene MUST NOT switch tabs or finish while modal.
-     */
-    readonly modal: boolean;
-    /** See {@link SetupSceneController.render}: `maxLines` is the tab-local row budget. */
-    render(width: number, maxLines?: number): readonly string[];
-    handleInput(data: string): void;
-    invalidate(): void;
-    /** Called when the tab becomes active (including initial mount). */
-    onActivate?(): void;
-    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
-    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
-    dispose(): void;
-}
 /** Versioned onboarding scene definition. */
 export interface SetupScene {
     id: string;

package/dist/types/stdin-buffer.d.ts

@@ -63,14 +63,17 @@ export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     constructor(options?: StdinBufferOptions);
     process(data: string | Buffer): void;
     /**
-     * Enable or disable unbracketed raw-paste classification. Terminal disables
-     * it once DECRQM confirms bracketed-paste (mode 2004) support: a genuine
-     * paste then always arrives wrapped, so the heuristic can only misfire on
-     * keystrokes an event-loop stall batched into one read (issue #12540).
-     * Disabling flushes any candidate already held by the classification window
-     * as ordinary key events so no buffered input is lost.
+     * Gate unbracketed raw-paste classification on event-loop responsiveness.
+     * Terminal installs a probe once DECRQM confirms bracketed-paste (mode
+     * 2004) support: a genuine paste then always arrives wrapped, so an
+     * unmarked multiline burst is either an input-method commit — IME,
+     * dictation, and emoji commits are typed input, never bracketed (#13344) —
+     * or keystrokes an event-loop stall batched into one read (#12540). A burst
+     * classified while `stalled()` reports a stall is replayed as the original
+     * keys so every Enter submits; otherwise it is delivered as one paste.
+     * `undefined` restores unconditional classification.
      */
-    setRawPasteClassification(enabled: boolean): void;
+    setRawPasteStallProbe(stalled: (() => boolean) | undefined): void;
     flush(): string[];
     clear(): void;
     getBuffer(): string;

package/dist/types/terminal.d.ts

@@ -96,6 +96,15 @@ export interface TerminalStartOptions {
      * echoes even while module loading blocks the event loop.
      */
     deferInput?: boolean;
+    /**
+     * Reports whether the event loop is stalled or just recovered from a
+     * stall. Once the terminal confirms bracketed paste, an unmarked multiline
+     * burst is an input-method commit (IME, dictation) delivered as one paste
+     * on a responsive loop, but keystrokes a stall batched into one read —
+     * replayed as keys so Enter submits — while this returns true. Without a
+     * probe every such burst is treated as an input-method commit.
+     */
+    isLoopStalled?: () => boolean;
 }
 /** Identity of an accepted explicit terminal appearance refresh request. */
 export type TerminalAppearanceRequestToken = number;
@@ -276,6 +285,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;

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

@@ -49,7 +49,7 @@ export declare class Theme {
      * Theme-derived inputs for `getSessionAccentHex`: the accent hex whose
      * OKLCH weight session accents adopt, the major colors they must not
      * hue-collide with, and the light-theme surface luminance to contrast
-     * against.
+     * against. Built once per instance and frozen; callers share the object.
      */
     get sessionAccentInputs(): SessionAccentTheme;
     fg(color: ThemeColor, text: string): string;

package/dist/types/tools/web-search-types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Web search response types shared by the coding agent's search providers and
+ * the transcript renderer in {@link ./web-search}. Render-free, so provider code
+ * can import it without loading UI components.
+ */
+/**
+ * Display label for every search implementation: `web/*` engines and the
+ * chat-model groundings. Keys are the ids providers report in
+ * {@link SearchResponse.provider} and search errors.
+ */
+export declare const SEARCH_PROVIDER_LABELS: {
+    readonly parallel: "Parallel";
+    readonly perplexity: "Perplexity";
+    readonly gemini: "Gemini";
+    readonly anthropic: "Anthropic";
+    readonly codex: "OpenAI Codex";
+    readonly openai: "OpenAI API";
+    readonly xai: "xAI";
+    readonly openrouter: "OpenRouter";
+    readonly zai: "Z.AI";
+    readonly exa: "Exa";
+    readonly tinyfish: "TinyFish";
+    readonly jina: "Jina";
+    readonly kagi: "Kagi";
+    readonly tavily: "Tavily";
+    readonly firecrawl: "Firecrawl";
+    readonly brave: "Brave";
+    readonly kimi: "Kimi";
+    readonly synthetic: "Synthetic";
+    readonly ollama: "Ollama";
+    readonly searxng: "SearXNG";
+    readonly startpage: "Startpage";
+    readonly duckduckgo: "DuckDuckGo";
+    readonly ecosia: "Ecosia";
+    readonly google: "Google";
+    readonly mojeek: "Mojeek";
+    readonly public: "Public Web";
+};
+/** Id of a search implementation; see {@link SEARCH_PROVIDER_LABELS}. */
+export type SearchProviderId = keyof typeof SEARCH_PROVIDER_LABELS;
+/** Label for a provider id; ids from older transcripts fall back to the raw id. */
+export declare function getSearchProviderLabel(id: SearchProviderId): string;
+/** Source returned by search (all providers) */
+export interface SearchSource {
+    title: string;
+    url: string;
+    snippet?: string;
+    /** ISO date string or relative ("2d ago") */
+    publishedDate?: string;
+    /** Age in seconds for consistent formatting */
+    ageSeconds?: number;
+    author?: string;
+}
+/** Citation with text reference (LLM-mediated providers) */
+export interface SearchCitation {
+    url: string;
+    title: string;
+    citedText?: string;
+}
+/** Usage metrics */
+export interface SearchUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Anthropic: number of web search requests made */
+    searchRequests?: number;
+    /** Perplexity: combined token count */
+    totalTokens?: number;
+}
+/** Unified response across providers */
+export interface SearchResponse {
+    provider: SearchProviderId | "none";
+    /** Synthesized answer text (LLM-mediated providers) */
+    answer?: string;
+    /** Search result sources */
+    sources: SearchSource[];
+    /** Text citations with context */
+    citations?: SearchCitation[];
+    /** Intermediate search queries (anthropic) */
+    searchQueries?: string[];
+    /** Follow-up question suggestions (provider-dependent) */
+    relatedQuestions?: string[];
+    /** Token usage metrics */
+    usage?: SearchUsage;
+    /** Model used */
+    model?: string;
+    /** Request ID for debugging */
+    requestId?: string;
+    /** Authentication mode used by the provider (e.g. oauth, api-key) */
+    authMode?: string;
+}