@saber2pr/ai-agent 0.0.54 → 0.0.55

package/lib/adapters/llm.d.ts

@@ -0,0 +1,18 @@
+import { AgentGraphLLMResponse, AgentGraphModel, StreamChunkCallback } from '../model/AgentGraphModel';
+import { BaseMessage } from '@langchain/core/messages';
+import { CreateAgentOptions } from '../agent/createAgent';
+export declare class LLMModel extends AgentGraphModel {
+    private chatId;
+    private options;
+    constructor(options: CreateAgentOptions);
+    resetChat(): void;
+    callApi(prompt: string): Promise<AgentGraphLLMResponse>;
+    /**
+     * 流式调用 API：发送 stream: true，自动适配多种响应格式（SSE / NDJSON / 普通 JSON）。
+     */
+    /**
+     * 流式调用 API：发送 stream: true
+     * 适配 SSE 格式，解析内容增量、思考过程以及最终的 Token 统计
+     */
+    callApiStream(prompt: string, lastMsg: BaseMessage, onChunk: StreamChunkCallback): Promise<AgentGraphLLMResponse>;
+}

package/lib/adapters/llm.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMModel = void 0;
+const AgentGraphModel_1 = require("../model/AgentGraphModel");
+class LLMModel extends AgentGraphModel_1.AgentGraphModel {
+    chatId;
+    options;
+    constructor(options) {
+        super();
+        this.chatId = '';
+        this.options = options;
+    }
+    resetChat() {
+        this.chatId = '';
+    }
+    async callApi(prompt) {
+        const response = await fetch(this.options.apiUrl, {
+            method: 'POST',
+            body: JSON.stringify({
+                query: prompt,
+                chatId: this.chatId,
+                stream: false,
+            }),
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.options.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`LLM API 响应异常: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        this.chatId = data.chat_id || data.chatId;
+        return {
+            text: data.text || '',
+            reasoning: data.reason || data.thought || '', // 适配后端可能的思考字段名
+            token: data.token, // ✅ 确保这里取到了 API 返回的 token
+            duration: data.duration, // ✅ 确保这里取到了 API 返回的 duration
+        };
+    }
+    /**
+     * 流式调用 API：发送 stream: true，自动适配多种响应格式（SSE / NDJSON / 普通 JSON）。
+     */
+    /**
+     * 流式调用 API：发送 stream: true
+     * 适配 SSE 格式，解析内容增量、思考过程以及最终的 Token 统计
+     */
+    async callApiStream(prompt, lastMsg, onChunk) {
+        const files = lastMsg?.additional_kwargs?.files || [];
+        const response = await fetch(this.options.apiUrl, {
+            method: 'POST',
+            body: JSON.stringify({
+                query: prompt,
+                chatId: this.chatId,
+                stream: true,
+                files
+            }),
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.options.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`LLM API 响应异常: ${response.status} ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type') || '';
+        // ✅ 情况1: 兜底处理非流式响应
+        if (contentType.includes('application/json')) {
+            const data = await response.json();
+            this.chatId = data.chat_id || data.chatId;
+            const text = data.text || data.content || '';
+            if (text)
+                onChunk(text);
+            return {
+                text,
+                reasoning: data.reason || data.thought || data.reasoning_content || '',
+                token: data.total_tokens || data.token || 0,
+                duration: data.duration || 0,
+            };
+        }
+        // ✅ 情况2: 流式响应处理
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error('响应体不支持流式读取');
+        }
+        const decoder = new TextDecoder();
+        let fullText = '';
+        let reasoning = '';
+        let token = 0;
+        let duration = 0;
+        let buffer = '';
+        let currentEvent = ''; // 记录当前的 SSE 事件类型
+        /**
+         * 内部解析函数：处理每一行 SSE 数据
+         */
+        const processLine = (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            // 1. 识别事件类型 (如 event: answer)
+            if (trimmed.startsWith('event:')) {
+                currentEvent = trimmed.slice(6).trim();
+                return;
+            }
+            // 2. 提取 Data 字符串
+            let dataStr = trimmed;
+            if (trimmed.startsWith('data:')) {
+                dataStr = trimmed.slice(5).trim();
+            }
+            // 跳过结束标志
+            if (dataStr === '[DONE]')
+                return;
+            try {
+                const data = JSON.parse(dataStr);
+                // A. 提取对话文本 (仅在 answer 事件中)
+                if (currentEvent === 'answer' || data.event === 'answer') {
+                    const chunkText = data.delta?.content || data.text || '';
+                    if (chunkText) {
+                        onChunk(chunkText);
+                        fullText += chunkText;
+                    }
+                    // 提取流式思考内容 (如果有)
+                    const rChunk = data.delta?.reasoning_content || '';
+                    if (rChunk)
+                        reasoning += rChunk;
+                }
+                // B. 提取统计信息 (在 done 或 flowNodeStatus 事件中)
+                // 根据你的日志，统计数据可能在 data.data 下或根部
+                const nestedData = data.data || data;
+                // 关键：优先匹配 total_tokens
+                const foundToken = nestedData.total_tokens || nestedData.totalTokens || nestedData.token || 0;
+                const foundDuration = nestedData.duration || 0;
+                if (foundToken > 0)
+                    token = foundToken;
+                if (foundDuration > 0)
+                    duration = foundDuration;
+                // C. 更新会话 ID
+                if (data.chat_id || data.chatId) {
+                    this.chatId = data.chat_id || data.chatId;
+                }
+                // D. 提取非流式的完整思考内容
+                const fullReasoning = nestedData.reasoning_content || nestedData.reason || nestedData.thought;
+                if (fullReasoning && currentEvent !== 'answer') {
+                    reasoning = fullReasoning;
+                }
+            }
+            catch (e) {
+                // 非 JSON 格式行，且当前处于回答状态时，作为纯文本 fallback
+                if (currentEvent === 'answer') {
+                    onChunk(trimmed);
+                    fullText += trimmed;
+                }
+            }
+        };
+        // 主循环：读取流
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // 留下不完整的一行在下个循环处理
+            for (const line of lines) {
+                processLine(line);
+            }
+        }
+        // 处理流结束后的残留 buffer
+        if (buffer.trim()) {
+            processLine(buffer);
+        }
+        return {
+            text: fullText,
+            reasoning,
+            token,
+            duration
+        };
+    }
+}
+exports.LLMModel = LLMModel;

package/lib/agent/createAgent.d.ts

