min-agent 0.1.8 → 0.2.0

package/dist/tui/index.js

@@ -0,0 +1,94 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { App } from "./App.js";
+/**
+ * TUI renderer — manages the Ink app lifecycle and provides
+ * imperative methods to update state from the agent loop.
+ */
+export class TuiRenderer {
+    state;
+    rerender = null;
+    inkInstance = null;
+    callbacks;
+    constructor(callbacks, model) {
+        this.state = {
+            messages: [],
+            isRunning: false,
+            model,
+        };
+        this.callbacks = callbacks;
+    }
+    start() {
+        this.inkInstance = render(_jsx(App, { initialState: this.state, onSubmit: this.callbacks.onSubmit, onConfirm: this.callbacks.onConfirm, onExit: this.callbacks.onExit }), { exitOnCtrlC: false });
+        // Position cursor at bottom-left for IME
+        const rows = process.stdout.rows ?? 24;
+        process.stdout.write(`\x1b[${rows};3H`);
+    }
+    /** Update state and trigger re-render */
+    update(partial) {
+        Object.assign(this.state, partial);
+        // Ink re-renders automatically when we call render again
+        if (this.inkInstance) {
+            this.inkInstance.rerender(_jsx(App, { initialState: this.state, onSubmit: this.callbacks.onSubmit, onConfirm: this.callbacks.onConfirm, onExit: this.callbacks.onExit }));
+            // Move terminal cursor to bottom-left (input bar area) for IME positioning
+            const rows = process.stdout.rows ?? 24;
+            process.stdout.write(`\x1b[${rows};3H`);
+        }
+    }
+    addMessage(msg) {
+        this.state.messages = [...this.state.messages, msg];
+        this.update({});
+    }
+    /** Append text to the last assistant message (for streaming) */
+    appendToLast(delta) {
+        const msgs = [...this.state.messages];
+        const last = msgs[msgs.length - 1];
+        if (last && last.role === "assistant") {
+            last.content += delta;
+            this.state.messages = msgs;
+            this.update({});
+        }
+        else {
+            this.addMessage({
+                id: `msg-${Date.now()}`,
+                role: "assistant",
+                content: delta,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    /** Append text to the current thinking message (for streaming thinking) */
+    appendToThinking(delta) {
+        const msgs = [...this.state.messages];
+        const last = msgs[msgs.length - 1];
+        if (last && last.role === "thinking") {
+            last.content += delta;
+            this.state.messages = msgs;
+            this.update({});
+        }
+        else {
+            this.addMessage({
+                id: `thinking-${Date.now()}`,
+                role: "thinking",
+                content: delta,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    setRunning(running, spinnerText) {
+        this.update({ isRunning: running, spinnerText });
+    }
+    showConfirm(message) {
+        this.update({ confirmMessage: message });
+    }
+    hideConfirm() {
+        this.update({ confirmMessage: undefined });
+    }
+    setTokenInfo(input, output, contextWindow) {
+        this.update({ tokenInfo: { input, output, contextWindow } });
+    }
+    destroy() {
+        this.inkInstance?.unmount();
+        this.inkInstance = null;
+    }
+}

package/dist/tui/types.js

@@ -0,0 +1 @@
+export {};

package/dist/tui-chat.js

@@ -0,0 +1,384 @@
+import { TuiRenderer } from "./tui/index.js";
+import { initMcp, shutdownMcp, getMcpStatus, loadMcpConfig } from "./mcp.js";
+import { discoverSkills, getSkills } from "./skills.js";
+import { loadInstructions } from "./instructions.js";
+import { TokenTracker, estimateTokens, compactMessages } from "./compaction.js";
+import { runOnce, runOnceWithSystem } from "./agent.js";
+import { killActiveProcesses } from "./tools/bash.js";
+import { setTuiConfirm } from "./confirm.js";
+import { getContextWindow } from "./context-window.js";
+import { loadConfig } from "./config.js";
+import { resolveModel } from "./provider.js";
+import { scanProject, buildCodeSystemPrompt } from "./code-mode.js";
+let confirmResolver = null;
+export async function runTui(opts) {
+    const { modelId, resumeSessionId, mode } = opts;
+    await initMcp();
+    discoverSkills();
+    const instructions = await loadInstructions();
+    const config = loadConfig();
+    // Code mode: scan project and build code-specific system prompt
+    let codeSystemPrompt;
+    if (mode === "code") {
+        const project = scanProject();
+        codeSystemPrompt = buildCodeSystemPrompt(project, instructions);
+    }
+    let messages = [];
+    let sessionId = resumeSessionId;
+    const tracker = new TokenTracker();
+    let abortController = null;
+    // Resume session if requested
+    if (resumeSessionId) {
+        const { loadSession } = await import("./sessions.js");
+        const session = loadSession(resumeSessionId);
+        if (session) {
+            messages = session.messages;
+            sessionId = resumeSessionId;
+        }
+    }
+    // Forward reference — assigned after tui is created
+    let executeAgent;
+    const tui = new TuiRenderer({
+        onSubmit: async (text) => {
+            if (text.startsWith("/")) {
+                const result = await handleSlashCommand(text, tui, messages, modelId, tracker);
+                if (result === "run") {
+                    await executeAgent();
+                }
+                return;
+            }
+            // Add user message
+            tui.addMessage({
+                id: `user-${Date.now()}`,
+                role: "user",
+                content: text,
+                timestamp: Date.now(),
+            });
+            messages.push({ role: "user", content: text });
+            await executeAgent();
+        },
+        onConfirm: (accepted) => {
+            tui.hideConfirm();
+            if (confirmResolver) {
+                confirmResolver(accepted);
+                confirmResolver = null;
+            }
+        },
+        onExit: () => {
+            if (abortController) {
+                killActiveProcesses();
+                abortController.abort();
+                abortController = null;
+                tui.setRunning(false);
+                tui.addMessage({
+                    id: `sys-${Date.now()}`,
+                    role: "system",
+                    content: "(已取消)",
+                    timestamp: Date.now(),
+                });
+            }
+        },
+    }, modelId ?? config.provider?.defaultModel);
+    // Define the agent execution function (uses tui, messages, etc. from closure)
+    executeAgent = async () => {
+        abortController = new AbortController();
+        tui.setRunning(true, "思考中...");
+        const callbacks = {
+            onAssistantDisplayDelta: (delta) => {
+                // Pass raw delta — markdown formatting is applied at display time
+                tui.appendToLast(delta);
+            },
+            onThinkingDelta: (delta) => {
+                tui.setRunning(true, "推理中...");
+                tui.appendToThinking(delta);
+            },
+            onToolCall: (toolName, input) => {
+                tui.setRunning(true, `执行 ${toolName}...`);
+                const args = typeof input === "object" && input
+                    ? Object.entries(input)
+                        .map(([k, v]) => `${k}=${typeof v === "string" ? (v.length > 40 ? v.slice(0, 40) + "..." : v) : JSON.stringify(v)}`)
+                        .join(" ")
+                    : "";
+                tui.addMessage({
+                    id: `tool-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                    role: "tool",
+                    content: args,
+                    toolName,
+                    timestamp: Date.now(),
+                });
+            },
+            onToolResult: (_toolName, _output) => {
+                tui.setRunning(true, "思考中...");
+            },
+            onStreamError: (msg) => {
+                tui.addMessage({
+                    id: `err-${Date.now()}`,
+                    role: "system",
+                    content: `错误: ${msg}`,
+                    timestamp: Date.now(),
+                });
+            },
+            onRunFinish: async (info) => {
+                abortController = null;
+                tui.setRunning(false);
+                if (info.usage) {
+                    const input = info.usage.inputTokens ?? 0;
+                    const output = info.usage.outputTokens ?? 0;
+                    const total = input + output;
+                    const ctxWindow = await getContextWindow(modelId);
+                    const pct = ctxWindow > 0 ? Math.round((input / ctxWindow) * 100) : 0;
+                    tui.setTokenInfo(input, output, ctxWindow);
+                    tui.addMessage({
+                        id: `done-${Date.now()}`,
+                        role: "system",
+                        content: `Done in ${info.stepCount} step(s) | Tokens: ${input} in / ${output} out / ${total} total | Context: ${pct}%`,
+                        timestamp: Date.now(),
+                    });
+                }
+            },
+        };
+        if (mode === "code" && codeSystemPrompt) {
+            await runOnceWithSystem(messages, codeSystemPrompt, modelId, abortController?.signal, callbacks, tracker);
+        }
+        else {
+            await runOnce(messages, instructions, modelId, abortController?.signal, callbacks, tracker);
+        }
+        abortController = null;
+        tui.setRunning(false);
+    };
+    // Override the confirm module to use TUI overlay
+    setTuiConfirm((message) => {
+        return new Promise((resolve) => {
+            confirmResolver = resolve;
+            tui.showConfirm(message);
+        });
+    });
+    tui.start();
+    // Keep process alive until exit
+    await new Promise((resolve) => {
+        process.on("SIGINT", () => {
+            if (abortController) {
+                killActiveProcesses();
+                abortController.abort();
+                abortController = null;
+                tui.setRunning(false);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+    // Save session
+    if (messages.length > 0) {
+        const { saveSession } = await import("./sessions.js");
+        sessionId = saveSession(messages, sessionId);
+    }
+    setTuiConfirm(null);
+    tui.destroy();
+    await shutdownMcp();
+}
+async function handleSlashCommand(input, tui, messages, modelId, tracker) {
+    const [cmd, ...rest] = input.slice(1).split(/\s+/);
+    const arg = rest.join(" ");
+    switch (cmd) {
+        case "exit":
+        case "quit":
+        case "q":
+            process.emit("SIGINT", "SIGINT");
+            break;
+        case "clear":
+            messages.length = 0;
+            tui.update({ messages: [] });
+            sysMsg(tui, "✓ 对话已清除");
+            break;
+        case "compact": {
+            if (messages.length < 4) {
+                sysMsg(tui, "消息太少，无需压缩");
+            }
+            else {
+                sysMsg(tui, "⟳ 正在压缩上下文...");
+                const model = resolveModel(modelId);
+                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 "model": {
+            if (arg) {
+                const config = await import("./config.js");
+                const cfg = config.loadConfig();
+                if (cfg.provider) {
+                    cfg.provider.defaultModel = arg;
+                    config.saveConfig(cfg);
+                    sysMsg(tui, `✓ 默认模型已设为: ${arg}`);
+                }
+            }
+            else {
+                const config = loadConfig();
+                sysMsg(tui, `当前模型: ${config.provider?.defaultModel ?? "未设置"}`);
+            }
+            break;
+        }
+        case "models": {
+            const { fetchModels } = await import("./config.js");
+            const cfg = loadConfig();
+            if (!cfg.provider?.baseURL || !cfg.provider?.apiKey) {
+                sysMsg(tui, "未配置 Provider，运行: min-agent setup");
+                break;
+            }
+            sysMsg(tui, "正在获取模型列表...");
+            const models = await fetchModels(cfg.provider.baseURL, cfg.provider.apiKey);
+            if (models.length === 0) {
+                sysMsg(tui, "无法获取模型列表");
+            }
+            else {
+                const lines = models.map((m) => {
+                    const marker = m === cfg.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(),
+            });
+            // Signal that we need to run the agent
+            return "run";
+        }
+        case "tokens": {
+            if (tracker && tracker.lastInputTokens > 0) {
+                const ctxWindow = await getContextWindow(modelId);
+                const pct = Math.round((tracker.lastInputTokens / ctxWindow) * 100);
+                sysMsg(tui, [
+                    `Context: ${tracker.lastInputTokens} / ${ctxWindow} tokens (${pct}%)`,
+                    `Total: ${tracker.totalInputTokens} in / ${tracker.totalOutputTokens} out`,
+                    `Messages: ${messages.length}`,
+                ].join("\n"));
+            }
+            else {
+                sysMsg(tui, `估算 tokens: ${estimateTokens(messages)} | Messages: ${messages.length}`);
+            }
+            break;
+        }
+        case "mcp": {
+            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 connected = status[name]?.connected ?? false;
+                    const toolCount = status[name]?.tools.length ?? 0;
+                    const state = disabled ? "disabled" : connected ? "connected" : "disconnected";
+                    return `  ${name}: ${state}${toolCount > 0 ? ` (${toolCount} tools)` : ""}`;
+                });
+                sysMsg(tui, `MCP 服务器 (${servers.length}):\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "skills": {
+            discoverSkills({ silent: true });
+            const skills = getSkills();
+            const cfg = loadConfig();
+            const disabledNames = cfg.disabledSkills ?? [];
+            if (skills.length === 0 && disabledNames.length === 0) {
+                sysMsg(tui, "无可用 skills。添加 SKILL.md 到 .min-agent/skills/<name>/");
+            }
+            else {
+                const lines = [];
+                for (const s of skills) {
+                    lines.push(`  ${s.name}  enabled`);
+                }
+                for (const n of disabledNames) {
+                    lines.push(`  ${n}  disabled`);
+                }
+                sysMsg(tui, `Skills:\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "help":
+            sysMsg(tui, [
+                "命令:",
+                "  /clear        清除对话历史",
+                "  /compact      压缩上下文",
+                "  /model [n]    显示/切换模型",
+                "  /models       列出可用模型",
+                "  /memory [t]   查看/保存记忆",
+                "  /tokens       显示 token 用量",
+                "  /mcp          显示 MCP 状态",
+                "  /skills       显示可用 skills",
+                "  /path         显示工作目录",
+                "  /paste [t]    粘贴剪贴板图片 + 可选提示",
+                "  /help         显示帮助",
+                "  /exit         退出",
+                "",
+                "快捷键:",
+                "  Esc           取消当前任务",
+                "  Ctrl+J        输入框换行",
+                "  Ctrl+C        退出程序",
+                "  PageUp/Down   滚动消息",
+            ].join("\n"));
+            break;
+        default:
+            sysMsg(tui, `未知命令: /${cmd}，输入 /help 查看可用命令`);
+    }
+}
+function sysMsg(tui, content) {
+    tui.addMessage({
+        id: `sys-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        role: "system",
+        content,
+        timestamp: Date.now(),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "min-agent",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "type": "module",
   "description": "Minimal AI coding agent with tool use, MCP, and skills support",
   "license": "MIT",
@@ -51,10 +51,14 @@
     "@modelcontextprotocol/sdk": "1.27.1",
     "ai": "6.0.168",
     "glob": "13.0.5",
+    "ink": "5",
+    "ink-spinner": "5",
+    "react": "18",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "22.13.9",
+    "@types/react": "18",
     "tsx": "4.19.4",
     "typescript": "5.8.2"
   }