apex-dev 3.0.2 → 3.1.0

package/src/components/UserMessage.jsx

@@ -1,11 +0,0 @@
-import { TextAttributes } from '@opentui/core';
-import { colors } from '../theme.js';
-
-export default function UserMessage({ content }) {
-  return (
-    <box style={{ flexDirection: 'column', paddingLeft: 1, marginTop: 1 }}>
-      <text fg={colors.blue} attributes={TextAttributes.BOLD} content="You" />
-      <text fg={colors.text} content={content || ''} />
-    </box>
-  );
-}

package/src/components/Welcome.jsx

@@ -1,14 +0,0 @@
-import { TextAttributes } from '@opentui/core';
-import { colors } from '../theme.js';
-import { useLayout } from '../hooks/useLayout.js';
-import { MAX_TOOL_ITERATIONS } from '../config.js';
-
-export default function Welcome() {
-  const { isNarrow } = useLayout();
-  return (
-    <box style={{ flexDirection: 'column', paddingLeft: 1, marginTop: 1 }}>
-      <text fg={colors.white} attributes={TextAttributes.BOLD} content="How can I help?" />
-      <text fg={colors.dim} content={isNarrow ? `Max ${MAX_TOOL_ITERATIONS} iterations` : `Tools available · Max ${MAX_TOOL_ITERATIONS} iterations per turn`} />
-    </box>
-  );
-}

package/src/config.js

