import type { RAGCitation, RAGGroundingReference, RAGSectionRetrievalDiagnostic, RAGSourceSummary } from "@absolutejs/ai";
export type RAGSectionDiagnostic = RAGSectionRetrievalDiagnostic & {
    peakStage?: string;
    peakCount?: number;
    finalCount?: number;
    finalRetentionRate?: number;
    dropFromPeak?: number;
    queryAttribution?: {
        mode: "primary" | "transformed" | "variant" | "mixed";
        primaryHits: number;
        transformedHits: number;
        variantHits: number;
        reasons: string[];
    };
    stageWeights?: Array<{
        stage: string;
        count: number;
        previousStage?: string;
        previousCount?: number;
        countDelta?: number;
        retentionRate?: number;
        totalScore?: number;
        stageScoreShare?: number;
        parentStageScoreShare?: number;
        stageScoreShareGap?: number;
        parentStageScoreShareGap?: number;
        stageShare: number;
        parentStageShare?: number;
        stageShareGap?: number;
        parentStageShareGap?: number;
        strongestSiblingLabel?: string;
        strongestSiblingCount?: number;
        reasons: string[];
    }>;
};
export type RAGSourceSummaryGroup = {
    id: string;
    label: string;
    targetId: string;
    summary: string;
    summaries: RAGSourceSummary[];
};
export type RAGGroundingReferenceGroup = {
    id: string;
    label: string;
    targetId: string;
    summary: string;
    references: RAGGroundingReference[];
};
export type RAGCitationGroup = {
    id: string;
    label: string;
    targetId: string;
    summary: string;
    citations: RAGCitation[];
};
export declare const buildSearchTargetId: (prefix: string, value: string) => string;
export declare const buildSourceSummarySectionGroups: (summaries?: RAGSourceSummary[] | null) => RAGSourceSummaryGroup[];
export declare const buildGroundingReferenceGroups: (references?: RAGGroundingReference[] | null) => RAGGroundingReferenceGroup[];
export declare const buildCitationGroups: (citations?: RAGCitation[] | null) => RAGCitationGroup[];
export declare const formatCitationLabel: (citation: RAGCitation) => string;
export declare const formatCitationSummary: (citation: RAGCitation) => string;
export declare const formatCitationExcerpt: (citation: RAGCitation) => string;
export declare const formatSourceSummaryDetails: (summary: RAGSourceSummary) => string[];
export declare const formatCitationDetails: (citation: RAGCitation) => string[];
export declare const formatSectionDiagnosticChannels: (diagnostic: RAGSectionRetrievalDiagnostic) => string;
export declare const formatSectionDiagnosticAttributionFocus: (diagnostic: RAGSectionDiagnostic) => string;
export declare const formatSectionDiagnosticPipeline: (diagnostic: RAGSectionDiagnostic) => string;
export declare const formatSectionDiagnosticStageFlow: (diagnostic: RAGSectionRetrievalDiagnostic) => string | null;
export declare const formatSectionDiagnosticStageBounds: (diagnostic: RAGSectionDiagnostic) => string | null;
export declare const formatSectionDiagnosticStageWeightRows: (diagnostic: RAGSectionDiagnostic) => string[];
export declare const formatSectionDiagnosticStageWeightReasons: (diagnostic: RAGSectionDiagnostic) => string[];
export declare const formatSectionDiagnosticCompetition: (diagnostic: RAGSectionRetrievalDiagnostic) => string;
export declare const formatSectionDiagnosticTopEntry: (diagnostic: RAGSectionDiagnostic) => string;
export declare const formatSectionDiagnosticReasons: (diagnostic: RAGSectionDiagnostic) => string[];
export declare const formatSectionDiagnosticDistributionRows: (diagnostic: RAGSectionRetrievalDiagnostic) => string[];
