@wrongstack/tui 0.284.1 → 0.286.0

package/dist/index.d.ts

@@ -1,910 +1,12 @@
-import * as _wrongstack_core from '@wrongstack/core';
-import { TokenSavingTier, Agent, SlashCommandRegistry, AttachmentStore, EventBus, TokenCounter, QueueStore, AutonomyStage, Director, Message, AutonomousCoordinator, CoordinatorEvent, SessionEvent } from '@wrongstack/core';
-export { buildGoalPreamble } from '@wrongstack/core';
-import { VisionAdapters } from '@wrongstack/runtime/vision';
-import { SddRunControl, SddLifecycleResult } from '@wrongstack/sdd';
-import React from 'react';
-export { ParseNextStepsResult, ParsedNextStep, parseNextSteps } from '@wrongstack/tools/next-steps';
-
-/** 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: 'thinking';
-    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;
-    /**
-     * Per-tool on-screen result render mode. `simple` hides the body
-     * preview and shows only meta (line count, byte size); `extend`
-     * shows the full preview. Mirrors the CLI's `setResultRenderMode`
-     * state. The frontend TUI reads this off the same
-     * `tools.resultRenderMode[name]` config the CLI uses.
-     */
-    resultRenderMode?: 'simple' | 'extend' | 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;
-};
-
-/** One saved API key / OAuth token, with the secret already masked. */
-interface AuthKeyRow {
-    label: string;
-    /** Pre-masked display form ("sk-a…f3k2" / "••••••") — never the secret. */
-    masked: string;
-    createdAt: string;
-    active: boolean;
-    authMethod?: 'api_key' | 'oauth' | 'session_token' | undefined;
-    expiresAt?: string | undefined;
-}
-/** One saved provider from ~/.wrongstack/config.json. */
-interface AuthProviderRow {
-    id: string;
-    type?: string | undefined;
-    family?: string | undefined;
-    baseUrl?: string | undefined;
-    models: string[];
-    envVars: string[];
-    keys: AuthKeyRow[];
-}
-/** One models.dev catalog entry offered by "Add provider (catalog)". */
-interface AuthCatalogRow {
-    id: string;
-    name: string;
-    family: string;
-    apiBase?: string | undefined;
-    envVars: string[];
-    /** Already present in the saved config (shown as ◉). */
-    saved: boolean;
-}
-/** One local-LLM preset (OmniRoute / Ollama / vLLM / LM Studio). */
-interface AuthLocalPresetRow {
-    id: string;
-    label: string;
-    defaultBaseUrl: string;
-    noAuth: boolean;
-    hint: string;
-}
-type AuthOAuthKind = 'chatgpt' | 'claude' | 'copilot';
-/**
- * Bridge the CLI flows use to talk to the panel while a flow runs.
- * `prompt` REJECTS when the user cancels (Esc) — flows treat a thrown
- * prompt as user-cancel, which aborts before anything is saved.
- */
-interface AuthFlowIo {
-    onLog(line: string): void;
-    prompt(question: string, opts: {
-        secret: boolean;
-    }): Promise<string>;
-    signal: AbortSignal;
-}
-interface AuthFlowResult {
-    ok: boolean;
-    message?: string | undefined;
-}
-/**
- * Host callbacks the CLI provides. Simple mutations return an error
- * string (or null on success); multi-step interactions run as "flows"
- * that log and prompt through {@link AuthFlowIo}.
- */
-interface AuthPanelHost {
-    listProviders(): Promise<AuthProviderRow[]>;
-    listCatalog(): Promise<AuthCatalogRow[]>;
-    localPresets(): AuthLocalPresetRow[];
-    setActiveKey(providerId: string, label: string): Promise<string | null>;
-    deleteKey(providerId: string, label: string): Promise<string | null>;
-    removeProvider(providerId: string): Promise<string | null>;
-    addKey(providerId: string, io: AuthFlowIo): Promise<AuthFlowResult>;
-    updateKey(providerId: string, label: string, io: AuthFlowIo): Promise<AuthFlowResult>;
-    editField(providerId: string, field: 'family' | 'baseUrl' | 'models', io: AuthFlowIo): Promise<AuthFlowResult>;
-    addCatalogProvider(catalogId: string, io: AuthFlowIo): Promise<AuthFlowResult>;
-    addCustomProvider(io: AuthFlowIo): Promise<AuthFlowResult>;
-    addLocal(presetId: string, io: AuthFlowIo): Promise<AuthFlowResult>;
-    oauthLogin(kind: AuthOAuthKind, io: AuthFlowIo): Promise<AuthFlowResult>;
-}
-
-interface ProviderOption {
-    id: string;
-    family: string;
-    /** Model ids the picker offers in step 2 for this provider. */
-    models: string[];
-    /** Optional dim hint shown next to the model list (e.g. "from saved config"). */
-    modelsLabel?: string | undefined;
-}
-
-interface McpPickerItem {
-    name: string;
-    enabled: boolean;
-    status: string;
-    transport: string;
-    description?: string | undefined;
-    toolCount: number;
-    lazy?: boolean | undefined;
-}
-
-interface PluginPickerItem {
-    name: string;
-    enabled: boolean;
-    risk: 'low' | 'medium' | 'high';
-    summary: string;
-    /**
-     * When false the row is locked: the picker renders a 🔒 marker and ignores
-     * Enter/←/→ on it. The current built-in audit list is fully toggleable, but
-     * the component keeps this marker for future or externally supplied locked
-     * rows.
-     */
-    lockable?: boolean | undefined;
-}
-
-interface ToolPickerItem {
-    name: string;
-    owner: string;
-    category: string;
-    enabled: boolean;
-    mutating: boolean;
-    permission: string;
-    descMode: 'extend' | 'simple';
-    description: string;
-}
-
-/** 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];
-
-/** All possible statusline chip keys. */
-type StatuslineItem = 'version' | 'state' | 'model' | 'tokens' | 'cache' | 'queue' | 'processes' | 'hint' | 'index' | 'breaker' | 'todos' | 'plan' | 'tasks' | 'fleet' | 'fleet_agents' | 'git' | 'elapsed' | 'context' | 'cost' | 'working_dir' | 'project' | 'yolo' | 'autonomy' | 'eternal_stage' | 'goal' | 'mode' | 'auto_proceed' | 'sessions' | 'tools' | 'token_saving' | 'brain' | 'mailbox' | 'enhance' | 'debug_stream' | 'next_steps';
-
-/** 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;
-    titleAnimation: boolean;
-    yolo: boolean;
-    streamFleet: boolean;
-    chime: boolean;
-    confirmExit: boolean;
-    nextPrediction: boolean;
-    featureMcp: boolean;
-    featurePlugins: boolean;
-    featureMemory: boolean;
-    featureSkills: boolean;
-    featureModelsRegistry: boolean;
-    /** Token-saving tier: off | minimal | light | medium | aggressive. */
-    featureTokenSaving: TokenSavingTier;
-    /** Allow tools to access paths outside the project root. Default: true (open). */
-    allowOutsideProjectRoot: boolean;
-    contextAutoCompact: boolean;
-    contextStrategy: 'hybrid' | 'intelligent' | 'selective';
-    contextMode: ContextMode;
-    maxConcurrent: number;
-    logLevel: 'error' | 'warn' | 'info' | 'debug' | 'trace';
-    auditLevel: 'minimal' | 'standard' | 'full';
-    indexOnStart: boolean;
-    /** Multi-file diff summary footer cutoff. 0 = off; positive = min file count. */
-    multiDiffSummaryThreshold: number;
-    /**
-     * Settings-picker row the user last navigated to. Carried in the
-     * canonical Settings shape so reopening the picker after a session
-     * restart lands on the same row they were last tweaking, rather than
-     * always resetting to 0. Updated on every `settingsFieldMove` /
-     * `settingsFieldSet`; consumed by the `settingsOpen` action.
-     */
-    lastSettingsField: number;
-    maxIterations: number;
-    /** Maximum auto-proceed iterations (0 = unlimited). */
-    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';
-    /**
-     * When true (default), submitting a plain message while the agent is busy
-     * pops the send-mode picker (queue / by-the-way / steer). Toggled via
-     * `/queue picker on|off`; persisted to `autonomy.midRunSendPicker`.
-     */
-    midRunSendPicker?: boolean | undefined;
-    /** Raw SSE stream debugging — hex-dump every byte received from providers. */
-    debugStream: boolean;
-    /** Skip the confirmation prompt for the `!<command>` shell shortcut. */
-    shellBangWarningDontShowAgain?: boolean | undefined;
-    /** 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;
-    /** Single word shown in the TUI rainbow working-state chip. */
-    thinkingWord: string;
-    /** Prompt cache TTL. */
-    cacheTtl: CacheTtl;
-    /** Where to persist settings: 'global' or 'project'. */
-    configScope: 'global' | 'project';
-    /**
-     * Animation style for the working/thinking chip in the status bar. One of
-     * the renderable styles plus the meta-mode `'cycle'` that rotates through
-     * the variant styles every `CYCLE_INTERVAL_SECONDS`.
-     */
-    animationStyle: 'rainbow' | 'wave' | 'pulse' | 'dots' | 'breathe' | 'cycle';
-    /** Full mouse mode: in-app managed scroll + clickable UI (SGR tracking on). */
-    mouseMode?: boolean | undefined;
-    /** Whether the process circuit breaker gates bash/exec. Default false (off). */
-    breakerEnabled?: boolean | undefined;
-    /** Auto kill/reset delay (ms) when the breaker trips. 0 = manual recovery. */
-    breakerAutoKillResetMs?: number | undefined;
-};
-
-interface RunTuiOptions {
-    agent: Agent;
-    slashRegistry: SlashCommandRegistry;
-    attachments: AttachmentStore;
-    events: EventBus;
-    tokenCounter?: TokenCounter | undefined;
-    visionAdapters?: VisionAdapters | undefined;
-    /** Resolve current model vision support. Falls back to provider capability when omitted. */
-    supportsVision?: (() => boolean | Promise<boolean>) | undefined;
-    model: string;
-    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. */
-    getYolo?: (() => boolean) | undefined;
-    /** Set live YOLO state from TUI-owned controls such as ConfirmPrompt. */
-    onYolo?: ((enabled: boolean) => boolean) | undefined;
-    /** Query the live autonomy mode. */
-    getAutonomy?: (() => 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel') | undefined;
-    /**
-     * Access the eternal-autonomy engine. When autonomy mode flips to
-     * 'eternal' the TUI drives `runOneIteration()` from the post-slash hook
-     * so the engine and TUI never race for the shared Context.
-     */
-    getEternalEngine?: (() => _wrongstack_core.EternalAutonomyEngine | null) | undefined;
-    /**
-     * Access the parallel-eternal engine. When autonomy mode flips to
-     * 'eternal-parallel' the TUI drives `runOneIteration()` from the post-slash
-     * hook so the engine and TUI never race for the shared Context.
-     */
-    getParallelEngine?: (() => _wrongstack_core.ParallelEternalEngine | null) | undefined;
-    /**
-     * Access the active SDD parallel run's control surface (or null). The TUI's
-     * SIGINT handler uses it to stop a running `/sdd parallel` on the first Ctrl+C.
-     */
-    getSddRun?: (() => SddRunControl | null) | undefined;
-    /**
-     * Apply a post-run SDD lifecycle op (clean / rollback / destroy) from the host.
-     * Drives the board overlay keys c / z / x so they work after the run ends.
-     */
-    onSddLifecycle?: ((op: 'cleanup_worktrees' | 'rollback' | 'destroy', opts?: {
-        revertMerged?: boolean;
-    }) => Promise<SddLifecycleResult>) | undefined;
-    /**
-     * Subscribe to live per-iteration events from the eternal engine.
-     * Returns an unsubscribe function. TUI uses this to render each
-     * iteration as a live timeline entry as it lands.
-     */
-    subscribeEternalIteration?: ((fn: (entry: _wrongstack_core.JournalEntry) => void) => () => void) | undefined;
-    /**
-     * Subscribe to per-iteration stage transitions from the autonomy engines.
-     * TUI uses this to render live status in the status bar.
-     */
-    subscribeEternalStage?: ((fn: (stage: AutonomyStage) => void) => () => void) | undefined;
-    /** Renders in the startup banner. Read from the CLI's package.json. */
-    appVersion?: string | undefined;
-    /** Provider id for the startup banner ("openai", "anthropic", ...). */
-    provider?: string | undefined;
-    /** Wire family — shown beneath provider in the banner. */
-    family?: string | undefined;
-    /** Last 3 chars of the active API key — shown in the banner for visual key-pick verification. */
-    keyTail?: string | undefined;
-    /** Snapshot of keyed providers + their model lists for the `/model` picker. Async — the catalog fetch may need to hit disk/network. */
-    getPickableProviders?: (() => Promise<ProviderOption[]>) | undefined;
-    /** Apply a (provider, model) pair after the picker confirms. Returns an error string on failure. */
-    switchProviderAndModel?: ((providerId: string, modelId: string) => string | null | Promise<string | null>) | undefined;
-    /** Apply an autonomy mode after the picker confirms. Returns an error string on failure. */
-    switchAutonomy?: ((mode: 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel') => string | null) | undefined;
-    /**
-     * Model-specific maxContext (tokens), resolved by the CLI via the
-     * ModelsRegistry. When omitted, the TUI falls back to the provider
-     * family's baseline (e.g. anthropic = 200_000), which can be wrong
-     * for variants like the 1M-context Opus build. The status bar's
-     * context chip uses this for its progress denominator.
-     */
-    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).
-     * Controlled via /settings → Terminal title animation.
-     */
-    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"). */
-    modeLabel?: string | undefined;
-    /** Token-saving tier — shown as a `💾 <tier>` chip in the TUI status bar (hidden when `'off'`). */
-    tokenSavingMode?: TokenSavingTier | undefined;
-    /** Number of registered tools — shown on the status bar line 2. */
-    toolCount?: number | undefined;
-    /** Live getter for the agent mode label so the status bar updates after /mode. */
-    getModeLabel?: (() => string) | undefined;
-    /**
-     * Get all available agent modes with their names, descriptions, and the
-     * currently active mode id. Used by the `/mode` picker in the TUI.
-     */
-    getModes?: (() => Promise<{
-        modes: _wrongstack_core.Mode[];
-        activeId: string | null;
-    }>) | undefined;
-    /** Switch to a different agent mode by id (e.g. "teach", "brief"). */
-    switchMode?: ((modeId: string) => Promise<string | null>) | undefined;
-    /**
-     * Called ONCE on mount by the App to install its debug-stream telemetry
-     * callback. The CLI wires this to setDebugStreamCallback() from
-     * @wrongstack/providers. On App unmount, the default stderr callback
-     * is restored.
-     */
-    registerDebugStreamCallback?: ((cb: (stats: {
-        chunkCount: number;
-        lastChunkSize: number;
-        lastDeltaMs: number;
-        totalBytes: number;
-        lastChunkAt: string;
-    }) => void) => void) | undefined;
-    /** Called on App unmount — restores the default stderr debug-stream callback. */
-    restoreDebugStreamCallback?: (() => void) | undefined;
-    /** Called from /clear so the TUI can wipe its history entries while agent.ctx + memory are cleared separately. */
-    onClearHistory?: ((dispatch: React.Dispatch<{
-        type: 'clearHistory';
-    } | {
-        type: 'resetContextChip';
-    } | {
-        type: 'streamReset';
-    } | {
-        type: 'toolStreamClear';
-    }>) => void) | undefined;
-    /**
-     * Live director instance. When set, the TUI renders a fleet panel
-     * showing every spawned subagent, its current task, streaming output,
-     * and runtime cost — updated live from the FleetBus. Pass null or omit
-     * when multi-agent / director mode is disabled.
-     */
-    director?: Director | null | undefined;
-    /**
-     * Optional roster reference for resolving subagent role ids to
-     * human-readable names. Same value passed to director.tools().
-     */
-    fleetRoster?: Record<string, {
-        name: string;
-    }> | undefined;
-    /**
-     * Shared controller for the `/fleet stream on|off` toggle. The slash
-     * command runs in the CLI process and needs to flip TUI reducer state;
-     * the App installs a dispatch-backed `setEnabled` here on mount so
-     * both sides stay synchronized.
-     */
-    /**
-     * Shared controller for the `/fleet stream on|off` toggle. The slash
-     * command runs in the CLI process and needs to flip TUI reducer state;
-     * the App installs a dispatch-backed `setEnabled` here on mount so
-     * both sides stay synchronized.
-     */
-    fleetStreamController?: {
-        enabled: boolean;
-        setEnabled: (enabled: boolean) => void;
-    } | undefined;
-    /**
-     * Controller for the `/interrupt` slash command. The App installs the real
-     * `abortLeader` on mount so the command can abort the in-flight leader run.
-     */
-    interruptController?: {
-        abortLeader: () => boolean;
-    } | undefined;
-    /**
-     * 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;
-    } | undefined;
-    /**
-     * Controller for status bar hidden items. App installs a dispatch-backed
-     * setter on mount so the /statusline slash command can update the TUI's
-     * visible bar without a round-trip. The initial value is loaded from
-     * the config file before App mounts.
-     */
-    statuslineHiddenItems: StatuslineItem[];
-    setStatuslineHiddenItems: (items: StatuslineItem[]) => 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: StatuslineItem[]) => 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
-     * overlay without a round-trip.
-     */
-    agentsMonitorController?: {
-        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
-     * launch directly from the shell:
-     *   wstack --tui --director --goal "audit packages/core for races"
-     * The chat shows a one-line "🎯 Goal locked: …" hint; the actual
-     * preamble is hidden from the visible history (same as `/goal`).
-     */
-    initialGoal?: string | undefined;
-    /**
-     * If set, submitted as the first turn verbatim (no preamble). Mainly
-     * for scripted shell aliases — `wstack --tui --ask "summarize foo.md"`
-     * — that want one turn pre-populated without the goal-mode framing.
-     * Ignored when `initialGoal` is also set.
-     */
-    initialAsk?: string | undefined;
-    /**
-     * Directory containing session JSONL files. Required for rewind
-     * functionality. When provided the TUI can list checkpoints and
-     * trigger a rewind via `/rewind` or Ctrl+R.
-     */
-    sessionsDir?: string | undefined;
-    /** Live active session id for cross-surface client registration. */
-    getSessionId?: (() => string | undefined) | undefined;
-    /**
-     * SDD session context getter. When an SDD session is active, returns
-     * the AI prompt context to inject into user messages.
-     */
-    getSDDContext?: (() => Promise<string | null>) | undefined;
-    /**
-     * Process AI output for SDD auto-detection (spec, tasks, plan).
-     * Returns displayable status messages.
-     */
-    onSDDOutput?: ((output: string) => Promise<string[]>) | undefined;
-    /**
-     * Subscribe to AutoPhase phase/graph events from the PhaseOrchestrator.
-     * Returns an unsubscribe function. The TUI uses this to drive the
-     * PhaseMonitor and PhasePanel live views via dispatch actions.
-     */
-    subscribeAutoPhase?: ((handler: (event: string, payload: unknown) => void) => () => void) | undefined;
-    /**
-     * Read the persisted autonomy settings (defaultMode, autoProceedDelayMs).
-     * Used by the SettingsPicker in the TUI on mount and after Ctrl+S toggle.
-     */
-    getSettings?: (() => Settings) | undefined;
-    /**
-     * Persist settings changes. Returns null on success, or an
-     * error string on failure (so the TUI can display it as a hint).
-     */
-    saveSettings?: ((s: Settings) => string | null | Promise<string | null>) | undefined;
-    /** Load toggleable plugin rows for the interactive plugin picker. */
-    getPluginItems?: (() => PluginPickerItem[]) | undefined;
-    /** Toggle one plugin from the interactive picker and return refreshed rows. */
-    onPluginToggle?: ((name: string) => Promise<{
-        items: PluginPickerItem[];
-        message?: string | undefined;
-        error?: string | undefined;
-    }>) | undefined;
-    /** Load MCP server rows for the interactive MCP picker. */
-    getMcpServers?: (() => McpPickerItem[]) | undefined;
-    /** Toggle one MCP server (enable/disable) from the interactive picker. */
-    onMcpToggle?: ((name: string) => Promise<{
-        items: McpPickerItem[];
-        message?: string | undefined;
-        error?: string | undefined;
-    }>) | undefined;
-    /** Restart one MCP server from the interactive picker. */
-    onMcpRestart?: ((name: string) => Promise<{
-        items: McpPickerItem[];
-        message?: string | undefined;
-        error?: string | undefined;
-    }>) | undefined;
-    /** Load tool rows for the interactive tool picker. */
-    getToolsItems?: (() => ToolPickerItem[]) | undefined;
-    /** Toggle one tool (enable/disable) from the interactive tool picker. */
-    onToolToggle?: ((name: string) => Promise<{
-        items: ToolPickerItem[];
-        message?: string | undefined;
-        error?: string | undefined;
-    }>) | undefined;
-    /** Get current brain risk level and decision log for the Brain panel. */
-    getBrainData?: (() => {
-        riskLevel: 'off' | 'low' | 'medium' | 'high' | 'all';
-        log: Array<{
-            kind: string;
-            question: string;
-            outcome: string;
-            age: string;
-        }>;
-    }) | undefined;
-    /** Set brain risk ceiling from the Brain panel. */
-    onBrainRiskLevel?: ((level: 'off' | 'low' | 'medium' | 'high' | 'all') => string | undefined) | undefined;
-    /** Get current Shadow Agent state. */
-    getShadowData?: (() => {
-        activeId: string | null;
-        running: boolean;
-        model: string;
-        intervalMs: number;
-    }) | undefined;
-    /** Start Shadow Agent. Returns message or error. */
-    onShadowStart?: (() => Promise<string | undefined>) | undefined;
-    /** Stop Shadow Agent. Returns message or error. */
-    onShadowStop?: (() => Promise<string | undefined>) | undefined;
-    /**
-     * Host for the interactive `/auth` panel (provider/key management, OAuth
-     * sign-in, local-server add). The CLI builds this from its vault +
-     * models registry; when absent, `/auth` falls back to plain text.
-     */
-    authHost?: AuthPanelHost | undefined;
-    /**
-     * Predict likely next steps after a completed turn. The CLI wires this from
-     * the session provider and the `/next` toggle; it returns [] when prediction
-     * is disabled or autonomy isn't 'off'. Display-only — never executed.
-     */
-    predictNext?: ((input: {
-        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;
-    /**
-     * Retrieve current auto suggestions (items with auto="true" attribute).
-     * Used by YOLO+auto mode for automatic next-step submission.
-     */
-    getAutoSuggestions?: (() => string[]) | undefined;
-    /**
-     * Autonomy next prompt template for YOLO+auto mode. Contains {{suggestion}} placeholder.
-     */
-    autonomyNextPrompt?: string | undefined;
-    /**
-     * Write parsed next steps into the shared suggestion store.
-     * Called by the Entry component after parsing each assistant message
-     * so /next 1 and the auto-submit countdown can access them.
-     */
-    setSuggestions?: ((steps: string[]) => void) | 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;
-    /**
-     * Access the project-level AutonomousCoordinator instance. When set, the TUI
-     * renders a coordination panel showing live goals, pending tasks, consensus
-     * decisions, and shared knowledge from all active sessions. The coordinator
-     * runs independently of the session — it coordinates multiple sessions.
-     */
-    getAutonomousCoordinator?: () => AutonomousCoordinator | null | undefined;
-    /**
-     * Subscribe to live events from the AutonomousCoordinator:
-     * - `goal:added` — new coordination goal received
-     * - `goal:completed` — goal finished successfully
-     * - `goal:failed` — goal failed after max attempts
-     * - `task:ready` — task's dependencies are satisfied, ready to execute
-     * - `task:completed` — task finished
-     * - `knowledge:added` — new shared fact published
-     * - `consensus:reached` — multi-session agreement reached
-     * Returns an unsubscribe function.
-     */
-    subscribeCoordinatorEvents?: (fn: (event: CoordinatorEvent) => void) => () => void;
-    /**
-     * Start the AutonomousCoordinator loop. Fire-and-forget — run() loops
-     * asynchronously. Pass a goal string to begin decomposition and task
-     * auction immediately.
-     */
-    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>;
-
-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 AuthCatalogRow, type AuthFlowIo, type AuthFlowResult, type AuthKeyRow, type AuthLocalPresetRow, type AuthOAuthKind, type AuthPanelHost, type AuthProviderRow, type PluginPickerItem, type RunTuiOptions, type Settings, parseInline, replaySessionEvents, runTui };
+export { runTui } from './run-tui.js';
+export type { RunTuiOptions } from './run-tui.js';
+export { buildGoalPreamble } from './app.js';
+export type { Settings } from './app.js';
+export type { PluginPickerItem } from './components/plugin-picker.js';
+export type { AuthCatalogRow, AuthFlowIo, AuthFlowResult, AuthKeyRow, AuthLocalPresetRow, AuthOAuthKind, AuthPanelHost, AuthProviderRow, } from './components/auth-panel-model.js';
+export type { BrainPanelHost, BrainPanelSettings, BrainPanelVoter, } from './components/brain-panel-model.js';
+export { parseInline } from './markdown.js';
+export { replaySessionEvents } from './components/history/replay.js';
+export { parseNextSteps } from './components/suggestions.js';
+export type { ParsedNextStep, ParseNextStepsResult } from './components/suggestions.js';
+//# sourceMappingURL=index.d.ts.map