@linxiraos/pi-tui 1.2.1 → 1.3.0

package/dist/types/overlays/session-account-selector.d.ts

@@ -1,5 +1,6 @@
 import { type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 /** Stored account identity rendered and matched by the session account picker. */
 export interface SessionPinAccount {
     position: number;
@@ -17,6 +18,9 @@ export interface SessionPinAccount {
 export declare class SessionAccountSelectorComponent extends OverlayPanel {
     #private;
     constructor(providerName: string, accounts: readonly SessionPinAccount[], onSelect: (account: SessionPinAccount) => void, onCancel: () => void);
+    describe(cx: DescribeContext): NativeNode | null;
+    /** Picker pointer events drive the list exactly as its keys do. */
+    handleNativeEvent(event: NativeUiEvent): void;
     /** Forward keyboard navigation and cancellation when the wrapper owns focus. */
     handleInput(keyData: string): void;
     /** Route mouse selection through the title rows into the account list. */

package/dist/types/overlays/session-info-overlay.d.ts

@@ -24,9 +24,13 @@ export declare class SessionInfoOverlay implements Component {
     setIgnoreTight(ignore: boolean): this;
     dispose(): void;
     /**
-     * The sheet body (the overlay is the frame): the session id in mono
-     * (click copies), each report heading as a section of key/value rows, a
-     * context meter after the leading block, and a Close button (Esc).
+     * The sheet body (the overlay is the frame), in three tiers: who the session
+     * is (the id and file as copyable mono fields), how full its context window
+     * is (a meter under a right-aligned figure), then the report's sections as
+     * headed groups. Groups of plain counts (Messages, Tokens, Cost) share a
+     * two-column stats grid with right-aligned figures and their Total set off
+     * last; the rest (Provider, servers) are key/value rows. A Close button (Esc)
+     * ends it.
      */
     describe(cx: DescribeContext): NativeNode;
     /** The Close button runs Esc's path. */

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

@@ -127,6 +127,8 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
     allSessions?: T[];
     /** Picker heading; defaults to "Resume Session". */
     title?: string;
+    /** Primary action label; defaults to "Resume" (ANSI footer defaults to "select"). */
+    actionLabel?: string;
     /** Fixed scope label, or false to omit the scope suffix. */
     scopeLabel?: string | false;
     /**
@@ -152,7 +154,7 @@ export interface SessionSelectorOptions<T extends SessionSelectorEntry = Session
     /** Path of the live session, or a getter so detach/newSession stays accurate. */
     currentSessionPath?: string | (() => string | undefined);
     /**
-     * The picker is the whole program (`zeta-c --resume`): the native picker
+     * The picker is the whole program (`zetacode --resume`): the native picker
      * fills the screen surface (`size:"screen"`) instead of floating as a
      * sheet over the transcript.
      */

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

@@ -122,12 +122,12 @@ export declare class UsageDashboardComponent implements Component {
     dispose(): void;
     render(width: number): readonly string[];
     /**
-     * The sheet body (the terminal's `lg` overlay is the frame): a head row
-     * (checked ago, Overview/Details tabs, Refresh), then either the provider
-     * grid of frames with window meters and the activity heatmap, or the
-     * per-provider detail tables, then Close like the other report sheets.
-     * `meter`/`chart` fall back to `progress`/`table` on terminals without
-     * them. Rebuilt only when its inputs change.
+     * The sheet body (the terminal's `lg` overlay is the frame): a toolbar
+     * (Overview/Details, freshness, Refresh), then either the overview — a
+     * strip of headline figures, the quota rows per provider, the activity
+     * calendar — or the per-provider detail tables, then Close like the other
+     * report sheets. `meter`/`chart` fall back to `progress`/`table` on
+     * terminals without them. Rebuilt only when its inputs change.
      */
     describe(cx: DescribeContext): NativeNode;
     /** Tab clicks switch views like Enter/Esc; the Refresh button runs `r`; Close closes from either view. */

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

@@ -50,18 +50,8 @@ export interface ComposerOptions {
     readonly exit?: (code: number) => void;
     readonly now?: () => number;
 }
-/** How {@link Composer.setRuntimeChildren} bills below-transcript roots against transcript retirement. */
+/** How {@link Composer.setRuntimeChildren} lays out the roots below the transcript. */
 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. Decision panels
-     * declaring `retireDisplacedTranscript` opt out of this floor even when
-     * mounted as a child of a transient editor container.
-     */
-    readonly transient?: readonly Component[];
     /**
      * Dock order on a TSP terminal (no status strip; the composer carries its
      * facts): the native dock stacks HUD pills, the working row and queued messages over
@@ -69,6 +59,20 @@ export interface RuntimeChildrenOptions {
      * to the roots below the transcript in render order.
      */
     readonly nativeDock?: readonly Component[];
+    /**
+     * Below-transcript roots the user opens and closes (the editor surface that
+     * drafts and dialogs swap into, docked reports). Their rows never become
+     * part of the post-run chrome floor, so collapsing them refills the screen.
+     */
+    readonly transientChrome?: readonly Component[];
+    /**
+     * Transient roots that clear themselves (todo and subagent HUDs, progress).
+     * Their first paint can be their tallest, e.g. a restored todo list on a
+     * resumed session, so unlike {@link transientChrome} it is never treated as
+     * their resting height: all of their rows stay out of the floor. Roots listed
+     * here are transient and need not also appear in `transientChrome`.
+     */
+    readonly selfClearingChrome?: readonly Component[];
 }
 /** Controls the first terminal paint for a composer that does not already own the terminal. */
 export interface ComposerStartOptions {
@@ -123,15 +127,6 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
      * the screen rows left above them; `undefined` before `root` was laid out.
      */
     rowsBelow(root: Component): number | undefined;
-    /**
-     * Keep the input on the bottom row while the live rows cannot fill the
-     * screen, as after an inline decision panel closes. A tall block that just
-     * left the chrome above the editor (a command report) may have scrolled
-     * rows into native history that cannot be pulled back; without the pin the
-     * editor would jump up to where the shorter frame now ends. The pin lifts
-     * once live rows fill the screen again.
-     */
-    pinInputToBottom(): void;
     /** Compose the bounded mutable viewport and the next ordered history append. */
     renderFrame(viewport: ViewportSize): TerminalFramePlan;
     /**
@@ -176,6 +171,12 @@ export declare class Composer implements TerminalFrameProvider, NativeSurfacePro
     setPreferences(update: Partial<ComposerPreferences>): void;
     /** Patch welcome data in place as version, session, and project discovery complete. */
     updateWelcome(update: ComposerWelcomeUpdate): void;
+    /**
+     * Mark whether a host agent run is in flight. Mid-run gaps with no streaming
+     * block (tool arguments not yet parseable, between tool calls) then do not
+     * count as the run ending when the post-run chrome floor is decided.
+     */
+    setRunActive(active: boolean): void;
     /** Replace optional header content around the stable welcome scene. */
     setHeaderExtras(before: readonly Component[], after: readonly Component[]): void;
     /** Update the canonical editor reference after InteractiveMode remounts a custom editor. */

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

@@ -24,6 +24,8 @@ export interface ComposerNativeState {
     readonly rate?: number;
     /** A turn is running: the send keycap becomes a Stop button. */
     readonly running: boolean;
+    /** Native dictation control; undefined hides it for hosts without speech-to-text. */
+    readonly dictation?: "idle" | "starting" | "recording" | "transcribing";
     /** The viewed subagent's lineage, outermost first and the viewed agent last; undefined on the main session. */
     readonly viewing?: readonly string[];
     /** The session's title, quoted in italics as the TSP placeholder; undefined until it has one. */
@@ -196,6 +198,8 @@ export declare class CustomEditor extends Editor {
      *  item markers use the accent color so separate follow-ups remain visible while composing.
      *  Called once per layout segment, so whole-buffer inputs are computed once per text revision. */
     decorateText: (text: string, context: EditorTextDecorationContext) => string;
+    /** Catch the typed word up with the caret first: its leaving the word (or a blur) re-describes the typo marks. */
+    describe(cx: DescribeContext): NativeNode;
     /**
      * TSP decorations: magic keywords shimmer (terminal-clocked) in the accent
      * color, chips and markers take their token colors, misspellings are marked,
@@ -220,7 +224,8 @@ export declare class CustomEditor extends Editor {
      *  once after construction (and again after `setEditorComponent` swaps the
      *  editor). Passing `undefined` clears any pending frame. */
     setShimmerRepaintHandler(handler: (() => void) | undefined): void;
-    /** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled. */
+    /** Editing is available during bootstrap; atomic sends wait until submission is wired and enabled
+     *  and no dictation is still writing into the draft. */
     protected get nativeSendable(): boolean;
     /** Viewing a subagent, the draft goes to it: the placeholder names it; else the session's title, quoted in italics. */
     describePlaceholder: () => TspText;
@@ -238,17 +243,17 @@ export declare class CustomEditor extends Editor {
      * subagent is focused, the attachment chips, a `line` row of the
      * shell-mode chip and the input, and the `bar`: model chip, effort chip
      * (or the effort glyph as the model chip's icon), the generation rate,
-     * the other status facts, usage, then send (Stop while a turn runs).
-     * Clicks come back as `status.model`, `thinking.cycle`, `submit`,
-     * `interrupt` and `focus:<id>` actions.
+     * the other status facts, usage, dictation, then send (Stop while a turn runs).
+     * Clicks come back as `status.model`, `thinking.cycle`, `dictation.toggle`,
+     * `submit`, `interrupt` and `focus:<id>` actions.
      */
     describeLayout: (input: NativeNode, cx: DescribeContext) => NativeEditorLayout;
     /**
-     * Clicks on the composer's controls take the same paths as their keys: ⇧⇥,
-     * ⏎ and Esc; the viewing header's links (`focus:<id>`) go to the host,
-     * the status facts' clicks (`status.*`) to their source. Selection edits
-     * go to the buffer; `send` submits its own prompt after saving the old draft
-     * for recall and waiting for in-flight clipboard work.
+     * Dictation clicks go directly to the host, independent of keybindings.
+     * Other controls take the same paths as their keys; the viewing header's
+     * links (`focus:<id>`) go to the host, the status facts' clicks to their source.
+     * Selection edits go to the buffer; `send` submits its own prompt after
+     * saving the old draft for recall and waiting for in-flight clipboard work.
      */
     handleNativeEvent(event: NativeUiEvent): void;
     onEscape?: () => void;
@@ -275,6 +280,8 @@ export declare class CustomEditor extends Editor {
     onRetry?: () => void;
     /** Called when Caps Lock is pressed. */
     onCapsLock?: () => void;
+    /** Called directly by the native microphone/stop control, without synthesizing a keypress. */
+    onToggleDictation?: () => void;
     /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
     onLeftAtStart?: () => void;
     /** Called when the viewing header asks to view agent `id` ({@link MAIN_AGENT_ID}: the main session). */
@@ -296,6 +303,8 @@ export declare class CustomEditor extends Editor {
      * Clear all custom key handlers.
      */
     clearCustomKeyHandlers(): void;
+    /** True while a clipboard-image or image-path paste is still landing; later keys queue behind it. */
+    get pasteInFlight(): boolean;
     capturesInput(data: string): boolean;
     handleInput(data: string): void;
     /**
@@ -305,7 +314,8 @@ export declare class CustomEditor extends Editor {
      * an Ask dialog opened over a non-empty prompt — so finishing or submitting
      * the draft cannot fire an editor-slot shortcut that clears
      * `editorContainer` and orphans the overlay. Only text editing, cursor
-     * movement, submission, and the clear action reach the buffer.
+     * movement, submission, the clear action, and pastes (clipboard images and
+     * image paths attach as on the composer) reach the buffer.
      */
     handleDraftEdit(data: string): void;
 }

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

@@ -1,4 +1,5 @@
 import type { ImageContent } from "@linxiraos/pi-ai";
+import type { TspSpan } from "@linxiraos/pi-wire";
 /** Materialized image destination returned by the host blob writer. */
 interface ImageBlobResult {
     displayPath: string;
@@ -23,4 +24,25 @@ type ImageBlobWriterSync = (data: Buffer, options?: {
 export declare function imageReferenceHyperlink(label: string, index: number, imageLinks: readonly (string | undefined)[] | undefined, renderLabel: (text: string) => string): string;
 export declare function materializeImageReferenceLinks(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriter): Promise<(string | undefined)[] | undefined>;
 export declare function materializeImageReferenceLinksSync(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriterSync): (string | undefined)[] | undefined;
+/**
+ * Register the host's blob writer that backs links for images without a file of their
+ * own. Returns a disposer that unregisters it unless another writer replaced it since.
+ */
+export declare function setImageBlobWriter(next: ImageBlobWriterSync): () => void;
+/**
+ * Whether transcript images carry links under the current `tui.hyperlinks` policy: a
+ * native surface honours only an explicit `off`, text mode the resolved OSC 8 support.
+ * Renderers caching a linked image key their cache on it.
+ */
+export declare function imageLinksEnabled(): boolean;
+/**
+ * The file a transcript image opens: `sourcePath` when it was read from one, else a
+ * blob copy of its bytes written through the host. Undefined when links are disabled
+ * or no file exists, so a disabled policy never writes blobs.
+ */
+export declare function transcriptImageLink(image: Pick<ImageContent, "data" | "mimeType">, sourcePath?: string): string | undefined;
+/** `text` (an image's placeholder) as an OSC 8 link to the image's file; plain when hyperlinks are off or no file exists. */
+export declare function linkedImageText(text: string, image: Pick<ImageContent, "data" | "mimeType">, sourcePath?: string): string;
+/** Native counterpart of {@link linkedImageText}: a span linking to the image's file when one exists. */
+export declare function linkedImageSpan(text: string, image: Pick<ImageContent, "data" | "mimeType">, sourcePath: string | undefined, s?: string): TspSpan;
 export {};

package/dist/types/prompt/internal-url-autocomplete.d.ts

@@ -31,6 +31,7 @@ export interface InternalUrlCallerContext {
     cwd?: string;
     sessionFile?: string;
     sessionId?: string;
+    seanceSourceArtifactsDir?: string;
 }
 /**
  * Suggestions for the internal-url token ending at the cursor, or `null` when

package/dist/types/prompt/macos-spelling.d.ts

@@ -30,7 +30,8 @@ export declare class MacOSSpellingProvider implements EditorTextAssistProvider {
     decorateTypos(text: string, context: SpellingDecorationContext, decorate?: (span: string) => string): string;
     /**
      * Misspelled prose ranges in `text` (offsets into it), in order and
-     * non-overlapping. Schedules the verification check for uncached text; its
+     * non-overlapping, except ones touching `context.typing` (the word still
+     * being typed). Schedules the verification check for uncached text; its
      * result arrives through {@link onUpdate}.
      */
     typoRanges(text: string, context: SpellingDecorationContext): readonly native.SpellingRange[];

package/dist/types/prompt/prose-gate.d.ts

@@ -1,9 +1,12 @@
+import type { TypingWord } from "./typing-word.js";
 /** Logical source location for one rendered editor segment. */
 export interface SpellingDecorationContext {
     editorText: string;
     lines: readonly string[];
     line: number;
     startCol: number;
+    /** The word being typed: typo marks touching it wait until the caret leaves it. */
+    typing?: TypingWord | undefined;
 }
 /**
  * Whether `text[start, end)` is a prose word: unmasked by {@link maskNonProse},

package/dist/types/prompt/queued-messages.d.ts

@@ -10,7 +10,7 @@ export interface QueuedMessageGroup {
  * Messages queued while the agent works, above the editor. ANSI: a heading
  * per group, numbered dim rows and the dequeue hint. Natively (§8.1): a
  * stack of pills, each `corner-down-right` · the text · `⌥↑ Edit`, the total
- * count in the first pill when more than one waits; the edit control sends
+ * (`N queued`, not a position) in the first pill when more than one waits; the edit control sends
  * `queue.edit`, answered like the dequeue key.
  */
 export declare class QueuedMessagesBand extends Container {

package/dist/types/prompt/typing-word.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The word being typed in the composer. Misspelling marks hold off on it until
+ * the caret leaves it (a space or punctuation, a caret move, losing focus), the
+ * way Slack and Chromium mark a typo only once its word is done; marks on other
+ * words stay while typing.
+ */
+/** A word of one logical line, as UTF-16 columns `[start, end)`. */
+export interface TypingWord {
+    line: number;
+    start: number;
+    end: number;
+}
+/** Follows an editor's text revision and caret to know which word is being typed. */
+export declare class TypingWordTracker {
+    #private;
+    /** The word being typed, if any. */
+    get word(): TypingWord | undefined;
+    /**
+     * Catch up with the editor: an edit that leaves the caret in (or right after)
+     * a word starts typing it; a caret move out of that word, or losing focus,
+     * ends it. The first call only records the revision, so a restored draft is
+     * not held. Returns whether the held word changed.
+     */
+    update(revision: number, lines: readonly string[], line: number, col: number, focused: boolean): boolean;
+}

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

@@ -1,5 +1,19 @@
 import type { DescribeContext, NativeNode } from "../native/node.js";
 import type { Component } from "../tui.js";
+/** Catalogue keys (`tip${line}`) of every tips.txt line, in file order. The
+ *  host needs them to gate a tip by the product feature it advertises. */
+export declare const TIP_CATALOGUE_KEYS: readonly string[];
+/**
+ * Host-installable tip gate: receives the tip's catalogue key and its raw
+ * tips.txt line; returning false removes it from the splash pool.
+ */
+export type TuiTipFilter = (key: string, raw: string) => boolean;
+/**
+ * Install the host's tip gate (pass `undefined` to reset). Consulted for every
+ * candidate on every pick, so no roll can surface a rejected tip — used when a
+ * feature a tip advertises is switched off by configuration.
+ */
+export declare function setTuiTipFilter(filter: TuiTipFilter | undefined): void;
 /** Pick a tip from `tips`, biased toward "[NEW]" tips by {@link NEW_TIP_WEIGHT};
  *  `r` is a uniform sample in [0, 1). Returns "" when `tips` is empty.
  *  Exported for tests. */
@@ -13,10 +27,11 @@ export declare function pickWeightedTip(tips: readonly string[], r: number): str
  */
 export declare function renderWelcomeTip(tip: string, width: number, phase?: number, isNew?: boolean): string[];
 /**
- * The session's welcome banner. In a terminal: the gradient logo beside the
- * `zeta` wordmark with the version under it (the logo alone when the lockup does
+ * The session's welcome banner. In a terminal: the gradient mark beside the
+ * `Zeta` wordmark, with the version under the wordmark and the `Linxira-Zeta`
+ * identity subline centered below the pair (the mark alone when the lockup does
  * not fit) and the tip of the session (dropped below {@link TIP_MIN_COLUMNS}
- * columns). Natively: a card with the same logo, wordmark, version and tip
+ * columns). Natively: a card with the same mark, wordmark, version and tip
  * ({@link WelcomeComponent.describe}).
  */
 export declare class WelcomeComponent implements Component {
@@ -28,7 +43,8 @@ export declare class WelcomeComponent implements Component {
     /**
      * A `card` (`zeta.welcome`) mirroring the terminal banner: the lockup
      * (`zeta.welcome.lockup`: the terminal's builtin `zeta` mark, which it animates,
-     * beside the wordmark with the version under it) and the tip of the session.
+     * beside the `Zeta` wordmark with the version and the `Linxira-Zeta`
+     * subline under it) and the tip of the session.
      * Roles carry the look (gradient logo, type scale); a "[NEW]" tip
      * carries a terminal-clocked shimmering tag.
      */
@@ -53,9 +69,13 @@ export declare class WelcomeComponent implements Component {
     setVersion(version: string): void;
     render(termWidth: number): readonly string[];
 }
-/** Block-grid brand mark shared by the welcome and setup surfaces. */
+/** Brand mark: FIGlet `ANSI Shadow` render of `Z` (generated). */
 export declare const ZETA_LOGO: string[];
-/** The block-grid brand mark as accent lines; `shimmer` declares the terminal-clocked shine sweep. */
+/** Primary product name: FIGlet `ANSI Shadow` render of `Zeta` (generated). */
+export declare const ZETA_WORDMARK: string[];
+/** Secondary identity line: FIGlet `mini` render of `Linxira-Zeta` (generated). */
+export declare const ZETA_SUBLINE: string[];
+/** The generated brand mark as accent lines; `shimmer` declares the terminal-clocked shine sweep. */
 export declare function logoNode(lines: readonly string[], shimmer: boolean): NativeNode;
 export interface ShineConfig {
     /** Overall opacity of the shine overlay, in [0, 1]. */

package/dist/types/render/hanging-wrap.d.ts

@@ -0,0 +1,7 @@
+import type { Theme } from "../theme/theme.js";
+/** Wrap content under a distinct first-row prefix, preserving its column on continuation rows. */
+export declare function wrapPrefixedLine(prefix: string, continuationPrefix: string, content: string, width: number): string[];
+/** Preserve a tree connector's ancestor guides while hanging a long node beneath its label. */
+export declare function wrapTreeLine(line: string, width: number, theme: Theme): string[] | undefined;
+/** Hang a tree row beneath its connector, or a connector-less detail row beneath its guide rails. */
+export declare function wrapGuidedLine(line: string, width: number, theme: Theme): string[];

package/dist/types/render/hyperlink.d.ts

@@ -70,6 +70,8 @@ export declare function urlHyperlinkAlways(url: string, displayText: string): st
  * Non-HTTP(S) or unparsable URLs yield a plain span.
  */
 export declare function urlLinkSpan(target: string, displayText: string, s?: string): TspSpan;
+/** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
+export declare function isNativeLinkEnabled(): boolean;
 /**
  * A native link span to a filesystem path as a plain `file://` URI (the
  * terminal opens it through the system; the location stays in the visible

package/dist/types/render/render-utils.d.ts

@@ -105,14 +105,22 @@ export declare function cappedHeadLines(lines: readonly string[], max: number):
 };
 /** Get the first nonblank preview lines, trimmed and width-capped. */
 export declare function getPreviewLines(text: string, maxLines: number, maxLineLen: number, ellipsis?: Ellipsis): string[];
+/** Collapse a possibly multi-line string into one line; whitespace runs (tabs included) become one space. */
+export declare function flattenLine(text: string): string;
 /**
  * Collapse a possibly multi-line string into a single line, then truncate it to
  * `maxWidth` display cells. {@link truncateToWidth} alone caps width but
  * newlines are zero-width, so multi-line content (markdown briefs, tool args,
  * provider errors) would otherwise spill a single status row across several
- * visual lines. Whitespace runs collapse to one space, so tabs are handled too.
+ * visual lines.
  */
 export declare function previewLine(text: string, maxWidth: number, ellipsis?: Ellipsis): string;
+/**
+ * Clip a result row to `maxWidth` only while collapsed. Expanded rows stay whole
+ * so the frame wraps them: the expand key ({@link formatExpandHint}) must reveal
+ * text, not re-clip it.
+ */
+export declare function clipCollapsed(text: string, maxWidth: number, expanded: boolean | undefined): string;
 /**
  * Extract domain from URL, stripping www. prefix.
  */

package/dist/types/render/utils.d.ts

@@ -32,7 +32,7 @@ export interface RenderCache {
     lines: string[];
 }
 /** Build indentation and continuing branches for ancestor levels. */
-export declare function buildTreePrefix(ancestors: boolean[], theme: Theme): string;
+export declare function buildTreePrefix(ancestors: readonly boolean[], theme: Theme): string;
 /** Return the branch glyph for a final or continuing tree item. */
 export declare function getTreeBranch(isLast: boolean, theme: Theme): string;
 /** Return the continuation prefix for subsequent lines of a tree item. */

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

@@ -3,11 +3,12 @@ export declare const SETUP_SPLASH_MS = 2600;
 export declare const SETUP_TICK_MS = 33;
 export declare function renderStarfield(width: number, height: number, frame: number): string[];
 /**
- * Animated setup splash, in the spirit of the Zeta visual identity: the brand ζ
- * mark rendered with the live diagonal gradient + shine sweep, rising out of a
- * rippling, gradient-lit water surface, under a faint twinkling starfield. The
- * mark and water share one continuous gradient so the sweep reads across the
- * whole scene; the water surface drifts each frame.
+ * Animated setup splash, in the spirit of the Zeta visual identity: the brand
+ * mark — the FIGlet-rendered Latin `Z`, the ASCII form of `Ζ` — with the live
+ * diagonal gradient + shine sweep, rising out of a rippling, gradient-lit water
+ * surface, under a faint twinkling starfield. The mark and water share one
+ * continuous gradient so the sweep reads across the whole scene; the water
+ * surface drifts each frame.
  */
 export declare function renderSetupSplash(width: number, height: number, elapsedMs: number): string[];
 /**

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

@@ -98,6 +98,7 @@ export interface CompactionBoundaries {
 export declare function computeCompactionBoundaries(compactionSettings: CompactionSettings, contextWindow: number, speculationLeadTokens?: number): CompactionBoundaries | null;
 /** Stable inputs used to cache non-message token estimates. */
 export interface NonMessageTokenSource {
+    readonly model?: Model;
     readonly systemPrompt?: readonly string[];
     readonly agent?: {
         readonly state?: {
@@ -137,6 +138,8 @@ export declare function invalidateToolSchemaMetadata(tools: ToolSchemaSource): v
  * {@link invalidateToolSchemaMetadata} when those inputs change.
  */
 export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, sourceRevision?: number): number;
+/** Count schemas carried on every request, excluding server-side deferred catalogs. */
+export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, sourceRevision?: number): number;
 export declare function computeNonMessageTokens(session: NonMessageTokenSource, tokenizer: Tokenizer, sourceRevision?: number): number;
 /**
  * Shared helper for the four non-message token totals used by
@@ -155,7 +158,7 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
-/** The `/context` title: the model and its window once a model is selected. */
+/** The `/context` title: the model once one is selected (the body leads with its window). */
 export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
 /**
  * Native context-usage panel for terminals without `meter`: the cell grid as

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

@@ -97,11 +97,13 @@ export interface FooterSession {
     autoResolvedThinkingLevel(): string | undefined;
     getContextUsage: StatusLineSession["getContextUsage"];
     modelRegistry: Pick<StatusLineSession["modelRegistry"], "isUsingOAuth">;
+    /**
+     * Cumulative session rollup. Unlike the active-window stats it spans every
+     * entry in the session, so compaction does not reset the counters, and it
+     * folds in usage carried by completed `task` tool results.
+     */
     sessionManager: {
-        getEntries(): readonly {
-            type: string;
-            message?: AgentMessage;
-        }[];
+        getUsageStatistics: StatusLineSession["sessionManager"]["getUsageStatistics"];
     };
 }
 /**

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

@@ -1,11 +1,11 @@
 /**
  * Status line for the speculative first frame, before any session exists.
  *
- * InteractiveMode persists {@link StatusLineStartupData} (settings plus the last
- * session's model and thinking state); the next launch renders it through the
- * real {@link StatusLineComponent} as a fresh, unnamed session at the live
- * terminal width. Path and git branch are read live; context usage is reported
- * unknown so the gauge shows the window without a percent.
+ * InteractiveMode persists {@link StatusLineStartupData} (settings plus the
+ * resolved default role model and status inputs); the next launch renders it
+ * through the real {@link StatusLineComponent} as a fresh, unnamed session at
+ * the live terminal width. Path and git branch are read live; context usage is
+ * reported unknown so the gauge shows the window without a percent.
  *
  * @example
  * ```ts ignore
@@ -22,7 +22,7 @@ import type { StatusLineSettings } from "./types.js";
 export interface StatusLineStartupData {
     readonly settings: StatusLineSettings;
     readonly gitEnabled: boolean;
-    /** Model of the last session; the next fresh session usually starts on it too. */
+    /** Model resolved for the next fresh session's default role. */
     readonly model?: Model;
     readonly thinkingLevel?: ThinkingLevel;
     readonly autoThinking: boolean;

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

@@ -31,6 +31,9 @@ export interface CollabStatus {
     stateOverride?: CollabSessionState | null;
 }
 export interface StatusLineSegmentOptions {
+    pi?: {
+        showProfile?: boolean;
+    };
     model?: {
         showThinkingLevel?: boolean;
     };

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

@@ -61,6 +61,13 @@ export type StdinBufferEventMap = {
 export declare class StdinBuffer extends EventEmitter<StdinBufferEventMap> {
     #private;
     constructor(options?: StdinBufferOptions);
+    /**
+     * Whether a bracketed paste has started and its end marker has not arrived.
+     * Terminal skips its per-read DEC 2004 reassertion meanwhile: the host is
+     * evidently in bracketed-paste mode, and a paste delivered one key record
+     * per read would otherwise cost one terminal write per pasted key (#15757).
+     */
+    get pasting(): boolean;
     process(data: string | Buffer): void;
     /**
      * Gate unbracketed raw-paste classification on event-loop responsiveness.

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

@@ -1,6 +1,13 @@
 import type { HangulCompatibilityJamoWidth } from "./utils.js";
 export * from "./terminal-multiplexer.js";
 export { wrapTmuxPassthrough } from "./tmux.js";
+/**
+ * Trusted terminal background when reported; otherwise black for detected dark
+ * appearance or white for detected light appearance, using theme auto-detection.
+ */
+export declare function getTerminalBackgroundColor(): number;
+/** Store an OSC 11 background, or reset to appearance detection (also for tests). */
+export declare function setTerminalBackgroundColor(color: number | undefined): void;
 export declare enum ImageProtocol {
     Kitty = "\u001B_G",
     Iterm2 = "\u001B]1337;File=",
@@ -339,6 +346,14 @@ export interface ParsedKittyPlacementLine {
  * callers fall back to writing the line verbatim.
  */
 export declare function parseKittyDirectPlacementLine(line: string): ParsedKittyPlacementLine | null;
+/**
+ * Rows above its own line that an {@link Image} direct-placement line paints
+ * over: the `CUU(rows-1)` of its lead-in, or 0 for any other line. The renderer
+ * erases those rows before a SIXEL/iTerm2 block is written again, because
+ * those protocols have no delete command and the block's reserved rows are
+ * byte-identical between frames, so the diff never rewrites them.
+ */
+export declare function directPlacementLift(line: string): number;
 /**
  * Rebuild an {@link Image} direct-placement line for the viewport row it is
  * written at. The component-rendered line encodes `CUU(rows-1)`, which clamps
@@ -397,7 +412,7 @@ export declare function getImageDimensions(base64Data: string, mimeType: string)
  * thread; `null` when the encode fails. For output that cannot wait for an
  * off-thread encode.
  */
-export declare function encodeSixelNow(base64Data: string, widthPx: number, heightPx: number): string | null;
+export declare function encodeSixelNow(base64Data: string, widthPx: number, heightPx: number, backgroundRgb?: number): string | null;
 export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): {
     sequence?: string;
     lines?: string[];

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

@@ -38,6 +38,7 @@ declare const registry: readonly [{
         readonly passthrough: typeof import("./tmux.js").wrapTmuxPassthrough;
         readonly settleMs: 100;
     };
+    readonly gatesBracketedPaste: true;
     readonly expandsRepPadding: true;
     readonly expiresSynchronizedOutput: true;
     readonly altRestoreEndsSynchronizedOutput: true;
@@ -100,6 +101,12 @@ export declare function hasTerminalMultiplexerSession(multiplexer: TerminalMulti
  * order. Nested sessions all appear; TERM is not consulted.
  */
 export declare function terminalMultiplexerSessions(env?: NodeJS.ProcessEnv): TerminalMultiplexerModule<TerminalMultiplexer>[];
+/**
+ * Whether OSC 11 background replies are trusted on this platform. Any active
+ * session with `backgroundQueryBrokenOn` matching the platform makes the entire
+ * path untrusted; TERM-only classification does not identify an active session.
+ */
+export declare function isTerminalBackgroundQueryTrusted(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
 /**
  * The multiplexer TERM names, whether or not its session markers survived.
  * This is classification's TERM fallback; session markers are not consulted.