@wrongstack/tui 0.265.1 → 0.268.0

package/README.md

@@ -70,9 +70,21 @@ process.exit(exitCode);
 | `↑` / `↓` | History navigation when buffer empty |
 | `@` | File picker |
 | `/` (at start) | Slash command picker |
-| `Ctrl+G` | Toggle agents monitor overlay |
-| `Ctrl+S` | Edit autonomy settings (default mode + auto-proceed delay); also `/settings` |
-| `Esc` | Close any picker / dialog / agents monitor |
+| `?` (empty prompt) | Keyboard shortcuts help overlay |
+| `F1` | Project switcher (also `/project`) |
+| `Ctrl+F` / `F2` | Toggle fleet orchestration monitor |
+| `Ctrl+G` / `F3` | Toggle agents live monitor |
+| `Ctrl+T` / `F4` | Toggle worktree monitor |
+| `F5` | Toggle plan panel |
+| `F6` | Toggle todos monitor overlay |
+| `F7` | Toggle queue panel |
+| `F8` | Toggle process list overlay |
+| `F9` | Toggle goal panel |
+| `F10` | Toggle live sessions panel |
+| `F11` | Toggle coordinator monitor |
+| `F12` | Open status line picker |
+| `Ctrl+S` | Edit autonomy/settings defaults; also `/settings` |
+| `Esc` | Close any picker / dialog / monitor / panel |
 | `Ctrl+L` | Clear screen (TUI keeps state — equivalent to scrolling) |
 
 ## Options worth knowing
@@ -95,8 +107,7 @@ State is a single `useReducer` `State` shape with discriminated-union `Action`s.
 
 ## React Version
 
-TUI remains on React 18 because ink v5 does not yet fully support React 19.
-WebUI uses React 19. This is a known divergence tracked in this codebase.
+TUI uses React 19 with Ink 7, matching the package dependencies in this workspace.
 
 ## License
 

package/dist/index.d.ts

@@ -125,6 +125,16 @@ interface ProviderOption {
     modelsLabel?: string | undefined;
 }
 
+/** Context window mode options — cyclable via ←/→. */
+declare const CONTEXT_MODES: readonly ["balanced", "frugal", "deep", "archival"];
+type ContextMode = (typeof CONTEXT_MODES)[number];
+declare const STATUSLINE_MODES: readonly ["minimum", "detailed"];
+type StatuslineMode = (typeof STATUSLINE_MODES)[number];
+declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+declare const CACHE_TTLS: readonly ["default", "5m", "1h"];
+type CacheTtl = (typeof CACHE_TTLS)[number];
+
 /** Thin view over a SessionSummary for the resume picker. */
 interface ResumeSessionEntry {
     id: string;
@@ -159,6 +169,8 @@ type Settings = {
     allowOutsideProjectRoot: boolean;
     contextAutoCompact: boolean;
     contextStrategy: 'hybrid' | 'intelligent' | 'selective';
+    contextMode: ContextMode;
+    maxConcurrent: number;
     logLevel: 'error' | 'warn' | 'info' | 'debug' | 'trace';
     auditLevel: 'minimal' | 'standard' | 'full';
     indexOnStart: boolean;
@@ -173,6 +185,16 @@ type Settings = {
     enhanceLanguage: 'original' | 'english';
     /** Raw SSE stream debugging — hex-dump every byte received from providers. */
     debugStream: boolean;
+    /** Statusline density mode. Defaults to detailed. */
+    statuslineMode: StatuslineMode;
+    /** Reasoning mode: auto (provider default) | on | off. */
+    reasoningMode: 'auto' | 'on' | 'off';
+    /** Reasoning effort level. */
+    reasoningEffort: ReasoningEffort;
+    /** Preserve thinking across turns. */
+    reasoningPreserve: boolean;
+    /** Prompt cache TTL. */
+    cacheTtl: CacheTtl;
     /** Where to persist settings: 'global' or 'project'. */
     configScope: 'global' | 'project';
     /** Full mouse mode: in-app managed scroll + clickable UI (SGR tracking on). */
@@ -257,6 +279,8 @@ interface RunTuiOptions {
     effectiveMaxContext?: number | undefined;
     /** Absolute project root for goal.json loading. */
     projectRoot?: string | undefined;
+    /** Full app config, used for HQ client publishing settings. */
+    appConfig?: _wrongstack_core.Config | undefined;
     /**
      * Terminal title animation on/off. Defaults to true. When false, the
      * OSC-0 window/tab title stays static (the app name only, no spinner).
@@ -363,6 +387,12 @@ interface RunTuiOptions {
      */
     statuslineHiddenItems: Array<'todos' | 'plan' | 'tasks' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost' | 'working_dir'>;
     setStatuslineHiddenItems: (items: Array<'todos' | 'plan' | 'tasks' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost' | 'working_dir'>) => void;
+    /**
+     * Atomically updates in-memory state AND persists to
+     * ~/.wrongstack/statusline.json. Used by the statusline picker to
+     * make each toggle immediately durable.
+     */
+    saveStatuslineHiddenItems: (items: Array<'todos' | 'plan' | 'tasks' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost' | 'working_dir'>) => Promise<void>;
     /**
      * Controller for the agents monitor overlay. App installs a dispatch-backed
      * setter on mount so the `/agents on|off` slash command can toggle the
@@ -372,6 +402,14 @@ interface RunTuiOptions {
         visible: boolean;
         setVisible: (visible: boolean) => void;
     } | undefined;
+    /**
+     * Mutable ref for opening TUI panels from slash commands. The slash commands
+     * call `onPanelOpen.current(action)` to open panels. The App sets
+     * `onPanelOpen.current` to its actual dispatch function on mount.
+     */
+    onPanelOpen?: {
+        current: ((action: string) => boolean) | null;
+    } | undefined;
     /**
      * If set, the App boots straight into goal mode — the text is wrapped
      * in the GOAL preamble and submitted as the first turn. Lets users
@@ -533,6 +571,40 @@ interface RunTuiOptions {
     onCoordinatorStart?: ((goal?: string) => void) | undefined;
     /** Stop the AutonomousCoordinator loop. */
     onCoordinatorStop?: (() => void) | undefined;
+    /** List pending coordinator tasks claimable by this terminal. */
+    onCoordinatorTasks?: (() => Promise<Array<{
+        id: string;
+        title: string;
+        priority: string;
+        tags: string[];
+    }> | null>) | undefined;
+    /** Claim a coordinator task. Returns description on success. */
+    onCoordinatorClaim?: ((taskId: string) => Promise<string | null | {
+        description: string;
+    }>) | undefined;
+    /** Mark a claimed task as completed. */
+    onCoordinatorComplete?: ((taskId: string, result?: string) => Promise<string | null>) | undefined;
+    /** Mark a claimed task as failed. */
+    onCoordinatorFail?: ((taskId: string, error: string) => Promise<string | null>) | undefined;
+    /** Get coordinator stats for status display. */
+    onCoordinatorStatus?: (() => Promise<{
+        goals: {
+            total: number;
+            done: number;
+            pending: number;
+            failed: number;
+        };
+        dag: {
+            running: number;
+            ready: number;
+            done: number;
+            failed: number;
+        };
+        auction: {
+            pending: number;
+            inProgress: number;
+        };
+    } | null>) | undefined;
 }
 declare function runTui(opts: RunTuiOptions): Promise<number>;