chivgent 0.12.0 → 0.13.0

package/dist/evals/graders.js

@@ -0,0 +1,175 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+const pass = { passed: true, reason: "" };
+function fail(reason) {
+    return { passed: false, reason };
+}
+function requireString(spec, field) {
+    const value = spec[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${spec.type}: "${field}" must be a non-empty string.`);
+    }
+    return value;
+}
+async function readWorkspaceFile(workspace, relativePath) {
+    try {
+        return await readFile(path.join(workspace, relativePath), "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Tool names that produced a result, in call order, errors included. */
+function toolCalls(events) {
+    return events
+        .filter((event) => event.type === "tool_execution_end")
+        .map((event) => event.toolName);
+}
+function successfulToolCalls(events) {
+    return events
+        .filter((event) => event.type === "tool_execution_end" &&
+        event.isError === false)
+        .map((event) => event.toolName);
+}
+const factories = {
+    "file-contains": (spec) => {
+        const file = requireString(spec, "path");
+        const text = requireString(spec, "text");
+        return async ({ workspace }) => {
+            const contents = await readWorkspaceFile(workspace, file);
+            if (contents === undefined) {
+                return fail(`${file} does not exist`);
+            }
+            return contents.includes(text)
+                ? pass
+                : fail(`${file} does not contain ${JSON.stringify(text)}`);
+        };
+    },
+    "file-excludes": (spec) => {
+        const file = requireString(spec, "path");
+        const text = requireString(spec, "text");
+        return async ({ workspace }) => {
+            const contents = await readWorkspaceFile(workspace, file);
+            if (contents === undefined) {
+                return fail(`${file} does not exist`);
+            }
+            if (!contents.includes(text)) {
+                return pass;
+            }
+            // Naming the line makes the failure actionable without opening the file.
+            const line = contents.slice(0, contents.indexOf(text)).split("\n").length;
+            return fail(`${file} still contains ${JSON.stringify(text)} at line ${line}`);
+        };
+    },
+    "file-exists": (spec) => {
+        const file = requireString(spec, "path");
+        return async ({ workspace }) => {
+            try {
+                await stat(path.join(workspace, file));
+                return pass;
+            }
+            catch {
+                return fail(`${file} was not created`);
+            }
+        };
+    },
+    "file-absent": (spec) => {
+        const file = requireString(spec, "path");
+        return async ({ workspace }) => {
+            try {
+                await stat(path.join(workspace, file));
+                return fail(`${file} still exists`);
+            }
+            catch {
+                return pass;
+            }
+        };
+    },
+    "file-equals": (spec) => {
+        const file = requireString(spec, "path");
+        const text = requireString(spec, "text");
+        return async ({ workspace }) => {
+            const contents = await readWorkspaceFile(workspace, file);
+            if (contents === undefined) {
+                return fail(`${file} does not exist`);
+            }
+            return contents === text
+                ? pass
+                : fail(`${file} does not match the expected contents byte for byte`);
+        };
+    },
+    "used-tool": (spec) => {
+        const name = requireString(spec, "name");
+        return async ({ events }) => {
+            const used = toolCalls(events);
+            return used.includes(name)
+                ? pass
+                : fail(`never called ${name}; called ${used.length === 0 ? "nothing" : [...new Set(used)].join(", ")}`);
+        };
+    },
+    "not-used-tool": (spec) => {
+        const name = requireString(spec, "name");
+        return async ({ events }) => {
+            const used = toolCalls(events);
+            const count = used.filter((tool) => tool === name).length;
+            return count === 0
+                ? pass
+                : fail(`called ${name} ${count} time(s), which this task forbids`);
+        };
+    },
+    "tool-succeeded": (spec) => {
+        const name = requireString(spec, "name");
+        return async ({ events }) => {
+            return successfulToolCalls(events).includes(name)
+                ? pass
+                : fail(`${name} never returned a successful result`);
+        };
+    },
+    "answer-matches": (spec) => {
+        const pattern = requireString(spec, "pattern");
+        const flags = typeof spec.flags === "string" ? spec.flags : "i";
+        const expression = new RegExp(pattern, flags);
+        return async ({ finalAnswer }) => {
+            return expression.test(finalAnswer)
+                ? pass
+                : fail(`the answer did not match /${pattern}/${flags}: ${JSON.stringify(finalAnswer.slice(0, 120))}`);
+        };
+    },
+    "answer-excludes": (spec) => {
+        const pattern = requireString(spec, "pattern");
+        const flags = typeof spec.flags === "string" ? spec.flags : "i";
+        const expression = new RegExp(pattern, flags);
+        return async ({ finalAnswer }) => {
+            return expression.test(finalAnswer)
+                ? fail(`the answer matched /${pattern}/${flags}, which this task forbids`)
+                : pass;
+        };
+    },
+    "max-turns-under": (spec) => {
+        const limit = spec.turns;
+        if (!Number.isSafeInteger(limit) || limit < 1) {
+            throw new Error("max-turns-under: \"turns\" must be a positive integer.");
+        }
+        return async ({ turnCount }) => {
+            return turnCount <= limit
+                ? pass
+                : fail(`took ${turnCount} turns, over the limit of ${limit}`);
+        };
+    },
+};
+export const GRADER_TYPES = Object.keys(factories);
+export function createGrader(spec) {
+    const factory = factories[spec.type];
+    if (factory === undefined) {
+        throw new Error(`Unknown grader type "${spec.type}". Known types: ${GRADER_TYPES.join(", ")}.`);
+    }
+    return factory(spec);
+}
+export function describeGrader(spec) {
+    const detail = Object.entries(spec)
+        .filter(([key]) => key !== "type")
+        .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+        .join(" ");
+    return detail.length === 0 ? spec.type : `${spec.type} ${detail}`;
+}
+//# sourceMappingURL=graders.js.map

package/dist/evals/graders.js.map

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

package/dist/evals/parse-args.d.ts

@@ -0,0 +1,18 @@
+import type { Capability } from "./task.js";
+/**
+ * Argument parsing lives apart from the entry point.
+ *
+ * cli.ts runs main() when imported, so anything that wants to test the parsing
+ * would start an eval run just by importing it.
+ */
+export interface EvalOptions {
+    readonly tasks: readonly string[];
+    readonly attempts?: number;
+    readonly directory: string;
+    readonly jsonPath?: string;
+    readonly capabilities: readonly Capability[];
+    readonly providerArgs: readonly string[];
+    readonly help: boolean;
+}
+export declare function parseEvalArgs(argv: readonly string[]): EvalOptions;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/evals/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../src/evals/parse-args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CA4DlE"}

package/dist/evals/parse-args.js

@@ -0,0 +1,67 @@
+export function parseEvalArgs(argv) {
+    const tasks = [];
+    const capabilities = [];
+    const providerArgs = [];
+    let attempts;
+    let directory = "evals";
+    let jsonPath;
+    let help = false;
+    const value = (index, option) => {
+        const next = argv[index + 1];
+        if (next === undefined || next.startsWith("-")) {
+            throw new TypeError(`${option} requires a value.`);
+        }
+        return next;
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument === "--help" || argument === "-h") {
+            help = true;
+        }
+        else if (argument === "--task") {
+            tasks.push(value(index, "--task"));
+            index += 1;
+        }
+        else if (argument === "--attempts") {
+            const parsed = Number(value(index, "--attempts"));
+            if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 50) {
+                throw new TypeError("--attempts must be an integer from 1 to 50.");
+            }
+            attempts = parsed;
+            index += 1;
+        }
+        else if (argument === "--dir") {
+            directory = value(index, "--dir");
+            index += 1;
+        }
+        else if (argument === "--json") {
+            jsonPath = value(index, "--json");
+            index += 1;
+        }
+        else if (argument === "--allow-writes") {
+            capabilities.push("writes");
+        }
+        else if (argument === "--allow-shell") {
+            capabilities.push("shell");
+        }
+        else if (argument === "--provider" || argument === "--model") {
+            // Passed through so the Provider registry resolves them exactly as the
+            // real CLI does, including environment fallbacks.
+            providerArgs.push(argument, value(index, argument));
+            index += 1;
+        }
+        else if (argument !== undefined) {
+            throw new TypeError(`Unknown option: ${argument}`);
+        }
+    }
+    return {
+        tasks,
+        ...(attempts === undefined ? {} : { attempts }),
+        directory,
+        ...(jsonPath === undefined ? {} : { jsonPath }),
+        capabilities,
+        providerArgs,
+        help,
+    };
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/evals/parse-args.js.map

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

package/dist/evals/report.d.ts

@@ -0,0 +1,18 @@
+import type { TaskResult } from "./runner.js";
+export interface ReportMeta {
+    readonly provider: string;
+    readonly model: string;
+    readonly version: string;
+    readonly startedAt: string;
+}
+/**
+ * The table always shows the sample size next to the score.
+ *
+ * "4/5" and "80%" carry different information from "passed": a rate without its
+ * denominator invites reading one lucky attempt as a result.
+ */
+export declare function formatTable(results: readonly TaskResult[]): string;
+/** Failures, grouped so the same reason across attempts is one line. */
+export declare function formatFailures(results: readonly TaskResult[]): string;
+export declare function toJsonReport(results: readonly TaskResult[], meta: ReportMeta): object;
+//# sourceMappingURL=report.d.ts.map

package/dist/evals/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/evals/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAwBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAqClE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAgBrE;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,UAAU,GACf,MAAM,CA4BR"}

package/dist/evals/report.js

@@ -0,0 +1,103 @@
+function median(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? Math.round(((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2)
+        : (sorted[middle] ?? 0);
+}
+function mean(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    return values.reduce((total, value) => total + value, 0) / values.length;
+}
+function pad(value, width) {
+    return value.length >= width ? value : value + " ".repeat(width - value.length);
+}
+/**
+ * The table always shows the sample size next to the score.
+ *
+ * "4/5" and "80%" carry different information from "passed": a rate without its
+ * denominator invites reading one lucky attempt as a result.
+ */
+export function formatTable(results) {
+    if (results.length === 0) {
+        return "No tasks ran.\n";
+    }
+    const rows = results.map((result) => ({
+        task: result.task,
+        pass: `${result.passed}/${result.total}`,
+        turns: mean(result.attempts.map((attempt) => attempt.turnCount)).toFixed(1),
+        tools: [
+            ...new Set(result.attempts.flatMap((attempt) => attempt.toolsUsed)),
+        ].join(","),
+        time: `${(median(result.attempts.map((attempt) => attempt.durationMs)) / 1000).toFixed(1)}s`,
+    }));
+    const widths = {
+        task: Math.max(4, ...rows.map((row) => row.task.length)),
+        pass: Math.max(4, ...rows.map((row) => row.pass.length)),
+        turns: Math.max(5, ...rows.map((row) => row.turns.length)),
+        tools: Math.max(5, ...rows.map((row) => row.tools.length)),
+    };
+    const lines = [
+        `${pad("task", widths.task)}  ${pad("pass", widths.pass)}  ${pad("turns", widths.turns)}  ${pad("tools", widths.tools)}  p50`,
+    ];
+    for (const row of rows) {
+        lines.push(`${pad(row.task, widths.task)}  ${pad(row.pass, widths.pass)}  ${pad(row.turns, widths.turns)}  ${pad(row.tools, widths.tools)}  ${row.time}`);
+    }
+    const passed = results.reduce((total, result) => total + result.passed, 0);
+    const total = results.reduce((sum, result) => sum + result.total, 0);
+    const percent = total === 0 ? 0 : Math.round((passed / total) * 100);
+    lines.push("");
+    lines.push(`overall  ${passed}/${total} (${percent}%)`);
+    return `${lines.join("\n")}\n`;
+}
+/** Failures, grouped so the same reason across attempts is one line. */
+export function formatFailures(results) {
+    const lines = [];
+    for (const result of results) {
+        const byReason = new Map();
+        for (const attempt of result.attempts) {
+            for (const failure of attempt.failures) {
+                const attempts = byReason.get(failure) ?? [];
+                attempts.push(attempt.attempt);
+                byReason.set(failure, attempts);
+            }
+        }
+        for (const [reason, attempts] of byReason) {
+            lines.push(`${result.task} attempt ${attempts.join(",")}: ${reason}`);
+        }
+    }
+    return lines.length === 0 ? "" : `${lines.join("\n")}\n`;
+}
+export function toJsonReport(results, meta) {
+    return {
+        schemaVersion: 1,
+        ...meta,
+        tasks: results.map((result) => ({
+            name: result.task,
+            passed: result.passed,
+            total: result.total,
+            passRate: result.total === 0 ? 0 : result.passed / result.total,
+            meanTurns: mean(result.attempts.map((attempt) => attempt.turnCount)),
+            medianDurationMs: median(result.attempts.map((attempt) => attempt.durationMs)),
+            attempts: result.attempts.map((attempt) => ({
+                attempt: attempt.attempt,
+                passed: attempt.passed,
+                status: attempt.status,
+                turnCount: attempt.turnCount,
+                durationMs: attempt.durationMs,
+                toolsUsed: attempt.toolsUsed,
+                failures: attempt.failures,
+            })),
+        })),
+        overall: {
+            passed: results.reduce((total, result) => total + result.passed, 0),
+            total: results.reduce((sum, result) => sum + result.total, 0),
+        },
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/evals/report.js.map

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

package/dist/evals/runner.d.ts

@@ -0,0 +1,43 @@
+import type { LLMClient } from "../llm.js";
+import { type AttemptFacts } from "./graders.js";
+import type { Capability, Task } from "./task.js";
+export interface AttemptResult {
+    readonly attempt: number;
+    readonly passed: boolean;
+    readonly status: AttemptFacts["status"];
+    readonly turnCount: number;
+    readonly durationMs: number;
+    readonly toolsUsed: readonly string[];
+    /** One entry per failed grader, in task order. */
+    readonly failures: readonly string[];
+}
+export interface TaskResult {
+    readonly task: string;
+    readonly attempts: readonly AttemptResult[];
+    readonly passed: number;
+    readonly total: number;
+}
+export interface RunnerOptions {
+    /** Built per attempt, so a test can hand out a fresh fake each time. */
+    readonly createClient: () => LLMClient;
+    readonly systemPrompt: string;
+    readonly capabilities: readonly Capability[];
+    readonly attempts?: number;
+    readonly onAttempt?: (result: AttemptResult, task: Task) => void;
+    readonly signal?: AbortSignal;
+}
+export declare class MissingCapabilityError extends Error {
+    readonly task: string;
+    readonly missing: readonly Capability[];
+    constructor(task: string, missing: readonly Capability[]);
+}
+/**
+ * Runs one task N times.
+ *
+ * The result is a pass rate, not a verdict: one attempt against a
+ * nondeterministic model says almost nothing, so the runner never reports a
+ * single attempt as the task's outcome.
+ */
+export declare function runTask(task: Task, options: RunnerOptions): Promise<TaskResult>;
+export declare function runTasks(tasks: readonly Task[], options: RunnerOptions): Promise<readonly TaskResult[]>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/evals/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAU3C,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE;IAA1E,YAAqB,IAAI,EAAE,MAAM,EAAW,OAAO,EAAE,SAAS,UAAU,EAAE,EAOzE;CACF;AAgHD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAMhC"}

package/dist/evals/runner.js

@@ -0,0 +1,144 @@
+import { Agent as AgentClass } from "../agent.js";
+import { LocalWorkspace } from "../workspace.js";
+import { ListFilesTool } from "../tools/list-files.js";
+import { ReadFileTool } from "../tools/read-file.js";
+import { SearchTextTool } from "../tools/search-text.js";
+import { WriteFileTool } from "../tools/write-file.js";
+import { EditFileTool } from "../tools/edit-file.js";
+import { BashTool } from "../tools/bash.js";
+import { createAttemptWorkspace } from "./fixture.js";
+import { createGrader, describeGrader } from "./graders.js";
+export class MissingCapabilityError extends Error {
+    task;
+    missing;
+    constructor(task, missing) {
+        super(`Task "${task}" needs ${missing.join(" and ")}; rerun with ${missing
+            .map((capability) => (capability === "writes" ? "--allow-writes" : "--allow-shell"))
+            .join(" ")}.`);
+        this.task = task;
+        this.missing = missing;
+        this.name = "MissingCapabilityError";
+    }
+}
+function toolsFor(capabilities, cwd) {
+    const tools = [
+        new ListFilesTool(),
+        new SearchTextTool(),
+        new ReadFileTool(),
+    ];
+    if (capabilities.includes("writes")) {
+        tools.push(new WriteFileTool(), new EditFileTool());
+    }
+    if (capabilities.includes("shell")) {
+        tools.push(new BashTool({ cwd }));
+    }
+    return tools;
+}
+function missingCapabilities(task, granted) {
+    return task.capabilities.filter((capability) => !granted.includes(capability));
+}
+async function runAttempt(task, attempt, options) {
+    const workspace = await createAttemptWorkspace(task.fixtureDirectory);
+    const events = [];
+    const startedAt = Date.now();
+    try {
+        const agent = new AgentClass({
+            systemPrompt: options.systemPrompt,
+            maxTurns: task.maxTurns,
+            llm: options.createClient(),
+            tools: toolsFor(task.capabilities, workspace.path),
+            workspace: new LocalWorkspace(workspace.path, {
+                allowWrites: task.capabilities.includes("writes"),
+            }),
+            streaming: false,
+            onEvent: (event) => events.push(event),
+        });
+        let status = "error";
+        let finalAnswer = "";
+        let turnCount = 0;
+        try {
+            const result = await agent.run(task.prompt, {
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            });
+            status = result.status;
+            turnCount = result.turnCount;
+            finalAnswer =
+                result.status === "completed" ? result.finalMessage.content : "";
+        }
+        catch (error) {
+            // A crashed run is a failed attempt, not a failed eval run: the point is
+            // to measure how often this happens, not to stop at the first one.
+            status = "error";
+            finalAnswer = error instanceof Error ? error.message : String(error);
+        }
+        const facts = {
+            workspace: workspace.path,
+            finalAnswer,
+            turnCount,
+            status,
+            events,
+        };
+        const failures = [];
+        if (status !== "completed") {
+            failures.push(status === "max_turns"
+                ? `hit the ${task.maxTurns}-turn limit without a final answer`
+                : `run ended as ${status}: ${finalAnswer.split("\n", 1)[0] ?? ""}`);
+        }
+        for (const spec of task.graders) {
+            const result = await createGrader(spec)(facts);
+            if (!result.passed) {
+                failures.push(`${describeGrader(spec)} — ${result.reason}`);
+            }
+        }
+        return {
+            attempt,
+            passed: failures.length === 0,
+            status,
+            turnCount,
+            durationMs: Date.now() - startedAt,
+            toolsUsed: [
+                ...new Set(events
+                    .filter((event) => event.type === "tool_execution_end")
+                    .map((event) => event.toolName)),
+            ],
+            failures,
+        };
+    }
+    finally {
+        await workspace.dispose();
+    }
+}
+/**
+ * Runs one task N times.
+ *
+ * The result is a pass rate, not a verdict: one attempt against a
+ * nondeterministic model says almost nothing, so the runner never reports a
+ * single attempt as the task's outcome.
+ */
+export async function runTask(task, options) {
+    const missing = missingCapabilities(task, options.capabilities);
+    if (missing.length > 0) {
+        throw new MissingCapabilityError(task.name, missing);
+    }
+    const total = options.attempts ?? task.attempts;
+    const attempts = [];
+    for (let index = 1; index <= total; index += 1) {
+        const result = await runAttempt(task, index, options);
+        attempts.push(result);
+        options.onAttempt?.(result, task);
+    }
+    return {
+        task: task.name,
+        attempts,
+        passed: attempts.filter((attempt) => attempt.passed).length,
+        total,
+    };
+}
+export async function runTasks(tasks, options) {
+    const results = [];
+    for (const task of tasks) {
+        results.push(await runTask(task, options));
+    }
+    return results;
+}
+//# sourceMappingURL=runner.js.map

package/dist/evals/runner.js.map

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

package/dist/evals/task.d.ts

@@ -0,0 +1,27 @@
+export declare class TaskError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Capabilities a task needs; the runner refuses to run without them. */
+export type Capability = "writes" | "shell";
+export interface GraderSpec {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+export interface Task {
+    readonly name: string;
+    readonly prompt: string;
+    readonly capabilities: readonly Capability[];
+    readonly attempts: number;
+    readonly maxTurns: number;
+    readonly graders: readonly GraderSpec[];
+    /** Directory copied into a fresh workspace for every attempt. */
+    readonly fixtureDirectory: string;
+    readonly directory: string;
+}
+export declare function parseTask(value: unknown, directory: string, fixtureDirectory: string): Task;
+export declare function loadTask(directory: string): Promise<Task>;
+/** Every subdirectory holding a task.json, in name order. */
+export declare function loadTasks(root: string): Promise<readonly Task[]>;
+//# sourceMappingURL=task.d.ts.map