import { type ComparisonManifest, type SectionIndex, type SectionRecord } from "./design-comparison.ts";
export type LivePreviewMap = Record<string, string>;
export type AgentCandidateContext = {
    candidateId: string;
    label: string;
    concept: string;
    root: string;
    previewUrl?: string;
    previewReady: boolean;
    missingRoutes: string[];
    routes: {
        path: string;
        purpose?: string;
        missing?: boolean;
        sections: {
            sectionId: string;
            semanticRole?: string;
            component?: string;
        }[];
    }[];
};
export type AgentComparisonContext = {
    runId: string;
    status: string;
    comparisonRevision: string;
    comparisonHash: string;
    reviewUrl?: string;
    api?: {
        state: string;
        context: string;
        page: string;
    };
    instruction: string;
    candidates: AgentCandidateContext[];
};
export type AgentPageContext = {
    candidateId: string;
    label: string;
    route: string;
    previewUrl?: string;
    missing: boolean;
    sections: SectionRecord[];
    html?: string;
};
export declare function resolveDesignSite(cwd: string, explicit?: string): string;
export declare function joinPreviewRoute(base: string, route: string): string;
export declare function comparisonDest(parent: string, runId: string): string;
export declare function readLivePreviewReceipt(root: string): string | undefined;
export declare function overlayPreviewUrl(candidateRoot: string, stored?: string, live?: string): string | undefined;
export declare function refreshCandidatePreviews(opts: {
    parent: string;
    kernel: string;
    runId: string;
}): Promise<LivePreviewMap>;
export declare function loadAgentComparison(parent: string, runId: string, livePreviews?: LivePreviewMap): AgentComparisonContext;
export declare function reviewState(parent: string, runId: string, livePreviews?: LivePreviewMap): {
    status: object;
    comparison: {
        candidates: {
            previewUrl: string | undefined;
            candidateId: string;
            label: string;
            root: string;
            concept: string;
            sourceHash: string;
            buildHash: string;
            previewReady: boolean;
            missingRoutes: string[];
        }[];
        version: 2;
        mode: "calibration" | "design-selection";
        revision: string;
        runId?: string;
        createdAt: string;
        hash: string;
        labels?: Record<string, string>;
    };
    indexes: Record<string, SectionIndex>;
    machineChecked: boolean;
    operatorApprovalRequired: boolean;
    feedbackInCursor: boolean;
    instruction: string;
};
export declare function resolveCandidateId(comparison: ComparisonManifest, value: string): string | undefined;
export declare function loadAgentPage(parent: string, runId: string, candidateRef: string, route: string, livePreviews?: LivePreviewMap): AgentPageContext;