code-gate 1.1.3 → 1.3.0

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>;

package/dist/agent/tools/list-directory.js

@@ -0,0 +1,162 @@
+/**
+ * list_directory 工具实现
+ * 列出目录内容，支持递归和分页
+ */
+import fs from 'node:fs';
+import nodePath from 'node:path';
+import { getGitRoot } from '../../core/git.js';
+// 默认值
+const DEFAULT_DEPTH = 1;
+const DEFAULT_OFFSET = 0;
+const DEFAULT_LIMIT = 50;
+// 排除的目录/文件
+const EXCLUDED_NAMES = [
+    'node_modules',
+    '.git',
+    '.idea',
+    '.vscode',
+    'dist',
+    'build',
+    'coverage',
+    '__pycache__',
+    '.DS_Store',
+    'Thumbs.db'
+];
+/**
+ * 工具定义
+ */
+export const listDirectoryTool = {
+    type: 'function',
+    function: {
+        name: 'list_directory',
+        description: '列出目录内容，了解项目结构。可以递归列出子目录。',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: '目录路径（相对于项目根目录）'
+                },
+                depth: {
+                    type: 'number',
+                    description: `递归深度，默认 ${DEFAULT_DEPTH}（只列出直接子项）`
+                },
+                offset: {
+                    type: 'number',
+                    description: `跳过前 N 条结果，默认 ${DEFAULT_OFFSET}`
+                },
+                limit: {
+                    type: 'number',
+                    description: `返回最大条数，默认 ${DEFAULT_LIMIT}`
+                }
+            },
+            required: ['path']
+        }
+    }
+};
+/**
+ * 判断是否应该排除
+ */
+function shouldExclude(name) {
+    // 排除隐藏文件（以 . 开头，但不包括 . 和 ..）
+    if (name.startsWith('.') && name !== '.' && name !== '..') {
+        // 允许一些常见的配置文件
+        const allowedDotFiles = ['.codegate.js', '.codegate.ts', '.codegate.json', '.eslintrc.js', '.prettierrc'];
+        if (!allowedDotFiles.some(f => name.startsWith(f.split('.')[1]))) {
+            return true;
+        }
+    }
+    return EXCLUDED_NAMES.includes(name);
+}
+/**
+ * 递归收集目录内容
+ */
+function collectEntries(dirPath, basePath, maxDepth, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return [];
+    }
+    const entries = [];
+    try {
+        const items = fs.readdirSync(dirPath);
+        for (const item of items) {
+            // 跳过排除的文件/目录
+            if (shouldExclude(item)) {
+                continue;
+            }
+            const fullPath = nodePath.join(dirPath, item);
+            const relativePath = nodePath.relative(basePath, fullPath);
+            try {
+                const stats = fs.statSync(fullPath);
+                if (stats.isDirectory()) {
+                    entries.push({
+                        name: relativePath,
+                        type: 'dir'
+                    });
+                    // 递归子目录
+                    if (currentDepth + 1 < maxDepth) {
+                        const subEntries = collectEntries(fullPath, basePath, maxDepth, currentDepth + 1);
+                        entries.push(...subEntries);
+                    }
+                }
+                else if (stats.isFile()) {
+                    entries.push({
+                        name: relativePath,
+                        type: 'file',
+                        size: stats.size
+                    });
+                }
+            }
+            catch {
+                // 忽略无法访问的文件
+            }
+        }
+    }
+    catch {
+        // 忽略无法访问的目录
+    }
+    return entries;
+}
+/**
+ * 执行 list_directory 工具
+ */
+export async function executeListDirectory(params) {
+    const { path: dirPath, depth = DEFAULT_DEPTH, offset = DEFAULT_OFFSET, limit = DEFAULT_LIMIT } = params;
+    // 获取项目根目录
+    const root = getGitRoot();
+    if (!root) {
+        throw new Error('Not in a git repository');
+    }
+    // 解析目录路径
+    const absolutePath = nodePath.resolve(root, dirPath);
+    // 安全检查：路径必须在项目根目录内
+    if (!absolutePath.startsWith(root)) {
+        throw new Error('Access denied: path outside project root');
+    }
+    // 检查目录存在
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`Directory not found: ${dirPath}`);
+    }
+    // 检查是否为目录
+    const stats = fs.statSync(absolutePath);
+    if (!stats.isDirectory()) {
+        throw new Error(`Not a directory: ${dirPath}`);
+    }
+    // 收集所有条目
+    const allEntries = collectEntries(absolutePath, absolutePath, depth);
+    const total = allEntries.length;
+    // 排序：目录在前，文件在后；同类型按名称排序
+    allEntries.sort((a, b) => {
+        if (a.type !== b.type) {
+            return a.type === 'dir' ? -1 : 1;
+        }
+        return a.name.localeCompare(b.name);
+    });
+    // 分页
+    const pagedEntries = allEntries.slice(offset, offset + limit);
+    return {
+        entries: pagedEntries,
+        total,
+        hasMore: offset + limit < total
+    };
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/agent/tools/list-directory.js.map

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

