min-agent 0.2.1 → 0.4.0

package/dist/tui/ModelPicker.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, useInput, useStdout } from "ink";
+import { loadConfig, getActiveProvider, fetchModels } from "../config.js";
+import { theme } from "./theme.js";
+/**
+ * Worst-case terminal rows the picker occupies (header/filter + status rows +
+ * list + footer + borders), used by App so the message area never overlaps it.
+ */
+export function modelPickerRows(terminalRows) {
+    const maxListRows = Math.max(4, terminalRows - 11);
+    return Math.min(6 + maxListRows + 3, Math.max(6, terminalRows - 2));
+}
+/**
+ * Interactive model picker — replaces the input bar while open.
+ * - Fetches the provider's model list, falls back to cache
+ * - Type to filter, ↑↓ to navigate, Enter to select, Esc to cancel
+ * - With a non-matching filter, Enter applies the typed name directly
+ * - List is capped so the picker never overflows the terminal
+ */
+export function ModelPicker({ currentModel, onSelect, onCancel }) {
+    const [models, setModels] = useState(null);
+    const [query, setQuery] = useState("");
+    const [index, setIndex] = useState(0);
+    const { stdout } = useStdout();
+    useEffect(() => {
+        let cancelled = false;
+        const cfg = loadConfig();
+        const provider = getActiveProvider(cfg);
+        if (provider?.baseURL && provider?.apiKey) {
+            fetchModels(provider.baseURL, provider.apiKey)
+                .then((m) => {
+                if (!cancelled)
+                    setModels(m);
+            })
+                .catch(() => {
+                if (!cancelled)
+                    setModels([]);
+            });
+        }
+        else {
+            setModels([]);
+        }
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+    const terminalRows = stdout.rows || 24;
+    const maxListRows = Math.max(4, terminalRows - 11); // chrome + status bar + safety
+    const q = query.trim().toLowerCase();
+    const filtered = (models ?? []).filter((m) => m.toLowerCase().includes(q));
+    const shownIndex = Math.min(index, Math.max(0, filtered.length - 1));
+    const windowStart = Math.min(shownIndex, Math.max(0, filtered.length - maxListRows));
+    const shown = filtered.slice(windowStart, windowStart + maxListRows);
+    const extraAbove = windowStart;
+    const extraBelow = filtered.length - (windowStart + shown.length);
+    useEffect(() => {
+        setIndex(0);
+    }, []);
+    useInput((input, key) => {
+        const cleanInput = input.replace(/[\r\n]+$/, "");
+        const isEnter = key.return || /[\r\n]+$/.test(input);
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.pageDown) {
+            if (filtered.length > 0)
+                setIndex((i) => Math.min(filtered.length - 1, i + maxListRows));
+            return;
+        }
+        if (key.pageUp) {
+            if (filtered.length > 0)
+                setIndex((i) => Math.max(0, i - maxListRows));
+            return;
+        }
+        if (filtered.length > 0) {
+            if (key.downArrow) {
+                setIndex((i) => (i + 1) % filtered.length);
+                return;
+            }
+            if (key.upArrow) {
+                setIndex((i) => (i - 1 + filtered.length) % filtered.length);
+                return;
+            }
+        }
+        if (isEnter) {
+            if (filtered.length > 0)
+                onSelect(filtered[shownIndex]);
+            else if (q !== "")
+                onSelect(q);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setQuery((v) => Array.from(v).slice(0, -1).join(""));
+            return;
+        }
+        if (key.ctrl && input === "u") {
+            setQuery("");
+            return;
+        }
+        if (key.ctrl || key.meta || key.tab)
+            return;
+        if (cleanInput)
+            setQuery((v) => v + cleanInput);
+    });
+    const loading = models === null;
+    const empty = models !== null && filtered.length === 0 && q === "";
+    // Debounce filter: avoid re-filtering on every keystroke burst
+    const debouncedQ = q;
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: "100%", borderStyle: "round", borderColor: theme.pickerBorder, paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: theme.pickerBorder, children: "\u9009\u62E9\u6A21\u578B" }), _jsx(Text, { color: theme.muted, children: currentModel ? ` (当前: ${currentModel})` : "" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "\u7B5B\u9009: " }), _jsx(Text, { color: query ? theme.accent : theme.muted, children: query || "输入字符过滤，↑↓/PgUpDn 导航" })] }), loading && (_jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, children: "\u6B63\u5728\u83B7\u53D6\u6A21\u578B\u5217\u8868..." }) })), empty && (_jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, children: "\u65E0\u6CD5\u83B7\u53D6\u6A21\u578B\u5217\u8868\uFF08\u53EF\u8F93\u5165\u6A21\u578B\u540D\u540E\u6309 Enter\uFF09" }) })), models !== null && extraAbove > 0 && (_jsx(Box, { children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2026 \u4E0A\u65B9\u8FD8\u6709 ", extraAbove, " \u4E2A\u6A21\u578B"] }) })), models !== null &&
+                shown.map((m, i) => (_jsxs(Box, { children: [_jsx(Text, { color: i === shownIndex - windowStart ? theme.accent : theme.muted, children: i === shownIndex - windowStart ? "❯ " : "  " }), _jsx(Text, { bold: i === shownIndex - windowStart, color: i === shownIndex - windowStart ? theme.accent : undefined, children: m }), m === currentModel && _jsx(Text, { color: theme.success, children: " \u2190 \u5F53\u524D" })] }, m))), extraBelow > 0 && (_jsx(Box, { children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2026 \u4E0B\u65B9\u8FD8\u6709 ", extraBelow, " \u4E2A\u6A21\u578B\uFF08\u8F93\u5165\u5B57\u7B26\u8FC7\u6EE4\uFF09"] }) })), models !== null && filtered.length === 0 && debouncedQ !== "" && (_jsxs(Box, { children: [_jsxs(Text, { color: theme.accent, bold: true, children: ["\u276F", " "] }), _jsxs(Text, { color: theme.accent, bold: true, children: ["\u4F7F\u7528\u81EA\u5B9A\u4E49\u6A21\u578B: ", debouncedQ] })] })), _jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, wrap: "truncate-end", children: "\u2191\u2193/PgUpDn \u9009\u62E9 \u00B7 Enter \u786E\u8BA4 \u00B7 Esc \u53D6\u6D88" }) })] }));
+}

package/dist/tui/QuestionBar.js

@@ -0,0 +1,136 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { wrapByWidth } from "./text-width.js";
+import { footerMaxRows, innerTextWidth, QUESTION_CHROME_ROWS, sliceLineWindow } from "./layout.js";
+import { theme } from "./theme.js";
+import { normalizeQuestionOptions, normalizeQuestionPrompt } from "../question-format.js";
+export function questionBodyLines(prompt, options, columns) {
+    const textWidth = innerTextWidth(columns);
+    const promptLines = `❓ ${normalizeQuestionPrompt(prompt)}`
+        .split("\n")
+        .flatMap((line) => wrapByWidth(line, textWidth));
+    const optionLines = normalizeQuestionOptions(options).flatMap((o, i) => `   ${i + 1}. ${o}`.split("\n").flatMap((l) => wrapByWidth(l, textWidth)));
+    return { lines: [...promptLines, ...optionLines], promptLineCount: promptLines.length };
+}
+/**
+ * Terminal rows the question bar occupies, mirroring the JSX layout below.
+ * Capped so a huge prompt cannot push the input row off the screen.
+ */
+export function questionBarRows(prompt, options, columns, frameRowCount = 0) {
+    const natural = questionBodyLines(prompt, options, columns).lines.length + QUESTION_CHROME_ROWS;
+    return Math.min(natural, footerMaxRows(frameRowCount, QUESTION_CHROME_ROWS));
+}
+/** Free-form question prompt: type an answer (or a number to pick an option), Enter to submit, Esc to cancel. */
+export function QuestionBar({ prompt, options, onAnswer, columns, maxRows }) {
+    const [value, setValue] = useState("");
+    const [caret, setCaret] = useState(0);
+    const [top, setTop] = useState(0);
+    const { lines, promptLineCount } = useMemo(() => questionBodyLines(prompt, options, columns), [prompt, options, columns]);
+    const bodyMax = Math.max(0, maxRows - QUESTION_CHROME_ROWS);
+    const window = useMemo(() => sliceLineWindow(lines, bodyMax, top), [lines, bodyMax, top]);
+    const scrollable = window.above > 0 || window.below > 0;
+    const choices = normalizeQuestionOptions(options);
+    useInput((input, key) => {
+        if (key.escape) {
+            onAnswer(null);
+            return;
+        }
+        if (key.return) {
+            if (/^\d+$/.test(value.trim()) && choices.length > 0) {
+                const n = parseInt(value.trim(), 10);
+                if (n >= 1 && n <= choices.length) {
+                    onAnswer(choices[n - 1]);
+                    return;
+                }
+            }
+            onAnswer(value.trim());
+            return;
+        }
+        if (scrollable) {
+            const view = Math.max(1, window.lines.length);
+            if (key.upArrow) {
+                setTop((t) => sliceLineWindow(lines, bodyMax, t - 1).start);
+                return;
+            }
+            if (key.downArrow) {
+                setTop((t) => sliceLineWindow(lines, bodyMax, t + 1).start);
+                return;
+            }
+            if (key.pageUp) {
+                setTop((t) => sliceLineWindow(lines, bodyMax, t - view).start);
+                return;
+            }
+            if (key.pageDown) {
+                setTop((t) => sliceLineWindow(lines, bodyMax, t + view).start);
+                return;
+            }
+        }
+        if (key.leftArrow) {
+            setCaret((c) => Math.max(0, c - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            setCaret((c) => Math.min(Array.from(value).length, c + 1));
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (key.backspace) {
+                if (caret === 0)
+                    return;
+                const chars = Array.from(value);
+                chars.splice(caret - 1, 1);
+                setValue(chars.join(""));
+                setCaret((c) => c - 1);
+            }
+            else {
+                const chars = Array.from(value);
+                if (caret >= chars.length)
+                    return;
+                chars.splice(caret, 1);
+                setValue(chars.join(""));
+            }
+            return;
+        }
+        if (key.ctrl && input === "a") {
+            setCaret(0);
+            return;
+        }
+        if (key.ctrl && input === "e") {
+            setCaret(Array.from(value).length);
+            return;
+        }
+        if (key.ctrl && input === "u") {
+            setValue("");
+            setCaret(0);
+            return;
+        }
+        if (key.ctrl && input === "k") {
+            const chars = Array.from(value);
+            chars.splice(caret);
+            setValue(chars.join(""));
+            return;
+        }
+        if (key.ctrl || key.meta)
+            return;
+        if (key.upArrow || key.downArrow || key.tab)
+            return;
+        if (input) {
+            const clean = input.replace(/[\r\n]+$/, "");
+            if (!clean)
+                return;
+            const chars = Array.from(value);
+            const ins = Array.from(clean);
+            chars.splice(caret, 0, ...ins);
+            setValue(chars.join(""));
+            setCaret((c) => c + ins.length);
+        }
+    });
+    const hint = scrollable
+        ? "Enter 提交 · Esc 取消 · ↑↓ 滚动 · 数字选选项"
+        : "Enter 提交 · Esc 取消 · ←→ 光标 · 数字选选项";
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: "100%", borderStyle: "round", borderColor: theme.questionBorder, paddingX: 1, children: [bodyMax > 0 && (_jsxs(Box, { flexDirection: "column", height: bodyMax, overflow: "hidden", flexShrink: 0, width: "100%", children: [window.above > 0 && (_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2026 \u4EE5\u4E0A ", window.above, " \u884C"] }) })), window.lines.map((line, i) => {
+                        const isPrompt = window.start + i < promptLineCount;
+                        return (_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: isPrompt, color: isPrompt ? theme.questionBorder : theme.muted, wrap: "truncate-end", children: line }) }, i));
+                    }), window.below > 0 && (_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2193 \u8FD8\u6709 ", window.below, " \u884C"] }) }))] })), _jsxs(Box, { marginTop: 1, flexShrink: 0, height: 1, overflow: "hidden", width: "100%", children: [_jsxs(Text, { bold: true, color: theme.questionBorder, children: ["\u2192", " "] }), _jsx(Text, { children: Array.from(value).slice(0, caret).join("") }), _jsx(Text, { color: theme.muted, inverse: true, children: " " }), _jsx(Text, { children: Array.from(value).slice(caret).join("") })] }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: theme.muted, dimColor: true, wrap: "truncate-end", children: hint }) })] }));
+}

package/dist/tui/SessionPicker.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text, useInput, useStdout } from "ink";
+import { listSessions } from "../sessions.js";
+import { theme } from "./theme.js";
+export function sessionPickerRows(terminalRows) {
+    const maxListRows = Math.max(4, terminalRows - 11);
+    return Math.min(6 + maxListRows + 3, Math.max(6, terminalRows - 2));
+}
+function label(s) {
+    const date = s.updated.split("T")[0] ?? "";
+    return `${s.id}  ${date}  ${s.title} (${s.messageCount})`;
+}
+export function SessionPicker({ currentId, onSelect, onCancel }) {
+    const sessions = listSessions();
+    const [query, setQuery] = useState("");
+    const [index, setIndex] = useState(0);
+    const { stdout } = useStdout();
+    const terminalRows = stdout.rows || 24;
+    const maxListRows = Math.max(4, terminalRows - 11);
+    const q = query.trim().toLowerCase();
+    const filtered = sessions.filter((s) => s.id.toLowerCase().includes(q) || s.title.toLowerCase().includes(q));
+    const shownIndex = Math.min(index, Math.max(0, filtered.length - 1));
+    const windowStart = Math.min(shownIndex, Math.max(0, filtered.length - maxListRows));
+    const shown = filtered.slice(windowStart, windowStart + maxListRows);
+    const extraAbove = windowStart;
+    const extraBelow = filtered.length - (windowStart + shown.length);
+    useEffect(() => {
+        setIndex(0);
+    }, []);
+    useInput((input, key) => {
+        const cleanInput = input.replace(/[\r\n]+$/, "");
+        const isEnter = key.return || /[\r\n]+$/.test(input);
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.pageDown) {
+            if (filtered.length > 0)
+                setIndex((i) => Math.min(filtered.length - 1, i + maxListRows));
+            return;
+        }
+        if (key.pageUp) {
+            if (filtered.length > 0)
+                setIndex((i) => Math.max(0, i - maxListRows));
+            return;
+        }
+        if (filtered.length > 0) {
+            if (key.downArrow) {
+                setIndex((i) => (i + 1) % filtered.length);
+                return;
+            }
+            if (key.upArrow) {
+                setIndex((i) => (i - 1 + filtered.length) % filtered.length);
+                return;
+            }
+        }
+        if (isEnter) {
+            if (filtered.length > 0)
+                onSelect(filtered[shownIndex].id);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setQuery((v) => Array.from(v).slice(0, -1).join(""));
+            return;
+        }
+        if (key.ctrl && input === "u") {
+            setQuery("");
+            return;
+        }
+        if (key.ctrl || key.meta || key.tab)
+            return;
+        if (cleanInput)
+            setQuery((v) => v + cleanInput);
+    });
+    const empty = filtered.length === 0 && q === "";
+    const noMatch = filtered.length === 0 && q !== "";
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: "100%", borderStyle: "round", borderColor: theme.pickerBorder, paddingX: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: theme.pickerBorder, children: "\u9009\u62E9\u4F1A\u8BDD" }), _jsx(Text, { color: theme.muted, children: currentId ? ` (当前: ${currentId})` : "" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "\u7B5B\u9009: " }), _jsx(Text, { color: query ? theme.accent : theme.muted, children: query || "输入字符过滤标题或 id" })] }), empty && (_jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, children: "\u65E0\u5DF2\u4FDD\u5B58\u7684\u4F1A\u8BDD" }) })), noMatch && (_jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, children: "\u6CA1\u6709\u5339\u914D\u7684\u4F1A\u8BDD" }) })), extraAbove > 0 && (_jsx(Box, { children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2026 \u4E0A\u65B9\u8FD8\u6709 ", extraAbove, " \u4E2A\u4F1A\u8BDD"] }) })), shown.map((s, i) => (_jsxs(Box, { children: [_jsx(Text, { color: i === shownIndex - windowStart ? theme.accent : theme.muted, children: i === shownIndex - windowStart ? "❯ " : "  " }), _jsx(Text, { bold: i === shownIndex - windowStart, color: i === shownIndex - windowStart ? theme.accent : undefined, wrap: "truncate-end", children: label(s) }), s.id === currentId && _jsx(Text, { color: theme.success, children: " \u2190" })] }, s.id))), extraBelow > 0 && (_jsx(Box, { children: _jsxs(Text, { color: theme.muted, dimColor: true, children: ["\u2026 \u4E0B\u65B9\u8FD8\u6709 ", extraBelow, " \u4E2A\u4F1A\u8BDD"] }) })), _jsx(Box, { children: _jsx(Text, { color: theme.muted, dimColor: true, wrap: "truncate-end", children: "\u2191\u2193/PgUpDn \u9009\u62E9 \u00B7 Enter \u786E\u8BA4 \u00B7 Esc \u53D6\u6D88" }) })] }));
+}

package/dist/tui/StatusBar.js

@@ -1,16 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
-export function StatusBar({ state }) {
+import { formatTokenStatusLabel } from "../token-display.js";
+import { displayWidth } from "./text-width.js";
+export function StatusBar({ state, columns = 80 }) {
     const model = state.model || "unknown";
-    const tokens = state.tokenInfo;
-    let bar = "";
-    let barColor = "green";
-    if (tokens && tokens.contextWindow > 0) {
-        const pct = Math.round((tokens.input / tokens.contextWindow) * 100);
-        const filled = Math.round(pct / 10);
-        const empty = 10 - filled;
-        bar = `${tokens.input}/${tokens.contextWindow} ${"█".repeat(filled)}${"░".repeat(empty)} ${pct}%`;
-        barColor = pct >= 80 ? "red" : pct >= 50 ? "yellow" : "green";
-    }
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "─".repeat(60) }), _jsxs(Box, { children: [_jsx(Text, { children: " \uD83E\uDD16 min-agent" }), _jsxs(Text, { color: "gray", children: [" (", model, ")"] }), bar && (_jsxs(_Fragment, { children: [_jsx(Text, { children: "  " }), _jsx(Text, { color: barColor, children: bar })] }))] })] }));
+    const tokensLabel = state.tokenInfo ? formatTokenStatusLabel(state.tokenInfo) : "";
+    // Transient copy feedback rides on the separator row itself (right end) so
+    // it never adds a row and the layout does not jump while it is visible.
+    const sepWidth = Math.max(8, columns - 2);
+    const notice = state.copyNotice
+        ? `✓ ${state.copyNotice}`
+        : state.selectionMode
+            ? "选择模式  ↑↓←→扩选  Enter复制  Esc退出"
+            : null;
+    const noticeWidth = notice ? displayWidth(notice) : 0;
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: "100%", children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: notice ? `${"─".repeat(Math.max(0, sepWidth - noticeWidth - 2))}  ${notice}` : "─".repeat(sepWidth) }), _jsxs(Box, { children: [_jsx(Text, { children: " \uD83E\uDD16 min-agent" }), _jsxs(Text, { color: "gray", wrap: "truncate-end", children: [" ", "(", model, ")"] }), tokensLabel && (_jsxs(_Fragment, { children: [_jsx(Text, { children: "  " }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: tokensLabel })] }))] })] }));
 }

