import type { SiteLensReportV1 } from "../types/report-v1.js";
export type ReportFailureKind = "step" | "assertion" | "error" | "visual-comparison" | "network" | "diagnostic";
export interface ReportFailureItem {
    kind: ReportFailureKind;
    status: string;
    message: string;
    stepIndex?: number;
    type?: string;
    comparisonId?: string;
    relativePath?: string;
    /** diagnostic kind only — findingId from diagnostics.json (stable within one diagnostics run). */
    findingId?: string;
    /** diagnostic kind only — the BrowserDiagnosticsEngine rule that produced this finding. */
    ruleId?: string;
    evidenceRefs?: Array<{
        kind: string;
        path?: string;
        stepIndex?: number;
    }>;
}
export interface GetReportFailuresOptions {
    limit?: number;
    /** Filter by failure kind. */
    kind?: ReportFailureKind | ReportFailureKind[];
    status?: string;
    query?: string;
    maxPreviewLength?: number;
}
export interface GetReportFailuresResult {
    totalMatching: number;
    returned: number;
    truncated: boolean;
    failures: ReportFailureItem[];
}
/**
 * Concise combined failures from the canonical report model only — no invented failures.
 */
export declare function getReportFailures(report: SiteLensReportV1, options?: GetReportFailuresOptions): GetReportFailuresResult;
//# sourceMappingURL=failures.d.ts.map