@oh-my-pi/pi-tui 18.3.2 → 18.3.4

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## [Unreleased]
 
+## [18.3.3] - 2026-09-27
+
+### Added
+
+- Added responsive ghost-text word completion with pluggable backend providers, context-aware prose filtering, and feedback support.
+- Improved autocomplete responsiveness for high-latency file discovery by showing interim suggestions and a searching state while results are refreshed.
+
+### Changed
+
+- Improved word-completion acceptance and persistence when typing through existing ghost text, including more natural handling of trailing spaces and punctuation.
+- Made keyboard labels across the TUI platform-aware so shortcuts are displayed using the appropriate key names for the user's operating system.
+- Updated the process monitor to distinguish target scope from current and global scope in its labels.
+
+### Fixed
+
+- Fixed autocomplete submission so Enter commits the current input correctly while suggestions are still loading.
+- Fixed the background tint for truncated skip lines.
+
+### Removed
+
+- Removed the legacy TinyTitleDownloadProgress overlay in favor of the centralized agent HUD.
+
 ## [18.3.1] - 2026-09-25
 
 ### Breaking Changes

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

@@ -372,24 +372,9 @@ export declare class KeybindingsManager extends TuiKeybindingsManager {
      * Get the effective resolved bindings (defaults + user overrides).
      */
     getEffectiveConfig(): KeybindingsConfig;
-    /**
-     * Get display string for a keybinding (e.g., "ctrl+c/escape").
-     */
+    /** Display string for a keybinding's keys (see {@link formatKeyHints}); empty when unbound. */
     getDisplayString(keybinding: Keybinding): string;
 }
-/** Pin the platform used to render modifier labels (test seam). */
-export declare function setKeyHintPlatform(platform: NodeJS.Platform | undefined): void;
-/** Platform currently used for key-hint rendering. */
-export declare function keyHintPlatform(): NodeJS.Platform;
-type Modifier = "ctrl" | "shift" | "alt" | "super";
-/**
- * Human label for a modifier, using each platform's own key names. `ctrl` and
- * `shift` are the same everywhere; `alt`/`super` become `Option`/`Cmd` on macOS.
- */
-export declare function modifierLabel(mod: Modifier, platform?: NodeJS.Platform): string;
-/** Format a key chord with human-readable, platform-aware modifier labels. */
-export declare function formatKeyHint(key: KeyId): string;
-/** Format alternative key chords as slash-separated human-readable hints. */
-export declare function formatKeyHints(keys: KeyId | KeyId[]): string;
+export * from "./key-hint-format.js";
 export type { Keybinding, KeybindingsConfig, KeyId };
 export { migrateKeybindingsConfigFile };

package/dist/types/autocomplete.d.ts

@@ -15,6 +15,12 @@ export declare function findTrailingSlashCommandStart(text: string): number | nu
 export declare function isDirectoryCompletionValue(value: string): boolean;
 /** Ranked-tier subsequence match ("wig" ~ "skill:wig"); distinct from fuzzy.ts's word-local engine. */
 export declare function subsequenceMatch(query: string, target: string): boolean;