package/dist/tui/agent-runner.js

@@ -0,0 +1,223 @@
+export function createAgentRunner(deps) {
+    let abortController = null;
+    const getController = () => abortController;
+    const abort = (tui) => {
+        if (!abortController)
+            return false;
+        import("../tools/bash.js").then((m) => m.killActiveProcesses()).catch(() => { });
+        abortController.abort();
+        abortController = null;
+        tui.setRunning(false);
+        tui.addMessage({ id: `sys-${Date.now()}`, role: "system", content: "(已取消)", timestamp: Date.now() });
+        return true;
+    };
+    const run = async () => {
+        const turnStart = deps.messages.length;
+        const uiStart = deps.tui.messageCount();
+        let compactedDuringRun = false;
+        abortController = new AbortController();
+        deps.tui.setRunning(true, "思考中...");
+        const { summarizeToolCall, summarizeToolResult, toolResultText } = await import("../tool-display.js");
+        const { getContextWindowInfo } = await import("../context-window.js");
+        const { getModelPrice, estimateCost, formatCost } = await import("../pricing.js");
+        const { runOnceWithSystem, emptyResponseMessage, WRAP_UP_MESSAGE } = await import("../agent.js");
+        const { clearStack, pushTurn } = await import("./undo-stack.js");
+        const { setSubAgentListener } = await import("../tools/task.js");
+        const { LOOP_HALT_MESSAGE } = await import("../doom-loop.js");
+        const { createSaveThrottle } = await import("../save-throttle.js");
+        const { snapshotTokenInfo } = await import("./token-info.js");
+        // Persist while the run is in flight so a crash/kill does not lose the turn.
+        const saveThrottle = createSaveThrottle(() => deps.persist?.());
+        const billedInAtStart = deps.tracker.totalInputTokens;
+        const billedOutAtStart = deps.tracker.totalOutputTokens;
+        let tokenTimer = null;
+        let tokenPaintSeq = 0;
+        const applyTokenInfo = async () => {
+            const seq = ++tokenPaintSeq;
+            const info = await snapshotTokenInfo(deps.tracker, deps.getModel(), deps.messages);
+            if (seq !== tokenPaintSeq)
+                return;
+            deps.tui.setTokenInfo(info);
+        };
+        const scheduleTokenInfo = () => {
+            if (tokenTimer != null)
+                return;
+            tokenTimer = setTimeout(() => {
+                tokenTimer = null;
+                void applyTokenInfo();
+            }, 50);
+        };
+        const flushTokenInfo = async () => {
+            if (tokenTimer != null) {
+                clearTimeout(tokenTimer);
+                tokenTimer = null;
+            }
+            await applyTokenInfo();
+        };
+        const unsubscribeTokens = deps.tracker.subscribe(scheduleTokenInfo);
+        void applyTokenInfo();
+        const callbacks = {
+            onAssistantDisplayDelta: (delta) => deps.tui.appendToLast(delta),
+            onThinkingDelta: (delta) => {
+                deps.tui.setRunning(true, "推理中...");
+                deps.tui.appendToThinking(delta);
+            },
+            onToolCall: (toolName, input, toolCallId) => {
+                deps.tui.setRunning(true, `执行 ${toolName}...`);
+                deps.tui.addMessage({
+                    id: `tool-${toolCallId || `${Date.now()}-${Math.random().toString(36).slice(2, 6)}`}`,
+                    role: "tool",
+                    content: summarizeToolCall(toolName, input),
+                    toolName,
+                    toolCallId,
+                    timestamp: Date.now(),
+                });
+            },
+            onToolResult: (toolName, output, meta) => {
+                deps.tui.setRunning(true, "思考中...");
+                deps.tui.setToolResult(meta.toolCallId, toolName, summarizeToolResult(toolName, output, meta.isError), toolResultText(output), meta.isError);
+            },
+            onStreamError: (msg) => {
+                deps.tui.addMessage({ id: `err-${Date.now()}`, role: "system", content: `错误: ${msg}`, timestamp: Date.now() });
+            },
+            onCompaction: (line) => {
+                compactedDuringRun = true;
+                deps.setUndoStack(clearStack(deps.getUndoStack()));
+                if (line === "compacting_start") {
+                    deps.tui.addMessage({
+                        id: `compact-${Date.now()}`,
+                        role: "system",
+                        content: "正在整理过长的对话记录…",
+                        timestamp: Date.now(),
+                    });
+                }
+                else if (line.startsWith("compacted_ok")) {
+                    deps.tui.addMessage({
+                        id: `compact-ok-${Date.now()}`,
+                        role: "system",
+                        content: "✓ 已整理对话记录，继续执行",
+                        timestamp: Date.now(),
+                    });
+                }
+            },
+            onRetryNotice: (info) => {
+                deps.tui.addMessage({
+                    id: `retry-${Date.now()}`,
+                    role: "system",
+                    content: info.kind === "wrap_up"
+                        ? "⟳ 本轮预算用尽，正在收尾…"
+                        : `⟳ 模型返回空响应，重试 ${info.attempt}/${info.maxAttempts}…`,
+                    timestamp: Date.now(),
+                });
+            },
+            onRunFinish: async (info) => {
+                abortController = null;
+                deps.tui.setRunning(false);
+                await flushTokenInfo();
+                if (info.aborted)
+                    return;
+                if (info.budgetExceeded)
+                    deps.tui.addMessage({
+                        id: `budget-${Date.now()}`,
+                        role: "system",
+                        content: "⚠ 已达到预算上限。/budget 查看或调高",
+                        timestamp: Date.now(),
+                    });
+                const runInput = Math.max(0, deps.tracker.totalInputTokens - billedInAtStart);
+                const runOutput = Math.max(0, deps.tracker.totalOutputTokens - billedOutAtStart);
+                const occupied = deps.tracker.lastInputTokens;
+                if (runInput > 0 || runOutput > 0 || occupied > 0) {
+                    const ctx = await getContextWindowInfo(deps.getModel());
+                    const pct = ctx.tokens > 0 && occupied > 0 ? Math.round((occupied / ctx.tokens) * 100) : null;
+                    const price = await getModelPrice(deps.getModel() ?? "");
+                    const cost = estimateCost({ inputTokens: runInput, outputTokens: runOutput }, price);
+                    const parts = [
+                        `Done in ${info.stepCount} step(s)`,
+                        `Tokens: ${runInput} in / ${runOutput} out / ${runInput + runOutput} total`,
+                        ...(pct != null ? [`Context: ${pct}%`] : []),
+                        ...(cost != null ? [`约 ${formatCost(cost)}`] : []),
+                    ];
+                    deps.tui.addMessage({
+                        id: `done-${Date.now()}`,
+                        role: "system",
+                        content: parts.join(" | "),
+                        timestamp: Date.now(),
+                    });
+                }
+                if (info.maxStepsReached)
+                    deps.tui.addMessage({
+                        id: `maxsteps-${Date.now()}`,
+                        role: "system",
+                        content: "⚠ 已达到自动续跑上限，发送消息继续",
+                        timestamp: Date.now(),
+                    });
+                if (info.stopped)
+                    deps.tui.addMessage({
+                        id: `stopped-${Date.now()}`,
+                        role: "system",
+                        content: `⚠ ${LOOP_HALT_MESSAGE}`,
+                        timestamp: Date.now(),
+                    });
+                else if (info.wrapUp)
+                    deps.tui.addMessage({
+                        id: `wrapup-${Date.now()}`,
+                        role: "system",
+                        content: `⚠ ${WRAP_UP_MESSAGE}`,
+                        timestamp: Date.now(),
+                    });
+                else if (info.emptyResponse)
+                    deps.tui.addMessage({
+                        id: `empty-${Date.now()}`,
+                        role: "system",
+                        content: `⚠ ${emptyResponseMessage(info.emptyAttempts ?? 0)}`,
+                        timestamp: Date.now(),
+                    });
+                else if (info.incomplete)
+                    deps.tui.addMessage({
+                        id: `incomplete-${Date.now()}`,
+                        role: "system",
+                        content: "还没有完整回复，发送消息可继续",
+                        timestamp: Date.now(),
+                    });
+            },
+        };
+        try {
+            setSubAgentListener((ev) => {
+                if (ev.phase !== "call")
+                    return;
+                deps.tui.appendToolChild(ev.parentToolCallId, {
+                    name: ev.name,
+                    summary: summarizeToolCall(ev.name, ev.input),
+                });
+            });
+            const runOptions = {
+                providerName: deps.getProvider(),
+                taskState: deps.getTaskState(),
+                onStepPersist: () => saveThrottle.request(),
+                ...(deps.getPlanMode() ? { planMode: true } : {}),
+            };
+            await runOnceWithSystem(deps.messages, deps.getSystemPrompt(), deps.getModel(), abortController?.signal, callbacks, deps.tracker, runOptions);
+        }
+        catch (err) {
+            if (!abortController)
+                return;
+            const msg = err instanceof Error ? err.message : String(err);
+            callbacks.onStreamError(msg);
+        }
+        finally {
+            unsubscribeTokens();
+            if (tokenTimer != null) {
+                clearTimeout(tokenTimer);
+                tokenTimer = null;
+            }
+            setSubAgentListener(null);
+            saveThrottle.cancel();
+            if (!compactedDuringRun)
+                deps.setUndoStack(pushTurn(deps.getUndoStack(), turnStart, deps.messages.length, uiStart));
+            abortController = null;
+            deps.tui.setRunning(false);
+            await flushTokenInfo();
+        }
+    };
+    return { run, abort, getController };
+}