import type { ReportProfileId, SiteLensReportV1 } from "../types/report-v1.js";
export interface LoadReportReferenceOptions {
    profile?: ReportProfileId;
    /**
     * When set, the resolved path must stay under one of these roots
     * (realpath containment). Used by MCP trusted-root enforcement.
     */
    trustedRoots?: string[];
}
export type LoadReportReferenceResult = {
    ok: true;
    report: SiteLensReportV1;
    bundlePath: string;
    reportPath: string;
    source: "report.json" | "summary.json";
} | {
    ok: false;
    error: string;
    code: "not_found" | "untrusted" | "malformed" | "unsupported";
};
/**
 * Load a report from a directory, report.json path, or co-located bundle.
 * Optional trustedRoots rejects paths outside configured artifact bases.
 */
export declare function loadReportReference(reference: string, options?: LoadReportReferenceOptions): Promise<LoadReportReferenceResult>;
//# sourceMappingURL=load-reference.d.ts.map