@linxiraos/pi-tui 1.1.26 → 1.1.27

package/CHANGELOG.md

@@ -2,9 +2,11 @@
 
 ## [Unreleased]
 
-## [1.1.26] - 2026-10-03
+## [1.1.27] - 2026-10-07
 
-- 版本线推进至 1.1.26；本版无独立用户可见变化。
+- 版本线推进至 1.1.27；本版无独立用户可见变化。
+
+- Inline images now retire to native scrollback as soon as their transcript block finalizes instead of waiting for row pressure or shutdown, so terminals whose live-region sixel does not stick (Windows Terminal) show images in real time; the exit-time history flush remains as the fallback.
 
 ## [14.9.8] - 2026-05-12
 
@@ -775,6 +777,10 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - Added `getText()` method to Text component for retrieving current text content
 
+## [1.1.26] - 2026-10-03
+
+- 版本线推进至 1.1.26；本版无独立用户可见变化。
+
 ## [1.1.25] - 2026-10-03
 
 - Hyperlinks (OSC 8) are now emitted when running inside Zetawork workbench panes: the `ZETA_WORKBENCH=1` probe unlocks `fileHyperlink` output, so file links stay clickable and titles update live in the workbench's embedded terminals.
@@ -1026,34 +1032,4 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - `visibleWidth()` now strips OSC 8 hyperlink sequences, fixing text wrapping for clickable links ([#396](https://github.com/badlogic/pi-mono/pull/396) by [@Cursivez](https://github.com/Cursivez))
 
-## [0.31.0] - 2026-01-02
-
-### Added
-
-- `isShiftCtrlO()` key detection function for Shift+Ctrl+O (Kitty protocol)
-- `isShiftCtrlD()` key detection function for Shift+Ctrl+D (Kitty protocol)
-- `TUI.onDebug` callback for global debug key handling (Shift+Ctrl+D)
-- `wrapTextWithAnsi()` utility now exported (wraps text to width, preserving ANSI codes)
-
-### Changed
-
-- README.md completely rewritten with accurate component documentation, theme interfaces, and examples
-- `visibleWidth()` reimplemented with grapheme-based width calculation, 10x faster on Bun and ~15% faster on Node ([#369](https://github.com/badlogic/pi-mono/pull/369) by [@nathyong](https://github.com/nathyong))
-
-### Fixed
-
-- Markdown component now renders HTML tags as plain text instead of silently dropping them ([#359](https://github.com/badlogic/pi-mono/issues/359))
-- Crash in `visibleWidth()` and grapheme iteration when encountering undefined code points ([#372](https://github.com/badlogic/pi-mono/pull/372) by [@HACKE-RC](https://github.com/HACKE-RC))
-- ZWJ emoji sequences (rainbow flag, family, etc.) now render with correct width instead of being split into multiple characters ([#369](https://github.com/badlogic/pi-mono/pull/369) by [@nathyong](https://github.com/nathyong))
-
-## [0.29.0] - 2025-12-25
-
-### Added
-
-- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) and the cursor is after a word character, a space is automatically prepended for better readability. Useful when dragging screenshots from macOS. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))
-- **Word navigation for Input component**: Added Ctrl+Left/Right and Alt+Left/Right support for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-- **Full Unicode input**: Input component now accepts Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
-
-### Fixed
-
-- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
+Older entries are archived in [packages/tui/CHANGELOG.md@9caccab691ce](https://github.com/can1357/oh-my-pi/blob/9caccab691ce575007f4b6bcbaf8f944723d5457/packages/tui/CHANGELOG.md).

package/README.md

@@ -455,7 +455,7 @@ const spacer = new Spacer(2); // 2 empty lines (default: 1)
 
 ### Image
 
-Renders images inline for terminals that support the Kitty graphics protocol (Kitty, Ghostty, WezTerm, and Warp on macOS/Linux) or iTerm2 inline images. Falls back to a text placeholder on unsupported terminals.
+Renders images inline for terminals that support the Kitty graphics protocol (Kitty, Ghostty, WezTerm, and Warp on macOS/Linux), iTerm2 inline images or SIXEL. Falls back to a text placeholder on unsupported terminals.
 
 ```typescript
 interface ImageTheme {
@@ -466,17 +466,21 @@ interface ImageOptions {
 	maxWidthCells?: number;
 	maxHeightCells?: number;
 	filename?: string;
+	budget?: ImageBudget; // usually tui.imageBudget
+	requestRender?: () => void; // repaint once a SIXEL encode lands; defaults to the budget's
 }
 
 const image = new Image(
 	base64Data, // base64-encoded image data
 	"image/png", // MIME type
 	theme, // ImageTheme
-	options, // optional ImageOptions
+	{ ...options, budget: tui.imageBudget }, // optional ImageOptions
 );
 tui.addChild(image);
 ```
 
+SIXEL images encode off the JavaScript thread: the first render reserves the image's rows and the image appears on the repaint `budget` or `requestRender` triggers once the encode lands. Without either, it waits for an unrelated repaint.
+
 Supported formats: PNG, JPEG, GIF, WebP. Dimensions are parsed from the image headers automatically.
 
 ## Autocomplete

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

@@ -0,0 +1,30 @@
+/**
+ * Ownership of stdout by a started {@link ProcessTerminal}, kept in a leaf
+ * module so writers that `terminal.ts` itself imports (terminal capabilities,
+ * notifications) can route through the active terminal without an import cycle.
+ */
+import type { ProcessTerminal } from "./terminal.js";
+/** The started terminal that owns stdout in this thread, if any. */
+export declare function getActiveTerminal(): ProcessTerminal | null;
+/** Record the terminal that owns stdout (`ProcessTerminal.start`), or release it with `null` (`stop`). */
+export declare function setActiveTerminal(terminal: ProcessTerminal | null): void;
+/** Observe stdout errors through the shared listener. Returns the unregister callback. */
+export declare function registerStdoutErrorHandler(handler: (err: Error) => void): () => void;
+/**
+ * Hand `data` to the active terminal's ordered output path. Returns false when
+ * no terminal in this thread has started. On the main thread that means the
+ * caller owns stdout; a worker thread never sees the main thread's terminal, so
+ * there `false` is not permission to write. Prefer {@link writeTerminalSequence}.
+ */
+export declare function writeThroughActiveTerminal(data: string): boolean;
+/**
+ * Write an out-of-band escape sequence (window title, OSC 52 clipboard,
+ * notification). While a TUI owns stdout, its frames go through an off-thread
+ * pump in chunks that ignore escape boundaries; a direct `process.stdout.write`
+ * can land between two chunks and split a frame's escape sequence, and the host
+ * terminal then prints its tail as text. So the sequence takes the active
+ * terminal's ordered output path, and goes straight to stdout, best-effort, only
+ * when no terminal owns it. A worker thread cannot reach the main thread's
+ * terminal and would write around its pump, so it writes nothing.
+ */
+export declare function writeTerminalSequence(data: string): void;

package/dist/types/app-keybindings.d.ts

@@ -40,6 +40,7 @@ interface AppKeybindings {
     "app.tree.unfoldOrDown": true;
     "app.plan.toggle": true;
     "app.history.search": true;
+    "app.stt.pushToTalk": true;
     "app.stt.toggle": true;
     "app.live.toggle": true;
 }
@@ -329,9 +330,13 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+r";
         readonly description: "Search history";
     };
+    readonly "app.stt.pushToTalk": {
+        readonly defaultKeys: "space";
+        readonly description: "Hold to record speech-to-text";
+    };
     readonly "app.stt.toggle": {
         readonly defaultKeys: [];
-        readonly description: "Toggle speech-to-text (default gesture: hold Space)";
+        readonly description: "Toggle speech-to-text recording";
     };
     readonly "app.live.toggle": {
         readonly defaultKeys: "ctrl+l";

package/dist/types/apps/git/git-tui.d.ts

@@ -13,8 +13,9 @@
  * arrows/PgUp/PgDn, vim motions (`j`/`k`/`h`/`l`/`g`/`G`), and mouse
  * clicks/wheel. All toolbar buttons are clickable and mirrored by keys:
  * `v` cycles the view (`1`–`4` pick one), `alt+↓`/`alt+↑` jump hunks and roll
- * into the adjacent file at the edges, `]`/`[` switch files, `s`/`u`
- * stage/unstage (hunk-aware), `x` discards a hunk, `delete` discards the
+ * into the adjacent file at the edges, `space` stages/unstages the focused
+ * diff row (the focused hunk in hunk view), `s`/`u` stage/unstage
+ * (hunk-aware), `x` discards a hunk, `delete` discards the
  * whole file (press twice to confirm), `w` wraps, `b` cycles
  * whitespace handling (exact → ignore whitespace → ignore
  * formatting/import-only changes), `c` jumps to the commit form, `r`

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

@@ -38,7 +38,7 @@ export declare class AssistantMessageComponent extends Container {
      * for lack of a target is re-rendered with its reaction stripped.
      */
     pickReactionTarget(transcript: readonly Component[]): void;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>);
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: () => void, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget, proseOnlyThinking?: boolean, linkTargets?: ReadonlyMap<string, string>, expandThinkingBlocks?: boolean);
     /**
      * Show or clear the trailing cache-invalidation divider. Set at `message_end`
      * (live) or during rebuild, once the turn's usage is known and compared
@@ -65,6 +65,11 @@ export declare class AssistantMessageComponent extends Container {
      */
     setMidStreamPublication(allowed: boolean): void;
     setProseOnlyThinking(proseOnly: boolean): void;
+    /**
+     * Keep finished thinking sections expanded instead of folding them to "Thought for 12s".
+     * Sections the user folded or unfolded by hand keep that choice.
+     */
+    setExpandThinkingBlocks(expand: boolean): void;
     dispose(): void;
     /**
      * Toggle suppression of the inline `Error: …` line while the same error is

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

@@ -25,6 +25,7 @@ export interface ChatTranscriptBuilderDeps {
     cwd: string;
     hideThinkingBlock?: () => boolean;
     proseOnlyThinking?: () => boolean;
+    expandThinkingBlocks?: () => boolean;
     /** Session-scoped resolved destinations for model-authored Markdown links. */
     linkTargets?: ReadonlyMap<string, string>;
     requestRender: () => void;

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

@@ -1,7 +1,7 @@
 import { type Component, Container } from "../tui.js";
 import type { ImageContent } from "@linxiraos/pi-ai";
 import type { ReactionTarget } from "./reaction.js";
-import { type NativeNode, type NativeUiEvent } from "../native/node.js";
+import { type DescribeContext, type NativeNode, type NativeUiEvent } from "../native/node.js";
 /** How a user bubble styles its prose and chips (see {@link userBubbleColor}). */
 export interface UserBubbleOptions {
     /** Materialized `file://` targets per attached image, indexed by chip number. */
@@ -42,7 +42,7 @@ export declare class UserMessageComponent extends Container implements ReactionT
      * agent's reaction are chips at the bottom-right, so a reaction landing
      * later updates the frame in place, even deep in scrollback.
      */
-    describe(): NativeNode;
+    describe(cx?: DescribeContext): NativeNode;
     /** Hover toolbar clicks: zeta's own copy and rewind commands. */
     handleNativeEvent(event: NativeUiEvent): void;
     render(width: number): readonly string[];

package/dist/types/chrome/status-notice.d.ts

@@ -1,14 +1,26 @@
 import type { NativeNode } from "../native/node.js";
 import { Container } from "../tui.js";
+/** How a {@link StatusNotice} shows. */
+export interface StatusNoticeOptions {
+    /** Styles the ANSI line; resolved at render so a theme change re-shapes it. */
+    styleFn?: (text: string) => string;
+    /**
+     * Whether a native terminal toasts it (default). False keeps the notice to
+     * the ANSI transcript: background chatter such as MCP connection progress,
+     * which would otherwise re-toast on every server that connects or fails.
+     */
+    toast?: boolean;
+}
 /**
  * A transient status notice (`showStatus`: "Thinking blocks: hidden", "Copied
  * to clipboard"). The ANSI render appends a blank row and the dim line to the
  * transcript; a native terminal shows it as a toast instead, so notices never
- * pile up in the history. Updating the text re-shows the toast.
+ * pile up in the history. Updating the text re-shows the toast; a notice
+ * with `toast: false` describes nothing natively.
  */
 export declare class StatusNotice extends Container {
     #private;
-    constructor(message: string, styleFn?: (text: string) => string);
-    setMessage(message: string, styleFn?: (text: string) => string): void;
+    constructor(message: string, options?: StatusNoticeOptions);
+    setMessage(message: string, options?: StatusNoticeOptions): void;
     describe(): NativeNode;
 }

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

@@ -138,6 +138,9 @@ export declare class Editor implements Component, Focusable {
     onLargePaste?: (text: string, lineCount: number, options: PasteOptions) => boolean;
     onAutocompleteCancel?: () => void;
     disableSubmit: boolean;
+    /** Base editors accept native edits, not atomic sends. Implementations that
+     *  handle `send` override this readiness check for their submission path. */
+    protected get nativeSendable(): boolean;
     /** Placeholder painted right-aligned on the cursor row while the editor is empty and no
      *  autocomplete is open; hidden when it can't keep {@link PLACEHOLDER_MIN_GAP} cells from the
      *  cursor. The host styles it (ANSI allowed). Re-evaluated on every render, so hosts can derive
@@ -296,7 +299,7 @@ export declare class Editor implements Component, Focusable {
     submit(): void;
     /** Insert text at the current cursor position */
     insertText(text: string): void;
-    /** Terminal-side selection edits on the `editor` node (see {@link applyHostEdit}). */
+    /** Terminal-side selection edits and undo on the `editor` node (see {@link applyHostEdit}). */
     handleNativeEvent(event: NativeUiEvent): void;
     /**
      * Apply an edit the terminal made over its own selection (TSP `edit`):
@@ -327,6 +330,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 a character-jump hotkey is waiting for its target character. */
+    get isJumpPending(): boolean;
+    /** Type literal text through the character-editing pipeline without keybinding dispatch. */
+    typeCharacter(text: 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

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

@@ -16,7 +16,19 @@ export interface ImageOptions {
      * repaint replaces the placement instead of stacking a duplicate.
      */
     imageKey?: string;
+    /**
+     * Schedules a repaint once this image's off-thread SIXEL encode lands.
+     * Defaults to the budget's repaint; a host without a budget must pass one,
+     * or the image's reserved rows stay blank until an unrelated repaint.
+     */
+    requestRender?: () => void;
 }
+/**
+ * Run `render` for rows bound for native scrollback. Those rows are never
+ * repainted, so an image whose off-thread SIXEL encode has not landed encodes
+ * synchronously instead of committing its reserved blank rows.
+ */
+export declare function renderForScrollback<T>(render: () => T): T;
 /** Default count of inline images kept as live graphics before older ones fall back to text. */
 export declare const DEFAULT_MAX_INLINE_IMAGES = 8;
 /**
@@ -52,6 +64,8 @@ export declare class ImageBudget {
     get cap(): number;
     get enabled(): boolean;
     setRequestRender(requestRender: () => void): void;
+    /** Ask for a repaint, e.g. once an image's off-thread encode settles. */
+    requestRender(): void;
     setCap(cap: number): void;
     /**
      * Stable graphics id for a logical image. A non-empty `key` maps to the same

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

@@ -28,6 +28,7 @@ export declare class Input implements Component, Focusable {
     setValue(value: string): void;
     setUseTerminalCursor(useTerminalCursor: boolean): void;
     getUseTerminalCursor(): boolean;
+    capturesInput(data: string): boolean;
     /**
      * Apply one key: the editor's text bindings (motion, deletion, kill ring,
      * undo), pastes and printable text. Returns whether the key was the
@@ -39,7 +40,7 @@ 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;
-    /** Terminal-side selection edits on the `input` node (see {@link applyHostEdit}). */
+    /** Terminal-side selection edits and undo on the `input` node (see {@link applyHostEdit}). */
     handleNativeEvent(event: NativeUiEvent): void;
     /**
      * Apply an edit the terminal made over its own selection (TSP `edit`):

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

@@ -1,3 +1,4 @@
+import type { KeyId } from "../keys.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 import { type ShimmerPalette } from "../theme/shimmer.js";
 import type { TUI } from "../tui.js";
@@ -23,16 +24,14 @@ export interface WorkingRowSpec {
     readonly variant?: WorkingRowVariant;
     /** Shimmer palette of the label (a session-accented intent). */
     readonly palette?: ShimmerPalette;
-    /** Live tok/s, docked before the stop control. */
-    readonly rate?: number;
     /** Key id that interrupts (`escape`); undefined hides the stop control (Esc would not cancel). */
-    readonly interruptKey?: string;
+    readonly interruptKey?: KeyId;
 }
 /**
  * The dock's working row: `starburst` spinner (or a retry countdown ring),
- * the intent shimmering, `·`, the elapsed time, a grow spacer, then the stop
- * control whose click sends `interrupt`. Compaction adds an indeterminate
- * `progress` before the stop control; a retry says "Cancel".
+ * the elapsed time, the `·` divider, the intent shimmering, a grow spacer,
+ * then the stop control whose click sends `interrupt`. Compaction adds an
+ * indeterminate `progress` before the stop control; a retry says "Cancel".
  */
 export declare function describeWorkingRow(spec: WorkingRowSpec, cx: DescribeContext, now?: number): NativeNode;
 type ColorFn = (str: string) => string;

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

@@ -1,8 +1,10 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
-/** @internal exported for tests — the grown-line-start block-kind gate. */
+/** @internal exported for tests — the grown-line block-kind gate. */
 export declare function fastLineStartHazard(grownLine: string): boolean;
+/** @internal exported for tests — the windowed lexer's first-probe window size. */
+export declare const LEX_WINDOW_BYTES: number;
 /** A hyperlink as the renderer sees it: inline `[text](href)`, `<autolink>`, bare GFM URL, or reference link. */
 export interface MarkdownLink {
     /** Visible link text (equals `href` for autolinks and bare URLs). */
@@ -82,7 +84,12 @@ export interface MarkdownTheme {
      * Return null to fall back to fenced code rendering.
      */
     resolveMermaidAscii?: (source: string, maxWidth?: number) => string | null;
-    symbols: SymbolTheme;
+    /**
+     * Glyphs for quote borders, rules, tables and color swatches. Optional so themes
+     * built to the upstream pi-tui `MarkdownTheme` shape (which has no `symbols`)
+     * still render; omitted symbols fall back to the active theme's set.
+     */
+    symbols?: SymbolTheme;
 }
 export declare class Markdown implements Component {
     #private;
@@ -101,8 +108,10 @@ export declare class Markdown implements Component {
     describe(_cx: DescribeContext): NativeNode;
     /**
      * Width-independent source prefix of the last render ending at a frozen
-     * Markdown block boundary. Only meaningful while streaming (transient
-     * render cache on); grows monotonically under append-only `setText`.
+     * Markdown block boundary that no append can move: it stops in front of a
+     * display-math opener whose block an append could still close. Only
+     * meaningful while streaming (transient render cache on); grows
+     * monotonically under append-only `setText`.
      */
     getLastRenderStableText(): string;
     get transientRenderCache(): boolean;

package/dist/types/key-hint-format.d.ts

@@ -23,6 +23,14 @@ export type KeyName = KeyId | ModifierName;
  * is capitalized. Other keys are capitalized (`f5` → `F5`).
  */
 export declare function formatKeyHint(key: KeyName): string;
+/**
+ * Format one key for a native tooltip (a TSP `title`): unicode keycap glyphs
+ * whatever the theme's symbol preset (`shift+tab` → `⇧⇥`), which Tern's
+ * tooltip splits into keycaps, and `esc` as Tern's own keycaps read. The nerd
+ * preset's icons are missing from Tern's UI font, and its spaced chords would
+ * not parse as keys.
+ */
+export declare function formatTooltipKey(key: KeyName): string;
 /** Format alternative keys as a slash-separated hint (`["f5", "alt+r"]` → `F5/⌥R`). */
 export declare function formatKeyHints(keys: KeyName | readonly KeyName[]): string;
 /** Format a double-tap gesture: `←←` with glyphs, `Left Left` with words. */

package/dist/types/native/apply.d.ts

@@ -1,8 +1,9 @@
 /**
  * Reference document applier: applies TSP frames to a node tree the way the
- * spec says the terminal does (§5.1). Ops are validated and applied one by
- * one; a rejected op is reported and skipped without affecting the rest of
- * the frame. `settle` is recorded as a hint and never restricts later ops.
+ * spec says the terminal does (Tern SDK, `protocol/documents.md`, frame ops).
+ * Ops are validated and applied one by one; a rejected op is reported and
+ * skipped without affecting the rest of the frame. `settle` is recorded as a
+ * hint and never restricts later ops.
  *
  * Used by tests, the debug server's `doc` op, and the TSP test harness.
  */

package/dist/types/native/backend.d.ts

@@ -83,8 +83,8 @@ export declare class NativeBackend {
      * The terminal's real `hello` reply after an optimistic start: adopt its
      * APC limit, credits, cell size, kinds, appearance and motion preference.
      * A width the terminal already reported in a `resize` event wins over the
-     * reply's. A different vocabulary or motion preference re-describes every
-     * component, so kinds the terminal lacks fall back.
+     * reply's. A different vocabulary, motion preference or clock re-describes
+     * every component, so kinds the terminal lacks fall back.
      */
     confirm(hello: TspHello): void;
     /** SIGWINCH: refresh the width used for `rows` fallback until the terminal reports one. */

package/dist/types/native/encode.d.ts

@@ -26,8 +26,11 @@ export declare function encodeTspMessage(verb: TspVerb, body: string, params?: T
 export declare function encodeTspJson(verb: TspVerb, value: unknown, params?: TspParams, limit?: number): string;
 /**
  * The `hello` query; callers follow it with a DA1 sentinel. `features: ["edit"]`
- * tells the terminal that zeta applies its `edit` events (TSP §8.5), so it may keep a
- * native selection in zeta's editors; without it, every key stays zeta's.
+#1:  * tells the terminal that zeta applies its `edit` events (Tern SDK,
+ * `protocol/input.md`), so it may keep a native selection in zeta's editors;
+ * without it, every key stays zeta's. `"undo"` says zeta applies `undo` events,
+ * so the terminal may turn ⌃Z in a field into one.
+ * `"send"` accepts an explicit prompt for a live composer without simulating keys.
  */
 export declare function encodeTspHelloQuery(version?: string): string;
 /** One decoded APC message: verb, parameters and raw body. */

package/dist/types/native/node.d.ts

@@ -11,7 +11,8 @@
  * `rows` fallback node rendered through `render(cx.cols)`.
  *
  * See `packages/wire/src/tsp.ts` for the wire vocabulary and
- * `crates/tern/SURFACE_PROTOCOL.md` (Stencil repository) for the spec.
+ * the Tern SDK's Surface Protocol reference (`docs/sdk/src/protocol` in the
+ * Stencil repository, https://docs.stencil.so/tern/protocol/) for the spec.
  */
 import type { TspEvent, TspKind, TspProps, TspScrollBy, TspSpan } from "@linxiraos/pi-wire";
 import type { Component } from "../tui.js";
@@ -28,10 +29,12 @@ export type NativeNode = {
          */
         readonly key?: string;
         /**
-         * Scroll the node into view, placed like the `reveal` op, when it is
-         * added. Key a node by what it points at to reveal it again on a move.
+         * Scroll the node into view, placed like the `reveal` op. A placement
+         * reveals it when it is added: key a node by what it points at to
+         * reveal it again on a move. A {@link NativeReveal} reveals it whenever
+         * its `n` differs from the previous description of the same node.
          */
-        readonly reveal?: "start" | "end" | "nearest";
+        readonly reveal?: NativeRevealAt | NativeReveal;
         /**
          * Keyboard scrolling forwarded to the terminal (PgUp/PgDn/End reach the
          * program): moves the scroller at or above the node by `by` whenever
@@ -42,6 +45,17 @@ export type NativeNode = {
         readonly scroll?: NativeScroll;
     };
 }[TspKind];
+/** Where a revealed node lands in its scroller. */
+export type NativeRevealAt = "start" | "end" | "nearest";
+/**
+ * A repeatable {@link NativeNode.reveal}: bump `n` to bring an existing node
+ * into view again (a Contents entry jumping to its section). A freshly added
+ * node is not revealed.
+ */
+export interface NativeReveal {
+    readonly at: NativeRevealAt;
+    readonly n: number;
+}
 /** A {@link NativeNode.scroll} request. */
 export interface NativeScroll {
     readonly by: TspScrollBy;
@@ -57,6 +71,12 @@ export interface DescribeContext {
     readonly reduceMotion: boolean;
     /** The terminal's appearance is dark. */
     readonly dark: boolean;
+    /**
+     * The user's system reads a 12-hour clock (`false`: 24-hour); `undefined`
+     * when the terminal doesn't say. Pass it as `hour12` when formatting times:
+     * the process's own default locale may not know.
+     */
+    readonly hour12?: boolean;
     /** Whether the terminal renders `kind` natively (else describe something simpler or let it fall back). */
     supports(kind: TspKind): boolean;
     /**
@@ -117,7 +137,18 @@ export type NativeUiEvent = {
  | ({
     readonly type: "edit";
     readonly key: string;
-} & NativeTextEdit);
+} & NativeTextEdit)
+/** Undo the last change to an `editor`/`input` node's text (the terminal's ⌃Z); a no-op with no history. */
+ | {
+    readonly type: "undo";
+    readonly key: string;
+}
+/** Submit an explicit prompt through the composer's normal path, preserving the previous draft for recall. */
+ | {
+    readonly type: "send";
+    readonly key: string;
+    readonly text: string;
+};
 /**
  * A primitive edit the terminal made over its own text selection (cut,
  * typing, Backspace/Delete or paste over it, or collapsing it). Offsets are

package/dist/types/native/overlay.d.ts

@@ -7,7 +7,7 @@
  * component's root is a `card` whose `head` carries the title.
  */
 import type { TspProps, TspSpan, TspText } from "@linxiraos/pi-wire";
-import type { KeyName } from "../key-hint-format.js";
+import { type KeyName } from "../key-hint-format.js";
 import { type Keybinding } from "../keybindings.js";
 import type { NativeChild, NativeNode } from "./node.js";
 /** One footer hint: the keys that trigger it and what it does. */
@@ -44,10 +44,10 @@ export interface ActionButtonOptions {
     /** Sibling identity key (defaults to the action id); `leafKey(event.key)` reports it back. */
     readonly key?: string;
     /** Key id of the keyboard path the button mirrors, drawn as a keycap inside it (`"r"`, `"ctrl+g"`). */
-    readonly keys?: string;
+    readonly keys?: KeyName;
     /** `accent` = the view's hero action, `error` = destructive. */
     readonly tone?: "accent" | "error";
-    /** Tooltip; defaults to the label plus the keycap (`"Refresh  r"`). */
+    /** Tooltip; defaults to the label plus the keycap (`"Refresh  r"`, see {@link formatTooltipKey}). */
     readonly title?: string;
     /** Target of an `open` action (URL or `file://` path). */
     readonly href?: string;

package/dist/types/native/settle.d.ts

@@ -1,8 +1,9 @@
 /**
  * Settling: the frame provider marks finalized transcript blocks so the
- * native reconciler stops keeping their description (spec §12 "Settling and
- * program memory"). A settled block stays editable: a later change is sent as
- * targeted ops by id, followed by a fresh `settle` hint.
+ * native reconciler stops keeping their description (Tern SDK,
+ * `protocol/operations.md`, "Settling"). A settled block stays editable: a
+ * later change is sent as targeted ops by id, followed by a fresh `settle`
+ * hint.
  */
 import type { Component } from "../tui.js";
 /** Mark `component` (and everything it describes) as finalized. Idempotent; a no-op outside a TSP terminal. */

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

@@ -73,6 +73,7 @@ export interface AgentHubDeps<TRecord extends AgentRecordLike = AgentRecordLike>
     /** Mirrors the main transcript's thinking-block visibility. */
     hideThinkingBlock?: () => boolean;
     proseOnlyThinking?: () => boolean;
+    expandThinkingBlocks?: () => boolean;
     /** Keys toggling tool output expansion (app.tools.expand). */
     expandKeys?: KeyId[];
     /** Focus the main view on this agent's live session (ctx.focusAgentSession). When absent (collab guest, tests), Enter opens the in-hub chat view instead. */

package/dist/types/overlays/agent-transcript-viewer.d.ts

@@ -54,6 +54,7 @@ export interface AgentTranscriptViewerDeps {
     cwd: string;
     hideThinkingBlock?: () => boolean;
     proseOnlyThinking?: () => boolean;
+    expandThinkingBlocks?: () => boolean;
     expandKeys: KeyId[];
     /** Keys that toggle the whole hub closed (app.agents.hub + app.session.observe). */
     hubKeys: KeyId[];

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

@@ -1,6 +1,7 @@
 import { type Component, type Focusable, Input } from "../index.js";
 import { type BtwHistoryRecord } from "./btw-history.js";
 import type { SpaceHoldHandler } from "../space-hold.js";
+import { type KeyId } from "../app-keybindings.js";
 import type { NativeNode, NativeUiEvent } from "../native/node.js";
 interface BtwHistoryPanelOptions {
     records: readonly BtwHistoryRecord[];
@@ -9,10 +10,17 @@ 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. */
+    /** Configured push-to-talk keys for a follow-up composer. */
+    spaceHoldKeys?: readonly KeyId[];
     spaceHold?: (input: Input) => SpaceHoldHandler;
     requestRender: () => void;
     getHeight: () => number;
+    /**
+     * Esc closes the panel even while the selected answer runs (it keeps
+     * streaming in the background) and `x` cancels it, instead of Esc cancelling
+     * first. For a host with no inline panel to fall back to (Tern).
+     */
+    escapeHides?: boolean;
 }
 /** Session-local side questions. Selecting or copying never promotes them into chat. */
 export declare class BtwHistoryPanel implements Component, Focusable {
@@ -25,6 +33,10 @@ export declare class BtwHistoryPanel implements Component, Focusable {
     markCopied(recordId: string, text: string): void;
     invalidate(): void;
     openFollowUp(recordId: string): boolean;
+    /** Select a record with its answer pane focused, read from the top (a just-asked /btw). */
+    showRecord(recordId: string): void;
+    /** Only an active follow-up composer can claim its configured push-to-talk keys. */
+    capturesInput(data: string): boolean;
     /** Enhanced clipboard pastes belong only to the active composer. */
     pasteText(text: string): void;
     handleInput(data: string): void;

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

@@ -31,6 +31,7 @@ export interface CopySelectorDeps {
     cwd: string;
     hideThinkingBlock?: () => boolean;
     proseOnlyThinking?: () => boolean;
+    expandThinkingBlocks?: () => boolean;
     linkTargets?: ReadonlyMap<string, string>;
     requestRender: () => void;
     /** Replaces the "Copy" header when the picker is reused for another purpose. */

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

@@ -61,7 +61,10 @@ export declare class HubFrame {
     constructor(title: string, sidebarBounds: {
         min: number;
         max: number;
-    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[]);
+    }, renderSidebar: (width: number, rows: number) => string[], renderBody: (width: number, height: number | undefined) => readonly string[], options?: {
+        bodyMinWidth?: number;
+        preserveSidebar?: boolean;
+    });
     /** Invalidate the composed layout. */
     invalidate(): void;
     /** Measure labels and annotations within this hub's sidebar width bounds. */