code-gate 1.2.0 → 1.3.0

package/README.md

@@ -6,7 +6,9 @@
 
 # Code Gate
 
-![Node Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=for-the-badge)](https://nodejs.org/)
+[![GitHub release](https://img.shields.io/github/v/release/Gil2015/code-gate?style=for-the-badge)](https://github.com/Gil2015/code-gate/releases/latest)
+[![License](https://img.shields.io/github/license/Gil2015/code-gate?style=for-the-badge)](LICENSE)
 
 **Your Lightweight Local AI Code Review Assistant**
 
@@ -20,8 +22,9 @@ Supports zero-config execution via npx, npm/yarn/pnpm package integration, and a
 
 ## ✨ Features
 
-- **🔒 Privacy First**: Native support for Ollama local models. 
+- **🔒 Privacy First**: Native support for Ollama local models.
 - **☁️ Multi-Model Support**: Seamlessly integrates with DeepSeek, OpenAI, Anthropic, Aliyun Qwen, Doubao, and more.
+- **🤖 Agent Mode**: AI can actively retrieve code context (file contents, search definitions, browse directories) for deeper and more accurate reviews. Supports DeepSeek and Zhipu.
 - **🌍 Multi-Language**: Built-in support for English, Chinese (Simplified & Traditional), Japanese, Korean, German, and French.
 - **⚡️ High Performance**: Intelligent concurrent processing for faster reviews across multiple files.
 - **🛠️ Highly Customizable**: Custom prompts, file filtering rules, and review strategies.
@@ -88,6 +91,12 @@ Provide feedback prioritized by:
 Provide specific examples on how to fix the issues.`,
   output: {
     dir: '.review-logs'
+  },
+  // Agent Mode (Optional) - Enables AI to actively retrieve code context
+  agent: {
+    enabled: false,      // Set to true to enable Agent mode (supports DeepSeek and Zhipu)
+    maxIterations: 5,    // Max iteration rounds
+    maxToolCalls: 10     // Max tool calls per review
   }
 }
 ```
@@ -200,6 +209,9 @@ git commit -m "feat: new feature"
 | `language` | `string` | `'en'` | UI & Prompt Language. Options: `'en'`, `'zh-CN'`, `'zh-TW'`, `'ja'`, `'ko'`, `'de'`, `'fr'` |
 | `prompt` | `string` | `...` | Universal system prompt sent to AI |
 | `output.dir` | `string` | `'.review-logs'` | Output directory for local reports and static assets |
+| `agent.enabled` | `boolean` | `false` | Enable Agent mode for deeper context-aware reviews (DeepSeek & Zhipu only) |
+| `agent.maxIterations` | `number` | `5` | Max iteration rounds for Agent to gather context |
+| `agent.maxToolCalls` | `number` | `10` | Max tool calls allowed per review session |
 
 ### providerOptions Configuration
 
@@ -276,6 +288,97 @@ export DEEPSEEK_API_KEY=[your-deepseek-api-key]
 
 ---
 
+## 🤖 Agent Mode
+
+Agent mode enables AI to actively retrieve code context during reviews, resulting in more accurate and comprehensive feedback. Instead of only seeing the diff, the AI can:
+
+- **Read complete files** to understand the full context of changes
+- **Search for definitions** to understand types, interfaces, and function implementations
+- **Find references** to assess the impact of changes
+- **Browse directory structure** to understand project organization
+
+### Enabling Agent Mode
+
+Add the `agent` configuration to your `.codegate.js`:
+
+```javascript
+export default {
+  provider: 'deepseek',  // or 'zhipu'
+  providerOptions: {
+    deepseek: {
+      apiKeyEnv: 'DEEPSEEK_API_KEY',
+      model: 'deepseek-chat'
+    }
+  },
+  agent: {
+    enabled: true,       // Enable Agent mode
+    maxIterations: 5,    // Max rounds of context gathering
+    maxToolCalls: 10     // Max tool invocations
+  }
+}
+```
+
+### Supported Providers
+
+Currently, Agent mode is supported by:
+- **DeepSeek** (`deepseek-chat` and other models with function calling)
+- **Zhipu** (`glm-4` and other models with function calling)
+
+
+### Agent Mode Prompt Example
+
+When using Agent mode, you can optimize your prompt to leverage the AI's ability to retrieve context. Here's a recommended prompt for Agent mode:
+
+```javascript
+export default {
+  provider: 'deepseek',
+  agent: {
+    enabled: true,
+    maxIterations: 5,
+    maxToolCalls: 10
+  },
+  prompt: `You are a senior code reviewer with access to the full codebase context.
+
+Project Info:
+- [Fill in your project info: architecture, standards, business type, etc.]
+
+Review Strategy:
+1. First analyze the diff to understand the scope and intent of changes
+2. When encountering unfamiliar types, interfaces, or functions, use tools to look up their definitions
+3. For significant logic changes, check how they affect other parts of the codebase
+4. Verify that changes follow existing patterns in the project
+
+Key Review Points:
+- Logic correctness and edge case handling
+- Type safety and null checks
+- Error handling completeness
+- Performance implications
+- Security considerations
+- Consistency with existing codebase patterns
+
+When using tools:
+- Use read_file to view complete file context when needed
+- Use search_content to find type definitions, function implementations, or usage patterns
+- Use list_directory to understand module structure when reviewing architectural changes
+
+Output Format:
+## Summary
+Brief description of the changes
+
+## Issues Found
+- 🔴 Critical: Must fix before merge
+- 🟡 Warning: Should address
+- 🔵 Suggestion: Consider improving
+
+## Overall Assessment
+Final recommendation on whether to merge`
+}
+```
+
+> **Note**: Agent mode increases API token usage due to multi-turn conversations and tool results. Consider this when reviewing large changes.
+
+---
+
 ## ❓ FAQ
 
 **Q: Report shows diffs but no AI suggestions?**

package/README_ZH.md

@@ -6,7 +6,9 @@
 
 # Code Gate
 
-![Node Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=for-the-badge)](https://nodejs.org/)
+[![GitHub release](https://img.shields.io/github/v/release/Gil2015/code-gate?style=for-the-badge)](https://github.com/Gil2015/code-gate/releases/latest)
+[![License](https://img.shields.io/github/license/Gil2015/code-gate?style=for-the-badge)](LICENSE)
 
 **您的轻量级本地 AI 代码审查助手**
 
@@ -22,6 +24,7 @@ Code Gate 是一款无缝集成到 Git 工作流中的智能代码AI审查工具
 
 - **🔒 数据隐私优先**：原生支持 Ollama 本地模型。
 - **☁️ 多模型支持**：无缝对接 DeepSeek, OpenAI, Anthropic, 阿里云 Qwen, 豆包等主流 AI 服务。
+- **🤖 Agent 模式**：AI 可主动获取代码上下文（读取文件、搜索定义、浏览目录），实现更深入准确的代码审查。支持 DeepSeek 和智谱。
 - **🌍 多语言界面**：内置中（简/繁）、英、日、韩、德、法等多语言支持。
 - **⚡️ 高效并发**：智能并发处理多文件审查，提升 Review 速度。
 - **🛠️ 高度可定制**：支持自定义 Prompt、文件过滤规则及审查策略。
@@ -87,6 +90,12 @@ export default {
 提供具体的示例说明如何修复问题。`,
   output: {
     dir: '.review-logs'
+  },
+  // Agent 模式（可选）- 启用后 AI 可主动获取代码上下文
+  agent: {
+    enabled: false,      // 设为 true 启用 Agent 模式（仅支持 DeepSeek 和智谱）
+    maxIterations: 5,    // 最大迭代轮数
+    maxToolCalls: 10     // 每次审查最大工具调用次数
   }
 }
 ```
@@ -207,6 +216,9 @@ git commit -m "feat: new feature"
 | `language` | `string` | `'en'` | 界面与 Prompt 语言。可选值：`'en'`, `'zh-CN'`, `'zh-TW'`, `'ja'`, `'ko'`, `'de'`, `'fr'` |
 | `prompt` | `string` | `...` | 发送给 AI 的通用系统提示词 |
 | `output.dir` | `string` | `'.review-logs'` | 本地生成报告和静态资源的输出目录 |
+| `agent.enabled` | `boolean` | `false` | 启用 Agent 模式，获取更深入的上下文感知审查（仅支持 DeepSeek 和智谱） |
+| `agent.maxIterations` | `number` | `5` | Agent 获取上下文的最大迭代轮数 |
+| `agent.maxToolCalls` | `number` | `10` | 每次审查允许的最大工具调用次数 |
 
 ### providerOptions 配置
 每个 Provider 可配置以下字段，支持 `request` 选项控制请求超时与重试。
@@ -281,6 +293,96 @@ export DEEPSEEK_API_KEY=[your-deepseek-api-key]
 
 ---
 
+## 🤖 Agent 模式
+
+Agent 模式允许 AI 在审查过程中主动获取代码上下文，从而提供更准确、更全面的反馈。与仅查看 diff 不同，AI 可以：
+
+- **读取完整文件**：了解变更的完整上下文
+- **搜索定义**：理解类型、接口和函数实现
+- **查找引用**：评估变更的影响范围
+- **浏览目录结构**：了解项目组织方式
+
+### 启用 Agent 模式
+
+在 `.codegate.js` 中添加 `agent` 配置：
+
+```javascript
+export default {
+  provider: 'deepseek',  // 或 'zhipu'
+  providerOptions: {
+    deepseek: {
+      apiKeyEnv: 'DEEPSEEK_API_KEY',
+      model: 'deepseek-chat'
+    }
+  },
+  agent: {
+    enabled: true,       // 启用 Agent 模式
+    maxIterations: 5,    // 最大上下文获取轮数
+    maxToolCalls: 10     // 最大工具调用次数
+  }
+}
+```
+
+### 支持的 Provider
+
+目前 Agent 模式支持以下 Provider：
+- **DeepSeek**（`deepseek-chat` 及其他支持函数调用的模型）
+- **智谱**（`glm-4` 及其他支持函数调用的模型）
+
+### Agent 模式提示词示例
+
+使用 Agent 模式时，可以优化提示词以充分利用 AI 获取上下文的能力。以下是推荐的 Agent 模式提示词：
+
+```javascript
+export default {
+  provider: 'deepseek',
+  agent: {
+    enabled: true,
+    maxIterations: 5,
+    maxToolCalls: 10
+  },
+  prompt: `你是一位高级代码审查员，可以访问完整的代码库上下文。
+
+项目信息：
+- [填入你项目相关信息：架构、规范、业务类型等]
+
+审查策略：
+1. 首先分析 diff，理解变更的范围和意图
+2. 遇到不熟悉的类型、接口或函数时，使用工具查找其定义
+3. 对于重要的逻辑变更，检查它们对代码库其他部分的影响
+4. 验证变更是否遵循项目中现有的模式
+
+重点审查项：
+- 逻辑正确性和边界情况处理
+- 类型安全和空值检查
+- 错误处理的完整性
+- 性能影响
+- 安全性考虑
+- 与现有代码风格的一致性
+
+工具使用建议：
+- 使用 read_file 查看需要的完整文件上下文
+- 使用 search_content 查找类型定义、函数实现或使用模式
+- 使用 list_directory 在审查架构变更时了解模块结构
+
+输出格式：
+## 变更概述
+简要描述本次变更
+
+## 发现的问题
+- 🔴 严重问题：合并前必须修复
+- 🟡 警告：建议处理
+- 🔵 建议：可以考虑改进
+
+## 总体评价
+是否建议合并的最终建议`
+}
+```
+
+> **注意**：Agent 模式会因多轮对话和工具结果而增加 API Token 消耗。审查大型变更时请注意这一点。
+
+---
+
 ## ❓ 常见问题
 
 **Q: 页面显示 Diff 但没有 AI 建议？**

package/dist/agent/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent 模块入口
+ */
+export { createOrchestrator } from './orchestrator.js';
+export { toolDefinitions, executeTool, executeTools } from './tools/index.js';
+export { buildAgentSystemPrompt, buildAgentUserPrompt } from './prompts/system.js';
+export type { AgentMessage, AgentReviewInput, AgentReviewOptions, OrchestratorState, AgentProvider, LLMCallFunction, AgentOrchestrator } from './types.js';
+export type { ToolDefinition, ToolCall, ToolResult, ReadFileParams, ReadFileResult, SearchContentParams, SearchContentResult, ListDirectoryParams, ListDirectoryResult } from './tools/types.js';

package/dist/agent/index.js

@@ -0,0 +1,10 @@
+/**
+ * Agent 模块入口
+ */
+// 导出编排器
+export { createOrchestrator } from './orchestrator.js';
+// 导出工具
+export { toolDefinitions, executeTool, executeTools } from './tools/index.js';
+// 导出 prompts
+export { buildAgentSystemPrompt, buildAgentUserPrompt } from './prompts/system.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO;AACP,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7E,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/agent/orchestrator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent 编排器
+ * 实现 Agent 循环逻辑，协调 LLM 调用和工具执行
+ */
+import type { Config } from '../config/types.js';
+import type { LLMCallFunction, AgentOrchestrator } from './types.js';
+/**
+ * 创建 Agent 编排器
+ * @param config 配置
+ * @param llmCall LLM 调用函数
+ */
+export declare function createOrchestrator(_config: Config, llmCall: LLMCallFunction): AgentOrchestrator;
+export type { AgentOrchestrator } from './types.js';

package/dist/agent/orchestrator.js

@@ -0,0 +1,109 @@
+/**
+ * Agent 编排器
+ * 实现 Agent 循环逻辑，协调 LLM 调用和工具执行
+ */
+import { toolDefinitions, executeTools } from './tools/index.js';
+import { buildAgentSystemPrompt, buildAgentUserPrompt } from './prompts/system.js';
+/**
+ * 创建 Agent 编排器
+ * @param config 配置
+ * @param llmCall LLM 调用函数
+ */
+export function createOrchestrator(_config, llmCall) {
+    /**
+     * 运行 Agent 循环
+     */
+    async function run(input, options) {
+        const { maxIterations, maxToolCalls, onToolCall, onIteration } = options;
+        // 初始化状态
+        const state = {
+            messages: [
+                {
+                    role: 'system',
+                    content: buildAgentSystemPrompt(input.prompt)
+                },
+                {
+                    role: 'user',
+                    content: buildAgentUserPrompt(input.diff, input.files)
+                }
+            ],
+            iteration: 0,
+            totalToolCalls: 0,
+            done: false
+        };
+        // Agent 循环
+        while (!state.done && state.iteration < maxIterations) {
+            state.iteration++;
+            // 调用 LLM
+            const response = await llmCall(state.messages, toolDefinitions);
+            // 没有工具调用，说明 LLM 已经完成审查，返回最终结果
+            if (!response.toolCalls || response.toolCalls.length === 0) {
+                state.done = true;
+                return response.content || '';
+            }
+            // 检查工具调用数限制
+            const callsThisIteration = response.toolCalls.length;
+            if (state.totalToolCalls + callsThisIteration > maxToolCalls) {
+                // 超过限制，强制请求最终结果
+                state.done = true;
+                return await requestFinalResult(state, response.content, llmCall);
+            }
+            // 触发回调
+            onIteration?.(state.iteration, callsThisIteration);
+            response.toolCalls.forEach(call => onToolCall?.(call));
+            // 执行工具调用
+            const results = await executeTools(response.toolCalls);
+            state.totalToolCalls += callsThisIteration;
+            // 添加 assistant 消息（包含工具调用）
+            const assistantMessage = {
+                role: 'assistant',
+                content: response.content,
+                tool_calls: response.toolCalls
+            };
+            // DeepSeek Reasoner 模型需要保留 reasoning_content
+            if (response.reasoning_content) {
+                assistantMessage.reasoning_content = response.reasoning_content;
+            }
+            state.messages.push(assistantMessage);
+            // 添加工具结果消息
+            for (const result of results) {
+                state.messages.push({
+                    role: 'tool',
+                    tool_call_id: result.id,
+                    name: result.name,
+                    content: result.error
+                        ? JSON.stringify({ error: result.error })
+                        : JSON.stringify(result.result)
+                });
+            }
+        }
+        // 达到最大迭代次数，强制请求最终结果
+        if (!state.done) {
+            return await requestFinalResult(state, null, llmCall);
+        }
+        return '';
+    }
+    return { run };
+}
+/**
+ * 请求 LLM 输出最终结果
+ */
+async function requestFinalResult(state, lastContent, llmCall) {
+    // 如果上一次响应有内容，先添加到消息历史
+    if (lastContent) {
+        state.messages.push({
+            role: 'assistant',
+            content: lastContent
+        });
+    }
+    // 添加请求最终结果的消息
+    state.messages.push({
+        role: 'user',
+        content: '已达到工具调用次数上限或迭代次数上限。请根据已获取的信息，输出最终的代码审查报告。'
+    });
+    // 调用 LLM，不提供工具（强制输出文本）
+    const emptyTools = [];
+    const finalResponse = await llmCall(state.messages, emptyTools);
+    return finalResponse.content || '';
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agent/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/agent/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/agent/prompts/system.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Agent System Prompt 构建
+ */
+/**
+ * 构建 Agent 专用的 System Prompt
+ * @param basePrompt 基础审查 prompt
+ */
+export declare function buildAgentSystemPrompt(basePrompt: string): string;
+/**
+ * 构建用户消息
+ * @param diff diff 内容
+ * @param files 变更的文件列表
+ */
+export declare function buildAgentUserPrompt(diff: string, files: string[]): string;

package/dist/agent/prompts/system.js

@@ -0,0 +1,108 @@
+/**
+ * Agent System Prompt 构建
+ */
+/**
+ * 构建 Agent 专用的 System Prompt
+ * @param basePrompt 基础审查 prompt
+ */
+export function buildAgentSystemPrompt(basePrompt) {
+    return `${basePrompt}
+
+## 工具使用指南
+
+你可以使用以下工具来获取代码上下文，以便更准确地进行代码审查：
+
+### read_file
+读取文件完整内容。适用场景：
+- 查看被修改文件的完整代码，了解上下文
+- 查看类型定义文件（如 .d.ts, types.ts）
+- 查看相关的配置文件
+- 查看被调用的函数/方法的实现
+
+参数：
+- path: 文件路径（相对于项目根目录）
+- startLine: 起始行号（可选，用于分页读取大文件）
+- maxLines: 最大读取行数（可选，默认 200）
+
+### search_content
+在项目中搜索内容，支持正则表达式。适用场景：
+- 查找某个函数、类、接口的定义位置
+- 查找某个方法或变量的使用位置
+- 搜索特定的代码模式或关键字
+- 查找相关的测试文件
+
+参数：
+- pattern: 搜索模式（支持正则表达式）
+- path: 搜索范围（可选，默认整个项目）
+- offset/limit: 分页参数
+
+### list_directory
+列出目录结构。适用场景：
+- 了解项目的模块划分和目录结构
+- 查找相关文件的位置
+- 了解某个功能模块包含哪些文件
+
+参数：
+- path: 目录路径
+- depth: 递归深度（可选，默认 1）
+- offset/limit: 分页参数
+
+## 审查流程建议
+
+1. **初步分析**：首先阅读 diff，识别变更的类型、范围和关键点
+2. **获取上下文**：如果需要更多信息来理解代码，使用工具获取：
+   - 不确定某个类型的定义？使用 search_content 查找，然后 read_file 查看
+   - 不了解被调用函数的行为？使用 read_file 查看其实现
+   - 不确定变更影响范围？使用 search_content 查找引用位置
+3. **深入审查**：基于完整信息进行审查，关注：
+   - 代码逻辑是否正确
+   - 是否有潜在的 bug 或边界情况
+   - 代码风格是否符合项目规范
+   - 是否有性能或安全问题
+4. **输出报告**：完成审查后，输出结构化的审查报告
+
+## 输出格式要求
+
+最终的审查报告应包含以下部分（根据实际情况选择性输出）：
+
+### 变更概述
+简要描述本次变更的目的和范围
+
+### 发现的问题
+列出发现的问题，按严重程度分类：
+- 🔴 严重问题：必须修复的 bug 或安全漏洞
+- 🟡 建议改进：可以优化的地方
+- 🔵 代码风格：格式或命名建议
+
+### 代码亮点
+如果代码有做得好的地方，也可以指出
+
+### 总体评价
+给出总体评价和是否建议合并
+
+## 注意事项
+
+- 只在确实需要更多上下文时才使用工具，避免不必要的调用
+- 如果工具返回 hasMore: true，可以使用 offset 参数获取更多结果
+- 审查时要结合项目的实际情况，避免教条主义
+- 如果不确定某个写法是否有问题，应该先查看项目中的其他代码作为参考`;
+}
+/**
+ * 构建用户消息
+ * @param diff diff 内容
+ * @param files 变更的文件列表
+ */
+export function buildAgentUserPrompt(diff, files) {
+    return `## 变更的文件
+${files.map(f => `- ${f}`).join('\n')}
+
+## Diff 内容
+\`\`\`diff
+${diff}
+\`\`\`
+
+请审查以上代码变更。如果需要了解更多上下文（如完整文件内容、类型定义、引用位置等），请使用提供的工具获取信息。
+
+审查完成后，请输出最终的代码审查报告。`;
+}
+//# sourceMappingURL=system.js.map

package/dist/agent/prompts/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/agent/prompts/system.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,GAAG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA+Ea,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAe;IAChE,OAAO;EACP,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;EAInC,IAAI;;;;;oBAKc,CAAA;AACpB,CAAC"}

package/dist/agent/tools/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 工具注册入口
+ * 统一管理所有 Agent 工具的定义和执行
+ */
+import type { ToolDefinition, ToolCall, ToolResult } from './types.js';
+export declare const toolDefinitions: ToolDefinition[];
+/**
+ * 执行单个工具调用
+ */
+export declare function executeTool(call: ToolCall): Promise<ToolResult>;
+/**
+ * 并行执行多个工具调用
+ */
+export declare function executeTools(calls: ToolCall[]): Promise<ToolResult[]>;
+export type { ToolDefinition, ToolCall, ToolResult } from './types.js';

package/dist/agent/tools/index.js

@@ -0,0 +1,57 @@
+/**
+ * 工具注册入口
+ * 统一管理所有 Agent 工具的定义和执行
+ */
+import { readFileTool, executeReadFile } from './read-file.js';
+import { searchContentTool, executeSearchContent } from './search-content.js';
+import { listDirectoryTool, executeListDirectory } from './list-directory.js';
+// ============ 工具定义列表 ============
+export const toolDefinitions = [
+    readFileTool,
+    searchContentTool,
+    listDirectoryTool
+];
+const executors = {
+    read_file: executeReadFile,
+    search_content: executeSearchContent,
+    list_directory: executeListDirectory
+};
+// ============ 工具执行函数 ============
+/**
+ * 执行单个工具调用
+ */
+export async function executeTool(call) {
+    const executor = executors[call.name];
+    if (!executor) {
+        return {
+            id: call.id,
+            name: call.name,
+            result: null,
+            error: `Unknown tool: ${call.name}`
+        };
+    }
+    try {
+        const result = await executor(call.arguments);
+        return {
+            id: call.id,
+            name: call.name,
+            result
+        };
+    }
+    catch (e) {
+        const error = e instanceof Error ? e.message : String(e);
+        return {
+            id: call.id,
+            name: call.name,
+            result: null,
+            error
+        };
+    }
+}
+/**
+ * 并行执行多个工具调用
+ */
+export async function executeTools(calls) {
+    return Promise.all(calls.map(executeTool));
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE7E,mCAAmC;AAEnC,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;CAClB,CAAA;AAOD,MAAM,SAAS,GAAmC;IAChD,SAAS,EAAE,eAAe;IAC1B,cAAc,EAAE,oBAAoB;IACpC,cAAc,EAAE,oBAAoB;CACrC,CAAA;AAED,mCAAmC;AAEnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE;SACpC,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7C,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;SACP,CAAA;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACxD,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,KAAK;SACN,CAAA;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAiB;IAClD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAA;AAC5C,CAAC"}

package/dist/agent/tools/list-directory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * list_directory 工具实现
+ * 列出目录内容，支持递归和分页
+ */
+import type { ToolDefinition, ListDirectoryParams, ListDirectoryResult } from './types.js';
+/**
+ * 工具定义
+ */
+export declare const listDirectoryTool: ToolDefinition;
+/**
+ * 执行 list_directory 工具
+ */
+export declare function executeListDirectory(params: ListDirectoryParams): Promise<ListDirectoryResult>;