import type { AgentRunInput, AgentRunResult, ExperimentFileSystem, ExperimentGit, ExperimentRunResult, JournalEntry, MetricDef } from "../types.js";
type SimulationFs = ExperimentFileSystem;
type TurnContext = {
    fs: SimulationFs;
    readFile: (filePath: string) => Promise<string>;
    writeFile: (filePath: string, content: string) => Promise<void>;
};
type MetricResultQueue = Record<string, SimulationMetricResult | SimulationMetricResult[]>;
export type SimulationExecCall = {
    command: string;
    cwd?: string;
    timeout?: number;
};
export type AgentTurnSpec = {
    assertPrompt?: (prompt: string, ctx: TurnContext) => void | Promise<void>;
    fileChanges?: Record<string, string>;
    output: AgentRunResult;
};
export type SimulationMetricResult = {
    stdout: string;
    stderr: string;
    exitCode: number;
};
export type CreateExperimentDocOptions = {
    agent?: string | string[];
    metric?: MetricDef | MetricDef[];
    baseline?: Record<string, number> | null;
    body?: string;
};
export type ExperimentLoopSimulationOptions = {
    docPath?: string;
    docContent?: string;
    files?: Record<string, string>;
    maxExperiments: number;
    metricResults?: MetricResultQueue;
    signal?: AbortSignal;
    turns: AgentTurnSpec[];
};
export type SimulationGit = ExperimentGit & {
    commitAll: (message: string, cwd: string) => Promise<string>;
    currentHashCalls: string[];
    commitAllCalls: Array<{
        message: string;
        cwd: string;
    }>;
    resetCalls: Array<{
        commitHash: string;
        cwd: string;
    }>;
    getHeadHash: () => string;
};
export type SimulationResult = {
    result: ExperimentRunResult;
    prompts: string[];
    runs: AgentRunInput[];
    fs: SimulationFs;
    git: SimulationGit;
    execCalls: SimulationExecCall[];
    cwd: string;
    homeDir: string;
    docPath: string;
    journalPath: string;
    readDoc: () => Promise<string>;
    readFile: (filePath: string) => Promise<string>;
    readJournal: () => Promise<JournalEntry[]>;
};
export declare function createExperimentDoc(options?: CreateExperimentDocOptions): string;
export declare function metricResult(options?: {
    score?: number;
    stdout?: string;
    stderr?: string;
    exitCode?: number;
    passed?: boolean;
}): SimulationMetricResult;
export declare function agentOutput(output?: Partial<AgentRunResult>, options?: {
    assertPrompt?: AgentTurnSpec["assertPrompt"];
    fileChanges?: Record<string, string>;
}): AgentTurnSpec;
export declare function agentMakesChanges(fileChanges?: Record<string, string>, options?: {
    assertPrompt?: AgentTurnSpec["assertPrompt"];
    stdout?: string;
    stderr?: string;
}): AgentTurnSpec;
export declare function createExperimentLoopSimulation(options: ExperimentLoopSimulationOptions): {
    run: () => Promise<SimulationResult>;
};
export {};