package/dist/agent/tools/read-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * read_file 工具实现
+ * 读取文件内容，支持分页
+ */
+import type { ToolDefinition, ReadFileParams, ReadFileResult } from './types.js';
+/**
+ * 工具定义
+ */
+export declare const readFileTool: ToolDefinition;
+/**
+ * 执行 read_file 工具
+ */
+export declare function executeReadFile(params: ReadFileParams): Promise<ReadFileResult>;

package/dist/agent/tools/read-file.js

@@ -0,0 +1,106 @@
+/**
+ * read_file 工具实现
+ * 读取文件内容，支持分页
+ */
+import fs from 'node:fs';
+import nodePath from 'node:path';
+import { getGitRoot } from '../../core/git.js';
+// 安全配置
+const MAX_FILE_SIZE = 100 * 1024; // 100KB
+const BLOCKED_PATTERNS = ['.env', '.git/objects', 'node_modules'];
+// 默认值
+const DEFAULT_START_LINE = 1;
+const DEFAULT_MAX_LINES = 200;
+/**
+ * 工具定义
+ */
+export const readFileTool = {
+    type: 'function',
+    function: {
+        name: 'read_file',
+        description: '读取文件内容，支持分页。用于查看完整的源代码文件、类型定义、配置文件等。',
+        parameters: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: '文件路径（相对于项目根目录）'
+                },
+                startLine: {
+                    type: 'number',
+                    description: `起始行号（从 1 开始），默认 ${DEFAULT_START_LINE}`
+                },
+                maxLines: {
+                    type: 'number',
+                    description: `最大读取行数，默认 ${DEFAULT_MAX_LINES}`
+                }
+            },
+            required: ['path']
+        }
+    }
+};
+/**
+ * 检查路径是否安全
+ */
+function isPathSafe(filePath, root, absolutePath) {
+    // 检查路径遍历
+    if (!absolutePath.startsWith(root)) {
+        return { safe: false, error: 'Access denied: path outside project root' };
+    }
+    // 检查敏感文件
+    for (const pattern of BLOCKED_PATTERNS) {
+        if (filePath.includes(pattern)) {
+            return { safe: false, error: `Access denied: ${pattern} files are blocked` };
+        }
+    }
+    return { safe: true };
+}
+/**
+ * 执行 read_file 工具
+ */
+export async function executeReadFile(params) {
+    const { path: filePath, startLine = DEFAULT_START_LINE, maxLines = DEFAULT_MAX_LINES } = params;
+    // 获取项目根目录
+    const root = getGitRoot();
+    if (!root) {
+        throw new Error('Not in a git repository');
+    }
+    // 解析绝对路径
+    const absolutePath = nodePath.resolve(root, filePath);
+    // 安全检查
+    const safeCheck = isPathSafe(filePath, root, absolutePath);
+    if (!safeCheck.safe) {
+        throw new Error(safeCheck.error);
+    }
+    // 检查文件存在
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    // 检查是否为文件
+    const stats = fs.statSync(absolutePath);
+    if (!stats.isFile()) {
+        throw new Error(`Not a file: ${filePath}`);
+    }
+    // 检查文件大小
+    if (stats.size > MAX_FILE_SIZE) {
+        throw new Error(`File too large: ${stats.size} bytes (max ${MAX_FILE_SIZE})`);
+    }
+    // 读取文件
+    const content = fs.readFileSync(absolutePath, 'utf8');
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    // 计算分页范围
+    const start = Math.max(1, startLine);
+    const end = Math.min(totalLines, start + maxLines - 1);
+    // 提取指定范围的行
+    const selectedLines = lines.slice(start - 1, end);
+    return {
+        content: selectedLines.join('\n'),
+        startLine: start,
+        endLine: end,
+        totalLines,
+        total: totalLines,
+        hasMore: end < totalLines
+    };
+}
+//# sourceMappingURL=read-file.js.map