@@ -0,0 +1,13 @@
+import McpGraphAgent from '../core/agent-graph';
+import { GraphAgentOptions } from '../types/type';
+import { LLMModel } from '../adapters/llm';
+export interface CreateAgentOptions {
+    apiKey: string;
+    apiUrl: string;
+    targetDir?: string;
+    /** 是否启用流式输出，默认 false */
+    stream?: boolean;
+    config?: GraphAgentOptions;
+}
+export declare const createAgent: (options: CreateAgentOptions) => McpGraphAgent<LLMModel>;
+export type Agent = ReturnType<typeof createAgent>;

package/lib/agent/createAgent.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgent = void 0;
+const agent_graph_1 = __importDefault(require("../core/agent-graph"));
+const llm_1 = require("../adapters/llm");
+const createAgent = (options) => {
+    const agent = new agent_graph_1.default({
+        alwaysSystem: false,
+        apiModel: new llm_1.LLMModel(options),
+        targetDir: options.targetDir,
+        stream: options.stream, // ✅ 将 stream 选项透传到 McpGraphAgent
+        ...(options?.config || {}),
+    });
+    return agent;
+};
+exports.createAgent = createAgent;

package/lib/{cli-graph.js → cli-openai.js}

@@ -4,8 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const agent_graph_1 = __importDefault(require("./core/agent-graph"));
-const agent = new agent_graph_1.default({
-    stream: true,
-});
+const agent_1 = __importDefault(require("./core/agent"));
+const agent = new agent_1.default();
 agent.start();

package/lib/cli.js

