evalbuff 0.0.1

package/dist/runners/codex.d.ts

@@ -0,0 +1,8 @@
+import type { Runner, RunnerResult } from './runner';
+export declare class CodexRunner implements Runner {
+    private cwd;
+    private env;
+    constructor(cwd: string, env?: Record<string, string>);
+    run(prompt: string): Promise<RunnerResult>;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/runners/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/runners/codex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAa,MAAM,UAAU,CAAA;AAG/D,qBAAa,WAAY,YAAW,MAAM;IACxC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,GAAG,CAAwB;gBAEvB,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKnD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA6DjD"}

package/dist/runners/codex.js

@@ -0,0 +1,131 @@
+import { execSync } from 'child_process';
+import { Codex } from '@openai/codex-sdk';
+import { captureGitDiff } from '../eval-helpers';
+export class CodexRunner {
+    cwd;
+    env;
+    constructor(cwd, env = {}) {
+        this.cwd = cwd;
+        this.env = env;
+    }
+    async run(prompt) {
+        const steps = [];
+        const baseSha = execSync('git rev-parse HEAD', {
+            cwd: this.cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        const codex = new Codex({
+            apiKey: process.env.OPENAI_API_KEY || this.env.OPENAI_API_KEY,
+        });
+        const thread = codex.startThread({
+            model: 'gpt-5.4',
+            workingDirectory: this.cwd,
+            approvalPolicy: 'never',
+            sandboxMode: 'workspace-write',
+            webSearchMode: 'live',
+        });
+        console.log(`[CodexRunner] Starting thread in ${this.cwd}`);
+        const { events } = await thread.runStreamed(prompt);
+        let usage = null;
+        for await (const event of events) {
+            switch (event.type) {
+                case 'item.completed':
+                    processItem(event.item, steps);
+                    break;
+                case 'turn.completed':
+                    usage = event.usage;
+                    break;
+                case 'turn.failed':
+                    console.error(`[CodexRunner] Turn failed: ${event.error.message}`);
+                    break;
+                case 'error':
+                    console.error(`[CodexRunner] Error: ${event.message}`);
+                    break;
+            }
+        }
+        // Get git diff after Codex has made changes
+        let diff = '';
+        try {
+            diff = captureGitDiff(this.cwd, { baseRef: baseSha });
+        }
+        catch {
+            // Ignore git errors
+        }
+        // Estimate cost from token usage (rough GPT-5.1-codex pricing)
+        const totalCostUsd = usage
+            ? (usage.input_tokens * 2 + usage.output_tokens * 8) / 1_000_000
+            : 0;
+        return {
+            steps,
+            totalCostUsd,
+            diff,
+        };
+    }
+}
+function processItem(item, steps) {
+    switch (item.type) {
+        case 'agent_message':
+            steps.push({ type: 'text', text: item.text });
+            process.stdout.write(item.text);
+            break;
+        case 'command_execution':
+            steps.push({
+                type: 'tool_call',
+                toolName: 'shell',
+                toolCallId: item.id,
+                input: { command: item.command },
+            });
+            if (item.aggregated_output) {
+                steps.push({
+                    type: 'tool_result',
+                    toolName: 'shell',
+                    toolCallId: item.id,
+                    output: [{ type: 'json', value: item.aggregated_output }],
+                });
+            }
+            break;
+        case 'file_change':
+            steps.push({
+                type: 'tool_call',
+                toolName: 'file_change',
+                toolCallId: item.id,
+                input: { changes: item.changes },
+            });
+            break;
+        case 'mcp_tool_call':
+            steps.push({
+                type: 'tool_call',
+                toolName: `mcp:${item.server}:${item.tool}`,
+                toolCallId: item.id,
+                input: item.arguments,
+            });
+            if (item.result || item.error) {
+                steps.push({
+                    type: 'tool_result',
+                    toolName: `mcp:${item.server}:${item.tool}`,
+                    toolCallId: item.id,
+                    output: [{ type: 'json', value: item.result || item.error }],
+                });
+            }
+            break;
+        case 'web_search':
+            steps.push({
+                type: 'tool_call',
+                toolName: 'web_search',
+                toolCallId: item.id,
+                input: { query: item.query },
+            });
+            break;
+        case 'reasoning':
+            // Skip reasoning items, they're internal
+            break;
+        case 'todo_list':
+            // Skip todo lists
+            break;
+        case 'error':
+            console.error(`[CodexRunner] Item error: ${item.message}`);
+            break;
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/runners/codex.js.map

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

package/dist/runners/index.d.ts

@@ -0,0 +1,5 @@
+export { ClaudeRunner } from './claude';
+export { CodebuffRunner } from './codebuff';
+export { CodexRunner } from './codex';
+export type { Runner, RunnerResult } from './runner';
+//# sourceMappingURL=index.d.ts.map

package/dist/runners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runners/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/runners/index.js

@@ -0,0 +1,4 @@
+export { ClaudeRunner } from './claude';
+export { CodebuffRunner } from './codebuff';
+export { CodexRunner } from './codex';
+//# sourceMappingURL=index.js.map

package/dist/runners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runners/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA"}

package/dist/runners/runner.d.ts

@@ -0,0 +1,11 @@
+import type { PrintModeEvent } from '../vendor/print-mode';
+export type AgentStep = PrintModeEvent;
+export type RunnerResult = {
+    steps: AgentStep[];
+    totalCostUsd: number;
+    diff: string;
+};
+export interface Runner {
+    run: (prompt: string) => Promise<RunnerResult>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runners/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runners/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,MAAM,MAAM,SAAS,GAAG,cAAc,CAAA;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CAC/C"}

package/dist/runners/runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.js.map

package/dist/runners/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runners/runner.ts"],"names":[],"mappings":""}

package/dist/test-repo-utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Helper function to manage test repository lifecycle
+ * Sets up a test repo, runs a function with the repo cwd, then cleans up.
+ *
+ * When localRepoPath is provided, uses a local clone (near-instant via hardlinks)
+ * instead of a remote clone (5-30s per clone). This is the single biggest
+ * speedup in evalbuff — with parallelism=5, saves 10-30 remote clones per commit.
+ */
+export declare const withTestRepo: <T>(repoConfig: {
+    repoUrl: string;
+    localRepoPath?: string;
+    parentSha: string;
+    initCommand?: string;
+    env?: Record<string, string>;
+}, fn: (cwd: string) => Promise<T>) => Promise<T>;
+export declare const withTestRepoAndParent: <T>(repoConfig: {
+    repoUrl: string;
+    commitSha: string;
+    initCommand?: string;
+}, fn: (cwd: string, commitSha: string, parentSha: string) => Promise<T>) => Promise<T | null>;
+//# sourceMappingURL=test-repo-utils.d.ts.map

package/dist/test-repo-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-repo-utils.d.ts","sourceRoot":"","sources":["../src/test-repo-utils.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,EAClC,YAAY;IACV,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B,EACD,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,CAAC,CAgDX,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAU,CAAC,EAC3C,YAAY;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,EACD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KACpE,OAAO,CAAC,CAAC,GAAG,IAAI,CA4DlB,CAAA"}

package/dist/test-repo-utils.js

@@ -0,0 +1,109 @@
+import { execSync } from 'child_process';
+import fs from 'fs';
+import * as os from 'os';
+import path from 'path';
+import { getErrorObject } from './vendor/error';
+/**
+ * Helper function to manage test repository lifecycle
+ * Sets up a test repo, runs a function with the repo cwd, then cleans up.
+ *
+ * When localRepoPath is provided, uses a local clone (near-instant via hardlinks)
+ * instead of a remote clone (5-30s per clone). This is the single biggest
+ * speedup in evalbuff — with parallelism=5, saves 10-30 remote clones per commit.
+ */
+export const withTestRepo = async (repoConfig, fn) => {
+    const { repoUrl, localRepoPath, parentSha, initCommand, env } = repoConfig;
+    // Create a temporary directory for the test repo
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codebuff-eval-'));
+    const repoDir = path.join(tempDir, 'repo');
+    try {
+        if (localRepoPath) {
+            // Local clone: uses hardlinks for objects, nearly instant
+            execSync(`git clone --no-checkout "${localRepoPath}" "${repoDir}"`, { stdio: 'ignore' });
+            execSync(`git checkout ${parentSha}`, { cwd: repoDir, stdio: 'ignore' });
+        }
+        else {
+            // Remote clone: slow but works without local repo
+            execSync(`git clone --depth 1 ${repoUrl} ${repoDir}`, { stdio: 'ignore' });
+            execSync(`git fetch --depth 1 origin ${parentSha}`, {
+                cwd: repoDir,
+                stdio: 'ignore',
+            });
+            execSync(`git checkout ${parentSha}`, { cwd: repoDir, stdio: 'ignore' });
+        }
+        if (initCommand) {
+            console.log(`Running init command: ${initCommand}...`);
+            try {
+                execSync(initCommand, {
+                    cwd: repoDir,
+                    stdio: 'ignore',
+                    env: { ...process.env, ...env },
+                });
+            }
+            catch (error) {
+                console.error(`Error running init command: ${getErrorObject(error).message}`);
+            }
+        }
+        // Run the provided function with the repo directory
+        return await fn(repoDir);
+    }
+    finally {
+        // Clean up the temporary directory
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch (error) {
+            console.warn(`Failed to clean up temporary directory: ${error}`);
+        }
+    }
+};
+export const withTestRepoAndParent = async (repoConfig, fn) => {
+    const { repoUrl, commitSha, initCommand } = repoConfig;
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codebuff-eval-'));
+    const repoDir = path.join(tempDir, 'repo');
+    try {
+        execSync(`git clone --depth 1 ${repoUrl} ${repoDir}`, { stdio: 'ignore' });
+        execSync(`git fetch --depth 2 origin ${commitSha}`, {
+            cwd: repoDir,
+            stdio: 'ignore',
+        });
+        execSync(`git checkout ${commitSha}`, { cwd: repoDir, stdio: 'ignore' });
+        let parentSha;
+        try {
+            const parents = execSync(`git log --pretty=%P -n 1 ${commitSha}`, {
+                cwd: repoDir,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            if (!parents) {
+                console.warn(`Commit ${commitSha.slice(0, 8)} has no parent (initial commit)`);
+                return null;
+            }
+            const parentList = parents.split(' ');
+            if (parentList.length > 1) {
+                console.warn(`Commit ${commitSha.slice(0, 8)} is a merge commit (${parentList.length} parents)`);
+                return null;
+            }
+            parentSha = parentList[0];
+        }
+        catch (error) {
+            console.error(`Error getting parent for ${commitSha.slice(0, 8)}:`, error);
+            return null;
+        }
+        execSync(`git checkout ${parentSha}`, { cwd: repoDir, stdio: 'ignore' });
+        if (initCommand) {
+            console.log(`Running init command: ${initCommand}...`);
+            execSync(initCommand, { cwd: repoDir, stdio: 'ignore' });
+        }
+        return await fn(repoDir, commitSha, parentSha);
+    }
+    finally {
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch (error) {
+            console.warn(`Failed to clean up temporary directory: ${error}`);
+        }
+    }
+};
+//# sourceMappingURL=test-repo-utils.js.map

package/dist/test-repo-utils.js.map

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

package/dist/trace-compressor.d.ts

@@ -0,0 +1,130 @@
+/**
+ * trace-compressor.ts — Compress verbose agent traces by extracting large
+ * tool outputs into sidecar files, keeping an inline trace with stable
+ * content-hash pointers and human-readable summaries.
+ *
+ * Supports:
+ *   - JSON-lines (JSONL) streams  — PrintModeEvent lines from the Claude runner
+ *   - Plain-text traces           — free-form text with fenced / tagged blocks
+ *
+ * Sidecar IDs are derived from SHA-256(content), so identical content across
+ * different trace runs always produces the same pointer and only one file.
+ *
+ * Usage (programmatic):
+ *   import { compressTrace, restoreTrace } from './trace-compressor'
+ *
+ *   const { compressed, manifest, stats } = await compressTrace(rawTrace, {
+ *     sidecarDir: '/tmp/run/trace.sidecars',
+ *     threshold: 2048,
+ *     summarize: 'heuristic',
+ *   })
+ *
+ * Usage (CLI):
+ *   bun run src/trace-compressor.ts trace.txt [options]
+ */
+/** A stable pointer embedded in the compressed trace in place of large content. */
+export interface SidecarRef {
+    /** Sentinel so consumers can detect this quickly. */
+    __sidecar__: true;
+    /** 12-char hex SHA-256 prefix of the original content — stable across runs. */
+    sidecarId: string;
+    /** Filename within the sidecar directory, e.g. "sidecar_abc123def456.json" */
+    file: string;
+    /** Original byte count of the extracted content. */
+    byteCount: number;
+    /** One-line human-readable summary of the content. */
+    summary: string;
+    /** How to interpret the sidecar file when restoring: 'text' | 'json' */
+    contentType: SidecarContentType;
+}
+export type SidecarContentType = 'text' | 'json';
+/** One entry in the manifest index written alongside all sidecars. */
+export interface ManifestEntry {
+    sidecarId: string;
+    file: string;
+    byteCount: number;
+    summary: string;
+    contentType: SidecarContentType;
+    /** Human-readable hint about the original location, e.g. "tool_result:Read:line 12" */
+    hint: string;
+}
+/** Written to <sidecarDir>/manifest.json */
+export interface SidecarManifest {
+    version: 1;
+    created: string;
+    threshold: number;
+    format: 'jsonl' | 'text';
+    entries: ManifestEntry[];
+}
+export interface CompressOptions {
+    /** Path to directory where sidecar files are written (created if absent). */
+    sidecarDir: string;
+    /**
+     * Byte length above which content is extracted to a sidecar.
+     * Default: 2 048 (2 KiB).
+     */
+    threshold?: number;
+    /**
+     * How to produce inline summaries:
+     *   'heuristic' (default) — no API call, uses first-line + stats
+     *   'claude'              — calls claude-haiku-4-5 for a one-sentence summary
+     *   'none'                — summary is just the byte count
+     */
+    summarize?: 'heuristic' | 'claude' | 'none';
+    /**
+     * Force the input format.  Default 'auto' detects from content.
+     */
+    format?: 'auto' | 'jsonl' | 'text';
+    /** Anthropic API key when summarize='claude'. Falls back to ANTHROPIC_API_KEY env var. */
+    anthropicApiKey?: string;
+}
+export interface CompressResult {
+    /** The compressed trace text ready to write to disk. */
+    compressed: string;
+    /** Index of all extracted sidecars. */
+    manifest: SidecarManifest;
+    stats: {
+        format: 'jsonl' | 'text';
+        originalBytes: number;
+        compressedBytes: number;
+        sidecarCount: number;
+        reductionPct: number;
+    };
+}
+/**
+ * Auto-detect whether a trace is JSONL or plain text.
+ * Votes based on whether ≥60 % of sampled lines parse as JSON objects.
+ */
+export declare function detectFormat(content: string): 'jsonl' | 'text';
+/** Type-guard: detects a string sidecar pointer, e.g. "[[sidecar:abc123|…]]". */
+export declare function isStrSidecarPointer(v: unknown): v is string;
+/** Type-guard: detects a SidecarRef object embedded in a parsed JSON value. */
+export declare function isSidecarRef(v: unknown): v is SidecarRef;
+/**
+ * Compress a trace string, extracting all large blocks to sidecar files.
+ *
+ * @param traceContent  Raw trace (JSONL or plain text)
+ * @param opts          Options — only `sidecarDir` is required
+ * @returns             Compressed text, manifest metadata, and statistics
+ */
+export declare function compressTrace(traceContent: string, opts: CompressOptions): Promise<CompressResult>;
+/**
+ * Restore a compressed trace to its original form by expanding all sidecar
+ * references.
+ *
+ * @param compressedContent  Text produced by `compressTrace`
+ * @param sidecarDir         Directory containing the sidecar files
+ * @param format             'auto' (default) to detect, or 'jsonl' / 'text'
+ * @returns                  Original trace text
+ */
+export declare function restoreTrace(compressedContent: string, sidecarDir: string, format?: 'auto' | 'jsonl' | 'text'): string;
+/**
+ * Compress a trace and write both the compressed file and sidecars to disk in
+ * one call.  Returns the paths for downstream use.
+ */
+export declare function compressAndSave(tracePath: string, content: string, threshold?: number, summarize?: CompressOptions['summarize']): Promise<{
+    compressedPath: string;
+    sidecarDir: string;
+    stats: CompressResult['stats'];
+}>;
+//# sourceMappingURL=trace-compressor.d.ts.map

package/dist/trace-compressor.d.ts.map

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