aegiscode 3.1.10 → 3.4.2

package/src/tools/builtin/edit.ts

@@ -1,213 +0,0 @@
-/**
- * Edit 工具
- * 
- * 
- */
-
-import fs from 'fs/promises';
-import path from 'path';
-import { z } from 'zod';
-import { createTool } from '../createTool.js';
-import { ToolKind, ToolErrorType } from '../types.js';
-import { createSnapshot } from './snapshot.js';
-
-// ========== Schema 定
-
-const EditSchema = z.object({
-  file_path: z.string()
-    .min(1, '文件路径不能为空')
-    .describe('The absolute path to the file to modify'),
-  old_string: z.string()
-    .describe('The text to replace (must be unique in the file unless replace_all is true)'),
-  new_string: z.string()
-    .describe('The text to replace it with'),
-  replace_all: z.boolean()
-    .default(false)
-    .describe('If true, replace all occurrences of old_string'),
-});
-
-// ========== Edit 工
-
-export const editTool = createTool({
-  name: 'Edit',
-  displayName: 'File Edit',
-  kind: ToolKind.Write,
-  schema: EditSchema,
-  
-  description: {
-    short: 'Performs exact string replacements in files',
-    long: 'Edits files by replacing specified text with new text. Requires the old_string to be unique unless replace_all is true.',
-    usageNotes: [
-      'You MUST use the Read tool first before editing a file',
-      'The edit will FAIL if old_string is not unique in the file',
-      'Use replace_all=true for renaming variables across the file',
-      'Preserve exact indentation (tabs/spaces) as it appears',
-      'If you want to create a new file, use the Write tool instead',
-    ],
-    examples: [
-      {
-        description: 'Replace a function name',
-        params: {
-          file_path: '/path/to/file.ts',
-          old_string: 'function oldName(',
-          new_string: 'function newName(',
-        },
-      },
-      {
-        description: 'Replace all occurrences of a variable',
-        params: {
-          file_path: '/path/to/file.ts',
-          old_string: 'oldVar',
-          new_string: 'newVar',
-          replace_all: true,
-        },
-      },
-    ],
-    important: [
-      'NEVER guess file contents - always Read first',
-      'If old_string is not found, the edit will fail',
-      'If multiple matches found without replace_all, provide more context',
-    ],
-  },
-
-  category: '文件操作',
-  tags: ['file', 'io', 'write', 'edit'],
-
-  // 提取签名内容（用于权限规
-  extractSignatureContent: (params: unknown) => {
-    const p = params as { file_path: string };
-    return p.file_path;
-  },
-
-  // 抽象权限规
-  abstractPermissionRule: (params: unknown) => {
-    const p = params as { file_path: string };
-    const dir = path.dirname(p.file_path);
-    return `Edit:${dir}/*`;
-  },
-
-  async execute(params, context) {
-    const { file_path, old_string, new_string, replace_all } = params;
-
-    try {
-      // 1. 检查文件是否存
-      try {
-        const stat = await fs.stat(file_path);
-        if (stat.isDirectory()) {
-          return {
-            success: false,
-            llmContent: `Error: ${file_path} is a directory, not a file`,
-            displayContent: `error: ${file_path} is a directory`,
-            error: {
-              type: ToolErrorType.VALIDATION_ERROR,
-              message: 'Path is a directory',
-            },
-          };
-        }
-      } catch (error) {
-        return {
-          success: false,
-          llmContent: `Error: File not found: ${file_path}`,
-          displayContent: `error: file not found: ${file_path}`,
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: 'File not found',
-          },
-        };
-      }
-
-      // 2. 读取文件内
-      const content = await fs.readFile(file_path, 'utf8');
-
-      // 3. old_string 和 new_string 相同检
-      if (old_string === new_string) {
-        return {
-          success: false,
-          llmContent: 'Error: old_string and new_string are identical',
-          displayContent: 'error: old_string and new_string are identical',
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: 'old_string and new_string are identical',
-          },
-        };
-      }
-
-      // 4. 检查 old_string 是否存
-      const matchCount = content.split(old_string).length - 1;
-      
-      if (matchCount === 0) {
-        return {
-          success: false,
-          llmContent: `Error: old_string not found in file. Make sure you have read the file first and the content is up to date.`,
-          displayContent: `error: old_string not found in file`,
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: 'old_string not found in file',
-          },
-        };
-      }
-
-      // 5. 多重匹配检查（非 replace_all 模
-      if (matchCount > 1 && !replace_all) {
-        return {
-          success: false,
-          llmContent: `Error: Multiple matches (${matchCount}) found for old_string. Either:
-1. Provide more context in old_string to make it unique
-2. Set replace_all=true to replace all occurrences`,
-          displayContent: `error: ${matchCount} matches found — use replace_all or add more context`,
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: `Multiple matches (${matchCount}) found`,
-          },
-        };
-      }
-
-      // 6. 快照原始文件（支持 undo）
-      const snapshotPath = await createSnapshot(file_path);
-
-      // 7. 执行替
-      const newContent = replace_all
-        ? content.replaceAll(old_string, new_string)
-        : content.replace(old_string, new_string);
-
-      // 8. 写入文
-      await fs.writeFile(file_path, newContent, 'utf8');
-
-      // 9. 计算替换数
-      const replacements = replace_all ? matchCount : 1;
-
-      // Render as a unified-style diff: old_string lines removed, new_string lines
-      // added. The renderer (MessageRenderer's ToolUseBlock) detects +/- prefixed
-      // lines and colors them, deriving the "+N -M lines" tally from the counts.
-      const diffLines = [
-        ...old_string.split('\n').map(l => `-${l}`),
-        ...new_string.split('\n').map(l => `+${l}`),
-      ];
-
-      return {
-        success: true,
-        llmContent: `Successfully edited ${file_path} (${replacements} replacement${replacements > 1 ? 's' : ''})`,
-        displayContent: diffLines.join('\n'),
-        metadata: {
-          file_path,
-          replacements,
-          snapshot: snapshotPath,
-          old_string_preview: old_string.length > 50
-            ? old_string.substring(0, 50) + '...'
-            : old_string,
-        },
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'unknown error';
-      return {
-        success: false,
-        llmContent: `Error editing file: ${errorMessage}`,
-        displayContent: `error: ${errorMessage}`,
-        error: {
-          type: ToolErrorType.EXECUTION_ERROR,
-          message: errorMessage,
-        },
-      };
-    }
-  },
-});

