apex-dev 2.0.0 → 3.0.0

package/src/tools.js

@@ -172,15 +172,131 @@ const toolDefs = [
   {
     type: 'function',
     function: {
-      name: 'CodeReview',
-      description: 'MANDATORY — call this as the FINAL step after completing any code-writing or code-editing task. Spawns a code-review sub-agent that reviews ALL files you modified during this turn. Provide a summary of what you built/changed so the reviewer has context. The reviewer will analyse your changes for bugs, logic errors, style issues, and missed edge cases, then return its findings. If the reviewer finds problems, fix them before responding to the user.',
+      name: 'WebSearch',
+      description: 'Search the web using Exa AI. Returns relevant results with titles, URLs, and text snippets. Use this to find up-to-date information, documentation, or answers from the internet.',
       parameters: {
         type: 'object',
         properties: {
-          prompt: { type: 'string', description: 'Summary of what you built or changed, so the reviewer understands the intent behind the code. Include the original user request and any key design decisions.' },
+          query: { type: 'string', description: 'The search query to execute.' },
+          num_results: { type: 'number', description: 'Number of results to return (default: 5, max: 10).' },
+          type: { type: 'string', description: 'Search type: "auto" (default), "neural", or "keyword".' },
+          include_domains: {
+            type: 'array',
+            description: 'Only return results from these domains, e.g. ["github.com", "stackoverflow.com"].',
+            items: { type: 'string' },
+          },
+          category: { type: 'string', description: 'Filter by category: "news", "research paper", "tweet", "company", "personal site", etc.' },
+        },
+        required: ['query'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'FilePickerMax',
+      description: 'Spawn a file-picker sub-agent that deeply explores the codebase to find files relevant to a prompt. It scans the full directory tree and previews every source file, then uses the most capable model to identify and rank the relevant files. Use this when you need to locate files related to a concept, feature, bug, or pattern. NEVER send generic prompts like "give me an overview of the codebase" — always specify the exact type of files you want.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'Specify the exact type of files you need. NEVER ask for a generic overview. Be specific — e.g. "show me the main entry point and routing files", "files that handle user authentication", "all React components related to the dashboard", "where database migrations are defined".' },
+        },
+        required: ['prompt'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'TodoList',
+      description: 'Manage a persistent todo list for tracking tasks. Supports adding, listing, completing, and removing items. The list is saved to .apex-todos.json in the project root.',
+      parameters: {
+        type: 'object',
+        properties: {
+          action: {
+            type: 'string',
+            enum: ['add', 'list', 'done', 'remove', 'clear'],
+            description: 'Action to perform: "add" a new item, "list" all items, "done" to mark complete, "remove" to delete, "clear" to remove all completed.',
+          },
+          text: { type: 'string', description: 'Text for the todo item (required for "add").' },
+          index: { type: 'number', description: 'Item index (1-based, required for "done" and "remove").' },
+        },
+        required: ['action'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'Thinker',
+      description: 'Spawn a deep reasoning/planning sub-agent. It analyzes the problem, considers multiple approaches, and returns a structured plan. Use for complex tasks that benefit from careful planning before implementation.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'The question or task to reason about deeply.' },
+        },
+        required: ['prompt'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'ThinkerBestOfN',
+      description: 'Spawn N parallel thinking agents that each independently reason about the same problem, then a selector picks the best response. Use for critical decisions that benefit from multiple perspectives. Only available in MAX mode.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'The question or task to reason about from multiple angles.' },
+          n: { type: 'number', description: 'Number of parallel thinking passes (default: 3, max: 5).' },
+        },
+        required: ['prompt'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'EditorMultiPrompt',
+      description: 'Spawn multiple editor agents in parallel, each with a different implementation strategy, then a selector picks the best result and applies it. Only available in MAX mode. Use for important code changes where you want to explore multiple approaches.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'The coding task to implement.' },
+          strategies: {
+            type: 'array',
+            description: 'Array of 2-3 different implementation strategies to try in parallel.',
+            items: { type: 'string' },
+          },
           files: {
             type: 'array',
-            description: 'Additional file paths to include beyond the auto-detected modified files (e.g. related files for context). Modified files are always included automatically.',
+            description: 'File paths and their contents that each editor will work with.',
+            items: {
+              type: 'object',
+              properties: {
+                path: { type: 'string', description: 'File path.' },
+                content: { type: 'string', description: 'Current file content.' },
+              },
+              required: ['path', 'content'],
+            },
+          },
+        },
+        required: ['prompt', 'strategies', 'files'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'CodeReviewMulti',
+      description: 'Spawn multiple code reviewers in parallel, each analyzing from a different perspective (correctness, security, performance, etc.). Only available in MAX mode.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'Description of the changes to review.' },
+          perspectives: {
+            type: 'array',
+            description: 'Review perspectives, e.g. ["correctness and logic", "security vulnerabilities", "performance and efficiency"].',
             items: { type: 'string' },
           },
         },
@@ -188,6 +304,32 @@ const toolDefs = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'Commander',
+      description: 'Spawn a terminal command specialist agent that determines and executes the right shell commands for a task. It plans the commands, explains them, then executes them in sequence.',
+      parameters: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'Description of what needs to be accomplished via terminal commands.' },
+        },
+        required: ['prompt'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'ContextPruner',
+      description: 'Summarize the current conversation history to free up context space. Automatically invoked in MAX mode but can be called manually. Replaces verbose conversation history with a concise summary preserving all critical information.',
+      parameters: {
+        type: 'object',
+        properties: {},
+        required: [],
+      },
+    },
+  },
 ];
 
 module.exports = { toolDefs };

package/src/utils.js

@@ -0,0 +1,32 @@
+'use strict';
+
+function toolDetailStr(name, args) {
+  if (!args) return '';
+  switch (name) {
+    case 'Bash': return args.command || '';
+    case 'Grep': return `"${args.pattern}"${args.path ? ` in ${args.path}` : ''}`;
+    case 'Glob': return args.pattern || '';
+    case 'ListDir': return args.path || '.';
+    case 'Read': {
+      let d = args.path || '';
+      if (args.start_line) d += `:${args.start_line}-${args.end_line || ''}`;
+      return d;
+    }
+    case 'Write': return args.path || '';
+    case 'Edit': return args.path || '';
+    case 'Patch': return `${args.path} (${(args.edits || []).length} edits)`;
+    case 'UndoEdit': return args.path || '';
+    case 'Task': return args.description || '';
+    case 'CodeReview': return 'reviewing changes';
+    case 'CodeReviewMulti': return `multi-review (${(args.perspectives || []).length} perspectives)`;
+    case 'FilePickerMax': return args.prompt ? args.prompt.slice(0, 40) : '';
+    case 'Thinker': return args.prompt ? args.prompt.slice(0, 40) : 'reasoning';
+    case 'ThinkerBestOfN': return `best-of-${args.n || 3}: ${(args.prompt || '').slice(0, 30)}`;
+    case 'EditorMultiPrompt': return `${(args.strategies || []).length} strategies`;
+    case 'Commander': return args.prompt ? args.prompt.slice(0, 40) : 'running commands';
+    case 'ContextPruner': return 'pruning context';
+    default: return JSON.stringify(args).slice(0, 60);
+  }
+}
+
+module.exports = { toolDetailStr };

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "skipLibCheck": true,
+    "strict": false
+  }
+}

