@oh-my-pi/pi-tui 18.2.11 → 18.3.1

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 ## [Unreleased]
 
+## [18.3.1] - 2026-09-25
+
+### Breaking Changes
+
+- Replaced the `CustomEditor` space-hold callbacks and `sttHoldEnabled` option with the `spaceHold.handler` API.
+- Removed `Editor.cursorOverrideWidth`; widths for `cursorOverride` glyphs are now measured automatically.
+
+### Added
+
+- Added push-to-talk dictation to `Input`, with live transcription and `cursorOverride` support.
+- Added visual indicators for live-steered user messages and paginated content in read-tool results.
+- Added transcript support for `cfg://` configuration read and write tool calls.
+- Added an Anthropic slow-mode badge to the status-line model segment, showing the priority state, end time, and remaining request percentage when available.
+
+### Changed
+
+- Updated the settings selector so clearing an input field fully unsets the corresponding setting.
+
+### Fixed
+
+- Fixed dimmed blockquote styling after inline code spans.
+- Fixed rendering of tool calls and results for top-level extension and MCP tools invoked through `xd://` links.
+- Fixed file links in pending Read and Write cards so they open the correct local targets, including paths in the home directory, archives, and databases.
+
+## [18.3.0] - 2026-09-24
+
+### Added
+
+- Added proc:// and agent:// URI support for interacting with processes and agents.
+- Added support for xd:// documentation topic URLs.
+- Added rendering for background job state and peer-to-peer messages from the wait tool.
+- Added supervised bash service rendering with status, readiness, and output information.
+- Added a fullscreen annotation overlay for diffs and text, including multi-line notes, editing, deletion, and undo ([#12601](https://github.com/can1357/oh-my-pi/pull/12601) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Added Daybreak-enabled account listings to the usage dashboard.
+
+### Changed
+
+- Mermaid flowcharts and state diagrams now automatically choose a layout that best fits the available terminal width and reflow when the terminal is resized.
+- Plan Review annotations now support multi-line editing, deletion, and undo ([#12601](https://github.com/can1357/oh-my-pi/pull/12601) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+
+### Fixed
+
+- Fixed AltGr characters, including `[`, `]`, `{`, and `}`, being dropped in Windows Terminal when using the kitty keyboard protocol on Hungarian and other international keyboard layouts ([#12984](https://github.com/can1357/oh-my-pi/pull/12984) by [@H4vC](https://github.com/H4vC)).
+
 ## [18.2.11] - 2026-09-23
 
 ### Added

package/THIRD-PARTY-NOTICES.txt

@@ -78,8 +78,8 @@ below.
 uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
-b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cut,
-date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
+b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
 printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
 truncate, uname, uniq, wc, whoami, yes.
 
@@ -293,7 +293,7 @@ MIT License
 Copyright (c) 2026 Sander Land
   (measured tokenizer vocabulary data, reconstruction model, and reference
   implementation: https://github.com/sanderland/ctok)
-Copyright (c) 2026 Can Bölük and the Oh My Pi contributors
+Copyright (c) 2026 Can Bölük and the omp contributors
 Copyright (c) 2026 Stencil Labs, Inc.
   (Rust implementation and the compact binary vocabulary encoding in
   crates/pi-natives/src/utok/claude)

package/dist/types/apps/ps-data.d.ts

@@ -1,4 +1,4 @@
-import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/hub.js";
+import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/daemon.js";
 /** One broker scope: a project runtime dir or a machine-global service dir. */
 export interface PsScope {
     kind: "project" | "global";

package/dist/types/apps/ps-top.d.ts

@@ -1,5 +1,5 @@
 import { type Component, TUI } from "../tui.js";
-import type { DaemonSnapshot, DaemonSpec } from "../tools/hub.js";
+import type { DaemonSnapshot, DaemonSpec } from "../tools/daemon.js";
 import { type PsScope, type PsScopeReport, type PsTarget } from "./ps-data.js";
 /** Options accepted by the interactive monitor: scope selection from the list flags. */
 export interface PsTopOptions extends PsTarget {

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

@@ -5,7 +5,7 @@
  * viewer ({@link AgentTranscriptViewer}) to render a parked subagent / advisor /
  * collab-guest transcript that has no live session.
  *
- * Unlike the old incremental hub sync, {@link ChatTranscriptBuilder.rebuild}
+ * Unlike incremental transcript sync, {@link ChatTranscriptBuilder.rebuild}
  * always discards prior components and rebuilds the whole transcript from the
  * supplied entries. Re-rendering a growing transcript is therefore O(n) in the
  * entry count, but it cannot duplicate or misorder rows the way incremental

package/dist/types/chat/read-tool-group.d.ts

@@ -7,9 +7,9 @@ export declare function readArgsHaveTarget(args: unknown): boolean;
 /**
  * Whether a read collapses into the compact {@link ReadToolGroupComponent}
  * rather than a full tool execution. Filesystem/external targets always
- * collapse; other internal URLs (`skill://`, `agent://`, …) render full so
- * their resolved content is visible. `xd://` device reads are the exception —
- * they list devices/docs and read better in the compact grouped view.
+ * collapse; registered internal-URL schemes render full so their resolved
+ * content is visible, unless their spec declares `compactTranscript`
+ * (device listings/docs read better in the compact grouped view).
  */
 export declare function readArgsCollapseIntoGroup(args: unknown): boolean;
 /**

package/dist/types/chat/user-message.d.ts

@@ -6,6 +6,8 @@ export interface UserBubbleOptions {
     imageLinks?: readonly (string | undefined)[];
     /** Agent-attributed input: dim, flat prose. */
     synthetic?: boolean;
+    /** Delivered into the response that was streaming; marked `*` at the bubble's top-left. */
+    liveSteered?: boolean;
     /** SKILL.md path for a skill chip by name; `undefined` leaves the chip unlinked. */
     skillPath?: (name: string) => string | undefined;
 }
@@ -19,7 +21,8 @@ export interface UserBubbleOptions {
 export declare function userBubbleColor(options?: UserBubbleOptions, tokenRegex?: RegExp): (value: string) => string;
 /**
  * Component that renders a user message. Accepts an agent reaction badge
- * (see {@link ReactionTarget}) drawn right-aligned in the bubble's top padding row.
+ * (see {@link ReactionTarget}) drawn right-aligned in the bubble's top padding row;
+ * a live-steered message carries a `*` marker left-aligned in the same row.
  */
 export declare class UserMessageComponent extends Container implements ReactionTarget {
     #private;

package/dist/types/components/editor.d.ts

@@ -69,8 +69,6 @@ export declare class Editor implements Component, Focusable {
     focused: boolean;
     /** When set, replaces the normal cursor glyph at end-of-text with this ANSI-styled string. */
     cursorOverride: string | undefined;
-    /** Display width of the cursorOverride glyph (needed because override may contain ANSI escapes). */
-    cursorOverrideWidth: number | undefined;
     /** Optional hook that decorates displayed user text after source-text layout.
      *  Width-changing output is allowed on lines without the cursor; it is truncated
      *  to the content width rather than reflowed. Cursor glyphs and inline hints are excluded. */

package/dist/types/components/input.d.ts

@@ -1,3 +1,4 @@
+import { SpaceHoldGesture } from "../space-hold.js";
 import { type Component, type Focusable } from "../tui.js";
 /**
  * Input component - single-line text input with horizontal scrolling
@@ -10,6 +11,10 @@ export declare class Input implements Component, Focusable {
     mask: boolean;
     onSubmit?: (value: string) => void;
     onEscape?: () => void;
+    /** Space-bar push-to-talk; set its `handler` to enable it. */
+    readonly spaceHold: SpaceHoldGesture;
+    /** When set, replaces the cursor glyph at end-of-text with this ANSI-styled string. */
+    cursorOverride: string | undefined;
     /** Focusable interface - set by TUI when focus changes */
     focused: boolean;
     getValue(): string;
@@ -22,6 +27,17 @@ export declare class Input implements Component, Focusable {
     /** Apply terminal paste semantics to text from non-bracketed paste transports
      *  (e.g. kitty's OSC 5522 enhanced clipboard read). Mirrors `Editor.pasteText`. */
     pasteText(text: string): void;
+    /** Programmatically trigger submission (e.g. for voice submit). */
+    submit(): void;
+    /** Delete up to `count` characters immediately before the cursor. */
+    deleteBeforeCursor(count: number): void;
+    /** Show or replace a volatile speech-to-text preview at the cursor, outside undo history.
+     *  Finalize it with {@link commitVolatileText} or drop it with {@link clearVolatileText}. */
+    setVolatileText(text: string): void;
+    /** Remove the current volatile preview without committing it. */
+    clearVolatileText(): void;
+    /** Drop any volatile preview, then insert `text` as a single undoable edit. */
+    commitVolatileText(text: string): void;
     invalidate(): void;
     render(width: number): readonly string[];
 }

package/dist/types/overlays/annotation-overlay.d.ts

@@ -0,0 +1,30 @@
+import { type Component, type TUI } from "../index.js";
+import { type KeybindingsManager } from "../app-keybindings.js";
+import { type Theme } from "../theme/theme.js";
+import type { CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
+export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
+export declare const PASTE_CODE_REVIEW_ACTION = "Paste annotations into prompt";
+export interface AnnotationOverlayCallbacks {
+    onComplete(result: CodeReviewOverlayResult | TextReviewOverlayResult | undefined): void;
+    onWarning?(message: string): void;
+    /** Open the draft in the host's editor and invoke `commit` with its result. */
+    onAnnotationExternalEditor?(draft: string, commit: (text: string | null) => void): void | Promise<void>;
+}
+export interface CodeReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
+    onComplete(result: CodeReviewOverlayResult | undefined): void;
+}
+export interface TextReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
+    onComplete(result: TextReviewOverlayResult | undefined): void;
+}
+/** A fullscreen, annotated diff picker that only relies on public OMP APIs. */
+export declare class AnnotationOverlay implements Component {
+    #private;
+    constructor(tui: TUI, theme: Theme, keybindings: KeybindingsManager, files: readonly ReviewDiffFile[], mode: string, callbacks: CodeReviewOverlayCallbacks);
+    constructor(tui: TUI, theme: Theme, keybindings: KeybindingsManager, source: TextReviewSource, callbacks: TextReviewOverlayCallbacks);
+    invalidate(): void;
+    dispose(): void;
+    getAnnotations(): CodeReviewAnnotation[];
+    getTextAnnotations(): TextReviewAnnotation[];
+    handleInput(data: string): void;
+    render(width: number): readonly string[];
+}

package/dist/types/overlays/annotation-types.d.ts

@@ -0,0 +1,84 @@
+export type ReviewSourceRowKind = "context" | "added" | "removed";
+export interface ReviewSourceRow {
+    kind: ReviewSourceRowKind;
+    raw: string;
+    content: string;
+    oldLine?: number;
+    newLine?: number;
+    hunkHeader: string;
+}
+export type ReviewDiffRow = ReviewSourceRow | {
+    kind: "hunk";
+    raw: string;
+    hunkHeader: string;
+} | {
+    kind: "no-newline";
+    raw: string;
+    hunkHeader: string;
+};
+export interface ReviewDiffFile {
+    path: string;
+    oldPath?: string;
+    newPath?: string;
+    occurrence: number;
+    rawDiff: string;
+    rows: ReviewDiffRow[];
+    linesAdded: number;
+    linesRemoved: number;
+    isBinary: boolean;
+}
+export interface CodeReviewAnnotationBase {
+    path: string;
+    oldPath?: string;
+    newPath?: string;
+    occurrence: number;
+    note: string;
+}
+export type CodeReviewAnnotation = (CodeReviewAnnotationBase & {
+    scope: "file";
+}) | (CodeReviewAnnotationBase & {
+    scope: "line";
+    hunkHeader: string;
+    oldLine?: number;
+    newLine?: number;
+    rawLine: string;
+});
+export interface CodeReviewOverlayResult {
+    action: "review" | "paste";
+    annotations: CodeReviewAnnotation[];
+}
+export type TextReviewSourceProvenance = {
+    kind: "latest-assistant";
+    entryId: string;
+} | {
+    kind: "session";
+    entryId: string;
+} | {
+    kind: "file";
+    path: string;
+} | {
+    kind: "prompt";
+};
+export interface TextReviewSource {
+    /** Identifies the source within this annotation run. */
+    id: string;
+    kind: "message" | "code" | "quote" | "command" | "file" | "prompt";
+    label: string;
+    text: string;
+    /** Identifies the active session entry that supplied this source, when applicable. */
+    provenance?: TextReviewSourceProvenance;
+    sessionId?: string;
+}
+export type TextReviewAnnotation = {
+    scope: "text";
+    note: string;
+} | {
+    scope: "line";
+    line: number;
+    quote: string;
+    note: string;
+};
+export interface TextReviewOverlayResult {
+    action: "paste";
+    annotations: TextReviewAnnotation[];
+}

package/dist/types/overlays/btw-history-panel.d.ts

@@ -1,5 +1,6 @@
-import { type Component, type Focusable } from "../index.js";
+import { type Component, type Focusable, Input } from "../index.js";
 import { type BtwHistoryRecord } from "./btw-history.js";
+import type { SpaceHoldHandler } from "../space-hold.js";
 interface BtwHistoryPanelOptions {
     records: readonly BtwHistoryRecord[];
     onClose: () => void;
@@ -7,6 +8,8 @@ interface BtwHistoryPanelOptions {
     onCancel: (record: BtwHistoryRecord) => void;
     canFollowUp?: (record: BtwHistoryRecord) => boolean;
     onFollowUp?: (record: BtwHistoryRecord, question: string, signal: AbortSignal) => Promise<boolean>;
+    /** Space-bar push-to-talk for a follow-up composer: dictates into `input` while Space is held. */
+    spaceHold?: (input: Input) => SpaceHoldHandler;
     requestRender: () => void;
     getHeight: () => number;
 }

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

@@ -29,12 +29,40 @@ export interface CopySelectorDeps {
     proseOnlyThinking?: () => boolean;
     linkTargets?: ReadonlyMap<string, string>;
     requestRender: () => void;
-    /** The outlined content was chosen — copy it. `label` feeds the status line. */
-    onPick: (content: string, label: string) => void;
+    /** Replaces the "Copy" header when the picker is reused for another purpose. */
+    title?: string;
+    /** Verb shown for the pick action in hints and block controls (default "copy"). */
+    actionLabel?: string;
+    /**
+     * The outlined content was chosen — copy it. `label` feeds the status line;
+     * `source` names the transcript entry (and inner block, when descended) it came from.
+     */
+    onPick: (content: string, label: string, source: CopyPickSource) => void;
     /** `o` on a link block — open `href` with the system opener. Absent: `o` is ignored. */
     onOpen?: (href: string, label: string) => void;
     onCancel: () => void;
 }
+/** Where picked content came from in the transcript. */
+export interface CopyPickSource {
+    entry: TranscriptEntry;
+    /** The inner block, when the pick happened in the descended block view. */
+    block?: CopyBlock;
+}
+/** One copyable inner block of a transcript turn. */
+export interface CopyBlock {
+    /** Short kind label ("code · ts", "bash command", "read result", …). */
+    label: string;
+    /** Exact text placed on the clipboard. */
+    content: string;
+    /** Transcript entry that produced this block. */
+    entry: TranscriptEntry;
+    /** Markdown code/quote block, or a bash/eval tool-call command. */
+    kind?: "code" | "quote" | "command";
+    /** Highlight language for the block preview. */
+    language?: string;
+    /** Set for link blocks: the URL `o` opens. `content` is the same URL. */
+    href?: string;
+}
 export declare class CopySelectorComponent implements Component {
     #private;
     private readonly deps;

package/dist/types/overlays/copy-targets.d.ts

@@ -61,3 +61,5 @@ export declare function extractLastLink(messages: readonly AgentMessage[]): Link
 export declare function commandFromToolCall(tc: ToolCall): LastCommand | undefined;
 /** Walk the transcript backwards for the most recent bash command or eval code. */
 export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
+/** Concatenated visible text of an assistant message, verbatim; undefined when blank. */
+export declare function assistantText(msg: AgentMessage): string | undefined;

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

@@ -1,4 +1,4 @@
-import type { Model } from "@oh-my-pi/pi-ai";
+import type { KeysApi, Model } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "../tui.js";
 import type { ModelBrowserSource, ModelBrowserRegistry } from "./model-browser.js";
 import { type ConfiguredThinkingLevel } from "../thinking.js";
@@ -15,7 +15,7 @@ export interface ModelHubSource extends ModelBrowserSource {
 /** Catalog capabilities required by the model hub. */
 export interface ModelHubRegistry extends ModelBrowserRegistry {
     readonly authStorage: {
-        hasAuth(provider: string): boolean;
+        readonly keys: Pick<KeysApi, "source">;
     };
     getDiscoverableProviders(): string[];
     getProviderDiscoveryState(provider: string): {

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

@@ -1,13 +1,10 @@
+import type { CredentialsApi, KeysApi } from "@oh-my-pi/pi-ai";
 import { type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
 /** Credential presence and provenance needed by the provider picker. */
 export interface OAuthSelectorAuthSource {
-    has(providerId: string): boolean;
-    hasAuth(providerId: string): boolean;
-    getCredentialOrigin(providerId: string): {
-        kind: "runtime" | "config" | "oauth" | "api_key" | "env" | "fallback";
-        envVar?: string;
-    } | undefined;
+    readonly credentials: Pick<CredentialsApi, "has">;
+    readonly keys: Pick<KeysApi, "source">;
 }
 /**
  * Component that renders an OAuth provider selector.

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

@@ -57,6 +57,11 @@ export interface SettingsHost {
     entries: readonly SettingsDisplayEntry[];
     get(path: string): unknown;
     set(path: string, value: unknown): void;
+    /**
+     * Removes the value from the global config: a project or other layer, or an environment
+     * variable, that configures the setting still applies; otherwise the default does.
+     */
+    unset(path: string): void;
     normalizeProviderLimits(value: unknown): Record<string, number>;
     validateProviderLimits(value: unknown): Record<string, number>;
 }

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

@@ -38,6 +38,8 @@ export interface ProviderCard {
         soonestExpiryMs?: number;
         unavailableReasons: string[];
     };
+    /** Labels of accounts with verified Daybreak access. */
+    daybreakAccounts?: string[];
 }
 /**
  * Collapse usage reports into one compact card per provider: limits grouped by

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

@@ -56,6 +56,17 @@ export interface ComposerOptions {
     readonly exit?: (code: number) => void;
     readonly now?: () => number;
 }
+/** How {@link Composer.setRuntimeChildren} bills below-transcript roots against transcript retirement. */
+export interface RuntimeChildrenOptions {
+    /**
+     * Below-transcript roots whose growth is momentary (inline dialogs, a tall
+     * multi-line editor). They are billed at their smallest height so expansion
+     * clips the live tail instead of retiring rows a later shrink could not
+     * reclaim (#11007). Every other root is billed at its current height, so
+     * settled rows it displaces retire to native scrollback.
+     */
+    readonly transient?: readonly Component[];
+}
 /** Controls the first terminal paint for a composer that does not already own the terminal. */
 export interface ComposerStartOptions {
     readonly clearScrollback?: boolean;
@@ -149,7 +160,7 @@ export declare class Composer implements TerminalFrameProvider {
      */
     setStatusComponent(component: Component): void;
     /** Mount or replace session-aware root children while preserving the header and status hosts. */
-    setRuntimeChildren(children: readonly Component[]): void;
+    setRuntimeChildren(children: readonly Component[], options?: RuntimeChildrenOptions): void;
     /** Play or replay the welcome intro against the stable header render target. */
     playWelcomeIntro(): void;
     /** Transfer terminal ownership to InteractiveMode without stopping the composer. */

package/dist/types/prompt/custom-editor.d.ts

@@ -1,27 +1,11 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { Editor, type EditorTextDecorationContext } from "../components/editor.js";
 import { type KeyId } from "../keys.js";
+import { SpaceHoldGesture } from "../space-hold.js";
 import { TUI } from "../tui.js";
 import type { AppKeybinding } from "../app-keybindings.js";
 import { type SpellingFeatures } from "./macos-spelling.js";
 type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
-/** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
- *  deliberate press. OS auto-repeat is fast; a deliberate tap (even a fast one) is slower. */
-export declare const SPACE_REPEAT_MAX_GAP_MS = 120;
-/** Two consecutive inter-space gaps are "mechanical" (machine-driven auto-repeat) when both are
- *  within {@link SPACE_REPEAT_MAX_GAP_MS} and differ by no more than this — an absolute jitter floor
- *  or, for slower repeat rates, {@link SPACE_REPEAT_JITTER_RATIO} of the smaller gap. OS key-repeat
- *  is metronomic; a human smashing the bar is fast but irregular, so its deltas never stay this
- *  steady. */
-export declare const SPACE_REPEAT_JITTER_MS = 18;
-export declare const SPACE_REPEAT_JITTER_RATIO = 0.35;
-/** Consecutive mechanical (fast + steady) deltas that confirm the space bar is held and start
- *  recording. Needs a sustained metronomic cadence, so jittery smashing and deliberate taps never
- *  reach it. */
-export declare const SPACE_HOLD_MECHANICAL_RUN = 2;
-/** Idle gap (ms) after the last repeated space that counts as the space bar being released, ending
- *  the push-to-talk recording. Must comfortably exceed the OS key-repeat interval. */
-export declare const SPACE_HOLD_RELEASE_MS = 250;
 /**
  * Extract image-or-other file paths from plain (un-bracketed) clipboard text.
  * Mirrors {@link extractBracketedPastePaths} for terminals/handlers that
@@ -224,15 +208,10 @@ export declare class CustomEditor extends Editor {
     onCapsLock?: () => void;
     /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
     onLeftAtStart?: () => void;
-    /** Fired when a sustained space-bar hold is recognized — the push-to-talk STT start. The
-     *  optimistically-typed spaces have already been deleted by the time this runs. */
-    onSpaceHoldStart?: () => void;
-    /** Fired when the held space bar is released (detected as an idle gap with no further repeated
-     *  spaces) — the push-to-talk STT stop. */
-    onSpaceHoldEnd?: () => void;
-    /** Gate for the space-hold gesture. Returns false to keep the space bar inserting spaces
-     *  normally; wired to `stt.enabled` so disabling STT restores plain space behavior. */
-    sttHoldEnabled?: () => boolean;
+    /** Space-bar push-to-talk; set its `handler` to enable it. It is a text-composition gesture, so it
+     *  stays out of Vim's Normal/Visual modes (where the space bar is the `l` motion) and away from an
+     *  open autocomplete menu. */
+    readonly spaceHold: SpaceHoldGesture;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.

package/dist/types/prompt/image-source.d.ts

@@ -1,16 +1,17 @@
 /**
- * Original filesystem source carried on image attachments that entered from a
- * file on disk: path-pasted/drag-and-dropped images and generated video
- * contact-sheet previews. Symbol metadata stays out of serialized/model-bound
- * image data while traveling with the draft object, until AgentSession creates
- * the hidden companion message that tells the model the path (and link
- * materialization prefers it over a blob copy).
+ * File source carried on image attachments backed by a file on disk:
+ * path-pasted/drag-and-dropped images, clipboard images the coding agent commits
+ * to the session's `local://` root, and generated video contact-sheet previews.
+ * Symbol metadata stays out of serialized/model-bound image data while traveling
+ * with the draft object, until AgentSession creates the hidden companion message
+ * that tells the model the path (and link materialization prefers it over a blob copy).
  */
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 /** How an image attachment's backing file entered the session. */
 export type ImageAttachmentSourceKind = "image" | "video";
-/** Original local file backing an image attachment. */
+/** Local file backing an image attachment. */
 export interface ImageAttachmentSource {
+    /** Absolute filesystem path, or a session-relative `local://` URL for images committed to the session. */
     readonly path: string;
     readonly kind: ImageAttachmentSourceKind;
 }
@@ -21,6 +22,6 @@ export type SourceTaggedImage = ImageContent & {
 };
 /** Create a model-ready image tagged with the local file it was loaded from. */
 export declare function tagImageAttachmentSource(image: ImageContent, path: string, kind: ImageAttachmentSourceKind): SourceTaggedImage;
-/** Return the original local source of an image attachment, or undefined for payloads with no source file (clipboard bitmaps). */
+/** Return the local file backing an image attachment, or undefined for payloads with no file on disk. */
 export declare function imageAttachmentSource(image: ImageContent): ImageAttachmentSource | undefined;
 export {};

package/dist/types/space-hold.d.ts

@@ -0,0 +1,45 @@
+/** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
+ *  deliberate press. OS auto-repeat is fast; a deliberate tap (even a fast one) is slower. */
+export declare const SPACE_REPEAT_MAX_GAP_MS = 120;
+/** Two consecutive inter-space gaps are "mechanical" (machine-driven auto-repeat) when both are
+ *  within {@link SPACE_REPEAT_MAX_GAP_MS} and differ by no more than this — an absolute jitter floor
+ *  or, for slower repeat rates, {@link SPACE_REPEAT_JITTER_RATIO} of the smaller gap. OS key-repeat
+ *  is metronomic; a human smashing the bar is fast but irregular, so its deltas never stay this
+ *  steady. */
+export declare const SPACE_REPEAT_JITTER_MS = 18;
+export declare const SPACE_REPEAT_JITTER_RATIO = 0.35;
+/** Consecutive mechanical (fast + steady) deltas that confirm the space bar is held and start
+ *  recording. Needs a sustained metronomic cadence, so jittery smashing and deliberate taps never
+ *  reach it. */
+export declare const SPACE_HOLD_MECHANICAL_RUN = 2;
+/** Idle gap (ms) after the last repeated space that counts as the space bar being released, ending
+ *  the push-to-talk recording. Must comfortably exceed the OS key-repeat interval. */
+export declare const SPACE_HOLD_RELEASE_MS = 250;
+/** What a recognized space-bar hold drives — the push-to-talk start and stop. */
+export interface SpaceHoldHandler {
+    /** Gate for the gesture. Returns false to keep the space bar inserting spaces normally, so
+     *  disabling push-to-talk restores plain space behavior. */
+    enabled(): boolean;
+    /** A sustained hold was recognized. The optimistically-typed spaces have already been deleted. */
+    onStart(): void;
+    /** The held space bar was released (an idle gap with no further repeated spaces, or any other key). */
+    onEnd(): void;
+}
+/** What the host must do with a keypress after {@link SpaceHoldGesture.process} has seen it:
+ *  `"pass"` — handle it normally; `"type"` — insert the space now (it is tracked back out if the run
+ *  turns into a hold); `"swallow"` — drop it, the gesture consumed it. */
+export type SpaceHoldStep = "pass" | "type" | "swallow";
+/** Space-hold push-to-talk state machine. A held space bar emits OS auto-repeat: a *steady* stream
+ *  of spaces at a fixed fast interval. We watch the inter-space deltas and only recognize a hold once
+ *  {@link SPACE_HOLD_MECHANICAL_RUN} consecutive deltas are "mechanical" — both auto-repeat-fast and
+ *  near-identical (see {@link gapsAreMechanical}). Smashing the bar is fast but jittery and deliberate
+ *  taps are too slow, so neither escalates and both keep typing real spaces; the few spaces typed
+ *  before a real hold is recognized are tracked back out of the host input. */
+export declare class SpaceHoldGesture {
+    #private;
+    /** Unset (the default) keeps the space bar typing spaces. */
+    handler: SpaceHoldHandler | undefined;
+    constructor(deleteTyped: (count: number) => void, allowed?: () => boolean);
+    /** Feed one keypress, `isSpace` when it is a plain space bar press. */
+    process(isSpace: boolean): SpaceHoldStep;
+}

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

@@ -7,7 +7,7 @@ interface ContextSkill {
     readonly description?: string;
     readonly hide?: boolean;
 }
-type ContextTool = Pick<AiTool, "name" | "description" | "parameters">;
+type ContextTool = Pick<AiTool, "name" | "description" | "parameters" | "examples">;
 /** Savings computed by the host's inline-image planner, not by the renderer. */
 export interface ContextSavingsEstimate {
     visionCapable: boolean;
@@ -100,6 +100,8 @@ export interface NonMessageTokenSource {
         };
     };
     readonly skills?: readonly ContextSkill[];
+    /** Provider-facing, session-frozen descriptions when available. */
+    readonly renderedSkills?: readonly ContextSkill[];
 }
 /** Shared empty system-prompt part list, avoiding an allocation per render. */
 export declare const EMPTY_STRING_PARTS: string[];

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

@@ -63,6 +63,8 @@ export interface StatusLineSession {
     } | undefined;
     autoResolvedThinkingLevel(): string | undefined;
     isFastModeActive(): boolean;
+    /** Anthropic subscription slow-mode label (`low priority until 14:30 · 62% left`) while active. */
+    getAnthropicSlowModeLabel?(): string | undefined;
     getPrewalkState?(): unknown;
     getAsyncJobSnapshot(): {
         running: readonly {

package/dist/types/theme/mermaid-cache.d.ts

@@ -6,12 +6,10 @@ import type { MermaidRenderOptions } from "@oh-my-pi/pi-natives";
  */
 export interface MermaidResolveOptions extends MermaidRenderOptions {
     /**
-     * Maximum display width (terminal columns) the diagram should occupy. A
-     * layout that overflows this width is re-rendered in the perpendicular
-     * orientation — a wide horizontal chain collapses to a tall vertical column
-     * (which the terminal can scroll), and a wide vertical fan-out collapses to a
-     * tall horizontal column. Omit to keep the source's own layout regardless of
-     * width.
+     * Maximum display width (terminal columns) the diagram should occupy.
+     * Flowcharts are also rendered top-down and left-to-right. A resize picks
+     * the shortest variant that fits; if none fit, the narrowest, which the
+     * caller may still clip. Omit to keep the source's own layout.
      */
     maxWidth?: number;
 }

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

@@ -19,6 +19,13 @@ export interface BashToolDetails {
     timedOut?: boolean;
     /** Live ACP update only; completed results refer to released terminals. */
     terminalId?: string;
+    service?: {
+        name: string;
+        state: string;
+        ready: boolean;
+        timedOut: boolean;
+        pid?: number;
+    };
     async?: {
         state: "running" | "completed" | "failed";
         jobId: string;