@@ -1,9 +1,104 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const agent_1 = __importDefault(require("./core/agent"));
-const agent = new agent_1.default();
-agent.start();
+const fs_1 = require("fs");
+const config_1 = require("./config/config");
+const readline_1 = require("readline");
+const createAgent_1 = require("./agent/createAgent");
+// 读取配置文件
+function loadConfig() {
+    if (!(0, fs_1.existsSync)(config_1.CONFIG_FILE)) {
+        return null;
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(config_1.CONFIG_FILE, 'utf-8');
+        const config = JSON.parse(content);
+        // 验证配置完整性
+        if (!config.apiKey || !config.apiUrl) {
+            return null;
+        }
+        return config;
+    }
+    catch (error) {
+        console.error(`读取配置文件失败: ${config_1.CONFIG_FILE}`, error);
+        return null;
+    }
+}
+// 保存配置文件
+function saveConfig(config) {
+    try {
+        (0, fs_1.writeFileSync)(config_1.CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+        console.log(`配置已保存到: ${config_1.CONFIG_FILE}`);
+    }
+    catch (error) {
+        console.error(`保存配置文件失败: ${config_1.CONFIG_FILE}`, error);
+        process.exit(1);
+    }
+}
+// CLI 交互式输入配置
+async function promptConfig() {
+    const rl = (0, readline_1.createInterface)({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (query) => {
+        return new Promise(resolve => {
+            rl.question(query, resolve);
+        });
+    };
+    try {
+        console.log('\n欢迎使用 AI Agent CLI！');
+        console.log('首次使用需要配置 API 信息。\n');
+        const apiUrlInput = await question(`请输入 API URL: `);
+        if (!apiUrlInput.trim()) {
+            console.error('API URL 不能为空！');
+            rl.close();
+            process.exit(1);
+        }
+        const apiKey = await question('请输入 API Key: ');
+        if (!apiKey.trim()) {
+            console.error('API Key 不能为空！');
+            rl.close();
+            process.exit(1);
+        }
+        const apiUrl = apiUrlInput.trim();
+        rl.close();
+        const config = {
+            apiKey: apiKey.trim(),
+            apiUrl: apiUrl.trim(),
+        };
+        return config;
+    }
+    catch (error) {
+        rl.close();
+        console.error('输入配置时出错:', error);
+        process.exit(1);
+    }
+}
+// 主函数
+async function main() {
+    let config = loadConfig();
+    // 如果配置不存在或不完整，提示用户输入
+    if (!config) {
+        console.log(`未找到配置文件或配置不完整。${config_1.CONFIG_FILE}`);
+        config = await promptConfig();
+        saveConfig(config);
+    }
+    // 创建并启动 agent（默认开启流式输出）
+    const agent = (0, createAgent_1.createAgent)({
+        apiKey: config.apiKey,
+        apiUrl: config.apiUrl,
+        stream: true,
+        targetDir: process.cwd()
+    });
+    const model = await agent.ensureInitialized();
+    if (process.env.AI_AGENT_CLI_NO_MCP) {
+        model.setMcpEnabled(false);
+    }
+    console.log('欢迎使用 AI Agent CLI！请输入问题，按 Ctrl+C 退出。\n当前目录：', process.cwd());
+    await agent.start();
+}
+main().catch(error => {
+    console.error('启动失败:', error);
+    process.exit(1);
+});

package/lib/core/agent-graph.js

@@ -32,7 +32,7 @@ const AgentState = langgraph_1.Annotation.Root({
     // ✅ Token 累加器
     tokenUsage: (0, langgraph_1.Annotation)({
         reducer: (x, y) => ({
-            total: ((x === null || x === void 0 ? void 0 : x.total) || 0) + ((y === null || y === void 0 ? void 0 : y.total) || 0),
+            total: (x?.total || 0) + (y?.total || 0),
         }),
         default: () => ({ total: 0 }),
     }),
@@ -43,12 +43,22 @@ const AgentState = langgraph_1.Annotation.Root({
     }),
 });
 class McpGraphAgent {
+    model;
+    toolNode;
+    targetDir;
+    options;
+    checkpointer = new langgraph_1.MemorySaver();
+    langchainTools = [];
+    stopLoadingFunc = null;
+    verbose;
+    alwaysSystem;
+    recursionLimit;
+    apiConfig;
+    maxTokens;
+    mcpClients = [];
+    streamEnabled;
+    streamOutputCallback = null;
     constructor(options = {}) {
-        this.checkpointer = new langgraph_1.MemorySaver();
-        this.langchainTools = [];
-        this.stopLoadingFunc = null;
-        this.mcpClients = [];
-        this.streamOutputCallback = null;
         this.options = options;
         this.verbose = options.verbose || false;
         this.alwaysSystem = options.alwaysSystem || true;
@@ -342,7 +352,6 @@ class McpGraphAgent {
         ask();
     }
     renderOutput(output, isStreaming = false) {
-        var _a, _b, _c;
         this.stopLoading(); // 停止加载动画
         const agentNode = output.agent;
         // ✅ 打印工具执行结果（tools 节点的输出）
@@ -350,9 +359,9 @@ class McpGraphAgent {
         if (toolsNode && toolsNode.messages) {
             const toolMessages = Array.isArray(toolsNode.messages) ? toolsNode.messages : [];
             // 获取最近的 AI 消息以匹配 tool_call_id
-            const lastAiMsg = (_a = agentNode === null || agentNode === void 0 ? void 0 : agentNode.messages) === null || _a === void 0 ? void 0 : _a[agentNode.messages.length - 1];
+            const lastAiMsg = agentNode?.messages?.[agentNode.messages.length - 1];
             const toolCallMap = new Map();
-            if (lastAiMsg === null || lastAiMsg === void 0 ? void 0 : lastAiMsg.tool_calls) {
+            if (lastAiMsg?.tool_calls) {
                 lastAiMsg.tool_calls.forEach((tc) => {
                     if (tc.id)
                         toolCallMap.set(tc.id, tc.name);
@@ -374,7 +383,7 @@ class McpGraphAgent {
             const msg = agentNode.messages[agentNode.messages.length - 1];
             // 1. 打印思考过程（如果有）
             // 流式模式下思考内容可能已经随流输出，此处仅在非流式模式或有独立 reasoning 字段时打印
-            const reasoning = (_b = msg.additional_kwargs) === null || _b === void 0 ? void 0 : _b.reasoning;
+            const reasoning = msg.additional_kwargs?.reasoning;
             if (reasoning && !isStreaming) {
                 console.log(`\n🧠 [思考]: ${reasoning}`);
             }
@@ -391,7 +400,7 @@ class McpGraphAgent {
                 process.stdout.write(`📊 \x1b[2m[实时统计] 消耗: ${token} tokens | 耗时: ${duration}ms\x1b[0m\n`);
             }
             // 4. 打印工具调用情况
-            if ((_c = msg.tool_calls) === null || _c === void 0 ? void 0 : _c.length) {
+            if (msg.tool_calls?.length) {
                 msg.tool_calls.forEach(call => {
                     console.log(`🛠️ [调用工具]: ${call.name} 📦 参数: ${JSON.stringify(call.args)}`);
                 });
@@ -406,19 +415,19 @@ class McpGraphAgent {
                 .join('\n')}`
             : '';
         // 1. 构建当前的系统提示词模板
-        const systemPromptTemplate = `你是一个代码专家。工作目录：${this.targetDir}。
+        const systemPromptTemplate = `You are an expert software engineer. Working directory: ${this.targetDir}.
 
-# 🧠 思考要求 (Mandatory Thinking Process)
-在进行任何输出或调用工具之前，你**必须**先进行深度的逻辑思考。请将你的思考过程包裹在 <think> 标签内。
+# 🧠 Mandatory Thinking Process
+Before providing any output or calling a tool, you **MUST** conduct a deep logical analysis. Wrap your thought process within <think> tags.
 
-# 🛠️ 工具调用规范
-1. Arguments 必须是纯粹的 JSON 对象，严禁将其作为字符串放入引号中。
-2. 严禁对 JSON 内容进行二次转义。
-3. **禁止空操作**：如果你认为任务已完成或不需要调用工具，请不要输出任何 Action 结构。严禁使用 "None"、"null" 或空字符串作为工具名称。
+# 🛠️ Tool Call Specifications
+1. **Pure JSON Arguments**: Arguments must be a valid JSON object. NEVER wrap the entire JSON object in a string or quotes.
+2. **No Double Escaping**: Do not double-escape characters within the JSON.
+3. **No Idle Operations**: If the task is complete or no tool is needed, DO NOT output any "Action" structure. Never use "None", "null", or empty strings as a tool name.
 
-# 🎯 核心指令
-1. **任务终结判定**：当你已经读取了用户要求的文件、回答了问题或完成了代码编写时，必须立即提供最终回复。
-2. **回复格式**：任务完成时，请以 "Final Answer:" 开头进行总结，此时不再调用任何工具。
+# 🎯 Core Instructions
+1. **Termination Criterion**: Once you have read the requested files, answered the questions, or completed the code implementation, you must provide the final response immediately.
+2. **Response Format**: Upon task completion, start your summary with "Final Answer:". No further tool calls should be made after this point.
 
 {extraPrompt}`;
         // 2. 核心逻辑：处理消息上下文
@@ -574,12 +583,11 @@ class McpGraphAgent {
         }
     }
     getRecentToolCalls(messages, limit = 5) {
-        var _a;
         const toolCalls = [];
         // 从后往前遍历消息，收集最近的工具调用
         for (let i = messages.length - 1; i >= 0 && toolCalls.length < limit; i--) {
             const msg = messages[i];
-            if ((_a = msg.tool_calls) === null || _a === void 0 ? void 0 : _a.length) {
+            if (msg.tool_calls?.length) {
                 for (const tc of msg.tool_calls) {
                     toolCalls.push({ name: tc.name, args: tc.args });
                     if (toolCalls.length >= limit)
@@ -590,8 +598,7 @@ class McpGraphAgent {
         return toolCalls;
     }
     printFinalSummary(state) {
-        var _a;
-        const totalTokens = ((_a = state.tokenUsage) === null || _a === void 0 ? void 0 : _a.total) || 0;
+        const totalTokens = state.tokenUsage?.total || 0;
         const totalMs = state.totalDuration || 0;
         if (totalTokens > 0 || totalMs > 0) {
             console.log('\n' + '═'.repeat(50));

package/lib/core/agent.js

@@ -49,16 +49,21 @@ const config_1 = require("../config/config");
 const builtin_1 = require("../tools/builtin");
 const jsonSchemaToZod_1 = require("../utils/jsonSchemaToZod");
 class McpAgent {
+    openai;
+    modelName = '';
+    allTools = [];
+    messages = [];
+    encoder;
+    extraTools = [];
+    maxTokens;
+    apiConfig;
+    targetDir;
+    mcpClients = [];
     constructor(options) {
-        this.modelName = '';
-        this.allTools = [];
-        this.messages = [];
-        this.extraTools = [];
-        this.mcpClients = [];
-        this.targetDir = (options === null || options === void 0 ? void 0 : options.targetDir) || process.cwd();
-        this.extraTools = (options === null || options === void 0 ? void 0 : options.tools) || []; // 接收外部传入的工具
-        this.maxTokens = (options === null || options === void 0 ? void 0 : options.maxTokens) || 100000; // 默认 100k
-        this.apiConfig = options === null || options === void 0 ? void 0 : options.apiConfig;
+        this.targetDir = options?.targetDir || process.cwd();
+        this.extraTools = options?.tools || []; // 接收外部传入的工具
+        this.maxTokens = options?.maxTokens || 100000; // 默认 100k
+        this.apiConfig = options?.apiConfig;
         let baseSystemPrompt = `你是一个专业的代码架构师。
 你的目标是理解并分析用户项目，请务必遵循以下工作流：
 
@@ -74,7 +79,7 @@ class McpAgent {
 - 优先查看 Skeleton（骨架），只有需要修复逻辑时才读取完整 Text（全文）。
 - 始终以中文回答思考过程。`;
         // 2. 拼接额外指令
-        if (options === null || options === void 0 ? void 0 : options.extraSystemPrompt) {
+        if (options?.extraSystemPrompt) {
             const extra = typeof options.extraSystemPrompt === 'string'
                 ? options.extraSystemPrompt
                 : JSON.stringify(options.extraSystemPrompt, null, 2);
@@ -152,7 +157,7 @@ class McpAgent {
             }),
             ...this.extraTools,
         ];
-        if (allTools === null || allTools === void 0 ? void 0 : allTools.length) {
+        if (allTools?.length) {
             this.allTools.push(...allTools);
         }
     }
@@ -251,7 +256,6 @@ class McpAgent {
         });
     }
     async processChat(userInput) {
-        var _a;
         this.messages.push({ role: 'user', content: userInput });
         while (true) {
             // --- 新增：发送请求前先检查并裁剪 ---
@@ -282,7 +286,7 @@ class McpAgent {
             const { message } = response.choices[0];
             this.messages.push(message);
             // 计算本次 AI 回复生成的 Token
-            const completionTokens = ((_a = response.usage) === null || _a === void 0 ? void 0 : _a.completion_tokens) ||
+            const completionTokens = response.usage?.completion_tokens ||
                 (message.content ? this.encoder.encode(message.content).length : 0);
             console.log(`✨ AI 回复消耗: ${completionTokens} tokens`);
             if (!message.tool_calls) {
@@ -301,10 +305,10 @@ class McpAgent {
                 console.log(`\n   🛠️  执行工具: \x1b[36m${call.function.name}\x1b[0m`);
                 console.log(`   📦 传入参数: \x1b[2m${JSON.stringify(args)}\x1b[0m`);
                 let result;
-                if (tool === null || tool === void 0 ? void 0 : tool._handler) {
+                if (tool?._handler) {
                     result = await tool._handler(args);
                 }
-                else if ((tool === null || tool === void 0 ? void 0 : tool._client) && tool._originalName) {
+                else if (tool?._client && tool._originalName) {
                     const mcpRes = await tool._client.callTool({
                         name: tool._originalName,
                         arguments: args,

package/lib/index.d.ts

@@ -4,3 +4,4 @@ export { createTool } from './utils/createTool';
 export * from './model/AgentGraphModel';
 export { default as McpGraphAgent } from './core/agent-graph';
 export * from './types/type';
+export { createAgent } from './agent/createAgent';

package/lib/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.McpGraphAgent = exports.createTool = exports.default = void 0;
+exports.createAgent = exports.McpGraphAgent = exports.createTool = exports.default = void 0;
 __exportStar(require("./core/agent"), exports);
 var agent_1 = require("./core/agent");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(agent_1).default; } });
@@ -27,3 +27,5 @@ __exportStar(require("./model/AgentGraphModel"), exports);
 var agent_graph_1 = require("./core/agent-graph");
 Object.defineProperty(exports, "McpGraphAgent", { enumerable: true, get: function () { return __importDefault(agent_graph_1).default; } });
 __exportStar(require("./types/type"), exports);
+var createAgent_1 = require("./agent/createAgent");
+Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return createAgent_1.createAgent; } });

package/lib/model/AgentGraphModel.js

@@ -4,9 +4,12 @@ exports.AgentGraphModel = void 0;
 const chat_models_1 = require("@langchain/core/language_models/chat_models");
 const messages_1 = require("@langchain/core/messages");
 const function_calling_1 = require("@langchain/core/utils/function_calling");
-const cleanToolDefinition_1 = require("../utils/cleanToolDefinition");
+const generateToolMarkdown_1 = require("../utils/generateToolMarkdown");
 const kit_1 = require("../utils/kit");
 class AgentGraphModel extends chat_models_1.BaseChatModel {
+    boundTools;
+    mcpEnabled = true;
+    mcpTools = [];
     setMcpTools(tools) {
         this.mcpTools = tools;
     }
@@ -21,12 +24,10 @@ class AgentGraphModel extends chat_models_1.BaseChatModel {
     }
     isMcpTool(tool) {
         const mcpTools = (0, kit_1.getArray)(this.mcpTools);
-        return mcpTools.some(t => { var _a, _b; return ((_a = t === null || t === void 0 ? void 0 : t.function) === null || _a === void 0 ? void 0 : _a.name) === ((_b = tool === null || tool === void 0 ? void 0 : tool.function) === null || _b === void 0 ? void 0 : _b.name); });
+        return mcpTools.some(t => t?.function?.name === tool?.function?.name);
     }
     constructor(fields) {
         super(fields || {});
-        this.mcpEnabled = true;
-        this.mcpTools = [];
     }
     bindTools(tools) {
         this.boundTools = tools.map(t => (0, function_calling_1.convertToOpenAITool)(t));
@@ -175,7 +176,7 @@ class AgentGraphModel extends chat_models_1.BaseChatModel {
         };
         const tools = this.getMcpEnabled() ? (0, kit_1.getArray)(this.boundTools) : (0, kit_1.getArray)(this.boundTools).filter(tool => !this.isMcpTool(tool));
         const toolsContext = tools.length
-            ? `\n[Tools]\n${JSON.stringify(tools.map(cleanToolDefinition_1.cleanToolDefinition), null, 2)}`
+            ? `${(0, generateToolMarkdown_1.generateToolMarkdown)(tools)}`
             : '';
         return `
 ${format(systemMsg)}

package/lib/tools/builtin.js

@@ -6,7 +6,7 @@ const ts_lsp_1 = require("./ts-lsp");
 function createDefaultBuiltinTools(context) {
     const { options } = context;
     return [
-        ...(0, ts_lsp_1.getTsLspTools)((options === null || options === void 0 ? void 0 : options.targetDir) || process.cwd()),
-        ...(0, filesystem_1.getFilesystemTools)((options === null || options === void 0 ? void 0 : options.targetDir) || process.cwd()),
+        ...(0, ts_lsp_1.getTsLspTools)(options?.targetDir || process.cwd()),
+        ...(0, filesystem_1.getFilesystemTools)(options?.targetDir || process.cwd()),
     ];
 }

package/lib/tools/filesystem/index.js

@@ -1,11 +1,45 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFilesystemTools = void 0;
 const promises_1 = __importDefault(require("fs/promises"));
-const minimatch_1 = require("minimatch");
+const minimatchLib = __importStar(require("minimatch"));
+const minimatch = typeof minimatchLib === 'function' ? minimatchLib : minimatchLib.minimatch;
 const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const createTool_1 = require("../../utils/createTool");
@@ -50,7 +84,7 @@ const ListDirectoryWithSizesArgsSchema = zod_1.z.object({
 const DirectoryTreeArgsSchema = zod_1.z.object({
     path: zod_1.z.string(),
     excludePatterns: zod_1.z.array(zod_1.z.string()).optional().default([]),
-    depth: zod_1.z.number().optional().default(2).describe('递归深度，默认 2 层。增加深度会消耗更多 Token'),
+    depth: zod_1.z.number().optional().default(2).describe('Recursive depth, default 2 layers. Increasing depth will consume more tokens'),
 });
 const MoveFileArgsSchema = zod_1.z.object({
     source: zod_1.z.string(),
@@ -65,19 +99,19 @@ const GetFileInfoArgsSchema = zod_1.z.object({
     path: zod_1.z.string(),
 });
 const GrepSearchArgsSchema = zod_1.z.object({
-    path: zod_1.z.string().describe('搜索的起始目录路径'),
-    query: zod_1.z.string().describe('要搜索的文本关键字'),
-    includePattern: zod_1.z.string().optional().default('**/*').describe('匹配模式，例如 "**/*.ts"'),
-    maxFiles: zod_1.z.number().optional().default(100).describe('最大扫描文件数，防止大型项目超时'),
+    path: zod_1.z.string().describe('The starting directory path to search'),
+    query: zod_1.z.string().describe('The text keyword to search'),
+    includePattern: zod_1.z.string().optional().default('**/*').describe('The matching pattern, for example "**/*.ts"'),
+    maxFiles: zod_1.z.number().optional().default(100).describe('The maximum number of files to scan, to prevent large projects from timing out'),
 });
 const PatchEditArgsSchema = zod_1.z.object({
-    path: zod_1.z.string().describe('文件路径'),
+    path: zod_1.z.string().describe('The file path'),
     patches: zod_1.z.array(zod_1.z.object({
-        startLine: zod_1.z.number().describe('起始行号（包含）'),
-        endLine: zod_1.z.number().describe('结束行号（包含）'),
-        replacement: zod_1.z.string().describe('要插入的新代码内容'),
-        originalSnippet: zod_1.z.string().optional().describe('可选：该行范围内的原始代码片段，用于二次校验防止行号偏移'),
-    })).describe('补丁列表。注意：若有多个补丁，建议从文件尾部向头部执行，或确保行号不重叠'),
+        startLine: zod_1.z.number().describe('The start line number (inclusive)'),
+        endLine: zod_1.z.number().describe('The end line number (inclusive)'),
+        replacement: zod_1.z.string().describe('The new code content to insert'),
+        originalSnippet: zod_1.z.string().optional().describe('Optional: The original code snippet within the line range, used to verify and prevent line number offset'),
+    })).describe('The patch list. Note: If there are multiple patches, it is recommended to execute from the end of the file to the beginning, or ensure that the line numbers do not overlap'),
 });
 const getFilesystemTools = (targetDir) => {
     (0, lib_1.setAllowedDirectories)([targetDir]);
@@ -101,15 +135,15 @@ const getFilesystemTools = (targetDir) => {
     };
     const readTextFileTool = (0, createTool_1.createTool)({
         name: 'read_text_file',
-        description: '读取文件全文。若超过100行则禁止使用，必须改用 read_file_range。支持 head/tail 参数。',
+        description: 'Read the full content of the file. If it exceeds 100 lines, it is forbidden to use, must use read_file_range. Supports head/tail parameters.',
         parameters: ReadTextFileArgsSchema,
         handler: readTextFileHandler,
     });
     const readMultipleFilesTool = (0, createTool_1.createTool)({
         name: 'read_multiple_files',
-        description: '同时读取多个文件的内容。当你需要对比多个文件或分析跨文件关联时使用。' +
-            '注意：为了防止 Token 溢出，本工具一次最多读取 10 个文件，且每个文件仅展示前 6000 字符。' +
-            '若需查看完整大文件或特定逻辑，请改用 read_file_range。',
+        description: 'Read the content of multiple files at the same time. Use when you need to compare multiple files or analyze cross-file relationships.' +
+            'Note: To prevent token overflow, this tool can read up to 10 files at a time, and each file only displays the first 6000 characters.' +
+            'If you need to view the complete large file or specific logic, please use read_file_range instead.',
         parameters: ReadMultipleFilesArgsSchema,
         handler: async (args) => {
             // 保护 1：文件数量限制 (防止 AI 一次传入几十个文件)
@@ -124,25 +158,25 @@ const getFilesystemTools = (targetDir) => {
                     const validPath = await (0, lib_1.validatePath)(targetDir, filePath);
                     const content = await (0, lib_1.readFileContent)(validPath);
                     if (content.length > MAX_CHARS_PER_FILE) {
-                        return `${filePath} (内容已截断):\n${content.substring(0, MAX_CHARS_PER_FILE)}\n\n[... 内容过长，仅展示前 ${MAX_CHARS_PER_FILE} 字符。若需查看后续内容，请使用 read_file_range 指定行号读取 ...]`;
+                        return `${filePath} (Content truncated):\n${content.substring(0, MAX_CHARS_PER_FILE)}\n\n[... Content too long, only showing the first ${MAX_CHARS_PER_FILE} characters. If you need to view the subsequent content, please use read_file_range to specify the line number to read ...]`;
                     }
                     return `${filePath}:\n${content}\n`;
                 }
                 catch (error) {
                     const errorMessage = error instanceof Error ? error.message : String(error);
-                    return `${filePath}: 读取失败 - ${errorMessage}`;
+                    return `${filePath}: Read failed - ${errorMessage}`;
                 }
             }));
             let text = results.join('\n---\n');
             if (isTruncatedByCount) {
-                text += `\n\n⚠️ 注意：一次请求最多处理 ${MAX_FILES} 个文件。剩余 ${args.paths.length - MAX_FILES} 个文件未读取，请分批请求。`;
+                text += `\n\n⚠️ Note: The maximum number of files processed in one request is ${MAX_FILES}. ${args.paths.length - MAX_FILES} files remain unread, please request in batches.`;
             }
             return text;
         },
     });
     const writeFileTool = (0, createTool_1.createTool)({
         name: 'write_file',
-        description: '仅用于创建新文件。严禁用于修改现有源代码。',
+        description: 'Only used to create new files. It is forbidden to use it to modify existing source code.',
         parameters: WriteFileArgsSchema,
         handler: async (args) => {
             const validPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -153,7 +187,7 @@ const getFilesystemTools = (targetDir) => {
     });
     const createDirectoryTool = (0, createTool_1.createTool)({
         name: 'create_directory',
-        description: '递归创建目录。支持多级嵌套。若目录已存在则静默成功。仅限允许目录。',
+        description: 'Recursively create a directory. Supports nested directories. If the directory already exists, it will be successful silently. Only allowed directories.',
         parameters: CreateDirectoryArgsSchema,
         handler: async (args) => {
             const validPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -164,7 +198,7 @@ const getFilesystemTools = (targetDir) => {
     });
     const listDirectoryWithSizesTool = (0, createTool_1.createTool)({
         name: 'list_directory',
-        description: '列出目录内容。返回带 [FILE]/[DIR] 前缀的条目、大小及汇总。支持按名称或大小排序。',
+        description: 'List the contents of the directory. Return entries with [FILE]/[DIR] prefix, size, and summary. Supports sorting by name or size.',
         parameters: ListDirectoryWithSizesArgsSchema,
         handler: async (args) => {
             const validPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -215,8 +249,8 @@ const getFilesystemTools = (targetDir) => {
     });
     const directoryTreeTool = (0, createTool_1.createTool)({
         name: 'directory_tree',
-        description: '获取目录的递归树状 JSON 结构。' +
-            '默认仅展示 2 层深度以节省 Token。如果需要看更深层级，请调大 depth 参数。',
+        description: 'Get the recursive tree JSON structure of the directory.' +
+            'Default only shows 2 layers of depth to save tokens. If you need to see deeper levels, please increase the depth parameter.',
         parameters: DirectoryTreeArgsSchema,
         handler: async (args) => {
             // 在 directory_tree 的 handler 内部
@@ -230,7 +264,7 @@ const getFilesystemTools = (targetDir) => {
                 const result = [];
                 for (const entry of entries) {
                     const relativePath = path_1.default.relative(rootPath, path_1.default.join(currentPath, entry.name));
-                    const shouldExclude = excludePatterns.some(pattern => (0, minimatch_1.minimatch)(relativePath, pattern, { dot: true }));
+                    const shouldExclude = excludePatterns.some(pattern => minimatch(relativePath, pattern, { dot: true }));
                     if (shouldExclude)
                         continue;
                     const entryData = {
@@ -251,7 +285,7 @@ const getFilesystemTools = (targetDir) => {
     });
     const moveFileTool = (0, createTool_1.createTool)({
         name: 'move_file',
-        description: '移动或重命名文件/目录。目标路径若已存在则失败。源与目标均须在允许目录内。',
+        description: 'Move or rename a file/directory. If the target path already exists, it will fail. The source and target must be within the allowed directories.',
         parameters: MoveFileArgsSchema,
         handler: async (args) => {
             const validSourcePath = await (0, lib_1.validatePath)(targetDir, args.source);
@@ -263,7 +297,7 @@ const getFilesystemTools = (targetDir) => {
     });
     const searchFilesTool = (0, createTool_1.createTool)({
         name: 'search_files',
-        description: '在指定路径下搜索匹配模式的文件名。返回匹配的相对路径列表。',
+        description: 'Search for file names matching a pattern in the specified path. Return a list of matching relative paths.',
         parameters: SearchFilesArgsSchema,
         handler: async (args) => {
             const combinedExcludes = [...DEFAULT_IGNORE, ...(args.excludePatterns || [])];
@@ -277,7 +311,7 @@ const getFilesystemTools = (targetDir) => {
     });
     const getFileInfoTool = (0, createTool_1.createTool)({
         name: 'get_file_info',
-        description: '查看文件元数据（大小、行数、修改时间）。读取大文件前务必先调用此工具。',
+        description: 'View file metadata (size, line count, modification time). Must call this tool before reading large files.',
         parameters: GetFileInfoArgsSchema,
         handler: async (args) => {
             const validPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -299,9 +333,9 @@ const getFilesystemTools = (targetDir) => {
     });
     const grepSearchTool = (0, createTool_1.createTool)({
         name: 'grep_search',
-        description: '在指定目录的文件内容中搜索关键字。' +
-            '该工具会返回包含关键字的文件路径及匹配行的预览。' +
-            '请尽量通过 includePattern 缩小搜索范围。',
+        description: 'Search for keywords in the content of files in the specified directory.' +
+            'This tool will return the file paths and preview of matching lines containing the keywords.' +
+            'Please narrow down the search scope as much as possible using includePattern.',
         parameters: GrepSearchArgsSchema,
         handler: async (args) => {
             const startPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -333,21 +367,21 @@ const getFilesystemTools = (targetDir) => {
                 }));
             }
             let response = matches.length > 0
-                ? `找到关键词 "${args.query}" 的位置如下：\n${matches.join('\n')}`
-                : `未找到包含 "${args.query}" 的内容。`;
+                ? `The location of the keyword "${args.query}" is as follows:\n${matches.join('\n')}`
+                : `The content containing "${args.query}" was not found.`;
             if (allFiles.length > args.maxFiles) {
-                response += `\n\n注意：搜索已达到限制，仅扫描了前 ${args.maxFiles} 个文件。若未找到结果，请提供更精确的 path 或 includePattern。`;
+                response += `\n\nNote: The search has reached the limit, only scanned the first ${args.maxFiles} files. If no results are found, please provide a more precise path or includePattern.`;
             }
             return response;
         },
     });
     const readFileRangeTool = (0, createTool_1.createTool)({
         name: 'read_file_range',
-        description: '精准读取指定行范围（包含行号前缀）。修改代码前或根据报错定位时必用。',
+        description: 'Precisely read the specified line range (includes line number prefix). Must use this tool before modifying code or locating errors based on error messages.',
         parameters: zod_1.z.object({
-            path: zod_1.z.string().describe('相对于目标目录的文件路径'),
-            startLine: zod_1.z.number().describe('起始行号（从 1 开始计）'),
-            endLine: zod_1.z.number().describe('结束行号'),
+            path: zod_1.z.string().describe('The file path relative to the target directory'),
+            startLine: zod_1.z.number().describe('The starting line number (starts from 1)'),
+            endLine: zod_1.z.number().describe('The ending line number'),
         }),
         handler: async (args) => {
             // 1. 验证路径安全（沿用你代码中的 validatePath 逻辑）
@@ -360,26 +394,26 @@ const getFilesystemTools = (targetDir) => {
                 const start = Math.max(1, args.startLine);
                 const end = Math.min(totalLines, args.endLine);
                 if (start > totalLines) {
-                    return `错误：文件仅有 ${totalLines} 行，起始行号 ${start} 超出范围。`;
+                    return `Error: The file only has ${totalLines} lines, the starting line number ${start} is out of range.`;
                 }
                 if (start > end) {
-                    return `错误：起始行号 ${start} 不能大于结束行号 ${end}。`;
+                    return `Error: The starting line number ${start} cannot be greater than the ending line number ${end}.`;
                 }
                 // 3. 截取并添加行号索引（核心：增强 AI 的位置感）
                 const selectedLines = lines.slice(start - 1, end);
                 const formattedContent = selectedLines
                     .map((line, index) => `${start + index}| ${line}`)
                     .join('\n');
-                return `[文件: ${args.path} | 第 ${start} 至 ${end} 行 / 共 ${totalLines} 行]\n${formattedContent}`;
+                return `[File: ${args.path} | Lines ${start} to ${end} / Total ${totalLines} lines]\n${formattedContent}`;
             }
             catch (error) {
-                return `读取文件范围失败: ${error.message}`;
+                return `Failed to read the file range: ${error.message}`;
             }
         },
     });
     const editFileTool = (0, createTool_1.createTool)({
         name: 'edit_file',
-        description: '基于行号范围替换代码。修改逻辑的唯一工具。调用前须通过 read_file_range 获取最新行号。支持删除(空内容)或单行替换。',
+        description: 'Replace code based on line number range. The only tool for modifying logic. Must call read_file_range to get the latest line number before calling. Supports deletion (empty content) or single line replacement.',
         parameters: PatchEditArgsSchema,
         handler: async (args) => {
             const validPath = await (0, lib_1.validatePath)(targetDir, args.path);
@@ -391,14 +425,14 @@ const getFilesystemTools = (targetDir) => {
                 for (const patch of sortedPatches) {
                     // 校验行号合法性
                     if (patch.startLine < 1 || patch.endLine > lines.length || patch.startLine > patch.endLine) {
-                        return `错误：行号范围 ${patch.startLine}-${patch.endLine} 超出文件实际范围 (1-${lines.length})`;
+                        return `Error: The line number range ${patch.startLine}-${patch.endLine} is out of the actual range of the file (1-${lines.length})`;
                     }
                     // 可选：二次校验（防止 AI 记忆了错误的行号）
                     if (patch.originalSnippet) {
                         const currentText = lines.slice(patch.startLine - 1, patch.endLine).join('\n');
                         // 模糊对比，如果差异太大则报错
                         if (!currentText.includes(patch.originalSnippet.trim()) && currentText.trim().length > 0) {
-                            return `警告：第 ${patch.startLine} 行的内容已发生变动，与你预想的代码不符。请重新读取文件获取最新行号。`;
+                            return `Warning: The content of the ${patch.startLine} line has changed, which does not match your expected code. Please read the file again to get the latest line number.`;
                         }
                     }
                     // 执行替换：splice(开始索引, 删除数量, 替换内容)
@@ -406,10 +440,10 @@ const getFilesystemTools = (targetDir) => {
                     lines.splice(patch.startLine - 1, (patch.endLine - patch.startLine) + 1, patch.replacement);
                 }
                 await promises_1.default.writeFile(validPath, lines.join('\n'), 'utf-8');
-                return `成功通过行号更新了 ${args.path} 的 ${args.patches.length} 处代码。`;
+                return `Successfully updated ${args.path} with ${args.patches.length} code changes.`;
             }
             catch (error) {
-                return `Patch 失败: ${error.message}`;
+                return `Patch failed: ${error.message}`;
             }
         },
     });

package/lib/tools/filesystem/lib.js

@@ -142,7 +142,6 @@ async function writeFileContent(filePath, content) {
     }
 }
 async function applyFileEdits(filePath, edits, dryRun = false) {
-    var _a;
     // Read file content and normalize line endings
     const content = normalizeLineEndings(await promises_1.default.readFile(filePath, 'utf-8'));
     // Apply edits sequentially
@@ -168,14 +167,13 @@ async function applyFileEdits(filePath, edits, dryRun = false) {
             });
             if (isMatch) {
                 // Preserve original indentation of first line
-                const originalIndent = ((_a = contentLines[i].match(/^\s*/)) === null || _a === void 0 ? void 0 : _a[0]) || '';
+                const originalIndent = contentLines[i].match(/^\s*/)?.[0] || '';
                 const newLines = normalizedNew.split('\n').map((line, j) => {
-                    var _a, _b, _c;
                     if (j === 0)
                         return originalIndent + line.trimStart();
                     // For subsequent lines, try to preserve relative indentation
-                    const oldIndent = ((_b = (_a = oldLines[j]) === null || _a === void 0 ? void 0 : _a.match(/^\s*/)) === null || _b === void 0 ? void 0 : _b[0]) || '';
-                    const newIndent = ((_c = line.match(/^\s*/)) === null || _c === void 0 ? void 0 : _c[0]) || '';
+                    const oldIndent = oldLines[j]?.match(/^\s*/)?.[0] || '';
+                    const newIndent = line.match(/^\s*/)?.[0] || '';
                     if (oldIndent && newIndent) {
                         const relativeIndent = newIndent.length - oldIndent.length;
                         return originalIndent + ' '.repeat(Math.max(0, relativeIndent)) + line.trimStart();

package/lib/tools/ts-lsp/index.js

@@ -9,18 +9,19 @@ const getTsLspTools = (targetDir) => {
     return [
         (0, createTool_1.createTool)({
             name: 'get_method_body',
-            description: '【仅限TS/JS】通过方法名提取代码块。比行号读取更抗干扰，参考逻辑时首选。',
+            description: '[Only for TS/JS] Extract code blocks by method name. More resistant to interference than line number reading, preferred when referencing logic.',
             parameters: zod_1.z.object({
-                filePath: zod_1.z.string().describe('文件相对路径'),
-                methodName: zod_1.z.string().describe('方法名或函数名'),
+                filePath: zod_1.z.string().describe('The relative file path'),
+                methodName: zod_1.z.string().describe('The method name or function name'),
             }),
             handler: async ({ filePath, methodName }) => {
-                return engine.getMethodImplementation(filePath, methodName);
+                const res = engine.getMethodImplementation(filePath, methodName);
+                return typeof res === 'string' ? res : JSON.stringify(res);
             },
         }),
         (0, createTool_1.createTool)({
             name: 'get_repo_map',
-            description: '获取项目全局文件结构及导出清单，用于快速定位代码',
+            description: 'Get the global file structure and export list of the project, used for quick code location',
             parameters: zod_1.z.object({}),
             handler: async () => {
                 engine.refresh();
@@ -29,26 +30,26 @@ const getTsLspTools = (targetDir) => {
         }),
         (0, createTool_1.createTool)({
             name: 'analyze_deps',
-            description: '分析指定文件的依赖关系，支持 tsconfig 路径别名解析',
-            parameters: zod_1.z.object({ filePath: zod_1.z.string().describe('文件相对路径') }),
+            description: 'Analyze the dependencies of the specified file, support tsconfig path alias parsing',
+            parameters: zod_1.z.object({ filePath: zod_1.z.string().describe('The relative file path') }),
             handler: async ({ filePath }) => engine.getDeps(filePath),
         }),
         (0, createTool_1.createTool)({
             name: 'read_skeleton',
-            description: '提取文件的结构定义（接口、类、方法签名），忽略具体实现以节省 Token',
-            parameters: zod_1.z.object({ filePath: zod_1.z.string().describe('文件相对路径') }),
+            description: 'Extract the structure definition of the file (interface, class, method signature), ignoring the specific implementation to save tokens',
+            parameters: zod_1.z.object({ filePath: zod_1.z.string().describe('The relative file path') }),
             handler: async (args) => {
-                const pathArg = args === null || args === void 0 ? void 0 : args.filePath;
+                const pathArg = args?.filePath;
                 if (typeof pathArg !== 'string' || pathArg.trim() === '') {
-                    return `Error: 参数 'filePath' 无效。收到的是: ${JSON.stringify(pathArg)}`;
+                    return `Error: The parameter 'filePath' is invalid. Received: ${JSON.stringify(pathArg)}`;
                 }
                 try {
                     engine.refresh();
                     const result = engine.getSkeleton(pathArg);
-                    return result || `// Warning: 文件 ${pathArg} 存在但未找到任何可提取的结构。`;
+                    return result || `// Warning: The file ${pathArg} exists but no structure can be extracted.`;
                 }
                 catch (error) {
-                    return `Error: 解析文件 ${pathArg} 时发生内部错误: ${error.message}`;
+                    return `Error: An internal error occurred while parsing the file ${pathArg}: ${error.message}`;
                 }
             },
         }),

package/lib/utils/convertToLangChainTool.js

@@ -5,7 +5,7 @@ const tools_1 = require("@langchain/core/tools");
 function convertToLangChainTool(info) {
     return new tools_1.DynamicStructuredTool({
         name: info.function.name,
-        description: info.function.description || "",
+        description: info.function.description || '',
         schema: info.function.parameters,
         func: async (args) => {
             if (info._handler)
@@ -17,7 +17,7 @@ function convertToLangChainTool(info) {
                 });
                 return JSON.stringify(result);
             }
-            return "Error: No tool execution handler found.";
+            return 'Error: No tool execution handler found.';
         },
     });
 }

package/lib/utils/createTool.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTool = createTool;
 function createTool(options) {
     return {
-        type: "function",
+        type: 'function',
         function: {
             name: options.name,
             description: options.description,

package/lib/utils/formatSchema.js

@@ -11,13 +11,13 @@ function formatSchema(schema) {
         const requiredKeys = res.required || [];
         const lines = [];
         for (const key in res.properties) {
-            lines.push(`     - ${key}: ${res.properties[key].type}${requiredKeys.includes(key) ? " (required)" : ""}`);
+            lines.push(`     - ${key}: ${res.properties[key].type}${requiredKeys.includes(key) ? ' (required)' : ''}`);
         }
         if (lines.length > 0) {
-            return lines.join("\n");
+            return lines.join('\n');
         }
-        return "No parameters";
+        return 'No parameters';
     }
     const keys = Object.keys(schema.shape);
-    return keys.join(", ");
+    return keys.join(', ');
 }

package/lib/utils/generateToolMarkdown.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 将工具定义从 Zod Schema 转换为极简 Markdown 格式
+ * 目的：显著节省 System Prompt 的 Token，同时保持 LLM 理解力
+ */
+export declare function generateToolMarkdown(tools: any[]): string;

package/lib/utils/generateToolMarkdown.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateToolMarkdown = generateToolMarkdown;
+const cleanToolDefinition_1 = require("./cleanToolDefinition");
+const kit_1 = require("./kit");
+/**
+ * 将工具定义从 Zod Schema 转换为极简 Markdown 格式
+ * 目的：显著节省 System Prompt 的 Token，同时保持 LLM 理解力
+ */
+function generateToolMarkdown(tools) {
+    let markdown = "## Tool Definitions\n\n";
+    (0, kit_1.getArray)(tools).forEach((tool) => {
+        const { name, description, parameters } = (0, cleanToolDefinition_1.cleanToolDefinition)(tool);
+        markdown += `- **${name}**: ${description}\n`;
+        // 提取 Zod 参数
+        const shape = parameters.properties || {};
+        const requiredFields = parameters.required || [];
+        Object.entries(shape).forEach(([paramName, schema]) => {
+            const isRequired = requiredFields.includes(paramName);
+            const type = schema.type.replace('Zod', '').toLowerCase();
+            const desc = schema.description || schema.title || '';
+            markdown += `  - \`${paramName}\` (${type}${isRequired ? ', required' : ''})${desc ? `: ${desc}` : ''}\n`;
+        });
+        markdown += "\n";
+    });
+    return markdown;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saber2pr/ai-agent",
-  "version": "0.0.54",
+  "version": "0.0.55",
   "description": "AI Assistant CLI.",
   "author": "saber2pr",
   "license": "ISC",
@@ -9,7 +9,7 @@
   ],
   "bin": {
     "sagent": "./lib/cli.js",
-    "sagent-graph": "./lib/cli-graph.js"
+    "sagent-openai": "./lib/cli-openai.js"
   },
   "publishConfig": {
     "access": "public",
@@ -42,7 +42,7 @@
     "@langchain/core": "0.3.40"
   },
   "devDependencies": {
-    "@types/node": "^16.3.3",
+    "@types/node": "^25.2.3",
     "prettier": "^2.4.1"
   }
 }