@wrongstack/tui 0.148.0 → 0.236.0

package/dist/index.d.ts

@@ -1,9 +1,121 @@
 import * as _wrongstack_core from '@wrongstack/core';
-import { Agent, SlashCommandRegistry, AttachmentStore, EventBus, TokenCounter, QueueStore, AutonomyStage, Director } from '@wrongstack/core';
+import { Agent, SlashCommandRegistry, AttachmentStore, EventBus, TokenCounter, QueueStore, AutonomyStage, Director, Message, SessionEvent } from '@wrongstack/core';
 export { buildGoalPreamble } from '@wrongstack/core';
 import { VisionAdapters } from '@wrongstack/runtime/vision';
 import React from 'react';
 
+/** A single session row from the SessionRegistry, exposed via WebSocket. */
+interface LiveSessionEntry {
+    sessionId: string;
+    projectName: string;
+    projectSlug: string;
+    projectRoot?: string | undefined;
+    workingDir: string;
+    gitBranch?: string | undefined;
+    status: string;
+    pid: number;
+    startedAt: string;
+    agentCount: number;
+    agents: LiveAgentEntry[];
+}
+interface LiveAgentEntry {
+    id: string;
+    name: string;
+    status: string;
+    currentTool?: string | undefined;
+    iterations: number;
+    toolCalls: number;
+    lastActivityAt: string;
+}
+
+/** A single row in the project picker. Matches the CLI's PickerItem shape. */
+interface ProjectPickerItem {
+    key: string;
+    label: string;
+    subtitle?: string | undefined;
+    meta?: string | undefined;
+    kind: 'project' | 'action';
+}
+
+type HistoryEntry = {
+    id: number;
+    kind: 'user';
+    text: string;
+    queued?: boolean | undefined;
+    pasteContent?: string | undefined;
+} | {
+    id: number;
+    kind: 'assistant';
+    text: string;
+} | {
+    id: number;
+    kind: 'tool';
+    name: string;
+    durationMs: number;
+    ok: boolean;
+    input?: unknown | undefined;
+    output?: string | undefined;
+    /** Full byte length of the result body the model actually received
+     *  (post-cap, post-scrub). Carried separately because `output` is a
+     *  ~400-char preview — `outputBytes` is what the model paid for. */
+    outputBytes?: number | undefined;
+    /** ~3.5 chars/token estimate over `outputBytes`. Cheap to render in
+     *  the chip; the authoritative count lives in provider.response.usage. */
+    outputTokens?: number | undefined;
+    /** Real line count for tools that have a meaningful one — read counts
+     *  numbered prefixes, shell/grep/logs count newlines. Undefined for
+     *  tools without a line notion (json, fetch, …). */
+    outputLines?: number | undefined;
+} | {
+    id: number;
+    kind: 'info';
+    text: string;
+} | {
+    id: number;
+    kind: 'warn';
+    text: string;
+} | {
+    id: number;
+    kind: 'error';
+    text: string;
+} | {
+    id: number;
+    kind: 'turn-summary';
+    text: string;
+} | {
+    id: number;
+    kind: 'brain';
+    status: 'thinking' | 'answered' | 'ask_human' | 'denied' | 'intervention';
+    source: string;
+    risk: 'low' | 'medium' | 'high' | 'critical';
+    question: string;
+    decision?: string | undefined;
+    rationale?: string | undefined;
+} | {
+    id: number;
+    kind: 'banner';
+    version: string;
+    provider: string;
+    model: string;
+    cwd: string;
+    family?: string | undefined;
+    keyTail?: string | undefined;
+} | {
+    id: number;
+    kind: 'confirm';
+    toolName: string;
+    input: unknown;
+    suggestedPattern: string;
+} | {
+    id: number;
+    kind: 'subagent';
+    agentLabel: string;
+    agentColor: string;
+    icon: string;
+    text: string;
+    detail?: string | undefined;
+};
+
 interface ProviderOption {
     id: string;
     family: string;
@@ -13,6 +125,20 @@ interface ProviderOption {
     modelsLabel?: string | undefined;
 }
 
+/** Thin view over a SessionSummary for the resume picker. */
+interface ResumeSessionEntry {
+    id: string;
+    title: string;
+    startedAt: string;
+    endedAt?: string | undefined;
+    tokenTotal: number;
+    iterationCount: number;
+    toolCallCount: number;
+    toolErrorCount: number;
+    outcome?: 'completed' | 'error' | 'timeout' | 'aborted' | undefined;
+    /** The current session — marked so the picker can disallow resuming into itself. */
+    isCurrent?: boolean | undefined;
+}
 type Settings = {
     mode: 'off' | 'suggest' | 'auto';
     delayMs: number;
@@ -37,10 +163,16 @@ type Settings = {
     autoProceedMaxIterations: number;
     /** Prompt refinement preview countdown (ms). */
     enhanceDelayMs: number;
+    /** Enable/disable prompt refinement. */
+    enhanceEnabled: boolean;
+    /** Default language for refinement: original or english. */
+    enhanceLanguage: 'original' | 'english';
     /** Raw SSE stream debugging — hex-dump every byte received from providers. */
     debugStream: boolean;
     /** Where to persist settings: 'global' or 'project'. */
     configScope: 'global' | 'project';
+    /** Full mouse mode: in-app managed scroll + clickable UI (SGR tracking on). */
+    mouseMode?: boolean | undefined;
 };
 
 interface RunTuiOptions {
@@ -56,6 +188,14 @@ interface RunTuiOptions {
     banner?: boolean | undefined;
     /** Persists the input queue across crashes; if omitted, the queue is in-memory only. */
     queueStore?: QueueStore | undefined;
+    /**
+     * Called with the queue's display texts (head first) on EVERY queue change
+     * — enqueue, /queue delete, /queue clear, dequeue-for-delivery. The CLI
+     * mirrors the snapshot onto the live agent Context (core's
+     * setQueuedMessagesSnapshot) so a running agent learns what's waiting at
+     * its next iteration boundary without the queue being delivered early.
+     */
+    onQueueChange?: ((items: string[]) => void) | undefined;
     /** Surfaces the "⚠ YOLO" chip in the status bar. */
     yolo?: boolean | undefined;
     /** Query live YOLO state from the permission policy. */
@@ -117,6 +257,14 @@ interface RunTuiOptions {
     titleAnimation?: boolean | undefined;
     /** Play terminal bell (\\x07) when agent run completes. */
     chime?: boolean | undefined;
+    /**
+     * Enable terminal mouse tracking (SGR; click + wheel). Stays in the normal
+     * screen buffer so native scrollback survives, BUT while tracking is on the
+     * plain wheel reports to the app instead of scrolling history — only
+     * Shift+wheel reaches native scrollback. Off by default; opt in here or via
+     * WRONGSTACK_MOUSE=1. See mouse.ts for the trade-off rationale.
+     */
+    mouse?: boolean | undefined;
     /** Show "confirm exit" message on first Ctrl+C instead of "exit". */
     confirmExit?: boolean | undefined;
     /** Active agent mode label shown in the status bar (e.g. "teach", "brief"). */
@@ -258,7 +406,129 @@ interface RunTuiOptions {
         userRequest: string;
         assistantSummary: string;
     }) => Promise<string[]>) | undefined;
+    /**
+     * Called after each agent turn with the assistant's final output text.
+     * The host parses "💡 Next steps" suggestions from the text and stores
+     * them in the shared suggestion store so `/next 1`, `/next 1 2 3` work.
+     */
+    onSuggestionsParsed?: ((finalText: string) => void) | undefined;
+    /**
+     * Retrieve current suggestions from the shared suggestion store.
+     * Used by the TUI to display and auto-submit next steps in 'auto' mode.
+     */
+    getSuggestions?: (() => string[]) | undefined;
+    /**
+     * Messages restored from a previous session. When provided (non-empty),
+     * the TUI renders the prior conversation as history entries so a resumed
+     * session shows its full chat context, not just the LLM's internal state.
+     */
+    restoredMessages?: Message[] | undefined;
+    /**
+     * Tool execution records from a previous session, keyed by tool_use id.
+     * Used to render tool entries (name, duration, ok/error) in the TUI on
+     * resume. Events are `tool_call_end` records from the session JSONL.
+     */
+    restoredToolCalls?: Array<{
+        name: string;
+        id: string;
+        durationMs: number;
+        ok: boolean;
+        outputBytes?: number | undefined;
+        outputTokens?: number | undefined;
+        outputLines?: number | undefined;
+    }> | undefined;
+    /**
+     * List recent session summaries for the /resume picker. The CLI reads
+     * from the session store and returns ResumeSessionEntry-shaped data.
+     */
+    listSessions?: ((limit?: number) => Promise<ResumeSessionEntry[]>) | undefined;
+    /**
+     * Resume a session by id: load JSONL events, replay history entries,
+     * rebuild agent context, and return hydrated entries for the TUI to
+     * display. Returns null when resume fails.
+     */
+    onResumeSession?: ((sessionId: string) => Promise<{
+        entries: HistoryEntry[];
+        nextId: number;
+        sessionId: string;
+    } | null>) | undefined;
+    getProjectPickerItems?: (() => Promise<ProjectPickerItem[]>) | undefined;
+    onProjectSelect?: ((key: string, kind: 'project' | 'action') => void) | undefined;
+    /**
+     * Request the TUI to exit with a specific code. Used by the project picker
+     * to trigger a clean exit before spawning a new wstack process in a different
+     * project directory. The host CLI catches this exit code and performs the
+     * actual project switch.
+     */
+    requestExit?: (code: number) => void;
+    getLiveSessions?: (() => Promise<LiveSessionEntry[]>) | undefined;
+    onSwitchToSession?: ((sessionId: string, projectRoot: string, projectName: string) => void) | undefined;
+    /**
+     * When true, the agents monitor (F3) is open by default at TUI startup.
+     * Used by the `wrongstack quick` command to show agents panel immediately.
+     */
+    initialAgentsMonitorOpen?: boolean | undefined;
 }
 declare function runTui(opts: RunTuiOptions): Promise<number>;
 
-export { type RunTuiOptions, type Settings, runTui };
+interface InlineToken {
+    text: string;
+    bold?: boolean | undefined;
+    italic?: boolean | undefined;
+    code?: boolean | undefined;
+    strike?: boolean | undefined;
+}
+/**
+ * Parse one line of prose into inline-emphasis tokens. Markers are stripped
+ * (this is display text, not length-preserving). `_..._` is intentionally NOT
+ * treated as italic so snake_case / file_names aren't mangled. An unterminated
+ * marker is emitted literally so no text is ever lost.
+ *
+ * Results are memoized: repeated calls with the same text return the identical
+ * cached array, eliminating redundant parsing on every TUI re-render.
+ */
+declare function parseInline(text: string): InlineToken[];
+
+/**
+ * Render a SessionEvent back into a TUI HistoryEntry so a resumed session
+ * displays exactly what the user saw during live interaction.
+ *
+ * ## Entry mapping
+ *
+ * | Event type                | HistoryEntry kind |
+ * |--------------------------|-------------------|
+ * | `user_input`             | `user`            |
+ * | `llm_response`           | `assistant`       |
+ * | `tool_use` + `tool_result` | `tool` (paired) |
+ * | `tool_call_start`/`tool_call_end` | `tool`      |
+ * | `compaction`             | `info`            |
+ * | `error`                  | `error`           |
+ * | `provider_retry`         | `warn`            |
+ * | `provider_error`         | `error`           |
+ * | `checkpoint`             | `info`            |
+ * | `agent_spawned`/`agent_stopped` | `subagent`  |
+ * | `agent_error`            | `subagent`        |
+ * | `mode_changed`           | `info`            |
+ * | `skill_activated`/`skill_deactivated` | `info` |
+ * | `message_truncated`      | `warn`            |
+ *
+ * ## Non-resumable events (subagent transcripts)
+ *
+ * Subagent events (`agent_spawned`, `agent_stopped`, `agent_error`) are
+ * rendered as `subagent` entries in the main TUI history but the full
+ * subagent tool-call details live in per-subagent JSONL files. The main
+ * session only holds the lifecycle markers.
+ *
+ * ## Compaction events
+ *
+ * Compaction boundaries are rendered as `info` entries showing how many
+ * tokens were collapsed. This keeps the display neat without pretending
+ * the full verbose context never existed.
+ *
+ * @param events  Parsed SessionEvent[] from session JSONL
+ * @param startId Starting id counter for the generated entries
+ * @returns       Ordered HistoryEntry[] ready for display
+ */
+declare function replaySessionEvents(events: SessionEvent[], startId: number): HistoryEntry[];
+
+export { type RunTuiOptions, type Settings, parseInline, replaySessionEvents, runTui };