min-agent 0.2.1 → 0.3.0

package/dist/tui/slash-handler.js

@@ -0,0 +1,370 @@
+export function sysMsg(tui, content) {
+    tui.addMessage({
+        id: `sys-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        role: "system",
+        content,
+        timestamp: Date.now(),
+    });
+}
+export async function handleSlashCommand(input, tui, messages, currentModel, tracker, setModel, requestExit, state) {
+    const { parseSlashArgs } = await import("./slash-commands.js");
+    const parsed = parseSlashArgs(input);
+    const rawParts = input.slice(1).trim().split(/\s+/);
+    const cmd = (parsed?.command || rawParts[0] || "").toLowerCase();
+    const rest = parsed ? [...parsed.tokens, ...(parsed.partial ? [parsed.partial] : [])] : rawParts.slice(1);
+    const arg = rest.join(" ");
+    const { truncateDisplay } = await import("../tool-display.js");
+    switch (cmd) {
+        case "exit":
+        case "quit":
+        case "q":
+            requestExit();
+            break;
+        case "clear": {
+            const { clearStack } = await import("./undo-stack.js");
+            messages.length = 0;
+            tui.update({ messages: [] });
+            state.setUndoStack(clearStack(state.undoStack));
+            sysMsg(tui, "✓ 对话已清除");
+            break;
+        }
+        case "undo": {
+            const { popTurn } = await import("./undo-stack.js");
+            const popped = popTurn(state.undoStack);
+            if (!popped) {
+                sysMsg(tui, "没有可撤销的内容");
+                break;
+            }
+            state.setUndoStack(popped.stack);
+            messages.splice(popped.turn.start, popped.turn.end - popped.turn.start);
+            tui.truncateMessages(popped.turn.uiEnd);
+            sysMsg(tui, "✓ 已撤销 1 轮");
+            break;
+        }
+        case "redo": {
+            if (!state.lastUserMessage) {
+                sysMsg(tui, "没有可重发的消息");
+                break;
+            }
+            const text = state.lastUserMessage;
+            tui.addMessage({ id: `user-${Date.now()}`, role: "user", content: text, timestamp: Date.now() });
+            messages.push({ role: "user", content: text });
+            return "run";
+        }
+        case "diff": {
+            const { getWorkingTreeDiff } = await import("./diff-view.js");
+            const result = await getWorkingTreeDiff();
+            if (!result.ok) {
+                const msg = result.reason === "not_git" ? "非 git 仓库，无法显示 diff" : result.reason === "no_changes" ? "工作区无未提交变更" : `diff 失败: ${result.message}`;
+                sysMsg(tui, msg);
+            }
+            else
+                sysMsg(tui, result.diff);
+            break;
+        }
+        case "plan": {
+            state.togglePlanMode();
+            sysMsg(tui, state.planMode ? "✓ 计划模式已开启：仅只读工具可用，输出计划后再次输入 /plan 确认并执行" : "✓ 已退出计划模式");
+            break;
+        }
+        case "sessions": {
+            const { listSessions } = await import("../sessions.js");
+            const sessions = listSessions();
+            if (sessions.length === 0)
+                sysMsg(tui, "无已保存的会话");
+            else {
+                const header = state.sessionId ? "" : "  (当前会话未保存)\n";
+                const lines = sessions.map((s) => {
+                    const current = state.sessionId === s.id ? " ← 当前" : "";
+                    const date = s.updated.split("T")[0];
+                    return `  ${s.id}  ${date}  ${s.title} (${s.messageCount} msgs)${current}`;
+                });
+                sysMsg(tui, `会话 (${sessions.length}):\n${header}${lines.join("\n")}\n\n恢复: min-agent chat --resume <id>`);
+            }
+            break;
+        }
+        case "rename": {
+            const title = arg.trim();
+            if (!title) {
+                sysMsg(tui, "用法: /rename <标题>");
+                break;
+            }
+            const { saveSession, renameSession } = await import("../sessions.js");
+            let id = state.sessionId;
+            if (!id) {
+                id = saveSession(messages);
+                state.setSessionId(id);
+            }
+            if (renameSession(id, title))
+                sysMsg(tui, `✓ 会话已重命名为: ${title}`);
+            else
+                sysMsg(tui, "重命名失败: 会话不存在");
+            break;
+        }
+        case "attach":
+        case "image": {
+            const filePath = arg;
+            if (!filePath) {
+                sysMsg(tui, "用法: /attach <图片路径>");
+                break;
+            }
+            const { loadImageParts } = await import("../agent.js");
+            const notify = (kind, imgPath) => {
+                if (kind === "not_found")
+                    sysMsg(tui, `⚠ 图片不存在: ${imgPath}`);
+                else if (kind === "too_large")
+                    sysMsg(tui, `⚠ 图片超过 5MB 限制: ${imgPath}`);
+            };
+            const parts = [{ type: "text", text: "" }, ...loadImageParts([filePath], notify)];
+            if (parts.length <= 1)
+                break;
+            messages.push({ role: "user", content: parts });
+            tui.addMessage({ id: `user-${Date.now()}`, role: "user", content: `[📎 图片] ${filePath}`, timestamp: Date.now() });
+            return "run";
+        }
+        case "compact": {
+            const { compactMessages } = await import("../compaction.js");
+            const { estimateTokens } = await import("../compaction.js");
+            const { resolveModel } = await import("../provider.js");
+            const { clearStack } = await import("./undo-stack.js");
+            if (messages.length < 4)
+                sysMsg(tui, "消息太少，无需压缩");
+            else {
+                sysMsg(tui, "⟳ 正在压缩上下文...");
+                const model = resolveModel(currentModel);
+                state.setUndoStack(clearStack(state.undoStack));
+                const result = await compactMessages(messages, model, { keepRecentTurns: 2, autoContinue: false });
+                messages.length = 0;
+                messages.push(...result.messages);
+                if (tracker)
+                    tracker.resetContext();
+                sysMsg(tui, `✓ 已压缩 (约 ${estimateTokens(messages)} tokens)`);
+            }
+            break;
+        }
+        case "provider": {
+            const { loadConfig, saveConfig } = await import("../config.js");
+            const cfg = loadConfig();
+            const providers = cfg.providers ?? [];
+            if (arg) {
+                const target = providers.find((p) => p.name === arg);
+                if (!target) {
+                    sysMsg(tui, `Provider "${arg}" 不存在`);
+                    break;
+                }
+                cfg.activeProvider = arg;
+                saveConfig(cfg);
+                setModel(target.defaultModel ?? "");
+                sysMsg(tui, `✓ 当前 Provider 已切换为: ${arg}`);
+            }
+            else {
+                if (providers.length === 0) {
+                    sysMsg(tui, "无已配置 Provider，运行: min-agent setup");
+                    break;
+                }
+                const lines = providers.map((p) => {
+                    const cur = p.name === cfg.activeProvider ? " ← 当前" : "";
+                    return `  ${p.name}  ${p.baseURL}${cur}`;
+                });
+                sysMsg(tui, `Providers:\n${lines.join("\n")}\n\n切换: /provider <name>`);
+            }
+            break;
+        }
+        case "model": {
+            if (arg) {
+                const config = await import("../config.js");
+                const cfg = config.loadConfig();
+                const provider = config.getActiveProvider(cfg);
+                if (provider) {
+                    provider.defaultModel = arg;
+                    config.saveConfig(cfg);
+                }
+                setModel(arg);
+                sysMsg(tui, `✓ 默认模型已设为: ${arg}`);
+            }
+            else
+                tui.showModelPicker();
+            break;
+        }
+        case "models": {
+            const { fetchModels } = await import("../config.js");
+            const { loadConfig, getActiveProvider } = await import("../config.js");
+            const cfg = loadConfig();
+            const provider = getActiveProvider(cfg);
+            if (!provider?.baseURL || !provider?.apiKey) {
+                sysMsg(tui, "未配置 Provider，运行: min-agent setup");
+                break;
+            }
+            sysMsg(tui, "正在获取模型列表...");
+            const models = await fetchModels(provider.baseURL, provider.apiKey);
+            if (models.length === 0)
+                sysMsg(tui, "无法获取模型列表");
+            else {
+                const lines = models.map((m) => {
+                    const marker = m === provider.defaultModel ? " ← 默认" : "";
+                    return `  ${m}${marker}`;
+                });
+                sysMsg(tui, `可用模型 (${models.length}):\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "memory": {
+            if (arg) {
+                const { addMemory } = await import("../memory.js");
+                addMemory(arg);
+                sysMsg(tui, `✓ 已保存记忆: "${arg}"`);
+            }
+            else {
+                const { loadMemories } = await import("../memory.js");
+                const memories = loadMemories();
+                if (memories.length === 0)
+                    sysMsg(tui, "无已保存的记忆");
+                else {
+                    const lines = memories.map((m, i) => {
+                        const tags = m.tags.length > 0 ? ` [${m.tags.join(", ")}]` : "";
+                        return `  #${i + 1}: ${m.content}${tags}`;
+                    });
+                    sysMsg(tui, `记忆 (${memories.length}):\n${lines.join("\n")}`);
+                }
+            }
+            break;
+        }
+        case "path":
+        case "pwd":
+            sysMsg(tui, process.cwd());
+            break;
+        case "paste": {
+            const { getClipboardImage } = await import("../clipboard.js");
+            const img = getClipboardImage();
+            if (!img) {
+                sysMsg(tui, "剪贴板中未找到图片");
+                break;
+            }
+            sysMsg(tui, `📎 剪贴板图片 (${(img.data.length / 1024).toFixed(1)} KB)`);
+            const text = arg || "What's in this image?";
+            const content = [{ type: "text", text }, { type: "image", image: img.data, mimeType: img.mimeType }];
+            messages.push({ role: "user", content });
+            tui.addMessage({ id: `user-${Date.now()}`, role: "user", content: `${text} [📎 图片]`, timestamp: Date.now() });
+            return "run";
+        }
+        case "tokens": {
+            const { getContextWindow } = await import("../context-window.js");
+            const { getModelPrice, estimateCost, formatCost } = await import("../pricing.js");
+            const { estimateTokens } = await import("../compaction.js");
+            if (tracker && tracker.lastInputTokens > 0) {
+                const ctxWindow = await getContextWindow(currentModel);
+                const pct = Math.round((tracker.lastInputTokens / ctxWindow) * 100);
+                const price = await getModelPrice(currentModel ?? "");
+                const cost = estimateCost({ inputTokens: tracker.totalInputTokens, outputTokens: tracker.totalOutputTokens }, price);
+                sysMsg(tui, [`Context: ${tracker.lastInputTokens} / ${ctxWindow} tokens (${pct}%)`, `Total: ${tracker.totalInputTokens} in / ${tracker.totalOutputTokens} out`, ...(cost != null ? [`Cost: 约 ${formatCost(cost)}`] : []), `Messages: ${messages.length}`].join("\n"));
+            }
+            else
+                sysMsg(tui, `估算 tokens: ${estimateTokens(messages)} | Messages: ${messages.length}`);
+            break;
+        }
+        case "budget": {
+            const { loadConfig, saveConfig } = await import("../config.js");
+            const { getModelPrice, estimateCost, formatCost } = await import("../pricing.js");
+            const cfg = loadConfig();
+            const maxCost = cfg.budget?.maxCostUSD;
+            if (arg) {
+                const n = parseFloat(arg);
+                if (isNaN(n) || n <= 0) {
+                    sysMsg(tui, "用法: /budget <USD 金额>");
+                    break;
+                }
+                cfg.budget = { maxCostUSD: n };
+                saveConfig(cfg);
+                sysMsg(tui, `✓ 预算上限已设为: $${n}`);
+                break;
+            }
+            const price = await getModelPrice(currentModel ?? "");
+            const cost = estimateCost({ inputTokens: tracker.totalInputTokens, outputTokens: tracker.totalOutputTokens }, price);
+            const costStr = cost != null ? `约 ${formatCost(cost)}` : "--";
+            sysMsg(tui, maxCost != null ? `预算: 已用${costStr} / 上限 $${maxCost}\n设置: /budget <金额>` : `预算: 已用${costStr} / 未设置上限\n设置: /budget <金额>`);
+            break;
+        }
+        case "mcp": {
+            const { loadMcpConfig } = await import("../mcp.js");
+            const { getMcpStatus } = await import("../mcp.js");
+            const config = loadMcpConfig();
+            const servers = Object.entries(config.mcpServers);
+            if (servers.length === 0)
+                sysMsg(tui, "无 MCP 服务器配置");
+            else {
+                const status = getMcpStatus();
+                const lines = servers.map(([name, cfg]) => {
+                    const disabled = cfg.enabled === false;
+                    const st = status[name];
+                    const connected = st?.connected ?? false;
+                    const toolCount = st?.tools.length ?? 0;
+                    const state = disabled ? "disabled" : connected ? "connected" : "disconnected";
+                    const err = !disabled && !connected && st?.error ? ` — ${st.error}` : "";
+                    return `  ${name}: ${state}${toolCount > 0 ? ` (${toolCount} tools)` : ""}${err}`;
+                });
+                sysMsg(tui, `MCP 服务器 (${servers.length}):\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "skills": {
+            const { discoverSkills, getAllSkills, getSkill, getStaleDisabledSkills, setSkillEnabled } = await import("../skills.js");
+            discoverSkills({ silent: true });
+            const tokens = rest.filter(Boolean);
+            const action = tokens[0];
+            const all = getAllSkills().sort((a, b) => a.name.localeCompare(b.name));
+            if (action === "enable" || action === "disable") {
+                const scope = tokens.includes("--project") ? "project" : "global";
+                const names = tokens.slice(1).filter((t) => t !== "--project" && t !== "--global");
+                if (names.length === 0) {
+                    sysMsg(tui, `用法: /skills ${action} <name...> [--project]`);
+                    break;
+                }
+                const known = new Set(all.map((s) => s.name));
+                const unknown = names.filter((n) => !known.has(n));
+                if (unknown.length > 0) {
+                    sysMsg(tui, `未找到 skill: ${unknown.join(", ")}\n可用: ${known.size ? [...known].join(", ") : "无"}`);
+                    break;
+                }
+                const results = setSkillEnabled(names, action === "enable", scope);
+                const notes = results.filter((r) => r.blockedBy).map((r) => `  ⚠ ${r.name} 仍为${r.enabled ? "启用" : "禁用"}（被 ${r.blockedBy} 范围覆盖）`);
+                sysMsg(tui, [`✓ 已${action === "enable" ? "启用" : "禁用"}(${scope}): ${names.join(", ")}`, ...notes].join("\n"));
+                break;
+            }
+            if (action === "info") {
+                const name = tokens[1];
+                const skill = name ? getSkill(name) : undefined;
+                if (!skill) {
+                    sysMsg(tui, `未找到 skill: ${name ?? "(未指定)"}\n可用: ${all.length ? all.map((s) => s.name).join(", ") : "无"}`);
+                    break;
+                }
+                const status = skill.enabled ? "enabled" : `disabled(${skill.disabledScope === "project" ? "proj" : "glob"})`;
+                const meta = [`Name:        ${skill.name}`, `Status:      ${status}`, ...(skill.version ? [`Version:     ${skill.version}`] : []), `Description: ${skill.description.replace(/\s+/g, " ")}`, `Location:    ${skill.location}`, ...(skill.allowedTools.length ? [`Tools:       ${skill.allowedTools.join(", ")}`] : []), ...(skill.requiredBins.length ? [`Requires:    ${skill.requiredBins.join(", ")}`] : [])];
+                const content = skill.content.trim();
+                sysMsg(tui, [...meta, ...(content ? ["", "--- Content ---", "", content.slice(0, 4000)] : [])].join("\n"));
+                break;
+            }
+            if (action && action !== "list") {
+                sysMsg(tui, "用法: /skills [list|info <name>|enable <name...> [--project]|disable <name...> [--project]]");
+                break;
+            }
+            const stale = getStaleDisabledSkills();
+            if (all.length === 0 && stale.length === 0) {
+                sysMsg(tui, "无可用 skills。添加 SKILL.md 到 .min-agent/skills/<name>/");
+                break;
+            }
+            const lines = all.map((s) => {
+                const status = s.enabled ? "enabled" : `disabled(${s.disabledScope === "project" ? "proj" : "glob"})`;
+                return `  ${s.name}  ${status}  ${truncateDisplay(s.description.replace(/\s+/g, " "), 56)}`;
+            });
+            if (stale.length > 0)
+                lines.push(`  ⚠ disabledSkills/enabledSkills 中无对应 skill: ${stale.join(", ")}`);
+            sysMsg(tui, `Skills (${all.filter((s) => s.enabled).length} enabled / ${all.length}):\n${lines.join("\n")}\n切换: /skills disable <name> [--project]`);
+            break;
+        }
+        case "help":
+            sysMsg(tui, ["命令:", "  输入 / 弹出命令菜单 (↑↓ 选择, Enter 执行, Esc 关闭)", "  /clear        清除对话历史", "  /compact      压缩上下文", "  /model [n]    交互式选择/切换模型", "  /models       列出可用模型", "  /provider [n] 查看/切换 Provider", "  /memory [t]   查看/保存记忆", "  /tokens       显示 token 用量与成本", "  /budget [n]   查看/设置预算上限 (USD)", "  /undo         撤销上一轮", "  /redo         重发最后一条消息", "  /diff         显示工作区未提交变更", "  /plan         切换只读计划模式", "  /sessions     列出已保存会话", "  /rename <t>   重命名当前会话", "  /attach <p>   附加本地图片", "  /mcp          显示 MCP 状态", "  /skills       显示/启用/禁用 skills（/skills info <name> 查看详情）", "  /path         显示工作目录", "  /paste [t]    粘贴剪贴板图片 + 可选提示", "  /help         显示帮助", "  /exit         退出", "", "快捷键:", "  Esc           取消当前任务", "  Ctrl+J        输入框换行", "  Ctrl+C        退出程序", "  PageUp/Down   滚动消息", "  鼠标滚轮      滚动消息", "  鼠标拖拽      选择文本并自动复制", "  鼠标点击      工具调用行展开/收起", "  ← →           移动输入框光标", "  鼠标点击      输入框内定位光标"].join("\n"));
+            break;
+        default:
+            sysMsg(tui, `未知命令: /${cmd}，输入 /help 查看可用命令`);
+    }
+}

package/dist/tui/text-width.js

@@ -0,0 +1,91 @@
+/**
+ * Terminal display-width helpers.
+ *
+ * CJK / fullwidth characters occupy two terminal cells, combining marks and
+ * variation selectors occupy none. The input bar needs the same notion of width
+ * that the terminal uses, otherwise the caret (and therefore the IME
+ * composition window) drifts as soon as non-ASCII text is typed.
+ */
+/** Zero-width: combining marks, variation selectors, zero-width spaces. */
+function isZeroWidth(cp) {
+    return ((cp >= 0x0300 && cp <= 0x036f) ||
+        (cp >= 0x0483 && cp <= 0x0489) ||
+        (cp >= 0x0591 && cp <= 0x05bd) ||
+        (cp >= 0x0610 && cp <= 0x061a) ||
+        (cp >= 0x064b && cp <= 0x065f) ||
+        (cp >= 0x0e31 && cp <= 0x0e3a) ||
+        (cp >= 0x0e47 && cp <= 0x0e4e) ||
+        (cp >= 0x1ab0 && cp <= 0x1aff) ||
+        (cp >= 0x1dc0 && cp <= 0x1dff) ||
+        (cp >= 0x200b && cp <= 0x200f) ||
+        (cp >= 0x2060 && cp <= 0x2064) ||
+        (cp >= 0x20d0 && cp <= 0x20ff) ||
+        (cp >= 0xfe00 && cp <= 0xfe0f) ||
+        (cp >= 0xfe20 && cp <= 0xfe2f) ||
+        cp === 0xfeff ||
+        (cp >= 0xe0100 && cp <= 0xe01ef));
+}
+/** East Asian Wide / Fullwidth, plus the emoji blocks terminals render double. */
+function isFullWidth(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) ||
+        (cp >= 0x2e80 && cp <= 0x303e) ||
+        (cp >= 0x3041 && cp <= 0x33ff) ||
+        (cp >= 0x3400 && cp <= 0x4dbf) ||
+        (cp >= 0x4e00 && cp <= 0x9fff) ||
+        (cp >= 0xa000 && cp <= 0xa4cf) ||
+        (cp >= 0xa960 && cp <= 0xa97f) ||
+        (cp >= 0xac00 && cp <= 0xd7a3) ||
+        (cp >= 0xf900 && cp <= 0xfaff) ||
+        (cp >= 0xfe10 && cp <= 0xfe19) ||
+        (cp >= 0xfe30 && cp <= 0xfe6f) ||
+        (cp >= 0xff00 && cp <= 0xff60) ||
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1f64f) ||
+        (cp >= 0x1f680 && cp <= 0x1f6ff) ||
+        (cp >= 0x1f900 && cp <= 0x1f9ff) ||
+        (cp >= 0x20000 && cp <= 0x2fffd) ||
+        (cp >= 0x30000 && cp <= 0x3fffd));
+}
+/** Display width of a single code point, in terminal cells. */
+export function charWidth(char) {
+    const cp = char.codePointAt(0);
+    if (cp === undefined)
+        return 0;
+    // C0 / C1 control characters render nothing useful.
+    if (cp < 0x20 || (cp >= 0x7f && cp < 0xa0))
+        return 0;
+    if (isZeroWidth(cp))
+        return 0;
+    return isFullWidth(cp) ? 2 : 1;
+}
+/** Display width of a string (single logical line, no ANSI escapes). */
+export function displayWidth(text) {
+    let width = 0;
+    for (const char of text)
+        width += charWidth(char);
+    return width;
+}
+/**
+ * Break a single logical line into visual rows of at most `maxWidth` cells.
+ * Breaks on cell boundaries (not word boundaries) so the caret column can be
+ * derived exactly — a fullwidth character is never split across rows.
+ */
+export function wrapByWidth(line, maxWidth) {
+    if (maxWidth < 1)
+        return [line];
+    const rows = [];
+    let current = "";
+    let width = 0;
+    for (const char of line) {
+        const w = charWidth(char);
+        if (width + w > maxWidth) {
+            rows.push(current);
+            current = "";
+            width = 0;
+        }
+        current += char;
+        width += w;
+    }
+    rows.push(current);
+    return rows;
+}

package/dist/tui/theme.js

@@ -0,0 +1,12 @@
+export const theme = {
+    inputBorder: "cyan",
+    inputBorderDisabled: "gray",
+    confirmBorder: "blue",
+    pickerBorder: "blue",
+    questionBorder: "blue",
+    accent: "cyan",
+    muted: "gray",
+    tool: "yellow",
+    error: "red",
+    success: "green",
+};

package/dist/tui/undo-stack.js

@@ -0,0 +1,14 @@
+export function createUndoStack() {
+    return [];
+}
+export function pushTurn(stack, start, end, uiEnd) {
+    return [...stack, { start, end, uiEnd }];
+}
+export function popTurn(stack) {
+    if (stack.length === 0)
+        return null;
+    return { turn: stack[stack.length - 1], stack: stack.slice(0, -1) };
+}
+export function clearStack(stack) {
+    return [];
+}

package/dist/tui/use-sgr-mouse.js

@@ -0,0 +1,27 @@
+import { useEffect, useRef } from "react";
+import { useStdin } from "ink";
+import { scanSgrMouse } from "./mouse.js";
+export function useSgrMouse(enabled, onEvent) {
+    const { stdin } = useStdin();
+    const onEventRef = useRef(onEvent);
+    onEventRef.current = onEvent;
+    const bufRef = useRef("");
+    useEffect(() => {
+        if (!enabled || !stdin)
+            return;
+        const handle = (data) => {
+            bufRef.current += data.toString("utf-8");
+            let scanned;
+            while ((scanned = scanSgrMouse(bufRef.current))) {
+                bufRef.current = scanned.rest;
+                onEventRef.current(scanned.event);
+            }
+            if (bufRef.current.length > 64) {
+                const esc = bufRef.current.lastIndexOf("\x1b");
+                bufRef.current = esc === -1 ? "" : bufRef.current.slice(esc);
+            }
+        };
+        stdin.on("data", handle);
+        return () => { stdin.off("data", handle); };
+    }, [enabled, stdin]);
+}