package/dist/agent/tools/read-file.js.map

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

package/dist/agent/tools/search-content.d.ts

@@ -0,0 +1,13 @@
+/**
+ * search_content 工具实现
+ * 在项目中搜索文件内容，支持分页
+ */
+import type { ToolDefinition, SearchContentParams, SearchContentResult } from './types.js';
+/**
+ * 工具定义
+ */
+export declare const searchContentTool: ToolDefinition;
+/**
+ * 执行 search_content 工具
+ */
+export declare function executeSearchContent(params: SearchContentParams): Promise<SearchContentResult>;

package/dist/agent/tools/search-content.js

@@ -0,0 +1,110 @@
+/**
+ * search_content 工具实现
+ * 在项目中搜索文件内容，支持分页
+ */
+import { spawnSync } from 'node:child_process';
+import nodePath from 'node:path';
+import { getGitRoot } from '../../core/git.js';
+// 默认值
+const DEFAULT_OFFSET = 0;
+const DEFAULT_LIMIT = 20;
+const MAX_CONTENT_LENGTH = 200; // 单行内容最大长度
+/**
+ * 工具定义
+ */
+export const searchContentTool = {
+    type: 'function',
+    function: {
+        name: 'search_content',
+        description: '在项目中搜索文件内容，支持正则表达式。用于查找函数定义、方法调用、类定义等。',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: '搜索模式（支持正则表达式）'
+                },
+                path: {
+                    type: 'string',
+                    description: '搜索路径（相对于项目根目录），默认为项目根目录'
+                },
+                offset: {
+                    type: 'number',
+                    description: `跳过前 N 条结果，默认 ${DEFAULT_OFFSET}`
+                },
+                limit: {
+                    type: 'number',
+                    description: `返回最大条数，默认 ${DEFAULT_LIMIT}`
+                }
+            },
+            required: ['pattern']
+        }
+    }
+};
+/**
+ * 解析 git grep 输出行
+ */
+function parseGrepLine(line) {
+    // 格式: file:line:content
+    const match = line.match(/^(.+?):(\d+):(.*)$/);
+    if (match) {
+        return {
+            file: match[1],
+            line: parseInt(match[2], 10),
+            content: match[3].substring(0, MAX_CONTENT_LENGTH)
+        };
+    }
+    return null;
+}
+/**
+ * 执行 search_content 工具
+ */
+export async function executeSearchContent(params) {
+    const { pattern, path: searchPath = '.', offset = DEFAULT_OFFSET, limit = DEFAULT_LIMIT } = params;
+    // 获取项目根目录
+    const root = getGitRoot();
+    if (!root) {
+        throw new Error('Not in a git repository');
+    }
+    // 解析搜索路径
+    const absolutePath = nodePath.resolve(root, searchPath);
+    // 安全检查：路径必须在项目根目录内
+    if (!absolutePath.startsWith(root)) {
+        throw new Error('Access denied: path outside project root');
+    }
+    // 使用 git grep 进行搜索
+    // 优点：自动排除 .gitignore 中的文件，速度快
+    const result = spawnSync('git', [
+        'grep',
+        '-n', // 显示行号
+        '-I', // 忽略二进制文件
+        '--no-color', // 不使用颜色
+        '-E', // 使用扩展正则表达式
+        pattern,
+        '--',
+        searchPath
+    ], {
+        cwd: root,
+        encoding: 'utf8',
+        maxBuffer: 10 * 1024 * 1024 // 10MB
+    });
+    // 解析结果
+    const lines = (result.stdout || '').split('\n').filter(Boolean);
+    const total = lines.length;
+    // 分页
+    const pagedLines = lines.slice(offset, offset + limit);
+    // 解析每一行
+    const matches = [];
+    for (const line of pagedLines) {
+        const match = parseGrepLine(line);
+        if (match) {
+            matches.push(match);
+        }
+    }
+    return {
+        matches,
+        total,
+        hasMore: offset + limit < total
+    };
+}
+//# sourceMappingURL=search-content.js.map

