@absolutejs/absolute 0.19.0-beta.532 → 0.19.0-beta.534

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, RAGEvaluationCaseResult, RAGEvaluationHistory, RAGEvaluationHistoryStore, RAGEvaluationInput, RAGEvaluationLeaderboardEntry, RAGEvaluationResponse, RAGEvaluationRunDiff, RAGLabelValueRow, RAGEvaluationSuite, RAGEvaluationSuiteRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalComparisonEntry, 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;

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

@@ -307,6 +307,30 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 totalCases: number;
                 passingRate: number;
             };
+            traceSummary?: {
+                totalCases: number;
+                modes: import("../..").RAGHybridRetrievalMode[];
+                vectorCases: number;
+                lexicalCases: number;
+                transformedCases: number;
+                variantCases: number;
+                averageFinalCount: number;
+                averageVectorCount: number;
+                averageLexicalCount: number;
+                averageCandidateTopK: number;
+                averageLexicalTopK: number;
+                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;
+                };
+            } | undefined;
             metadata?: Record<string, unknown> | undefined;
         }[], import("../..").RAGEvaluationSuiteRun[] | {
             id: string;
@@ -351,6 +375,30 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 totalCases: number;
                 passingRate: number;
             };
+            traceSummary?: {
+                totalCases: number;
+                modes: import("../..").RAGHybridRetrievalMode[];
+                vectorCases: number;
+                lexicalCases: number;
+                transformedCases: number;
+                variantCases: number;
+                averageFinalCount: number;
+                averageVectorCount: number;
+                averageLexicalCount: number;
+                averageCandidateTopK: number;
+                averageLexicalTopK: number;
+                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;
+                };
+            } | undefined;
             metadata?: Record<string, unknown> | undefined;
         }[]>;
         suites: import("vue").Ref<{

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

@@ -171,6 +171,30 @@ export declare const useRAGEvaluate: (path: string) => {
             totalCases: number;
             passingRate: number;
         };
+        traceSummary?: {
+            totalCases: number;
+            modes: import("../..").RAGHybridRetrievalMode[];
+            vectorCases: number;
+            lexicalCases: number;
+            transformedCases: number;
+            variantCases: number;
+            averageFinalCount: number;
+            averageVectorCount: number;
+            averageLexicalCount: number;
+            averageCandidateTopK: number;
+            averageLexicalTopK: number;
+            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;
+            };
+        } | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[], RAGEvaluationSuiteRun[] | {
         id: string;
@@ -215,6 +239,30 @@ export declare const useRAGEvaluate: (path: string) => {
             totalCases: number;
             passingRate: number;
         };
+        traceSummary?: {
+            totalCases: number;
+            modes: import("../..").RAGHybridRetrievalMode[];
+            vectorCases: number;
+            lexicalCases: number;
+            transformedCases: number;
+            variantCases: number;
+            averageFinalCount: number;
+            averageVectorCount: number;
+            averageLexicalCount: number;
+            averageCandidateTopK: number;
+            averageLexicalTopK: number;
+            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;
+            };
+        } | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[]>;
     suites: import("vue").Ref<{

package/dist/svelte/ai/index.js

@@ -1780,6 +1780,23 @@ var buildTraceStageCounts = (traces) => {
   }
   return counts;
 };
