/**
 * GAP-RUN-001: Run Comparison and Diffing.
 *
 * Captures point-in-time snapshots of run metadata and computes
 * field-level diffs between two snapshots for comparison.
 */
import type { RunMetadata } from "../storage/types";
export interface RunSnapshot {
    runId: string;
    status: string;
    effectCount: number;
    completedCount: number;
    failedCount: number;
    totalCostUsd: number;
    durationMs: number;
}
export type DiffChangeType = 'added' | 'removed' | 'modified';
export interface RunDiff {
    field: string;
    before: unknown;
    after: unknown;
    changeType: DiffChangeType;
}
/**
 * Extract a RunSnapshot from run metadata and optional state cache data.
 */
export declare function captureRunSnapshot(metadata: RunMetadata & {
    status?: string;
    effectCount?: number;
    completedCount?: number;
    failedCount?: number;
    totalCostUsd?: number;
    durationMs?: number;
}): RunSnapshot;
/**
 * Compare two run snapshots field by field.
 * Returns an array of diffs for fields that differ.
 */
export declare function diffRuns(a: RunSnapshot, b: RunSnapshot): RunDiff[];
/**
 * Render a human-readable diff summary.
 */
export declare function formatRunDiff(diffs: RunDiff[]): string;
//# sourceMappingURL=runDiff.d.ts.map