package/dist/agent/tools/search-content.js.map

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

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

@@ -0,0 +1,71 @@
+/**
+ * Agent 工具类型定义
+ */
+export interface PaginationParams {
+    offset?: number;
+    limit?: number;
+}
+export interface PaginationResult {
+    total: number;
+    hasMore: boolean;
+}
+export interface ReadFileParams {
+    path: string;
+    startLine?: number;
+    maxLines?: number;
+}
+export interface ReadFileResult extends PaginationResult {
+    content: string;
+    startLine: number;
+    endLine: number;
+    totalLines: number;
+}
+export interface SearchContentParams extends PaginationParams {
+    pattern: string;
+    path?: string;
+}
+export interface SearchMatch {
+    file: string;
+    line: number;
+    content: string;
+}
+export interface SearchContentResult extends PaginationResult {
+    matches: SearchMatch[];
+}
+export interface ListDirectoryParams extends PaginationParams {
+    path: string;
+    depth?: number;
+}
+export interface DirectoryEntry {
+    name: string;
+    type: 'file' | 'dir';
+    size?: number;
+}
+export interface ListDirectoryResult extends PaginationResult {
+    entries: DirectoryEntry[];
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    id: string;
+    name: string;
+    result: unknown;
+    error?: string;
+}
+export interface ToolFunctionDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolDefinition {
+    type: 'function';
+    function: ToolFunctionDefinition;
+}
+export type ToolExecutor<P = unknown, R = unknown> = (params: P) => Promise<R>;

package/dist/agent/tools/types.js

@@ -0,0 +1,5 @@
+/**
+ * Agent 工具类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/agent/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agent 核心类型定义
+ */
+import type { ToolCall, ToolDefinition } from './tools/types.js';
+export interface AgentMessageBase {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+}
+export interface AgentSystemMessage extends AgentMessageBase {
+    role: 'system';
+    content: string;
+}
+export interface AgentUserMessage extends AgentMessageBase {
+    role: 'user';
+    content: string;
+}
+export interface AgentAssistantMessage extends AgentMessageBase {
+    role: 'assistant';
+    tool_calls?: ToolCall[];
+    reasoning_content?: string;
+}
+export interface AgentToolMessage extends AgentMessageBase {
+    role: 'tool';
+    tool_call_id: string;
+    name: string;
+}
+export type AgentMessage = AgentSystemMessage | AgentUserMessage | AgentAssistantMessage | AgentToolMessage;
+export interface AgentReviewInput {
+    prompt: string;
+    diff: string;
+    files: string[];
+}
+export interface AgentReviewOptions {
+    maxIterations: number;
+    maxToolCalls: number;
+    onToolCall?: (call: ToolCall) => void;
+    onIteration?: (iteration: number, toolCalls: number) => void;
+}
+export interface OrchestratorState {
+    messages: AgentMessage[];
+    iteration: number;
+    totalToolCalls: number;
+    done: boolean;
+}
+export interface AgentProvider {
+    reviewWithAgent(input: AgentReviewInput, options: AgentReviewOptions): Promise<string>;
+}
+export type LLMCallFunction = (messages: AgentMessage[], tools: ToolDefinition[]) => Promise<{
+    content: string | null;
+    toolCalls: ToolCall[];
+    reasoning_content?: string;
+}>;
+export interface AgentOrchestrator {
+    run(input: AgentReviewInput, options: AgentReviewOptions): Promise<string>;
+}

package/dist/agent/types.js

@@ -0,0 +1,5 @@
+/**
+ * Agent 核心类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}