+var diffTraceStageCounts = ({
+  current,
+  previous
+}) => {
+  const next = {};
+  const stages = new Set([
+    ...Object.keys(current),
+    ...Object.keys(previous)
+  ]);
+  for (const stage of stages) {
+    const delta = (current[stage] ?? 0) - (previous[stage] ?? 0);
+    if (delta !== 0) {
+      next[stage] = delta;
+    }
+  }
+  return next;
+};
 var roundTraceAverage = (value, total) => total > 0 ? Number((value / total).toFixed(2)) : 0;
 var summarizeRetrievalTraces = (traces) => {
   if (traces.length === 0) {
@@ -2141,6 +2158,166 @@ var buildGroundingCaseSnapshots = ({
   });
 };
 var getStatusRank = (status) => status === "pass" ? 2 : status === "partial" ? 1 : 0;
+var formatSignedDelta = (value, decimals = 0, suffix = "") => `${value >= 0 ? "+" : ""}${value.toFixed(decimals)}${suffix}`;
+var formatEvaluationSummary = (response) => `${response.summary.passedCases}/${response.totalCases} pass \xB7 f1 ${response.summary.averageF1.toFixed(3)} \xB7 latency ${response.summary.averageLatencyMs.toFixed(1)}ms`;
+var formatHistoryCaseLabels = (cases) => cases.length > 0 ? cases.map((entry) => entry.label ?? entry.caseId).join(", ") : "none";
+var formatTraceModes = (modes) => modes.length > 0 ? modes.join(" / ") : "n/a";
+var formatTraceStageSummary = (stageCounts) => {
+  const topStages = Object.entries(stageCounts).sort((left, right) => right[1] - left[1]).slice(0, 3);
+  return topStages.length > 0 ? topStages.map(([stage, count]) => `${stage} ${count}`).join(" \xB7 ") : "n/a";
+};
+var formatTraceRatio = (count, total) => `${count}/${total}`;
+var formatTraceCountDelta = (value) => `${value >= 0 ? "+" : ""}${value}`;
+var buildRAGComparisonTraceSummaryRows = (entry) => {
+  const trace = entry.traceSummary;
+  if (!trace) {
+    return [{ label: "Trace", value: "Unavailable" }];
+  }
+  return [
+    { label: "Modes", value: formatTraceModes(trace.modes) },
+    { label: "Avg final", value: trace.averageFinalCount.toFixed(1) },
+    { label: "Avg vector", value: trace.averageVectorCount.toFixed(1) },
+    { label: "Avg lexical", value: trace.averageLexicalCount.toFixed(1) },
+    {
+      label: "Transforms",
+      value: formatTraceRatio(trace.transformedCases, trace.totalCases)
+    },
+    {
+      label: "Variants",
+      value: formatTraceRatio(trace.variantCases, trace.totalCases)
+    },
+    {
+      label: "TopK",
+      value: `${trace.averageCandidateTopK.toFixed(1)} / ${trace.averageLexicalTopK.toFixed(1)}`
+    },
+    {
+      label: "Stages",
+      value: formatTraceStageSummary(trace.stageCounts)
+    }
+  ];
+};
+var buildRAGComparisonTraceDiffRows = (entry, leader) => {
+  const trace = entry.traceSummary;
+  if (!trace) {
+    return [{ label: "Trace", value: "Unavailable for comparison" }];
+  }
+  const leaderTrace = leader?.traceSummary;
+  if (!leaderTrace) {
+    return [{ label: "Baseline", value: "Leader trace unavailable" }];
+  }
+  if (entry === leader) {
+    return [{ label: "Baseline", value: "Leader strategy" }];
+  }
+  const stageDelta = Object.keys({
+    ...leaderTrace.stageCounts,
+    ...trace.stageCounts
+  }).map((stage) => {
+    const typedStage = stage;
+    const delta = (trace.stageCounts[typedStage] ?? 0) - (leaderTrace.stageCounts[typedStage] ?? 0);
+    return delta === 0 ? null : `${typedStage} ${formatTraceCountDelta(delta)}`;
+  }).filter((value) => Boolean(value)).slice(0, 3).join(" \xB7 ");
+  const rows = [
+    { label: "Baseline", value: leader.label }
+  ];
+  if (formatTraceModes(trace.modes) !== formatTraceModes(leaderTrace.modes)) {
+    rows.push({
+      label: "Modes vs leader",
+      value: `${formatTraceModes(trace.modes)} vs ${formatTraceModes(leaderTrace.modes)}`
+    });
+  }
+  rows.push({
+    label: "Final delta",
+    value: formatSignedDelta(trace.averageFinalCount - leaderTrace.averageFinalCount, 1)
+  }, {
+    label: "Vector delta",
+    value: formatSignedDelta(trace.averageVectorCount - leaderTrace.averageVectorCount, 1)
+  }, {
+    label: "Lexical delta",
+    value: formatSignedDelta(trace.averageLexicalCount - leaderTrace.averageLexicalCount, 1)
+  }, {
+    label: "Transform delta",
+    value: formatTraceCountDelta(trace.transformedCases - leaderTrace.transformedCases)
+  });
+  if (stageDelta) {
+    rows.push({ label: "Stage delta", value: stageDelta });
+  }
+  return rows;
+};
+var buildRAGEvaluationHistoryRows = (history) => {
+  if (!history?.latestRun) {
+    return [
+      { label: "History", value: "No persisted benchmark runs yet." }
+    ];
+  }
+  const rows = [
+    { label: "Runs recorded", value: String(history.runs.length) },
+    {
+      label: "Latest",
+      value: `${history.latestRun.label} \xB7 ${formatEvaluationSummary(history.latestRun.response)}`
+    }
+  ];
+  if (history.latestRun.traceSummary) {
+    rows.push({
+      label: "Latest trace",
+      value: `${formatTraceModes(history.latestRun.traceSummary.modes)} \xB7 final ${history.latestRun.traceSummary.averageFinalCount.toFixed(1)} \xB7 vector ${history.latestRun.traceSummary.averageVectorCount.toFixed(1)} \xB7 lexical ${history.latestRun.traceSummary.averageLexicalCount.toFixed(1)}`
+    });
+  }
+  if (history.previousRun) {
+    rows.push({
+      label: "Previous",
+      value: `${history.previousRun.label} \xB7 ${formatEvaluationSummary(history.previousRun.response)}`
+    });
+  }
+  if (!history.diff) {
+    rows.push({
+      label: "History diff",
+      value: "Run the benchmark again to diff regressions over time."
+    });
+    return rows;
+  }
+  rows.push({
+    label: "Passing delta",
+    value: formatSignedDelta(history.diff.summaryDelta.passingRate, 1, "%")
+  }, {
+    label: "Average F1 delta",
+    value: formatSignedDelta(history.diff.summaryDelta.averageF1, 3)
+  }, {
+    label: "Latency delta",
+    value: formatSignedDelta(history.diff.summaryDelta.averageLatencyMs, 1, "ms")
+  }, {
+    label: "Improved",
+    value: formatHistoryCaseLabels(history.diff.improvedCases)
+  }, {
+    label: "Regressed",
+    value: formatHistoryCaseLabels(history.diff.regressedCases)
+  });
+  if (history.diff.traceSummaryDelta) {
+    rows.push({
+      label: "Trace mode shift",
+      value: history.diff.traceSummaryDelta.modesChanged ? "changed" : "stable"
+    }, {
+      label: "Trace final delta",
+      value: formatSignedDelta(history.diff.traceSummaryDelta.averageFinalCount, 1)
+    }, {
+      label: "Trace vector delta",
+      value: formatSignedDelta(history.diff.traceSummaryDelta.averageVectorCount, 1)
+    }, {
+      label: "Trace lexical delta",
+      value: formatSignedDelta(history.diff.traceSummaryDelta.averageLexicalCount, 1)
+    }, {
+      label: "Trace transform delta",
+      value: formatTraceCountDelta(history.diff.traceSummaryDelta.transformedCases)
+    }, {
+      label: "Trace variant delta",
+      value: formatTraceCountDelta(history.diff.traceSummaryDelta.variantCases)
+    });
+    const stageDelta = Object.entries(history.diff.traceSummaryDelta.stageCounts ?? {}).map(([stage, count]) => `${stage} ${formatTraceCountDelta(count)}`).join(", ");
+    if (stageDelta) {
+      rows.push({ label: "Trace stage delta", value: stageDelta });
+    }
+  }
+  return rows;
+};
 var buildRAGEvaluationRunDiff = ({
   current,
   previous
@@ -2164,6 +2341,22 @@ var buildRAGEvaluationRunDiff = ({
       passingRate: current.response.passingRate - (previous?.response.passingRate ?? 0),
       partialCases: current.response.summary.partialCases - (previous?.response.summary.partialCases ?? 0)
     },
+    traceSummaryDelta: current.traceSummary || previous?.traceSummary ? {
+      averageCandidateTopK: (current.traceSummary?.averageCandidateTopK ?? 0) - (previous?.traceSummary?.averageCandidateTopK ?? 0),
+      averageFinalCount: (current.traceSummary?.averageFinalCount ?? 0) - (previous?.traceSummary?.averageFinalCount ?? 0),
+      averageLexicalCount: (current.traceSummary?.averageLexicalCount ?? 0) - (previous?.traceSummary?.averageLexicalCount ?? 0),
+      averageLexicalTopK: (current.traceSummary?.averageLexicalTopK ?? 0) - (previous?.traceSummary?.averageLexicalTopK ?? 0),
+      averageVectorCount: (current.traceSummary?.averageVectorCount ?? 0) - (previous?.traceSummary?.averageVectorCount ?? 0),
+      lexicalCases: (current.traceSummary?.lexicalCases ?? 0) - (previous?.traceSummary?.lexicalCases ?? 0),
+      modesChanged: (current.traceSummary?.modes ?? []).join("|") !== (previous?.traceSummary?.modes ?? []).join("|"),
+      stageCounts: diffTraceStageCounts({
+        current: current.traceSummary?.stageCounts ?? {},
+        previous: previous?.traceSummary?.stageCounts ?? {}
+      }),
+      transformedCases: (current.traceSummary?.transformedCases ?? 0) - (previous?.traceSummary?.transformedCases ?? 0),
+      variantCases: (current.traceSummary?.variantCases ?? 0) - (previous?.traceSummary?.variantCases ?? 0),
+      vectorCases: (current.traceSummary?.vectorCases ?? 0) - (previous?.traceSummary?.vectorCases ?? 0)
+    } : undefined,
     unchangedCases
   };
 };
@@ -2537,7 +2730,8 @@ var compareRAGRerankers = async ({
     label: entry.label,
     response: entry.response,
     startedAt: 0,
-    suiteId: suite.id
+    suiteId: suite.id,
+    traceSummary: entry.traceSummary
   })));
   return {
     entries,
@@ -2622,7 +2816,8 @@ var compareRAGRetrievalStrategies = async ({
     label: entry.label,
     response: entry.response,
     startedAt: 0,
-    suiteId: suite.id
+    suiteId: suite.id,
+    traceSummary: entry.traceSummary
   })));
   return {
     entries,
@@ -3419,5 +3614,5 @@ export {
   createAIStream
 };
 
-//# debugId=1515E9DBD027AFA064756E2164756E21
+//# debugId=E92A24FDA13560A364756E2164756E21
 //# sourceMappingURL=index.js.map