@@ -1,196 +0,0 @@
-'use strict';
-
-const OpenAI = require('openai');
-
-// ===== Config =====
-const NVIDIA_MODEL = 'z-ai/glm4.7';
-const REVIEWER_MODEL = 'nvidia/llama-3.3-nemotron-70b-instruct';
-const FILE_PICKER_MODEL = 'qwen/qwen3-coder-480b-a35b-instruct';
-const THINKER_MODEL = 'z-ai/glm4.7';
-const COMMANDER_MODEL = 'nvidia/llama-3.3-nemotron-70b-instruct';
-const CONTEXT_PRUNER_MODEL = 'nvidia/llama-3.3-nemotron-70b-instruct';
-const MAX_TOOL_ITERATIONS = 50;
-const MAX_OUTPUT_LEN = 12000;
-const TOOL_TIMEOUT = 60000;
-const PROJECT_ROOT = process.cwd();
-
-// ===== Mode System =====
-// Modes: 'default' | 'max' | 'lite'
-let currentMode = 'default';
-
-const REVIEWER_SYSTEM_PROMPT = `You are a senior code reviewer. An AI coding assistant just made changes to a codebase. Your job is to review those changes thoroughly and report issues. Be specific — reference exact line numbers, function names, and variables.
-
-The caller must always specify the exact files and changes to review. If you receive a vague or generic prompt, review only what is explicitly provided — do NOT infer or assume scope.
-
-Focus on:
-1. **Bugs & logic errors** — incorrect conditions, off-by-one, null/undefined risks, race conditions
-2. **Security** — exposed secrets, injection risks, unsafe operations
-3. **Edge cases** — unhandled inputs, missing error handling at boundaries
-4. **Code quality** — naming, readability, dead code, unnecessary complexity
-5. **Correctness** — does the code actually fulfil the stated intent?
-
-If everything looks good, say so briefly. If there are problems, list them clearly with severity (critical / warning / nit). You have no tools; your only output is this review.`;
-
-const FILE_PICKER_SYSTEM_PROMPT = `You are a precision file-picker agent embedded inside a coding assistant. Your ONLY job is to identify the files in a codebase that are relevant to a given prompt.
-
-You will receive:
-1. A full recursive directory tree of the project.
-2. A preview (first 8 lines) of every source file.
-3. A prompt specifying the exact type of files to find.
-
-Your task:
-- Analyze the directory tree and file previews carefully.
-- Select ONLY the files that are directly relevant to the prompt.
-- Rank them by relevance (most relevant first).
-- Be precise — do NOT include files that are only tangentially related.
-- If no files match, say so.
-- The caller must always specify the exact type of files they need. If you receive a vague or generic prompt like "give me an overview of the codebase", respond with an empty array — do NOT guess.
-
-Output format — return ONLY a JSON array of objects, nothing else:
-[
-  { "path": "relative/path/to/file.js", "reason": "Brief explanation of why this file is relevant" }
-]
-
-Do NOT wrap in markdown code fences. Output raw JSON only.`;
-
-const THINKER_SYSTEM_PROMPT = `You are Theo the Theorizer, a deep reasoning and planning agent inside a coding assistant. Your job is to think carefully about coding tasks and produce clear, actionable plans.
-
-You will receive the conversation history and a specific question or task to reason about.
-
-Your process:
-1. Analyze the problem deeply — consider edge cases, dependencies, and implications.
-2. If it's a coding task, plan which files need changes and in what order.
-3. Consider multiple approaches and trade-offs.
-4. Output a clear, structured response with your reasoning and recommendations.
-
-Be concise but thorough. Focus on actionable insights, not obvious observations. If you identify risks or potential issues, flag them clearly.`;
-
-const COMMANDER_SYSTEM_PROMPT = `You are a terminal command specialist agent. Your job is to determine the right shell commands to accomplish a goal and explain what they do.
-
-You will receive a task description. Output a JSON array of commands to execute:
-[
-  { "command": "the shell command", "description": "what this does and why" }
-]
-
-Rules:
-- Only suggest safe, non-destructive commands unless explicitly asked for destructive operations.
-- Never suggest commands that expose secrets or credentials.
-- Prefer specific, targeted commands over broad ones.
-- Include error handling where appropriate (e.g., using || or checking exit codes).
-- Output raw JSON only, no markdown fences.`;
-
-const CONTEXT_PRUNER_SYSTEM_PROMPT = `You are a context management agent. Your job is to summarize a long conversation history into a concise but complete summary that preserves all important information.
-
-Preserve:
-1. All file paths that were read, modified, or created.
-2. Key decisions and their rationale.
-3. Errors encountered and how they were resolved.
-4. The current state of the task (what's done, what's remaining).
-5. Any important code snippets or patterns discussed.
-
-Output a structured summary with sections:
-- **Task**: What the user asked for
-- **Progress**: What has been done so far
-- **Files Modified**: List of files changed
-- **Key Decisions**: Important choices made
-- **Current State**: Where things stand now
-- **Remaining**: What still needs to be done (if anything)
-
-Be concise but lose no critical details. This summary replaces the full conversation.`;
-
-const SELECTOR_SYSTEM_PROMPT = `You are a code implementation selector. You will receive multiple implementation proposals (labeled A, B, C, etc.) for the same coding task. Each proposal includes the strategy used and the resulting changes.
-
-Your job:
-1. Analyze each implementation carefully for:
-   - **Correctness**: Does it actually solve the stated problem?
-   - **Code quality**: Is it clean, readable, and maintainable?
-   - **Simplicity**: Is it the simplest correct solution?
-   - **Edge cases**: Does it handle edge cases?
-   - **Consistency**: Does it match existing code patterns?
-2. Pick the best implementation.
-3. Note any good ideas from non-chosen implementations that could improve the winner.
-
-Output JSON only, no markdown fences:
-{
-  "chosen": "A",
-  "reason": "Brief explanation of why this is the best",
-  "improvements": "Any good ideas from other implementations to incorporate"
-}`;
-
-const nvidiaClient = new OpenAI({
-  apiKey: process.env.NVIDIA_API_KEY || '',
-  baseURL: 'https://integrate.api.nvidia.com/v1',
-});
-
-// ===== Session State =====
-const session = {
-  conversationHistory: [],
-  totalTokens: 0,
-  totalCost: 0,
-  toolCallCount: 0,
-  filesModified: new Set(),
-  filesRead: new Set(),
-  commandsRun: [],
-  editHistory: [],       // { path, before, after, timestamp }
-  startTime: Date.now(),
-  turnCount: 0,
-};
-
-// ===== Shared Utilities =====
-function truncateOutput(str) {
-  if (str.length > MAX_OUTPUT_LEN) {
-    return str.slice(0, MAX_OUTPUT_LEN) + `\n... (truncated, ${str.length} chars total)`;
-  }
-  return str;
-}
-
-const path = require('path');
-
-function resolvePath(p) {
-  if (!p) return PROJECT_ROOT;
-  return path.isAbsolute(p) ? p : path.resolve(PROJECT_ROOT, p);
-}
-
-function timestamp() {
-  return new Date().toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' });
-}
-
-function sleep(ms) {
-  return new Promise(r => setTimeout(r, ms));
-}
-
-function getMode() { return currentMode; }
-function setMode(mode) {
-  if (['default', 'max', 'lite'].includes(mode)) {
-    currentMode = mode;
-    return true;
-  }
-  return false;
-}
-
-module.exports = {
-  NVIDIA_MODEL,
-  REVIEWER_MODEL,
-  THINKER_MODEL,
-  COMMANDER_MODEL,
-  CONTEXT_PRUNER_MODEL,
-  MAX_TOOL_ITERATIONS,
-  MAX_OUTPUT_LEN,
-  TOOL_TIMEOUT,
-  PROJECT_ROOT,
-  FILE_PICKER_MODEL,
-  FILE_PICKER_SYSTEM_PROMPT,
-  REVIEWER_SYSTEM_PROMPT,
-  THINKER_SYSTEM_PROMPT,
-  COMMANDER_SYSTEM_PROMPT,
-  CONTEXT_PRUNER_SYSTEM_PROMPT,
-  SELECTOR_SYSTEM_PROMPT,
-  nvidiaClient,
-  session,
-  truncateOutput,
-  resolvePath,
-  timestamp,
-  sleep,
-  getMode,
-  setMode,
-};

package/src/hooks/useLayout.js

@@ -1,15 +0,0 @@
-import { useTerminalDimensions } from '@opentui/react';
-
-const NARROW_THRESHOLD = 60;
-
-export function useLayout() {
-  const { width } = useTerminalDimensions();
-  const w = width || 80;
-  const isNarrow = w < NARROW_THRESHOLD;
-  return {
-    width: w,
-    isNarrow,
-    indent: isNarrow ? 2 : 4,
-    smallIndent: isNarrow ? 1 : 2,
-  };
-}

package/src/hooks/useStore.js

@@ -1,6 +0,0 @@
-import { useSyncExternalStore } from 'react';
-import { subscribe, getSnapshot } from '../store.js';
-
-export function useStore() {
-  return useSyncExternalStore(subscribe, getSnapshot);
-}

package/src/prompt.js

@@ -1,101 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-const { PROJECT_ROOT, MAX_TOOL_ITERATIONS, getMode } = require('./config');
-
-function buildSystemPrompt() {
-  let gitInfo = '';
-  try {
-    const branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', { encoding: 'utf-8', cwd: PROJECT_ROOT }).trim();
-    const status = execSync('git status --short 2>/dev/null', { encoding: 'utf-8', cwd: PROJECT_ROOT }).trim();
-    const remoteUrl = execSync('git config --get remote.origin.url 2>/dev/null', { encoding: 'utf-8', cwd: PROJECT_ROOT }).trim();
-    gitInfo = `\nGit branch: ${branch}\nGit remote: ${remoteUrl}\nGit status:\n${status || '(clean)'}`;
-  } catch {}
-
-  let projectInfo = '';
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(PROJECT_ROOT, 'package.json'), 'utf-8'));
-    projectInfo = `\nProject: ${pkg.name || 'unknown'} v${pkg.version || '0.0.0'}`;
-    if (pkg.dependencies) projectInfo += `\nDependencies: ${Object.keys(pkg.dependencies).join(', ')}`;
-    if (pkg.devDependencies) projectInfo += `\nDev dependencies: ${Object.keys(pkg.devDependencies).join(', ')}`;
-    if (pkg.scripts) projectInfo += `\nScripts: ${Object.keys(pkg.scripts).join(', ')}`;
-  } catch {}
-
-  return `You are Apex AI, an agentic CLI coding assistant that runs in the terminal. Be concise, precise, and action-oriented.
-
-# Output Style
-- Default to short answers (≤4 lines) unless the user asks for detail.
-- No unnecessary preamble or postamble. Don't narrate obvious steps or explain what you're about to do.
-- After working on files, just stop — don't summarize what you did unless asked.
-- Use bullets and monospace for commands, file paths, and code identifiers.
-- No emojis unless the user uses them first.
-- For casual conversation, greetings, or quick questions, respond naturally without tools or formatting.
-- NEVER say things like "I don't have any tool to call" — just respond with what you know.
-
-# Core Behavior
-1. **Finish the task.** When asked to do something, DO it with tools until complete. Don't just explain how.
-2. **Read before edit.** NEVER modify a file you haven't read. Understand existing code first.
-3. **Work incrementally.** Make small changes, verify they work, then continue.
-4. **Keep going.** If a tool call fails, recover and try another approach. Don't give up after one attempt.
-5. **Existing code: be surgical.** Only change what's needed. Don't refactor, add features, or "improve" beyond what was asked. Match existing style, patterns, and dependencies.
-6. **New/greenfield work:** You may propose structure and be creative, but keep scope minimal.
-7. **Act on errors.** If the user pastes an error or stack trace, use tools to locate the exact source, identify root cause, and fix it. Never punt back with "try checking X."
-
-# Safety & Side Effects
-- Never expose secrets, API keys, tokens, or credentials. Don't display .env contents.
-- Never run destructive commands (\`rm -rf\`, \`git reset --hard\`, \`git clean -fdx\`) without asking.
-- Never \`git commit\` or \`git push\` unless the user explicitly asks.
-- Don't add new dependencies without confirming the user wants them.
-- NEVER assume a library is available. Check package.json or neighboring files first.
-
-# Code Hygiene
-- Do NOT add code comments or docstrings unless the user asks or correctness requires it.
-- Match existing code style, naming conventions, frameworks, and patterns.
-- When creating new files or components, look at existing ones first to follow conventions.
-- Follow security best practices. Never introduce code that exposes or logs secrets.
-
-# Validation
-- After code changes, run the most relevant checks: tests, lint, typecheck, or build. Prefer scripts from package.json.
-- If checks fail, fix and re-run. If blocked, clearly state what's failing and why.
-- Start with targeted tests for what you changed, then broaden if needed.
-
-# Tool Usage
-- Use Grep/Glob/ListDir to explore and locate code.
-- Use Read to understand files before modifying them.
-- Use Edit for surgical changes to existing files (preferred over Write).
-- Use Patch for multiple edits to the same file.
-- Use Write only for creating new files.
-- Use Bash for running commands (tests, builds, linters, git).
-- Bundle independent tool calls in the same turn for parallel execution.
-- Don't ask for permission to use tools — just use them.
-- When using FilePickerMax, ALWAYS specify the exact type of files you need (e.g. "show me the main entry point and config files", "files handling authentication"). NEVER send generic prompts like "give me an overview of the codebase".
-
-# Sub-Agents
-You have access to specialized sub-agents that handle specific tasks:
-- **FilePickerMax**: Scans the codebase to find files relevant to a prompt. Always specify the exact type of files needed.
-- **Thinker**: Deep reasoning and planning for complex tasks. Use when you need to analyze a problem carefully before acting.
-- **ThinkerBestOfN**: (MAX mode only) Spawns N parallel thinkers and picks the best reasoning. Use for critical decisions.
-- **EditorMultiPrompt**: (MAX mode only) Tries multiple implementation strategies in parallel and picks the best one.
-- **CodeReviewMulti**: (MAX mode only) Multiple reviewers analyze code from different perspectives (correctness, security, performance).
-- **Commander**: Plans and executes terminal commands for a specific goal.
-- **ContextPruner**: Summarizes conversation history to free context space.
-
-# Modes
-Current mode: ${getMode()}
-- **default**: Standard single-agent pass with auto code review.
-- **max**: Best-of-N thinking, multi-strategy editing, multi-perspective review, auto context pruning. Higher quality, more API calls.
-- **lite**: Fast mode — skips validation and review steps.
-
-# Note
-A separate code reviewer runs automatically after edits (skipped in lite mode, multi-perspective in max mode).
-
-# Environment
-Working directory: ${PROJECT_ROOT}
-OS: ${process.platform}
-Node: ${process.version}${projectInfo}${gitInfo}
-Maximum tool iterations per turn: ${MAX_TOOL_ITERATIONS}`;
-}
-
-module.exports = { buildSystemPrompt };

