min-agent 0.2.1 → 0.4.0

package/dist/cli.js

@@ -1,637 +1,12 @@
-import { runAgent } from "./agent.js";
-import { loadMcpConfig, saveMcpConfig, checkMcpServer, checkAllMcpServers, formatMcpServerBinding, } from "./mcp.js";
-import { discoverSkills, getSkills } from "./skills.js";
-import { loadMemories, addMemory, deleteMemory, searchMemories } from "./memory.js";
-import { runSetup, isConfigured, loadConfig, saveConfig, fetchModels, getConfigDir, getRulesFile } from "./config.js";
-import { setAutoApprove } from "./confirm.js";
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import path from "path";
-const rawArgs = process.argv.slice(2);
-// Extract leading global flags only, so subcommands can still use "-y"
-const args = [...rawArgs];
-let hasYes = false;
-while (args[0] === "--yes" || args[0] === "-y") {
-    hasYes = true;
-    args.shift();
-}
-if (hasYes)
-    setAutoApprove(true);
-function printUsage() {
-    console.log(`
-min-agent - Minimal AI coding agent
-
-Usage:
-  min-agent init                    Initialize .min-agent/ in current directory
-  min-agent chat <message>          Send a message to the agent
-  min-agent chat                    Start interactive multi-turn chat
-  min-agent chat --resume <id>      Resume a previous session
-  min-agent code                    AI coding mode (project-aware)
-  min-agent setup                   Configure API provider (interactive)
-  min-agent models                  List available models
-  min-agent history                 List saved sessions
-  min-agent rules                   Show loaded instruction rules
-  min-agent rules edit              Edit global rules file
-  min-agent memory                  List all memories
-  min-agent memory add <text>       Add a memory manually
-  min-agent memory search <query>   Search memories
-  min-agent memory delete <index>   Delete a memory by number
-  min-agent mcp add <name> <cmd>    Add a local MCP server (stdio)
-  min-agent mcp add <name> --url <url> [--sse] [--token <t>]  Add remote MCP (HTTP)
-  min-agent mcp remove <name>       Remove an MCP server
-  min-agent mcp list                List configured MCP servers
-  min-agent mcp check               Check MCP server availability
-  min-agent skills list             List available skills
-  min-agent serve [--host H] [--port P]   HTTP API (see docs/API.md)
-
-Options:
-  --model, -m <model>    Override model for this request
-  --image, -i <path>     Attach an image (can be used multiple times)
-  --yes, -y              Auto-approve all confirmations (dangerous commands, file overwrites)
-
-Permission modes (set in ~/.min-agent/config.json):
-  "permission": "ask"        Prompt before dangerous operations (default)
-  "permission": "allow-all"  Auto-approve everything (same as --yes permanently)
-
-Rules (loaded as system instructions):
-  Global:  ~/.min-agent/rules.md
-  Project: ./AGENTS.md or ./RULES.md or ./.min-agent/AGENTS.md
-  Config:  "instructions" array in ~/.min-agent/config.json
-
-Examples:
-  min-agent setup
-  min-agent chat "hello"
-  min-agent chat
-  min-agent serve --port 8787
-  min-agent rules edit
-  min-agent mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /tmp
-  min-agent mcp add remote --url https://example.com/mcp --token "$TOKEN"
-`);
-}
-function parseMcpAddArgs(argv) {
-    let skipCheck = false;
-    let url;
-    let token;
-    let sse = false;
-    const cmd = [];
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === "--skip-check") {
-            skipCheck = true;
-            continue;
-        }
-        if (a === "--sse") {
-            sse = true;
-            continue;
-        }
-        if (a === "--url" && argv[i + 1]) {
-            url = argv[++i];
-            continue;
-        }
-        if (a === "--token" && argv[i + 1]) {
-            token = argv[++i];
-            continue;
-        }
-        cmd.push(a);
-    }
-    return { skipCheck, url, token, sse, cmd };
-}
-function ensureProjectDefaults() {
-    const projectConfigDir = path.join(process.cwd(), ".min-agent");
-    const projectSkillsDir = path.join(projectConfigDir, "skills");
-    const projectMcpFile = path.join(projectConfigDir, "mcp.json");
-    if (!existsSync(projectSkillsDir)) {
-        mkdirSync(projectSkillsDir, { recursive: true });
-    }
-    if (!existsSync(projectMcpFile)) {
-        mkdirSync(projectConfigDir, { recursive: true });
-        writeFileSync(projectMcpFile, JSON.stringify({ mcpServers: {} }, null, 2), "utf-8");
-    }
-}
+import { runProgram } from "./cli/program.js";
+import { registerCommands } from "./cli/commands/index.js";
+import { initLogger, log } from "./logger.js";
 async function main() {
-    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-        printUsage();
-        process.exit(0);
-    }
-    if (args[0] === "--version" || args[0] === "-v") {
-        const pkgPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), "../package.json");
-        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-        console.log(pkg.version);
-        process.exit(0);
-    }
-    const command = args[0];
-    switch (command) {
-        case "setup": {
-            await runSetup();
-            break;
-        }
-        case "models": {
-            const config = loadConfig();
-            if (!config.provider?.baseURL || !config.provider?.apiKey) {
-                console.error("Not configured. Run: min-agent setup");
-                process.exit(1);
-            }
-            console.log("Fetching models...");
-            const models = await fetchModels(config.provider.baseURL, config.provider.apiKey);
-            if (models.length === 0) {
-                console.log("No models found or unable to fetch model list.");
-            }
-            else {
-                console.log(`\nAvailable models (${models.length}):`);
-                for (const m of models) {
-                    const marker = m === config.provider.defaultModel ? " ← default" : "";
-                    console.log(`  ${m}${marker}`);
-                }
-            }
-            break;
-        }
-        case "chat": {
-            if (!isConfigured()) {
-                console.error("Not configured. Run: min-agent setup");
-                process.exit(1);
-            }
-            // Parse --model / -m, --resume, and --image / -i flags
-            let modelOverride;
-            let resumeId;
-            const images = [];
-            const chatArgs = [];
-            for (let i = 1; i < args.length; i++) {
-                if ((args[i] === "--model" || args[i] === "-m") && args[i + 1]) {
-                    modelOverride = args[++i];
-                }
-                else if (args[i] === "--resume" && args[i + 1]) {
-                    resumeId = args[++i];
-                }
-                else if ((args[i] === "--image" || args[i] === "-i") && args[i + 1]) {
-                    images.push(args[++i]);
-                }
-                else {
-                    chatArgs.push(args[i]);
-                }
-            }
-            const message = chatArgs.join(" ");
-            if (!message) {
-                const { runTui } = await import("./tui-chat.js");
-                await runTui({ modelId: modelOverride, resumeSessionId: resumeId, mode: "chat" });
-            }
-            else {
-                await runAgent(message, modelOverride, images.length > 0 ? images : undefined);
-            }
-            break;
-        }
-        case "code": {
-            if (!isConfigured()) {
-                console.error("Not configured. Run: min-agent setup");
-                process.exit(1);
-            }
-            let modelOverride;
-            let resumeId;
-            for (let i = 1; i < args.length; i++) {
-                if ((args[i] === "--model" || args[i] === "-m") && args[i + 1]) {
-                    modelOverride = args[++i];
-                }
-                else if (args[i] === "--resume" && args[i + 1]) {
-                    resumeId = args[++i];
-                }
-            }
-            const { runTui } = await import("./tui-chat.js");
-            await runTui({ modelId: modelOverride, resumeSessionId: resumeId, mode: "code" });
-            break;
-        }
-        case "serve": {
-            if (!isConfigured()) {
-                console.error("Not configured. Run: min-agent setup");
-                process.exit(1);
-            }
-            let servePort;
-            let serveHost;
-            for (let i = 1; i < args.length; i++) {
-                if ((args[i] === "--port" || args[i] === "-p") && args[i + 1]) {
-                    servePort = parseInt(args[++i], 10);
-                }
-                else if (args[i] === "--host" && args[i + 1]) {
-                    serveHost = args[++i];
-                }
-            }
-            const { runServe } = await import("./serve.js");
-            await runServe({ port: servePort, host: serveHost });
-            break;
-        }
-        case "mcp": {
-            const subcommand = args[1];
-            if (subcommand === "-h" || subcommand === "--help" || !subcommand) {
-                console.log(`Usage: min-agent mcp <command>
-
-Commands:
-  list              List configured MCP servers (name + status)
-  info <name>       Show details of a server
-  add <name> ...    Add a new server (stdio or remote)
-  remove <name>     Remove a server
-  enable <name>     Enable a disabled server
-  disable <name>    Disable a server
-  check             Test connectivity of all servers`);
-                process.exit(0);
-            }
-            switch (subcommand) {
-                case "add": {
-                    const name = args[2];
-                    if (!name) {
-                        console.error("Usage: min-agent mcp add <name> [--skip-check] <command...>");
-                        console.error("   or: min-agent mcp add <name> --url <https://host/mcp> [--sse] [--token <bearer>] [--skip-check]");
-                        process.exit(1);
-                    }
-                    const { skipCheck, url, token, sse, cmd } = parseMcpAddArgs(args.slice(3));
-                    let entry;
-                    if (url?.trim()) {
-                        entry = {
-                            url: url.trim(),
-                            enabled: true,
-                            remoteTransport: sse ? "sse" : "auto",
-                        };
-                        if (token?.trim())
-                            entry.token = token.trim();
-                    }
-                    else if (cmd.length > 0) {
-                        entry = { command: cmd, enabled: true };
-                    }
-                    else {
-                        console.error("Usage: min-agent mcp add <name> [--skip-check] <command...>");
-                        console.error("   or: min-agent mcp add <name> --url <https://host/mcp> [--sse] [--token <bearer>] [--skip-check]");
-                        process.exit(1);
-                    }
-                    let detectedTools = 0;
-                    if (!skipCheck) {
-                        console.log(`Validating MCP server "${name}"...`);
-                        const checkResult = await checkMcpServer(name, entry);
-                        if (!checkResult.ok) {
-                            console.error(`MCP server "${name}" validation failed: ${checkResult.error ?? "unknown error"}`);
-                            process.exit(1);
-                        }
-                        detectedTools = checkResult.toolCount;
-                    }
-                    else {
-                        console.log(`Skipping MCP validation for "${name}" (--skip-check).`);
-                    }
-                    const config = loadMcpConfig();
-                    config.mcpServers[name] = entry;
-                    saveMcpConfig(config);
-                    const toolsSuffix = skipCheck ? "" : ` (${detectedTools} tools detected)`;
-                    console.log(`✓ MCP server "${name}" added: ${formatMcpServerBinding(entry)}${toolsSuffix}`);
-                    break;
-                }
-                case "remove": {
-                    const name = args[2];
-                    if (!name) {
-                        console.error("Usage: min-agent mcp remove <name>");
-                        process.exit(1);
-                    }
-                    const config = loadMcpConfig();
-                    if (!config.mcpServers[name]) {
-                        console.error(`MCP server "${name}" not found`);
-                        process.exit(1);
-                    }
-                    delete config.mcpServers[name];
-                    saveMcpConfig(config);
-                    console.log(`✓ MCP server "${name}" removed`);
-                    break;
-                }
-                case "list": {
-                    const config = loadMcpConfig();
-                    const servers = Object.entries(config.mcpServers);
-                    if (servers.length === 0) {
-                        console.log("No MCP servers configured.");
-                        console.log("Add one with: min-agent mcp add <name> <command...>");
-                    }
-                    else {
-                        console.log("MCP Servers:");
-                        for (const [name, cfg] of servers) {
-                            const status = cfg.enabled === false ? "\x1b[90mdisabled\x1b[0m" : "\x1b[32menabled\x1b[0m";
-                            console.log(`  ${name}  ${status}`);
-                        }
-                        console.log("\nUse: min-agent mcp info <name>  for details");
-                    }
-                    break;
-                }
-                case "info": {
-                    const name = args[2];
-                    if (!name) {
-                        console.error("Usage: min-agent mcp info <name>");
-                        process.exit(1);
-                    }
-                    const config = loadMcpConfig();
-                    const cfg = config.mcpServers[name];
-                    if (!cfg) {
-                        console.error(`MCP server "${name}" not found`);
-                        process.exit(1);
-                    }
-                    console.log(`Name:      ${name}`);
-                    console.log(`Status:    ${cfg.enabled === false ? "disabled" : "enabled"}`);
-                    console.log(`Binding:   ${formatMcpServerBinding(cfg)}`);
-                    if (cfg.command)
-                        console.log(`Command:   ${Array.isArray(cfg.command) ? cfg.command.join(" ") : `${cfg.command} ${(cfg.args ?? []).join(" ")}`.trim()}`);
-                    if (cfg.url)
-                        console.log(`URL:       ${cfg.url}`);
-                    if (cfg.token)
-                        console.log(`Token:     ***`);
-                    if (cfg.environment)
-                        console.log(`Env:       ${Object.keys(cfg.environment).join(", ")}`);
-                    if (cfg.timeout)
-                        console.log(`Timeout:   ${cfg.timeout}ms`);
-                    break;
-                }
-                case "check": {
-                    const results = await checkAllMcpServers();
-                    if (results.length === 0) {
-                        console.log("No MCP servers configured.");
-                        console.log("Add one with: min-agent mcp add <name> <command...>  or  --url <https://...>");
-                        break;
-                    }
-                    let failed = 0;
-                    console.log("MCP Check Results:");
-                    for (const result of results) {
-                        if (!result.enabled) {
-                            console.log(`  ${result.name}: skipped (disabled)`);
-                            continue;
-                        }
-                        if (result.ok) {
-                            console.log(`  ${result.name}: ok (${result.toolCount} tools)`);
-                        }
-                        else {
-                            failed++;
-                            console.log(`  ${result.name}: failed${result.error ? ` - ${result.error}` : ""}`);
-                        }
-                    }
-                    if (failed > 0) {
-                        console.error(`\n${failed} MCP server(s) failed.`);
-                        process.exit(1);
-                    }
-                    else {
-                        console.log("\nAll enabled MCP servers are available.");
-                    }
-                    break;
-                }
-                case "enable": {
-                    const names = args.slice(2);
-                    if (names.length === 0) {
-                        console.error("Usage: min-agent mcp enable <name...>");
-                        process.exit(1);
-                    }
-                    const config = loadMcpConfig();
-                    for (const name of names) {
-                        if (!config.mcpServers[name]) {
-                            console.error(`MCP server "${name}" not found`);
-                            continue;
-                        }
-                        config.mcpServers[name].enabled = true;
-                        console.log(`✓ MCP server "${name}" enabled`);
-                    }
-                    saveMcpConfig(config);
-                    break;
-                }
-                case "disable": {
-                    const names = args.slice(2);
-                    if (names.length === 0) {
-                        console.error("Usage: min-agent mcp disable <name...>");
-                        process.exit(1);
-                    }
-                    const config = loadMcpConfig();
-                    for (const name of names) {
-                        if (!config.mcpServers[name]) {
-                            console.error(`MCP server "${name}" not found`);
-                            continue;
-                        }
-                        config.mcpServers[name].enabled = false;
-                        console.log(`✓ MCP server "${name}" disabled`);
-                    }
-                    saveMcpConfig(config);
-                    break;
-                }
-                default:
-                    console.error("Usage: min-agent mcp -h");
-                    process.exit(1);
-            }
-            break;
-        }
-        case "history": {
-            const { listSessions } = await import("./sessions.js");
-            const sessions = listSessions();
-            if (sessions.length === 0) {
-                console.log("No saved sessions.");
-                console.log("Sessions are auto-saved when you exit interactive chat.");
-            }
-            else {
-                console.log(`Sessions (${sessions.length}):`);
-                for (const s of sessions.slice(0, 20)) {
-                    const date = s.updated.split("T")[0];
-                    console.log(`  ${s.id}  ${date}  ${s.title} (${s.messageCount} msgs)`);
-                }
-                console.log("\nResume with: min-agent chat --resume <id>");
-            }
-            break;
-        }
-        case "memory": {
-            const subcommand = args[1];
-            switch (subcommand) {
-                case "add": {
-                    const text = args.slice(2).join(" ");
-                    if (!text) {
-                        console.error("Usage: min-agent memory add <text>");
-                        process.exit(1);
-                    }
-                    addMemory(text);
-                    console.log(`✓ Memory saved: "${text}"`);
-                    break;
-                }
-                case "search": {
-                    const query = args.slice(2).join(" ");
-                    if (!query) {
-                        console.error("Usage: min-agent memory search <query>");
-                        process.exit(1);
-                    }
-                    const results = searchMemories(query);
-                    if (results.length === 0) {
-                        console.log(`No memories matching "${query}"`);
-                    }
-                    else {
-                        console.log(`Found ${results.length} memory(s):`);
-                        for (const m of results) {
-                            const tags = m.tags.length > 0 ? ` [${m.tags.join(", ")}]` : "";
-                            console.log(`  #${m.index + 1}: ${m.content}${tags}`);
-                        }
-                    }
-                    break;
-                }
-                case "delete": {
-                    const idx = parseInt(args[2]);
-                    if (isNaN(idx)) {
-                        console.error("Usage: min-agent memory delete <number>");
-                        process.exit(1);
-                    }
-                    if (deleteMemory(idx - 1)) {
-                        console.log(`✓ Memory #${idx} deleted`);
-                    }
-                    else {
-                        console.error(`Memory #${idx} not found`);
-                    }
-                    break;
-                }
-                default: {
-                    // List all memories
-                    const memories = loadMemories();
-                    if (memories.length === 0) {
-                        console.log("No memories stored.");
-                        console.log("The agent will automatically save memories during conversations.");
-                        console.log("Or add manually: min-agent memory add \"prefer TypeScript over JavaScript\"");
-                    }
-                    else {
-                        console.log(`Memories (${memories.length}):`);
-                        for (let i = 0; i < memories.length; i++) {
-                            const m = memories[i];
-                            const tags = m.tags.length > 0 ? ` [${m.tags.join(", ")}]` : "";
-                            const date = m.created.split("T")[0];
-                            console.log(`  #${i + 1}: ${m.content}${tags} (${date})`);
-                        }
-                    }
-                    break;
-                }
-            }
-            break;
-        }
-        case "skills": {
-            const subcommand = args[1];
-            if (subcommand === "-h" || subcommand === "--help" || !subcommand) {
-                console.log(`Usage: min-agent skills <command>
-
-Commands:
-  list              List skills (name + status)
-  info <name>       Show details of a skill
-  enable <name>     Enable a disabled skill
-  disable <name>    Disable a skill`);
-                process.exit(0);
-            }
-            switch (subcommand) {
-                case "info": {
-                    const name = args[2];
-                    if (!name) {
-                        console.error("Usage: min-agent skills info <name>");
-                        process.exit(1);
-                    }
-                    discoverSkills({ silent: true });
-                    const { getSkill } = await import("./skills.js");
-                    const skill = getSkill(name);
-                    if (!skill) {
-                        console.error(`Skill "${name}" not found`);
-                        process.exit(1);
-                    }
-                    const config = loadConfig();
-                    const isDisabled = (config.disabledSkills ?? []).includes(name);
-                    console.log(`Name:        ${skill.name}`);
-                    console.log(`Status:      ${isDisabled ? "disabled" : "enabled"}`);
-                    console.log(`Description: ${skill.description}`);
-                    console.log(`Location:    ${skill.location}`);
-                    break;
-                }
-                case "enable": {
-                    const names = args.slice(2);
-                    if (names.length === 0) {
-                        console.error("Usage: min-agent skills enable <name...>");
-                        process.exit(1);
-                    }
-                    const config = loadConfig();
-                    config.disabledSkills = (config.disabledSkills ?? []).filter((s) => !names.includes(s));
-                    saveConfig(config);
-                    for (const name of names)
-                        console.log(`✓ Skill "${name}" enabled`);
-                    break;
-                }
-                case "disable": {
-                    const names = args.slice(2);
-                    if (names.length === 0) {
-                        console.error("Usage: min-agent skills disable <name...>");
-                        process.exit(1);
-                    }
-                    const config = loadConfig();
-                    const disabled = config.disabledSkills ?? [];
-                    for (const name of names) {
-                        if (!disabled.includes(name))
-                            disabled.push(name);
-                        console.log(`✓ Skill "${name}" disabled`);
-                    }
-                    config.disabledSkills = disabled;
-                    saveConfig(config);
-                    break;
-                }
-                case "list": {
-                    discoverSkills({ silent: true });
-                    const skills = getSkills();
-                    const config = loadConfig();
-                    const disabledNames = config.disabledSkills ?? [];
-                    if (skills.length === 0 && disabledNames.length === 0) {
-                        console.log("No skills found. Add SKILL.md files in .min-agent/skills/<name>/");
-                        break;
-                    }
-                    console.log("Skills:");
-                    for (const skill of skills) {
-                        console.log(`  ${skill.name}  \x1b[32menabled\x1b[0m`);
-                    }
-                    for (const n of disabledNames) {
-                        console.log(`  ${n}  \x1b[90mdisabled\x1b[0m`);
-                    }
-                    console.log("\nUse: min-agent skills info <name>  for details");
-                    break;
-                }
-                default:
-                    console.error("Usage: min-agent skills -h");
-                    process.exit(1);
-            }
-            break;
-        }
-        case "init": {
-            ensureProjectDefaults();
-            console.log(`✓ Initialized .min-agent/ in ${process.cwd()}`);
-            break;
-        }
-        case "rules": {
-            const subcommand = args[1];
-            if (subcommand === "edit") {
-                const rulesFile = getRulesFile();
-                if (!existsSync(rulesFile)) {
-                    mkdirSync(getConfigDir(), { recursive: true });
-                    writeFileSync(rulesFile, `# Global Agent Rules\n\n<!-- Add your custom instructions here. They will be included in every conversation. -->\n`, "utf-8");
-                }
-                const editor = process.env.EDITOR || "vi";
-                const { execSync } = await import("child_process");
-                execSync(`${editor} "${rulesFile}"`, { stdio: "inherit" });
-            }
-            else {
-                const { loadInstructions } = await import("./instructions.js");
-                const instructions = await loadInstructions();
-                if (instructions.length === 0) {
-                    console.log("No instruction rules loaded.");
-                    console.log("");
-                    console.log("Add rules by creating:");
-                    console.log(`  Global:  ${getRulesFile()}`);
-                    console.log("  Project: ./AGENTS.md or ./RULES.md");
-                    console.log("");
-                    console.log("Or add paths/URLs in ~/.min-agent/config.json:");
-                    console.log('  { "instructions": ["./docs/rules.md", "https://..."] }');
-                }
-                else {
-                    console.log(`Loaded ${instructions.length} instruction source(s):\n`);
-                    for (const inst of instructions) {
-                        const firstLine = inst.split("\n")[0];
-                        console.log(`  ${firstLine}`);
-                    }
-                }
-            }
-            break;
-        }
-        default:
-            console.error(`Unknown command: ${command}`);
-            printUsage();
-            process.exit(1);
-    }
+    initLogger();
+    log("info", "min-agent started");
+    await runProgram(process.argv.slice(2), registerCommands);
 }
 main().catch((err) => {
     console.error(`\x1b[31mFatal error: ${err.message}\x1b[0m`);
-    process.exit(1);
+    process.exitCode = 1;
 });