@absolutejs/absolute 0.19.0-beta.552 → 0.19.0-beta.554

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

@@ -37,21 +37,5 @@ export declare const fuseRAGQueryResults: ({ fusion, fusionConstant, lexical, le
     source?: string;
     metadata?: Record<string, unknown>;
 }[];
-export declare const resolveRAGHybridSearchOptions: (retrieval: RAGHybridSearchOptions | RAGHybridRetrievalMode | undefined) => {
-    fusion: "rrf";
-    fusionConstant: number;
-    lexicalTopK: undefined;
-    lexicalWeight: number;
-    mode: RAGHybridRetrievalMode;
-    vectorWeight: number;
-    maxResultsPerSource?: undefined;
-} | {
-    fusion: RAGHybridFusionMode;
-    fusionConstant: number;
-    lexicalTopK: number | undefined;
-    maxResultsPerSource: number | undefined;
-    lexicalWeight: number;
-    mode: RAGHybridRetrievalMode;
-    vectorWeight: number;
-};
+export declare const resolveRAGHybridSearchOptions: (retrieval: RAGHybridSearchOptions | RAGHybridRetrievalMode | undefined) => Required<Pick<RAGHybridSearchOptions, "fusion" | "fusionConstant" | "lexicalWeight" | "mode" | "sourceBalanceStrategy" | "vectorWeight">> & Pick<RAGHybridSearchOptions, "lexicalTopK" | "maxResultsPerSource">;
 export {};

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

@@ -312,8 +312,11 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             traceSummary?: {
                 totalCases: number;
                 modes: import("../..").RAGHybridRetrievalMode[];
+                sourceBalanceStrategies: import("../..").RAGSourceBalanceStrategy[];
                 vectorCases: number;
                 lexicalCases: number;
+                balancedCases: number;
+                roundRobinCases: number;
                 transformedCases: number;
                 variantCases: number;
                 averageFinalCount: number;
@@ -341,6 +344,8 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 status: import("../..").RAGEvaluationCaseResult["status"];
                 traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
                 previousTraceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+                sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
+                previousSourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
                 transformedQuery?: string | undefined;
                 previousTransformedQuery?: string | undefined;
                 variantQueries: string[];
@@ -428,8 +433,11 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             traceSummary?: {
                 totalCases: number;
                 modes: import("../..").RAGHybridRetrievalMode[];
+                sourceBalanceStrategies: import("../..").RAGSourceBalanceStrategy[];
                 vectorCases: number;
                 lexicalCases: number;
+                balancedCases: number;
+                roundRobinCases: number;
                 transformedCases: number;
                 variantCases: number;
                 averageFinalCount: number;
@@ -457,6 +465,8 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 status: import("../..").RAGEvaluationCaseResult["status"];
                 traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
                 previousTraceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+                sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
+                previousSourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
                 transformedQuery?: string | undefined;
                 previousTransformedQuery?: string | undefined;
                 variantQueries: string[];
@@ -1049,6 +1059,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 mode?: import("../..").RAGHybridRetrievalMode | undefined;
                 lexicalTopK?: number | undefined;
                 maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
                 fusion?: import("../..").RAGHybridFusionMode | undefined;
                 fusionConstant?: number | undefined;
                 lexicalWeight?: number | undefined;
@@ -1071,6 +1082,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 mode?: import("../..").RAGHybridRetrievalMode | undefined;
                 lexicalTopK?: number | undefined;
                 maxResultsPerSource?: number | undefined;
+                sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
                 fusion?: import("../..").RAGHybridFusionMode | undefined;
                 fusionConstant?: number | undefined;
                 lexicalWeight?: number | undefined;

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

@@ -176,8 +176,11 @@ export declare const useRAGEvaluate: (path: string) => {
         traceSummary?: {
             totalCases: number;
             modes: import("../..").RAGHybridRetrievalMode[];
+            sourceBalanceStrategies: import("../..").RAGSourceBalanceStrategy[];
             vectorCases: number;
             lexicalCases: number;
+            balancedCases: number;
+            roundRobinCases: number;
             transformedCases: number;
             variantCases: number;
             averageFinalCount: number;
@@ -205,6 +208,8 @@ export declare const useRAGEvaluate: (path: string) => {
             status: import("../..").RAGEvaluationCaseResult["status"];
             traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
             previousTraceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+            sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
+            previousSourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
             transformedQuery?: string | undefined;
             previousTransformedQuery?: string | undefined;
             variantQueries: string[];
@@ -292,8 +297,11 @@ export declare const useRAGEvaluate: (path: string) => {
         traceSummary?: {
             totalCases: number;
             modes: import("../..").RAGHybridRetrievalMode[];
+            sourceBalanceStrategies: import("../..").RAGSourceBalanceStrategy[];
             vectorCases: number;
             lexicalCases: number;
+            balancedCases: number;
+            roundRobinCases: number;
             transformedCases: number;
             variantCases: number;
             averageFinalCount: number;
@@ -321,6 +329,8 @@ export declare const useRAGEvaluate: (path: string) => {
             status: import("../..").RAGEvaluationCaseResult["status"];
             traceMode?: import("../..").RAGHybridRetrievalMode | undefined;
             previousTraceMode?: import("../..").RAGHybridRetrievalMode | undefined;
+            sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
+            previousSourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
             transformedQuery?: string | undefined;
             previousTransformedQuery?: string | undefined;
             variantQueries: string[];

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

@@ -18,6 +18,7 @@ export declare const useRAGSearch: (path: string) => {
             mode?: import("../..").RAGHybridRetrievalMode | undefined;
             lexicalTopK?: number | undefined;
             maxResultsPerSource?: number | undefined;
+            sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
             fusion?: import("../..").RAGHybridFusionMode | undefined;
             fusionConstant?: number | undefined;
             lexicalWeight?: number | undefined;
@@ -40,6 +41,7 @@ export declare const useRAGSearch: (path: string) => {
             mode?: import("../..").RAGHybridRetrievalMode | undefined;
             lexicalTopK?: number | undefined;
             maxResultsPerSource?: number | undefined;
+            sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
             fusion?: import("../..").RAGHybridFusionMode | undefined;
             fusionConstant?: number | undefined;
             lexicalWeight?: number | undefined;

package/dist/svelte/ai/index.js

@@ -2209,8 +2209,11 @@ var summarizeRetrievalTraces = (traces) => {
   }
   const totalCases = traces.length;
   const modeSet = new Set;
+  const sourceBalanceStrategySet = new Set;
   let vectorCases = 0;
   let lexicalCases = 0;
+  let balancedCases = 0;
+  let roundRobinCases = 0;
   let transformedCases = 0;
   let variantCases = 0;
   let finalCountSum = 0;
@@ -2220,12 +2223,19 @@ var summarizeRetrievalTraces = (traces) => {
   let lexicalTopKSum = 0;
   for (const trace of traces) {
     modeSet.add(trace.mode);
+    sourceBalanceStrategySet.add(trace.sourceBalanceStrategy ?? "cap");
     if (trace.runVector) {
       vectorCases += 1;
     }
     if (trace.runLexical) {
       lexicalCases += 1;
     }
+    if (typeof trace.maxResultsPerSource === "number") {
+      balancedCases += 1;
+      if (trace.sourceBalanceStrategy === "round_robin") {
+        roundRobinCases += 1;
+      }
+    }
     if (trace.transformedQuery !== trace.query) {
       transformedCases += 1;
     }
@@ -2243,9 +2253,12 @@ var summarizeRetrievalTraces = (traces) => {
     averageFinalCount: roundTraceAverage(finalCountSum, totalCases),
     averageLexicalCount: roundTraceAverage(lexicalCountSum, totalCases),
     averageLexicalTopK: roundTraceAverage(lexicalTopKSum, totalCases),
+    balancedCases,
     averageVectorCount: roundTraceAverage(vectorCountSum, totalCases),
     lexicalCases,
     modes: Array.from(modeSet),
+    roundRobinCases,
+    sourceBalanceStrategies: Array.from(sourceBalanceStrategySet),
     stageCounts: buildTraceStageCounts(traces),
     totalCases,
     transformedCases,
@@ -2581,7 +2594,7 @@ var buildEvaluationCaseTraceSnapshot = ({
 }) => {
   const stageCounts = currentTrace ? buildTraceStageCounts([currentTrace]) : {};
   const previousStageCounts = previousTrace?.stageCounts ?? {};
-  const traceChange = !previousTrace ? currentTrace ? "new" : "unchanged" : previousTrace.traceMode !== currentTrace?.mode || previousTrace.transformedQuery !== (currentTrace?.transformedQuery || undefined) || previousTrace.variantQueries.join("|") !== (currentTrace?.variantQueries ?? []).join("|") || previousTrace.finalCount !== (currentTrace?.resultCounts.final ?? 0) || previousTrace.vectorCount !== (currentTrace?.resultCounts.vector ?? 0) || previousTrace.lexicalCount !== (currentTrace?.resultCounts.lexical ?? 0) || previousTrace.candidateTopK !== (currentTrace?.candidateTopK ?? 0) || previousTrace.lexicalTopK !== (currentTrace?.lexicalTopK ?? 0) || !areStageCountsEqual(previousStageCounts, stageCounts) ? "changed" : "unchanged";
+  const traceChange = !previousTrace ? currentTrace ? "new" : "unchanged" : previousTrace.traceMode !== currentTrace?.mode || previousTrace.sourceBalanceStrategy !== currentTrace?.sourceBalanceStrategy || previousTrace.transformedQuery !== (currentTrace?.transformedQuery || undefined) || previousTrace.variantQueries.join("|") !== (currentTrace?.variantQueries ?? []).join("|") || previousTrace.finalCount !== (currentTrace?.resultCounts.final ?? 0) || previousTrace.vectorCount !== (currentTrace?.resultCounts.vector ?? 0) || previousTrace.lexicalCount !== (currentTrace?.resultCounts.lexical ?? 0) || previousTrace.candidateTopK !== (currentTrace?.candidateTopK ?? 0) || previousTrace.lexicalTopK !== (currentTrace?.lexicalTopK ?? 0) || !areStageCountsEqual(previousStageCounts, stageCounts) ? "changed" : "unchanged";
   return {
     candidateTopK: currentTrace?.candidateTopK ?? 0,
     caseId: caseResult.caseId,
@@ -2593,6 +2606,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousFinalCount: previousTrace?.finalCount,
     previousLexicalCount: previousTrace?.lexicalCount,
     previousLexicalTopK: previousTrace?.lexicalTopK,
+    previousSourceBalanceStrategy: previousTrace?.sourceBalanceStrategy,
     previousStageCounts,
     previousTraceMode: previousTrace?.traceMode,
     previousTransformedQuery: previousTrace?.transformedQuery,
@@ -2601,6 +2615,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     query: caseResult.query,
     stageCounts,
     status: caseResult.status,
+    sourceBalanceStrategy: currentTrace?.sourceBalanceStrategy,
     traceChange,
     traceMode: currentTrace?.mode,
     transformedQuery: currentTrace?.transformedQuery || undefined,
@@ -2645,6 +2660,7 @@ var buildEvaluationCaseTraceSnapshots = ({
         },
         runLexical: currentSnapshot.lexicalCount > 0,
         runVector: currentSnapshot.vectorCount > 0,
+        sourceBalanceStrategy: currentSnapshot.sourceBalanceStrategy ?? "cap",
         steps: [],
         topK: caseResult.topK,
         transformedQuery: currentSnapshot.transformedQuery ?? caseResult.query,
@@ -2675,6 +2691,7 @@ var formatRetrievalComparisonHeadline = (entry) => [
   `latency ${entry.response.summary.averageLatencyMs.toFixed(1)}ms`
 ].join(" \xB7 ");
 var formatTraceModes = (modes) => modes.length > 0 ? modes.join(" / ") : "n/a";
+var formatSourceBalanceStrategies = (strategies) => strategies.length > 0 ? strategies.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";
@@ -2710,9 +2727,21 @@ var buildRAGComparisonTraceSummaryRows = (entry) => {
   }
   return [
     { label: "Modes", value: formatTraceModes(trace.modes) },
+    {
+      label: "Balance",
+      value: formatSourceBalanceStrategies(trace.sourceBalanceStrategies)
+    },
     { 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: "Balanced",
+      value: formatTraceRatio(trace.balancedCases, trace.totalCases)
+    },
+    {
+      label: "Round robin",
+      value: formatTraceRatio(trace.roundRobinCases, trace.totalCases)
+    },
     {
       label: "Transforms",
       value: formatTraceRatio(trace.transformedCases, trace.totalCases)
@@ -2760,6 +2789,12 @@ var buildRAGComparisonTraceDiffRows = (entry, leader) => {
       value: `${formatTraceModes(trace.modes)} vs ${formatTraceModes(leaderTrace.modes)}`
     });
   }
+  if (formatSourceBalanceStrategies(trace.sourceBalanceStrategies) !== formatSourceBalanceStrategies(leaderTrace.sourceBalanceStrategies)) {
+    rows.push({
+      label: "Balance vs leader",
+      value: `${formatSourceBalanceStrategies(trace.sourceBalanceStrategies)} vs ${formatSourceBalanceStrategies(leaderTrace.sourceBalanceStrategies)}`
+    });
+  }
   rows.push({
     label: "Final delta",
     value: formatSignedDelta(trace.averageFinalCount - leaderTrace.averageFinalCount, 1)
@@ -2772,6 +2807,12 @@ var buildRAGComparisonTraceDiffRows = (entry, leader) => {
   }, {
     label: "Transform delta",
     value: formatTraceCountDelta(trace.transformedCases - leaderTrace.transformedCases)
+  }, {
+    label: "Balanced delta",
+    value: formatTraceCountDelta(trace.balancedCases - leaderTrace.balancedCases)
+  }, {
+    label: "Round robin delta",
+    value: formatTraceCountDelta(trace.roundRobinCases - leaderTrace.roundRobinCases)
   });
   if (stageDelta) {
     rows.push({ label: "Stage delta", value: stageDelta });
@@ -2935,7 +2976,7 @@ var buildRAGEvaluationHistoryRows = (history) => {
   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)}`
+      value: `${formatTraceModes(history.latestRun.traceSummary.modes)} \xB7 balance ${formatSourceBalanceStrategies(history.latestRun.traceSummary.sourceBalanceStrategies)} \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) {
@@ -2971,6 +3012,9 @@ var buildRAGEvaluationHistoryRows = (history) => {
     rows.push({
       label: "Trace mode shift",
       value: history.diff.traceSummaryDelta.modesChanged ? "changed" : "stable"
+    }, {
+      label: "Trace balance shift",
+      value: history.diff.traceSummaryDelta.sourceBalanceStrategiesChanged ? "changed" : "stable"
     }, {
       label: "Trace final delta",
       value: formatSignedDelta(history.diff.traceSummaryDelta.averageFinalCount, 1)
@@ -2980,6 +3024,12 @@ var buildRAGEvaluationHistoryRows = (history) => {
     }, {
       label: "Trace lexical delta",
       value: formatSignedDelta(history.diff.traceSummaryDelta.averageLexicalCount, 1)
+    }, {
+      label: "Trace balanced delta",
+      value: formatTraceCountDelta(history.diff.traceSummaryDelta.balancedCases)
+    }, {
+      label: "Trace round robin delta",
+      value: formatTraceCountDelta(history.diff.traceSummaryDelta.roundRobinCases)
     }, {
       label: "Trace transform delta",
       value: formatTraceCountDelta(history.diff.traceSummaryDelta.transformedCases)
@@ -3009,6 +3059,8 @@ var buildRAGEvaluationCaseTracePresentations = (history) => {
     const label = entry.label ?? entry.caseId;
     const currentMode = entry.traceMode ?? "no-trace";
     const previousMode = entry.previousTraceMode ?? "n/a";
+    const currentBalance = entry.sourceBalanceStrategy ?? "cap";
+    const previousBalance = entry.previousSourceBalanceStrategy ?? "n/a";
     const currentVariants = entry.variantQueries.length > 0 ? entry.variantQueries.join(", ") : "none";
     const previousVariants = entry.previousVariantQueries.length > 0 ? entry.previousVariantQueries.join(", ") : "none";
     const currentStages = Object.keys(entry.stageCounts).length > 0 ? Object.entries(entry.stageCounts).map(([stage, count]) => `${stage} ${count}`).join(", ") : "none";
@@ -3016,12 +3068,16 @@ var buildRAGEvaluationCaseTracePresentations = (history) => {
     return {
       caseId: entry.caseId,
       label,
-      summary: `${entry.traceChange} \xB7 ${previousMode}\u2192${currentMode} \xB7 final ${entry.previousFinalCount ?? 0}\u2192${entry.finalCount}`,
+      summary: `${entry.traceChange} \xB7 ${previousMode}\u2192${currentMode} \xB7 ${previousBalance}\u2192${currentBalance} \xB7 final ${entry.previousFinalCount ?? 0}\u2192${entry.finalCount}`,
       traceChange: entry.traceChange,
       rows: [
         { label: "Query", value: entry.query },
         { label: "Trace change", value: entry.traceChange },
         { label: "Mode", value: `${previousMode}\u2192${currentMode}` },
+        {
+          label: "Balance",
+          value: `${previousBalance}\u2192${currentBalance}`
+        },
         {
           label: "Transformed query",
           value: `${entry.previousTransformedQuery?.trim() || "n/a"}\u2192${entry.transformedQuery?.trim() || "n/a"}`
@@ -3093,12 +3149,15 @@ var buildRAGEvaluationRunDiff = ({
       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),
+      balancedCases: (current.traceSummary?.balancedCases ?? 0) - (previous?.traceSummary?.balancedCases ?? 0),
       lexicalCases: (current.traceSummary?.lexicalCases ?? 0) - (previous?.traceSummary?.lexicalCases ?? 0),
       modesChanged: (current.traceSummary?.modes ?? []).join("|") !== (previous?.traceSummary?.modes ?? []).join("|"),
+      roundRobinCases: (current.traceSummary?.roundRobinCases ?? 0) - (previous?.traceSummary?.roundRobinCases ?? 0),
       stageCounts: diffTraceStageCounts({
         current: current.traceSummary?.stageCounts ?? {},
         previous: previous?.traceSummary?.stageCounts ?? {}
       }),
+      sourceBalanceStrategiesChanged: (current.traceSummary?.sourceBalanceStrategies ?? []).join("|") !== (previous?.traceSummary?.sourceBalanceStrategies ?? []).join("|"),
       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)
@@ -4492,5 +4551,5 @@ export {
   createAIStream
 };
 
-//# debugId=086F4529C4D4B76164756E2164756E21
+//# debugId=4C6A458565CAE93E64756E2164756E21
 //# sourceMappingURL=index.js.map