@absolutejs/absolute 0.19.0-beta.533 → 0.19.0-beta.535

package/dist/src/ai/index.d.ts

@@ -1,7 +1,7 @@
 export { aiChat } from '../plugins/aiChat';
 export { streamAI } from './streamAI';
 export { ragChat } from './rag';
-export { buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGContext, buildRAGEvaluationLeaderboard, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, compareRAGRetrievalStrategies, compareRAGRerankers, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGBunS3SyncClient, createRAGFileEvaluationHistoryStore, createRAGEvaluationSuite, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGGmailEmailSyncClient, createRAGFileSyncStateStore, createRAGGraphEmailSyncClient, createRAGIMAPEmailSyncClient, createRAGStaticEmailSyncClient, createRAGStorageSyncSource, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, runRAGEvaluationSuite, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGLexicalHaystack, buildRAGGroundedAnswer, buildRAGGroundingReferences, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createLegacyDocumentExtractor, createRAGPDFOCRExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGCollection, createRAGEmbeddingProvider, createRAGFileExtractor, createRAGImageOCRExtractor, createHeuristicRAGReranker, createHeuristicRAGQueryTransform, createRAGHTMXConfig, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGSyncManager, createRAGSyncScheduler, createRAGOCRProvider, createRAGUrlSyncSource, createRAGQueryTransform, createRAGReranker, fuseRAGQueryResults, createTextFileExtractor, createRAGHTMXWorkflowRenderConfig, alibabaEmbeddings, anthropicOCR, deepseekEmbeddings, geminiEmbeddings, geminiOCR, getLatestAssistantMessage, getLatestRAGSources, buildRAGStreamProgress, googleEmbeddings, ingestDocuments, ingestRAGDocuments, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentFromURL, loadRAGDocumentsFromURLs, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, ollamaOCR, ollamaTranscriber, openaiCompatibleEmbeddings, openaiCompatibleOCR, openaiCompatibleTranscriber, openaiEmbeddings, openaiOCR, openaiTranscriber, prepareRAGDirectoryDocuments, buildRAGUpsertInputFromUploads, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, ragPlugin, resolveRAGQueryTransform, resolveRAGEmbeddingProvider, resolveRAGHybridSearchOptions, resolveRAGReranker, resolveRAGStreamStage, searchDocuments, scoreRAGLexicalMatch, applyRAGReranking, applyRAGQueryTransform, validateRAGEmbeddingDimensions, xaiEmbeddings } from './rag';
+export { buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGContext, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGEvaluationLeaderboard, buildRAGEvaluationHistoryRows, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, compareRAGRetrievalStrategies, compareRAGRerankers, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGBunS3SyncClient, createRAGFileEvaluationHistoryStore, createRAGEvaluationSuite, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGGmailEmailSyncClient, createRAGFileSyncStateStore, createRAGGraphEmailSyncClient, createRAGIMAPEmailSyncClient, createRAGStaticEmailSyncClient, createRAGStorageSyncSource, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, runRAGEvaluationSuite, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGLexicalHaystack, buildRAGGroundedAnswer, buildRAGGroundingReferences, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createLegacyDocumentExtractor, createRAGPDFOCRExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGCollection, createRAGEmbeddingProvider, createRAGFileExtractor, createRAGImageOCRExtractor, createHeuristicRAGReranker, createHeuristicRAGQueryTransform, createRAGHTMXConfig, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGSyncManager, createRAGSyncScheduler, createRAGOCRProvider, createRAGUrlSyncSource, createRAGQueryTransform, createRAGReranker, fuseRAGQueryResults, createTextFileExtractor, createRAGHTMXWorkflowRenderConfig, alibabaEmbeddings, anthropicOCR, deepseekEmbeddings, geminiEmbeddings, geminiOCR, getLatestAssistantMessage, getLatestRAGSources, buildRAGStreamProgress, googleEmbeddings, ingestDocuments, ingestRAGDocuments, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentFromURL, loadRAGDocumentsFromURLs, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, ollamaOCR, ollamaTranscriber, openaiCompatibleEmbeddings, openaiCompatibleOCR, openaiCompatibleTranscriber, openaiEmbeddings, openaiOCR, openaiTranscriber, prepareRAGDirectoryDocuments, buildRAGUpsertInputFromUploads, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, ragPlugin, resolveRAGQueryTransform, resolveRAGEmbeddingProvider, resolveRAGHybridSearchOptions, resolveRAGReranker, resolveRAGStreamStage, searchDocuments, scoreRAGLexicalMatch, applyRAGReranking, applyRAGQueryTransform, validateRAGEmbeddingDimensions, xaiEmbeddings } from './rag';
 export { createInMemoryRAGStore } from './rag/adapters/inMemory';
 export { createSQLiteRAGStore } from './rag/adapters/sqlite';
 export { resolveAbsoluteSQLiteVec, resolveAbsoluteSQLiteVecExtensionPath } from './rag/resolveAbsoluteSQLiteVec';

