@oh-my-pi/pi-tui 18.2.4 → 18.2.5

package/dist/types/apps/git/sidebar.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Right sidebar of the git TUI.
+ *
+ * Dirty tree → file management: unstaged/staged sections with stage/unstage
+ * actions plus a commit form (amend toggle, summary input, description
+ * editor, commit button). Clean tree → HEAD commit view: subject, body,
+ * author with avatar photo, parents, and the commit's file list.
+ *
+ * The sidebar is not a TUI component itself: the root composes its rendered
+ * lines and forwards key/mouse input. Every rendered frame records a hit
+ * target per row so mouse clicks resolve against what is actually visible.
+ */
+import { Editor } from "../../components/editor.js";
+import { TextFormField } from "../../components/form.js";
+import { type ImageBudget } from "../../components/image.js";
+import { type AvatarSource } from "./avatar.js";
+import type { ChangedFile, GitViewState } from "./state.js";
+/** Generated conventional commit fields shown in the commit form. */
+export interface GitCommitMessage {
+    type: string;
+    scope?: string | null;
+    summary: string;
+    body: readonly string[];
+}
+/** Actions the sidebar raises to the root component. */
+export type SidebarAction = 
+/** `selection` omitted → whole tree; `label` names the target for the status line. */
+{
+    type: "stage";
+    selection?: {
+        files: ChangedFile[];
+        label: string;
+    };
+} | {
+    type: "unstage";
+    selection?: {
+        files: ChangedFile[];
+        label: string;
+    };
+}
+/** `delete`: throw away the row's changes (a dir batches every file underneath). */
+ | {
+    type: "discard";
+    selection: {
+        files: ChangedFile[];
+        label: string;
+    };
+} | {
+    type: "generate";
+}
+/** Wand pill: AI-filter the unstaged tree against a natural-language prompt. */
+ | {
+    type: "stage-ai";
+    prompt: string;
+} | {
+    type: "commit";
+    message: string;
+    amend: boolean;
+    stageAll: boolean;
+};
+type FileTarget = {
+    kind: "file";
+    file: ChangedFile;
+} | {
+    kind: "dir";
+    key: string;
+};
+/** A foldable file-list section header (unstaged/staged). */
+type SectionTarget = {
+    kind: "section";
+    area: "unstaged" | "staged";
+};
+type Target = FileTarget | {
+    kind: "view-style";
+    style: "path" | "tree";
+} | SectionTarget | {
+    kind: "stage-all";
+} | {
+    kind: "unstage-all";
+} | {
+    kind: "stage-ai";
+} | {
+    kind: "stage-ai-input";
+} | {
+    kind: "amend";
+} | {
+    kind: "summary";
+} | {
+    kind: "description";
+} | {
+    kind: "commit-button";
+};
+/** Sidebar state machine + renderer. */
+export declare class Sidebar {
+    #private;
+    readonly summary: TextFormField;
+    readonly description: Editor;
+    /** "What should we stage?" textbox opened by the unstaged-header wand pill. */
+    readonly aiInput: TextFormField;
+    focused: boolean;
+    amend: boolean;
+    generating: boolean;
+    /** File-list presentation: flat paths or a collapsible directory tree. */
+    viewStyle: "path" | "tree";
+    constructor(options: {
+        model: GitViewState;
+        avatars: AvatarSource;
+        imageBudget?: ImageBudget;
+        onSelectFile: (file: ChangedFile | null) => void;
+        onAction: (action: SidebarAction) => void;
+        onFocusDiff: () => void;
+        requestRender: () => void;
+    });
+    /** Currently selected target, if any. */
+    get selected(): Target | undefined;
+    get selectedFile(): ChangedFile | null;
+    /** Re-sync selection after a model refresh; returns the file to show. */
+    reconcile(): ChangedFile | null;
+    /** Called by the root when pane focus changes. */
+    setFocused(focused: boolean): void;
+    /** Clear the commit form after a successful commit. */
+    clearForm(): void;
+    /** Replace the form with one generated conventional commit. */
+    setGeneratedCommit(commit: GitCommitMessage): void;
+    /** Reflect whether an inference request currently owns the commit form. */
+    setGenerating(generating: boolean): void;
+    /** Escape while the sidebar has focus: blur a text input first. True when consumed. */
+    handleEscape(): boolean;
+    /** True while a commit-form text input is capturing letter keys. */
+    get editing(): boolean;
+    /**
+     * Move selection to the next/previous visible file row. False at the
+     * boundary. `from` anchors the walk at the file currently shown in the
+     * diff pane, so hunk rollover works even when the sidebar selection sits
+     * on a dir row or a commit-form control.
+     */
+    selectAdjacentFile(direction: 1 | -1, from?: ChangedFile | null): boolean;
+    /** Select the commit summary input (the `c` shortcut). False on a clean tree. */
+    focusCommitForm(): boolean;
+    handleInput(data: string): void;
+    /** Wheel scroll over the sidebar. */
+    handleWheel(delta: number): void;
+    /** Left click at sidebar-local coordinates. */
+    handleClick(row: number, col: number): void;
+    render(width: number, height: number): string[];
+    /** Permanently release viewport, form, and avatar resources. */
+    dispose(): void;
+}
+export {};

package/dist/types/apps/git/state.d.ts

@@ -0,0 +1,117 @@
+import type { DiffStreamProgress, DiffStreamResult } from "@oh-my-pi/pi-natives";
+/** Context lines retained around each exact streamed hunk. */
+export declare const DIFF_CONTEXT_LINES = 3;
+/** Change classification shown beside a file path. */
+export type ChangeKind = "modified" | "added" | "deleted" | "renamed" | "untracked" | "conflicted";
+/** Repository area represented by a file list. */
+export type ChangeArea = "unstaged" | "staged" | "commit";
+/** One changed path shown in the sidebar file lists. */
+export interface ChangedFile {
+    readonly path: string;
+    /** Pre-rename path for renames/copies. */
+    readonly origPath?: string;
+    readonly kind: ChangeKind;
+    readonly area: ChangeArea;
+    readonly additions?: number;
+    readonly deletions?: number;
+}
+/** HEAD commit metadata for the clean-tree sidebar view. */
+export interface HeadCommit {
+    readonly sha: string;
+    readonly shortSha: string;
+    readonly subject: string;
+    readonly body: string;
+    readonly authorName: string;
+    readonly authorEmail: string;
+    readonly authorDate: string;
+    readonly parents: readonly string[];
+    /** Changed paths once their numstats have loaded. */
+    readonly files: readonly ChangedFile[];
+    /** Whether {@link files} contains the complete commit file list. */
+    readonly filesLoaded: boolean;
+}
+/** A terminal-ready image decoded from one Git file side. */
+export interface ReviewImage {
+    readonly data: string;
+    readonly mimeType: "image/png";
+    readonly sourceMimeType: string;
+    readonly widthPx: number;
+    readonly heightPx: number;
+    readonly byteLength: number;
+    /** Stable content identity for terminal graphics placement. */
+    readonly key: string;
+    /** Git LFS object id when the preview came from local LFS storage. */
+    readonly lfsOid?: string;
+}
+/** One side of a media or binary Git change. */
+export type FileAssetSide = {
+    readonly kind: "empty";
+} | {
+    readonly kind: "text";
+    readonly byteLength: number;
+    readonly lfsOid?: string;
+} | {
+    readonly kind: "image";
+    readonly image: ReviewImage;
+} | {
+    readonly kind: "binary";
+    readonly byteLength?: number;
+    readonly lfsOid?: string;
+} | {
+    readonly kind: "tooLarge";
+    readonly byteLength?: number;
+    readonly lfsOid?: string;
+} | {
+    readonly kind: "lfsMissing";
+    readonly oid: string;
+    readonly byteLength: number;
+};
+/** Diffable UTF-8 content for both sides of a file. */
+export interface TextFileContents {
+    readonly kind: "text";
+    readonly oldText: string;
+    readonly newText: string;
+    readonly streamResult: DiffStreamResult;
+}
+/** Non-text sides rendered as previews or explicit placeholders. */
+export interface AssetFileContents {
+    readonly kind: "asset";
+    readonly old: FileAssetSide;
+    readonly new: FileAssetSide;
+}
+/** Loaded file content selected for text diffing or asset preview. */
+export type FileContents = TextFileContents | AssetFileContents;
+/** Newly completed lines and state emitted while a file pair streams. */
+export interface FileStreamUpdate {
+    readonly oldLineOffset: number;
+    readonly oldLines: readonly string[];
+    readonly newLineOffset: number;
+    readonly newLines: readonly string[];
+    readonly progress: DiffStreamProgress;
+}
+/** Repository values read by the sidebar. */
+export interface GitViewState {
+    readonly cwd: string;
+    readonly branch: string | null;
+    readonly clean: boolean;
+    readonly unstaged: readonly ChangedFile[];
+    readonly staged: readonly ChangedFile[];
+    readonly headCommit: HeadCommit | null;
+}
+/** Repository operations supplied by the command host. */
+export interface GitTuiModel extends GitViewState {
+    refresh(): Promise<boolean>;
+    loadChangeStats(): Promise<boolean>;
+    loadHeadFiles(): Promise<boolean>;
+    streamContents(file: ChangedFile, onProgress: (update: FileStreamUpdate) => void, signal?: AbortSignal): Promise<FileContents>;
+    stage(files?: readonly ChangedFile[]): Promise<void>;
+    unstage(files?: readonly ChangedFile[]): Promise<void>;
+    discard(files: readonly ChangedFile[]): Promise<void>;
+    commit(message: string, options?: {
+        amend?: boolean;
+    }): Promise<void>;
+    applyPatch(patchText: string, options?: {
+        cached?: boolean;
+        reverse?: boolean;
+    }): Promise<void>;
+}

package/dist/types/apps/if-bench-board.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Live board and scoreboard for `omp if-bench`.
+ *
+ * Interactive terminals get one repainted row per model — a turn ladder that
+ * fills as turns pass, the in-flight turn as a spinner cell, and the live
+ * position of the cat directive — plus a permanent verdict line per model as it
+ * settles. Non-TTY output falls back to one plain line per turn so scripted
+ * callers keep a parseable trace.
+ */
+import { type LiveBoardOutput } from "../chrome/live-board.js";
+/** Failure category displayed in benchmark verdicts. */
+export type IfBenchFailure = "result" | "cat" | "result+cat" | "format" | "provider";
+/** Scored turn fields consumed by the live board and failure details. */
+export interface IfBenchTurnRecord {
+    turn: number;
+    cumulativeActions: number;
+    placement: string;
+    durationMs: number;
+    passed: boolean;
+    failure?: IfBenchFailure;
+    expected: string;
+    response: string;
+}
+/** Per-model scoreboard and verdict fields. */
+export interface IfBenchModelReport {
+    label: string;
+    turns: readonly IfBenchTurnRecord[];
+    turnsPassed: number;
+    actionsPassed: number;
+    failure?: {
+        turn: number;
+        kind: IfBenchFailure;
+    };
+    durationMs: number;
+    outputTokens: number;
+    cost: number;
+}
+/** Benchmark results consumed by the ranked scoreboard. */
+export interface IfBenchSummary {
+    maxTurns: number;
+    models: readonly IfBenchModelReport[];
+}
+/** Optional live-progress callbacks accepted by a benchmark runner. */
+export interface IfBenchObserver<Turn extends IfBenchTurnRecord = IfBenchTurnRecord, Report extends IfBenchModelReport = IfBenchModelReport> {
+    modelStarted?(label: string): void;
+    turnStarted?(label: string, turn: number, actions: number): void;
+    turnFinished?(label: string, record: Turn): void;
+    modelFinished?(report: Report): void;
+}
+/** Rendering surface for one `omp if-bench` run. */
+export interface IfBenchBoard extends IfBenchObserver {
+    readonly interactive: boolean;
+    /** Print a permanent line above the live rows (plain write when non-TTY). */
+    log(text: string): void;
+    /** Clear the live area and restore the cursor. Idempotent. */
+    close(): void;
+}
+/** Static run parameters shown in the board header. */
+export interface IfBenchBoardMeta {
+    maxTurns: number;
+    arrayLength: number;
+    nyaMax: number;
+}
+/**
+ * Create the if-bench board bound to `output`.
+ *
+ * `errors` receives non-TTY failure lines so a piped stdout stays a clean
+ * turn-by-turn trace.
+ */
+export declare function createIfBenchBoard(meta: IfBenchBoardMeta, output?: LiveBoardOutput, errors?: LiveBoardOutput): IfBenchBoard;
+/**
+ * Ranked comparison table: depth first (turns, then actions), latency only as a
+ * tie-break, because surviving one more turn always beats answering faster.
+ */
+export declare function formatIfBenchScoreboard(summary: IfBenchSummary): string;

package/dist/types/apps/live-visualizer.d.ts

@@ -0,0 +1,33 @@
+import type { Component } from "../tui.js";
+import { type KeyId } from "../keys.js";
+/** Distinct states of a realtime call connection. */
+export type LivePhase = "connecting" | "listening" | "working" | "speaking" | "muted" | "error";
+/** Configuration callbacks for user interactions in the visualizer. */
+export interface LiveVisualizerOptions {
+    onStop(): void;
+    onToggleMute(): void;
+    /** Configured `app.live.toggle` chords that also end the call (Ctrl+L by default). */
+    stopKeys?: readonly KeyId[];
+}
+/** A compact, fixed-height terminal component for displaying a realtime call. */
+export declare class LiveVisualizer implements Component {
+    #private;
+    readonly wantsKeyRelease = false;
+    constructor(options: LiveVisualizerOptions);
+    /** Updates the current call phase. */
+    setPhase(phase: LivePhase): void;
+    /** Updates the microphone volume level (0..1). */
+    setInputLevel(level: number): void;
+    /** Advances the spectrum animation and its peak decay. */
+    setFrame(frame: number): void;
+    /** Updates the user's streaming voice transcript. */
+    setTranscript(text: string): void;
+    /** Clears the user's voice transcript row. */
+    clearTranscript(): void;
+    /** Processes user keypresses. */
+    handleInput(data: string): void;
+    /** Clears the render cache. */
+    invalidate(): void;
+    /** Renders the microphone spectrum into a compact fixed-height panel. */
+    render(width: number): readonly string[];
+}

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

@@ -0,0 +1,51 @@
+import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/hub.js";
+/** One broker scope: a project runtime dir or a machine-global service dir. */
+export interface PsScope {
+    kind: "project" | "global";
+    runtimeDir: string;
+    /** Canonical project dir when known; used to connect and displayed as the scope label. */
+    projectDir?: string;
+    /** Global service name (`kind === "global"`). */
+    service?: string;
+    /** Live broker PID; undefined when no broker owns the scope. */
+    brokerPid?: number;
+}
+/** One process snapshot and its table display metadata. */
+export interface PsDaemonRow {
+    snapshot: DaemonSnapshot;
+    /** Launch command from the persisted spec, when readable. */
+    command?: string;
+    cwd?: string;
+    /** False when the snapshot came from disk with no live broker supervising it. */
+    supervised: boolean;
+}
+/** Process rows grouped under their owning broker scope. */
+export interface PsScopeReport {
+    scope: PsScope;
+    daemons: PsDaemonRow[];
+}
+/** Scope selector shared by every ps action: current project, `--dir`, or `--global`. */
+export interface PsTarget {
+    dir?: string;
+    global?: string;
+}
+/** Process states without a running process or live uptime. */
+export declare const TERMINAL_STATES: Partial<Record<DaemonState, true>>;
+/** Combine an executable and its arguments for display. */
+export declare function formatCommand(spec: DaemonSpec | undefined): string | undefined;
+/** Collapse a launch command to one display line (inline scripts embed newlines/tabs). */
+export declare function collapseCommand(command: string | undefined): string;
+/** One-line daemon summary used by action results and detail views. */
+export declare function daemonLabel(daemon: DaemonSnapshot): string;
+/** Colored STATE cell, e.g. `ready`, `exited(143)`. */
+export declare function stateCell(row: PsDaemonRow): string;
+/** Display persistence and supervision flags for a process row. */
+export declare function flagsCell(row: PsDaemonRow): string;
+/** Display elapsed runtime, or a dash for a terminal process. */
+export declare function uptimeCell(snapshot: DaemonSnapshot): string;
+/** Labels aligned with the process table's display cells. */
+export declare const TABLE_HEADER: string[];
+/** Raw (possibly colored) cells for one daemon row, aligned with {@link TABLE_HEADER}. */
+export declare function tableCells(row: PsDaemonRow): string[];
+/** Scope heading, e.g. `project /work/pi — broker pid 1234`. */
+export declare function scopeHeader(scope: PsScope): string;

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

@@ -0,0 +1,33 @@
+import { type Component, TUI } from "../tui.js";
+import type { DaemonSnapshot, DaemonSpec } from "../tools/hub.js";
+import { type PsScope, type PsScopeReport, type PsTarget } from "./ps-data.js";
+/** Options accepted by the interactive monitor: scope selection from the list flags. */
+export interface PsTopOptions extends PsTarget {
+    all: boolean;
+}
+/** Broker capabilities supplied by the process command. */
+export interface PsTopHost {
+    collectReports(all: boolean, target: PsTarget): Promise<PsScopeReport[]>;
+    act(scope: PsScope, name: string, verb: "stop" | "kill" | "restart"): Promise<DaemonSnapshot>;
+    describe(scope: PsScope, name: string): Promise<{
+        daemon: DaemonSnapshot;
+        spec: DaemonSpec;
+    }>;
+    logs(scope: PsScope, name: string, lines: number): Promise<{
+        terminalRows?: string[];
+        text: string;
+        state: string;
+    }>;
+    close(): void;
+}
+/** Interactive process table and detail views. */
+export declare class PsTopComponent implements Component {
+    #private;
+    constructor(ui: TUI, options: PsTopOptions, host: PsTopHost);
+    run(): Promise<void>;
+    dispose(): void;
+    handleInput(data: string): void;
+    render(width: number): readonly string[];
+}
+/** Run the fullscreen interactive process monitor until the user quits. */
+export declare function runPsTop(options: PsTopOptions, host: PsTopHost): Promise<void>;

package/dist/types/apps/session-picker.d.ts

@@ -0,0 +1,26 @@
+import { type SessionSelectorEntry, type SessionHistoryMatcher } from "../overlays/session-selector.js";
+/** Persistence and history capabilities supplied by the session-owning host. */
+export interface SessionPickerHost<T extends SessionSelectorEntry = SessionSelectorEntry> {
+    loadPinnedIds?(): Promise<ReadonlySet<string>>;
+    loadHistoryMatcher?(): SessionHistoryMatcher;
+    deleteSession?(session: T): Promise<boolean>;
+    loadAllSessions?(): Promise<T[]>;
+}
+/** Presentation and capability controls for the standalone session picker. */
+export interface SessionPickerOptions<T extends SessionSelectorEntry = SessionSelectorEntry> {
+    allSessions?: T[];
+    title?: string;
+    scopeLabel?: string | false;
+    showCwd?: boolean;
+    allowDelete?: boolean;
+    allowGlobalScope?: boolean;
+    historySearch?: boolean;
+    pinnedIds?: ReadonlySet<string>;
+}
+/**
+ * Show the TUI session selector and return the selected session, or null if
+ * cancelled. The default OMP picker supports deletion, transcript-history
+ * search, and an all-projects scope; foreign import pickers disable those
+ * source-owned capabilities.
+ */
+export declare function selectSession<T extends SessionSelectorEntry>(sessions: T[], options?: SessionPickerOptions<T>, host?: SessionPickerHost<T>): Promise<T | null>;

package/dist/types/apps/setup-model-picker.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Standalone TUI model picker used by `omp setup speech`.
+ *
+ * One-shot {@link selectStandaloneItem} prompt: resolve on select/cancel and
+ * let the adapter tear the UI down. The standalone TUI auto-renders on input,
+ * so no manual render wiring is needed.
+ */
+import { type SelectItem } from "../components/select-list.js";
+/**
+ * Show a single-column model picker and resolve with the chosen item's value,
+ * or `null` if the user cancelled. `currentValue` pre-selects the matching row.
+ */
+export declare function selectSetupModel(title: string, items: SelectItem[], currentValue: string): Promise<string | null>;

package/dist/types/apps/standalone-picker.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tightly scoped adapter for one-shot standalone TUI prompts.
+ *
+ * Owns the `ProcessTerminal`/`TUI` lifecycle (mount, idempotent finish,
+ * teardown) so individual pickers only declare their form field. Styling goes
+ * through {@link fgOrPlain} and {@link getSelectListTheme}, both of which are
+ * safe before theme initialization, so standalone paths never initialize the
+ * global theme.
+ */
+import type { SelectItem } from "../components/select-list.js";
+import { TUI, type Component, type OverlayOptions } from "../tui.js";
+/** Build context for a standalone prompt: the owned UI plus its resolver. */
+export interface StandaloneTuiContext<T> {
+    ui: TUI;
+    /** Idempotent: stops the UI and resolves the runner promise with `value`. */
+    finish: (value: T) => void;
+}
+/** Presentation controls for a standalone prompt. */
+export interface StandaloneTuiOptions {
+    /** Present the component as an overlay instead of a plain child. */
+    overlay?: OverlayOptions;
+}
+/**
+ * Run a one-shot TUI component built from `{ ui, finish }` until `finish` is
+ * called, then tear the UI down and resolve with the finished value.
+ */
+export declare function runStandaloneTui<T>(build: (context: StandaloneTuiContext<T>) => Component, options?: StandaloneTuiOptions): Promise<T>;
+/** Options for a standalone single-column item picker. */
+export interface StandaloneSelectOptions {
+    currentValue?: string;
+    maxVisible?: number;
+}
+/**
+ * Show a single-column item picker and resolve with the chosen item's value,
+ * or `null` if the user cancelled.
+ */
+export declare function selectStandaloneItem(title: string, items: SelectItem[], options?: StandaloneSelectOptions): Promise<string | null>;
+/**
+ * Show a one-shot text prompt and resolve with the trimmed input, or `null`
+ * when cancelled or left empty.
+ */
+export declare function promptStandaloneText(title: string): Promise<string | null>;

package/dist/types/autocomplete.d.ts

@@ -13,6 +13,10 @@ export declare function findTrailingSlashCommandStart(text: string): number | nu
  * behavior so Tab and Enter acceptance stay in sync.
  */
 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;
+/** 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 {
     value: string;
     label: string;

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

@@ -0,0 +1,11 @@
+import { type Component } from "../tui.js";
+import type { AdvisorMessageDetails } from "./messages.js";
+import type { Theme } from "../theme/index.js";
+/**
+ * Display-only transcript card for advisor notes injected into the primary
+ * session. Styled as a distinct voice so notes never blend into thinking
+ * output (whose `thinkingText` color equals `toolOutput` in most themes):
+ * a bold `customMessageLabel` header tag (skill-card convention), a heavy
+ * rail tinted per-note severity, and the note body on the default text color.
+ */
+export declare function createAdvisorMessageCard(details: AdvisorMessageDetails | undefined, getExpanded: () => boolean, uiTheme: Theme): Component;