@absolutejs/rag 0.0.1

package/dist/src/vue/ai/useRAGEvaluate.d.ts

@@ -0,0 +1,1002 @@
+import type { RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSuite, RAGEvaluationSuiteRun } from '@absolutejs/ai';
+export declare const useRAGEvaluate: (path: string) => {
+    clearRuns: () => void;
+    error: import("vue").Ref<string | null, string | null>;
+    evaluate: (input: RAGEvaluationInput) => Promise<RAGEvaluationResponse>;
+    isEvaluating: import("vue").Ref<boolean, boolean>;
+    lastRequest: import("vue").Ref<{
+        cases: {
+            id: string;
+            query: string;
+            corpusKey?: string | undefined;
+            topK?: number | undefined;
+            model?: string | undefined;
+            scoreThreshold?: number | undefined;
+            filter?: Record<string, unknown> | undefined;
+            retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            expectedChunkIds?: string[] | undefined;
+            expectedSources?: string[] | undefined;
+            expectedDocumentIds?: string[] | undefined;
+            goldenSet?: boolean | undefined;
+            hardNegativeChunkIds?: string[] | undefined;
+            hardNegativeSources?: string[] | undefined;
+            hardNegativeDocumentIds?: string[] | undefined;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        topK?: number | undefined;
+        scoreThreshold?: number | undefined;
+        model?: string | undefined;
+        filter?: Record<string, unknown> | undefined;
+        retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+            mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            lexicalTopK?: number | undefined;
+            maxResultsPerSource?: number | undefined;
+            sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+            mmrLambda?: number | undefined;
+            fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+            fusionConstant?: number | undefined;
+            lexicalWeight?: number | undefined;
+            vectorWeight?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+        } | undefined;
+        dryRun?: boolean | undefined;
+    } | null, RAGEvaluationInput | {
+        cases: {
+            id: string;
+            query: string;
+            corpusKey?: string | undefined;
+            topK?: number | undefined;
+            model?: string | undefined;
+            scoreThreshold?: number | undefined;
+            filter?: Record<string, unknown> | undefined;
+            retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            expectedChunkIds?: string[] | undefined;
+            expectedSources?: string[] | undefined;
+            expectedDocumentIds?: string[] | undefined;
+            goldenSet?: boolean | undefined;
+            hardNegativeChunkIds?: string[] | undefined;
+            hardNegativeSources?: string[] | undefined;
+            hardNegativeDocumentIds?: string[] | undefined;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        topK?: number | undefined;
+        scoreThreshold?: number | undefined;
+        model?: string | undefined;
+        filter?: Record<string, unknown> | undefined;
+        retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+            mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            lexicalTopK?: number | undefined;
+            maxResultsPerSource?: number | undefined;
+            sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+            mmrLambda?: number | undefined;
+            fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+            fusionConstant?: number | undefined;
+            lexicalWeight?: number | undefined;
+            vectorWeight?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+        } | undefined;
+        dryRun?: boolean | undefined;
+    } | null>;
+    lastResponse: import("vue").Ref<{
+        ok: true;
+        corpusKeys?: string[] | undefined;
+        cases: {
+            caseId: string;
+            corpusKey?: string | undefined;
+            query: string;
+            label?: string | undefined;
+            status: "pass" | "partial" | "fail";
+            topK: number;
+            elapsedMs: number;
+            retrievedCount: number;
+            expectedCount: number;
+            matchedCount: number;
+            precision: number;
+            recall: number;
+            f1: number;
+            retrievedIds: string[];
+            expectedIds: string[];
+            matchedIds: string[];
+            missingIds: string[];
+            mode: "chunkId" | "source" | "documentId";
+            failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        summary: {
+            totalCases: number;
+            passedCases: number;
+            partialCases: number;
+            failedCases: number;
+            averagePrecision: number;
+            averageRecall: number;
+            averageF1: number;
+            averageLatencyMs: number;
+        };
+        elapsedMs: number;
+        totalCases: number;
+        passingRate: number;
+    } | null, RAGEvaluationResponse | {
+        ok: true;
+        corpusKeys?: string[] | undefined;
+        cases: {
+            caseId: string;
+            corpusKey?: string | undefined;
+            query: string;
+            label?: string | undefined;
+            status: "pass" | "partial" | "fail";
+            topK: number;
+            elapsedMs: number;
+            retrievedCount: number;
+            expectedCount: number;
+            matchedCount: number;
+            precision: number;
+            recall: number;
+            f1: number;
+            retrievedIds: string[];
+            expectedIds: string[];
+            matchedIds: string[];
+            missingIds: string[];
+            mode: "chunkId" | "source" | "documentId";
+            failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        summary: {
+            totalCases: number;
+            passedCases: number;
+            partialCases: number;
+            failedCases: number;
+            averagePrecision: number;
+            averageRecall: number;
+            averageF1: number;
+            averageLatencyMs: number;
+        };
+        elapsedMs: number;
+        totalCases: number;
+        passingRate: number;
+    } | null>;
+    leaderboard: import("vue").ComputedRef<import("@absolutejs/ai").RAGEvaluationLeaderboardEntry[]>;
+    removeSuite: (id: string) => void;
+    reset: () => void;
+    runSuite: (suite: RAGEvaluationSuite, overrides?: Partial<RAGEvaluationInput>) => Promise<{
+        caseTraceSnapshots: import("@absolutejs/ai").RAGEvaluationCaseTraceSnapshot[] | undefined;
+        elapsedMs: number;
+        finishedAt: number;
+        id: `${string}-${string}-${string}-${string}-${string}`;
+        label: string;
+        metadata: Record<string, unknown> | undefined;
+        response: RAGEvaluationResponse;
+        startedAt: number;
+        suiteId: string;
+        traceSummary: import("@absolutejs/ai").RAGRetrievalTraceComparisonSummary | undefined;
+    }>;
+    saveSuite: (suite: RAGEvaluationSuite) => RAGEvaluationSuite;
+    suiteRuns: import("vue").Ref<{
+        id: string;
+        suiteId: string;
+        label: string;
+        startedAt: number;
+        finishedAt: number;
+        elapsedMs: number;
+        response: {
+            ok: true;
+            corpusKeys?: string[] | undefined;
+            cases: {
+                caseId: string;
+                corpusKey?: string | undefined;
+                query: string;
+                label?: string | undefined;
+                status: "pass" | "partial" | "fail";
+                topK: number;
+                elapsedMs: number;
+                retrievedCount: number;
+                expectedCount: number;
+                matchedCount: number;
+                precision: number;
+                recall: number;
+                f1: number;
+                retrievedIds: string[];
+                expectedIds: string[];
+                matchedIds: string[];
+                missingIds: string[];
+                mode: "chunkId" | "source" | "documentId";
+                failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            summary: {
+                totalCases: number;
+                passedCases: number;
+                partialCases: number;
+                failedCases: number;
+                averagePrecision: number;
+                averageRecall: number;
+                averageF1: number;
+                averageLatencyMs: number;
+            };
+            elapsedMs: number;
+            totalCases: number;
+            passingRate: number;
+        };
+        traceSummary?: {
+            totalCases: number;
+            modes: import("@absolutejs/ai").RAGHybridRetrievalMode[];
+            sourceBalanceStrategies: import("@absolutejs/ai").RAGSourceBalanceStrategy[];
+            vectorCases: number;
+            lexicalCases: number;
+            balancedCases: number;
+            roundRobinCases: number;
+            transformedCases: number;
+            variantCases: number;
+            multiVectorCases: number;
+            multiVectorVectorHitCases: number;
+            multiVectorLexicalHitCases: number;
+            multiVectorCollapsedCases: number;
+            officeEvidenceReconcileCases: number;
+            officeParagraphEvidenceReconcileCases?: number | undefined;
+            officeListEvidenceReconcileCases?: number | undefined;
+            officeTableEvidenceReconcileCases?: number | undefined;
+            pdfEvidenceReconcileCases: number;
+            runtimeCandidateBudgetExhaustedCases: number;
+            runtimeUnderfilledTopKCases: number;
+            averageFinalCount: number;
+            averageVectorCount: number;
+            averageLexicalCount: number;
+            averageCandidateTopK: number;
+            averageLexicalTopK: number;
+            stageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+        } | undefined;
+        caseTraceSnapshots?: {
+            caseId: string;
+            corpusKey?: string | undefined;
+            label?: string | undefined;
+            query: string;
+            status: import("@absolutejs/ai").RAGEvaluationCaseResult["status"];
+            inputFilter?: Record<string, unknown> | undefined;
+            previousInputFilter?: Record<string, unknown> | undefined;
+            inputRetrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            previousInputRetrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            traceMode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            previousTraceMode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            previousSourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            transformedQuery?: string | undefined;
+            previousTransformedQuery?: string | undefined;
+            variantQueries: string[];
+            previousVariantQueries: string[];
+            finalCount: number;
+            previousFinalCount?: number | undefined;
+            vectorCount: number;
+            previousVectorCount?: number | undefined;
+            lexicalCount: number;
+            previousLexicalCount?: number | undefined;
+            candidateTopK: number;
+            previousCandidateTopK?: number | undefined;
+            lexicalTopK: number;
+            previousLexicalTopK?: number | undefined;
+            topContextLabel?: string | undefined;
+            previousTopContextLabel?: string | undefined;
+            topLocatorLabel?: string | undefined;
+            previousTopLocatorLabel?: string | undefined;
+            leadPresentationCue?: "body" | "notes" | "title" | undefined;
+            previousLeadPresentationCue?: "body" | "notes" | "title" | undefined;
+            leadSpreadsheetCue?: "column" | "sheet" | "table" | undefined;
+            previousLeadSpreadsheetCue?: "column" | "sheet" | "table" | undefined;
+            leadSpeakerCue?: string | undefined;
+            previousLeadSpeakerCue?: string | undefined;
+            leadSpeakerAttributionCue?: string | undefined;
+            previousLeadSpeakerAttributionCue?: string | undefined;
+            leadChannelCue?: string | undefined;
+            previousLeadChannelCue?: string | undefined;
+            leadChannelAttributionCue?: string | undefined;
+            previousLeadChannelAttributionCue?: string | undefined;
+            leadContinuityCue?: string | undefined;
+            previousLeadContinuityCue?: string | undefined;
+            sqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
+            previousSqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
+            sqliteQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            previousSqliteQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            sqliteQueryPushdownApplied?: boolean | undefined;
+            previousSqliteQueryPushdownApplied?: boolean | undefined;
+            sqliteQueryPushdownClauseCount?: number | undefined;
+            previousSqliteQueryPushdownClauseCount?: number | undefined;
+            sqliteQueryTotalFilterClauseCount?: number | undefined;
+            previousSqliteQueryTotalFilterClauseCount?: number | undefined;
+            sqliteQueryJsRemainderClauseCount?: number | undefined;
+            previousSqliteQueryJsRemainderClauseCount?: number | undefined;
+            sqliteQueryMultiplierUsed?: number | undefined;
+            previousSqliteQueryMultiplierUsed?: number | undefined;
+            sqliteQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            previousSqliteQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            sqliteQueryCandidateLimitUsed?: number | undefined;
+            previousSqliteQueryCandidateLimitUsed?: number | undefined;
+            sqliteQueryMaxBackfillsUsed?: number | undefined;
+            previousSqliteQueryMaxBackfillsUsed?: number | undefined;
+            sqliteQueryMinResultsUsed?: number | undefined;
+            previousSqliteQueryMinResultsUsed?: number | undefined;
+            sqliteQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            previousSqliteQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            sqliteQueryPushdownCoverageRatio?: number | undefined;
+            previousSqliteQueryPushdownCoverageRatio?: number | undefined;
+            sqliteQueryJsRemainderRatio?: number | undefined;
+            previousSqliteQueryJsRemainderRatio?: number | undefined;
+            sqliteQueryFilteredCandidates?: number | undefined;
+            previousSqliteQueryFilteredCandidates?: number | undefined;
+            sqliteQueryInitialSearchK?: number | undefined;
+            previousSqliteQueryInitialSearchK?: number | undefined;
+            sqliteQueryFinalSearchK?: number | undefined;
+            previousSqliteQueryFinalSearchK?: number | undefined;
+            sqliteQuerySearchExpansionRatio?: number | undefined;
+            previousSqliteQuerySearchExpansionRatio?: number | undefined;
+            sqliteQueryBackfillCount?: number | undefined;
+            previousSqliteQueryBackfillCount?: number | undefined;
+            sqliteQueryBackfillLimitReached?: boolean | undefined;
+            previousSqliteQueryBackfillLimitReached?: boolean | undefined;
+            sqliteQueryMinResultsSatisfied?: boolean | undefined;
+            previousSqliteQueryMinResultsSatisfied?: boolean | undefined;
+            sqliteQueryReturnedCount?: number | undefined;
+            previousSqliteQueryReturnedCount?: number | undefined;
+            sqliteQueryCandidateYieldRatio?: number | undefined;
+            previousSqliteQueryCandidateYieldRatio?: number | undefined;
+            sqliteQueryTopKFillRatio?: number | undefined;
+            previousSqliteQueryTopKFillRatio?: number | undefined;
+            sqliteQueryUnderfilledTopK?: boolean | undefined;
+            previousSqliteQueryUnderfilledTopK?: boolean | undefined;
+            sqliteQueryCandidateBudgetExhausted?: boolean | undefined;
+            previousSqliteQueryCandidateBudgetExhausted?: boolean | undefined;
+            sqliteQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            previousSqliteQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            postgresQueryMode?: "native_pgvector" | undefined;
+            previousPostgresQueryMode?: "native_pgvector" | undefined;
+            postgresQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            previousPostgresQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            postgresQueryPushdownApplied?: boolean | undefined;
+            previousPostgresQueryPushdownApplied?: boolean | undefined;
+            postgresQueryPushdownClauseCount?: number | undefined;
+            previousPostgresQueryPushdownClauseCount?: number | undefined;
+            postgresQueryTotalFilterClauseCount?: number | undefined;
+            previousPostgresQueryTotalFilterClauseCount?: number | undefined;
+            postgresQueryJsRemainderClauseCount?: number | undefined;
+            previousPostgresQueryJsRemainderClauseCount?: number | undefined;
+            postgresQueryMultiplierUsed?: number | undefined;
+            previousPostgresQueryMultiplierUsed?: number | undefined;
+            postgresQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            previousPostgresQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            postgresQueryCandidateLimitUsed?: number | undefined;
+            previousPostgresQueryCandidateLimitUsed?: number | undefined;
+            postgresQueryMaxBackfillsUsed?: number | undefined;
+            previousPostgresQueryMaxBackfillsUsed?: number | undefined;
+            postgresQueryMinResultsUsed?: number | undefined;
+            previousPostgresQueryMinResultsUsed?: number | undefined;
+            postgresQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            previousPostgresQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            postgresQueryPushdownCoverageRatio?: number | undefined;
+            previousPostgresQueryPushdownCoverageRatio?: number | undefined;
+            postgresQueryJsRemainderRatio?: number | undefined;
+            previousPostgresQueryJsRemainderRatio?: number | undefined;
+            postgresQueryFilteredCandidates?: number | undefined;
+            previousPostgresQueryFilteredCandidates?: number | undefined;
+            postgresQueryInitialSearchK?: number | undefined;
+            previousPostgresQueryInitialSearchK?: number | undefined;
+            postgresQueryFinalSearchK?: number | undefined;
+            previousPostgresQueryFinalSearchK?: number | undefined;
+            postgresQuerySearchExpansionRatio?: number | undefined;
+            previousPostgresQuerySearchExpansionRatio?: number | undefined;
+            postgresQueryBackfillCount?: number | undefined;
+            previousPostgresQueryBackfillCount?: number | undefined;
+            postgresQueryBackfillLimitReached?: boolean | undefined;
+            previousPostgresQueryBackfillLimitReached?: boolean | undefined;
+            postgresQueryMinResultsSatisfied?: boolean | undefined;
+            previousPostgresQueryMinResultsSatisfied?: boolean | undefined;
+            postgresQueryReturnedCount?: number | undefined;
+            previousPostgresQueryReturnedCount?: number | undefined;
+            postgresQueryCandidateYieldRatio?: number | undefined;
+            previousPostgresQueryCandidateYieldRatio?: number | undefined;
+            postgresQueryTopKFillRatio?: number | undefined;
+            previousPostgresQueryTopKFillRatio?: number | undefined;
+            postgresQueryUnderfilledTopK?: boolean | undefined;
+            previousPostgresQueryUnderfilledTopK?: boolean | undefined;
+            postgresQueryCandidateBudgetExhausted?: boolean | undefined;
+            previousPostgresQueryCandidateBudgetExhausted?: boolean | undefined;
+            postgresQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            previousPostgresQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            postgresIndexType?: "none" | "hnsw" | "ivfflat" | undefined;
+            previousPostgresIndexType?: "none" | "hnsw" | "ivfflat" | undefined;
+            postgresIndexName?: string | undefined;
+            previousPostgresIndexName?: string | undefined;
+            postgresIndexPresent?: boolean | undefined;
+            previousPostgresIndexPresent?: boolean | undefined;
+            postgresEstimatedRowCount?: number | undefined;
+            previousPostgresEstimatedRowCount?: number | undefined;
+            postgresTableBytes?: number | undefined;
+            previousPostgresTableBytes?: number | undefined;
+            postgresIndexBytes?: number | undefined;
+            previousPostgresIndexBytes?: number | undefined;
+            postgresTotalBytes?: number | undefined;
+            previousPostgresTotalBytes?: number | undefined;
+            postgresIndexStorageRatio?: number | undefined;
+            previousPostgresIndexStorageRatio?: number | undefined;
+            sourceAwareChunkReasonLabel?: string | undefined;
+            previousSourceAwareChunkReasonLabel?: string | undefined;
+            sourceAwareUnitScopeLabel?: string | undefined;
+            previousSourceAwareUnitScopeLabel?: string | undefined;
+            stageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            previousStageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            traceChange: "new" | "changed" | "unchanged";
+        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[], RAGEvaluationSuiteRun[] | {
+        id: string;
+        suiteId: string;
+        label: string;
+        startedAt: number;
+        finishedAt: number;
+        elapsedMs: number;
+        response: {
+            ok: true;
+            corpusKeys?: string[] | undefined;
+            cases: {
+                caseId: string;
+                corpusKey?: string | undefined;
+                query: string;
+                label?: string | undefined;
+                status: "pass" | "partial" | "fail";
+                topK: number;
+                elapsedMs: number;
+                retrievedCount: number;
+                expectedCount: number;
+                matchedCount: number;
+                precision: number;
+                recall: number;
+                f1: number;
+                retrievedIds: string[];
+                expectedIds: string[];
+                matchedIds: string[];
+                missingIds: string[];
+                mode: "chunkId" | "source" | "documentId";
+                failureClasses?: Array<"no_expected_targets" | "no_results" | "no_match" | "partial_recall" | "extra_noise" | "section_evidence_miss" | "section_graph_miss" | "section_hierarchy_miss" | "spreadsheet_evidence_miss" | "media_evidence_miss" | "ocr_evidence_miss" | "routing_miss"> | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            summary: {
+                totalCases: number;
+                passedCases: number;
+                partialCases: number;
+                failedCases: number;
+                averagePrecision: number;
+                averageRecall: number;
+                averageF1: number;
+                averageLatencyMs: number;
+            };
+            elapsedMs: number;
+            totalCases: number;
+            passingRate: number;
+        };
+        traceSummary?: {
+            totalCases: number;
+            modes: import("@absolutejs/ai").RAGHybridRetrievalMode[];
+            sourceBalanceStrategies: import("@absolutejs/ai").RAGSourceBalanceStrategy[];
+            vectorCases: number;
+            lexicalCases: number;
+            balancedCases: number;
+            roundRobinCases: number;
+            transformedCases: number;
+            variantCases: number;
+            multiVectorCases: number;
+            multiVectorVectorHitCases: number;
+            multiVectorLexicalHitCases: number;
+            multiVectorCollapsedCases: number;
+            officeEvidenceReconcileCases: number;
+            officeParagraphEvidenceReconcileCases?: number | undefined;
+            officeListEvidenceReconcileCases?: number | undefined;
+            officeTableEvidenceReconcileCases?: number | undefined;
+            pdfEvidenceReconcileCases: number;
+            runtimeCandidateBudgetExhaustedCases: number;
+            runtimeUnderfilledTopKCases: number;
+            averageFinalCount: number;
+            averageVectorCount: number;
+            averageLexicalCount: number;
+            averageCandidateTopK: number;
+            averageLexicalTopK: number;
+            stageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+        } | undefined;
+        caseTraceSnapshots?: {
+            caseId: string;
+            corpusKey?: string | undefined;
+            label?: string | undefined;
+            query: string;
+            status: import("@absolutejs/ai").RAGEvaluationCaseResult["status"];
+            inputFilter?: Record<string, unknown> | undefined;
+            previousInputFilter?: Record<string, unknown> | undefined;
+            inputRetrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            previousInputRetrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            traceMode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            previousTraceMode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+            sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            previousSourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+            transformedQuery?: string | undefined;
+            previousTransformedQuery?: string | undefined;
+            variantQueries: string[];
+            previousVariantQueries: string[];
+            finalCount: number;
+            previousFinalCount?: number | undefined;
+            vectorCount: number;
+            previousVectorCount?: number | undefined;
+            lexicalCount: number;
+            previousLexicalCount?: number | undefined;
+            candidateTopK: number;
+            previousCandidateTopK?: number | undefined;
+            lexicalTopK: number;
+            previousLexicalTopK?: number | undefined;
+            topContextLabel?: string | undefined;
+            previousTopContextLabel?: string | undefined;
+            topLocatorLabel?: string | undefined;
+            previousTopLocatorLabel?: string | undefined;
+            leadPresentationCue?: "body" | "notes" | "title" | undefined;
+            previousLeadPresentationCue?: "body" | "notes" | "title" | undefined;
+            leadSpreadsheetCue?: "column" | "sheet" | "table" | undefined;
+            previousLeadSpreadsheetCue?: "column" | "sheet" | "table" | undefined;
+            leadSpeakerCue?: string | undefined;
+            previousLeadSpeakerCue?: string | undefined;
+            leadSpeakerAttributionCue?: string | undefined;
+            previousLeadSpeakerAttributionCue?: string | undefined;
+            leadChannelCue?: string | undefined;
+            previousLeadChannelCue?: string | undefined;
+            leadChannelAttributionCue?: string | undefined;
+            previousLeadChannelAttributionCue?: string | undefined;
+            leadContinuityCue?: string | undefined;
+            previousLeadContinuityCue?: string | undefined;
+            sqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
+            previousSqliteQueryMode?: "json_fallback" | "native_vec0" | undefined;
+            sqliteQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            previousSqliteQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            sqliteQueryPushdownApplied?: boolean | undefined;
+            previousSqliteQueryPushdownApplied?: boolean | undefined;
+            sqliteQueryPushdownClauseCount?: number | undefined;
+            previousSqliteQueryPushdownClauseCount?: number | undefined;
+            sqliteQueryTotalFilterClauseCount?: number | undefined;
+            previousSqliteQueryTotalFilterClauseCount?: number | undefined;
+            sqliteQueryJsRemainderClauseCount?: number | undefined;
+            previousSqliteQueryJsRemainderClauseCount?: number | undefined;
+            sqliteQueryMultiplierUsed?: number | undefined;
+            previousSqliteQueryMultiplierUsed?: number | undefined;
+            sqliteQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            previousSqliteQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            sqliteQueryCandidateLimitUsed?: number | undefined;
+            previousSqliteQueryCandidateLimitUsed?: number | undefined;
+            sqliteQueryMaxBackfillsUsed?: number | undefined;
+            previousSqliteQueryMaxBackfillsUsed?: number | undefined;
+            sqliteQueryMinResultsUsed?: number | undefined;
+            previousSqliteQueryMinResultsUsed?: number | undefined;
+            sqliteQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            previousSqliteQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            sqliteQueryPushdownCoverageRatio?: number | undefined;
+            previousSqliteQueryPushdownCoverageRatio?: number | undefined;
+            sqliteQueryJsRemainderRatio?: number | undefined;
+            previousSqliteQueryJsRemainderRatio?: number | undefined;
+            sqliteQueryFilteredCandidates?: number | undefined;
+            previousSqliteQueryFilteredCandidates?: number | undefined;
+            sqliteQueryInitialSearchK?: number | undefined;
+            previousSqliteQueryInitialSearchK?: number | undefined;
+            sqliteQueryFinalSearchK?: number | undefined;
+            previousSqliteQueryFinalSearchK?: number | undefined;
+            sqliteQuerySearchExpansionRatio?: number | undefined;
+            previousSqliteQuerySearchExpansionRatio?: number | undefined;
+            sqliteQueryBackfillCount?: number | undefined;
+            previousSqliteQueryBackfillCount?: number | undefined;
+            sqliteQueryBackfillLimitReached?: boolean | undefined;
+            previousSqliteQueryBackfillLimitReached?: boolean | undefined;
+            sqliteQueryMinResultsSatisfied?: boolean | undefined;
+            previousSqliteQueryMinResultsSatisfied?: boolean | undefined;
+            sqliteQueryReturnedCount?: number | undefined;
+            previousSqliteQueryReturnedCount?: number | undefined;
+            sqliteQueryCandidateYieldRatio?: number | undefined;
+            previousSqliteQueryCandidateYieldRatio?: number | undefined;
+            sqliteQueryTopKFillRatio?: number | undefined;
+            previousSqliteQueryTopKFillRatio?: number | undefined;
+            sqliteQueryUnderfilledTopK?: boolean | undefined;
+            previousSqliteQueryUnderfilledTopK?: boolean | undefined;
+            sqliteQueryCandidateBudgetExhausted?: boolean | undefined;
+            previousSqliteQueryCandidateBudgetExhausted?: boolean | undefined;
+            sqliteQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            previousSqliteQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            postgresQueryMode?: "native_pgvector" | undefined;
+            previousPostgresQueryMode?: "native_pgvector" | undefined;
+            postgresQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            previousPostgresQueryPushdownMode?: "none" | "partial" | "full" | undefined;
+            postgresQueryPushdownApplied?: boolean | undefined;
+            previousPostgresQueryPushdownApplied?: boolean | undefined;
+            postgresQueryPushdownClauseCount?: number | undefined;
+            previousPostgresQueryPushdownClauseCount?: number | undefined;
+            postgresQueryTotalFilterClauseCount?: number | undefined;
+            previousPostgresQueryTotalFilterClauseCount?: number | undefined;
+            postgresQueryJsRemainderClauseCount?: number | undefined;
+            previousPostgresQueryJsRemainderClauseCount?: number | undefined;
+            postgresQueryMultiplierUsed?: number | undefined;
+            previousPostgresQueryMultiplierUsed?: number | undefined;
+            postgresQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            previousPostgresQueryPlannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            postgresQueryCandidateLimitUsed?: number | undefined;
+            previousPostgresQueryCandidateLimitUsed?: number | undefined;
+            postgresQueryMaxBackfillsUsed?: number | undefined;
+            previousPostgresQueryMaxBackfillsUsed?: number | undefined;
+            postgresQueryMinResultsUsed?: number | undefined;
+            previousPostgresQueryMinResultsUsed?: number | undefined;
+            postgresQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            previousPostgresQueryFillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+            postgresQueryPushdownCoverageRatio?: number | undefined;
+            previousPostgresQueryPushdownCoverageRatio?: number | undefined;
+            postgresQueryJsRemainderRatio?: number | undefined;
+            previousPostgresQueryJsRemainderRatio?: number | undefined;
+            postgresQueryFilteredCandidates?: number | undefined;
+            previousPostgresQueryFilteredCandidates?: number | undefined;
+            postgresQueryInitialSearchK?: number | undefined;
+            previousPostgresQueryInitialSearchK?: number | undefined;
+            postgresQueryFinalSearchK?: number | undefined;
+            previousPostgresQueryFinalSearchK?: number | undefined;
+            postgresQuerySearchExpansionRatio?: number | undefined;
+            previousPostgresQuerySearchExpansionRatio?: number | undefined;
+            postgresQueryBackfillCount?: number | undefined;
+            previousPostgresQueryBackfillCount?: number | undefined;
+            postgresQueryBackfillLimitReached?: boolean | undefined;
+            previousPostgresQueryBackfillLimitReached?: boolean | undefined;
+            postgresQueryMinResultsSatisfied?: boolean | undefined;
+            previousPostgresQueryMinResultsSatisfied?: boolean | undefined;
+            postgresQueryReturnedCount?: number | undefined;
+            previousPostgresQueryReturnedCount?: number | undefined;
+            postgresQueryCandidateYieldRatio?: number | undefined;
+            previousPostgresQueryCandidateYieldRatio?: number | undefined;
+            postgresQueryTopKFillRatio?: number | undefined;
+            previousPostgresQueryTopKFillRatio?: number | undefined;
+            postgresQueryUnderfilledTopK?: boolean | undefined;
+            previousPostgresQueryUnderfilledTopK?: boolean | undefined;
+            postgresQueryCandidateBudgetExhausted?: boolean | undefined;
+            previousPostgresQueryCandidateBudgetExhausted?: boolean | undefined;
+            postgresQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            previousPostgresQueryCandidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+            postgresIndexType?: "none" | "hnsw" | "ivfflat" | undefined;
+            previousPostgresIndexType?: "none" | "hnsw" | "ivfflat" | undefined;
+            postgresIndexName?: string | undefined;
+            previousPostgresIndexName?: string | undefined;
+            postgresIndexPresent?: boolean | undefined;
+            previousPostgresIndexPresent?: boolean | undefined;
+            postgresEstimatedRowCount?: number | undefined;
+            previousPostgresEstimatedRowCount?: number | undefined;
+            postgresTableBytes?: number | undefined;
+            previousPostgresTableBytes?: number | undefined;
+            postgresIndexBytes?: number | undefined;
+            previousPostgresIndexBytes?: number | undefined;
+            postgresTotalBytes?: number | undefined;
+            previousPostgresTotalBytes?: number | undefined;
+            postgresIndexStorageRatio?: number | undefined;
+            previousPostgresIndexStorageRatio?: number | undefined;
+            sourceAwareChunkReasonLabel?: string | undefined;
+            previousSourceAwareChunkReasonLabel?: string | undefined;
+            sourceAwareUnitScopeLabel?: string | undefined;
+            previousSourceAwareUnitScopeLabel?: string | undefined;
+            stageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            previousStageCounts: {
+                input?: number | undefined;
+                query_transform?: number | undefined;
+                routing?: number | undefined;
+                embed?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                diversity?: number | undefined;
+                source_balance?: number | undefined;
+                evidence_reconcile?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            traceChange: "new" | "changed" | "unchanged";
+        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[]>;
+    suites: import("vue").Ref<{
+        id: string;
+        label?: string | undefined;
+        description?: string | undefined;
+        input: {
+            cases: {
+                id: string;
+                query: string;
+                corpusKey?: string | undefined;
+                topK?: number | undefined;
+                model?: string | undefined;
+                scoreThreshold?: number | undefined;
+                filter?: Record<string, unknown> | undefined;
+                retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                    mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                    lexicalTopK?: number | undefined;
+                    maxResultsPerSource?: number | undefined;
+                    sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                    diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                    mmrLambda?: number | undefined;
+                    fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                    fusionConstant?: number | undefined;
+                    lexicalWeight?: number | undefined;
+                    vectorWeight?: number | undefined;
+                    nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                    nativeCandidateLimit?: number | undefined;
+                    nativeMaxBackfills?: number | undefined;
+                    nativeMinResults?: number | undefined;
+                    nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+                } | undefined;
+                expectedChunkIds?: string[] | undefined;
+                expectedSources?: string[] | undefined;
+                expectedDocumentIds?: string[] | undefined;
+                goldenSet?: boolean | undefined;
+                hardNegativeChunkIds?: string[] | undefined;
+                hardNegativeSources?: string[] | undefined;
+                hardNegativeDocumentIds?: string[] | undefined;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            model?: string | undefined;
+            filter?: Record<string, unknown> | undefined;
+            retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            dryRun?: boolean | undefined;
+        };
+        metadata?: Record<string, unknown> | undefined;
+    }[], RAGEvaluationSuite[] | {
+        id: string;
+        label?: string | undefined;
+        description?: string | undefined;
+        input: {
+            cases: {
+                id: string;
+                query: string;
+                corpusKey?: string | undefined;
+                topK?: number | undefined;
+                model?: string | undefined;
+                scoreThreshold?: number | undefined;
+                filter?: Record<string, unknown> | undefined;
+                retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                    mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                    lexicalTopK?: number | undefined;
+                    maxResultsPerSource?: number | undefined;
+                    sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                    diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                    mmrLambda?: number | undefined;
+                    fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                    fusionConstant?: number | undefined;
+                    lexicalWeight?: number | undefined;
+                    vectorWeight?: number | undefined;
+                    nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                    nativeCandidateLimit?: number | undefined;
+                    nativeMaxBackfills?: number | undefined;
+                    nativeMinResults?: number | undefined;
+                    nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+                } | undefined;
+                expectedChunkIds?: string[] | undefined;
+                expectedSources?: string[] | undefined;
+                expectedDocumentIds?: string[] | undefined;
+                goldenSet?: boolean | undefined;
+                hardNegativeChunkIds?: string[] | undefined;
+                hardNegativeSources?: string[] | undefined;
+                hardNegativeDocumentIds?: string[] | undefined;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            model?: string | undefined;
+            filter?: Record<string, unknown> | undefined;
+            retrieval?: import("@absolutejs/ai").RAGHybridRetrievalMode | {
+                mode?: import("@absolutejs/ai").RAGHybridRetrievalMode | undefined;
+                lexicalTopK?: number | undefined;
+                maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("@absolutejs/ai").RAGSourceBalanceStrategy | undefined;
+                diversityStrategy?: import("@absolutejs/ai").RAGDiversityStrategy | undefined;
+                mmrLambda?: number | undefined;
+                fusion?: import("@absolutejs/ai").RAGHybridFusionMode | undefined;
+                fusionConstant?: number | undefined;
+                lexicalWeight?: number | undefined;
+                vectorWeight?: number | undefined;
+                nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                nativeCandidateLimit?: number | undefined;
+                nativeMaxBackfills?: number | undefined;
+                nativeMinResults?: number | undefined;
+                nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            } | undefined;
+            dryRun?: boolean | undefined;
+        };
+        metadata?: Record<string, unknown> | undefined;
+    }[]>;
+};
+export type UseRAGEvaluateResult = ReturnType<typeof useRAGEvaluate>;