package/dist/src/ai/rag/index.d.ts

@@ -10,7 +10,7 @@ export { createRAGGmailEmailSyncClient, createRAGGraphEmailSyncClient, createRAG
 export { buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, buildRAGUpsertInputFromUploads, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createLegacyDocumentExtractor, createRAGPDFOCRExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGFileExtractor, createRAGImageOCRExtractor, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGOCRProvider, createTextFileExtractor, loadRAGDocumentFromURL, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentsFromURLs, prepareRAGDirectoryDocuments, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments } from './ingestion';
 export { buildRAGAnswerWorkflowState, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGGroundedAnswer, buildRAGGroundingReferences, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGStreamProgress, getLatestAssistantMessage, getLatestRAGSources, resolveRAGStreamStage } from './presentation';
 export { buildRAGContext } from './types';
-export { buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGEvaluationLeaderboard, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, compareRAGRetrievalStrategies, compareRAGRerankers, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGFileEvaluationHistoryStore, createRAGEvaluationSuite, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, runRAGEvaluationSuite, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison } from './quality';
+export { buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGEvaluationLeaderboard, buildRAGEvaluationHistoryRows, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, compareRAGRetrievalStrategies, compareRAGRerankers, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGFileEvaluationHistoryStore, createRAGEvaluationSuite, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, runRAGEvaluationSuite, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison } from './quality';
 export { createRAGBunS3SyncClient, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGFileSyncStateStore, createRAGStaticEmailSyncClient, createRAGStorageSyncSource, createRAGSyncManager, createRAGSyncScheduler, createRAGUrlSyncSource } from './sync';
 export type { RAGStreamProgress, RAGStreamProgressState } from './presentation';
 export { createRAGCollection, ingestDocuments, ingestRAGDocuments, searchDocuments } from './collection';

package/dist/src/ai/rag/quality.d.ts

@@ -1,4 +1,4 @@
-import type { RAGAnswerGroundingCaseDifficultyHistory, RAGAnswerGroundingCaseDifficultyHistoryStore, RAGAnswerGroundingCaseDifficultyRun, RAGAnswerGroundingCaseDifficultyRunDiff, RAGAnswerGroundingEvaluationCase, RAGAnswerGroundingEvaluationCaseDifficultyEntry, RAGAnswerGroundingEvaluationCaseResult, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationLeaderboardEntry, RAGAnswerGroundingEvaluationHistoryStore, RAGAnswerGroundingEvaluationInput, RAGAnswerGroundingEvaluationResponse, RAGAnswerGroundingEvaluationRun, RAGAnswerGroundingEvaluationRunDiff, RAGCollection, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationHistory, RAGEvaluationHistoryStore, RAGEvaluationInput, RAGEvaluationLeaderboardEntry, RAGEvaluationResponse, RAGEvaluationRunDiff, RAGEvaluationSuite, RAGEvaluationSuiteRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalComparisonSummary, RAGRerankerCandidate, RAGRerankerComparison, RAGRerankerComparisonEntry, RAGRerankerComparisonSummary, RAGRerankerProviderLike } from '../../../types/ai';
+import type { RAGAnswerGroundingCaseDifficultyHistory, RAGAnswerGroundingCaseDifficultyHistoryStore, RAGAnswerGroundingCaseDifficultyRun, RAGAnswerGroundingCaseDifficultyRunDiff, RAGAnswerGroundingEvaluationCase, RAGAnswerGroundingEvaluationCaseDifficultyEntry, RAGAnswerGroundingEvaluationCaseResult, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationLeaderboardEntry, RAGAnswerGroundingEvaluationHistoryStore, RAGAnswerGroundingEvaluationInput, RAGAnswerGroundingEvaluationResponse, RAGAnswerGroundingEvaluationRun, RAGAnswerGroundingEvaluationRunDiff, RAGCollection, RAGEvaluationCase, RAGEvaluationCaseTraceSnapshot, RAGEvaluationCaseResult, RAGEvaluationHistory, RAGEvaluationHistoryStore, RAGEvaluationInput, RAGEvaluationLeaderboardEntry, RAGEvaluationResponse, RAGEvaluationRunDiff, RAGLabelValueRow, RAGEvaluationSuite, RAGEvaluationSuiteRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalTraceComparisonSummary, RAGRetrievalComparisonSummary, RAGRerankerCandidate, RAGRerankerComparison, RAGRerankerComparisonEntry, RAGRerankerComparisonSummary, RAGRerankerProviderLike } from '../../../types/ai';
 export declare const buildRAGEvaluationLeaderboard: (runs: RAGEvaluationSuiteRun[]) => RAGEvaluationLeaderboardEntry[];
 export declare const buildRAGAnswerGroundingEvaluationLeaderboard: (runs: RAGAnswerGroundingEvaluationRun[]) => RAGAnswerGroundingEvaluationLeaderboardEntry[];
 export declare const buildRAGAnswerGroundingCaseDifficultyLeaderboard: (entries: Array<{
@@ -9,6 +9,9 @@ export declare const buildRAGAnswerGroundingCaseDifficultyRunDiff: ({ current, p
     current: RAGAnswerGroundingCaseDifficultyRun;
     previous?: RAGAnswerGroundingCaseDifficultyRun;
 }) => RAGAnswerGroundingCaseDifficultyRunDiff;
+export declare const buildRAGComparisonTraceSummaryRows: (entry: RAGRerankerComparisonEntry | RAGRetrievalComparisonEntry) => RAGLabelValueRow[];
+export declare const buildRAGComparisonTraceDiffRows: (entry: RAGRerankerComparisonEntry | RAGRetrievalComparisonEntry, leader?: RAGRerankerComparisonEntry | RAGRetrievalComparisonEntry) => RAGLabelValueRow[];
+export declare const buildRAGEvaluationHistoryRows: (history?: RAGEvaluationHistory) => RAGLabelValueRow[];
 export declare const buildRAGEvaluationRunDiff: ({ current, previous }: {
     current: RAGEvaluationSuiteRun;
     previous?: RAGEvaluationSuiteRun;
@@ -74,11 +77,13 @@ export declare const evaluateRAGCollection: ({ collection, input, defaultTopK, r
     rerank?: RAGRerankerProviderLike;
 }) => Promise<RAGEvaluationResponse>;
 export declare const executeDryRunRAGEvaluation: (input: RAGEvaluationInput, defaultTopK?: number) => RAGEvaluationCaseResult[];
-export declare const runRAGEvaluationSuite: ({ suite, evaluate, overrides }: {
+export declare const runRAGEvaluationSuite: ({ suite, evaluate, overrides, artifacts }: {
     suite: RAGEvaluationSuite;
     evaluate: (input: RAGEvaluationInput) => Promise<RAGEvaluationResponse>;
     overrides?: Partial<RAGEvaluationInput>;
+    artifacts?: Pick<RAGEvaluationSuiteRun, "traceSummary" | "caseTraceSnapshots">;
 }) => Promise<{
+    caseTraceSnapshots: RAGEvaluationCaseTraceSnapshot[] | undefined;
     elapsedMs: number;
     finishedAt: number;
     id: `${string}-${string}-${string}-${string}-${string}`;
@@ -87,6 +92,7 @@ export declare const runRAGEvaluationSuite: ({ suite, evaluate, overrides }: {
     response: RAGEvaluationResponse;
     startedAt: number;
     suiteId: string;
+    traceSummary: RAGRetrievalTraceComparisonSummary | undefined;
 }>;
 export declare const summarizeRAGEvaluationCase: ({ caseIndex, caseInput, query, mode, retrievedIds, expectedIds, elapsedMs }: {
     caseIndex: number;

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

@@ -40,6 +40,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         removeSuite: (id: string) => void;
         reset: () => void;
         runSuite: (suite: import("../..").RAGEvaluationSuite, overrides?: Partial<import("../..").RAGEvaluationInput>) => Promise<{
+            caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
             elapsedMs: number;
             finishedAt: number;
             id: `${string}-${string}-${string}-${string}-${string}`;
@@ -48,6 +49,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             response: import("../..").RAGEvaluationResponse;
             startedAt: number;
             suiteId: string;
+            traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
         }>;
         saveSuite: (suite: import("../..").RAGEvaluationSuite) => import("../..").RAGEvaluationSuite;
         suiteRuns: import("../..").RAGEvaluationSuiteRun[];

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

@@ -10,6 +10,7 @@ export declare const useRAGEvaluate: (path: string) => {
     removeSuite: (id: string) => void;
     reset: () => void;
     runSuite: (suite: RAGEvaluationSuite, overrides?: Partial<RAGEvaluationInput>) => Promise<{
+        caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
         elapsedMs: number;
         finishedAt: number;
         id: `${string}-${string}-${string}-${string}-${string}`;
@@ -18,6 +19,7 @@ export declare const useRAGEvaluate: (path: string) => {
         response: RAGEvaluationResponse;
         startedAt: number;
         suiteId: string;
+        traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
     }>;
     saveSuite: (suite: RAGEvaluationSuite) => RAGEvaluationSuite;
     suiteRuns: RAGEvaluationSuiteRun[];

package/dist/src/svelte/ai/createRAG.d.ts

@@ -40,6 +40,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         removeSuite: (id: string) => void;
         reset: () => void;
         runSuite: (suite: import("../..").RAGEvaluationSuite, overrides?: Partial<import("../..").RAGEvaluationInput>) => Promise<{
+            caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
             elapsedMs: number;
             finishedAt: number;
             id: `${string}-${string}-${string}-${string}-${string}`;
@@ -48,6 +49,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
             response: import("../..").RAGEvaluationResponse;
             startedAt: number;
             suiteId: string;
+            traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
         }>;
         saveSuite: (suite: import("../..").RAGEvaluationSuite) => import("../..").RAGEvaluationSuite;
         suiteRuns: import("svelte/store").Writable<import("../..").RAGEvaluationSuiteRun[]>;

package/dist/src/svelte/ai/createRAGEvaluate.d.ts

@@ -10,6 +10,7 @@ export declare const createRAGEvaluate: (path: string) => {
     removeSuite: (id: string) => void;
     reset: () => void;
     runSuite: (suite: RAGEvaluationSuite, overrides?: Partial<RAGEvaluationInput>) => Promise<{
+        caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
         elapsedMs: number;
         finishedAt: number;
         id: `${string}-${string}-${string}-${string}-${string}`;
@@ -18,6 +19,7 @@ export declare const createRAGEvaluate: (path: string) => {
         response: RAGEvaluationResponse;
         startedAt: number;
         suiteId: string;
+        traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
     }>;
     saveSuite: (suite: RAGEvaluationSuite) => RAGEvaluationSuite;
     suiteRuns: import("svelte/store").Writable<RAGEvaluationSuiteRun[]>;

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

@@ -254,6 +254,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         removeSuite: (id: string) => void;
         reset: () => void;
         runSuite: (suite: import("../..").RAGEvaluationSuite, overrides?: Partial<import("../..").RAGEvaluationInput>) => Promise<{
+            caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
             elapsedMs: number;
             finishedAt: number;
             id: `${string}-${string}-${string}-${string}-${string}`;
@@ -262,6 +263,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             response: import("../..").RAGEvaluationResponse;
             startedAt: number;
             suiteId: string;
+            traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
         }>;
         saveSuite: (suite: import("../..").RAGEvaluationSuite) => import("../..").RAGEvaluationSuite;
         suiteRuns: import("vue").Ref<{
@@ -331,6 +333,51 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                     finalize?: number | undefined;
                 };
             } | undefined;
+            caseTraceSnapshots?: {
+                caseId: string;
+                label?: string | undefined;
+                query: string;
+                status: import("../..").RAGEvaluationCaseResult["status"];
+                traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+                previousTraceMode?: import("../..").RAGHybridRetrievalMode | 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;
+                stageCounts: {
+                    input?: number | undefined;
+                    embed?: number | undefined;
+                    query_transform?: number | undefined;
+                    vector_search?: number | undefined;
+                    lexical_search?: number | undefined;
+                    fusion?: number | undefined;
+                    rerank?: number | undefined;
+                    score_filter?: number | undefined;
+                    finalize?: number | undefined;
+                };
+                previousStageCounts: {
+                    input?: number | undefined;
+                    embed?: number | undefined;
+                    query_transform?: number | undefined;
+                    vector_search?: number | undefined;
+                    lexical_search?: number | undefined;
+                    fusion?: number | undefined;
+                    rerank?: number | undefined;
+                    score_filter?: number | undefined;
+                    finalize?: number | undefined;
+                };
+                traceChange: "new" | "changed" | "unchanged";
+            }[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         }[], import("../..").RAGEvaluationSuiteRun[] | {
             id: string;
@@ -399,6 +446,51 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                     finalize?: number | undefined;
                 };
             } | undefined;
+            caseTraceSnapshots?: {
+                caseId: string;
+                label?: string | undefined;
+                query: string;
+                status: import("../..").RAGEvaluationCaseResult["status"];
+                traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+                previousTraceMode?: import("../..").RAGHybridRetrievalMode | 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;
+                stageCounts: {
+                    input?: number | undefined;
+                    embed?: number | undefined;
+                    query_transform?: number | undefined;
+                    vector_search?: number | undefined;
+                    lexical_search?: number | undefined;
+                    fusion?: number | undefined;
+                    rerank?: number | undefined;
+                    score_filter?: number | undefined;
+                    finalize?: number | undefined;
+                };
+                previousStageCounts: {
+                    input?: number | undefined;
+                    embed?: number | undefined;
+                    query_transform?: number | undefined;
+                    vector_search?: number | undefined;
+                    lexical_search?: number | undefined;
+                    fusion?: number | undefined;
+                    rerank?: number | undefined;
+                    score_filter?: number | undefined;
+                    finalize?: number | undefined;
+                };
+                traceChange: "new" | "changed" | "unchanged";
+            }[] | undefined;
             metadata?: Record<string, unknown> | undefined;
         }[]>;
         suites: import("vue").Ref<{

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

@@ -118,6 +118,7 @@ export declare const useRAGEvaluate: (path: string) => {
     removeSuite: (id: string) => void;
     reset: () => void;
     runSuite: (suite: RAGEvaluationSuite, overrides?: Partial<RAGEvaluationInput>) => Promise<{
+        caseTraceSnapshots: import("../..").RAGEvaluationCaseTraceSnapshot[] | undefined;
         elapsedMs: number;
         finishedAt: number;
         id: `${string}-${string}-${string}-${string}-${string}`;
@@ -126,6 +127,7 @@ export declare const useRAGEvaluate: (path: string) => {
         response: RAGEvaluationResponse;
         startedAt: number;
         suiteId: string;
+        traceSummary: import("../..").RAGRetrievalTraceComparisonSummary | undefined;
     }>;
     saveSuite: (suite: RAGEvaluationSuite) => RAGEvaluationSuite;
     suiteRuns: import("vue").Ref<{
@@ -195,6 +197,51 @@ export declare const useRAGEvaluate: (path: string) => {
                 finalize?: number | undefined;
             };
         } | undefined;
+        caseTraceSnapshots?: {
+            caseId: string;
+            label?: string | undefined;
+            query: string;
+            status: import("../..").RAGEvaluationCaseResult["status"];
+            traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+            previousTraceMode?: import("../..").RAGHybridRetrievalMode | 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;
+            stageCounts: {
+                input?: number | undefined;
+                embed?: number | undefined;
+                query_transform?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            previousStageCounts: {
+                input?: number | undefined;
+                embed?: number | undefined;
+                query_transform?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            traceChange: "new" | "changed" | "unchanged";
+        }[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[], RAGEvaluationSuiteRun[] | {
         id: string;
@@ -263,6 +310,51 @@ export declare const useRAGEvaluate: (path: string) => {
                 finalize?: number | undefined;
             };
         } | undefined;
+        caseTraceSnapshots?: {
+            caseId: string;
+            label?: string | undefined;
+            query: string;
+            status: import("../..").RAGEvaluationCaseResult["status"];
+            traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+            previousTraceMode?: import("../..").RAGHybridRetrievalMode | 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;
+            stageCounts: {
+                input?: number | undefined;
+                embed?: number | undefined;
+                query_transform?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            previousStageCounts: {
+                input?: number | undefined;
+                embed?: number | undefined;
+                query_transform?: number | undefined;
+                vector_search?: number | undefined;
+                lexical_search?: number | undefined;
+                fusion?: number | undefined;
+                rerank?: number | undefined;
+                score_filter?: number | undefined;
+                finalize?: number | undefined;
+            };
+            traceChange: "new" | "changed" | "unchanged";
+        }[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[]>;
     suites: import("vue").Ref<{