agent-nuvira 1.14.0

package/dist/agents/agents/context-gatherer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ContextGathererAgent — Scans the codebase to find files relevant to the user's
+ * goal and execution plan. It reads file contents and stores them as artifacts
+ * in the shared context bus for downstream agents (Writer, Reviewer) to use.
+ *
+ * Rate-limit handling:
+ * - Short waits (<3s): auto-retry silently
+ * - Long waits (>=3s): invokes onRateLimit callback (if available) to let the
+ *   user choose: wait, switch model, skip (falls back to keyword scan), or abort
+ * - Other LLM errors: caught gracefully, falls back to keyword scanning
+ */
+import { Agent, type AgentContext, type AgentResult } from '../agent.js';
+import type { LLMCallFn } from '../agent.js';
+/**
+ * ContextGathererAgent — Discovers and reads relevant files from the codebase.
+ */
+export declare class ContextGathererAgent extends Agent {
+    readonly name = "Context Gatherer";
+    readonly description = "Scans the codebase and identifies relevant files";
+    execute(context: AgentContext, callLLM: LLMCallFn): Promise<AgentResult>;
+    /**
+     * Call identifyRelevantFiles with a retry loop that handles rate-limit errors
+     * via the onRateLimit callback.
+     */
+    private identifyWithRetry;
+    /**
+     * Ask the LLM to identify which files are relevant to the goal.
+     * Non-rate-limit errors are caught internally (falls back to keyword scanning).
+     * Rate-limit errors are re-thrown so identifyWithRetry can handle them.
+     */
+    private identifyRelevantFiles;
+    /**
+     * Extract an array of file paths from the LLM response.
+     */
+    private extractPaths;
+    private tryParseJson;
+    /** Fallback keyword-based file scanning when LLM is unavailable */
+    private scanByKeywords;
+    private walkAndScore;
+    private formatSize;
+}
+//# sourceMappingURL=context-gatherer.d.ts.map

package/dist/agents/agents/context-gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-gatherer.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/context-gatherer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAiB,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAqD7C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,sDAAsD;IAEpE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IA8E9E;;;OAGG;YACW,iBAAiB;IA+F/B;;;;OAIG;YACW,qBAAqB;IAoDnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,YAAY;IAYpB,mEAAmE;IACnE,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,UAAU;CAKnB"}

package/dist/agents/agents/context-gatherer.js

