jawere 1.0.13 → 1.5.0

package/dist/scanner.js

@@ -1,520 +0,0 @@
-// src/scanner.ts — Background codebase scanner
-// Runs before the user prompt becomes available.
-// Generates .codebase/tree.yaml (annotated project tree + file summaries)
-// and .codebase/meta.json (scan metadata for cache invalidation).
-// Also generates .codebase/checksums.json for content-hash change detection.
-import { existsSync, statSync, readFileSync } from 'fs';
-import { readFile, writeFile, mkdir, readdir } from 'fs/promises';
-import { resolve, relative, join, basename, dirname } from 'path';
-import { execSync } from 'child_process';
-import { createHash } from 'crypto';
-const SCAN_INTERVAL_MS = 5 * 60 * 1000; // 5 min cache validity
-const CODEBASE_DIR = '.codebase';
-const TREE_FILE = '.codebase/tree.yaml';
-const META_FILE = '.codebase/meta.json';
-const CHECKSUMS_FILE = '.codebase/checksums.json';
-// Files/dirs to skip entirely
-const SKIP_DIRS = new Set([
-    'node_modules', '.git', 'dist', '.codebase',
-    '__pycache__', '.cache', '.next', '.turbo',
-]);
-const SKIP_FILES = new Set([
-    'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock',
-]);
-// Files we can summarize by reading first N lines
-const SUMMARIZABLE_EXTENSIONS = new Set([
-    '.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.rb',
-    '.c', '.cpp', '.h', '.hpp', '.java', '.kt', '.swift',
-    '.yaml', '.yml', '.json', '.toml', '.md', '.css', '.scss',
-    '.sql', '.sh', '.bash', '.zsh', '.Dockerfile',
-]);
-// ── Helpers ─────────────────────────────────────────────────────────
-/** Compute SHA-256 hash of a file's contents (first 64KB for speed). */
-function hashFile(filepath) {
-    try {
-        const fd = readFileSync(filepath);
-        const sample = fd.length > 65536 ? fd.subarray(0, 65536) : fd;
-        return createHash('sha256').update(sample).digest('hex').slice(0, 16);
-    }
-    catch {
-        return null;
-    }
-}
-async function getGitHash(workDir) {
-    try {
-        return execSync('git rev-parse HEAD', {
-            cwd: workDir,
-            timeout: 5000,
-            stdio: ['ignore', 'pipe', 'ignore'],
-        }).toString().trim();
-    }
-    catch {
-        return null;
-    }
-}
-function isBinary(buffer) {
-    const sample = buffer.slice(0, 4096);
-    for (let i = 0; i < sample.length; i++) {
-        if (sample[i] === 0)
-            return true;
-    }
-    return false;
-}
-function classifyFile(filename, dir) {
-    const name = filename.toLowerCase();
-    if (name.includes('.test.') || name.includes('.spec.'))
-        return 'test';
-    if (name.endsWith('.d.ts'))
-        return 'types';
-    if (dir.includes('/convex/'))
-        return 'backend';
-    if (dir.includes('/src/')) {
-        if (name.includes('config') || name.includes('env'))
-            return 'config';
-        if (name.includes('test') || name.includes('spec'))
-            return 'test';
-        if (name.includes('prompt'))
-            return 'prompt';
-        if (name.includes('tool'))
-            return 'core';
-        if (name.includes('agent'))
-            return 'core';
-        if (name.includes('index'))
-            return 'core';
-        if (name.includes('crypto') || name.includes('encrypt'))
-            return 'security';
-        return 'core';
-    }
-    if (dir.includes('/scripts/') || dir.includes('/bin/')) {
-        if (name.includes('build'))
-            return 'build';
-        return 'entry';
-    }
-    if (name === 'package.json')
-        return 'config';
-    if (name === 'tsconfig.json')
-        return 'config';
-    if (name.endsWith('.json'))
-        return 'config';
-    if (name.endsWith('.md'))
-        return 'docs';
-    if (name.includes('readme'))
-        return 'docs';
-    if (name.includes('.gitignore'))
-        return 'config';
-    if (name.includes('docker'))
-        return 'container';
-    if (name.includes('.env'))
-        return 'secret';
-    if (dir.includes('/.github/'))
-        return 'ci';
-    return 'other';
-}
-function extractExports(lines) {
-    const exports = [];
-    for (const line of lines) {
-        const trimmed = line.trim();
-        // Named exports: export const/function/class/interface/type/async function
-        const namedMatch = trimmed.match(/^export\s+(const|function|class|interface|type|enum|async\s+function|let|var)\s+(\w+)/);
-        if (namedMatch) {
-            exports.push(namedMatch[2]);
-            continue;
-        }
-        // Default export
-        if (trimmed.startsWith('export default')) {
-            exports.push('default');
-            continue;
-        }
-    }
-    return exports;
-}
-function extractImports(lines) {
-    const deps = [];
-    for (const line of lines) {
-        // Relative imports only (internal deps)
-        const relMatch = line.match(/from\s+['"](\.[^'"]+)['"]/);
-        if (relMatch) {
-            deps.push(relMatch[1]);
-        }
-    }
-    return deps;
-}
-function extractKeyFunctions(lines) {
-    const funcs = [];
-    for (const line of lines) {
-        // Exported functions
-        const expFunc = line.match(/^export\s+(async\s+)?function\s+(\w+)/);
-        if (expFunc) {
-            funcs.push(expFunc[2]);
-            continue;
-        }
-        // Top-level functions
-        const topFunc = line.match(/^(async\s+)?function\s+(\w+)/);
-        if (topFunc) {
-            funcs.push(topFunc[2]);
-            continue;
-        }
-        // Arrow functions assigned to const
-        const arrowFunc = line.match(/^(export\s+)?const\s+(\w+)\s*=\s*(async\s*)?\(/);
-        if (arrowFunc) {
-            funcs.push(arrowFunc[2]);
-        }
-    }
-    return funcs;
-}
-function generateDescription(filepath, lines, exports) {
-    const basenameLower = basename(filepath).toLowerCase();
-    const ext = filepath.includes('.') ? filepath.split('.').pop()?.toLowerCase() : '';
-    // ── By filename (specific) ──
-    if (basenameLower === 'package.json')
-        return 'NPM package manifest — scripts, dependencies, metadata.';
-    if (basenameLower === 'package-lock.json')
-        return 'NPM dependency lockfile.';
-    if (basenameLower === 'tsconfig.json')
-        return 'TypeScript compiler configuration.';
-    if (basenameLower === 'readme.md')
-        return 'Project documentation and README.';
-    if (basenameLower === '.gitignore')
-        return 'Git ignore rules.';
-    if (basenameLower === '.env.local' || basenameLower === '.env.prod')
-        return 'Environment variables (local/prod).';
-    if (basenameLower === 'convex.json')
-        return 'Convex project configuration.';
-    if (basenameLower === '.releaserc')
-        return 'Semantic release configuration.';
-    if (basenameLower === 'ci.yml' || basenameLower === '.gitlab-ci.yml')
-        return 'CI/CD pipeline configuration.';
-    // ── By file role ──
-    if (basenameLower.includes('index'))
-        return 'Main entry point and REPL loop.';
-    if (basenameLower.includes('agent'))
-        return 'Agent loop — API calls, tool execution, spinner, retry logic.';
-    if (basenameLower.includes('tool'))
-        return 'Tool definitions and implementations for agent actions.';
-    if (basenameLower.includes('config'))
-        return 'Configuration loading and management.';
-    if (basenameLower.includes('crypto') || basenameLower.includes('encrypt'))
-        return 'Encryption/decryption utilities.';
-    if (basenameLower.includes('prompt'))
-        return 'System prompt definition for the agent.';
-    if (basenameLower.includes('convex'))
-        return 'Convex backend client for session persistence.';
-    if (basenameLower.includes('scanner'))
-        return 'Background codebase scanner — generates tree.yaml cache.';
-    if (basenameLower.includes('schema'))
-        return 'Database schema definition.';
-    if (basenameLower.includes('session'))
-        return 'Session management logic.';
-    if (basenameLower.includes('seed'))
-        return 'Database seeding script.';
-    if (basenameLower.includes('build'))
-        return 'Build/bundler script.';
-    if (basenameLower.includes('test') || basenameLower.includes('spec'))
-        return 'Test file.';
-    // ── By extension ──
-    if (ext === 'md')
-        return 'Documentation file.';
-    if (ext === 'json')
-        return 'JSON configuration file.';
-    if (ext === 'yml' || ext === 'yaml')
-        return 'YAML configuration file.';
-    if (ext === 'js')
-        return 'JavaScript module.';
-    if (ext === 'ts' || ext === 'tsx') {
-        if (exports.length > 0) {
-            return `Exports: ${exports.slice(0, 5).join(', ')}${exports.length > 5 ? ', …' : ''}.`;
-        }
-        return 'TypeScript source file.';
-    }
-    if (ext === 'd.ts')
-        return 'TypeScript type declarations.';
-    // Fallback: derive from exports
-    if (exports.length > 0) {
-        return `Exports: ${exports.slice(0, 5).join(', ')}${exports.length > 5 ? ', …' : ''}.`;
-    }
-    return 'Source file.';
-}
-async function summarizeFile(filepath) {
-    const ext = filepath.includes('.') ? `.${filepath.split('.').pop()}` : '';
-    if (!SUMMARIZABLE_EXTENSIONS.has(ext))
-        return null;
-    let content;
-    try {
-        content = await readFile(filepath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-    const lines = content.split('\n');
-    const totalLines = lines.length;
-    const exports = extractExports(lines);
-    const keyFunctions = extractKeyFunctions(lines);
-    const dependsOn = extractImports(lines);
-    const description = generateDescription(filepath, lines, exports);
-    return {
-        lines: totalLines,
-        exports,
-        key_functions: keyFunctions,
-        depends_on: dependsOn,
-        description,
-    };
-}
-// ── Cache check ──────────────────────────────────────────────────────
-export async function cacheIsStale(workDir) {
-    const treePath = resolve(workDir, TREE_FILE);
-    const metaPath = resolve(workDir, META_FILE);
-    if (!existsSync(treePath) || !existsSync(metaPath))
-        return true;
-    let meta;
-    try {
-        meta = JSON.parse(await readFile(metaPath, 'utf-8'));
-    }
-    catch {
-        return true;
-    }
-    // Check age
-    if (Date.now() - meta.scannedAt > SCAN_INTERVAL_MS)
-        return true;
-    // Check git hash (if available)
-    const currentHash = await getGitHash(workDir);
-    if (currentHash && currentHash !== meta.gitHash)
-        return true;
-    return false;
-}
-/**
- * Load stored checksums for quick file-change detection.
- * The agent can use this to skip re-reading files that haven't changed.
- */
-export async function loadChecksums(workDir) {
-    const path = resolve(workDir, CHECKSUMS_FILE);
-    try {
-        if (!existsSync(path))
-            return null;
-        return JSON.parse(await readFile(path, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-// ── Scanner ──────────────────────────────────────────────────────────
-async function getAllFiles(dir, baseDir) {
-    const files = [];
-    let entries;
-    try {
-        entries = await readdir(dir, { withFileTypes: true });
-    }
-    catch {
-        return files;
-    }
-    for (const entry of entries) {
-        if (entry.name.startsWith('.'))
-            continue; // skip hidden
-        if (SKIP_DIRS.has(entry.name))
-            continue;
-        if (SKIP_FILES.has(entry.name))
-            continue;
-        const fullPath = join(dir, entry.name);
-        const relPath = relative(baseDir, fullPath);
-        if (entry.isDirectory()) {
-            const children = await getAllFiles(fullPath, baseDir);
-            files.push(...children);
-        }
-        else if (entry.isFile()) {
-            files.push(relPath);
-        }
-    }
-    return files;
-}
-function buildTree(files) {
-    const tree = {};
-    for (const file of files) {
-        const dir = dirname(file);
-        const name = basename(file);
-        const key = dir === '.' ? 'root' : dir + '/';
-        if (!tree[key])
-            tree[key] = [];
-        let size = 0;
-        try {
-            size = statSync(file).size;
-        }
-        catch { /* ignore */ }
-        const type = classifyFile(name, dir);
-        tree[key].push({
-            name,
-            type,
-            desc: '',
-            size,
-        });
-    }
-    // Sort each directory: dirs first, then files alphabetically
-    for (const key of Object.keys(tree)) {
-        tree[key].sort((a, b) => a.name.localeCompare(b.name));
-    }
-    return tree;
-}
-function getProjectInfo(workDir) {
-    let name = basename(workDir);
-    let version = '0.0.0';
-    try {
-        const pkg = JSON.parse(readFileSync(resolve(workDir, 'package.json'), 'utf-8'));
-        if (pkg.name)
-            name = pkg.name;
-        if (pkg.version)
-            version = pkg.version;
-    }
-    catch { /* use defaults */ }
-    return { name, version };
-}
-async function scanCodebase(workDir) {
-    const codebaseDir = resolve(workDir, CODEBASE_DIR);
-    await mkdir(codebaseDir, { recursive: true });
-    // 1. Get all files
-    const allFiles = await getAllFiles(workDir, workDir);
-    const files = allFiles.sort();
-    // 2. Build tree
-    const tree = buildTree(files);
-    // 3. Summarize source files
-    const summaries = {};
-    for (const file of files) {
-        const summary = await summarizeFile(resolve(workDir, file));
-        if (summary) {
-            summaries[file] = summary;
-        }
-    }
-    // 4. Get project info
-    const { name, version } = getProjectInfo(workDir);
-    // 5. Generate checksums (content-hash tracking for change detection)
-    const gitHash = await getGitHash(workDir);
-    const checksums = {
-        scannedAt: Date.now(),
-        gitHash,
-        files: {},
-    };
-    for (const file of files) {
-        const fullPath = resolve(workDir, file);
-        const hash = hashFile(fullPath);
-        if (hash) {
-            try {
-                const st = statSync(fullPath);
-                checksums.files[file] = { hash, size: st.size, scannedAt: Date.now() };
-            }
-            catch { /* skip unreadable files */ }
-        }
-    }
-    await writeFile(resolve(workDir, CHECKSUMS_FILE), JSON.stringify(checksums, null, 2) + '\n', 'utf-8');
-    // 6. Generate tree.yaml
-    const treeYaml = generateTreeYaml(name, version, tree, summaries);
-    await writeFile(resolve(workDir, TREE_FILE), treeYaml, 'utf-8');
-    // 7. Generate meta.json
-    const meta = {
-        scannedAt: Date.now(),
-        fileCount: files.length,
-        gitHash,
-        workDir,
-        scanner: 'background-v1',
-    };
-    await writeFile(resolve(workDir, META_FILE), JSON.stringify(meta, null, 2) + '\n', 'utf-8');
-    return { fileCount: files.length };
-}
-function generateTreeYaml(name, version, tree, summaries) {
-    const lines = [];
-    lines.push(`# ${name} — Full Codebase Tree (auto-generated)`);
-    lines.push(`# Generated: ${new Date().toISOString().split('T')[0]}`);
-    lines.push('# Updated by background scanner agent before each session.');
-    lines.push('# This file is consumed by the main agent so it doesn\'t need to re-scan.');
-    lines.push('');
-    lines.push('project:');
-    lines.push(`  name: ${name}`);
-    lines.push(`  version: ${version}`);
-    lines.push('  language: typescript');
-    lines.push('  type: terminal-ai-coding-agent');
-    lines.push('');
-    lines.push('tree:');
-    // Sort keys: root first, then alphabetically
-    const keys = Object.keys(tree).sort((a, b) => {
-        if (a === 'root')
-            return -1;
-        if (b === 'root')
-            return 1;
-        return a.localeCompare(b);
-    });
-    for (const key of keys) {
-        const entries = tree[key];
-        const indent = '  ' + (key === 'root' ? '' : '  ');
-        const displayKey = key === 'root' ? 'root:' : `${key}:`;
-        lines.push(`  ${displayKey}`);
-        for (const entry of entries) {
-            const sizeStr = entry.size ? ` (${formatSize(entry.size)})` : '';
-            lines.push(`    - ${entry.name}:`);
-            lines.push(`        type: ${entry.type}`);
-            if (entry.desc) {
-                lines.push(`        desc: "${entry.desc}"`);
-            }
-            else {
-                // Auto-describe from summary if available
-                const filePath = key === 'root' ? entry.name : `${key}${entry.name}`;
-                const summary = summaries[filePath];
-                if (summary) {
-                    lines.push(`        desc: "${escapeYaml(summary.description)}"`);
-                }
-            }
-            if (entry.size) {
-                lines.push(`        size: ${entry.size}`);
-            }
-        }
-    }
-    // Summaries section
-    lines.push('');
-    lines.push('# ── File summaries (for quick agent context) ────────────────────────');
-    lines.push('');
-    lines.push('summaries:');
-    const summaryKeys = Object.keys(summaries).sort();
-    for (const file of summaryKeys) {
-        const s = summaries[file];
-        lines.push(`  "${file}":`);
-        lines.push(`    lines: ${s.lines}`);
-        lines.push(`    exports: [${s.exports.map((e) => `"${e}"`).join(', ')}]`);
-        if (s.key_functions.length > 0) {
-            lines.push(`    key_functions: [${s.key_functions.map((f) => `"${f}"`).join(', ')}]`);
-        }
-        if (s.depends_on.length > 0) {
-            lines.push(`    depends_on: [${s.depends_on.map((d) => `"${d}"`).join(', ')}]`);
-        }
-        lines.push(`    description: |`);
-        lines.push(`      ${s.description}`);
-    }
-    return lines.join('\n') + '\n';
-}
-function escapeYaml(str) {
-    return str.replace(/"/g, '\\"').replace(/\n/g, '\\n');
-}
-function formatSize(bytes) {
-    if (bytes < 1024)
-        return `${bytes}B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)}KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-}
-// ── Public API ───────────────────────────────────────────────────────
-/**
- * Run the background scanner.
- * Checks cache validity first; if stale, re-scans the codebase.
- *
- * @param workDir Working directory to scan
- * @param force Force rescan even if cache is fresh
- * @returns Scan result with file count
- */
-export async function runScanner(workDir, force = false) {
-    if (!force && !(await cacheIsStale(workDir))) {
-        // Cache is fresh — read meta for fileCount
-        try {
-            const meta = JSON.parse(await readFile(resolve(workDir, META_FILE), 'utf-8'));
-            return { fileCount: meta.fileCount, cached: true };
-        }
-        catch {
-            // Meta corrupt, fall through to scan
-        }
-    }
-    const { fileCount } = await scanCodebase(workDir);
-    return { fileCount, cached: false };
-}

package/dist/spinner.d.ts

@@ -1,23 +0,0 @@
-/**
- * Terminal spinner — a lightweight animated indicator shown while the agent
- * is waiting for an API response or processing tool results.
- *
- * Usage:
- *   const spin = createSpinner();
- *   spin.start('Thinking…');
- *   // ... do work ...
- *   spin.update('Running tool…');
- *   // ... more work ...
- *   spin.stop();
- */
-export interface Spinner {
-    /** Start (or restart) the spinner with a status message */
-    start(message: string): void;
-    /** Update the status message without stopping the animation */
-    update(message: string): void;
-    /** Stop and clear the spinner. If message is provided, show it as the final status. */
-    stop(finalMessage?: string): void;
-    /** Whether the spinner is currently running */
-    readonly running: boolean;
-}
-export declare function createSpinner(): Spinner;

package/dist/spinner.js

@@ -1,83 +0,0 @@
-/**
- * Terminal spinner — a lightweight animated indicator shown while the agent
- * is waiting for an API response or processing tool results.
- *
- * Usage:
- *   const spin = createSpinner();
- *   spin.start('Thinking…');
- *   // ... do work ...
- *   spin.update('Running tool…');
- *   // ... more work ...
- *   spin.stop();
- */
-// Spinner frames — classic braille dots
-const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-// Gruvbox colors
-const GRAY = '\x1b[38;2;146;131;116m';
-const GREEN = '\x1b[38;2;184;187;3m';
-const RESET = '\x1b[0m';
-const FRAME_INTERVAL = 80; // ms per frame
-export function createSpinner() {
-    let interval = null;
-    let frameIdx = 0;
-    let currentMessage = '';
-    // Remember the cursor position where the spinner line was drawn.
-    // We use this to overwrite the line cleanly.
-    let lastLineLen = 0;
-    function draw(message) {
-        const frame = FRAMES[frameIdx % FRAMES.length];
-        const line = `  ${GREEN}${frame}${RESET} ${GRAY}${message}${RESET}`;
-        // Clear the previous line first with \r and spaces, then write new line
-        const clear = ' '.repeat(Math.max(0, lastLineLen));
-        process.stderr.write(`\r${clear}\r${line}`);
-        lastLineLen = line.replace(/\x1b\[[0-9;]*m/g, '').length;
-    }
-    function clear() {
-        if (lastLineLen > 0) {
-            process.stderr.write(`\r${' '.repeat(lastLineLen)}\r`);
-            lastLineLen = 0;
-        }
-    }
-    const self = {
-        get running() {
-            return interval !== null;
-        },
-        start(message) {
-            if (interval !== null) {
-                // Already running — just change the message
-                currentMessage = message;
-                draw(message);
-                return;
-            }
-            currentMessage = message;
-            frameIdx = 0;
-            draw(message);
-            interval = setInterval(() => {
-                frameIdx++;
-                draw(currentMessage);
-            }, FRAME_INTERVAL);
-        },
-        update(message) {
-            currentMessage = message;
-            // Next frame tick will pick up the new message
-        },
-        stop(finalMessage) {
-            if (interval !== null) {
-                clearInterval(interval);
-                interval = null;
-            }
-            if (finalMessage) {
-                // Show final status on the spinner line
-                const line = `  ${GREEN}✓${RESET} ${GRAY}${finalMessage}${RESET}`;
-                const clear = ' '.repeat(Math.max(0, lastLineLen));
-                process.stderr.write(`\r${clear}\r${line}\n`);
-            }
-            else {
-                clear();
-            }
-            lastLineLen = 0;
-            currentMessage = '';
-        },
-    };
-    return self;
-}

package/dist/system-prompt.d.ts

@@ -1 +0,0 @@
-export declare const SYSTEM_PROMPT = "You are a coding agent running in a terminal. You help users by reading files, running shell commands, editing code, and writing files. You do NOT introduce yourself, describe your capabilities, or make small talk \u2014 just work.\n\n\u2500\u2500 Critical: Be Extremely Concise \u2500\u2500\n\nThe user pays per token. Wasting tokens is unacceptable.\n  \u2022 Your text responses should be 2-6 lines MAX unless the user explicitly asks for detail.\n  \u2022 Never greet, never say \"Sure!\", \"Here you go!\", \"Let me help you with that!\" \u2014 just do the work.\n  \u2022 Don't explain what you're about to do. Just do it and report the result.\n  \u2022 Don't summarize unless asked. The user can see what happened.\n  \u2022 Skip all pleasantries, acknowledgements, and filler.\n\n\u2500\u2500 Working Memory (Critical for Efficiency) \u2500\u2500\n\nYou have a working memory file at .codebase/state.md that persists across turns.\nUse it to avoid redundant work \u2014 this is your MOST IMPORTANT efficiency tool.\n\n  AT THE START of every turn (before any other action):\n    1. Read .codebase/state.md to recall what you already know\n    2. Read .codebase/tree.yaml if you haven't already (check state.md)\n\n  DURING work:\n    \u2022 After reading a file, update state.md with the file path + summary\n    \u2022 After editing a file, update state.md with what you changed\n    \u2022 Track your current task and progress in state.md\n\n  RULE: Never re-read a file you've already read this session UNLESS:\n    \u2022 You modified it since reading\n    \u2022 The tree.yaml hash changed (indicating external modification)\n    \u2022 You need a specific section you didn't read before (use offset)\n\n\u2500\u2500 Codebase Context \u2500\u2500\n\nA pre-scan of the project is available. Before doing anything else:\n  1. Read .codebase/state.md to check what's already known\n  2. Read .codebase/tree.yaml to understand the project structure\n  3. Read .codebase/meta.json for scan metadata\n  4. Use this knowledge to navigate efficiently \u2014 don't re-scan what's already documented\n\n\u2500\u2500 Your Capabilities \u2500\u2500\n\nYou have access to a set of tools that let you interact with the filesystem:\n\n  bash   Execute shell commands in the working directory. Run scripts, install\n         dependencies, list files, search with grep/find, git operations,\n         compilers, linters, and tests.\n  read   Read file contents. Use offset/limit for large files. Continue with\n         offset until you have the full file.\n  edit   Precise file edits via exact-text replacement. oldText must match\n         exactly once. Merge nearby changes into one edit. Keep oldText as\n         small as possible while still unique.\n  write  Create new files or completely overwrite existing ones. Creates\n         parent directories automatically. For new files or full rewrites only.\n  ls     List directory contents with sizes (dirs first, then files alphabetical).\n  find   Find files by fuzzy name or glob (e.g. \"agentloop\" or \"*.ts\").\n         Skips hidden dirs and node_modules, .git, dist, etc.\n  grep   Search file contents with regex. Returns file paths with line numbers.\n         Skips binary files and files over 500KB.\n\n\u2500\u2500 Parallel Tool Execution \u2500\u2500\n\nYou can call multiple tools simultaneously in a single response when they are\nindependent of each other. This is faster and saves tokens \u2014 use it whenever possible.\n\n  GOOD \u2014 read 3 files in parallel:\n    \u2022 Call read(fileA), read(fileB), read(fileC) all at once\n\n  GOOD \u2014 run independent commands in parallel:\n    \u2022 Call ls(src/), find(\"*.test.ts\"), grep(\"TODO\", \"src/\") all at once\n\n  GOOD \u2014 read a file AND list a directory at the same time:\n    \u2022 Call read(config.ts) + ls(src/) together\n\n  BAD \u2014 these depend on each other, so must be sequential:\n    \u2022 grep then read (grep finds a file, then you read it)\n    \u2022 bash then read (you run a command, then read its output file)\n    \u2022 write then bash (you create a file, then run it)\n\n  Rule of thumb: if tool B's input depends on tool A's output, they must be\n  sequential. Otherwise, batch them together in one response.\n\n\u2500\u2500 Response Style \u2500\u2500\n\nYou are running in a terminal. Use clean plain text \u2014 never markdown.\n  \u2022 No **bold**, no ## headings, no [links](url), no `code spans`\n  \u2022 Use \u2500\u2500 section separators for structure\n  \u2022 Use indentation for lists and code blocks\n  \u2022 Show file paths like this: path/to/file.ts\n  \u2022 Wrap code snippets with 2-space indent, not triple backticks\n  \u2022 Keep responses tight \u2014 skip filler and pleasantries\n\n\u2500\u2500 Rules \u2500\u2500\n\n  1. Think before acting. Reason internally about the best approach.\n  2. Use bash first for exploration (ls, find, grep) before editing.\n  3. Edit precisely \u2014 minimal oldText, unique matches only.\n  4. Merge nearby edits into a single call.\n  5. Write for new files or complete rewrites only.\n  6. Stay safe. Never run rm -rf, force-push to main, etc. without confirmation.\n  7. Work in the current directory. Use relative paths.\n  8. When done, give a short summary (1-3 lines) of what you changed.\n\n\u2500\u2500 Final Output Format \u2500\u2500\n\nYour final message (when all tool calls are complete) MUST be a brief summary:\n\n  \u2500\u2500 Changes Made \u2500\u2500\n  \u2022 file/path.ts \u2014 what you changed (one line)\n  \u2500\u2500\n\nOnly include files you actually modified. Do NOT include:\n  - Markdown formatting, long explanations, or step-by-step walkthroughs\n  - Tool-by-tool recaps of what commands you ran\n  - Pleasantries, filler, or \"let me know if you need anything else\"\n\nKeep it tight. The user sees tool calls live \u2014 they just want the summary.";