import type { FileSystem } from "../ports/filesystem.js";
/** A recorded tool call with its expected result. */
export interface RecordedToolCall {
    readonly tool: string;
    readonly args: Readonly<Record<string, unknown>>;
    readonly expectedResult: Readonly<Record<string, unknown>>;
}
/** A single mismatch between expected and actual. */
export interface ReplayFailure {
    readonly index: number;
    readonly tool: string;
    readonly expected: Readonly<Record<string, unknown>>;
    readonly actual: Readonly<Record<string, unknown>>;
}
/** Result of replaying a scenario. */
export interface ReplayResult {
    readonly passed: boolean;
    readonly total: number;
    readonly matched: number;
    readonly mismatched: number;
    readonly failures: readonly ReplayFailure[];
}
/** Handler that executes a tool call and returns the result. */
export type ToolCallHandler = (tool: string, args: Readonly<Record<string, unknown>>) => Promise<Readonly<Record<string, unknown>>>;
/**
 * Create a mock FileSystem from a snapshot map.
 *
 * Keys are file paths, values are file contents. Provides readFile,
 * readdir, stat, and other FileSystem methods backed by the map.
 */
export declare function createSnapshotFs(files: Readonly<Record<string, string>>): FileSystem;
/**
 * Replay a sequence of recorded tool calls against a handler.
 *
 * Compares each actual result to the expected result from the
 * recording. Returns pass/fail with details on mismatches.
 */
export declare function replayToolCalls(calls: readonly RecordedToolCall[], handler: ToolCallHandler): Promise<ReplayResult>;
//# sourceMappingURL=deterministic-replay.d.ts.map