@@ -0,0 +1,366 @@
+/**
+ * ContextGathererAgent — Scans the codebase to find files relevant to the user's
+ * goal and execution plan. It reads file contents and stores them as artifacts
+ * in the shared context bus for downstream agents (Writer, Reviewer) to use.
+ *
+ * Rate-limit handling:
+ * - Short waits (<3s): auto-retry silently
+ * - Long waits (>=3s): invokes onRateLimit callback (if available) to let the
+ *   user choose: wait, switch model, skip (falls back to keyword scan), or abort
+ * - Other LLM errors: caught gracefully, falls back to keyword scanning
+ */
+import { existsSync, readFileSync, statSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { Agent } from '../agent.js';
+import { buildProjectFileTree, truncateTree } from '../utils/file-tree.js';
+import { logger } from '../../utils/logger.js';
+/** File extensions we consider as source code */
+const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.js', '.tsx', '.jsx',
+    '.go', '.py', '.rs', '.rb', '.java', '.kt',
+    '.json', '.yaml', '.yml', '.md', '.toml', '.xml',
+    '.css', '.scss', '.html', '.vue', '.svelte',
+]);
+/** Directories to skip during traversal */
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next',
+    '.cache', 'coverage', '.nyc_output', '__pycache__',
+    '.venv', 'venv', '.env',
+]);
+/** Maximum number of API retry attempts for transient LLM failures (rate limits, timeouts) */
+const MAX_API_RETRIES = 2;
+/** Base delay for exponential backoff in milliseconds (doubles each retry: 5s, 10s) */
+const BASE_RETRY_DELAY_MS = 5000;
+/** Threshold above which we consider a rate-limit wait "long" and prompt the user. */
+const LONG_WAIT_THRESHOLD_MS = 3000;
+// ─── Rate-limit Helpers ────────────────────────────────────────────────────
+function parseRetryAfterHint(errorMessage) {
+    const secondMatch = errorMessage.match(/try again in ([\d.]+)s/i);
+    if (secondMatch) {
+        const seconds = parseFloat(secondMatch[1]);
+        if (!isNaN(seconds) && seconds > 0)
+            return Math.ceil(seconds * 1000);
+    }
+    const msMatch = errorMessage.match(/try again in (\d+)ms/i);
+    if (msMatch) {
+        const ms = parseInt(msMatch[1], 10);
+        if (!isNaN(ms) && ms > 0)
+            return ms;
+    }
+    return null;
+}
+function parseModelName(errorMessage) {
+    const match = errorMessage.match(/model\s+`([^`]+)`|model\s+'([^']+)'|model\s+([^\s]+)/i);
+    return match?.[1] || match?.[2] || match?.[3] || undefined;
+}
+function isRateLimitError(errorMessage) {
+    return /rate\s*limit|429|too many requests|try again in/i.test(errorMessage);
+}
+/**
+ * ContextGathererAgent — Discovers and reads relevant files from the codebase.
+ */
+export class ContextGathererAgent extends Agent {
+    name = 'Context Gatherer';
+    description = 'Scans the codebase and identifies relevant files';
+    async execute(context, callLLM) {
+        try {
+            // 1. Get a broad overview of the project structure
+            const fileTree = await buildProjectFileTree(context.workingDirectory);
+            // 2. Ask the LLM which files are relevant — with retry and rate-limit handling
+            const { paths: relevantPaths, llmError } = await this.identifyWithRetry(context, fileTree, callLLM);
+            // 3. Fallback: if LLM returned nothing or errored, try keyword scanning
+            if (llmError) {
+                logger.debug(`LLM call failed: ${llmError}`);
+            }
+            let effectivePaths = relevantPaths;
+            if (relevantPaths.length === 0) {
+                if (llmError) {
+                    logger.warn(`   LLM error: ${llmError}`);
+                }
+                effectivePaths = this.scanByKeywords(context.goal, context.workingDirectory);
+            }
+            // 4. Read the identified files
+            const artifacts = [];
+            const errors = [];
+            if (llmError && effectivePaths.length > 0) {
+                logger.debug(`Keywords matched ${effectivePaths.length} file(s) after LLM error`);
+            }
+            for (const filePath of effectivePaths) {
+                const absolutePath = join(context.workingDirectory, filePath);
+                if (!existsSync(absolutePath) || !statSync(absolutePath).isFile()) {
+                    errors.push(`File not found: ${filePath}`);
+                    continue;
+                }
+                try {
+                    const content = readFileSync(absolutePath, 'utf-8');
+                    artifacts.push({
+                        path: filePath,
+                        content,
+                        description: `${filePath} (${this.formatSize(content.length)} characters)`,
+                    });
+                }
+                catch {
+                    errors.push(`Could not read: ${filePath}`);
+                }
+            }
+            // 5. Store artifacts in the shared context
+            context.artifacts.push(...artifacts);
+            const details = artifacts.length > 0
+                ? artifacts.map((a) => `  \u{1F4C4} ${a.path}`).join('\n')
+                : undefined;
+            const resultSummary = artifacts.length > 0
+                ? `Gathered ${artifacts.length} file${artifacts.length !== 1 ? 's' : ''}`
+                : `No relevant files found${errors.length > 0 ? ` (${errors.length} errors while scanning)` : ''}`;
+            return {
+                success: true,
+                summary: resultSummary,
+                details,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                summary: 'Context gathering failed',
+                error: msg,
+            };
+        }
+    }
+    /**
+     * Call identifyRelevantFiles with a retry loop that handles rate-limit errors
+     * via the onRateLimit callback.
+     */
+    async identifyWithRetry(context, fileTree, callLLM) {
+        let latestCallLLM = callLLM;
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_API_RETRIES; attempt++) {
+            try {
+                // identifyRelevantFiles re-throws rate-limit errors so we can handle them here
+                const result = await this.identifyRelevantFiles(context.goal, context.taskPlan, fileTree, latestCallLLM);
+                // Success or non-rate-limit error (caught internally by identifyRelevantFiles)
+                return result;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                // ── Rate-limit handling with user prompt ─────────────────────
+                if (isRateLimitError(lastError) && context.onRateLimit) {
+                    const retryAfterMs = parseRetryAfterHint(lastError) || BASE_RETRY_DELAY_MS;
+                    if (retryAfterMs >= LONG_WAIT_THRESHOLD_MS) {
+                        const modelName = parseModelName(lastError);
+                        const action = await context.onRateLimit({
+                            retryAfterMs,
+                            modelName,
+                            agentName: this.name,
+                            errorMessage: lastError.slice(0, 300),
+                        });
+                        if (action.action === 'abort') {
+                            // User wants to abort — return failure
+                            return {
+                                paths: [],
+                                llmError: `Aborted by user: ${lastError}`,
+                            };
+                        }
+                        if (action.action === 'skip') {
+                            // User wants to skip — fall through to keyword scanning
+                            logger.info('Context-gatherer LLM call skipped by user');
+                            return { paths: [], llmError: undefined };
+                        }
+                        if (action.action === 'switch-model') {
+                            // Switch model and retry immediately
+                            logger.info('Switching model for context gathering per user request...');
+                            latestCallLLM = action.callLLM;
+                            await new Promise((resolve) => setTimeout(resolve, 500));
+                            continue;
+                        }
+                        // 'retry': wait and retry
+                        logger.warn(`Context-gatherer rate limited. Waiting ${(retryAfterMs / 1000).toFixed(1)}s as chosen by user...`);
+                        await new Promise((resolve) => setTimeout(resolve, retryAfterMs));
+                        continue;
+                    }
+                    // Short wait: fall through to auto-retry below
+                }
+                // ── Standard retry for transient errors ──────────────────────
+                if (attempt < MAX_API_RETRIES) {
+                    const delayMs = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);
+                    if (isRateLimitError(lastError)) {
+                        logger.warn(`Context-gatherer API error (attempt ${attempt + 1}/${MAX_API_RETRIES + 1}): ` +
+                            `${lastError.slice(0, 200)}. Waiting ${(delayMs / 1000).toFixed(1)}s...`);
+                    }
+                    else {
+                        logger.warn(`Context-gatherer API error (attempt ${attempt + 1}/${MAX_API_RETRIES + 1}): ` +
+                            `${lastError.slice(0, 200)}. Retrying...`);
+                    }
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                    continue;
+                }
+                // All retries exhausted
+                logger.warn(`Context-gatherer LLM unavailable after retries: ${lastError}`);
+                return { paths: [], llmError: lastError };
+            }
+        }
+        // Fallback
+        return { paths: [], llmError: lastError || 'Unknown error' };
+    }
+    /**
+     * Ask the LLM to identify which files are relevant to the goal.
+     * Non-rate-limit errors are caught internally (falls back to keyword scanning).
+     * Rate-limit errors are re-thrown so identifyWithRetry can handle them.
+     */
+    async identifyRelevantFiles(goal, taskPlan, fileTree, callLLM) {
+        const taskDescriptions = taskPlan
+            .filter((s) => s.status !== 'failed')
+            .map((s) => `  - ${s.description}`)
+            .join('\n');
+        // Limit file tree to avoid token overflow on large projects
+        const truncatedTree = truncateTree(fileTree, 80);
+        const prompt = [
+            'You are a codebase navigation expert. Identify files relevant to the task.',
+            '',
+            'Project files:',
+            truncatedTree || '(empty directory)',
+            '',
+            `Goal: ${goal}`,
+            taskDescriptions ? `Plan: ${taskDescriptions}` : '',
+            '',
+            'Return ONLY a valid JSON array of file paths. Example:',
+            '["src/index.ts", "package.json"]',
+            '',
+            'Rules:',
+            '- Only include files shown in the project listing above',
+            '- Include config files (package.json, tsconfig.json) when relevant',
+            '- Max 10 files',
+            '- NO explanation text before or after the JSON',
+        ].filter(Boolean).join('\n');
+        try {
+            const response = await callLLM(prompt, {
+                temperature: 0.1,
+                maxTokens: 1024,
+            });
+            const paths = this.extractPaths(response);
+            return { paths };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Let rate-limit errors propagate so the retry loop can handle them
+            if (isRateLimitError(msg)) {
+                throw err;
+            }
+            // Other errors: gracefully return with error flag (falls back to keyword scanning)
+            return { paths: [], llmError: msg };
+        }
+    }
+    /**
+     * Extract an array of file paths from the LLM response.
+     */
+    extractPaths(response) {
+        const trimmed = response.trim();
+        const fromJson = this.tryParseJson(trimmed);
+        if (fromJson.length > 0)
+            return fromJson;
+        const jsonBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+        if (jsonBlockMatch) {
+            const fromBlock = this.tryParseJson(jsonBlockMatch[1].trim());
+            if (fromBlock.length > 0)
+                return fromBlock;
+        }
+        const arrayMatch = trimmed.match(/\[[\s\S]*?\]/);
+        if (arrayMatch) {
+            const fromArray = this.tryParseJson(arrayMatch[0]);
+            if (fromArray.length > 0)
+                return fromArray;
+        }
+        const lines = trimmed.split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith('`') && !l.startsWith('#'))
+            .map((l) => l.replace(/^[-*\d.\s]+/, '').trim())
+            .filter((l) => l.includes('.') || l.includes('/'))
+            .filter((l) => l.length < 200);
+        if (lines.length > 0) {
+            const validPaths = lines.filter((l) => !l.includes(' ') && !l.includes('```'));
+            if (validPaths.length > 0)
+                return validPaths;
+        }
+        return [];
+    }
+    tryParseJson(text) {
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed)) {
+                return parsed.filter((p) => typeof p === 'string');
+            }
+        }
+        catch {
+            // Not valid JSON
+        }
+        return [];
+    }
+    /** Fallback keyword-based file scanning when LLM is unavailable */
+    scanByKeywords(goal, workingDir) {
+        const stopWords = new Set([
+            'the', 'a', 'an', 'in', 'to', 'for', 'of', 'and', 'or', 'is',
+            'add', 'fix', 'update', 'change', 'remove', 'create', 'implement',
+            'with', 'on', 'at', 'by', 'from', 'as', 'be', 'this', 'that',
+        ]);
+        const keywords = goal
+            .toLowerCase()
+            .split(/[\s,.-]+/)
+            .filter((w) => w.length > 2 && !stopWords.has(w));
+        if (keywords.length === 0)
+            return [];
+        const scored = this.walkAndScore(workingDir, keywords, 0);
+        return scored
+            .sort((a, b) => b.score - a.score)
+            .filter((s) => s.score > 0)
+            .slice(0, 5)
+            .map((s) => s.path);
+    }
+    walkAndScore(dir, keywords, depth, baseDir) {
+        const root = baseDir ?? dir;
+        if (depth > 5)
+            return [];
+        const results = [];
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry.name))
+                continue;
+            const entryPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const subResults = this.walkAndScore(entryPath, keywords, depth + 1, root);
+                results.push(...subResults);
+            }
+            else if (entry.isFile()) {
+                const ext = entry.name.slice(entry.name.lastIndexOf('.'));
+                if (!SOURCE_EXTENSIONS.has(ext))
+                    continue;
+                let score = 0;
+                const lowerName = entry.name.toLowerCase();
+                const lowerPath = entryPath.toLowerCase();
+                for (const kw of keywords) {
+                    if (lowerName.includes(kw))
+                        score += 3;
+                    else if (lowerPath.includes(kw))
+                        score += 1;
+                }
+                if (score > 0) {
+                    const relPath = relative(root, entryPath);
+                    results.push({ path: relPath, score });
+                }
+            }
+        }
+        return results;
+    }
+    formatSize(bytes) {
+        if (bytes < 1024)
+            return String(bytes);
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)}k`;
+        return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+    }
+}
+//# sourceMappingURL=context-gatherer.js.map

package/dist/agents/agents/context-gatherer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-gatherer.js","sourceRoot":"","sources":["../../../src/agents/agents/context-gatherer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAsD,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,iDAAiD;AACjD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IAC5B,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK;IAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM;IAChD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS;CAC5C,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAChD,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa;IAClD,OAAO,EAAE,MAAM,EAAE,MAAM;CACxB,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,uFAAuF;AACvF,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,sFAAsF;AACtF,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAClE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,YAAoB;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC1F,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,gBAAgB,CAAC,YAAoB;IAC5C,OAAO,kDAAkD,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,kDAAkD,CAAC;IAE1E,KAAK,CAAC,OAAO,CAAC,OAAqB,EAAE,OAAkB;QACrD,IAAI,CAAC;YACH,mDAAmD;YACnD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAEtE,+EAA+E;YAC/E,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,iBAAiB,CACrE,OAAO,EACP,QAAQ,EACR,OAAO,CACR,CAAC;YAEF,wEAAwE;YACxE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,cAAc,GAAG,aAAa,CAAC;YACnC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;gBAC3C,CAAC;gBACD,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC/E,CAAC;YAED,+BAA+B;YAC/B,MAAM,SAAS,GAAe,EAAE,CAAC;YACjC,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,IAAI,QAAQ,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,oBAAoB,cAAc,CAAC,MAAM,0BAA0B,CAAC,CAAC;YACpF,CAAC;YAED,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBAC9D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClE,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;oBAC3C,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACpD,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,QAAQ;wBACd,OAAO;wBACP,WAAW,EAAE,GAAG,QAAQ,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc;qBAC3E,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YAED,2CAA2C;YAC3C,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;YAErC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;gBACxC,CAAC,CAAC,YAAY,SAAS,CAAC,MAAM,QAAQ,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzE,CAAC,CAAC,0BAA0B,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAErG,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,aAAa;gBACtB,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,0BAA0B;gBACnC,KAAK,EAAE,GAAG;aACX,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB,CAC7B,OAAqB,EACrB,QAAgB,EAChB,OAAkB;QAElB,IAAI,aAAa,GAAG,OAAO,CAAC;QAC5B,IAAI,SAA6B,CAAC;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,eAAe,EAAE,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,+EAA+E;gBAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAC7C,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,QAAQ,EAChB,QAAQ,EACR,aAAa,CACd,CAAC;gBACF,+EAA+E;gBAC/E,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAE7D,gEAAgE;gBAChE,IAAI,gBAAgB,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACvD,MAAM,YAAY,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,mBAAmB,CAAC;oBAE3E,IAAI,YAAY,IAAI,sBAAsB,EAAE,CAAC;wBAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;wBAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC;4BACvC,YAAY;4BACZ,SAAS;4BACT,SAAS,EAAE,IAAI,CAAC,IAAI;4BACpB,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;yBACtC,CAAC,CAAC;wBAEH,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;4BAC9B,uCAAuC;4BACvC,OAAO;gCACL,KAAK,EAAE,EAAE;gCACT,QAAQ,EAAE,oBAAoB,SAAS,EAAE;6BAC1C,CAAC;wBACJ,CAAC;wBAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;4BAC7B,wDAAwD;4BACxD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;4BACzD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;wBAC5C,CAAC;wBAED,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;4BACrC,qCAAqC;4BACrC,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;4BACzE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;4BAC/B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;4BACzD,SAAS;wBACX,CAAC;wBAED,0BAA0B;wBAC1B,MAAM,CAAC,IAAI,CACT,0CAA0C,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CACnG,CAAC;wBACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;wBAClE,SAAS;oBACX,CAAC;oBACD,+CAA+C;gBACjD,CAAC;gBAED,gEAAgE;gBAChE,IAAI,OAAO,GAAG,eAAe,EAAE,CAAC;oBAC9B,MAAM,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC3D,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;wBAChC,MAAM,CAAC,IAAI,CACT,uCAAuC,OAAO,GAAG,CAAC,IAAI,eAAe,GAAG,CAAC,KAAK;4BAC9E,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CACzE,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,CACT,uCAAuC,OAAO,GAAG,CAAC,IAAI,eAAe,GAAG,CAAC,KAAK;4BAC9E,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,eAAe,CAC1C,CAAC;oBACJ,CAAC;oBACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC7D,SAAS;gBACX,CAAC;gBAED,wBAAwB;gBACxB,MAAM,CAAC,IAAI,CAAC,mDAAmD,SAAS,EAAE,CAAC,CAAC;gBAC5E,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,IAAI,eAAe,EAAE,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,qBAAqB,CACjC,IAAY,EACZ,QAAkC,EAClC,QAAgB,EAChB,OAAkB;QAElB,MAAM,gBAAgB,GAAG,QAAQ;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;aAClC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,4DAA4D;QAC5D,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG;YACb,4EAA4E;YAC5E,EAAE;YACF,gBAAgB;YAChB,aAAa,IAAI,mBAAmB;YACpC,EAAE;YACF,SAAS,IAAI,EAAE;YACf,gBAAgB,CAAC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE;YACnD,EAAE;YACF,wDAAwD;YACxD,kCAAkC;YAClC,EAAE;YACF,QAAQ;YACR,yDAAyD;YACzD,oEAAoE;YACpE,gBAAgB;YAChB,gDAAgD;SACjD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE;gBACrC,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,oEAAoE;YACpE,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,mFAAmF;YACnF,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAgB;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEzC,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACxE,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC7C,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACvE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;aAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;aACjD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAEjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,UAAU,CAAC;QAC/C,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mEAAmE;IAC3D,cAAc,CAAC,IAAY,EAAE,UAAkB;QACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;YACxB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI;YAC5D,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW;YACjE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;SAC7D,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI;aAClB,WAAW,EAAE;aACb,KAAK,CAAC,UAAU,CAAC;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1D,OAAO,MAAM;aACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;aAC1B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,YAAY,CAClB,GAAW,EACX,QAAkB,EAClB,KAAa,EACb,OAAgB;QAEhB,MAAM,IAAI,GAAG,OAAO,IAAI,GAAG,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,OAAO,GAA2C,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAExC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC3E,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAE1C,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;gBAE1C,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;oBAC1B,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAAE,KAAK,IAAI,CAAC,CAAC;yBAClC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAAE,KAAK,IAAI,CAAC,CAAC;gBAC9C,CAAC;gBAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACd,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBAC1C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,GAAG,IAAI;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;YAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QAChE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,CAAC;CACF"}

package/dist/agents/agents/debugger.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DebuggerAgent — Takes test failure output, uses the LLM to diagnose and fix
+ * the issues, re-runs tests, and iterates until all tests pass or max attempts
+ * are exhausted.
+ *
+ * This agent depends on the TesterAgent having run first and stored its results
+ * in the context metadata under `testResult`.
+ *
+ * The debug cycle:
+ * 1. Read test failure output from `context.metadata.testResult`
+ * 2. Call LLM with failure output + source files → get proposed fixes
+ * 3. Apply fixes to the sandbox (the TesterAgent's sandbox path is in testResult)
+ * 4. Re-run tests in the sandbox
+ * 5. If tests pass → done. If not, repeat up to MAX_DEBUG_ITERATIONS.
+ */
+import { Agent, type AgentContext, type AgentResult } from '../agent.js';
+import type { LLMCallFn } from '../agent.js';
+/**
+ * DebuggerAgent — Diagnoses and fixes test failures iteratively.
+ *
+ * Usage in task plans:
+ * ```json
+ * { "id": "step-06-debug", "description": "Fix failing tests", "agentType": "debugger", "dependsOn": ["step-05-test"] }
+ * ```
+ */
+export declare class DebuggerAgent extends Agent {
+    readonly name = "Debugger";
+    readonly description = "Diagnoses test failures and iteratively applies fixes";
+    execute(context: AgentContext, callLLM: LLMCallFn): Promise<AgentResult>;
+    /**
+     * Build the debug prompt with failure output and source files.
+     */
+    private buildPrompt;
+    /**
+     * Parse the LLM response and apply the fixes to files in the sandbox.
+     * Returns a list of file paths that were changed.
+     */
+    private applyFixes;
+    /**
+     * Read fixed files from the sandbox and update the context's fileChanges.
+     * Handles both files already in context.fileChanges AND new files the LLM
+     * may have modified that weren't in the original change set.
+     */
+    private syncChangesToContext;
+    /**
+     * Run the test command in the sandbox.
+     */
+    private runTest;
+    /**
+     * Detect the test command from package.json.
+     */
+    private detectTestCommand;
+    /**
+     * Truncate long output to avoid huge strings.
+     */
+    private truncateOutput;
+}
+//# sourceMappingURL=debugger.d.ts.map

package/dist/agents/agents/debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/debugger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoB7C;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,2DAA2D;IAEzE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAkG9E;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA0BlB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,CAAC,OAAO;IAyBf;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,cAAc;CAIvB"}