@absolutejs/rag 0.0.1

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

@@ -0,0 +1,2892 @@
+export type UseRAGOptions = {
+    autoLoadOps?: boolean;
+    autoLoadStatus?: boolean;
+    conversationId?: string;
+    streamPath?: string;
+};
+export declare const useRAG: (path: string, options?: UseRAGOptions) => {
+    chunkPreview: {
+        activeChunkId: import("vue").Ref<string | null, string | null>;
+        activeSectionDiagnostic: import("vue").ComputedRef<import("@absolutejs/ai").RAGSectionRetrievalDiagnostic | null>;
+        clear: () => void;
+        chunkGraph: import("vue").ComputedRef<import("@absolutejs/ai").RAGChunkGraph | null>;
+        error: import("vue").Ref<string | null, string | null>;
+        inspect: (id: string) => Promise<{
+            ok: true;
+        } & import("@absolutejs/ai").RAGDocumentChunkPreview>;
+        isLoading: import("vue").Ref<boolean, boolean>;
+        navigation: import("vue").ComputedRef<import("@absolutejs/ai").RAGChunkGraphNavigation | null>;
+        preview: import("vue").Ref<{
+            document: {
+                kind?: string | undefined;
+                source: string;
+                title: string;
+                corpusKey?: string | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+                id: string;
+                createdAt?: number | undefined;
+                chunkCount?: number | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            };
+            normalizedText: string;
+            chunks: {
+                chunkId: string;
+                corpusKey?: string | undefined;
+                text: string;
+                title?: string | undefined;
+                source?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                embedding?: number[] | undefined;
+                embeddingVariants?: {
+                    id: string;
+                    label?: string | undefined;
+                    text?: string | undefined;
+                    metadata?: Record<string, unknown> | undefined;
+                    embedding?: number[] | undefined;
+                }[] | undefined;
+                structure?: {
+                    section?: {
+                        title?: string | undefined;
+                        path?: string[] | undefined;
+                        depth?: number | undefined;
+                        kind?: "markdown_heading" | "html_heading" | "office_heading" | "office_block" | "pdf_block" | "spreadsheet_rows" | "presentation_slide" | undefined;
+                    } | undefined;
+                    sequence?: {
+                        sectionChunkId?: string | undefined;
+                        sectionChunkIndex?: number | undefined;
+                        sectionChunkCount?: number | undefined;
+                        previousChunkId?: string | undefined;
+                        nextChunkId?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+                excerpts?: {
+                    chunkExcerpt: string;
+                    windowExcerpt: string;
+                    sectionExcerpt: string;
+                } | undefined;
+                excerptSelection?: {
+                    mode: import("@absolutejs/ai").RAGExcerptMode;
+                    reason: import("@absolutejs/ai").RAGExcerptPromotionReason;
+                } | undefined;
+            }[];
+        } | null, import("@absolutejs/ai").RAGDocumentChunkPreview | {
+            document: {
+                kind?: string | undefined;
+                source: string;
+                title: string;
+                corpusKey?: string | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+                id: string;
+                createdAt?: number | undefined;
+                chunkCount?: number | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            };
+            normalizedText: string;
+            chunks: {
+                chunkId: string;
+                corpusKey?: string | undefined;
+                text: string;
+                title?: string | undefined;
+                source?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                embedding?: number[] | undefined;
+                embeddingVariants?: {
+                    id: string;
+                    label?: string | undefined;
+                    text?: string | undefined;
+                    metadata?: Record<string, unknown> | undefined;
+                    embedding?: number[] | undefined;
+                }[] | undefined;
+                structure?: {
+                    section?: {
+                        title?: string | undefined;
+                        path?: string[] | undefined;
+                        depth?: number | undefined;
+                        kind?: "markdown_heading" | "html_heading" | "office_heading" | "office_block" | "pdf_block" | "spreadsheet_rows" | "presentation_slide" | undefined;
+                    } | undefined;
+                    sequence?: {
+                        sectionChunkId?: string | undefined;
+                        sectionChunkIndex?: number | undefined;
+                        sectionChunkCount?: number | undefined;
+                        previousChunkId?: string | undefined;
+                        nextChunkId?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+                excerpts?: {
+                    chunkExcerpt: string;
+                    windowExcerpt: string;
+                    sectionExcerpt: string;
+                } | undefined;
+                excerptSelection?: {
+                    mode: import("@absolutejs/ai").RAGExcerptMode;
+                    reason: import("@absolutejs/ai").RAGExcerptPromotionReason;
+                } | undefined;
+            }[];
+        } | null>;
+        sectionDiagnostics: import("vue").ComputedRef<import("@absolutejs/ai").RAGSectionRetrievalDiagnostic[]>;
+        selectChildSection: (sectionId: string) => void;
+        selectChunk: (id: string | null) => void;
+        selectParentSection: () => void;
+        selectSiblingSection: (sectionId: string) => void;
+    };
+    citations: {
+        citationReferenceMap: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitationReferenceMap>;
+        citations: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitation[]>;
+        hasCitations: import("vue").ComputedRef<boolean>;
+        sourceGroups: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceGroup[]>;
+        sourceSummaries: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceSummary[]>;
+    };
+    documents: {
+        documents: import("vue").Ref<{
+            corpusKey?: string | undefined;
+            id: string;
+            title: string;
+            source: string;
+            text?: string | undefined;
+            kind?: string | undefined;
+            format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+            chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+            chunkSize?: number | undefined;
+            chunkCount?: number | undefined;
+            createdAt?: number | undefined;
+            updatedAt?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            labels?: {
+                contextLabel?: string | undefined;
+                locatorLabel?: string | undefined;
+                provenanceLabel?: string | undefined;
+            } | undefined;
+        }[], import("@absolutejs/ai").RAGIndexedDocument[] | {
+            corpusKey?: string | undefined;
+            id: string;
+            title: string;
+            source: string;
+            text?: string | undefined;
+            kind?: string | undefined;
+            format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+            chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+            chunkSize?: number | undefined;
+            chunkCount?: number | undefined;
+            createdAt?: number | undefined;
+            updatedAt?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            labels?: {
+                contextLabel?: string | undefined;
+                locatorLabel?: string | undefined;
+                provenanceLabel?: string | undefined;
+            } | undefined;
+        }[]>;
+        error: import("vue").Ref<string | null, string | null>;
+        isLoading: import("vue").Ref<boolean, boolean>;
+        lastResponse: import("vue").Ref<{
+            ok: true;
+            documents: {
+                corpusKey?: string | undefined;
+                id: string;
+                title: string;
+                source: string;
+                text?: string | undefined;
+                kind?: string | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                chunkCount?: number | undefined;
+                createdAt?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+            }[];
+            lastSeedMsByMode?: Record<string, number> | undefined;
+        } | null, import("@absolutejs/ai").RAGDocumentsResponse | {
+            ok: true;
+            documents: {
+                corpusKey?: string | undefined;
+                id: string;
+                title: string;
+                source: string;
+                text?: string | undefined;
+                kind?: string | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                chunkCount?: number | undefined;
+                createdAt?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+            }[];
+            lastSeedMsByMode?: Record<string, number> | undefined;
+        } | null>;
+        load: (kind?: string) => Promise<import("@absolutejs/ai").RAGDocumentsResponse>;
+        reset: () => void;
+    };
+    evaluate: {
+        clearRuns: () => void;
+        error: import("vue").Ref<string | null, string | null>;
+        evaluate: (input: import("@absolutejs/ai").RAGEvaluationInput) => Promise<import("@absolutejs/ai").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, import("@absolutejs/ai").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, import("@absolutejs/ai").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: import("@absolutejs/ai").RAGEvaluationSuite, overrides?: Partial<import("@absolutejs/ai").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: import("@absolutejs/ai").RAGEvaluationResponse;
+            startedAt: number;
+            suiteId: string;
+            traceSummary: import("@absolutejs/ai").RAGRetrievalTraceComparisonSummary | undefined;
+        }>;
+        saveSuite: (suite: import("@absolutejs/ai").RAGEvaluationSuite) => import("@absolutejs/ai").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;
+        }[], import("@absolutejs/ai").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;
+        }[], import("@absolutejs/ai").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;
+        }[]>;
+    };
+    grounding: {
+        coverage: import("vue").ComputedRef<"grounded" | "partial" | "ungrounded">;
+        groundedAnswer: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundedAnswer>;
+        hasCitations: import("vue").ComputedRef<boolean>;
+        hasGrounding: import("vue").ComputedRef<boolean>;
+        references: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundingReference[]>;
+        ungroundedReferenceNumbers: import("vue").ComputedRef<number[]>;
+    };
+    index: {
+        backends: import("vue").Ref<{
+            ok: true;
+            defaultMode?: string | undefined;
+            activeModeCookie?: string | undefined;
+            backends: {
+                id: string;
+                label: string;
+                path?: string | undefined;
+                available: boolean;
+                reason?: string | undefined;
+                lastSeedMs?: number | undefined;
+                status?: {
+                    backend: "in_memory" | "sqlite" | "postgres";
+                    vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                    dimensions?: number | undefined;
+                    native?: {
+                        requested: boolean;
+                        available: boolean;
+                        active: boolean;
+                        mode?: "vec0" | undefined;
+                        tableName?: string | undefined;
+                        distanceMetric?: "cosine" | "l2" | undefined;
+                        rowCount?: number | undefined;
+                        pageCount?: number | undefined;
+                        freelistCount?: number | undefined;
+                        databaseBytes?: number | undefined;
+                        lastHealthCheckAt?: number | undefined;
+                        lastAnalyzeAt?: number | undefined;
+                        resolution?: {
+                            status: import("@absolutejs/ai").SQLiteVecResolutionStatus;
+                            source: import("@absolutejs/ai").SQLiteVecResolutionSource;
+                            platformKey: string;
+                            packageName?: string | undefined;
+                            packageVersion?: string | undefined;
+                            packageRoot?: string | undefined;
+                            libraryFile?: string | undefined;
+                            libraryPath?: string | undefined;
+                            reason?: string | undefined;
+                        } | undefined;
+                        fallbackReason?: string | undefined;
+                        lastAnalyzeError?: string | undefined;
+                        lastHealthError?: string | undefined;
+                        lastLoadError?: string | undefined;
+                        lastQueryError?: string | undefined;
+                        lastUpsertError?: string | undefined;
+                        lastQueryPlan?: {
+                            pushdownMode: "none" | "partial" | "full";
+                            pushdownApplied: boolean;
+                            pushdownClauseCount: number;
+                            totalFilterClauseCount: number;
+                            jsRemainderClauseCount: number;
+                            plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                            queryMultiplierUsed?: number | undefined;
+                            candidateLimitUsed?: number | undefined;
+                            maxBackfillsUsed?: number | undefined;
+                            minResultsUsed?: number | undefined;
+                            fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                            pushdownCoverageRatio?: number | undefined;
+                            jsRemainderRatio?: number | undefined;
+                            filteredCandidateCount?: number | undefined;
+                            initialSearchK?: number | undefined;
+                            finalSearchK?: number | undefined;
+                            searchExpansionRatio?: number | undefined;
+                            backfillCount?: number | undefined;
+                            backfillLimitReached?: boolean | undefined;
+                            minResultsSatisfied?: boolean | undefined;
+                            returnedCount?: number | undefined;
+                            candidateYieldRatio?: number | undefined;
+                            topKFillRatio?: number | undefined;
+                            underfilledTopK?: boolean | undefined;
+                            candidateBudgetExhausted?: boolean | undefined;
+                            candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                            queryMode: "json_fallback" | "native_vec0";
+                        } | undefined;
+                    } | {
+                        requested: boolean;
+                        available: boolean;
+                        active: boolean;
+                        mode?: "pgvector" | undefined;
+                        extensionName?: string | undefined;
+                        schemaName?: string | undefined;
+                        tableName?: string | undefined;
+                        distanceMetric?: "cosine" | "l2" | "inner_product" | undefined;
+                        indexType?: "none" | "hnsw" | "ivfflat" | undefined;
+                        indexName?: string | undefined;
+                        indexPresent?: boolean | undefined;
+                        estimatedRowCount?: number | undefined;
+                        tableBytes?: number | undefined;
+                        indexBytes?: number | undefined;
+                        totalBytes?: number | undefined;
+                        lastHealthCheckAt?: number | undefined;
+                        lastAnalyzeAt?: number | undefined;
+                        lastReindexAt?: number | undefined;
+                        fallbackReason?: string | undefined;
+                        lastAnalyzeError?: string | undefined;
+                        lastInitError?: string | undefined;
+                        lastQueryError?: string | undefined;
+                        lastReindexError?: string | undefined;
+                        lastUpsertError?: string | undefined;
+                        lastMigrationError?: string | undefined;
+                        lastHealthError?: string | undefined;
+                        lastFilterDebug?: {
+                            filter?: Record<string, unknown> | undefined;
+                            pushdownFilter?: Record<string, unknown> | undefined;
+                            countSql?: string | undefined;
+                            countParams?: unknown[] | undefined;
+                            querySql?: string | undefined;
+                            queryParams?: unknown[] | undefined;
+                            countResultRaw?: unknown;
+                            queryRowCount?: number | undefined;
+                        } | undefined;
+                        lastQueryPlan?: {
+                            pushdownMode: "none" | "partial" | "full";
+                            pushdownApplied: boolean;
+                            pushdownClauseCount: number;
+                            totalFilterClauseCount: number;
+                            jsRemainderClauseCount: number;
+                            plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                            queryMultiplierUsed?: number | undefined;
+                            candidateLimitUsed?: number | undefined;
+                            maxBackfillsUsed?: number | undefined;
+                            minResultsUsed?: number | undefined;
+                            fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                            pushdownCoverageRatio?: number | undefined;
+                            jsRemainderRatio?: number | undefined;
+                            filteredCandidateCount?: number | undefined;
+                            initialSearchK?: number | undefined;
+                            finalSearchK?: number | undefined;
+                            searchExpansionRatio?: number | undefined;
+                            backfillCount?: number | undefined;
+                            backfillLimitReached?: boolean | undefined;
+                            minResultsSatisfied?: boolean | undefined;
+                            returnedCount?: number | undefined;
+                            candidateYieldRatio?: number | undefined;
+                            topKFillRatio?: number | undefined;
+                            underfilledTopK?: boolean | undefined;
+                            candidateBudgetExhausted?: boolean | undefined;
+                            candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                            queryMode: "native_pgvector";
+                        } | undefined;
+                    } | undefined;
+                } | undefined;
+                capabilities?: {
+                    backend: "in_memory" | "sqlite" | "postgres" | "custom";
+                    persistence: "memory_only" | "embedded" | "external";
+                    nativeVectorSearch: boolean;
+                    serverSideFiltering: boolean;
+                    streamingIngestStatus: boolean;
+                } | undefined;
+            }[];
+        } | null, import("@absolutejs/ai").RAGBackendsResponse | {
+            ok: true;
+            defaultMode?: string | undefined;
+            activeModeCookie?: string | undefined;
+            backends: {
+                id: string;
+                label: string;
+                path?: string | undefined;
+                available: boolean;
+                reason?: string | undefined;
+                lastSeedMs?: number | undefined;
+                status?: {
+                    backend: "in_memory" | "sqlite" | "postgres";
+                    vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                    dimensions?: number | undefined;
+                    native?: {
+                        requested: boolean;
+                        available: boolean;
+                        active: boolean;
+                        mode?: "vec0" | undefined;
+                        tableName?: string | undefined;
+                        distanceMetric?: "cosine" | "l2" | undefined;
+                        rowCount?: number | undefined;
+                        pageCount?: number | undefined;
+                        freelistCount?: number | undefined;
+                        databaseBytes?: number | undefined;
+                        lastHealthCheckAt?: number | undefined;
+                        lastAnalyzeAt?: number | undefined;
+                        resolution?: {
+                            status: import("@absolutejs/ai").SQLiteVecResolutionStatus;
+                            source: import("@absolutejs/ai").SQLiteVecResolutionSource;
+                            platformKey: string;
+                            packageName?: string | undefined;
+                            packageVersion?: string | undefined;
+                            packageRoot?: string | undefined;
+                            libraryFile?: string | undefined;
+                            libraryPath?: string | undefined;
+                            reason?: string | undefined;
+                        } | undefined;
+                        fallbackReason?: string | undefined;
+                        lastAnalyzeError?: string | undefined;
+                        lastHealthError?: string | undefined;
+                        lastLoadError?: string | undefined;
+                        lastQueryError?: string | undefined;
+                        lastUpsertError?: string | undefined;
+                        lastQueryPlan?: {
+                            pushdownMode: "none" | "partial" | "full";
+                            pushdownApplied: boolean;
+                            pushdownClauseCount: number;
+                            totalFilterClauseCount: number;
+                            jsRemainderClauseCount: number;
+                            plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                            queryMultiplierUsed?: number | undefined;
+                            candidateLimitUsed?: number | undefined;
+                            maxBackfillsUsed?: number | undefined;
+                            minResultsUsed?: number | undefined;
+                            fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                            pushdownCoverageRatio?: number | undefined;
+                            jsRemainderRatio?: number | undefined;
+                            filteredCandidateCount?: number | undefined;
+                            initialSearchK?: number | undefined;
+                            finalSearchK?: number | undefined;
+                            searchExpansionRatio?: number | undefined;
+                            backfillCount?: number | undefined;
+                            backfillLimitReached?: boolean | undefined;
+                            minResultsSatisfied?: boolean | undefined;
+                            returnedCount?: number | undefined;
+                            candidateYieldRatio?: number | undefined;
+                            topKFillRatio?: number | undefined;
+                            underfilledTopK?: boolean | undefined;
+                            candidateBudgetExhausted?: boolean | undefined;
+                            candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                            queryMode: "json_fallback" | "native_vec0";
+                        } | undefined;
+                    } | {
+                        requested: boolean;
+                        available: boolean;
+                        active: boolean;
+                        mode?: "pgvector" | undefined;
+                        extensionName?: string | undefined;
+                        schemaName?: string | undefined;
+                        tableName?: string | undefined;
+                        distanceMetric?: "cosine" | "l2" | "inner_product" | undefined;
+                        indexType?: "none" | "hnsw" | "ivfflat" | undefined;
+                        indexName?: string | undefined;
+                        indexPresent?: boolean | undefined;
+                        estimatedRowCount?: number | undefined;
+                        tableBytes?: number | undefined;
+                        indexBytes?: number | undefined;
+                        totalBytes?: number | undefined;
+                        lastHealthCheckAt?: number | undefined;
+                        lastAnalyzeAt?: number | undefined;
+                        lastReindexAt?: number | undefined;
+                        fallbackReason?: string | undefined;
+                        lastAnalyzeError?: string | undefined;
+                        lastInitError?: string | undefined;
+                        lastQueryError?: string | undefined;
+                        lastReindexError?: string | undefined;
+                        lastUpsertError?: string | undefined;
+                        lastMigrationError?: string | undefined;
+                        lastHealthError?: string | undefined;
+                        lastFilterDebug?: {
+                            filter?: Record<string, unknown> | undefined;
+                            pushdownFilter?: Record<string, unknown> | undefined;
+                            countSql?: string | undefined;
+                            countParams?: unknown[] | undefined;
+                            querySql?: string | undefined;
+                            queryParams?: unknown[] | undefined;
+                            countResultRaw?: unknown;
+                            queryRowCount?: number | undefined;
+                        } | undefined;
+                        lastQueryPlan?: {
+                            pushdownMode: "none" | "partial" | "full";
+                            pushdownApplied: boolean;
+                            pushdownClauseCount: number;
+                            totalFilterClauseCount: number;
+                            jsRemainderClauseCount: number;
+                            plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                            queryMultiplierUsed?: number | undefined;
+                            candidateLimitUsed?: number | undefined;
+                            maxBackfillsUsed?: number | undefined;
+                            minResultsUsed?: number | undefined;
+                            fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                            pushdownCoverageRatio?: number | undefined;
+                            jsRemainderRatio?: number | undefined;
+                            filteredCandidateCount?: number | undefined;
+                            initialSearchK?: number | undefined;
+                            finalSearchK?: number | undefined;
+                            searchExpansionRatio?: number | undefined;
+                            backfillCount?: number | undefined;
+                            backfillLimitReached?: boolean | undefined;
+                            minResultsSatisfied?: boolean | undefined;
+                            returnedCount?: number | undefined;
+                            candidateYieldRatio?: number | undefined;
+                            topKFillRatio?: number | undefined;
+                            underfilledTopK?: boolean | undefined;
+                            candidateBudgetExhausted?: boolean | undefined;
+                            candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                            queryMode: "native_pgvector";
+                        } | undefined;
+                    } | undefined;
+                } | undefined;
+                capabilities?: {
+                    backend: "in_memory" | "sqlite" | "postgres" | "custom";
+                    persistence: "memory_only" | "embedded" | "external";
+                    nativeVectorSearch: boolean;
+                    serverSideFiltering: boolean;
+                    streamingIngestStatus: boolean;
+                } | undefined;
+            }[];
+        } | null>;
+        analyzeBackend: () => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        clearIndex: () => Promise<{
+            ok: boolean;
+        }>;
+        createDocument: (input: {
+            id?: string;
+            title?: string;
+            source?: string;
+            text: string;
+            format?: import("@absolutejs/ai").RAGContentFormat;
+            metadata?: Record<string, unknown>;
+            chunking?: {
+                maxChunkLength?: number;
+                chunkOverlap?: number;
+                minChunkLength?: number;
+                strategy?: import("@absolutejs/ai").RAGChunkingStrategy;
+            };
+        }) => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        deleteDocument: (id: string) => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        error: import("vue").Ref<string | null, string | null>;
+        isLoading: import("vue").Ref<boolean, boolean>;
+        lastMutation: import("vue").Ref<{
+            ok: boolean;
+            error?: string | undefined;
+            deleted?: string | undefined;
+            inserted?: string | undefined;
+            reindexed?: string | undefined;
+            status?: string | undefined;
+            documents?: number | undefined;
+            maintenance?: {
+                backend: Exclude<import("@absolutejs/ai").RAGVectorStoreStatus["backend"], "in_memory">;
+                activeJobs: {
+                    action: "analyze_backend" | "rebuild_native_index";
+                    startedAt: number;
+                    target?: string | undefined;
+                }[];
+                recentActions: {
+                    action: "analyze_backend" | "rebuild_native_index";
+                    status: import("@absolutejs/ai").RAGAdminActionRecord["status"];
+                    finishedAt?: number | undefined;
+                    target?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                recommendations: {
+                    code: "backend_statistics_refresh_recommended" | "native_backend_inactive" | "native_backend_recent_errors" | "native_index_missing" | "native_index_rebuild_recommended" | "sqlite_storage_optimization_recommended";
+                    message: string;
+                    severity: "info" | "warning" | "error";
+                    action?: "analyze_backend" | "rebuild_native_index" | undefined;
+                }[];
+            } | undefined;
+            workflowStatus?: {
+                backend: "in_memory" | "sqlite" | "postgres";
+                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
+                    requested: boolean;
+                    available: boolean;
+                    active: boolean;
+                    mode?: "vec0" | undefined;
+                    tableName?: string | undefined;
+                    distanceMetric?: "cosine" | "l2" | undefined;
+                    rowCount?: number | undefined;
+                    pageCount?: number | undefined;
+                    freelistCount?: number | undefined;
+                    databaseBytes?: number | undefined;
+                    lastHealthCheckAt?: number | undefined;
+                    lastAnalyzeAt?: number | undefined;
+                    resolution?: {
+                        status: import("@absolutejs/ai").SQLiteVecResolutionStatus;
+                        source: import("@absolutejs/ai").SQLiteVecResolutionSource;
+                        platformKey: string;
+                        packageName?: string | undefined;
+                        packageVersion?: string | undefined;
+                        packageRoot?: string | undefined;
+                        libraryFile?: string | undefined;
+                        libraryPath?: string | undefined;
+                        reason?: string | undefined;
+                    } | undefined;
+                    fallbackReason?: string | undefined;
+                    lastAnalyzeError?: string | undefined;
+                    lastHealthError?: string | undefined;
+                    lastLoadError?: string | undefined;
+                    lastQueryError?: string | undefined;
+                    lastUpsertError?: string | undefined;
+                    lastQueryPlan?: {
+                        pushdownMode: "none" | "partial" | "full";
+                        pushdownApplied: boolean;
+                        pushdownClauseCount: number;
+                        totalFilterClauseCount: number;
+                        jsRemainderClauseCount: number;
+                        plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                        queryMultiplierUsed?: number | undefined;
+                        candidateLimitUsed?: number | undefined;
+                        maxBackfillsUsed?: number | undefined;
+                        minResultsUsed?: number | undefined;
+                        fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                        pushdownCoverageRatio?: number | undefined;
+                        jsRemainderRatio?: number | undefined;
+                        filteredCandidateCount?: number | undefined;
+                        initialSearchK?: number | undefined;
+                        finalSearchK?: number | undefined;
+                        searchExpansionRatio?: number | undefined;
+                        backfillCount?: number | undefined;
+                        backfillLimitReached?: boolean | undefined;
+                        minResultsSatisfied?: boolean | undefined;
+                        returnedCount?: number | undefined;
+                        candidateYieldRatio?: number | undefined;
+                        topKFillRatio?: number | undefined;
+                        underfilledTopK?: boolean | undefined;
+                        candidateBudgetExhausted?: boolean | undefined;
+                        candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                        queryMode: "json_fallback" | "native_vec0";
+                    } | undefined;
+                } | {
+                    requested: boolean;
+                    available: boolean;
+                    active: boolean;
+                    mode?: "pgvector" | undefined;
+                    extensionName?: string | undefined;
+                    schemaName?: string | undefined;
+                    tableName?: string | undefined;
+                    distanceMetric?: "cosine" | "l2" | "inner_product" | undefined;
+                    indexType?: "none" | "hnsw" | "ivfflat" | undefined;
+                    indexName?: string | undefined;
+                    indexPresent?: boolean | undefined;
+                    estimatedRowCount?: number | undefined;
+                    tableBytes?: number | undefined;
+                    indexBytes?: number | undefined;
+                    totalBytes?: number | undefined;
+                    lastHealthCheckAt?: number | undefined;
+                    lastAnalyzeAt?: number | undefined;
+                    lastReindexAt?: number | undefined;
+                    fallbackReason?: string | undefined;
+                    lastAnalyzeError?: string | undefined;
+                    lastInitError?: string | undefined;
+                    lastQueryError?: string | undefined;
+                    lastReindexError?: string | undefined;
+                    lastUpsertError?: string | undefined;
+                    lastMigrationError?: string | undefined;
+                    lastHealthError?: string | undefined;
+                    lastFilterDebug?: {
+                        filter?: Record<string, unknown> | undefined;
+                        pushdownFilter?: Record<string, unknown> | undefined;
+                        countSql?: string | undefined;
+                        countParams?: unknown[] | undefined;
+                        querySql?: string | undefined;
+                        queryParams?: unknown[] | undefined;
+                        countResultRaw?: unknown;
+                        queryRowCount?: number | undefined;
+                    } | undefined;
+                    lastQueryPlan?: {
+                        pushdownMode: "none" | "partial" | "full";
+                        pushdownApplied: boolean;
+                        pushdownClauseCount: number;
+                        totalFilterClauseCount: number;
+                        jsRemainderClauseCount: number;
+                        plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                        queryMultiplierUsed?: number | undefined;
+                        candidateLimitUsed?: number | undefined;
+                        maxBackfillsUsed?: number | undefined;
+                        minResultsUsed?: number | undefined;
+                        fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                        pushdownCoverageRatio?: number | undefined;
+                        jsRemainderRatio?: number | undefined;
+                        filteredCandidateCount?: number | undefined;
+                        initialSearchK?: number | undefined;
+                        finalSearchK?: number | undefined;
+                        searchExpansionRatio?: number | undefined;
+                        backfillCount?: number | undefined;
+                        backfillLimitReached?: boolean | undefined;
+                        minResultsSatisfied?: boolean | undefined;
+                        returnedCount?: number | undefined;
+                        candidateYieldRatio?: number | undefined;
+                        topKFillRatio?: number | undefined;
+                        underfilledTopK?: boolean | undefined;
+                        candidateBudgetExhausted?: boolean | undefined;
+                        candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                        queryMode: "native_pgvector";
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+            admin?: {
+                canAnalyzeBackend: boolean;
+                canClearIndex: boolean;
+                canCreateDocument: boolean;
+                canDeleteDocument: boolean;
+                canListSyncSources: boolean;
+                canManageRetrievalBaselines: boolean;
+                canPruneSearchTraces: boolean;
+                canRebuildNativeIndex: boolean;
+                canReindexDocument: boolean;
+                canReindexSource: boolean;
+                canReseed: boolean;
+                canReset: boolean;
+                canSyncAllSources: boolean;
+                canSyncSource: boolean;
+            } | undefined;
+            adminActions?: {
+                id: string;
+                action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+                status: "completed" | "failed";
+                startedAt: number;
+                finishedAt?: number | undefined;
+                elapsedMs?: number | undefined;
+                documentId?: string | undefined;
+                target?: string | undefined;
+                error?: string | undefined;
+            }[] | undefined;
+            adminJobs?: {
+                id: string;
+                action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+                status: import("@absolutejs/ai").RAGAdminJobStatus;
+                startedAt: number;
+                finishedAt?: number | undefined;
+                elapsedMs?: number | undefined;
+                target?: string | undefined;
+                error?: string | undefined;
+            }[] | undefined;
+            backendStats?: Record<string, {
+                chunkCount: number;
+                totalDocuments: number;
+                elapsedMs: number;
+            }> | undefined;
+            document?: {
+                corpusKey?: string | undefined;
+                id: string;
+                title: string;
+                source: string;
+                text?: string | undefined;
+                kind?: string | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                chunkCount?: number | undefined;
+                createdAt?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | null, import("@absolutejs/ai").RAGMutationResponse | {
+            ok: boolean;
+            error?: string | undefined;
+            deleted?: string | undefined;
+            inserted?: string | undefined;
+            reindexed?: string | undefined;
+            status?: string | undefined;
+            documents?: number | undefined;
+            maintenance?: {
+                backend: Exclude<import("@absolutejs/ai").RAGVectorStoreStatus["backend"], "in_memory">;
+                activeJobs: {
+                    action: "analyze_backend" | "rebuild_native_index";
+                    startedAt: number;
+                    target?: string | undefined;
+                }[];
+                recentActions: {
+                    action: "analyze_backend" | "rebuild_native_index";
+                    status: import("@absolutejs/ai").RAGAdminActionRecord["status"];
+                    finishedAt?: number | undefined;
+                    target?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                recommendations: {
+                    code: "backend_statistics_refresh_recommended" | "native_backend_inactive" | "native_backend_recent_errors" | "native_index_missing" | "native_index_rebuild_recommended" | "sqlite_storage_optimization_recommended";
+                    message: string;
+                    severity: "info" | "warning" | "error";
+                    action?: "analyze_backend" | "rebuild_native_index" | undefined;
+                }[];
+            } | undefined;
+            workflowStatus?: {
+                backend: "in_memory" | "sqlite" | "postgres";
+                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
+                    requested: boolean;
+                    available: boolean;
+                    active: boolean;
+                    mode?: "vec0" | undefined;
+                    tableName?: string | undefined;
+                    distanceMetric?: "cosine" | "l2" | undefined;
+                    rowCount?: number | undefined;
+                    pageCount?: number | undefined;
+                    freelistCount?: number | undefined;
+                    databaseBytes?: number | undefined;
+                    lastHealthCheckAt?: number | undefined;
+                    lastAnalyzeAt?: number | undefined;
+                    resolution?: {
+                        status: import("@absolutejs/ai").SQLiteVecResolutionStatus;
+                        source: import("@absolutejs/ai").SQLiteVecResolutionSource;
+                        platformKey: string;
+                        packageName?: string | undefined;
+                        packageVersion?: string | undefined;
+                        packageRoot?: string | undefined;
+                        libraryFile?: string | undefined;
+                        libraryPath?: string | undefined;
+                        reason?: string | undefined;
+                    } | undefined;
+                    fallbackReason?: string | undefined;
+                    lastAnalyzeError?: string | undefined;
+                    lastHealthError?: string | undefined;
+                    lastLoadError?: string | undefined;
+                    lastQueryError?: string | undefined;
+                    lastUpsertError?: string | undefined;
+                    lastQueryPlan?: {
+                        pushdownMode: "none" | "partial" | "full";
+                        pushdownApplied: boolean;
+                        pushdownClauseCount: number;
+                        totalFilterClauseCount: number;
+                        jsRemainderClauseCount: number;
+                        plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                        queryMultiplierUsed?: number | undefined;
+                        candidateLimitUsed?: number | undefined;
+                        maxBackfillsUsed?: number | undefined;
+                        minResultsUsed?: number | undefined;
+                        fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                        pushdownCoverageRatio?: number | undefined;
+                        jsRemainderRatio?: number | undefined;
+                        filteredCandidateCount?: number | undefined;
+                        initialSearchK?: number | undefined;
+                        finalSearchK?: number | undefined;
+                        searchExpansionRatio?: number | undefined;
+                        backfillCount?: number | undefined;
+                        backfillLimitReached?: boolean | undefined;
+                        minResultsSatisfied?: boolean | undefined;
+                        returnedCount?: number | undefined;
+                        candidateYieldRatio?: number | undefined;
+                        topKFillRatio?: number | undefined;
+                        underfilledTopK?: boolean | undefined;
+                        candidateBudgetExhausted?: boolean | undefined;
+                        candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                        queryMode: "json_fallback" | "native_vec0";
+                    } | undefined;
+                } | {
+                    requested: boolean;
+                    available: boolean;
+                    active: boolean;
+                    mode?: "pgvector" | undefined;
+                    extensionName?: string | undefined;
+                    schemaName?: string | undefined;
+                    tableName?: string | undefined;
+                    distanceMetric?: "cosine" | "l2" | "inner_product" | undefined;
+                    indexType?: "none" | "hnsw" | "ivfflat" | undefined;
+                    indexName?: string | undefined;
+                    indexPresent?: boolean | undefined;
+                    estimatedRowCount?: number | undefined;
+                    tableBytes?: number | undefined;
+                    indexBytes?: number | undefined;
+                    totalBytes?: number | undefined;
+                    lastHealthCheckAt?: number | undefined;
+                    lastAnalyzeAt?: number | undefined;
+                    lastReindexAt?: number | undefined;
+                    fallbackReason?: string | undefined;
+                    lastAnalyzeError?: string | undefined;
+                    lastInitError?: string | undefined;
+                    lastQueryError?: string | undefined;
+                    lastReindexError?: string | undefined;
+                    lastUpsertError?: string | undefined;
+                    lastMigrationError?: string | undefined;
+                    lastHealthError?: string | undefined;
+                    lastFilterDebug?: {
+                        filter?: Record<string, unknown> | undefined;
+                        pushdownFilter?: Record<string, unknown> | undefined;
+                        countSql?: string | undefined;
+                        countParams?: unknown[] | undefined;
+                        querySql?: string | undefined;
+                        queryParams?: unknown[] | undefined;
+                        countResultRaw?: unknown;
+                        queryRowCount?: number | undefined;
+                    } | undefined;
+                    lastQueryPlan?: {
+                        pushdownMode: "none" | "partial" | "full";
+                        pushdownApplied: boolean;
+                        pushdownClauseCount: number;
+                        totalFilterClauseCount: number;
+                        jsRemainderClauseCount: number;
+                        plannerProfileUsed?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+                        queryMultiplierUsed?: number | undefined;
+                        candidateLimitUsed?: number | undefined;
+                        maxBackfillsUsed?: number | undefined;
+                        minResultsUsed?: number | undefined;
+                        fillPolicyUsed?: "strict_topk" | "satisfy_min_results" | undefined;
+                        pushdownCoverageRatio?: number | undefined;
+                        jsRemainderRatio?: number | undefined;
+                        filteredCandidateCount?: number | undefined;
+                        initialSearchK?: number | undefined;
+                        finalSearchK?: number | undefined;
+                        searchExpansionRatio?: number | undefined;
+                        backfillCount?: number | undefined;
+                        backfillLimitReached?: boolean | undefined;
+                        minResultsSatisfied?: boolean | undefined;
+                        returnedCount?: number | undefined;
+                        candidateYieldRatio?: number | undefined;
+                        topKFillRatio?: number | undefined;
+                        underfilledTopK?: boolean | undefined;
+                        candidateBudgetExhausted?: boolean | undefined;
+                        candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
+                        queryMode: "native_pgvector";
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+            admin?: {
+                canAnalyzeBackend: boolean;
+                canClearIndex: boolean;
+                canCreateDocument: boolean;
+                canDeleteDocument: boolean;
+                canListSyncSources: boolean;
+                canManageRetrievalBaselines: boolean;
+                canPruneSearchTraces: boolean;
+                canRebuildNativeIndex: boolean;
+                canReindexDocument: boolean;
+                canReindexSource: boolean;
+                canReseed: boolean;
+                canReset: boolean;
+                canSyncAllSources: boolean;
+                canSyncSource: boolean;
+            } | undefined;
+            adminActions?: {
+                id: string;
+                action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+                status: "completed" | "failed";
+                startedAt: number;
+                finishedAt?: number | undefined;
+                elapsedMs?: number | undefined;
+                documentId?: string | undefined;
+                target?: string | undefined;
+                error?: string | undefined;
+            }[] | undefined;
+            adminJobs?: {
+                id: string;
+                action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+                status: import("@absolutejs/ai").RAGAdminJobStatus;
+                startedAt: number;
+                finishedAt?: number | undefined;
+                elapsedMs?: number | undefined;
+                target?: string | undefined;
+                error?: string | undefined;
+            }[] | undefined;
+            backendStats?: Record<string, {
+                chunkCount: number;
+                totalDocuments: number;
+                elapsedMs: number;
+            }> | undefined;
+            document?: {
+                corpusKey?: string | undefined;
+                id: string;
+                title: string;
+                source: string;
+                text?: string | undefined;
+                kind?: string | undefined;
+                format?: import("@absolutejs/ai").RAGContentFormat | undefined;
+                chunkStrategy?: import("@absolutejs/ai").RAGChunkingStrategy | undefined;
+                chunkSize?: number | undefined;
+                chunkCount?: number | undefined;
+                createdAt?: number | undefined;
+                updatedAt?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                labels?: {
+                    contextLabel?: string | undefined;
+                    locatorLabel?: string | undefined;
+                    provenanceLabel?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | null>;
+        loadBackends: () => Promise<import("@absolutejs/ai").RAGBackendsResponse>;
+        loadSyncSources: () => Promise<import("@absolutejs/ai").RAGSyncResponse>;
+        rebuildNativeIndex: () => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        reindexDocument: (id: string) => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        reindexSource: (source: string) => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        reseed: () => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        reset: () => Promise<import("@absolutejs/ai").RAGMutationResponse>;
+        resetState: () => void;
+        syncAllSources: (options?: import("@absolutejs/ai").RAGSyncRunOptions) => Promise<{
+            ok: true;
+            source: import("@absolutejs/ai").RAGSyncSourceRecord;
+            partial?: boolean;
+        } | {
+            ok: true;
+            sources: import("@absolutejs/ai").RAGSyncSourceRecord[];
+            partial?: boolean;
+            failedSourceIds?: string[];
+            errorsBySource?: Record<string, string>;
+        }>;
+        syncSource: (id: string, options?: import("@absolutejs/ai").RAGSyncRunOptions) => Promise<{
+            ok: true;
+            source: import("@absolutejs/ai").RAGSyncSourceRecord;
+            partial?: boolean;
+        } | {
+            ok: true;
+            sources: import("@absolutejs/ai").RAGSyncSourceRecord[];
+            partial?: boolean;
+            failedSourceIds?: string[];
+            errorsBySource?: Record<string, string>;
+        }>;
+        syncSources: import("vue").Ref<{
+            ok: true;
+            source: {
+                id: string;
+                label: string;
+                kind: "directory" | "url" | "storage" | "email" | "custom";
+                status: import("@absolutejs/ai").RAGSyncSourceStatus;
+                description?: string | undefined;
+                target?: string | undefined;
+                lastStartedAt?: number | undefined;
+                lastSyncedAt?: number | undefined;
+                lastSyncDurationMs?: number | undefined;
+                lastError?: string | undefined;
+                lastSuccessfulSyncAt?: number | undefined;
+                consecutiveFailures?: number | undefined;
+                retryAttempts?: number | undefined;
+                nextRetryAt?: number | undefined;
+                documentCount?: number | undefined;
+                chunkCount?: number | undefined;
+                reconciliation?: {
+                    refreshMode: "noop" | "targeted";
+                    staleDocumentIds: string[];
+                    staleSyncKeys: string[];
+                    refreshedDocumentIds: string[];
+                    refreshedSyncKeys: string[];
+                    unchangedDocumentIds: string[];
+                    unchangedSyncKeys: string[];
+                    targetedRefreshSyncKeys: string[];
+                    duplicateSyncKeyGroups: {
+                        syncKey: string;
+                        count: number;
+                        documentIds: string[];
+                    }[];
+                    lineageConflicts: {
+                        syncKey: string;
+                        lineageIds: string[];
+                        versionIds: string[];
+                        latestDocumentIds: string[];
+                        documentIds: string[];
+                        documents: {
+                            documentId: string;
+                            lineageId?: string | undefined;
+                            versionId?: string | undefined;
+                            versionNumber?: number | undefined;
+                            isLatestVersion: boolean;
+                        }[];
+                        reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                    }[];
+                } | undefined;
+                diagnostics?: {
+                    summary: string;
+                    entries: {
+                        code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                        severity: "info" | "warning" | "error";
+                        summary: string;
+                    }[];
+                    extractionFailures?: {
+                        itemLabel: string;
+                        itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                        reason: string;
+                        remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                    }[] | undefined;
+                    retryGuidance?: {
+                        action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                        reason: string;
+                        nextRetryAt?: number | undefined;
+                        resumeCursor?: string | undefined;
+                        syncKeys?: string[] | undefined;
+                    } | undefined;
+                } | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            };
+            partial?: boolean | undefined;
+        } | {
+            ok: true;
+            sources: {
+                id: string;
+                label: string;
+                kind: "directory" | "url" | "storage" | "email" | "custom";
+                status: import("@absolutejs/ai").RAGSyncSourceStatus;
+                description?: string | undefined;
+                target?: string | undefined;
+                lastStartedAt?: number | undefined;
+                lastSyncedAt?: number | undefined;
+                lastSyncDurationMs?: number | undefined;
+                lastError?: string | undefined;
+                lastSuccessfulSyncAt?: number | undefined;
+                consecutiveFailures?: number | undefined;
+                retryAttempts?: number | undefined;
+                nextRetryAt?: number | undefined;
+                documentCount?: number | undefined;
+                chunkCount?: number | undefined;
+                reconciliation?: {
+                    refreshMode: "noop" | "targeted";
+                    staleDocumentIds: string[];
+                    staleSyncKeys: string[];
+                    refreshedDocumentIds: string[];
+                    refreshedSyncKeys: string[];
+                    unchangedDocumentIds: string[];
+                    unchangedSyncKeys: string[];
+                    targetedRefreshSyncKeys: string[];
+                    duplicateSyncKeyGroups: {
+                        syncKey: string;
+                        count: number;
+                        documentIds: string[];
+                    }[];
+                    lineageConflicts: {
+                        syncKey: string;
+                        lineageIds: string[];
+                        versionIds: string[];
+                        latestDocumentIds: string[];
+                        documentIds: string[];
+                        documents: {
+                            documentId: string;
+                            lineageId?: string | undefined;
+                            versionId?: string | undefined;
+                            versionNumber?: number | undefined;
+                            isLatestVersion: boolean;
+                        }[];
+                        reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                    }[];
+                } | undefined;
+                diagnostics?: {
+                    summary: string;
+                    entries: {
+                        code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                        severity: "info" | "warning" | "error";
+                        summary: string;
+                    }[];
+                    extractionFailures?: {
+                        itemLabel: string;
+                        itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                        reason: string;
+                        remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                    }[] | undefined;
+                    retryGuidance?: {
+                        action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                        reason: string;
+                        nextRetryAt?: number | undefined;
+                        resumeCursor?: string | undefined;
+                        syncKeys?: string[] | undefined;
+                    } | undefined;
+                } | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            partial?: boolean | undefined;
+            failedSourceIds?: string[] | undefined;
+            errorsBySource?: Record<string, string> | undefined;
+        } | {
+            ok: false;
+            error: string;
+        } | null, import("@absolutejs/ai").RAGSyncResponse | {
+            ok: true;
+            source: {
+                id: string;
+                label: string;
+                kind: "directory" | "url" | "storage" | "email" | "custom";
+                status: import("@absolutejs/ai").RAGSyncSourceStatus;
+                description?: string | undefined;
+                target?: string | undefined;
+                lastStartedAt?: number | undefined;
+                lastSyncedAt?: number | undefined;
+                lastSyncDurationMs?: number | undefined;
+                lastError?: string | undefined;
+                lastSuccessfulSyncAt?: number | undefined;
+                consecutiveFailures?: number | undefined;
+                retryAttempts?: number | undefined;
+                nextRetryAt?: number | undefined;
+                documentCount?: number | undefined;
+                chunkCount?: number | undefined;
+                reconciliation?: {
+                    refreshMode: "noop" | "targeted";
+                    staleDocumentIds: string[];
+                    staleSyncKeys: string[];
+                    refreshedDocumentIds: string[];
+                    refreshedSyncKeys: string[];
+                    unchangedDocumentIds: string[];
+                    unchangedSyncKeys: string[];
+                    targetedRefreshSyncKeys: string[];
+                    duplicateSyncKeyGroups: {
+                        syncKey: string;
+                        count: number;
+                        documentIds: string[];
+                    }[];
+                    lineageConflicts: {
+                        syncKey: string;
+                        lineageIds: string[];
+                        versionIds: string[];
+                        latestDocumentIds: string[];
+                        documentIds: string[];
+                        documents: {
+                            documentId: string;
+                            lineageId?: string | undefined;
+                            versionId?: string | undefined;
+                            versionNumber?: number | undefined;
+                            isLatestVersion: boolean;
+                        }[];
+                        reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                    }[];
+                } | undefined;
+                diagnostics?: {
+                    summary: string;
+                    entries: {
+                        code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                        severity: "info" | "warning" | "error";
+                        summary: string;
+                    }[];
+                    extractionFailures?: {
+                        itemLabel: string;
+                        itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                        reason: string;
+                        remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                    }[] | undefined;
+                    retryGuidance?: {
+                        action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                        reason: string;
+                        nextRetryAt?: number | undefined;
+                        resumeCursor?: string | undefined;
+                        syncKeys?: string[] | undefined;
+                    } | undefined;
+                } | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            };
+            partial?: boolean | undefined;
+        } | {
+            ok: true;
+            sources: {
+                id: string;
+                label: string;
+                kind: "directory" | "url" | "storage" | "email" | "custom";
+                status: import("@absolutejs/ai").RAGSyncSourceStatus;
+                description?: string | undefined;
+                target?: string | undefined;
+                lastStartedAt?: number | undefined;
+                lastSyncedAt?: number | undefined;
+                lastSyncDurationMs?: number | undefined;
+                lastError?: string | undefined;
+                lastSuccessfulSyncAt?: number | undefined;
+                consecutiveFailures?: number | undefined;
+                retryAttempts?: number | undefined;
+                nextRetryAt?: number | undefined;
+                documentCount?: number | undefined;
+                chunkCount?: number | undefined;
+                reconciliation?: {
+                    refreshMode: "noop" | "targeted";
+                    staleDocumentIds: string[];
+                    staleSyncKeys: string[];
+                    refreshedDocumentIds: string[];
+                    refreshedSyncKeys: string[];
+                    unchangedDocumentIds: string[];
+                    unchangedSyncKeys: string[];
+                    targetedRefreshSyncKeys: string[];
+                    duplicateSyncKeyGroups: {
+                        syncKey: string;
+                        count: number;
+                        documentIds: string[];
+                    }[];
+                    lineageConflicts: {
+                        syncKey: string;
+                        lineageIds: string[];
+                        versionIds: string[];
+                        latestDocumentIds: string[];
+                        documentIds: string[];
+                        documents: {
+                            documentId: string;
+                            lineageId?: string | undefined;
+                            versionId?: string | undefined;
+                            versionNumber?: number | undefined;
+                            isLatestVersion: boolean;
+                        }[];
+                        reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                    }[];
+                } | undefined;
+                diagnostics?: {
+                    summary: string;
+                    entries: {
+                        code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                        severity: "info" | "warning" | "error";
+                        summary: string;
+                    }[];
+                    extractionFailures?: {
+                        itemLabel: string;
+                        itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                        reason: string;
+                        remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                    }[] | undefined;
+                    retryGuidance?: {
+                        action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                        reason: string;
+                        nextRetryAt?: number | undefined;
+                        resumeCursor?: string | undefined;
+                        syncKeys?: string[] | undefined;
+                    } | undefined;
+                } | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }[];
+            partial?: boolean | undefined;
+            failedSourceIds?: string[] | undefined;
+            errorsBySource?: Record<string, string> | undefined;
+        } | {
+            ok: false;
+            error: string;
+        } | null>;
+    };
+    ingest: {
+        clearIndex: () => Promise<{
+            ok: boolean;
+        }>;
+        error: import("vue").Ref<string | null, string | null>;
+        ingest: (chunks: import("@absolutejs/ai").RAGDocumentChunk[]) => Promise<import("@absolutejs/ai").RAGIngestResponse>;
+        ingestChunks: (chunks: import("@absolutejs/ai").RAGDocumentChunk[]) => Promise<import("@absolutejs/ai").RAGIngestResponse>;
+        ingestDocuments: (input: import("@absolutejs/ai").RAGDocumentIngestInput) => Promise<import("@absolutejs/ai").RAGIngestResponse>;
+        ingestUploads: (input: import("@absolutejs/ai").RAGDocumentUploadIngestInput) => Promise<import("@absolutejs/ai").RAGIngestResponse>;
+        ingestUrls: (input: import("@absolutejs/ai").RAGDocumentUrlIngestInput) => Promise<import("@absolutejs/ai").RAGIngestResponse>;
+        isIngesting: import("vue").Ref<boolean, boolean>;
+        lastDocumentCount: import("vue").Ref<number | null, number | null>;
+        lastIngestCount: import("vue").Ref<number | null, number | null>;
+        lastResponse: import("vue").Ref<{
+            ok: boolean;
+            count?: number | undefined;
+            documentCount?: number | undefined;
+            error?: string | undefined;
+        } | null, import("@absolutejs/ai").RAGIngestResponse | {
+            ok: boolean;
+            count?: number | undefined;
+            documentCount?: number | undefined;
+            error?: string | undefined;
+        } | null>;
+        reset: () => void;
+    };
+    ops: {
+        admin: import("vue").Ref<import("@absolutejs/ai").RAGAdminCapabilities | undefined, import("@absolutejs/ai").RAGAdminCapabilities | undefined>;
+        adminActions: import("vue").Ref<{
+            id: string;
+            action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+            status: "completed" | "failed";
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            documentId?: string | undefined;
+            target?: string | undefined;
+            error?: string | undefined;
+        }[], import("@absolutejs/ai").RAGAdminActionRecord[] | {
+            id: string;
+            action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+            status: "completed" | "failed";
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            documentId?: string | undefined;
+            target?: string | undefined;
+            error?: string | undefined;
+        }[]>;
+        adminJobs: import("vue").Ref<{
+            id: string;
+            action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+            status: import("@absolutejs/ai").RAGAdminJobStatus;
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            target?: string | undefined;
+            error?: string | undefined;
+        }[], import("@absolutejs/ai").RAGAdminJobRecord[] | {
+            id: string;
+            action: "analyze_backend" | "rebuild_native_index" | "clear_index" | "create_document" | "delete_document" | "promote_retrieval_baseline" | "revert_retrieval_baseline" | "prune_search_traces" | "reindex_document" | "reindex_source" | "sync_all_sources" | "sync_source" | "reseed" | "reset";
+            status: import("@absolutejs/ai").RAGAdminJobStatus;
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            target?: string | undefined;
+            error?: string | undefined;
+        }[]>;
+        capabilities: import("vue").Ref<import("@absolutejs/ai").RAGBackendCapabilities | undefined, import("@absolutejs/ai").RAGBackendCapabilities | undefined>;
+        documents: import("vue").Ref<import("@absolutejs/ai").RAGDocumentSummary | undefined, import("@absolutejs/ai").RAGDocumentSummary | undefined>;
+        error: import("vue").Ref<string | null, string | null>;
+        health: import("vue").Ref<import("@absolutejs/ai").RAGCorpusHealth | undefined, import("@absolutejs/ai").RAGCorpusHealth | undefined>;
+        ingestJobs: import("vue").Ref<{
+            id: string;
+            status: import("@absolutejs/ai").RAGIngestJobStatus;
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            inputKind: "chunks" | "documents" | "urls" | "uploads";
+            requestedCount: number;
+            chunkCount?: number | undefined;
+            documentCount?: number | undefined;
+            error?: string | undefined;
+            extractorNames?: string[] | undefined;
+        }[], import("@absolutejs/ai").RAGIngestJobRecord[] | {
+            id: string;
+            status: import("@absolutejs/ai").RAGIngestJobStatus;
+            startedAt: number;
+            finishedAt?: number | undefined;
+            elapsedMs?: number | undefined;
+            inputKind: "chunks" | "documents" | "urls" | "uploads";
+            requestedCount: number;
+            chunkCount?: number | undefined;
+            documentCount?: number | undefined;
+            error?: string | undefined;
+            extractorNames?: string[] | undefined;
+        }[]>;
+        isLoading: import("vue").Ref<boolean, boolean>;
+        maintenance: import("vue").Ref<import("@absolutejs/ai").RAGBackendMaintenanceSummary | undefined, import("@absolutejs/ai").RAGBackendMaintenanceSummary | undefined>;
+        operations: import("vue").Ref<import("@absolutejs/ai").RAGOperationsResponse | undefined, import("@absolutejs/ai").RAGOperationsResponse | undefined>;
+        readiness: import("vue").Ref<import("@absolutejs/ai").RAGExtractorReadiness | undefined, import("@absolutejs/ai").RAGExtractorReadiness | undefined>;
+        refresh: () => Promise<import("@absolutejs/ai").RAGOperationsResponse>;
+        reset: () => void;
+        status: import("vue").Ref<import("@absolutejs/ai").RAGVectorStoreStatus | undefined, import("@absolutejs/ai").RAGVectorStoreStatus | undefined>;
+        syncSources: import("vue").Ref<{
+            id: string;
+            label: string;
+            kind: "directory" | "url" | "storage" | "email" | "custom";
+            status: import("@absolutejs/ai").RAGSyncSourceStatus;
+            description?: string | undefined;
+            target?: string | undefined;
+            lastStartedAt?: number | undefined;
+            lastSyncedAt?: number | undefined;
+            lastSyncDurationMs?: number | undefined;
+            lastError?: string | undefined;
+            lastSuccessfulSyncAt?: number | undefined;
+            consecutiveFailures?: number | undefined;
+            retryAttempts?: number | undefined;
+            nextRetryAt?: number | undefined;
+            documentCount?: number | undefined;
+            chunkCount?: number | undefined;
+            reconciliation?: {
+                refreshMode: "noop" | "targeted";
+                staleDocumentIds: string[];
+                staleSyncKeys: string[];
+                refreshedDocumentIds: string[];
+                refreshedSyncKeys: string[];
+                unchangedDocumentIds: string[];
+                unchangedSyncKeys: string[];
+                targetedRefreshSyncKeys: string[];
+                duplicateSyncKeyGroups: {
+                    syncKey: string;
+                    count: number;
+                    documentIds: string[];
+                }[];
+                lineageConflicts: {
+                    syncKey: string;
+                    lineageIds: string[];
+                    versionIds: string[];
+                    latestDocumentIds: string[];
+                    documentIds: string[];
+                    documents: {
+                        documentId: string;
+                        lineageId?: string | undefined;
+                        versionId?: string | undefined;
+                        versionNumber?: number | undefined;
+                        isLatestVersion: boolean;
+                    }[];
+                    reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                }[];
+            } | undefined;
+            diagnostics?: {
+                summary: string;
+                entries: {
+                    code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                    severity: "info" | "warning" | "error";
+                    summary: string;
+                }[];
+                extractionFailures?: {
+                    itemLabel: string;
+                    itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                    reason: string;
+                    remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                }[] | undefined;
+                retryGuidance?: {
+                    action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                    reason: string;
+                    nextRetryAt?: number | undefined;
+                    resumeCursor?: string | undefined;
+                    syncKeys?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[], import("@absolutejs/ai").RAGSyncSourceRecord[] | {
+            id: string;
+            label: string;
+            kind: "directory" | "url" | "storage" | "email" | "custom";
+            status: import("@absolutejs/ai").RAGSyncSourceStatus;
+            description?: string | undefined;
+            target?: string | undefined;
+            lastStartedAt?: number | undefined;
+            lastSyncedAt?: number | undefined;
+            lastSyncDurationMs?: number | undefined;
+            lastError?: string | undefined;
+            lastSuccessfulSyncAt?: number | undefined;
+            consecutiveFailures?: number | undefined;
+            retryAttempts?: number | undefined;
+            nextRetryAt?: number | undefined;
+            documentCount?: number | undefined;
+            chunkCount?: number | undefined;
+            reconciliation?: {
+                refreshMode: "noop" | "targeted";
+                staleDocumentIds: string[];
+                staleSyncKeys: string[];
+                refreshedDocumentIds: string[];
+                refreshedSyncKeys: string[];
+                unchangedDocumentIds: string[];
+                unchangedSyncKeys: string[];
+                targetedRefreshSyncKeys: string[];
+                duplicateSyncKeyGroups: {
+                    syncKey: string;
+                    count: number;
+                    documentIds: string[];
+                }[];
+                lineageConflicts: {
+                    syncKey: string;
+                    lineageIds: string[];
+                    versionIds: string[];
+                    latestDocumentIds: string[];
+                    documentIds: string[];
+                    documents: {
+                        documentId: string;
+                        lineageId?: string | undefined;
+                        versionId?: string | undefined;
+                        versionNumber?: number | undefined;
+                        isLatestVersion: boolean;
+                    }[];
+                    reasons: Array<"duplicate_sync_key" | "multiple_lineages" | "multiple_versions" | "multiple_latest_versions">;
+                }[];
+            } | undefined;
+            diagnostics?: {
+                summary: string;
+                entries: {
+                    code: import("@absolutejs/ai").RAGSyncSourceDiagnosticCode;
+                    severity: "info" | "warning" | "error";
+                    summary: string;
+                }[];
+                extractionFailures?: {
+                    itemLabel: string;
+                    itemKind: "directory_file" | "url" | "storage_object" | "email_attachment";
+                    reason: string;
+                    remediation: "configure_extractor" | "add_ocr_extractor" | "inspect_file";
+                }[] | undefined;
+                retryGuidance?: {
+                    action: "wait_for_retry" | "resume_sync" | "resolve_conflicts" | "rerun_sync" | "inspect_source" | "configure_extractor";
+                    reason: string;
+                    nextRetryAt?: number | undefined;
+                    resumeCursor?: string | undefined;
+                    syncKeys?: string[] | undefined;
+                } | undefined;
+            } | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[]>;
+    };
+    search: {
+        error: import("vue").Ref<string | null, string | null>;
+        hasSearched: import("vue").Ref<boolean, boolean>;
+        isSearching: import("vue").Ref<boolean, boolean>;
+        lastRequest: import("vue").Ref<{
+            filter?: Record<string, unknown> | undefined;
+            query: string;
+            candidateTopK?: number | 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;
+            model?: string | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeQueryMultiplier?: number | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            queryTransform?: import("@absolutejs/ai").RAGQueryTransformer | {
+                transform: import("@absolutejs/ai").RAGQueryTransformer;
+                defaultModel?: string | undefined;
+                providerName?: string | undefined;
+            } | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategySelector | {
+                select: import("@absolutejs/ai").RAGRetrievalStrategySelector;
+                providerName?: string | undefined;
+                defaultLabel?: string | undefined;
+            } | undefined;
+            includeTrace?: boolean | undefined;
+            persistTrace?: boolean | undefined;
+            traceGroupKey?: string | undefined;
+            traceTags?: string[] | undefined;
+        } | null, import("@absolutejs/ai").RAGSearchRequest | {
+            filter?: Record<string, unknown> | undefined;
+            query: string;
+            candidateTopK?: number | 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;
+            model?: string | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeQueryMultiplier?: number | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            queryTransform?: import("@absolutejs/ai").RAGQueryTransformer | {
+                transform: import("@absolutejs/ai").RAGQueryTransformer;
+                defaultModel?: string | undefined;
+                providerName?: string | undefined;
+            } | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategySelector | {
+                select: import("@absolutejs/ai").RAGRetrievalStrategySelector;
+                providerName?: string | undefined;
+                defaultLabel?: string | undefined;
+            } | undefined;
+            includeTrace?: boolean | undefined;
+            persistTrace?: boolean | undefined;
+            traceGroupKey?: string | undefined;
+            traceTags?: string[] | undefined;
+        } | null>;
+        reset: () => void;
+        results: import("vue").Ref<{
+            chunkId: string;
+            corpusKey?: string | undefined;
+            score: number;
+            text: string;
+            title?: string | undefined;
+            source?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            labels?: {
+                contextLabel?: string | undefined;
+                locatorLabel?: string | undefined;
+                provenanceLabel?: string | undefined;
+            } | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | "office_heading" | "office_block" | "pdf_block" | "spreadsheet_rows" | "presentation_slide" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }[], import("@absolutejs/ai").RAGSource[] | {
+            chunkId: string;
+            corpusKey?: string | undefined;
+            score: number;
+            text: string;
+            title?: string | undefined;
+            source?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            labels?: {
+                contextLabel?: string | undefined;
+                locatorLabel?: string | undefined;
+                provenanceLabel?: string | undefined;
+            } | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | "office_heading" | "office_block" | "pdf_block" | "spreadsheet_rows" | "presentation_slide" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }[]>;
+        search: (input: {
+            filter?: Record<string, unknown> | undefined;
+            query: string;
+            candidateTopK?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeQueryMultiplier?: number | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            persistTrace?: boolean | undefined;
+            traceGroupKey?: string | undefined;
+            traceTags?: string[] | undefined;
+        }) => Promise<import("@absolutejs/ai").RAGSource[]>;
+        searchWithTrace: (input: {
+            filter?: Record<string, unknown> | undefined;
+            query: string;
+            candidateTopK?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
+            nativeQueryMultiplier?: number | undefined;
+            nativeCandidateLimit?: number | undefined;
+            nativeMaxBackfills?: number | undefined;
+            nativeMinResults?: number | undefined;
+            nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            persistTrace?: boolean | undefined;
+            traceGroupKey?: string | undefined;
+            traceTags?: string[] | undefined;
+        }) => Promise<import("../../ai/client").RAGDetailedSearchResponse>;
+        trace: import("vue").Ref<import("@absolutejs/ai").RAGRetrievalTrace | undefined, import("@absolutejs/ai").RAGRetrievalTrace | undefined>;
+    };
+    sources: {
+        citationReferenceMap: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitationReferenceMap>;
+        chunkGraph: import("vue").ComputedRef<import("@absolutejs/ai").RAGChunkGraph>;
+        hasSources: import("vue").ComputedRef<boolean>;
+        latestAssistantMessage: import("vue").ComputedRef<import("@absolutejs/ai").AIMessage | undefined>;
+        navigationForChunk: (chunkId?: string | null) => import("@absolutejs/ai").RAGChunkGraphNavigation;
+        sectionDiagnostics: import("vue").ComputedRef<import("@absolutejs/ai").RAGSectionRetrievalDiagnostic[]>;
+        sourceGroups: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceGroup[]>;
+        sources: import("vue").ComputedRef<import("@absolutejs/ai").RAGSource[]>;
+        sourceSummaries: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceSummary[]>;
+    };
+    status: {
+        capabilities: import("vue").Ref<import("@absolutejs/ai").RAGBackendCapabilities | undefined, import("@absolutejs/ai").RAGBackendCapabilities | undefined>;
+        error: import("vue").Ref<string | null, string | null>;
+        isLoading: import("vue").Ref<boolean, boolean>;
+        refresh: () => Promise<import("@absolutejs/ai").RAGStatusResponse>;
+        reset: () => void;
+        status: import("vue").Ref<import("@absolutejs/ai").RAGVectorStoreStatus | undefined, import("@absolutejs/ai").RAGVectorStoreStatus | undefined>;
+    };
+    stream: {
+        state: import("vue").ComputedRef<import("@absolutejs/ai").RAGAnswerWorkflowState>;
+        citationReferenceMap: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitationReferenceMap>;
+        citations: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitation[]>;
+        coverage: import("vue").ComputedRef<"grounded" | "partial" | "ungrounded">;
+        groundedAnswer: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundedAnswer>;
+        groundingReferences: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundingReference[]>;
+        hasGrounding: import("vue").ComputedRef<boolean>;
+        hasRetrieved: import("vue").ComputedRef<boolean>;
+        hasSources: import("vue").ComputedRef<boolean>;
+        isAnswerStreaming: import("vue").ComputedRef<boolean>;
+        isComplete: import("vue").ComputedRef<boolean>;
+        isError: import("vue").ComputedRef<boolean>;
+        isRetrieved: import("vue").ComputedRef<boolean>;
+        isRetrieving: import("vue").ComputedRef<boolean>;
+        isRunning: import("vue").ComputedRef<boolean>;
+        latestAssistantMessage: import("vue").ComputedRef<import("@absolutejs/ai").AIMessage | undefined>;
+        progress: import("vue").ComputedRef<import("../../ai/rag/presentation").RAGStreamProgress>;
+        query: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
+        retrieval: import("vue").ComputedRef<import("@absolutejs/ai").RAGRetrievedState | null>;
+        sourceGroups: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceGroup[]>;
+        sourceSummaries: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceSummary[]>;
+        sources: import("vue").ComputedRef<import("@absolutejs/ai").RAGSource[]>;
+        stage: import("vue").ComputedRef<import("@absolutejs/ai").RAGStreamStage>;
+        ungroundedReferenceNumbers: import("vue").ComputedRef<number[]>;
+        workflow: import("vue").ComputedRef<import("@absolutejs/ai").RAGAnswerWorkflowState>;
+        branch: (messageId: string, content: string) => void;
+        cancel: () => void;
+        destroy: () => void;
+        error: import("vue").Ref<string | null, string | null>;
+        isStreaming: import("vue").Ref<boolean, boolean>;
+        messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;
+        send: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
+    };
+    workflow: {
+        state: import("vue").ComputedRef<import("@absolutejs/ai").RAGAnswerWorkflowState>;
+        citationReferenceMap: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitationReferenceMap>;
+        citations: import("vue").ComputedRef<import("@absolutejs/ai").RAGCitation[]>;
+        coverage: import("vue").ComputedRef<"grounded" | "partial" | "ungrounded">;
+        groundedAnswer: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundedAnswer>;
+        groundingReferences: import("vue").ComputedRef<import("@absolutejs/ai").RAGGroundingReference[]>;
+        hasGrounding: import("vue").ComputedRef<boolean>;
+        hasRetrieved: import("vue").ComputedRef<boolean>;
+        hasSources: import("vue").ComputedRef<boolean>;
+        isAnswerStreaming: import("vue").ComputedRef<boolean>;
+        isComplete: import("vue").ComputedRef<boolean>;
+        isError: import("vue").ComputedRef<boolean>;
+        isRetrieved: import("vue").ComputedRef<boolean>;
+        isRetrieving: import("vue").ComputedRef<boolean>;
+        isRunning: import("vue").ComputedRef<boolean>;
+        latestAssistantMessage: import("vue").ComputedRef<import("@absolutejs/ai").AIMessage | undefined>;
+        progress: import("vue").ComputedRef<import("../../ai/rag/presentation").RAGStreamProgress>;
+        query: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
+        retrieval: import("vue").ComputedRef<import("@absolutejs/ai").RAGRetrievedState | null>;
+        sourceGroups: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceGroup[]>;
+        sourceSummaries: import("vue").ComputedRef<import("@absolutejs/ai").RAGSourceSummary[]>;
+        sources: import("vue").ComputedRef<import("@absolutejs/ai").RAGSource[]>;
+        stage: import("vue").ComputedRef<import("@absolutejs/ai").RAGStreamStage>;
+        ungroundedReferenceNumbers: import("vue").ComputedRef<number[]>;
+        workflow: import("vue").ComputedRef<import("@absolutejs/ai").RAGAnswerWorkflowState>;
+        branch: (messageId: string, content: string) => void;
+        cancel: () => void;
+        destroy: () => void;
+        error: import("vue").Ref<string | null, string | null>;
+        isStreaming: import("vue").Ref<boolean, boolean>;
+        messages: import("vue").ShallowRef<import("@absolutejs/ai").AIMessage[], import("@absolutejs/ai").AIMessage[]>;
+        send: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
+    };
+};
+export type UseRAGResult = ReturnType<typeof useRAG>;