+/**
+ * Whether an `@` file completion `value` still fits the live `@` token.
+ * The editor narrows a stale `@` list with this while a fresh search runs;
+ * mirrors the subsequence filter `getSuggestions` applies to fuzzy results.
+ */
+export declare function atCompletionMatches(token: string, value: string): boolean;
 /** Ranked-tier subsequence score (100/80/60/40−gaps·5); higher is better, 0 is no match. */
 export declare function subsequenceScore(query: string, target: string): number;
 export interface AutocompleteItem {
@@ -43,8 +49,14 @@ export interface SlashCommand {
     getInlineHint?(argumentText: string): string | null;
 }
 export interface AutocompleteProvider {
-    /** Get autocomplete suggestions for current text/cursor position. Expensive providers SHOULD stop when `signal` aborts. */
-    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal): Promise<{
+    /**
+     * Get autocomplete suggestions for current text/cursor position. Expensive providers SHOULD stop when `signal` aborts.
+     * Slow providers MAY report interim suggestions through `onPartial` before resolving; the resolved value supersedes them.
+     */
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal, onPartial?: (suggestions: {
+        items: AutocompleteItem[];
+        prefix: string;
+    }) => void): Promise<{
         items: AutocompleteItem[];
         prefix: string;
     } | null>;
@@ -114,7 +126,10 @@ export declare function midPromptSkillTokenMatches(lowerToken: string, name: str
 export declare class CombinedAutocompleteProvider implements AutocompleteProvider {
     #private;
     constructor(commands?: CommandEntry[], basePath?: string, options?: CombinedAutocompleteOptions);
-    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal): Promise<{
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal, onPartial?: (suggestions: {
+        items: AutocompleteItem[];
+        prefix: string;
+    }) => void): Promise<{
         items: AutocompleteItem[];
         prefix: string;
     } | null>;

package/dist/types/chrome/keybinding-hints.d.ts

@@ -1,15 +1,24 @@
 /**
  * Utilities for formatting keybinding hints in the UI.
  */
-import { type Keybinding } from "../keybindings.js";
-import { type AppKeybinding, type KeybindingsManager } from "../app-keybindings.js";
+import { type KeyId, type Keybinding } from "../keybindings.js";
+import { type AppKeybinding, type KeyName, type KeybindingsManager } from "../app-keybindings.js";
 /**
- * Get display string for an editor action.
+ * Primary (first) key bound to an editor action, formatted for footer hints;
+ * empty when unbound. Full alternatives: `formatKeyHints(getKeybindings().getKeys(action))`.
  */
 export declare function editorKey(action: Keybinding): string;
+/** Primary keys of several actions, slash-joined: `editorKeys("tui.select.up", "tui.select.down")` → `↑/↓`. */
+export declare function editorKeys(...actions: Keybinding[]): string;
 /**
- * Get display string for an app action.
+ * Keys bound to `action`, or `fallback` when the active registry has none — a
+ * TUI-only registry carries no `app.*` bindings. Mirrors the fallbacks in
+ * `keybinding-matchers.ts`, so hints name the keys the matcher accepts.
  */
+export declare function boundKeys(action: Keybinding, fallback: readonly KeyId[]): readonly KeyId[];
+/** Primary interrupt key (`app.interrupt`, raw Escape when unbound, as `matchesAppInterrupt`). */
+export declare function interruptKey(): string;
+/** Primary key bound to an app action (see {@link editorKey}); all keys: `getDisplayString`. */
 export declare function appKey(keybindings: KeybindingsManager, action: AppKeybinding): string;
 /**
  * Format a keybinding hint with consistent styling: dim key, muted description.
@@ -31,10 +40,7 @@ export declare function keyHint(action: Keybinding, description: string): string
  */
 export declare function appKeyHint(keybindings: KeybindingsManager, action: AppKeybinding, description: string): string;
 /**
- * Format a raw key string with description (for non-configurable keys like ↑↓).
- *
- * @param key - Raw key string
- * @param description - Description text
- * @returns Formatted string with dim key and muted description
+ * Format a hint for fixed (non-configurable) keys, e.g. `rawKeyHint(["up", "down"], "navigate")`.
+ * Alternatives render slash-separated (see {@link formatKeyHints}).
  */
-export declare function rawKeyHint(key: string, description: string): string;
+export declare function rawKeyHint(keys: KeyName | readonly KeyName[], description: string): string;

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

@@ -53,6 +53,12 @@ export interface EditorTextDecorationContext {
 export interface EditorTextAssistProvider {
     /** Return ghost-text suffix for the partial word at the cursor, or `null`. */
     getWordCompletion?(lines: string[], cursorLine: number, cursorCol: number): string | null;
+    /**
+     * Report the fate of the ghost-text `suggestion` shown at the cursor:
+     * `accepted` (Tab/→) or typed past (a typed character diverged from it).
+     * Called with the editor state the suggestion was shown for.
+     */
+    wordCompletionFeedback?(lines: string[], cursorLine: number, cursorCol: number, suggestion: string, accepted: boolean): void;
     /** Return a correction after one single-character insertion, or `null`. */
     tryAutocorrect?(lines: string[], cursorLine: number, cursorCol: number): EditorInlineReplacement | null | Promise<EditorInlineReplacement | null>;
     /** Return replacement candidates for the misspelled word at the cursor. */
@@ -103,6 +109,11 @@ export declare class Editor implements Component, Focusable {
     onLargePaste?: (text: string, lineCount: number, options: PasteOptions) => boolean;
     onAutocompleteCancel?: () => void;
     disableSubmit: 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
+     *  it from live state. */
+    placeholder?: () => string | undefined;
     constructor(theme: EditorTheme);
     /** Return bounded editor content, cursor, and transient child state for debug inspection. */
     debugState(): Record<string, unknown>;

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

@@ -0,0 +1,29 @@
+/**
+ * Key-hint formatting, kept free of the native addon: it imports only types
+ * plus the theme symbol mirror, so addon-free CLI paths (`omp --version`,
+ * help text in cli/command-help.ts) can format keys without loading
+ * `@oh-my-pi/pi-natives` through the keybindings registry.
+ */
+import type { KeyId } from "./keybindings.js";
+import type { ModifierName } from "./keys.js";
+/** Pin the platform used to render modifier labels (test seam). */
+export declare function setKeyHintPlatform(platform: NodeJS.Platform | undefined): void;
+/** Platform currently used for key-hint rendering. */
+export declare function keyHintPlatform(): NodeJS.Platform;
+/** A displayable key: a chord, or a bare modifier for "hold ⇧" style hints. */
+export type KeyName = KeyId | ModifierName;
+/**
+ * Format one key for display: `"ctrl+shift+c"` → `⌃⇧C` (macOS) / `Ctrl+⇧C`,
+ * `"escape"` → `⎋`, `"alt+up"` → `⌥↑` / `Alt+↑`, `"shift"` → `⇧`.
+ * A glyph modifier is followed by the preset's `key.joiner` (nothing in
+ * unicode, a space in nerd, whose icons blur together when adjacent); a word
+ * modifier takes a `+`. Modifiers
+ * render in canonical order whatever the binding says (`shift+ctrl+p` → `⌃⇧P`).
+ * A bare letter stays lowercase (`q`) since `Q` would read as ⇧Q; in a chord it
+ * is capitalized. Other keys are capitalized (`f5` → `F5`).
+ */
+export declare function formatKeyHint(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. */
+export declare function formatDoubleTap(key: KeyName): string;

package/dist/types/keys.d.ts

@@ -45,7 +45,8 @@ type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
 type KeySymbol = "`" | "-" | "=" | "[" | "]" | "\\" | ";" | "'" | "," | "." | "/" | "!" | "@" | "#" | "$" | "%" | "^" | "&" | "*" | "(" | ")" | "_" | "+" | "|" | "~" | "{" | "}" | ":" | "<" | ">" | "?";
 type SpecialKey = "escape" | "esc" | "enter" | "return" | "tab" | "space" | "backspace" | "delete" | "insert" | "clear" | "home" | "end" | "pageUp" | "pageDown" | "up" | "down" | "left" | "right" | "f1" | "f2" | "f3" | "f4" | "f5" | "f6" | "f7" | "f8" | "f9" | "f10" | "f11" | "f12";
 type BaseKey = Letter | Digit | KeySymbol | SpecialKey;
-type ModifierName = "ctrl" | "shift" | "alt" | "super";
+/** Modifier key names as they appear in {@link KeyId} chords. */
+export type ModifierName = "ctrl" | "shift" | "alt" | "super";
 type ModifiedKeyId<Key extends string, RemainingModifiers extends ModifierName = ModifierName> = {
     [M in RemainingModifiers]: `${M}+${Key}` | `${M}+${ModifiedKeyId<Key, Exclude<RemainingModifiers, M>>}`;
 }[RemainingModifiers];

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

@@ -17,7 +17,7 @@ import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import { Container, type TUI } from "../tui.js";
 import { type SelectListMouseTarget } from "../mouse.js";
 import { type AgentActivitySource } from "./agent-activity.js";
-import type { KeyId } from "../app-keybindings.js";
+import { type KeyId } from "../app-keybindings.js";
 import type { MessageRenderer } from "../chat/extension-types.js";
 import type { AgentLifecycleLike, IrcBusLike } from "./agent-hub-types.js";
 import { type AgentRecordLike, type AgentHubRegistry } from "./agent-hub-types.js";

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

@@ -16,7 +16,7 @@
 import type * as fs from "node:fs";
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import type { Component, TUI } from "../tui.js";
-import type { KeyId } from "../app-keybindings.js";
+import { type KeyId } from "../app-keybindings.js";
 import type { MessageRenderer } from "../chat/extension-types.js";
 import type { AgentLifecycleLike } from "./agent-hub-types.js";
 import type { AgentHubRegistry } from "./agent-hub-types.js";

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

@@ -51,10 +51,8 @@ export interface ModelPickerOptions {
     quickRoleOrder?: ReadonlyArray<string>;
     /** Active quick role, highlighted when the search begins with `@`. */
     currentQuickRole?: string;
-    /** Keys that toggle task-subagent mode while the picker is open; typically the alt+p binding. */
+    /** Keys that toggle task-subagent mode while the picker is open; the first is shown in the footer. */
     taskModeKeys?: readonly KeyId[];
-    /** Human-readable label for the toggle key, shown in footer hints (e.g. "alt+p"). */
-    taskModeKeyLabel?: string;
     /** `provider/id` highlighted and preselected in task mode (current Task subagent model). */
     taskSelector?: string;
 }

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

@@ -0,0 +1,42 @@
+/**
+ * Composer hints: the right-aligned placeholder shown in the empty composer to
+ * surface gestures that matter right now (e.g. background agents are running).
+ *
+ * Hints are checked in priority order; the first one that applies wins. A hint
+ * retires for good once the user has performed its gesture
+ * {@link ComposerHint.learnedAfter} times — the host records each use under the
+ * hint's id and reports counts through {@link ComposerHintContext.uses}.
+ *
+ * Add a hint by appending to {@link COMPOSER_HINTS}, extending
+ * {@link ComposerHintId}, and recording the gesture where it is handled.
+ */
+import { type KeybindingsManager } from "../app-keybindings.js";
+/** Stable hint ids; persisted as usage-counter keys, so never rename one. */
+export type ComposerHintId = "agents" | "effort";
+/** Live state that hint conditions read. Built by the host on every render of the empty composer. */
+export interface ComposerHintContext {
+    /** Subagents currently running in the background. */
+    runningAgents: number;
+    /** The view is focused on a subagent session instead of the main one. */
+    focusedOnAgent: boolean;
+    /** The viewed session already has messages. */
+    conversationStarted: boolean;
+    keybindings: KeybindingsManager;
+    /** Times the user has performed the gesture a hint teaches. */
+    uses(id: ComposerHintId): number;
+}
+/** A gesture tip: `key` renders highlighted, `label` describes what it does. */
+export interface ComposerHint {
+    id: ComposerHintId;
+    /** Uses of the gesture after which the hint stops showing. */
+    learnedAfter: number;
+    /** Key and label when the hint applies, otherwise `undefined`. */
+    resolve(ctx: ComposerHintContext): {
+        key: string;
+        label: string;
+    } | undefined;
+}
+/** Registered hints, highest priority first. */
+export declare const COMPOSER_HINTS: readonly ComposerHint[];
+/** Render the highest-priority applicable, not-yet-learned hint, if any. */
+export declare function resolveComposerHint(ctx: ComposerHintContext): string | undefined;

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

@@ -1,6 +1,7 @@
 import { type Terminal } from "../terminal.js";
 import { type Component, type ResizeScrollbackMode, type TerminalFramePlan, type TerminalFrameProvider, TUI, type TUIOptions, type ViewportSize } from "../tui.js";
 import { CustomEditor } from "./custom-editor.js";
+import type { WordCompletionMethod } from "./word-completion.js";
 import { type LspServerInfo, type RecentSession, WelcomeComponent } from "./welcome.js";
 /** Live settings that affect the composer before and after session adoption. */
 export interface ComposerPreferences {
@@ -12,7 +13,7 @@ export interface ComposerPreferences {
     readonly imeSafeCursor: boolean;
     readonly autocompleteMaxVisible: number;
     readonly spellingTypoDetection: boolean;
-    readonly spellingAutocomplete: boolean;
+    readonly spellingAutocomplete: WordCompletionMethod;
     readonly spellingAutocorrect: boolean;
 }
 /** Settings-schema-compatible defaults used when constructing a dependency-free composer. */

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

@@ -4,7 +4,13 @@ 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";
+import { type MacOSSpellingFeatures } from "./macos-spelling.js";
+import { type WordCompletionMethod } from "./word-completion.js";
+/** Independently switchable prose-assistance features of the composer. */
+export interface SpellingFeatures extends MacOSSpellingFeatures {
+    /** Word-completion engine; `off` disables ghost text. */
+    autocomplete: WordCompletionMethod;
+}
 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">;
 /**
  * Extract image-or-other file paths from plain (un-bracketed) clipboard text.
@@ -114,7 +120,7 @@ export declare class CustomEditor extends Editor {
      * keep working.
      */
     constructor(...args: readonly unknown[]);
-    /** Independently configure typo detection, word autocomplete, and autocorrect. */
+    /** Independently configure typo detection, the word-completion engine, and autocorrect. */
     setSpellingFeatures(features: SpellingFeatures): void;
     /** Clear the composer draft: optionally commit `historyText` to history, then
      *  reset the editor text and all pending draft-image state. The shared tail of

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

@@ -1,29 +1,22 @@
 import * as native from "@oh-my-pi/pi-natives";
 import type { EditorInlineReplacement, EditorTextAssistProvider, EditorWordReplacements } from "../components/editor.js";
+import { type SpellingDecorationContext } from "./prose-gate.js";
 /** Independently switchable macOS prose-assistance features. */
-export interface SpellingFeatures {
+export interface MacOSSpellingFeatures {
     typoDetection: boolean;
-    autocomplete: boolean;
     autocorrect: boolean;
 }
-/** Logical source location for one rendered editor segment. */
-export interface SpellingDecorationContext {
-    editorText: string;
-    lines: readonly string[];
-    line: number;
-    startCol: number;
-}
 /** Native spelling operations used by {@link MacOSSpellingProvider}. */
 export interface SpellingBackend {
     isAvailable(): boolean;
     checkSpelling(text: string): Promise<readonly native.SpellingRange[]>;
-    completeWord(text: string, start: number, length: number): Promise<readonly string[]>;
     autocorrectWord(text: string, start: number, length: number): Promise<string | null>;
     spellingGuesses(text: string, start: number, length: number): Promise<readonly string[]>;
 }
 /**
- * Bridges Apple's spelling service into the editor's separate typo,
- * word-completion, and autocorrection paths.
+ * Bridges Apple's spelling service into the editor's typo and autocorrection
+ * paths. Word completion is the cross-platform `WordCompletionProvider`
+ * (`word-completion.ts`).
  */
 export declare class MacOSSpellingProvider implements EditorTextAssistProvider {
     #private;
@@ -31,12 +24,10 @@ export declare class MacOSSpellingProvider implements EditorTextAssistProvider {
     /** Invoked when an asynchronous spelling result can change rendered output. */
     onUpdate: (() => void) | undefined;
     constructor(backend?: SpellingBackend, styledUnderlines?: boolean);
-    /** Apply all three independent feature gates and invalidate rendered typo ranges. */
-    setFeatures(features: SpellingFeatures): void;
+    /** Apply both independent feature gates and invalidate rendered typo ranges. */
+    setFeatures(features: MacOSSpellingFeatures): void;
     /** Add red undercurls to misspellings while preserving visible text width. */
     decorateTypos(text: string, context: SpellingDecorationContext, decorate?: (span: string) => string): string;
-    /** Return the cached macOS completion suffix for the word ending at the cursor. */
-    getWordCompletion(lines: string[], cursorLine: number, cursorCol: number): string | null;
     /** Return the confident macOS correction after a completed prose word. */
     tryAutocorrect(lines: string[], cursorLine: number, cursorCol: number): Promise<EditorInlineReplacement | null>;
     /** Return macOS replacement guesses for the misspelled word at the cursor. */

package/dist/types/prompt/prompt-action-autocomplete.d.ts

@@ -32,7 +32,10 @@ interface PromptActionAutocompleteOptions {
 export declare class PromptActionAutocompleteProvider implements AutocompleteProvider {
     #private;
     constructor(commands: SlashCommand[], basePath: string, actions: PromptActionDefinition[], commandUsage?: (name: string) => number, internalUrlCaller?: () => InternalUrlCallerContext, modelMentions?: ModelMentionCandidateSource);
-    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal): Promise<{
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, signal?: AbortSignal, onPartial?: (suggestions: {
+        items: AutocompleteItem[];
+        prefix: string;
+    }) => void): Promise<{
         items: AutocompleteItem[];
         prefix: string;
     } | null>;

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

@@ -0,0 +1,24 @@
+/** Logical source location for one rendered editor segment. */
+export interface SpellingDecorationContext {
+    editorText: string;
+    lines: readonly string[];
+    line: number;
+    startCol: number;
+}
+/**
+ * Whether `text[start, end)` is a prose word: unmasked by {@link maskNonProse},
+ * not inside a path/identifier-like token, and not on a slash-command or
+ * queue-shorthand line.
+ */
+export declare function isProseWord(text: string, masked: string, start: number, end: number): boolean;
+/** Whole-buffer context for `line`, starting at column 0. */
+export declare function lineContext(lines: readonly string[], line: number): SpellingDecorationContext;
+/**
+ * Memoized whole-buffer prose mask: answers whether a line range is prose in
+ * the context of the full editor text (fenced code spans lines).
+ */
+export declare class ProseSource {
+    #private;
+    /** True when `[startCol, endCol)` of `context.line` is prose and the buffer is within the caps. */
+    isProse(context: SpellingDecorationContext, startCol: number, endCol: number): boolean;
+}

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

@@ -0,0 +1,46 @@
+import type { EditorTextAssistProvider } from "../components/editor.js";
+/** Values of the `spelling.autocomplete` setting. */
+export declare const WORD_COMPLETION_METHODS: readonly ["off", "auto", "ngram", "smollm", "apple"];
+/** Configured word-completion engine; `off` disables ghost text. */
+export type WordCompletionMethod = (typeof WORD_COMPLETION_METHODS)[number];
+/** Whether `value` is a {@link WordCompletionMethod}. */
+export declare function isWordCompletionMethod(value: unknown): value is WordCompletionMethod;
+/** An enabled word-completion engine. */
+export type WordCompletionEngine = Exclude<WordCompletionMethod, "off">;
+/** Asynchronous engine behind ghost-text word completion (coding-agent: the text-prediction daemon). */
+export interface WordPredictionBackend {
+    /** Characters to paint after `prefix` typed after `before`, or `null` to show nothing. */
+    complete(before: string, prefix: string): Promise<string | null>;
+    /** Report a shown suggestion the user accepted (Tab/→) or typed past. Fire-and-forget. */
+    feedback(before: string, prefix: string, suggestion: string, accepted: boolean): void;
+}
+/** Resolves the backend for an engine; `undefined` means none is available (no ghost text). */
+export type WordPredictionBackendResolver = (method: WordCompletionEngine) => WordPredictionBackend | undefined;
+/**
+ * Install the host's backend resolver for every editor, including ones built
+ * before the host finished starting. Pass `undefined` to detach.
+ */
+export declare function setWordPredictionHost(resolver: WordPredictionBackendResolver | undefined): void;
+/**
+ * Ghost-text word completion for the prose word ending at the cursor, served
+ * by an injected asynchronous {@link WordPredictionBackend}.
+ *
+ * Rendering is synchronous, so a cache miss schedules a single-flight backend
+ * request (one active, the newest queued) and repaints through `onUpdate` when
+ * the answer changes what is shown. The previous suggestion is projected: if
+ * its full word still extends what was typed, the remainder shows immediately
+ * and stays until the engine offers a different word.
+ */
+export declare class WordCompletionProvider implements EditorTextAssistProvider {
+    #private;
+    /** Invoked when an asynchronous answer changes the rendered ghost text. */
+    onUpdate: (() => void) | undefined;
+    /** `resolveBackend` defaults to the host installed with {@link setWordPredictionHost}. */
+    constructor(resolveBackend?: WordPredictionBackendResolver);
+    /** Select the engine (`off` disables completion) and drop answers from the previous one. */
+    setMethod(method: WordCompletionMethod): void;
+    /** Return the ghost-text suffix for the prose word ending at the cursor, or `null`. */
+    getWordCompletion(lines: string[], cursorLine: number, cursorCol: number): string | null;
+    /** Forward accept (Tab/→) or typed-past feedback for the suggestion shown at the cursor. */
+    wordCompletionFeedback(lines: string[], cursorLine: number, cursorCol: number, suggestion: string, accepted: boolean): void;
+}

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

@@ -94,7 +94,7 @@ export declare const TRUNCATE_LENGTHS: {
     /** Idle recap status line (~40-word LLM reply) */
     readonly RECAP: 280;
 };
-/** Human-readable key currently bound to tool-output expansion, e.g. `Ctrl+O`. */
+/** Human-readable primary key bound to tool-output expansion, e.g. `Ctrl+O`. */
 export declare function expandKeyHint(): string;
 /** Keep both ends of a single-line label without splitting wide characters. */
 export declare function truncateMiddleToWidth(text: string, maxWidth: number): string;

package/dist/types/theme/active-symbols.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Active theme's symbol lookup without importing `./theme` (which pulls the
+ * native addon through `@oh-my-pi/pi-natives`). Key-hint formatting runs on
+ * CLI paths that must stay addon-free (`omp --version`, help), so it reads the
+ * active theme through this mirror; `./theme` publishes every assignment here.
+ */
+import { type SymbolKey } from "./symbols.js";
+import type { Theme } from "./theme-class.js";
+/** @internal Called by `./theme` whenever the active theme changes. */
+export declare function setActiveSymbolTheme(value: Theme | undefined): void;
+/** Symbol from the active theme, or the ascii preset before any theme loads. */
+export declare function activeThemeSymbol(key: SymbolKey): string;

package/dist/types/theme/symbols.d.ts

@@ -2,7 +2,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.esc" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
 export type SymbolMap = Record<SymbolKey, string>;
 /**
  * Icon vocabulary for slash-command autocomplete type indicators. Each name

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

@@ -213,7 +213,6 @@ export declare class Theme {
         advisorClosed: string;
         time: string;
         omp: string;
-        esc: string;
         ghost: string;
         agents: string;
         job: string;

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

@@ -3,7 +3,7 @@ import type { RenderResultOptions } from "./renderer.js";
 import { type Theme } from "../theme/theme.js";
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import type { OutputMeta } from "./output-meta.js";
-import type { ConfiguredThinkingLevel } from "../render/render-utils.js";
+import { type ConfiguredThinkingLevel } from "../render/render-utils.js";
 /** Runtime backend that an eval cell dispatches to. */
 export type EvalLanguage = "python" | "js";
 /** Status event emitted by eval prelude helpers for TUI rendering. */

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

@@ -48,7 +48,7 @@ export interface MCPResourceContent {
 }
 /** Supported MCP result content blocks retained in display metadata. */
 export type MCPContent = MCPTextContent | MCPImageContent | MCPResourceContent;
-/** Details included in MCP tool results for rendering */
+/** MCP result details shared by renderers and programmatic tool consumers. */
 export interface MCPToolDetails {
     /** Server name */
     serverName: string;
@@ -58,6 +58,8 @@ export interface MCPToolDetails {
     isError?: boolean;
     /** Raw content from MCP response */
     rawContent?: MCPContent[];
+    /** Server-supplied structured data, independent of the model-facing text rendering. */
+    structuredContent?: Record<string, unknown>;
     /** Structured metadata from the MCP response */
     mcpMeta?: Record<string, unknown>;
     /** Provider ID (e.g., "claude", "mcp-json") */

package/dist/types/tools/task-yield-assembly.d.ts

@@ -1,4 +1,11 @@
 import type { YieldItem } from "./task.js";
+/**
+ * Output-schema shape of each declared top-level property, keyed by incremental yield label.
+ * `array` sections accumulate into a list (even a lone yield); `scalar` sections keep the
+ * latest yield, since the schema admits exactly one value. Undeclared labels accumulate
+ * into a list only once repeated.
+ */
+export type YieldSectionShapes = ReadonlyMap<string, "array" | "scalar">;
 /** Outcome of folding a run's yield calls into one payload, with provenance flags. */
 interface AssembledYieldResult {
     data: unknown;
@@ -14,7 +21,8 @@ interface AssembledYieldResult {
  * assistant turn the raw terminal result. Other string-typed yields contribute
  * the terminal labelled section. Untyped terminal yields keep the historical
  * "last yield wins" behavior unless no terminal yield exists, in which case
- * accumulated typed sections finalize on idle.
+ * accumulated typed sections finalize on idle. Repeated sections merge per
+ * `sectionShapes` (see {@link YieldSectionShapes}).
  */
-export declare function assembleYieldResult(yieldItems: YieldItem[], lastAssistantText?: string, arrayLabels?: ReadonlySet<string>): AssembledYieldResult | undefined;
+export declare function assembleYieldResult(yieldItems: YieldItem[], lastAssistantText?: string, sectionShapes?: YieldSectionShapes): AssembledYieldResult | undefined;
 export {};

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

@@ -101,6 +101,8 @@ export interface TaskItem {
     agent?: string;
     /** The work; required by the schema. */
     task?: string;
+    /** How open-ended the work is; required by the schema and the child's sole `auto` thinking classification input. */
+    solutionSpace?: string;
     /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
     effort?: "lo" | "med" | "hi";
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
@@ -125,6 +127,8 @@ export interface TaskParams {
     agent?: string;
     /** The work (flat form). */
     task?: string;
+    /** How open-ended the work is (flat form); see {@link TaskItem.solutionSpace}. */
+    solutionSpace?: string;
     /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
     effort?: "lo" | "med" | "hi";
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */