@agi-fans/dsh-tui 0.1.0

package/lib/editor.js

@@ -0,0 +1,365 @@
+/**
+ * Input-editor state machine: OMP readline/emacs bindings over a single
+ * buffer that may contain newlines. Pure — the provider owns history,
+ * interrupt, and process lifetime.
+ * @module @agi-fans/dsh-tui
+ */
+const MAX_UNDO = 80;
+const MAX_KILLS = 60;
+/** Emacs-style kill ring (consecutive kills accumulate). */
+export class KillRing {
+    #entries = [];
+    push(text, opts) {
+        if (text === '')
+            return;
+        if (opts.accumulate && this.#entries.length > 0) {
+            const last = this.#entries.pop() ?? '';
+            this.#entries.push(opts.prepend ? text + last : last + text);
+        }
+        else {
+            this.#entries.push(text);
+            if (this.#entries.length > MAX_KILLS)
+                this.#entries.shift();
+        }
+    }
+    peek() {
+        return this.#entries[this.#entries.length - 1];
+    }
+    rotate() {
+        if (this.#entries.length > 1) {
+            const last = this.#entries.pop();
+            if (last !== undefined)
+                this.#entries.unshift(last);
+        }
+    }
+    get length() {
+        return this.#entries.length;
+    }
+}
+/** Start index of the line containing `cursor`. */
+export function lineStart(text, cursor) {
+    const at = text.lastIndexOf('\n', cursor - 1);
+    return at < 0 ? 0 : at + 1;
+}
+/** End index (before newline, or length) of the line containing `cursor`. */
+export function lineEnd(text, cursor) {
+    const at = text.indexOf('\n', cursor);
+    return at < 0 ? text.length : at;
+}
+/** Word-left: skip trailing whitespace, then the previous word. */
+export function moveWordLeft(text, cursor) {
+    let i = cursor;
+    while (i > 0 && /\s/.test(text[i - 1] ?? ''))
+        i -= 1;
+    while (i > 0 && !/\s/.test(text[i - 1] ?? ''))
+        i -= 1;
+    return i;
+}
+/** Word-right: skip the current word, then following whitespace. */
+export function moveWordRight(text, cursor) {
+    let i = cursor;
+    while (i < text.length && !/\s/.test(text[i] ?? ''))
+        i += 1;
+    while (i < text.length && /\s/.test(text[i] ?? ''))
+        i += 1;
+    return i;
+}
+function moveLine(text, cursor, dir) {
+    const start = lineStart(text, cursor);
+    const col = cursor - start;
+    if (dir < 0) {
+        if (start === 0)
+            return undefined;
+        const prevEnd = start - 1;
+        const prevStart = lineStart(text, prevEnd);
+        return prevStart + Math.min(col, prevEnd - prevStart);
+    }
+    const end = lineEnd(text, cursor);
+    if (end >= text.length)
+        return undefined;
+    const nextStart = end + 1;
+    const nextEnd = lineEnd(text, nextStart);
+    return nextStart + Math.min(col, nextEnd - nextStart);
+}
+/**
+ * Multiline input buffer with OMP editor bindings.
+ */
+export class InputEditor {
+    #text = '';
+    #cursor = 0;
+    #undo = [];
+    #last = 'none';
+    #kills = new KillRing();
+    #yankLen = 0;
+    #jump = null;
+    get text() {
+        return this.#text;
+    }
+    get cursor() {
+        return this.#cursor;
+    }
+    /** Replace the buffer (history recall). Clears undo. */
+    setText(text, cursor = text.length) {
+        this.#text = text;
+        this.#cursor = Math.max(0, Math.min(cursor, text.length));
+        this.#undo = [];
+        this.#last = 'none';
+        this.#yankLen = 0;
+        this.#jump = null;
+    }
+    /** Move the caret without changing text or undo. */
+    setCursor(cursor) {
+        this.#cursor = Math.max(0, Math.min(cursor, this.#text.length));
+        this.#last = 'none';
+    }
+    /** Empty the buffer, keeping undo of the previous contents. */
+    clear() {
+        if (this.#text === '')
+            return;
+        this.#pushUndo();
+        this.#text = '';
+        this.#cursor = 0;
+        this.#last = 'none';
+    }
+    /** Apply one decoded event. */
+    handle(event) {
+        if (this.#jump !== null) {
+            if (event.type === 'key' && (event.id === 'ctrl+]' || event.id === 'ctrl+alt+]')) {
+                this.#jump = null;
+                return { kind: 'changed' };
+            }
+            if (event.type === 'text' && event.value !== '') {
+                const dir = this.#jump;
+                this.#jump = null;
+                this.#jumpToChar(event.value[0] ?? '', dir);
+                return { kind: 'changed' };
+            }
+            this.#jump = null;
+        }
+        if (event.type === 'text') {
+            this.#insert(event.value);
+            return { kind: 'changed', edited: true };
+        }
+        if (event.type !== 'key')
+            return { kind: 'ignored' };
+        return this.#handleKey(event.id);
+    }
+    #handleKey(id) {
+        switch (id) {
+            case 'enter':
+                return { kind: 'submit', text: this.#text };
+            case 'ctrl+j':
+            case 'shift+enter':
+            case 'alt+enter':
+            case 'ctrl+enter':
+                this.#insert('\n');
+                return { kind: 'changed', edited: true };
+            case 'ctrl+c':
+                return { kind: 'clear' };
+            case 'escape':
+                return { kind: 'interrupt' };
+            case 'ctrl+d':
+                if (this.#text === '')
+                    return { kind: 'quit' };
+                this.#deleteForward();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+z':
+                return { kind: 'suspend' };
+            case 'alt+l':
+                return { kind: 'resetDisplay' };
+            case 'up':
+                return this.#vertical(-1);
+            case 'down':
+                return this.#vertical(1);
+            case 'left':
+            case 'ctrl+b':
+                return this.#moveTo(this.#cursor - 1);
+            case 'right':
+            case 'ctrl+f':
+                return this.#moveTo(this.#cursor + 1);
+            case 'home':
+            case 'ctrl+a':
+                return this.#moveTo(lineStart(this.#text, this.#cursor));
+            case 'end':
+            case 'ctrl+e':
+                return this.#moveTo(lineEnd(this.#text, this.#cursor));
+            case 'alt+left':
+            case 'ctrl+left':
+            case 'alt+b':
+                return this.#moveTo(moveWordLeft(this.#text, this.#cursor));
+            case 'alt+right':
+            case 'ctrl+right':
+            case 'alt+f':
+                return this.#moveTo(moveWordRight(this.#text, this.#cursor));
+            case 'backspace':
+                this.#deleteBackward();
+                return { kind: 'changed', edited: true };
+            case 'delete':
+                this.#deleteForward();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+w':
+            case 'alt+backspace':
+            case 'ctrl+backspace':
+                this.#deleteWordBackward();
+                return { kind: 'changed', edited: true };
+            case 'alt+d':
+            case 'alt+delete':
+                this.#deleteWordForward();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+u':
+                this.#deleteToLineStart();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+k':
+                this.#deleteToLineEnd();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+y':
+                this.#yank();
+                return { kind: 'changed', edited: true };
+            case 'alt+y':
+                this.#yankPop();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+-':
+            case 'ctrl+_':
+                this.#applyUndo();
+                return { kind: 'changed', edited: true };
+            case 'ctrl+]':
+                this.#jump = 'forward';
+                return { kind: 'changed' };
+            case 'ctrl+alt+]':
+                this.#jump = 'backward';
+                return { kind: 'changed' };
+            default:
+                return { kind: 'ignored' };
+        }
+    }
+    #vertical(dir) {
+        const next = moveLine(this.#text, this.#cursor, dir);
+        if (next === undefined)
+            return dir < 0 ? { kind: 'historyPrev' } : { kind: 'historyNext' };
+        return this.#moveTo(next);
+    }
+    #moveTo(cursor) {
+        const next = Math.max(0, Math.min(this.#text.length, cursor));
+        if (next === this.#cursor)
+            return { kind: 'changed' };
+        this.#cursor = next;
+        this.#last = 'none';
+        return { kind: 'changed' };
+    }
+    #pushUndo() {
+        this.#undo.push({ text: this.#text, cursor: this.#cursor });
+        if (this.#undo.length > MAX_UNDO)
+            this.#undo.shift();
+    }
+    #insert(value) {
+        if (value === '')
+            return;
+        const coalesce = this.#last === 'insert' && value.length === 1 && value !== '\n';
+        if (!coalesce)
+            this.#pushUndo();
+        this.#text = this.#text.slice(0, this.#cursor) + value + this.#text.slice(this.#cursor);
+        this.#cursor += value.length;
+        this.#last = 'insert';
+        this.#yankLen = 0;
+    }
+    #deleteRange(start, end, direction) {
+        if (start >= end)
+            return;
+        this.#pushUndo();
+        const killed = this.#text.slice(start, end);
+        this.#text = this.#text.slice(0, start) + this.#text.slice(end);
+        this.#cursor = start;
+        this.#kills.push(killed, { prepend: direction === 'backward', accumulate: this.#last === 'kill' });
+        this.#last = 'kill';
+        this.#yankLen = 0;
+    }
+    #deleteBackward() {
+        if (this.#cursor === 0)
+            return;
+        this.#deleteRange(this.#cursor - 1, this.#cursor, 'backward');
+    }
+    #deleteForward() {
+        if (this.#cursor >= this.#text.length)
+            return;
+        this.#deleteRange(this.#cursor, this.#cursor + 1, 'forward');
+    }
+    #deleteWordBackward() {
+        if (this.#cursor === 0)
+            return;
+        this.#deleteRange(moveWordLeft(this.#text, this.#cursor), this.#cursor, 'backward');
+    }
+    #deleteWordForward() {
+        if (this.#cursor >= this.#text.length)
+            return;
+        this.#deleteRange(this.#cursor, moveWordRight(this.#text, this.#cursor), 'forward');
+    }
+    #deleteToLineStart() {
+        const start = lineStart(this.#text, this.#cursor);
+        if (this.#cursor > start) {
+            this.#deleteRange(start, this.#cursor, 'backward');
+            return;
+        }
+        if (start > 0)
+            this.#deleteRange(start - 1, start, 'backward');
+    }
+    #deleteToLineEnd() {
+        const end = lineEnd(this.#text, this.#cursor);
+        if (this.#cursor < end) {
+            this.#deleteRange(this.#cursor, end, 'forward');
+            return;
+        }
+        if (end < this.#text.length)
+            this.#deleteRange(end, end + 1, 'forward');
+    }
+    #yank() {
+        const text = this.#kills.peek();
+        if (text === undefined)
+            return;
+        this.#insert(text);
+        this.#last = 'yank';
+        this.#yankLen = text.length;
+    }
+    #yankPop() {
+        if (this.#last !== 'yank' || this.#kills.length <= 1 || this.#yankLen === 0)
+            return;
+        const start = this.#cursor - this.#yankLen;
+        if (start < 0)
+            return;
+        this.#text = this.#text.slice(0, start) + this.#text.slice(this.#cursor);
+        this.#cursor = start;
+        this.#kills.rotate();
+        const next = this.#kills.peek();
+        if (next === undefined)
+            return;
+        this.#text = this.#text.slice(0, this.#cursor) + next + this.#text.slice(this.#cursor);
+        this.#cursor += next.length;
+        this.#yankLen = next.length;
+        this.#last = 'yank';
+    }
+    #jumpToChar(char, dir) {
+        if (char === '')
+            return;
+        this.#last = 'none';
+        if (dir === 'forward') {
+            const at = this.#text.indexOf(char, this.#cursor + 1);
+            if (at >= 0)
+                this.#cursor = at;
+            return;
+        }
+        if (this.#cursor === 0)
+            return;
+        const at = this.#text.lastIndexOf(char, this.#cursor - 1);
+        if (at >= 0)
+            this.#cursor = at;
+    }
+    #applyUndo() {
+        const snap = this.#undo.pop();
+        if (snap === undefined)
+            return;
+        this.#text = snap.text;
+        this.#cursor = snap.cursor;
+        this.#last = 'none';
+        this.#yankLen = 0;
+    }
+}
+//# sourceMappingURL=editor.js.map

package/lib/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"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"}

package/lib/event-views.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Transcript state machine: SessionEvent -> display blocks, and the pure
+ * view that composes blocks + status + input into a render frame.
+
+ * applyEvent is the single writer of TranscriptState; renderView is the
+ * single reader. windowTranscript clips the body the way OMP's ScrollView
+ * does. Both are pure so the whole rendering pipeline is testable without
+ * a terminal.
+ * @module @agi-fans/dsh-tui
+ */
+import type { CallId } from '@deepseek-ai/dsh-llm';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { AutocompleteItem, SlashCommand } from './autocomplete.ts';
+import { type HistorySearchState } from './history-search.ts';
+import type { Frame, TranscriptScroll } from './renderer.ts';
+import { type CopySelectorState } from './copy-selector.ts';
+import { type SettingsState } from './settings-list.ts';
+import { type PromptSelectorState } from './prompt-selector.ts';
+import { type StatusBarConfig, type StatusPreset } from './status-config.ts';
+import { type Theme, type ThemeName } from './theme.ts';
+import type { TuiRecentSession, TuiSessionControls, TuiSessionStats } from './definition.ts';
+import { type TuiToolPresentation } from './tool-renderers.ts';
+import { type ToolInfo } from './tools-list.ts';
+import { type HotkeyBindings } from './hotkeys.ts';
+import type { WelcomeTip } from './welcome-tips.ts';
+/** Display state of one tool invocation. */
+export type ToolBlockStatus = 'running' | 'ok' | 'error';
+/** One rendered block of the transcript. */
+export type Block = {
+    kind: 'user';
+    text: string;
+} | {
+    kind: 'assistant';
+    turn: number;
+    step: number;
+    text: string;
+    reasoning: string;
+    streaming: boolean;
+} | {
+    kind: 'tool';
+    callId: CallId;
+    name: string;
+    args: string;
+    status: ToolBlockStatus;
+    output: string;
+    partial?: boolean;
+    presentation?: TuiToolPresentation;
+} | {
+    kind: 'toolCatalog';
+    tools: readonly ToolInfo[];
+} | {
+    kind: 'hotkeyCatalog';
+    bindings: HotkeyBindings;
+} | {
+    kind: 'commandOutput';
+    command: string;
+    text: string;
+} | {
+    kind: 'notice';
+    level: 'info' | 'error';
+    text: string;
+};
+/** Live session status shown on the status line. */
+export type SessionStatus = 'idle' | 'running';
+/** Mutable-free transcript state produced by applyEvent. */
+export interface TranscriptState {
+    /** Ordered display blocks (user, assistant, tool). */
+    blocks: Block[];
+    /** Whole-agent liveness for the status line. */
+    status: SessionStatus;
+    /** The most recent turn number. */
+    turn: number;
+}
+/** Empty starting state. */
+export declare function initialTranscript(): TranscriptState;
+/**
+ * Fold one session-log event into the transcript state.
+ * @param state - prior state.
+ * @param event - the appended session event.
+ * @returns the next state.
+ */
+export declare function applyEvent(state: TranscriptState, event: SessionEvent, presentation?: TuiToolPresentation): TranscriptState;
+/** View options: terminal geometry and live input state. */
+export interface ViewOptions {
+    /** Terminal width in columns. */
+    width: number;
+    /** Terminal height in rows; the view keeps the frame inside it. */
+    height: number;
+    /** Model name for the fixed footer. */
+    model: string;
+    /** Effective reasoning effort for the selected model, including adapter defaults. */
+    reasoningEffort?: string;
+    /** Current input buffer text. */
+    input: string;
+    /** Cursor column inside the input buffer (0-based, before the prefix). */
+    inputCursor: number;
+    /** Number of client-owned image drafts represented by input markers. */
+    inputImages?: number;
+    /** Whether to emit color SGR sequences. */
+    colors: boolean;
+    /** Working directory shown in the footer. */
+    pwd?: string;
+    /** Git branch shown in the footer. */
+    branch?: string;
+    /** Product version painted on the welcome title. */
+    version?: string;
+    /** Product name painted on the welcome title. */
+    appName?: string;
+    /** Spinner phase while a turn or tool is running. */
+    spinnerFrame?: number;
+    /** 24-bit color; defaults to off so tests stay deterministic. */
+    trueColor?: boolean;
+    /** Shipped palette; defaults to dark. */
+    themeName?: ThemeName;
+    /** Slash-command popup sitting under the editor. */
+    autocomplete?: {
+        items: readonly AutocompleteItem[];
+        selected: number;
+    };
+    /** Ctrl+R history-search overlay; replaces the editor while open. */
+    historySearch?: HistorySearchState;
+    /** `/settings` overlay; replaces the editor while open. */
+    settings?: SettingsState;
+    /** `/copy` picker overlay; replaces the editor while open. */
+    copySelector?: CopySelectorState;
+    /** Human-interaction selector; replaces the normal editor while active. */
+    promptSelector?: PromptSelectorState;
+    /** Effective local + agent-scoped slash command catalog. */
+    commands?: readonly SlashCommand[];
+    /** Durable rows shown in the welcome card. */
+    recentSessions?: readonly TuiRecentSession[];
+    /** Startup-stable sample of hints shown in the welcome card. */
+    welcomeTips?: readonly WelcomeTip[];
+    /** Whole-session figures rendered in the footer's telemetry row. */
+    sessionStats?: TuiSessionStats;
+    /** Harness-owned collaboration and permission state rendered in metadata. */
+    sessionControls?: TuiSessionControls;
+    /** Visible groups, order, and label style for the status line. */
+    statusBar?: StatusBarConfig;
+    /** Legacy status preset accepted while direct render callers migrate. */
+    statusPreset?: StatusPreset;
+    /**
+     * First transcript row to show (0 = top). Omit or pass +Infinity to pin
+     * the window to the latest lines — the OMP follow-tail default.
+     */
+    scrollStart?: number;
+    /** Open one transcript block at its first row instead of following the tail. */
+    focusBlock?: number;
+    /**
+     * When true, tool blocks paint their full output (OMP `ctrl+o`). Default
+     * is the collapsed preview of {@link TOOL_COLLAPSED_LINES} rows.
+     */
+    toolsExpanded?: boolean;
+    /** Individual tool calls expanded by the user. */
+    expandedTools?: ReadonlySet<string>;
+}
+/** Collapsed tool-output preview height (OMP `DEFAULT_TERMINAL_PREVIEW_LINES`). */
+export declare const TOOL_COLLAPSED_LINES = 10;
+/**
+ * Render one transcript block to display lines. Pure; shared by the tty view
+ * and the non-tty plain printer.
+ * @param block - the block to render.
+ * @param theme - active theme.
+ * @param width - terminal width in columns.
+ * @param spinnerFrame - activity spinner phase for running tools.
+ * @param toolsExpanded - paint full tool output instead of the collapsed preview.
+ * @returns display lines (already width-fitted).
+ */
+export declare function blockLines(block: Block, theme: Theme, width: number, spinnerFrame?: number, toolsExpanded?: boolean): string[];
+/** Rows moved per Shift+Arrow (OMP ScrollView `fastScrollLines`). */
+export declare const TRANSCRIPT_FAST_SCROLL = 5;
+/** Rows moved per mouse-wheel notch. */
+export declare const TRANSCRIPT_WHEEL_SCROLL = 3;
+/**
+ * Window `body` into `budget` rows with ↑/↓ overflow markers.
+ * `start` is the first body row to keep; non-finite values pin to the tail.
+ */
+export declare function windowTranscript(body: readonly string[], budget: number, start: number, theme: Theme): TranscriptScroll & {
+    lines: string[];
+};
+/**
+ * Compose the welcome card, transcript, working row, and rounded editor into
+ * one frame — the oh-my-pi surface.
+ * @param state - transcript state.
+ * @param options - terminal geometry and input state.
+ * @returns the frame to hand to a renderer.
+ */
+export declare function renderView(state: TranscriptState, options: ViewOptions): Frame;