@co0ontty/wand 1.18.1 → 1.20.4

package/dist/server.d.ts

@@ -1,2 +1,20 @@
+import { ProcessManager } from "./process-manager.js";
+import { StructuredSessionManager } from "./structured-session-manager.js";
 import { WandConfig } from "./types.js";
-export declare function startServer(config: WandConfig, configPath: string): Promise<void>;
+export interface ServerUrl {
+    url: string;
+    scheme: "HTTP" | "HTTPS";
+}
+export interface ServerHandle {
+    processManager: ProcessManager;
+    structuredSessions: StructuredSessionManager;
+    configPath: string;
+    dbPath: string;
+    urls: ServerUrl[];
+    bindAddr: string;
+    httpsEnabled: boolean;
+    version: string;
+    orphanRecoveredCount: number;
+    close(): Promise<void>;
+}
+export declare function startServer(config: WandConfig, configPath: string): Promise<ServerHandle>;

package/dist/server.js

@@ -20,7 +20,9 @@ import { StructuredSessionManager } from "./structured-session-manager.js";
 import { generatePwaManifest, generateServiceWorker } from "./pwa.js";
 import { getErrorMessage, registerClaudeHistoryRoutes, registerSessionRoutes } from "./server-session-routes.js";
 import { registerUploadRoutes } from "./upload-routes.js";
+import { optimizePrompt, PromptOptimizeError } from "./prompt-optimizer.js";
 import { resolveDatabasePath, WandStorage } from "./storage.js";
+import { isLogBusActive, wandTuiLog } from "./tui/log-bus.js";
 import { renderApp } from "./web-ui/index.js";
 import { WsBroadcastManager } from "./ws-broadcast.js";
 import { checkRateLimit, recordFailedLogin, resetRateLimit } from "./middleware/rate-limit.js";
@@ -445,12 +447,24 @@ process.on("unhandledRejection", (reason) => {
     wandError("未处理的异步错误", msg);
 });
 function wandError(label, message, suggestion) {
+    if (isLogBusActive()) {
+        wandTuiLog("error", `✗ [wand] ${label}：${message}`);
+        if (suggestion)
+            wandTuiLog("error", `  解决方法：${suggestion}`);
+        return;
+    }
     process.stderr.write(`\n✗ [wand] ${label}：${message}\n`);
     if (suggestion)
         process.stderr.write(`  解决方法：${suggestion}\n`);
     process.stderr.write("\n");
 }
 function wandWarn(message, hint) {
+    if (isLogBusActive()) {
+        wandTuiLog("warn", `⚠️  [wand] 警告：${message}`);
+        if (hint)
+            wandTuiLog("warn", `  提示：${hint}`);
+        return;
+    }
     process.stderr.write(`⚠️  [wand] 警告：${message}\n`);
     if (hint)
         process.stderr.write(`  提示：${hint}\n`);
@@ -493,7 +507,6 @@ function getLanguageFromExt(ext, filePath) {
         return "plaintext";
     return map[ext] || "plaintext";
 }
-// ── Main server ──
 export async function startServer(config, configPath) {
     const app = express();
     const storage = new WandStorage(resolveDatabasePath(configPath));
@@ -906,9 +919,31 @@ export async function startServer(config, configPath) {
             updateInFlight = false;
         }
     });
-    registerSessionRoutes(app, processes, structuredSessions, storage, config.defaultMode);
+    registerSessionRoutes(app, processes, structuredSessions, storage, config.defaultMode, config);
     registerClaudeHistoryRoutes(app, processes, storage);
     registerUploadRoutes(app, processes);
