aegiscode 3.1.7 → 3.1.10

package/src/tools/builtin/council.ts

@@ -0,0 +1,105 @@
+/**
+ * Council tool — lets the running agent convene a multi-perspective
+ * deliberation mid-conversation, without the user typing /research.
+ * Mirrors the /research slash command (builtinCommands.ts) exactly:
+ * fixed 4-member council, read-only tools, no confirmation needed.
+ */
+
+import { z } from 'zod';
+import { createTool } from '../createTool.js';
+import { ToolKind } from '../types.js';
+import { CouncilAgent } from '../../agent/orchestrator/CouncilAgent.js';
+import { requireModelConfig, buildSourceContext } from '../../agent/orchestrator/utils.js';
+
+const CouncilSchema = z.object({
+  question: z.string().describe('The question or decision to deliberate on'),
+});
+
+export const councilTool = createTool({
+  name: 'Council',
+  displayName: 'Convene Council',
+  kind: ToolKind.ReadOnly,
+  schema: CouncilSchema,
+
+  description: {
+    short: 'Convene a 4-perspective council to deliberate on a question',
+    long: `Spawns a research council of read-only sub-agents with different perspectives —
+Analyst (data/empirical), Architect (systems/design), Ethicist (safety/fairness),
+Pragmatist (implementation reality) — who each vote and reason independently,
+then returns their views plus a synthesis.
+
+Use this for genuinely contested questions where multiple angles matter
+(architecture tradeoffs, risk calls, "should we do X" decisions) — not for
+straightforward lookups.`,
+  },
+
+  execute: async ({ question }, context) => {
+    let modelConfig;
+    try {
+      modelConfig = requireModelConfig();
+    } catch (e) {
+      const msg = (e as Error).message;
+      return { success: false, llmContent: msg, displayContent: msg };
+    }
+
+    const cwd = context?.cwd || process.cwd();
+    const sourceCtx = buildSourceContext(cwd);
+    const baseModelCfg = { model: modelConfig.model, baseURL: modelConfig.baseURL || undefined, apiKey: modelConfig.apiKey };
+    const researchTools = ['Read', 'Grep', 'Glob'];
+    const researchNote = `\n\nWorkspace context (project metadata + file tree + structure summaries + git changes):\n${sourceCtx}\n\nRead files with Read tool, search with Grep, browse with Glob.\nAlways state VOTE: approve, reject, or abstain and REASONING: with clear justification.`;
+
+    try {
+      const council = new CouncilAgent('council', modelConfig, {
+        rule: 'majority',
+        maxTokensPerAgent: 800,
+        enableIteration: false,
+      });
+
+      council.addMember('analyst', 'Data Analyst',
+        `You are a Data Analyst on a research council. You reason from data, statistics, and empirical evidence.\nYou value measurable outcomes and quantitative reasoning.${researchNote}`,
+        1, baseModelCfg, researchTools);
+
+      council.addMember('architect', 'Systems Architect',
+        `You are a Systems Architect on a research council. You evaluate designs, tradeoffs, and architectural decisions.\nYou focus on scalability, maintainability, and system coherence.${researchNote}`,
+        1, baseModelCfg, researchTools);
+
+      council.addMember('ethicist', 'Ethics & Safety Officer',
+        `You are an Ethics & Safety Officer on a research council. You evaluate safety, fairness, privacy, and societal impact.\nYou raise concerns others might miss and advocate for responsible practices.${researchNote}`,
+        1, baseModelCfg, researchTools);
+
+      council.addMember('pragmatist', 'Pragmatic Engineer',
+        `You are a Pragmatic Engineer on a research council. You evaluate practicality, implementation effort, and real-world constraints.\nYou balance idealism with what actually works in production.${researchNote}`,
+        1, baseModelCfg, researchTools);
+
+      const result = await council.deliberate(question, context?.sessionId);
+
+      const lines: string[] = [];
+      for (const v of result.voteResults) {
+        lines.push(`### ${v.role}`);
+        lines.push(`VOTE: ${v.vote}`);
+        lines.push(v.reasoning);
+        lines.push('');
+      }
+      lines.push('### Synthesis');
+      lines.push('');
+      const summaryLines = result.summary.split('\n');
+      const verdictIdx = summaryLines.findIndex(l => l.includes('APPROVED') || l.includes('REJECTED'));
+      const synthesis = verdictIdx > -1
+        ? summaryLines.slice(verdictIdx + 1).join('\n').trim()
+        : result.summary;
+      lines.push(synthesis || `${result.voteResults.length} perspectives gathered.`);
+
+      const formatted = lines.join('\n').trim();
+      return {
+        success: true,
+        llmContent: formatted,
+        displayContent: `✓ Council deliberated (${result.voteResults.length} perspectives, ${result.rounds} round${result.rounds === 1 ? '' : 's'})`,
+      };
+    } catch (e) {
+      const msg = `Council deliberation failed: ${(e as Error).message}`;
+      return { success: false, llmContent: msg, displayContent: msg };
+    }
+  },
+});
+
+export default councilTool;

package/src/tools/builtin/edit.ts

@@ -0,0 +1,213 @@
+/**
+ * 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

@@ -0,0 +1,136 @@
+/**
+ * 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,
+        },
+      };
+    }
+  },
+});