@wrongstack/tui 0.295.0 → 0.296.2

package/dist/run-tui.d.ts

@@ -1,574 +1,7 @@
-import type { Agent } from '@wrongstack/core/agent';
-import type { AutonomousCoordinator, CoordinatorEvent, Director } from '@wrongstack/core/coordination';
-import type { SlashCommandRegistry } from '@wrongstack/core/registry';
-import type { QueueStore } from '@wrongstack/core/storage';
-import type { AttachmentStore, AutonomyStage, FleetChatVerbosity, Message, TokenCounter, TokenSavingTier } from '@wrongstack/core/types';
-import type { EventBus } from '@wrongstack/core/kernel';
-import type { VisionAdapters } from '@wrongstack/runtime/vision';
-import type { SddLifecycleResult, SddRunControl } from '@wrongstack/sdd';
-import React from 'react';
-import type { AgentTranscriptReader } from './components/agents-monitor.js';
-import type { McpPickerItem } from './components/mcp-picker.js';
-import type { PluginPickerItem } from './components/plugin-picker.js';
-import type { StatuslineItem } from './components/statusline-picker.js';
-import type { ToolPickerItem } from './components/tools-picker.js';
-export type { AutonomyStage };
-export interface RunTuiOptions {
-    agent: Agent;
-    slashRegistry: SlashCommandRegistry;
-    /** Host-owned mutable bridge for slash commands that need masked input. */
-    secretInputController?: {
-        readSecret(prompt: string): Promise<string>;
-        readText?(prompt: string): Promise<string>;
-    } | undefined;
-    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?: (() => import('@wrongstack/core/execution').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?: (() => import('@wrongstack/core/execution').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: import('@wrongstack/core/goal').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;
-    /** Active fallback profile name, shown in the banner (e.g. "default"). */
-    profile?: string | undefined;
-    /** Absolute path to the active profile's config.json
-     *  (e.g. "~/.wrongstack/profiles/default/config.json"). When present,
-     *  the banner shows the full path with the profile name highlighted,
-     *  instead of the bare {@link profile} string. */
-    profileConfigPath?: string | undefined;
-    /** Background autonomy agents to display in the banner (Brain, Shadow,
-     *  Kanban, Mailbox, Memory, etc.). Read from the mailbox at boot. */
-    autonomyAgents?: import('./components/history/types.js').AutonomyAgentStatus[] | undefined;
-    /** Latest version published to the npm registry (drives the
-     *  "update available" indicator next to the banner version chip).
-     *  Sourced from the CLI's preflight update-check. */
-    latestVersion?: string | undefined;
-    /** True when the preflight update-check found a newer version than
-     *  {@link appVersion}. The banner renders `(update available)` next to
-     *  the version chip when this is true, so users notice without having
-     *  to read the stderr notice. */
-    updateAvailable?: boolean | undefined;
-    /** Snapshot of keyed providers + their model lists for the `/model` picker. Async — the catalog fetch may need to hit disk/network. */
-    getPickableProviders?: (() => Promise<import('./components/model-picker.js').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?: import('@wrongstack/core/types').Config | undefined;
-    /**
-     * The embedding host already owns the HQ publisher and telemetry bridges.
-     * Prevents this UI surface from opening a duplicate heartbeat-only client.
-     */
-    hqTelemetryOwnedExternally?: boolean | 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, but while tracking is on the plain wheel reports to the app.
-     * The bounded chat viewport can always be scrolled with PgUp/PgDn. 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: import('@wrongstack/core/types').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';
-        model?: string | undefined;
-        provider?: string | undefined;
-    } | {
-        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;
-    /**
-     * Read the CURRENT director. Unlike the static `director` option (captured
-     * at boot, null in non---director sessions), this sees a director the fleet
-     * host built lazily on the first delegate/spawn — the TUI's fleet-teardown
-     * paths (Ctrl+C, Esc, /steer) resolve through it.
-     */
-    getDirector?: (() => 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?: {
-        mode: FleetChatVerbosity;
-        setMode: (mode: FleetChatVerbosity) => void;
-    } | undefined;
-    /**
-     * Read-only per-subagent transcript access for the F3 agents monitor
-     * (AgentMonitorService satisfies this structurally).
-     */
-    agentTranscripts?: AgentTranscriptReader | 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;
-        isRunning?: (() => boolean) | undefined;
-        confirmClear?: ((info: {
-            leaderActive: boolean;
-            subagentCount: number;
-        }) => Promise<boolean>) | undefined;
-        confirmSlash?: ((question: string, defaultYes: boolean) => Promise<boolean | null>) | undefined;
-        resetSession?: (() => void) | undefined;
-        waitForIdle?: (() => Promise<void>) | undefined;
-    } | 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;
-    /** Capability-gated low-effort reasoning hint for the prompt refiner. */
-    getEnhancerReasoning?: (() => import('@wrongstack/core/types').ReasoningRequest | undefined) | undefined;
-    /** Build an ephemeral Provider for retrying a failed refinement on another model (no session switch). */
-    buildEnhancerProvider?: ((providerId: string, modelId: string) => Promise<import('@wrongstack/core/types').Provider | undefined>) | undefined;
-    /** Resolve the one-key "retry with another model" fallback ref on a refine failure. */
-    getEnhanceFallbackRef?: (() => string | undefined) | undefined;
-    /** Resolve the dedicated refiner target for the initial refinement attempt. */
-    getConfiguredRefinerRef?: (() => string | undefined) | 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
-     * Active profile/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 Goal 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.
-     */
-    subscribeGoal?: ((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?: (() => import('./app-state.js').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: import('./app-state.js').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;
-    /** Full Brain settings editor bridge (live apply + persist to global config). */
-    brainPanelHost?: import('./brain-panel-model.js').BrainPanelHost | 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?: import('./auth-panel-model.js').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;
-    /**
-     * Raw prior-session JSONL events. When provided, the boot `--resume` history
-     * is rebuilt with the canonical renderer (tool I/O + interleaved audit
-     * markers) instead of meta-only tool chips. Omitted → legacy fallback.
-     */
-    restoredEvents?: import('@wrongstack/core/types').SessionEvent[] | 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<import('./app-state.js').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: import('./components/history/types.js').HistoryEntry[];
-        nextId: number;
-        sessionId: string;
-    } | null>) | undefined;
-    getProjectPickerItems?: (() => Promise<import('./components/project-picker.js').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<import('./components/sessions-panel.js').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;
-    /** Access the persistent memory store for listing and inspecting memories. */
-    memoryStore?: import('@wrongstack/core/types').MemoryPort | undefined;
-}
-export declare function silenceTerminal(): void;
-export declare function unsilenceTerminal(): void;
+import type { RunTuiOptions } from './run-tui-options.js';
+import { silenceTerminal, unsilenceTerminal } from './terminal-silence.js';
+export type { AutonomyStage } from '@wrongstack/core/types';
+export type { RunTuiOptions } from './run-tui-options.js';
+export { silenceTerminal, unsilenceTerminal };
 export declare function runTui(opts: RunTuiOptions): Promise<number>;
 //# sourceMappingURL=run-tui.d.ts.map

package/dist/run-tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-tui.d.ts","sourceRoot":"","sources":["../src/run-tui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-tui.d.ts","sourceRoot":"","sources":["../src/run-tui.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AAE9C,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAohBjE"}

package/dist/scroll-anchor.d.ts

@@ -1,23 +1,19 @@
 /**
- * Anchor-based scroll model for the managed history viewport.
+ * Pure geometry helpers for the managed history viewport.
  *
- * The scroll position is a {@link ScrollAnchor}: the index of the render group
- * whose row band contains the viewport's top row, plus how many of that
- * group's rows are clipped above the viewport (`clip`). Rendering starts AT
- * the anchor and proceeds downward, so what appears on screen depends only on
- * the anchor and the heights of the groups actually mounted — never on the
- * (possibly estimated) heights of content above or below the window. That is
- * the property that kills the estimate-vs-actual spacer misalignment class of
- * bugs: an off-window estimate being wrong can no longer move a single pixel.
+ * The component owns one absolute viewport-top row for wheel, page, and
+ * scrollbar input. These helpers translate that coordinate into a temporary
+ * {@link ScrollAnchor}: the render-group containing the row plus the number
+ * of rows clipped inside it. Rendering begins at that anchor, with no spacer
+ * elements.
  *
  * `null` means "pinned to the newest output" (follow mode). Pinned rendering
  * uses `justifyContent:'flex-end'` and needs no position math at all.
  *
- * Prefix sums over the {@link EntryHeightCache} are still used — but only to
- * *translate* scroll gestures (wheel deltas, page jumps, scrollbar clicks)
- * into a new anchor, and to size the scrollbar thumb. Estimate error there
- * affects only the step size of a jump through unmeasured territory, which is
- * invisible; it can never misalign rendered content.
+ * Prefix sums over the {@link EntryHeightCache} translate absolute rows to
+ * mounted groups and size the scrollbar. When a measurement corrects those
+ * sums, the component resolves the same absolute row again instead of letting
+ * separate anchor/offset/thumb states drift apart.
  *
  * Pure TypeScript — no React, no Ink. Unit-testable without mounting anything.
  */

package/dist/scroll-anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-anchor.d.ts","sourceRoot":"","sources":["../src/scroll-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,KAAK,EAAE,gBAAgB,CAAC;IACxB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;sDACsD;AACtD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CAErB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAE/E;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,IAAI,CAOrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,SAAS,SAAI,GACZ,SAAS,CAYX;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,SAAI,GAAG,SAAS,CAc7E"}
+{"version":3,"file":"scroll-anchor.d.ts","sourceRoot":"","sources":["../src/scroll-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,KAAK,EAAE,gBAAgB,CAAC;IACxB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;sDACsD;AACtD,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAK1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAU5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CAErB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAE/E;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,IAAI,CAOrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,EACpB,SAAS,SAAI,GACZ,SAAS,CAsCX;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,SAAI,GAAG,SAAS,CAkC7E"}