mini-agents-cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 liruifengv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+## mini-agents-cli

package/dist/index.mjs

@@ -0,0 +1,428 @@
+#!/usr/bin/env node
+import { dirname, join, resolve } from "node:path";
+import { Command } from "commander";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { stdin, stdout } from "node:process";
+import { Agent, LLMClient } from "mini-agents";
+import { SkillLoader, createBashTool, createEditTool, createGetSkillTool, createReadTool, createWriteTool } from "mini-agents/tools";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+
+//#region src/config.ts
+/**
+* CLI 配置管理
+*
+* 使用 Zod 定义配置 schema，从 ~/.mini-agents-cli/settings.json 加载配置。
+*/
+/** 重试配置 schema */
+const RetryConfigSchema = z.object({
+	enabled: z.boolean().default(true),
+	maxRetries: z.number().default(3),
+	initialDelay: z.number().default(1),
+	maxDelay: z.number().default(60),
+	exponentialBase: z.number().default(2)
+});
+/** LLM 配置 schema */
+const LLMConfigSchema = z.object({
+	apiKey: z.string(),
+	apiBase: z.string(),
+	model: z.string(),
+	provider: z.enum(["anthropic", "openai"]),
+	retry: z.unknown().default({}).pipe(RetryConfigSchema)
+});
+/** Agent 配置 schema */
+const AgentConfigSchema = z.object({
+	maxSteps: z.number().default(50),
+	workspaceDir: z.string().default("./workspace"),
+	systemPromptPath: z.string().default("system_prompt.md")
+});
+/** MCP 超时配置 schema */
+const MCPConfigSchema = z.object({
+	connectTimeout: z.number().default(10),
+	executeTimeout: z.number().default(60),
+	sseReadTimeout: z.number().default(120)
+});
+/** 工具配置 schema */
+const ToolsConfigSchema = z.object({
+	enableFileTools: z.boolean().default(true),
+	enableBash: z.boolean().default(true),
+	enableNote: z.boolean().default(true),
+	enableSkills: z.boolean().default(true),
+	skillsDir: z.string().default("./skills"),
+	enableMcp: z.boolean().default(true),
+	mcpConfigPath: z.string().default("mcp.json"),
+	mcp: z.unknown().default({}).pipe(MCPConfigSchema)
+});
+/** 顶层配置 schema */
+const SettingsSchema = z.object({
+	llm: LLMConfigSchema,
+	agent: z.unknown().default({}).pipe(AgentConfigSchema),
+	tools: z.unknown().default({}).pipe(ToolsConfigSchema)
+});
+/** 配置文件目录：~/.mini-agents-cli */
+const CONFIG_DIR = join(homedir(), ".mini-agents-cli");
+/** 用户配置文件路径：~/.mini-agents-cli/settings.json */
+const USER_SETTINGS_FILE = join(CONFIG_DIR, "settings.json");
+/** 本地配置文件名（开发模式） */
+const LOCAL_SETTINGS_FILE = "settings.json";
+/** 默认配置模板 */
+const DEFAULT_SETTINGS = { llm: {
+	apiKey: "YOUR_API_KEY_HERE",
+	apiBase: "https://api.anthropic.com",
+	model: "claude-sonnet-4-20250514",
+	provider: "anthropic"
+} };
+/**
+* 按优先级搜索配置文件
+*
+* 搜索顺序：
+* 1. ~/.mini-agents-cli/settings.json（用户自定义）
+* 2. {packageDir}/config/settings.json（包内置，开发模式）
+*
+* @returns 找到的配置文件路径，未找到返回 null
+*/
+function findSettingsFile() {
+	return findConfigFile(LOCAL_SETTINGS_FILE);
+}
+/**
+* 按优先级搜索配置文件（通用版）
+*
+* 搜索顺序：
+* 1. ~/.mini-agents-cli/{filename}（用户自定义）
+* 2. {packageDir}/config/{filename}（包内置默认）
+*
+* @param filename - 要搜索的文件名（如 system_prompt.md）
+* @returns 找到的文件路径，未找到返回 null
+*/
+function findConfigFile(filename) {
+	const userPath = join(CONFIG_DIR, filename);
+	if (existsSync(userPath)) return userPath;
+	const builtinPath = join(dirname(dirname(fileURLToPath(import.meta.url))), "config", filename);
+	if (existsSync(builtinPath)) return builtinPath;
+	return null;
+}
+/**
+* 创建默认配置文件
+*
+* 在 ~/.mini-agents-cli/settings.json 创建模板配置。
+*
+* @returns 创建的配置文件路径
+*/
+function createDefaultSettings() {
+	ensureConfigDir();
+	writeFileSync(USER_SETTINGS_FILE, JSON.stringify(DEFAULT_SETTINGS, null, 2), "utf-8");
+	return USER_SETTINGS_FILE;
+}
+/**
+* 确保配置目录存在
+*/
+function ensureConfigDir() {
+	if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+}
+/**
+* 从指定路径加载并验证配置
+*
+* @param filePath - JSON 配置文件路径
+* @returns 验证后的 Settings 对象
+* @throws 文件不存在、JSON 格式错误、schema 验证失败时抛出错误
+*/
+function loadSettingsFromFile(filePath) {
+	if (!existsSync(filePath)) throw new Error(`Settings file not found: ${filePath}`);
+	const raw = readFileSync(filePath, "utf-8");
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		throw new Error(`Invalid JSON in settings file: ${filePath}`);
+	}
+	const result = SettingsSchema.safeParse(data);
+	if (!result.success) {
+		const issues = result.error.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`).join("\n");
+		throw new Error(`Invalid settings file:\n${issues}`);
+	}
+	return result.data;
+}
+
+//#endregion
+//#region src/cli.ts
+/**
+* 极简 CLI 实现
+*
+* 使用纯 Node.js API，无第三方渲染库
+*/
+const colors = {
+	reset: "\x1B[0m",
+	bright: "\x1B[1m",
+	dim: "\x1B[2m",
+	green: "\x1B[32m",
+	cyan: "\x1B[36m",
+	yellow: "\x1B[33m",
+	red: "\x1B[31m",
+	gray: "\x1B[90m",
+	blue: "\x1B[34m"
+};
+var SimpleCLI = class {
+	settings;
+	workspaceDir;
+	agent;
+	inputBuffer = "";
+	isProcessing = false;
+	abortController = null;
+	constructor(settings, workspaceDir) {
+		this.settings = settings;
+		this.workspaceDir = workspaceDir;
+		this.agent = this.createAgent();
+	}
+	createAgent() {
+		const llmClient = new LLMClient({
+			apiKey: this.settings.llm.apiKey,
+			provider: this.settings.llm.provider,
+			apiBase: this.settings.llm.apiBase,
+			model: this.settings.llm.model
+		});
+		const tools = [];
+		if (this.settings.tools.enableFileTools) {
+			tools.push(createReadTool(this.workspaceDir));
+			tools.push(createWriteTool(this.workspaceDir));
+			tools.push(createEditTool(this.workspaceDir));
+		}
+		if (this.settings.tools.enableBash) tools.push(createBashTool());
+		let skillsMetadata = "";
+		if (this.settings.tools.enableSkills) {
+			const skillsDir = this.settings.tools.skillsDir;
+			const loader = new SkillLoader(skillsDir);
+			if (loader.discoverSkills().length > 0) {
+				tools.push(createGetSkillTool(loader));
+				skillsMetadata = loader.getSkillsMetadataPrompt();
+			}
+		}
+		let systemPrompt;
+		const promptPath = findConfigFile(this.settings.agent.systemPromptPath);
+		if (promptPath) systemPrompt = readFileSync(promptPath, "utf-8");
+		else systemPrompt = "You are Mini-Agent, an intelligent AI assistant that helps users complete tasks using available tools. Be concise and helpful.";
+		if (skillsMetadata) systemPrompt = systemPrompt.replace("{{SKILLS_METADATA}}", skillsMetadata);
+		else systemPrompt = systemPrompt.replace("{{SKILLS_METADATA}}", "");
+		if (!systemPrompt.includes("Current Workspace")) systemPrompt += `\n\n## Current Workspace\nYou are currently working in: \`${this.workspaceDir}\`\nAll relative paths will be resolved relative to this directory.`;
+		return new Agent(llmClient, systemPrompt, tools);
+	}
+	printBanner() {
+		console.log();
+		console.log(`${colors.cyan}${colors.bright}🤖 Mini Agent${colors.reset}`);
+		console.log(`${colors.gray}${this.settings.llm.model} · ${this.getToolCount()} tools · ${this.workspaceDir}${colors.reset}`);
+		console.log(`${colors.gray}${"─".repeat(60)}${colors.reset}`);
+		console.log();
+	}
+	getToolCount() {
+		return [
+			this.settings.tools.enableFileTools,
+			this.settings.tools.enableBash,
+			this.settings.tools.enableNote,
+			this.settings.tools.enableSkills,
+			this.settings.tools.enableMcp
+		].filter(Boolean).length;
+	}
+	printPrompt() {
+		stdout.write(`${colors.green}You › ${colors.reset}`);
+	}
+	printThinking(text) {
+		const display = text.length > 300 ? `${text.slice(0, 300)}...` : text;
+		console.log(`${colors.gray}  💭 ${display}${colors.reset}`);
+	}
+	printToolCall(name, args) {
+		const argsStr = Object.entries(args).map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`).join(", ");
+		const display = argsStr.length > 200 ? `${argsStr.slice(0, 200)}...` : argsStr;
+		console.log(`${colors.yellow}  ⚡ ${name}(${display})${colors.reset}`);
+	}
+	printToolResult(isError) {
+		if (isError) console.log(`${colors.red}  ✗ Failed${colors.reset}`);
+		else console.log(`${colors.gray}  ✓ Done${colors.reset}`);
+	}
+	printAssistantMessage(content) {
+		console.log(`${colors.cyan}Assistant › ${content}${colors.reset}`);
+	}
+	printError(error) {
+		console.log(`${colors.red}Error: ${error}${colors.reset}`);
+	}
+	printHelp() {
+		console.log();
+		console.log(`${colors.bright}Available commands:${colors.reset}`);
+		console.log(`  /help    - Show this help message`);
+		console.log(`  /clear   - Clear the screen`);
+		console.log(`  /exit    - Exit the CLI`);
+		console.log();
+	}
+	/**
+	* 处理 AgentMessageEvent，实时打印
+	*/
+	handleAgentMessageEvent(event) {
+		switch (event.type) {
+			case "thinking":
+				if (event.thinking) this.printThinking(event.thinking);
+				break;
+			case "toolCall":
+				this.printToolCall(event.toolCall.function.name, event.toolCall.function.arguments);
+				break;
+			case "toolResult":
+				this.printToolResult(!event.result.success);
+				break;
+			case "assistantMessage":
+				if (event.content?.trim()) this.printAssistantMessage(event.content);
+				break;
+			case "summarized":
+				console.log(`${colors.yellow}  📝 Messages summarized (${event.beforeTokens} → ${event.afterTokens} tokens)${colors.reset}`);
+				break;
+		}
+	}
+	async processMessage(text) {
+		if (this.isProcessing) return;
+		this.isProcessing = true;
+		this.abortController = new AbortController();
+		this.agent.addUserMessage(text);
+		let loadingFrame = 0;
+		const loadingFrames = [
+			"⠋",
+			"⠙",
+			"⠹",
+			"⠸",
+			"⠼",
+			"⠴",
+			"⠦",
+			"⠧",
+			"⠇",
+			"⠏"
+		];
+		const loadingInterval = setInterval(() => {
+			stdout.write(`\r${colors.blue}  ${loadingFrames[loadingFrame]} Thinking...${colors.reset}`);
+			loadingFrame = (loadingFrame + 1) % loadingFrames.length;
+		}, 100);
+		try {
+			let hasReceivedEvent = false;
+			for await (const event of this.agent.run({ signal: this.abortController.signal })) {
+				if (!hasReceivedEvent) {
+					clearInterval(loadingInterval);
+					stdout.write(`\r${" ".repeat(30)}\r`);
+					hasReceivedEvent = true;
+				}
+				if (event.type === "cancelled") {
+					console.log(`${colors.yellow}⏹  Task cancelled by user.${colors.reset}`);
+					break;
+				}
+				this.handleAgentMessageEvent(event);
+			}
+			if (!hasReceivedEvent) {
+				clearInterval(loadingInterval);
+				stdout.write(`\r${" ".repeat(30)}\r`);
+			}
+			console.log();
+		} catch (err) {
+			clearInterval(loadingInterval);
+			stdout.write(`\r${" ".repeat(30)}\r`);
+			const errorMsg = err instanceof Error ? err.message : String(err);
+			this.printError(errorMsg);
+			console.log();
+		} finally {
+			this.abortController = null;
+			this.isProcessing = false;
+		}
+	}
+	async start() {
+		this.printBanner();
+		stdin.setRawMode(true);
+		stdin.setEncoding("utf8");
+		stdin.resume();
+		this.printPrompt();
+		stdin.on("data", async (data) => {
+			for (let i = 0; i < data.length; i++) {
+				const char = data[i];
+				const charCode = char.charCodeAt(0);
+				if (charCode === 3) {
+					console.log();
+					console.log(`${colors.cyan}Goodbye!${colors.reset}`);
+					process.exit(0);
+				}
+				if (charCode === 27 && this.isProcessing && this.abortController) {
+					this.abortController.abort();
+					continue;
+				}
+				if (charCode === 13) {
+					console.log();
+					const text = this.inputBuffer;
+					this.inputBuffer = "";
+					if (!text.trim()) {
+						this.printPrompt();
+						continue;
+					}
+					if (text.startsWith("/")) {
+						const cmd = text.slice(1).toLowerCase();
+						switch (cmd) {
+							case "exit":
+							case "quit":
+								console.log(`${colors.cyan}Goodbye!${colors.reset}`);
+								process.exit(0);
+							case "clear":
+								console.clear();
+								this.printBanner();
+								this.printPrompt();
+								continue;
+							case "help":
+								this.printHelp();
+								this.printPrompt();
+								continue;
+							default:
+								console.log(`${colors.red}Unknown command: ${cmd}${colors.reset}`);
+								this.printPrompt();
+								continue;
+						}
+					}
+					await this.processMessage(text);
+					this.printPrompt();
+					continue;
+				}
+				if (charCode === 127 || charCode === 8) {
+					if (this.inputBuffer.length > 0) {
+						const lastChar = this.inputBuffer[this.inputBuffer.length - 1];
+						const charWidth = lastChar && lastChar.charCodeAt(0) > 127 ? 2 : 1;
+						this.inputBuffer = this.inputBuffer.slice(0, -1);
+						if (charWidth === 2) stdout.write("\b\b  \b\b");
+						else stdout.write("\b \b");
+					}
+					continue;
+				}
+				if (charCode < 32) continue;
+				this.inputBuffer += char;
+				stdout.write(char);
+			}
+		});
+	}
+};
+
+//#endregion
+//#region src/index.ts
+/**
+* Mini Agent CLI - 极简版本
+*
+* 纯 Node.js 实现，无第三方渲染库
+*/
+const program = new Command();
+program.name("mini-agents-cli").description("Mini Agent - AI assistant with tool support").version("0.3.0").option("-w, --workspace <dir>", "Workspace directory", process.cwd()).action(async (options) => {
+	let settingsPath = findSettingsFile();
+	if (!settingsPath) {
+		const { runOnboarding } = await import("./onboarding-BPrwWMQk.mjs");
+		settingsPath = await runOnboarding();
+	}
+	let settings;
+	try {
+		settings = loadSettingsFromFile(settingsPath);
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		console.error(`Error: ${msg}`);
+		process.exit(1);
+	}
+	const workspaceDir = resolve(options.workspace);
+	await new SimpleCLI(settings, workspaceDir).start();
+});
+program.parse();
+
+//#endregion
+export { createDefaultSettings as t };

package/dist/onboarding-BPrwWMQk.mjs

@@ -0,0 +1,81 @@
+import { t as createDefaultSettings } from "./index.mjs";
+import { stdin, stdout } from "node:process";
+import * as readline from "node:readline/promises";
+
+//#region src/onboarding.ts
+/**
+* 首次使用引导流程
+*
+* 交互式询问用户配置 LLM provider、API Key、API URL、Model，
+* 保存到 ~/.mini-agents-cli/settings.json。
+*/
+const CYAN = "\x1B[36m";
+const GREEN = "\x1B[32m";
+const YELLOW = "\x1B[33m";
+const DIM = "\x1B[2m";
+const BOLD = "\x1B[1m";
+const RESET = "\x1B[0m";
+/** Provider 预设 */
+const PROVIDER_PRESETS = {
+	anthropic: {
+		apiBase: "https://api.anthropic.com",
+		model: "claude-sonnet-4-20250514"
+	},
+	openai: {
+		apiBase: "https://api.openai.com/v1",
+		model: "gpt-4o"
+	}
+};
+/**
+* 运行 onboarding 流程
+*
+* @returns 配置文件路径
+*/
+async function runOnboarding() {
+	const rl = readline.createInterface({
+		input: stdin,
+		output: stdout
+	});
+	console.log();
+	console.log(`${BOLD}${CYAN}🤖 Welcome to Mini Agent CLI!${RESET}`);
+	console.log(`${DIM}Let's set up your configuration.${RESET}`);
+	console.log();
+	try {
+		console.log(`${BOLD}${YELLOW}[1/4] LLM Provider${RESET}`);
+		console.log(`  ${GREEN}1${RESET}) Anthropic (Claude)`);
+		console.log(`  ${GREEN}2${RESET}) OpenAI`);
+		const provider = (await rl.question(`${DIM}Choose [1/2] (default: 1): ${RESET}`)).trim() === "2" ? "openai" : "anthropic";
+		const preset = PROVIDER_PRESETS[provider];
+		console.log(`  → ${CYAN}${provider}${RESET}`);
+		console.log();
+		console.log(`${BOLD}${YELLOW}[2/4] API Key${RESET}`);
+		const apiKey = await rl.question(`${DIM}Enter your API key: ${RESET}`);
+		if (!apiKey.trim()) console.log(`${YELLOW}⚠ No API key provided. You can edit the config later.${RESET}`);
+		console.log();
+		console.log(`${BOLD}${YELLOW}[3/4] API Base URL${RESET}`);
+		const apiBase = (await rl.question(`${DIM}URL (default: ${preset.apiBase}): ${RESET}`)).trim() || preset.apiBase;
+		console.log(`  → ${CYAN}${apiBase}${RESET}`);
+		console.log();
+		console.log(`${BOLD}${YELLOW}[4/4] Model${RESET}`);
+		const model = (await rl.question(`${DIM}Model name (default: ${preset.model}): ${RESET}`)).trim() || preset.model;
+		console.log(`  → ${CYAN}${model}${RESET}`);
+		console.log();
+		const settingsPath = createDefaultSettings();
+		const { writeFileSync } = await import("node:fs");
+		const settings = { llm: {
+			apiKey: apiKey.trim() || "YOUR_API_KEY_HERE",
+			apiBase,
+			model,
+			provider
+		} };
+		writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+		console.log(`${GREEN}✅ Config saved to: ${settingsPath}${RESET}`);
+		console.log();
+		return settingsPath;
+	} finally {
+		rl.close();
+	}
+}
+
+//#endregion
+export { runOnboarding };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "mini-agents-cli",
+  "version": "0.0.1",
+  "description": "A mini AI agent in CLI",
+  "main": "dist/index.mjs",
+  "bin": {
+    "mini-agents-cli": "dist/index.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsdown": "^0.16.6",
+    "tsx": "^4.20.6",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "zod": "^4.1.12",
+    "mini-agents": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "node dist/index.mjs"
+  }
+}