package/src/store.js

@@ -1,99 +0,0 @@
-'use strict';
-
-let state = {
-  messages: [],
-  streamingContent: '',
-  streamingThinking: '',
-  isProcessing: false,
-  showHelp: false,
-  showSummary: false,
-};
-
-let nextId = 1;
-const listeners = new Set();
-let renderer = null;
-
-function getSnapshot() { return state; }
-
-function subscribe(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-
-function notify() {
-  for (const fn of listeners) fn();
-  if (renderer) renderer.requestRender();
-}
-
-function setState(partial) {
-  state = { ...state, ...partial };
-  notify();
-}
-
-function addMessage(msg) {
-  const id = nextId++;
-  state = { ...state, messages: [...state.messages, { id, ...msg }] };
-  notify();
-  return id;
-}
-
-function updateMessage(id, updates) {
-  state = {
-    ...state,
-    messages: state.messages.map(m => m.id === id ? { ...m, ...updates } : m),
-  };
-  notify();
-}
-
-function toggleMessageExpanded(id) {
-  state = {
-    ...state,
-    messages: state.messages.map(m => m.id === id ? { ...m, expanded: !m.expanded } : m),
-  };
-  notify();
-}
-
-function updateStreaming(content, thinking) {
-  state = { ...state, streamingContent: content || '', streamingThinking: thinking || '' };
-  notify();
-}
-
-function clearStreaming() {
-  state = { ...state, streamingContent: '', streamingThinking: '' };
-  notify();
-}
-
-function finishStreaming(msg) {
-  const id = nextId++;
-  state = {
-    ...state,
-    streamingContent: '',
-    streamingThinking: '',
-    messages: [...state.messages, { id, ...msg }],
-  };
-  notify();
-  return id;
-}
-
-function clearMessages() {
-  state = { ...state, messages: [] };
-  notify();
-}
-
-function setRenderer(r) { renderer = r; }
-function getRenderer() { return renderer; }
-
-module.exports = {
-  getSnapshot,
-  subscribe,
-  setState,
-  addMessage,
-  updateMessage,
-  toggleMessageExpanded,
-  updateStreaming,
-  clearStreaming,
-  finishStreaming,
-  clearMessages,
-  setRenderer,
-  getRenderer,
-};

package/src/theme.js

@@ -1,19 +0,0 @@
-'use strict';
-
-const colors = {
-  primary: '#6366f1',
-  accent: '#818cf8',
-  dim: '#666666',
-  muted: '#888888',
-  text: '#e0e0e0',
-  white: '#ffffff',
-  green: '#22c55e',
-  yellow: '#eab308',
-  red: '#ef4444',
-  blue: '#3b82f6',
-  cyan: '#06b6d4',
-  surface: '#1e1e2e',
-  border: '#333355',
-};
-
-module.exports = { colors };

package/src/thinking.js

@@ -1,54 +0,0 @@
-'use strict';
-
-function parseThinkBlocks(text) {
-  const thinkRegex = /<think>([\s\S]*?)(?:<\/think>|think>)/g;
-  const thoughts = [];
-  let match;
-  while ((match = thinkRegex.exec(text)) !== null) {
-    const content = match[1].trim();
-    if (content) thoughts.push(content);
-  }
-  const cleaned = text.replace(/<think>[\s\S]*?(?:<\/think>|think>)/g, '').trim();
-  return { thoughts, content: cleaned };
-}
-
-function findThinkClose(text) {
-  const fullClose = text.indexOf('</think>');
-  if (fullClose !== -1) return { pos: fullClose, len: 8 };
-  let searchFrom = 0;
-  while (searchFrom < text.length) {
-    const idx = text.indexOf('think>', searchFrom);
-    if (idx === -1) break;
-    if (idx === 0 || text[idx - 1] !== '<') return { pos: idx, len: 6 };
-    searchFrom = idx + 6;
-  }
-  return null;
-}
-
-function stripStrayCloseTag(text) {
-  return text.replace(/<\/think>/g, '').replace(/(?<!<)think>/g, '');
-}
-
-function splitAtPartialTag(text) {
-  const prefixes = [
-    '</think>', '</think', '</thin', '</thi', '</th', '</t', '</',
-    '<think>', '<think', '<thin', '<thi', '<th', '<t',
-    '<',
-  ];
-  for (const prefix of prefixes) {
-    if (text.endsWith(prefix)) {
-      if (prefix === '</think>' || prefix === 'think>') {
-        return { safe: text.slice(0, -prefix.length), pending: '' };
-      }
-      return { safe: text.slice(0, -prefix.length), pending: prefix };
-    }
-  }
-  return { safe: text, pending: '' };
-}
-
-module.exports = {
-  parseThinkBlocks,
-  findThinkClose,
-  stripStrayCloseTag,
-  splitAtPartialTag,
-};