@wrongstack/tui 0.68.0 → 0.77.0

package/README.md

@@ -76,21 +76,7 @@ process.exit(exitCode);
 | `Esc` | Close any picker / dialog / agents monitor |
 | `Ctrl+L` | Clear screen (TUI keeps state — equivalent to scrolling) |
 
-### Mouse mode (`--mouse`)
-
-With `--mouse` the TUI takes over terminal mouse tracking (forces alt-screen; native wheel-scroll and text selection are suspended until `/mouse off`). Then:
-
-- **Wheel** scrolls chat history, or moves the selection in an open picker.
-- **Click or drag the right-edge scrollbar** to jump/scrub the chat viewport to any position.
-- **Click inside the input** to move the caret (single- and multi-line).
-- **Click** a picker item to select + confirm it (single click).
-- **Click** the permission dialog's `[y]/[n]/[a]/[d]` buttons.
-- **Click** a `/rewind` checkpoint to select it; click again to rewind.
-- **Click** the status-bar model chip to open the model picker, or the `∞ MODE` chip to open the autonomy picker.
-- **Click** a `/settings` row to focus it; click again to cycle its value.
-- **Click** the lower region to dismiss an open monitor (`Ctrl+F/G/T/P`) or the `?` help overlay (parity with `Esc`).
-
-Keyboard shortcuts (always available in managed/alt-screen mode, not just `--mouse`):
+Keyboard shortcuts (always available in managed/alt-screen mode):
 - **PgUp/PgDn** — page scroll through chat history.
 - **Home/End** — jump to top/bottom of chat history (when input is empty); move cursor to start/end of line (when typing).
 - **Ctrl+Home/End** — jump to top/bottom of chat history (always, even when typing).

package/dist/index.d.ts

@@ -13,6 +13,28 @@ interface ProviderOption {
     modelsLabel?: string;
 }
 
+interface Settings {
+    mode: 'off' | 'suggest' | 'auto';
+    delayMs: number;
+    titleAnimation: boolean;
+    yolo: boolean;
+    streamFleet: boolean;
+    chime: boolean;
+    confirmExit: boolean;
+    nextPrediction: boolean;
+    featureMcp: boolean;
+    featurePlugins: boolean;
+    featureMemory: boolean;
+    featureSkills: boolean;
+    featureModelsRegistry: boolean;
+    contextAutoCompact: boolean;
+    contextStrategy: 'hybrid' | 'intelligent' | 'selective';
+    logLevel: 'error' | 'warn' | 'info' | 'debug' | 'trace';
+    auditLevel: 'minimal' | 'standard' | 'full';
+    indexOnStart: boolean;
+    maxIterations: number;
+}
+
 interface RunTuiOptions {
     agent: Agent;
     slashRegistry: SlashCommandRegistry;
@@ -81,7 +103,7 @@ interface RunTuiOptions {
     projectRoot?: string;
     /** Render into the terminal's alternate screen buffer (like vim/less/htop).
      * Default: false — native scrollback stays live so chat history is
-     * scrollable via mouse wheel / Shift+PgUp, which matches the user's
+     * scrollable (wheel / Shift+PgUp), which matches the user's
      * "this is a chat app, let me scroll the chat" intuition. Pass true
      * (or run with `--alt-screen`) for the full-screen mode that owns the
      * terminal and prevents resize/overlay leaks of the live region —
@@ -90,13 +112,19 @@ interface RunTuiOptions {
      */
     altScreen?: boolean;
     /**
-     * Enable full mouse support: clickable list items in menus/pickers and
-     * in-app mouse-wheel scrolling of the chat history. Opt-in (default false)
-     * because enabling terminal mouse tracking disables the terminal's own
-     * wheel-scroll and text-selection/copy. When true this FORCES alt-screen
-     * on (the app must own the screen to render its scroll viewport).
+     * Terminal title animation on/off. Defaults to true. When false, the
+     * OSC-0 window/tab title stays static (the app name only, no spinner).
+     * Controlled via /settings → Terminal title animation.
      */
-    mouse?: boolean;
+    titleAnimation?: boolean;
+    /** Play terminal bell (\\x07) when agent run completes. */
+    chime?: boolean;
+    /** Show "confirm exit" message on first Ctrl+C instead of "exit". */
+    confirmExit?: boolean;
+    /** Active agent mode label shown in the status bar (e.g. "teach", "brief"). */
+    modeLabel?: string;
+    /** Live getter for the agent mode label so the status bar updates after /mode. */
+    getModeLabel?: () => string;
     /**
      * Called right after we exit the alt-screen on a clean shutdown. The
      * CLI uses this to print a one-line "session saved to …" hint into
@@ -140,6 +168,16 @@ interface RunTuiOptions {
         enabled: boolean;
         setEnabled: (enabled: boolean) => void;
     };
+    /**
+     * Controller for the `/enhance on|off` prompt-refinement toggle. The App
+     * installs a dispatch-backed `setEnabled` here on mount so the slash command
+     * (run in the CLI process) flips the TUI's reducer flag. Mirrors
+     * `fleetStreamController`.
+     */
+    enhanceController?: {
+        enabled: boolean;
+        setEnabled: (enabled: boolean) => void;
+    };
     /**
      * Controller for status bar hidden items. App installs a dispatch-backed
      * setter on mount so the /statusline slash command can update the TUI's
@@ -199,18 +237,12 @@ interface RunTuiOptions {
      * Read the persisted autonomy settings (defaultMode, autoProceedDelayMs).
      * Used by the SettingsPicker in the TUI on mount and after Ctrl+S toggle.
      */
-    getSettings?: () => {
-        mode: 'off' | 'suggest' | 'auto';
-        delayMs: number;
-    };
+    getSettings?: () => Settings;
     /**
-     * Persist autonomy settings changes. Returns null on success, or an
+     * Persist settings changes. Returns null on success, or an
      * error string on failure (so the TUI can display it as a hint).
      */
-    saveSettings?: (s: {
-        mode: 'off' | 'suggest' | 'auto';
-        delayMs: number;
-    }) => string | null | Promise<string | null>;
+    saveSettings?: (s: Settings) => string | null | Promise<string | null>;
     /**
      * Predict likely next steps after a completed turn. The CLI wires this from
      * the session provider and the `/next` toggle; it returns [] when prediction
@@ -223,4 +255,4 @@ interface RunTuiOptions {
 }
 declare function runTui(opts: RunTuiOptions): Promise<number>;
 
-export { type RunTuiOptions, runTui };
+export { type RunTuiOptions, type Settings, runTui };