agent-nuvira 1.14.0

package/dist/agents/agents/tester.js

@@ -0,0 +1,410 @@
+/**
+ * TesterAgent — Creates a sandboxed test environment, copies the project,
+ * installs dependencies, runs tests, and reports pass/fail results.
+ *
+ * The sandbox is created in a temp directory to avoid modifying the original project.
+ * Tests are run via `npm test` (or a custom command), and full stdout/stderr + exit
+ * code are captured and returned.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, rmSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { tmpdir } from 'node:os';
+import { mkdtempSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { Agent } from '../agent.js';
+import { SandboxManager } from '../../sandbox/manager.js';
+import { detectProjectImage } from '../../sandbox/images.js';
+import { getSandboxConfig } from '../../sandbox/types.js';
+/** Common directories to exclude when copying to the sandbox */
+const EXCLUDE_DIRS = ['node_modules', '.git', 'dist', '.next', 'coverage', '.cache'];
+/** Default test command */
+const DEFAULT_TEST_COMMAND = 'npm test 2>&1';
+/** Maximum sandbox age before cleanup (30 minutes) */
+const SANDBOX_MAX_AGE_MS = 30 * 60 * 1000;
+/** Track sandbox directories for cleanup */
+const activeSandboxes = [];
+/**
+ * Clean up any sandbox directories on process exit.
+ * This prevents temp directory accumulation.
+ */
+function registerCleanup() {
+    const cleanup = () => {
+        for (const dir of activeSandboxes) {
+            try {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+    };
+    process.on('exit', cleanup);
+    process.on('SIGINT', () => { cleanup(); process.exit(1); });
+    process.on('SIGTERM', cleanup);
+}
+// Register cleanup once
+let cleanupRegistered = false;
+function ensureCleanupRegistered() {
+    if (!cleanupRegistered) {
+        registerCleanup();
+        cleanupRegistered = true;
+    }
+}
+/**
+ * TesterAgent — Sandboxed test runner.
+ *
+ * Usage in task plans:
+ * ```json
+ * { "id": "step-05-test", "description": "Run tests to verify the changes", "agentType": "tester", "dependsOn": ["step-04-write"] }
+ * ```
+ */
+export class TesterAgent extends Agent {
+    name = 'Tester';
+    description = 'Runs tests in a sandboxed environment';
+    /**
+     * Execute tests in a sandboxed copy of the project.
+     *
+     * Steps:
+     * 1. Create a temp directory
+     * 2. Copy project files (excluding node_modules, .git, etc.)
+     * 3. Run `npm install` in the sandbox
+     * 4. Run `npm test` in the sandbox
+     * 5. Parse and return the results
+     */
+    async execute(context, _callLLM) {
+        ensureCleanupRegistered();
+        // Check if Docker sandbox should be used
+        // Skip if we already tried Docker and it was unavailable
+        const triedDocker = context.metadata._dockerTried === true;
+        const useDocker = !triedDocker && (context.metadata.useDockerSandbox === true ||
+            getSandboxConfig().enabled === true);
+        if (useDocker) {
+            return this.executeWithDocker(context, _callLLM);
+        }
+        let sandboxPath = '';
+        try {
+            // 1. Detect test command from package.json
+            const testCommand = this.detectTestCommand(context.workingDirectory);
+            // 2. Create sandbox
+            sandboxPath = mkdtempSync(join(tmpdir(), 'buff-sandbox-'));
+            activeSandboxes.push(sandboxPath);
+            if (context.metadata.verboseLogging) {
+                // verbose logging enabled
+            }
+            // 3. Copy project files to sandbox
+            this.copyProject(context.workingDirectory, sandboxPath);
+            // 4. Apply file changes from context to the sandbox
+            this.applyChangesToSandbox(sandboxPath, context.fileChanges);
+            // 5. Install dependencies
+            const installOutput = this.runInstall(sandboxPath);
+            // 6. Run tests
+            const testResult = this.runTests(sandboxPath, testCommand);
+            // 7. Parse test results
+            const parsed = this.parseTestOutput(testResult.output);
+            // 8. Store test result in context metadata for other agents
+            context.metadata['testResult'] = {
+                success: testResult.success,
+                output: testResult.output,
+                exitCode: testResult.exitCode,
+                sandboxPath,
+                ...parsed,
+            };
+            // 9. Build summary
+            const summaryLines = [];
+            if (parsed.total !== undefined) {
+                summaryLines.push(`${parsed.passed}/${parsed.total} tests passed`);
+            }
+            summaryLines.push(testResult.success ? '✅ All tests passed' : `❌ Tests failed (exit code ${testResult.exitCode})`);
+            const details = testResult.success
+                ? undefined
+                : `Test output:\n${this.truncateOutput(testResult.output, 2000)}`;
+            return {
+                success: testResult.success,
+                summary: summaryLines.join(' — '),
+                details,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                summary: 'Test execution failed',
+                error: msg,
+            };
+        }
+    }
+    /**
+     * Execute tests inside a Docker sandbox container.
+     * Falls back to filesystem sandbox if Docker is not available.
+     */
+    async executeWithDocker(context, callLLM) {
+        const sandboxManager = new SandboxManager();
+        let containerId = '';
+        try {
+            // Check Docker availability
+            const dockerAvailable = await sandboxManager.isDockerAvailable();
+            if (!dockerAvailable) {
+                // Fall back to filesystem sandbox — prevent infinite loop
+                // by temporarily disabling the Docker sandbox flag
+                if (context.metadata.verboseLogging) {
+                    // Docker not available — falling back to filesystem sandbox
+                }
+                // Mark that we tried Docker to prevent infinite loop via config
+                context.metadata._dockerTried = true;
+                return this.execute(context, callLLM);
+            }
+            // Detect the right image for the project
+            const image = detectProjectImage(context.workingDirectory);
+            if (context.metadata.verboseLogging) {
+                // verbose logging enabled
+            }
+            // Create a Docker container for the sandbox
+            containerId = await sandboxManager.createContainer(image.image, {
+                memoryLimit: '1g',
+                cpuLimit: 1,
+                timeoutMs: 300_000,
+                networkAccess: false,
+            });
+            // Copy project files to the container
+            await sandboxManager.copyProjectToContainer(containerId, context.workingDirectory);
+            // Apply file changes from context to the container via heredoc
+            for (const change of context.fileChanges) {
+                if (change.status === 'deleted' || !change.newContent)
+                    continue;
+                // Use a heredoc to write files with proper newline handling
+                const dir = `$(dirname "${change.path}")`;
+                await sandboxManager.runCommand(containerId, `mkdir -p ${dir} && cat > "${change.path}" << 'BUFFEOF'
+${change.newContent}
+BUFFEOF`, 30_000);
+            }
+            // Install dependencies inside the container
+            await sandboxManager.runCommand(containerId, image.installCommand || 'npm install', 120_000);
+            // Run tests inside the container
+            const testCommand = this.detectTestCommand(context.workingDirectory);
+            const testResult = await sandboxManager.runCommand(containerId, testCommand, 180_000);
+            // Parse test results
+            const parsed = this.parseTestOutput(testResult.stdout);
+            // Store test result in context metadata
+            const output = testResult.stdout + (testResult.stderr ? '\n' + testResult.stderr : '');
+            context.metadata['testResult'] = {
+                success: testResult.success,
+                output,
+                exitCode: testResult.exitCode,
+                sandboxPath: `docker:${containerId.slice(0, 12)}`,
+                ...parsed,
+            };
+            // Build summary
+            const summaryLines = [];
+            if (parsed.total !== undefined) {
+                summaryLines.push(`${parsed.passed}/${parsed.total} tests passed`);
+            }
+            summaryLines.push(testResult.success ? '✅ All tests passed (Docker)' : `❌ Tests failed (exit code ${testResult.exitCode})`);
+            // Clean up the container
+            await sandboxManager.destroyContainer(containerId).catch(() => { });
+            return {
+                success: testResult.success,
+                summary: summaryLines.join(' — '),
+                details: testResult.success ? undefined : `Test output:\n${this.truncateOutput(output, 2000)}`,
+            };
+        }
+        catch (err) {
+            // Clean up on error
+            if (containerId) {
+                await sandboxManager.destroyContainer(containerId).catch(() => { });
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                summary: 'Docker sandbox test execution failed',
+                error: msg,
+            };
+        }
+    }
+    /**
+     * Detect the test command from package.json scripts.
+     * Falls back to the default if not found.
+     */
+    detectTestCommand(workingDir) {
+        try {
+            const pkgPath = join(workingDir, 'package.json');
+            if (existsSync(pkgPath)) {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (pkg.scripts?.test) {
+                    return `npm run test 2>&1`;
+                }
+            }
+        }
+        catch {
+            // Fall through
+        }
+        return DEFAULT_TEST_COMMAND;
+    }
+    /**
+     * Copy project files to the sandbox directory, excluding large/generated dirs.
+     */
+    copyProject(sourceDir, targetDir) {
+        const entries = this.getDirectoryEntries(sourceDir);
+        for (const entry of entries) {
+            const srcPath = join(sourceDir, entry);
+            const tgtPath = join(targetDir, entry);
+            try {
+                if (entry.startsWith('.'))
+                    continue; // Skip hidden files
+                if (EXCLUDE_DIRS.includes(entry))
+                    continue; // Skip excluded dirs
+                if (existsSync(srcPath)) {
+                    cpSync(srcPath, tgtPath, { recursive: true, force: true });
+                }
+            }
+            catch {
+                // Skip files we can't copy
+            }
+        }
+    }
+    /**
+     * Get sorted directory entries to ensure deterministic copy order.
+     */
+    getDirectoryEntries(dir) {
+        try {
+            return readdirSync(dir).sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Apply the file changes from the execution context to the sandbox.
+     */
+    applyChangesToSandbox(sandboxPath, changes) {
+        for (const change of changes) {
+            if (change.status === 'deleted')
+                continue;
+            if (!change.newContent)
+                continue;
+            const filePath = join(sandboxPath, change.path);
+            const dir = dirname(filePath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(filePath, change.newContent, 'utf-8');
+        }
+    }
+    /**
+     * Run npm install in the sandbox.
+     */
+    runInstall(sandboxPath) {
+        try {
+            return execSync('npm install --prefer-offline --no-audit --no-fund 2>&1', {
+                cwd: sandboxPath,
+                timeout: 120_000, // 2 minutes
+                stdio: 'pipe',
+                encoding: 'utf-8',
+            });
+        }
+        catch (err) {
+            const output = err instanceof Error ? err.message : String(err);
+            // npm install warnings are normal — only throw on critical errors
+            return output;
+        }
+    }
+    /**
+     * Run the test command and capture output.
+     */
+    runTests(sandboxPath, command) {
+        try {
+            const output = execSync(command, {
+                cwd: sandboxPath,
+                timeout: 180_000, // 3 minutes
+                stdio: 'pipe',
+                encoding: 'utf-8',
+            });
+            return {
+                success: true,
+                output,
+                exitCode: 0,
+                sandboxPath,
+            };
+        }
+        catch (err) {
+            const error = err;
+            const output = [
+                error.stdout || '',
+                error.stderr || '',
+                error.message || '',
+            ].filter(Boolean).join('\n');
+            return {
+                success: false,
+                output,
+                exitCode: error.status ?? 1,
+                sandboxPath,
+            };
+        }
+    }
+    /**
+     * Parse test output to extract pass/fail/total counts.
+     * Supports common test runners: vitest, jest, mocha, etc.
+     */
+    parseTestOutput(output) {
+        // Try vitest format: "Tests  1 failed | 3 passed (4)"
+        const vitestMatch = output.match(/Tests\s+(?:(?:(\d+)\s+failed)\s*)?(?:\|?\s*)?(?:(\d+)\s+passed)?\s*\((\d+)\)/);
+        if (vitestMatch) {
+            return {
+                failed: vitestMatch[1] ? parseInt(vitestMatch[1], 10) : 0,
+                passed: vitestMatch[2] ? parseInt(vitestMatch[2], 10) : 0,
+                total: parseInt(vitestMatch[3], 10),
+            };
+        }
+        // Try jest format: "Tests: 1 failed, 3 passed, 4 total"
+        const jestMatch = output.match(/Tests:\s*(?:(\d+)\s+failed,?\s*)?(?:(\d+)\s+passed,?\s*)?(\d+)\s+total/);
+        if (jestMatch) {
+            return {
+                failed: jestMatch[1] ? parseInt(jestMatch[1], 10) : 0,
+                passed: jestMatch[2] ? parseInt(jestMatch[2], 10) : 0,
+                total: parseInt(jestMatch[3], 10),
+            };
+        }
+        // Try generic: "X passing, Y failing"
+        const genericMatch = output.match(/(\d+)\s+passing,?\s*(?:(\d+)\s+failing)?/);
+        if (genericMatch) {
+            return {
+                passed: parseInt(genericMatch[1], 10),
+                failed: genericMatch[2] ? parseInt(genericMatch[2], 10) : 0,
+                total: (genericMatch[2] ? parseInt(genericMatch[1], 10) + parseInt(genericMatch[2], 10) : parseInt(genericMatch[1], 10)),
+            };
+        }
+        // Count lines with ✗, ✓, PASS, FAIL markers as a rough estimate
+        const failLines = (output.match(/[✗❌]|FAIL|failed/g) || []).length;
+        const passLines = (output.match(/[✓✅]|PASS|passed/g) || []).length;
+        if (passLines > 0 || failLines > 0) {
+            return {
+                passed: passLines,
+                failed: failLines,
+                total: passLines + failLines,
+            };
+        }
+        return {};
+    }
+    /**
+     * Truncate long output to avoid huge result strings.
+     */
+    truncateOutput(output, maxLength) {
+        if (output.length <= maxLength)
+            return output;
+        return output.slice(0, maxLength) + '\n... (output truncated)';
+    }
+}
+/**
+ * Clean up a specific sandbox directory.
+ */
+export function cleanupSandbox(sandboxPath) {
+    try {
+        rmSync(sandboxPath, { recursive: true, force: true });
+        const idx = activeSandboxes.indexOf(sandboxPath);
+        if (idx >= 0)
+            activeSandboxes.splice(idx, 1);
+    }
+    catch {
+        // Best-effort
+    }
+}
+//# sourceMappingURL=tester.js.map

package/dist/agents/agents/tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.js","sourceRoot":"","sources":["../../../src/agents/agents/tester.ts"],"names":[],"mappings":"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"}

package/dist/agents/agents/writer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WriterAgent — Proposes code changes based on the task plan and gathered context.
+ *
+ * For each "writer" step in the execution plan, this agent:
+ * 1. Reads the relevant source files (from artifacts in the context bus)
+ * 2. Generates modified versions using the LLM
+ * 3. Stores FileChange objects in the context bus for the orchestrator to apply
+ *
+ * The agent does NOT write to disk — it only proposes changes.
+ * The orchestrator decides whether to apply them (based on dry-run mode).
+ */
+import { Agent, type AgentContext, type AgentResult, type LLMCallFn } from '../agent.js';
+/**
+ * WriterAgent — Proposes code changes by reading files, generating new versions
+ * via the LLM, and storing FileChange objects in the shared context.
+ * Does NOT write to disk directly; the orchestrator handles that.
+ *
+ * Retry strategy:
+ * 1. Rate-limit (429) errors with LONG wait (>3s): invokes onRateLimit callback
+ *    (if available) to let the user choose: wait, switch model, skip, or abort.
+ * 2. Rate-limit errors with SHORT wait (<=3s): auto-retry with smart delay.
+ * 3. Other transient errors (timeouts, network): auto-retry with backoff.
+ * 4. Empty parse results (format issue): retry once with stricter prompt.
+ */
+export declare class WriterAgent extends Agent {
+    readonly name = "Writer";
+    readonly description = "Generates code changes based on the plan and context";
+    execute(context: AgentContext, callLLM: LLMCallFn): Promise<AgentResult>;
+    /**
+     * Perform a single write attempt.
+     * Optionally uses a stricter retry prompt.
+     */
+    private attemptWrite;
+    /**
+     * Build the prompt for the writer agent from the shared context.
+     * Limits the number of files sent to avoid token budget issues.
+     * When isRetry is true, uses a more explicit prompt.
+     */
+    private buildPrompt;
+    /**
+     * Parse the LLM response to extract file changes.
+     */
+    private parseFileChanges;
+    /**
+     * Select files within the given character budget.
+     * Prioritizes smaller files first so the LLM sees as much complete context as possible.
+     */
+    private selectFilesWithinBudget;
+    private addFileChange;
+}
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/agents/agents/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AA8G1G;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,0DAA0D;IAExE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAwH9E;;;OAGG;YACW,YAAY;IAiE1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA6BnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAoC/B,OAAO,CAAC,aAAa;CA0BtB"}