+    app.post("/api/optimize-prompt", express.json({ limit: "256kb" }), async (req, res) => {
+        const body = (req.body ?? {});
+        const text = typeof body.text === "string" ? body.text : "";
+        let cwd;
+        if (typeof body.sessionId === "string" && body.sessionId.length > 0) {
+            const snap = storage.getSession(body.sessionId);
+            if (snap?.cwd)
+                cwd = snap.cwd;
+        }
+        try {
+            const optimized = await optimizePrompt(text, config.language ?? "", cwd);
+            res.json({ optimized });
+        }
+        catch (error) {
+            if (error instanceof PromptOptimizeError) {
+                const status = error.code === "EMPTY_INPUT" || error.code === "INPUT_TOO_LONG" ? 400 : 500;
+                res.status(status).json({ error: error.message, errorCode: error.code });
+                return;
+            }
+            res.status(500).json({ error: getErrorMessage(error, "提示词优化失败。") });
+        }
+    });
     // ── Path suggestion ──
     app.get("/api/path-suggestions", async (req, res) => {
         const query = typeof req.query.q === "string" ? req.query.q : "";
@@ -1240,11 +1275,20 @@ export async function startServer(config, configPath) {
             setTimeout(() => process.exit(0), 5000);
         }, 600);
     });
+    let bindAddr = config.host === "0.0.0.0" ? "0.0.0.0" : config.host;
+    const collectedUrls = [];
     await new Promise((resolve, reject) => {
         server.listen(config.port, config.host, () => {
-            const listenAddr = config.host === "0.0.0.0" ? "0.0.0.0 (所有接口)" : config.host;
-            process.stdout.write(`[wand] Web console listening on ${listenAddr}:${config.port}\n` +
-                `[wand] 本地访问: ${protocol}://127.0.0.1:${config.port}\n`);
+            bindAddr = `${config.host}:${config.port}`;
+            const scheme = useHttps ? "HTTPS" : "HTTP";
+            // 主 URL：本机回环；若绑定 0.0.0.0 再补一个对外提示。
+            collectedUrls.push({ url: `${protocol}://127.0.0.1:${config.port}`, scheme });
+            if (config.host === "0.0.0.0") {
+                collectedUrls.push({ url: `${protocol}://0.0.0.0:${config.port}`, scheme });
+            }
+            else if (config.host !== "127.0.0.1" && config.host !== "localhost") {
+                collectedUrls.push({ url: `${protocol}://${config.host}:${config.port}`, scheme });
+            }
             resolve();
         });
         server.on("error", (err) => {
@@ -1336,4 +1380,45 @@ export async function startServer(config, configPath) {
     setInterval(() => {
         performAutoUpdate().catch(() => { });
     }, 30 * 60 * 1000);
+    const close = () => new Promise((resolve) => {
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            try {
+                storage.close();
+            }
+            catch { /* ignore */ }
+            resolve();
+        };
+        try {
+            wss.clients.forEach((c) => c.close());
+        }
+        catch { /* ignore */ }
+        try {
+            wss.close();
+        }
+        catch { /* ignore */ }
+        try {
+            server.close(() => finish());
+        }
+        catch {
+            finish();
+            return;
+        }
+        setTimeout(finish, 3000); // 兜底：3s 内未关完强制 resolve
+    });
+    return {
+        processManager: processes,
+        structuredSessions,
+        configPath,
+        dbPath: resolveDatabasePath(configPath),
+        urls: collectedUrls,
+        bindAddr,
+        httpsEnabled: useHttps,
+        version: PKG_VERSION,
+        orphanRecoveredCount: processes.getOrphanRecoveredCount(),
+        close,
+    };
 }

package/dist/storage.js

@@ -54,12 +54,12 @@ function mapWorktreeMergeFields(row) {
 }
 function sessionSelectFields() {
     return `id, provider, session_kind, runner, command, cwd, mode, status, exit_code, started_at, ended_at, output, archived, archived_at, claude_session_id, messages, queued_messages, structured_state
-             , resumed_from_session_id, resumed_to_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
+             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
 }
 function sessionPersistFields() {
     return `id, command, cwd, mode, status, exit_code, started_at, ended_at, output
              , archived, archived_at, claude_session_id, provider, session_kind, runner, messages, queued_messages, structured_state
-             , resumed_from_session_id, resumed_to_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
+             , resumed_from_session_id, auto_recovered, worktree_enabled, worktree_info, worktree_merge_status, worktree_merge_info`;
 }
 function sessionPersistAssignments() {
     return `command = excluded.command,
@@ -80,7 +80,6 @@ function sessionPersistAssignments() {
              queued_messages = excluded.queued_messages,
              structured_state = excluded.structured_state,
              resumed_from_session_id = excluded.resumed_from_session_id,
-             resumed_to_session_id = excluded.resumed_to_session_id,
              auto_recovered = excluded.auto_recovered,
              worktree_enabled = excluded.worktree_enabled,
              worktree_info = excluded.worktree_info,
@@ -92,7 +91,7 @@ function sessionMetadataAssignments() {
            started_at = ?, ended_at = ?, output = ?,
            archived = ?, archived_at = ?, claude_session_id = ?,
            provider = ?, session_kind = ?, runner = ?, structured_state = ?,
-           resumed_from_session_id = ?, resumed_to_session_id = ?, auto_recovered = ?,
+           resumed_from_session_id = ?, auto_recovered = ?,
            worktree_enabled = ?, worktree_info = ?, worktree_merge_status = ?, worktree_merge_info = ?`;
 }
 function sessionPersistValues(snapshot) {
@@ -116,7 +115,6 @@ function sessionPersistValues(snapshot) {
         snapshot.queuedMessages ? JSON.stringify(snapshot.queuedMessages) : null,
         snapshot.structuredState ? JSON.stringify(snapshot.structuredState) : null,
         snapshot.resumedFromSessionId ?? null,
-        snapshot.resumedToSessionId ?? null,
         snapshot.autoRecovered ? 1 : 0,
         snapshot.worktreeEnabled ? 1 : 0,
         serializeWorktreeInfo(snapshot.worktree),
@@ -142,7 +140,6 @@ function sessionMetadataValues(snapshot) {
         snapshot.runner ?? null,
         snapshot.structuredState ? JSON.stringify(snapshot.structuredState) : null,
         snapshot.resumedFromSessionId ?? null,
-        snapshot.resumedToSessionId ?? null,
         snapshot.autoRecovered ? 1 : 0,
         snapshot.worktreeEnabled ? 1 : 0,
         serializeWorktreeInfo(snapshot.worktree),
@@ -173,7 +170,6 @@ function mapSessionCore(row) {
         queuedMessages: parseQueuedMessages(row.queued_messages),
         structuredState: safeJsonParse(row.structured_state),
         resumedFromSessionId: row.resumed_from_session_id ?? undefined,
-        resumedToSessionId: row.resumed_to_session_id ?? undefined,
         autoRecovered: Boolean(row.auto_recovered),
         worktreeEnabled: Boolean(row.worktree_enabled),
         worktree: parseWorktreeInfo(row.worktree_info) ?? null,
@@ -309,7 +305,7 @@ export class WandStorage {
             this.db
                 .prepare(`INSERT INTO command_sessions (
            ${sessionPersistFields()}
-           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
            ON CONFLICT(id) DO UPDATE SET
              ${sessionPersistAssignments()}`)
                 .run(...sessionPersistValues(snapshot));

package/dist/structured-session-manager.d.ts

@@ -14,15 +14,20 @@ export declare class StructuredSessionManager {
     private readonly config;
     private readonly sessions;
     private readonly pendingChildren;
+    private readonly interruptedWith;
     private emitEvent;
+    private archiveTimer;
     constructor(storage: WandStorage, config: WandConfig);
+    private archiveExpiredSessions;
     setEventEmitter(emitEvent: (event: ProcessEvent) => void): void;
     list(): SessionSnapshot[];
     /** Return lightweight snapshots for the session list (no output/messages). */
     listSlim(): SessionSnapshot[];
     get(id: string): SessionSnapshot | null;
     createSession(options: CreateStructuredSessionOptions): SessionSnapshot;
-    sendMessage(id: string, input: string): Promise<SessionSnapshot>;
+    sendMessage(id: string, input: string, opts?: {
+        interrupt?: boolean;
+    }): Promise<SessionSnapshot>;
     /** Approve a pending permission request. */
     approvePermission(sessionId: string): SessionSnapshot;
     /** Deny a pending permission request. */

package/dist/structured-session-manager.js

@@ -2,9 +2,44 @@ import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { prepareSessionWorktree } from "./git-worktree.js";
 const STREAM_EMIT_DEBOUNCE_MS = 16;
+const ARCHIVE_AFTER_MS = 1000 * 60 * 60 * 24;
 function isRunningAsRoot() {
     return process.getuid?.() === 0 || process.geteuid?.() === 0;
 }
+/**
+ * 找出最后一条 assistant turn 中尚未配对 tool_result 的 AskUserQuestion tool_use。
+ * 用来识别"刚被 SIGTERM 中断、正在等用户提交答案"的状态。
+ */
+function findUnpairedAskUserQuestion(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const turn = messages[i];
+        if (turn.role !== "assistant")
+            continue;
+        for (const block of turn.content) {
+            if (block.type === "tool_use" && block.name === "AskUserQuestion") {
+                const toolUseId = block.id;
+                // 检查后续 turn 中是否已有对应 tool_result
+                let answered = false;
+                for (let j = i + 1; j < messages.length; j++) {
+                    const nextTurn = messages[j];
+                    for (const nb of nextTurn.content) {
+                        if (nb.type === "tool_result" && nb.tool_use_id === toolUseId) {
+                            answered = true;
+                            break;
+                        }
+                    }
+                    if (answered)
+                        break;
+                }
+                if (!answered)
+                    return { id: toolUseId };
+            }
+        }
+        // 只检查最后一条 assistant turn
+        return null;
+    }
+    return null;
+}
 /** Enrich a snapshot with a derived summary from the first user message. */
 function withSummary(snapshot) {
     if (snapshot.summary)
@@ -51,7 +86,9 @@ export class StructuredSessionManager {
     config;
     sessions = new Map();
     pendingChildren = new Map();
+    interruptedWith = new Map();
     emitEvent = null;
+    archiveTimer = null;
     constructor(storage, config) {
         this.storage = storage;
         this.config = config;
@@ -83,6 +120,30 @@ export class StructuredSessionManager {
             this.sessions.set(restored.id, restored);
             this.storage.saveSession(restored);
         }
+        this.archiveExpiredSessions();
+        this.archiveTimer = setInterval(() => {
+            try {
+                this.archiveExpiredSessions();
+            }
+            catch (err) {
+                console.error(`[StructuredSessionManager] archive scan failed: ${String(err)}`);
+            }
+        }, 60 * 1000);
+        this.archiveTimer.unref?.();
+    }
+    archiveExpiredSessions() {
+        const now = Date.now();
+        for (const session of this.sessions.values()) {
+            if (session.archived || session.status === "running")
+                continue;
+            const referenceTime = session.endedAt ?? session.startedAt;
+            const endedAtMs = Date.parse(referenceTime);
+            if (!Number.isFinite(endedAtMs) || now - endedAtMs < ARCHIVE_AFTER_MS)
+                continue;
+            session.archived = true;
+            session.archivedAt = new Date(now).toISOString();
+            this.storage.saveSession(session);
+        }
     }
     setEventEmitter(emitEvent) {
         this.emitEvent = emitEvent;
@@ -155,7 +216,7 @@ export class StructuredSessionManager {
         }
         return snapshot;
     }
-    async sendMessage(id, input) {
+    async sendMessage(id, input, opts) {
         let session = this.requireSession(id);
         const prompt = input.trim();
         if (!prompt)
@@ -181,6 +242,14 @@ export class StructuredSessionManager {
                 this.storage.saveSession(recovered);
                 session = recovered;
             }
+            else if (opts?.interrupt) {
+                this.interruptedWith.set(id, prompt);
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch (_err) { /* ignore */ }
+                return session;
+            }
             else {
                 const queue = [...(session.queuedMessages ?? [])];
                 if (queue.length >= 10) {
@@ -196,10 +265,26 @@ export class StructuredSessionManager {
                 return queued;
             }
         }
-        const userTurn = {
-            role: "user",
-            content: [{ type: "text", text: prompt }],
-        };
+        // 检测上一轮 assistant 是否有未配对的 AskUserQuestion tool_use（说明前一次
+        // child 是被 SIGTERM 主动 kill 的，正在等用户回答）。如果有，把这次的输入打包
+        // 成 tool_result 注入到 messages，让 UI 把卡片渲染为 answered。
+        const pendingAsk = findUnpairedAskUserQuestion(session.messages ?? []);
+        const userTurn = pendingAsk
+            ? {
+                role: "user",
+                content: [
+                    {
+                        type: "tool_result",
+                        tool_use_id: pendingAsk.id,
+                        content: prompt,
+                        is_error: false,
+                    },
+                ],
+            }
+            : {
+                role: "user",
+                content: [{ type: "text", text: prompt }],
+            };
         const requestId = randomUUID();
         const updated = {
             ...session,
@@ -222,8 +307,13 @@ export class StructuredSessionManager {
             sessionId: id,
             data: { status: "running", sessionKind: "structured", queuedMessages: updated.queuedMessages, structuredState: updated.structuredState },
         });
+        // 续接 AskUserQuestion 时给 Claude 加上下文，避免它把刚才悬挂的 tool_use 当作
+        // 异常重试。结构化模式 (claude -p) 没有 tool_result 回传通道，所以用文本告知。
+        const claudePrompt = pendingAsk
+            ? `[对刚才 AskUserQuestion 工具的回答 — 结构化模式不支持工具结果回传，下面是用户从选项中的选择]\n${prompt}`
+            : prompt;
         try {
-            await this.runClaudeStreaming(id, updated, prompt);
+            await this.runClaudeStreaming(id, updated, claudePrompt);
             const finished = this.requireSession(id);
             return finished;
         }
@@ -325,6 +415,7 @@ export class StructuredSessionManager {
     }
     stop(id) {
         const session = this.requireSession(id);
+        this.interruptedWith.delete(id);
         const child = this.pendingChildren.get(id);
         if (child) {
             child.kill();
@@ -529,17 +620,27 @@ export class StructuredSessionManager {
             if (modelChoice && modelChoice !== "default") {
                 args.push("--model", modelChoice);
             }
+            // 托管模式：禁用 AskUserQuestion，让 agent 自己拍板，不要等用户决策。
+            // 非托管模式：保留工具，靠 processLine 检测后主动 kill child 触发"中断+续接"流程。
+            const isManaged = session.mode === "managed";
+            if (isManaged) {
+                args.push("--disallowedTools", "AskUserQuestion");
+            }
             if (session.claudeSessionId) {
                 args.push("--resume", session.claudeSessionId);
             }
-            args.push(prompt);
+            // 通过 stdin 传 prompt，避免被 --allowedTools / --disallowedTools 这类
+            // variadic 参数贪婪吞掉（commander 的 <tools...> 会一直吃 positional 直到
+            // 下一个 flag）。表现为 claude 报 "Input must be provided either through
+            // stdin or as a prompt argument when using --print"。
             const child = spawn("claude", args, {
                 cwd: session.cwd,
                 env: process.env,
-                stdio: ["ignore", "pipe", "pipe"],
+                stdio: ["pipe", "pipe", "pipe"],
             });
-            console.log("[WAND] spawned claude -p pid:", child.pid, "args:", args.filter(a => a !== prompt).join(" "));
+            console.log("[WAND] spawned claude -p pid:", child.pid, "args:", args.join(" "));
             this.pendingChildren.set(sessionId, child);
+            child.stdin?.end(prompt);
             const turnState = {
                 blocks: [],
                 result: "",
@@ -551,6 +652,10 @@ export class StructuredSessionManager {
             let lineBuf = "";
             // Debounce output events to avoid flooding the WebSocket.
             let emitTimer = null;
+            // 当 Claude 在非托管模式调用 AskUserQuestion 时，stdin 关闭导致它会 hang 等
+            // tool_result。我们检测到后主动 kill child，让它顺利退出，UI 把 tool_use 卡片
+            // 渲染成可交互选项；用户提交后由 sendMessage() 通过 --resume 续接。
+            let killedForAskUserQuestion = false;
             const flushEmit = () => {
                 if (emitTimer) {
                     clearTimeout(emitTimer);
@@ -625,6 +730,20 @@ export class StructuredSessionManager {
                     // We only use the authoritative usage from the final "result" event.
                     syncSnapshot();
                     scheduleEmit();
+                    // 非托管模式下检测 AskUserQuestion：claude -p 的 stdin 被 ignore，无法回传
+                    // tool_result，进程会 hang 住。主动 SIGTERM 让它退出；后续用户提交答案时由
+                    // sendMessage() 注入伪造的 tool_result 并通过 --resume 续接。
+                    if (!isManaged && !killedForAskUserQuestion) {
+                        const askBlock = extracted.content.find((b) => b.type === "tool_use" && b.name === "AskUserQuestion");
+                        if (askBlock) {
+                            killedForAskUserQuestion = true;
+                            flushEmit();
+                            try {
+                                child.kill("SIGTERM");
+                            }
+                            catch (_err) { /* ignore */ }
+                        }
+                    }
                     return;
                 }
                 if (parsed && parsed.type === "user" && parsed.message && Array.isArray(parsed.message.content)) {
@@ -746,14 +865,19 @@ export class StructuredSessionManager {
                 else {
                     msgs.push(assistantTurn);
                 }
+                // 被 AskUserQuestion 检测或用户中断主动 kill 时，保持 status="running"
+                // 让 UI 不跳到"已停止"。inFlight=false 才能触发后续 sendMessage。
+                const interruptPrompt = this.interruptedWith.get(sessionId);
+                const keepRunning = killedForAskUserQuestion || !!interruptPrompt;
                 const finished = {
                     ...current,
-                    status: "stopped",
-                    exitCode: 0,
-                    endedAt: new Date().toISOString(),
+                    status: keepRunning ? "running" : "stopped",
+                    exitCode: keepRunning ? null : 0,
+                    endedAt: keepRunning ? null : new Date().toISOString(),
                     output: turnState.result,
                     claudeSessionId: turnState.sessionId ?? current.claudeSessionId,
                     messages: msgs,
+                    queuedMessages: interruptPrompt ? [] : current.queuedMessages,
                     pendingEscalation: null,
                     permissionBlocked: false,
                     structuredState: {
@@ -767,7 +891,26 @@ export class StructuredSessionManager {
                 this.sessions.set(sessionId, finished);
                 this.storage.saveSession(finished);
                 this.emitStructuredSnapshot(finished);
-                this.emitStructuredSnapshot(finished, "ended");
+                if (!keepRunning) {
+                    this.emitStructuredSnapshot(finished, "ended");
+                }
+                // 等待用户回答 AskUserQuestion 时，跳过后续自续接和队列推进。
+                if (killedForAskUserQuestion) {
+                    resolve();
+                    return;
+                }
+                // 用户中断当前回复：保存部分回复后立即发送新消息。
+                if (interruptPrompt) {
+                    this.interruptedWith.delete(sessionId);
+                    console.log("[WAND] interrupt-and-send for session:", sessionId, "prompt:", interruptPrompt.substring(0, 50));
+                    resolve();
+                    setImmediate(() => {
+                        this.sendMessage(sessionId, interruptPrompt).catch((err) => {
+                            console.error("[WAND] interrupt-and-send failed:", err);
+                        });
+                    });
+                    return;
+                }
                 // Auto-continue after plan mode exit: when Claude calls ExitPlanMode,
                 // the `-p` process exits because stdin is "ignore" and it cannot get
                 // user confirmation.  Detect this and automatically resume execution

package/dist/tui/index.d.ts

@@ -0,0 +1,24 @@
+import { ProcessManager } from "../process-manager.js";
+import { StructuredSessionManager } from "../structured-session-manager.js";
+export interface TuiDeps {
+    processManager: ProcessManager;
+    structuredSessions: StructuredSessionManager;
+    version: string;
+    configPath: string;
+    dbPath: string;
+    bindAddr: string;
+    httpsEnabled: boolean;
+    urls: Array<{
+        url: string;
+        scheme: "HTTP" | "HTTPS";
+    }>;
+    orphanRecoveredCount: number;
+    /** 退出 TUI 时调用。返回的 Promise resolve 后 cli 才会 process.exit。 */
+    onExit: (reason: ExitReason) => void | Promise<void>;
+}
+export type ExitReason = "user" | "signal" | "error";
+export interface TuiHandle {
+    isActive: boolean;
+    stop(reason: ExitReason): Promise<void>;
+}
+export declare function startTui(deps: TuiDeps): TuiHandle;