package/index.js

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { session } = require('./src/config');
-const {
-  t,
-  indent,
-  showHeader,
-  showWelcome,
-  showPrompt,
-  showSessionSummary,
-  createPrompt,
-} = require('./src/ui');
-const { handleSlashCommand } = require('./src/commands');
-const { handleUserInput, setRlClosed, getRlClosed, getIsProcessing } = require('./src/agent');
-
-// ===== State =====
-let rl;
-let askQuestion;
-
-// ===== Input Loop =====
-function setupInputLoop() {
-  setRlClosed(false);
-  rl = createPrompt();
-
-  rl.on('close', () => {
-    setRlClosed(true);
-    if (getIsProcessing()) return;
-    // If stdin is still usable, re-create readline (e.g. terminal glitch)
-    if (!process.stdin.destroyed && process.stdin.readable) {
-      setupInputLoop();
-      askQuestion();
-      return;
-    }
-    console.log();
-    showSessionSummary();
-    console.log(indent(t.dim('Goodbye! ') + t.primary('✦')));
-    console.log();
-    process.exit(0);
-  });
-}
-
-// ===== Main Loop =====
-async function main() {
-  showHeader();
-  showWelcome();
-
-  setupInputLoop();
-
-  askQuestion = () => {
-    if (getRlClosed()) return;
-    process.stdin.resume();
-    const promptStr = showPrompt();
-
-    rl.question(promptStr, async (answer) => {
-      if (answer === null || answer === undefined) {
-        process.exit(0);
-      }
-      const input = answer.trim();
-
-      if (!input) { askQuestion(); return; }
-
-      // Slash commands
-      if (input.startsWith('/')) {
-        await handleSlashCommand(input, rl);
-        askQuestion();
-        return;
-      }
-
-      if (input === 'exit' || input === 'quit') {
-        console.log();
-        showSessionSummary();
-        console.log(indent(t.dim('Goodbye! ') + t.primary('✦')));
-        console.log();
-        process.exit(0);
-      }
-
-      try {
-        await handleUserInput(input, { setupInputLoop, askQuestion });
-      } catch (err) {
-        console.log(indent(t.red('✗ Unexpected error: ') + t.text(err.message)));
-        console.log();
-      }
-      askQuestion();
-    });
-  };
-
-  askQuestion();
-}
-
-// ===== Run =====
-main().catch(console.error);

package/src/ui.js

@@ -1,269 +0,0 @@
-'use strict';
-
-const chalk = require('chalk');
-const ora = require('ora');
-const boxen = require('boxen');
-const figures = require('figures');
-const readline = require('readline');
-const { highlight } = require('cli-highlight');
-const path = require('path');
-const { execSync } = require('child_process');
-const { MAX_TOOL_ITERATIONS, PROJECT_ROOT, session, timestamp } = require('./config');
-
-// ===== Theme (Amp-inspired) =====
-const t = {
-  primary:  chalk.hex('#6366f1'),
-  accent:   chalk.hex('#818cf8'),
-  dim:      chalk.dim,
-  muted:    chalk.gray,
-  text:     chalk.white,
-  bold:     chalk.bold,
-  green:    chalk.green,
-  yellow:   chalk.yellow,
-  red:      chalk.red,
-  blue:     chalk.blue,
-  cyan:     chalk.cyan,
-  italic:   chalk.italic,
-};
-
-// ===== Layout =====
-const COLS = Math.min(process.stdout.columns || 80, 100);
-
-function hr() {
-  return t.dim('─'.repeat(COLS));
-}
-
-function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
-}
-
-function indent(str, n = 0) {
-  if (n === 0) return str;
-  const prefix = ' '.repeat(n);
-  return str.split('\n').map(l => prefix + l).join('\n');
-}
-
-// ===== Header =====
-function showHeader() {
-  console.clear();
-  let branch = '';
-  try { branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { encoding: 'utf-8', cwd: PROJECT_ROOT }).trim(); } catch {}
-
-  const name = t.primary.bold('⚡ Apex');
-  const branchStr = branch ? t.dim('on ') + t.text(branch) : '';
-  const cwd = t.dim(path.basename(PROJECT_ROOT));
-
-  console.log();
-  console.log(`${name}  ${cwd}  ${branchStr}`);
-  console.log(hr());
-}
-
-// ===== Welcome =====
-function showWelcome() {
-  console.log();
-  console.log(t.bold('How can I help?'));
-  console.log(t.dim(`Tools available · Max ${MAX_TOOL_ITERATIONS} iterations per turn`));
-  console.log();
-}
-
-// ===== Messages =====
-function showUserMessage(text) {
-  console.log();
-  console.log(t.blue.bold('You'));
-  console.log(text);
-  console.log();
-}
-
-function showAssistantHeader() {
-  console.log(t.primary.bold('Apex'));
-}
-
-function showAssistantMessage(text) {
-  const lines = text.split('\n');
-  const formatted = [];
-  let inCodeBlock = false;
-  let codeLines = [];
-  let codeLang = '';
-
-  for (const line of lines) {
-    if (line.startsWith('```') && !inCodeBlock) {
-      inCodeBlock = true;
-      codeLang = line.slice(3).trim() || 'code';
-      codeLines = [];
-    } else if (line.startsWith('```') && inCodeBlock) {
-      inCodeBlock = false;
-      formatted.push(renderCodeBlock(codeLines.join('\n'), codeLang));
-    } else if (inCodeBlock) {
-      codeLines.push(line);
-    } else {
-      const processed = line.replace(/`([^`]+)`/g, (_, code) => t.cyan(code));
-      formatted.push(processed);
-    }
-  }
-
-  console.log(formatted.join('\n'));
-  console.log();
-}
-
-// ===== Code Block =====
-function renderCodeBlock(code, lang) {
-  const label = t.dim(`── ${lang} ──`);
-  let highlighted;
-  try {
-    highlighted = highlight(code, { language: lang, ignoreIllegals: true });
-  } catch {
-    highlighted = code;
-  }
-
-  const cLines = highlighted.split('\n').map((line, i) => {
-    return t.dim(String(i + 1).padStart(3) + ' │ ') + line;
-  });
-
-  return `${label}\n${cLines.join('\n')}\n${t.dim('─'.repeat(Math.min(COLS, 60)))}`;
-}
-
-// ===== Tool Display =====
-function toolBadge(name) {
-  return t.dim('[') + t.accent(name) + t.dim(']');
-}
-
-function toolDetail(name, args) {
-  switch (name) {
-    case 'Bash': return args.command || '';
-    case 'Grep': return `"${args.pattern}"${args.path ? ` in ${args.path}` : ''}`;
-    case 'Glob': return args.pattern || '';
-    case 'ListDir': return args.path || '.';
-    case 'Read': {
-      let d = args.path || '';
-      if (args.start_line) d += `:${args.start_line}-${args.end_line || ''}`;
-      return d;
-    }
-    case 'Write': return args.path || '';
-    case 'Edit': return args.path || '';
-    case 'Patch': return `${args.path} (${(args.edits || []).length} edits)`;
-    case 'UndoEdit': return args.path || '';
-    case 'Task': return args.description || '';
-    case 'CodeReview': {
-      const extra = (args.files || []).length;
-      const modCount = session.filesModified.size;
-      return `${modCount} modified${extra ? ` + ${extra} extra` : ''}`;
-    }
-    default: return JSON.stringify(args).slice(0, 60);
-  }
-}
-
-async function showToolCall(name, detail, startTime) {
-  const truncDetail = detail.length > 60 ? detail.slice(0, 57) + '...' : detail;
-  const spinner = ora({
-    text: `${toolBadge(name)} ${t.dim(truncDetail)}`,
-    prefixText: '  ',
-    spinner: 'dots',
-    color: 'white',
-  }).start();
-  return spinner;
-}
-
-function finishToolCall(spinner, name, detail, startTime, success = true) {
-  const elapsed = Date.now() - startTime;
-  const icon = success ? t.green('✓') : t.red('✗');
-  const timeStr = elapsed < 1000 ? `${elapsed}ms` : `${(elapsed / 1000).toFixed(1)}s`;
-  const truncDetail = detail.length > 60 ? detail.slice(0, 57) + '...' : detail;
-
-  spinner.stopAndPersist({
-    symbol: icon,
-    text: `${toolBadge(name)} ${t.dim(truncDetail)}  ${t.dim(timeStr)}`,
-    prefixText: '  ',
-  });
-}
-
-// ===== Diff =====
-function showDiff(filename, diffText) {
-  console.log(indent(t.bold(path.basename(filename)), 4));
-  const lines = diffText.split('\n');
-  for (const line of lines) {
-    if (line.startsWith('+')) {
-      console.log(indent(t.green(line), 4));
-    } else if (line.startsWith('-')) {
-      console.log(indent(t.red(line), 4));
-    }
-  }
-  console.log();
-}
-
-
-// ===== Prompt =====
-function createPrompt() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    prompt: '',
-  });
-}
-
-function showPrompt() {
-  console.log(t.dim('  Ctrl+C to cancel · /help for commands'));
-  return t.primary('❯ ');
-}
-
-// ===== Session Summary =====
-function showSessionSummary() {
-  const elapsed = ((Date.now() - session.startTime) / 1000 / 60).toFixed(1);
-  const parts = [
-    `${elapsed} min`,
-    `${session.turnCount} turns`,
-    `${session.toolCallCount} tool calls`,
-    `${session.totalTokens.toLocaleString()} tokens`,
-    `$${session.totalCost.toFixed(4)}`,
-  ];
-  if (session.filesModified.size > 0) {
-    parts.push(`${session.filesModified.size} files modified`);
-  }
-  if (session.commandsRun.length > 0) {
-    parts.push(`${session.commandsRun.length} commands`);
-  }
-
-  console.log();
-  console.log(t.dim('  Session: ') + t.text(parts.join(' · ')));
-  console.log();
-}
-
-// ===== Help =====
-function showHelpMenu() {
-  console.log();
-  console.log(t.bold('Commands'));
-  console.log(t.dim('  /help       ') + 'Show this menu');
-  console.log(t.dim('  /files      ') + 'Show project file tree');
-  console.log(t.dim('  /clear      ') + 'Clear conversation');
-  console.log(t.dim('  /cost       ') + 'Show session stats');
-  console.log(t.dim('  /undo       ') + 'Undo last edit');
-  console.log(t.dim('  /diff       ') + 'Show git diff');
-  console.log(t.dim('  /git <cmd>  ') + 'Run a git command');
-  console.log(t.dim('  /quit       ') + 'Exit');
-  console.log();
-  console.log(t.bold('Tools'));
-  console.log(t.dim('  Read, Write, Edit, Patch, Bash, Grep, Glob, ListDir, UndoEdit, Task, CodeReview'));
-  console.log();
-}
-
-module.exports = {
-  t,
-  COLS,
-  hr,
-  stripAnsi,
-  indent,
-  showHeader,
-  showWelcome,
-  showUserMessage,
-  showAssistantHeader,
-  showAssistantMessage,
-  renderCodeBlock,
-  toolBadge,
-  toolDetail,
-  showToolCall,
-  finishToolCall,
-  showDiff,
-  createPrompt,
-  showPrompt,
-  showSessionSummary,
-  showHelpMenu,
-};