package/src/tools/builtin/glob.ts

@@ -1,136 +0,0 @@
-/**
- * Glob 工具 - 文件搜索
- */
-
-import { glob } from 'glob';
-import path from 'path';
-import { z } from 'zod';
-import { createTool } from '../createTool.js';
-import { ToolKind, ToolErrorType } from '../types.js';
-
-/**
- * 
- */
-const DEFAULT_IGNORE = [
-  '**/node_modules/**',
-  '**/.git/**',
-  '**/dist/**',
-  '**/build/**',
-  '**/.next/**',
-  '**/coverage/**',
-];
-
-/**
- * Glob 工具 Schema
- */
-const GlobSchema = z.object({
-  pattern: z.string()
-    .min(1, '模式不能为空')
-    .describe('The glob pattern to match files against'),
-  
-  path: z.string()
-    .optional()
-    .describe('Directory to search in (defaults to current working directory)'),
-});
-
-/**
- * Glob 工具
- */
-export const globTool = createTool({
-  name: 'Glob',
-  displayName: 'File Search',
-  kind: ToolKind.ReadOnly,
-  schema: GlobSchema,
-
-  description: {
-    short: 'Find files matching a glob pattern',
-    long: `Search for files matching a glob pattern. Returns matching file paths sorted by modification time.
-Use this tool when you need to find files by name patterns.`,
-    usageNotes: [
-      'Patterns not starting with "**/" are automatically prepended with "**/" to enable recursive searching',
-      'Common patterns: "*.ts" for TypeScript files, "*.test.ts" for test files',
-      'Results are sorted by modification time (newest first)',
-      'Automatically ignores node_modules, .git, dist, build directories',
-    ],
-    examples: [
-      {
-        description: 'Find all TypeScript files',
-        params: { pattern: '*.ts' },
-      },
-      {
-        description: 'Find all test files',
-        params: { pattern: '**/*.test.ts' },
-      },
-      {
-        description: 'Find files in specific directory',
-        params: { pattern: '*.json', path: '/project/config' },
-      },
-    ],
-  },
-
-  category: '搜索',
-  tags: ['search', 'file', 'glob'],
-
-  async execute(params, context) {
-    let { pattern, path: searchPath } = params;
-    
-    // 默认搜索目
-    const cwd = searchPath || context?.cwd || process.cwd();
-
-    // 自动添
-    if (!pattern.startsWith('**/') && !pattern.startsWith('/')) {
-      pattern = `**/${pattern}`;
-    }
-
-    try {
-      // 执行 glob 搜
-      const files = await glob(pattern, {
-        cwd,
-        ignore: DEFAULT_IGNORE,
-        nodir: true,
-        absolute: true,
-      });
-
-      if (files.length === 0) {
-        return {
-          success: true,
-          llmContent: 'No files found matching the pattern.',
-          displayContent: `no files: ${pattern}`,
-          metadata: {
-            pattern,
-            cwd,
-            count: 0,
-          },
-        };
-      }
-
-      // 格式化输
-      const formattedFiles = files
-        .map(f => path.relative(cwd, f))
-        .join('\n');
-
-      return {
-        success: true,
-        llmContent: formattedFiles,
-        displayContent: `${files.length} file${files.length === 1 ? '' : 's'}`,
-        metadata: {
-          pattern,
-          cwd,
-          count: files.length,
-          files: files.slice(0, 100), // 只存储前 100 
-        },
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : '未知错误';
-      return {
-        success: false,
-        llmContent: `Glob search failed: ${errorMessage}`,
-        displayContent: `error: ${errorMessage}`,
-        error: {
-          type: ToolErrorType.EXECUTION_ERROR,
-          message: errorMessage,
-        },
-      };
-    }
-  },
-});

package/src/tools/builtin/grep.ts

@@ -1,263 +0,0 @@
-/**
- * Grep 工具 - 内容搜索
- */
-
-import fs from 'fs/promises';
-import path from 'path';
-import { glob } from 'glob';
-import { z } from 'zod';
-import { createTool } from '../createTool.js';
-import { ToolKind, ToolErrorType } from '../types.js';
-
-/**
- * 
- */
-const DEFAULT_IGNORE = [
-  '**/node_modules/**',
-  '**/.git/**',
-  '**/dist/**',
-  '**/build/**',
-  '**/.next/**',
-  '**/coverage/**',
-  '**/*.min.js',
-  '**/*.bundle.js',
-];
-
-/**
- * 
- */
-const MAX_RESULTS = 100;
-
-/**
- * Grep 工具 Schema
- */
-const GrepSchema = z.object({
-  pattern: z.string()
-    .min(1, '搜索模式不能为空')
-    .describe('The regular expression pattern to search for'),
-  
-  path: z.string()
-    .optional()
-    .describe('Directory to search in (defaults to current working directory)'),
-  
-  include: z.string()
-    .optional()
-    .describe('Glob pattern to filter files (e.g., "*.ts" for TypeScript files)'),
-  
-  case_sensitive: z.boolean()
-    .default(true)
-    .describe('Whether the search is case sensitive'),
-});
-
-/**
- * 
- */
-interface SearchMatch {
-  file: string;
-  line: number;
-  content: string;
-}
-
-/**
- * 
- */
-async function searchInFile(
-  filePath: string,
-  regex: RegExp
-): Promise<SearchMatch[]> {
-  try {
-    const content = await fs.readFile(filePath, 'utf-8');
-    const lines = content.split('\n');
-    const matches: SearchMatch[] = [];
-
-    for (let i = 0; i < lines.length; i++) {
-      if (regex.test(lines[i])) {
-        matches.push({
-          file: filePath,
-          line: i + 1,
-          content: lines[i].trim(),
-        });
-      }
-    }
-
-    return matches;
-  } catch {
-    // 忽略无法读取的文
-    return [];
-  }
-}
-
-/**
- * Grep 工具
- */
-export const grepTool = createTool({
-  name: 'Grep',
-  displayName: 'Content Search',
-  kind: ToolKind.ReadOnly,
-  schema: GrepSchema,
-
-  description: {
-    short: 'Search file contents using regular expressions',
-    long: `A powerful search tool for finding patterns in file contents.
-Supports full regex syntax and can filter files by glob pattern.`,
-    usageNotes: [
-      'Uses JavaScript regex syntax',
-      'Common patterns: "function\\s+\\w+" for function definitions',
-      'Use include parameter to filter files: "*.ts" for TypeScript only',
-      'Results are limited to 100 matches for performance',
-      'Automatically ignores node_modules, .git, dist directories',
-    ],
-    examples: [
-      {
-        description: 'Search for function definitions',
-        params: { pattern: 'function\\s+\\w+' },
-      },
-      {
-        description: 'Search in TypeScript files only',
-        params: { pattern: 'export', include: '*.ts' },
-      },
-      {
-        description: 'Case-insensitive search',
-        params: { pattern: 'todo', case_sensitive: false },
-      },
-    ],
-  },
-
-  category: '搜索',
-  tags: ['search', 'grep', 'regex'],
-
-  async execute(params, context) {
-    const { pattern, path: searchPath, include, case_sensitive } = params;
-    
-    // 默认搜索目
-    const cwd = searchPath || context?.cwd || process.cwd();
-
-    try {
-      // 创建正则表达
-      // 验证正则表达式是否包含未闭合的字符类或分组
-      const unclosedBracket = (pattern.match(/\[/g) || []).length !== (pattern.match(/\]/g) || []).length;
-      const unclosedParen = (pattern.match(/\(/g) || []).length !== (pattern.match(/\)/g) || []).length;
-      
-      if (unclosedBracket || unclosedParen) {
-        return {
-          success: false,
-          llmContent: `Invalid regex pattern: ${pattern} — unclosed bracket or parenthesis`,
-          displayContent: `error: invalid regex — unclosed bracket or parenthesis`,
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: 'Invalid regex pattern — unclosed bracket or parenthesis',
-          },
-        };
-      }
-
-      let regex: RegExp;
-      try {
-        regex = new RegExp(pattern, case_sensitive ? 'g' : 'gi');
-      } catch (e) {
-        return {
-          success: false,
-          llmContent: `Invalid regex pattern: ${pattern}`,
-          displayContent: `error: invalid regex: ${pattern}`,
-          error: {
-            type: ToolErrorType.VALIDATION_ERROR,
-            message: 'Invalid regex pattern',
-          },
-        };
-      }
-
-      // 获取要搜索的文件列
-      const filePattern = include 
-        ? (include.startsWith('**/') ? include : `**/${include}`)
-        : '**/*';
-      
-      const files = await glob(filePattern, {
-        cwd,
-        ignore: DEFAULT_IGNORE,
-        nodir: true,
-        absolute: true,
-      });
-
-      // 过滤二进制文件（简单判
-      const textExtensions = [
-        '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
-        '.json', '.md', '.txt', '.yaml', '.yml',
-        '.html', '.css', '.scss', '.less',
-        '.py', '.rb', '.go', '.rs', '.java',
-        '.c', '.cpp', '.h', '.hpp',
-        '.sh', '.bash', '.zsh',
-        '.xml', '.svg',
-      ];
-      
-      const textFiles = files.filter(f => 
-        textExtensions.some(ext => f.endsWith(ext))
-      );
-
-      // 搜索所有文
-      const allMatches: SearchMatch[] = [];
-      
-      for (const file of textFiles) {
-        if (allMatches.length >= MAX_RESULTS) break;
-        
-        const matches = await searchInFile(file, regex);
-        allMatches.push(...matches);
-        
-        if (allMatches.length >= MAX_RESULTS) {
-          allMatches.length = MAX_RESULTS;
-          break;
-        }
-      }
-
-      if (allMatches.length === 0) {
-        return {
-          success: true,
-          llmContent: 'No matches found.',
-          displayContent: `no matches: ${pattern}`,
-          metadata: {
-            pattern,
-            cwd,
-            files_searched: textFiles.length,
-            matches: 0,
-          },
-        };
-      }
-
-      // 格式化输
-      const formattedMatches = allMatches
-        .map(m => {
-          const relPath = path.relative(cwd, m.file);
-          return `${relPath}:${m.line}: ${m.content}`;
-        })
-        .join('\n');
-
-      const truncated = allMatches.length >= MAX_RESULTS;
-      let summary = `${allMatches.length} match${allMatches.length === 1 ? '' : 'es'}`;
-      if (truncated) {
-        summary += ` (truncated)`;
-      }
-
-      return {
-        success: true,
-        llmContent: formattedMatches,
-        displayContent: summary,
-        metadata: {
-          pattern,
-          cwd,
-          files_searched: textFiles.length,
-          matches: allMatches.length,
-          truncated,
-        },
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'unknown error';
-      return {
-        success: false,
-        llmContent: `Grep search failed: ${errorMessage}`,
-        displayContent: `error: ${errorMessage}`,
-        error: {
-          type: ToolErrorType.EXECUTION_ERROR,
-          message: errorMessage,
-        },
-      };
-    }
-  },
-});

package/src/tools/builtin/index.ts

@@ -1,61 +0,0 @@
-/**
- * 
- */
-
-// 文件工
-export { readTool } from './read.js';
-export { editTool } from './edit.js';
-export { writeTool } from './write.js';
-
-// 搜索工
-export { grepTool } from './grep.js';
-export { globTool } from './glob.js';
-
-// Shell 工
-export { bashTool } from './bash.js';
-
-// Skills 工
-export { skillTool } from './skill.js';
-
-// Memory 工
-export { memoryTool } from './memory.js';
-
-// Multi-agent orchestration 工
-export { taskTool } from './task.js';
-export { councilTool } from './council.js';
-
-import { readTool } from './read.js';
-import { editTool } from './edit.js';
-import { writeTool } from './write.js';
-import { grepTool } from './grep.js';
-import { globTool } from './glob.js';
-import { bashTool } from './bash.js';
-import { skillTool } from './skill.js';
-import { memoryTool } from './memory.js';
-import { taskTool } from './task.js';
-import { councilTool } from './council.js';
-import type { Tool } from '../types.js';
-
-/**
- * 
- */
-export function getBuiltinTools(): Tool[] {
-  return [
-    // 文件工
-    readTool,
-    editTool,
-    writeTool,
-    // 搜索工
-    grepTool,
-    globTool,
-    // Shell 工
-    bashTool,
-    // Skills 工
-    skillTool,
-    // Memory 工
-    memoryTool,
-    // Multi-agent orchestration 工
-    taskTool,
-    councilTool,
-  ];
-}