npm - min-agent - Versions diffs - 0.1.5 → 0.1.7 - Mend

min-agent 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/skills.js CHANGED Viewed

@@ -3,6 +3,7 @@ import { readFileSync, existsSync, readdirSync, statSync } from "fs";
 import os from "os";
 import path from "path";
 import { globSync } from "glob";
+import { loadConfig } from "./config.js";
 /**
  * Skill scan order: later entries win on duplicate `name` in frontmatter.
  * Global user skills first, then project-local dirs so repo skills override ~/.agents.
@@ -15,7 +16,7 @@ const SKILL_DIRS = [
     path.join(process.cwd(), ".claude", "skills"),
 ];
 let loadedSkills = {};
-export function discoverSkills() {
+export function discoverSkills(opts) {
     loadedSkills = {};
     for (const dir of SKILL_DIRS) {
         if (!existsSync(dir))
@@ -29,8 +30,10 @@ export function discoverSkills() {
         }
     }
     const count = Object.keys(loadedSkills).length;
-    if (count > 0) {
-        console.log(`\x1b[90m  Skills loaded: ${count} (${Object.keys(loadedSkills).join(", ")})\x1b[0m`);
+    if (count > 0 && !opts?.silent) {
+        const disabled = new Set(loadConfig().disabledSkills ?? []);
+        const enabledCount = Object.keys(loadedSkills).filter((n) => !disabled.has(n)).length;
+        console.log(`\x1b[90m  Skills: ${enabledCount} enabled${count > enabledCount ? `, ${count - enabledCount} disabled` : ""}\x1b[0m`);
     }
 }
 function parseSkillFile(filePath) {
@@ -58,7 +61,8 @@ function parseSkillFile(filePath) {
     }
 }
 export function getSkills() {
-    return Object.values(loadedSkills);
+    const disabled = new Set(loadConfig().disabledSkills ?? []);
+    return Object.values(loadedSkills).filter((s) => !disabled.has(s.name));
 }
 export function getSkill(name) {
     return loadedSkills[name];
@@ -74,9 +78,13 @@ export function getSkillsTool() {
             required: ["name"],
         }),
         execute: async ({ name }) => {
+            const disabled = new Set(loadConfig().disabledSkills ?? []);
+            if (disabled.has(name)) {
+                return `Skill "${name}" is disabled. Available skills: ${getSkills().map((s) => s.name).join(", ") || "none"}`;
+            }
             const skill = loadedSkills[name];
             if (!skill) {
-                const available = Object.keys(loadedSkills);
+                const available = getSkills().map((s) => s.name);
                 return `Skill "${name}" not found. Available skills: ${available.length ? available.join(", ") : "none"}`;
             }
             const dir = path.dirname(skill.location);
@@ -104,7 +112,7 @@ export function getSkillsTool() {
     });
 }
 export function getSkillsSystemPrompt() {
-    const skills = Object.values(loadedSkills);
+    const skills = getSkills();
     if (skills.length === 0)
         return "";
     return [
@@ -115,7 +123,7 @@ export function getSkillsSystemPrompt() {
     ].join("\n");
 }
 function buildSkillDescription() {
-    const skills = Object.values(loadedSkills);
+    const skills = getSkills();
     if (skills.length === 0)
         return "Load a specialized skill. No skills are currently available.";
     return [

package/dist/tools/bash.js CHANGED Viewed

@@ -21,11 +21,15 @@ export const bashTool = tool({
             const chunks = [];
             let killed = false;
             let timer;
-            const proc = spawn(command, [], {
+            // On Windows, force UTF-8 codepage to avoid Chinese garbled text
+            const isWin = process.platform === "win32";
+            const actualCommand = isWin ? `chcp 65001 >nul && ${command}` : command;
+            const proc = spawn(actualCommand, [], {
                 shell: true,
                 cwd: process.cwd(),
                 stdio: ["ignore", "pipe", "pipe"],
                 detached: process.platform !== "win32",
+                env: { ...process.env, ...(isWin ? { PYTHONIOENCODING: "utf-8" } : {}) },
             });
             proc.stdout?.on("data", (chunk) => chunks.push(chunk));
             proc.stderr?.on("data", (chunk) => chunks.push(chunk));

package/dist/tools/index.js CHANGED Viewed

@@ -9,7 +9,23 @@ import { webFetchTool } from "./web_fetch.js";
 import { todoTool } from "./todo.js";
 import { questionTool } from "./question.js";
 import { codeSearchTool } from "./code_search.js";
-export function createTools() {
+/** Chat mode: general assistant tools (fewer tools = less token overhead) */
+export function createChatTools() {
+    const tools = {
+        bash: bashTool,
+        read: readTool,
+        write: writeTool,
+        edit: editTool,
+        glob: globTool,
+        grep: grepTool,
+        web_search: webSearchTool,
+        web_fetch: webFetchTool,
+        question: questionTool,
+    };
+    return tools;
+}
+/** Code mode: full tool set including task tracking and code search */
+export function createCodeTools() {
     const tools = {
         bash: bashTool,
         read: readTool,
@@ -27,3 +43,7 @@ export function createTools() {
     }
     return tools;
 }
+/** @deprecated Use createChatTools or createCodeTools */
+export function createTools() {
+    return createChatTools();
+}

package/docs/API.md CHANGED Viewed

@@ -1,21 +1,19 @@
 # min-agent HTTP API
-通过 `min-agent serve` 启动本地 HTTP 服务，以编程方式调用与 CLI 相同的代理能力。
+`min-agent serve` 启动本地 HTTP 服务，以编程方式调用代理能力。
 ## 启动
 ```bash
 min-agent serve
-min-agent serve --host 127.0.0.1 --port 8787
+min-agent serve --host 0.0.0.0 --port 3000
 ```
-环境变量：
-| 变量 | 说明 |
-|------|------|
+| 环境变量 | 说明 |
+|----------|------|
 | `MIN_AGENT_SERVE_HOST` | 监听地址（默认 `127.0.0.1`） |
 | `MIN_AGENT_SERVE_PORT` | 端口（默认 `8787`） |
-| `MIN_AGENT_SERVE_TOKEN` | 设置后所有请求须带 `Authorization: Bearer <token>` |
+| `MIN_AGENT_SERVE_TOKEN` | Bearer token 鉴权 |
 | `MIN_AGENT_SERVE_CORS` | 设为 `1` 启用 CORS |
 ---
@@ -25,26 +23,26 @@ min-agent serve --host 127.0.0.1 --port 8787
 | 方法 | 路径 | 说明 |
 |------|------|------|
 | GET | `/health` | 存活检查 |
-| GET | `/v1/meta` | 运行环境摘要 |
+| GET | `/v1/meta` | 运行环境 |
 | GET | `/v1/models` | 模型列表 |
 | GET | `/v1/context` | 上下文窗口信息 |
-| GET | `/v1/project` | 项目扫描（code 模式） |
-| POST | `/v1/chat` | 对话（支持流式） |
-| POST | `/v1/paste` | 粘贴图片 + 文本对话 |
-| POST | `/v1/code` | Code 模式对话（项目感知） |
+| GET | `/v1/project` | 项目扫描 |
+| POST | `/v1/chat` | 对话 |
+| POST | `/v1/code` | Code 模式对话 |
+| POST | `/v1/paste` | 图片+文本对话 |
 | POST | `/v1/chat/compact` | 手动压缩会话 |
 | POST | `/v1/chat/reload-instructions` | 重载规则 |
-| GET | `/v1/sessions` | 列出历史会话 |
+| GET | `/v1/sessions` | 列出会话 |
 | DELETE | `/v1/sessions/:id` | 删除会话 |
 | GET | `/v1/memory` | 列出记忆 |
 | POST | `/v1/memory` | 添加记忆 |
 | GET | `/v1/memory/search?q=xxx` | 搜索记忆 |
 | DELETE | `/v1/memory/:index` | 删除记忆 |
-| GET | `/v1/mcp` | MCP 服务器状态 |
+| GET | `/v1/mcp` | MCP 状态 |
 | POST | `/v1/mcp` | 添加 MCP 服务器 |
 | DELETE | `/v1/mcp/:name` | 删除 MCP 服务器 |
-| GET | `/v1/skills` | 可用技能列表 |
-| GET | `/v1/rules` | 已加载的规则 |
+| GET | `/v1/skills` | 技能列表 |
+| GET | `/v1/rules` | 已加载规则 |
 ---
@@ -54,42 +52,30 @@ min-agent serve --host 127.0.0.1 --port 8787
 { "ok": true, "service": "min-agent", "version": "0.1.0" }
 ```
----
 ## `GET /v1/meta`
 ```json
 { "version": "0.1.0", "cwd": "/path/to/project", "instructions_chars": 1234 }
 ```
----
 ## `GET /v1/models`
 ```json
-{ "default_model": "gpt-4o", "models": ["gpt-4o", "gpt-4o-mini", "..."] }
+{ "default_model": "gpt-4o", "models": ["gpt-4o", "gpt-4o-mini"] }
 ```
----
 ## `GET /v1/context`
-返回当前模型的上下文窗口大小（自动检测）。
 ```json
 { "context_window": 128000, "model": "gpt-4o" }
 ```
----
 ## `GET /v1/project`
-扫描当前工作目录的项目信息（与 `min-agent code` 启动时相同）。
 ```json
 {
   "project": {
-    "directory": "/path/to/project",
+    "directory": "/path",
     "isGitRepo": true,
     "branch": "main",
     "languages": ["TypeScript"],
@@ -106,15 +92,13 @@ min-agent serve --host 127.0.0.1 --port 8787
 ## `POST /v1/chat`
-### 请求体
 | 字段 | 类型 | 说明 |
 |------|------|------|
-| `message` | string | 单轮用户消息 |
-| `messages` | array | 多轮 ModelMessage[]（与 `message` 二选一） |
-| `model` | string | 覆盖默认模型 |
-| `stream` | boolean | SSE 流式返回 |
-| `session_id` | string | 恢复历史会话并追加 |
+| `message` | string | 用户消息（与 `messages` 二选一） |
+| `messages` | array | 完整 ModelMessage[] |
+| `model` | string | 覆盖模型 |
+| `stream` | boolean | SSE 流式 |
+| `session_id` | string | 恢复会话 |
 | `images` | string[] | 本地图片路径 |
 ### 非流式响应
@@ -148,24 +132,43 @@ min-agent serve --host 127.0.0.1 --port 8787
 ---
-## `POST /v1/chat/compact`
+## `POST /v1/code`
+Code 模式对话（项目感知 prompt + explore 工具）。请求体与 `/v1/chat` 相同。
+响应额外包含：
+```json
+{ "mode": "code", "project": { "languages": [...], ... }, ... }
+```
+---
+## `POST /v1/paste`
+图片 + 文本多模态对话。
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `image_base64` | string | **必填** Base64 图片数据 |
+| `mime_type` | string | MIME 类型（默认 `image/png`） |
+| `message` | string | 文本 prompt |
+| `model` | string | 覆盖模型 |
+| `session_id` | string | 追加到会话 |
+| `stream` | boolean | SSE 流式 |
-手动压缩指定会话的上下文。
+---
+## `POST /v1/chat/compact`
 ```json
 // 请求
 { "session_id": "abc123" }
 // 响应
 { "ok": true, "compacted": true, "message_count": 5 }
 ```
----
 ## `POST /v1/chat/reload-instructions`
-重新加载规则文件（不重启 MCP）。
 ```json
 { "ok": true, "instructions_chars": 1234 }
 ```
@@ -174,22 +177,12 @@ min-agent serve --host 127.0.0.1 --port 8787
 ## `GET /v1/sessions`
-列出所有保存的会话。
 ```json
-{
-  "sessions": [
-    { "id": "abc123", "title": "Fix login bug", "created": "...", "updated": "...", "messageCount": 12 }
-  ]
-}
+{ "sessions": [{ "id": "abc", "title": "Fix bug", "updated": "...", "messageCount": 12 }] }
 ```
----
 ## `DELETE /v1/sessions/:id`
-删除指定会话。
 ```json
 { "ok": true, "deleted": "abc123" }
 ```
@@ -198,46 +191,27 @@ min-agent serve --host 127.0.0.1 --port 8787
 ## `GET /v1/memory`
-列出所有记忆。
 ```json
-{
-  "memories": [
-    { "content": "用户喜欢中文回复", "tags": ["偏好"], "created": "2025-01-01T00:00:00Z" }
-  ]
-}
+{ "memories": [{ "content": "...", "tags": [...], "created": "..." }] }
 ```
----
 ## `POST /v1/memory`
-添加记忆。
 ```json
 // 请求
-{ "content": "项目使用 bun 作为包管理器", "tags": ["project"] }
+{ "content": "prefer TypeScript", "tags": ["preference"] }
 // 响应
-{ "ok": true, "memory": { "content": "...", "tags": [...], "created": "..." } }
+{ "ok": true, "memory": {...} }
 ```
----
-## `GET /v1/memory/search?q=bun`
-搜索记忆。
+## `GET /v1/memory/search?q=typescript`
 ```json
-{ "results": [{ "content": "...", "tags": [...], "created": "...", "index": 0 }] }
+{ "results": [{ "content": "...", "tags": [...], "index": 0 }] }
 ```
----
 ## `DELETE /v1/memory/:index`
-删除记忆（1-based index）。
 ```json
 { "ok": true, "deleted": 1 }
 ```
@@ -246,118 +220,41 @@ min-agent serve --host 127.0.0.1 --port 8787
 ## `GET /v1/mcp`
-MCP 服务器连接状态。
 ```json
-{
-  "servers": {
-    "filesystem": { "connected": true, "tools": ["read_file", "write_file", "list_dir"] },
-    "fetch": { "connected": false, "tools": [] }
-  }
-}
+{ "servers": { "filesystem": { "connected": true, "tools": ["read_file", "write_file"] } } }
 ```
----
-## `GET /v1/skills`
-可用技能列表。
-```json
-{
-  "skills": [
-    { "name": "git-workflow", "description": "Git workflow guide", "location": "/path/to/SKILL.md" }
-  ]
-}
-```
----
-## `GET /v1/rules`
-已加载的规则来源。
+## `POST /v1/mcp`
 ```json
-{
-  "count": 2,
-  "rules": [
-    { "source": "~/.min-agent/rules.md", "chars": 456 },
-    { "source": "/project/AGENTS.md", "chars": 1200 }
-  ]
-}
+// 本地 stdio
+{ "name": "fs", "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"] }
+// 远程
+{ "name": "remote", "url": "https://mcp.example.com", "token": "xxx" }
 ```
----
-## `POST /v1/paste`
-发送剪贴板图片 + 文本进行多模态对话。
 ```json
-// 请求
-{
-  "image_base64": "<base64 encoded image>",
-  "mime_type": "image/png",
-  "message": "这张图片里是什么？",
-  "model": "gpt-4o",
-  "session_id": "abc123",
-  "stream": true
-}
+{ "ok": true, "name": "fs" }
 ```
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `image_base64` | string | **必填** Base64 编码的图片数据 |
-| `mime_type` | string | 图片 MIME 类型（默认 `image/png`） |
-| `message` | string | 文本 prompt（默认 "What's in this image?"） |
-| `model` | string | 覆盖模型 |
-| `session_id` | string | 追加到已有会话 |
-| `stream` | boolean | SSE 流式 |
-响应格式与 `/v1/chat` 相同。
----
-## `POST /v1/code`
-Code 模式对话（与 `min-agent code` 相同的项目感知 prompt 和工具集）。
-请求体与 `/v1/chat` 相同，响应额外包含 `mode: "code"` 和 `project` 字段。
+## `DELETE /v1/mcp/:name`
 ```json
-// 请求
-{ "message": "add error handling to the login function", "stream": true }
-// 响应（非流式）额外字段
-{ "mode": "code", "project": { "languages": ["TypeScript"], "framework": "Next.js", ... }, ... }
+{ "ok": true, "deleted": "fs" }
 ```
 ---
-## `POST /v1/mcp`
-添加 MCP 服务器。
+## `GET /v1/skills`
 ```json
-// 本地 stdio
-{ "name": "filesystem", "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"] }
-// 远程 HTTP
-{ "name": "remote", "url": "https://mcp.example.com", "token": "xxx" }
+{ "skills": [{ "name": "git-workflow", "description": "...", "location": "..." }] }
 ```
-响应：`{ "ok": true, "name": "filesystem" }`
-注意：添加后需重启 serve 进程才能连接新服务器。
----
-## `DELETE /v1/mcp/:name`
-删除 MCP 服务器配置。
+## `GET /v1/rules`
 ```json
-{ "ok": true, "deleted": "filesystem" }
+{ "count": 2, "rules": [{ "source": "~/.min-agent/rules.md", "chars": 456 }] }
 ```
 ---
@@ -378,7 +275,7 @@ Code 模式对话（与 `min-agent code` 相同的项目感知 prompt 和工具
 ## 示例
 ```bash
-# 单轮对话
+# 对话
 curl http://127.0.0.1:8787/v1/chat \
   -H "Content-Type: application/json" \
   -d '{"message":"list files"}'
@@ -388,14 +285,26 @@ curl -N http://127.0.0.1:8787/v1/chat \
   -H "Content-Type: application/json" \
   -d '{"message":"say hi","stream":true}'
+# Code 模式
+curl http://127.0.0.1:8787/v1/code \
+  -H "Content-Type: application/json" \
+  -d '{"message":"add error handling to login"}'
+# 图片
+curl http://127.0.0.1:8787/v1/paste \
+  -H "Content-Type: application/json" \
+  -d '{"image_base64":"iVBOR...","message":"分析这张图"}'
+# 添加 MCP
+curl -X POST http://127.0.0.1:8787/v1/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"name":"fs","command":["npx","-y","@modelcontextprotocol/server-filesystem","/tmp"]}'
 # 添加记忆
 curl -X POST http://127.0.0.1:8787/v1/memory \
   -H "Content-Type: application/json" \
   -d '{"content":"prefer TypeScript","tags":["preference"]}'
-# 项目扫描
-curl http://127.0.0.1:8787/v1/project
 # 压缩会话
 curl -X POST http://127.0.0.1:8787/v1/chat/compact \
   -H "Content-Type: application/json" \

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "min-agent",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "Minimal AI coding agent with tool use, MCP, and skills support",
   "license": "MIT",