@absolutejs/absolute 0.19.0-beta.613 → 0.19.0-beta.615

package/dist/types/ai.d.ts

@@ -128,7 +128,14 @@ export type RAGSectionRetrievalDiagnostic = {
         mode: 'primary' | 'transformed' | 'variant' | 'mixed';
         reasons: RAGSectionQueryAttributionReason[];
     };
+    requestedMode?: RAGHybridRetrievalMode;
     retrievalMode?: RAGHybridRetrievalMode;
+    routingProvider?: string;
+    routingLabel?: string;
+    routingReason?: string;
+    queryTransformProvider?: string;
+    queryTransformLabel?: string;
+    queryTransformReason?: string;
     rerankApplied?: boolean;
     sourceBalanceApplied?: boolean;
     scoreThresholdApplied?: boolean;
@@ -432,6 +439,9 @@ export type RAGQueryTransformInput = {
 export type RAGQueryTransformResult = {
     query: string;
     variants?: string[];
+    label?: string;
+    reason?: string;
+    metadata?: Record<string, string | number | boolean | null>;
 };
 export type RAGQueryTransformer = (input: RAGQueryTransformInput) => Promise<RAGQueryTransformResult> | RAGQueryTransformResult;
 export type RAGQueryTransformProvider = {
@@ -440,6 +450,39 @@ export type RAGQueryTransformProvider = {
     providerName?: string;
 };
 export type RAGQueryTransformProviderLike = RAGQueryTransformer | RAGQueryTransformProvider;
+export type RAGRetrievalStrategyDecision = {
+    mode?: RAGHybridRetrievalMode;
+    lexicalTopK?: number;
+    maxResultsPerSource?: number;
+    sourceBalanceStrategy?: RAGSourceBalanceStrategy;
+    diversityStrategy?: RAGDiversityStrategy;
+    mmrLambda?: number;
+    fusion?: RAGHybridFusionMode;
+    fusionConstant?: number;
+    lexicalWeight?: number;
+    vectorWeight?: number;
+    label?: string;
+    reason?: string;
+    metadata?: Record<string, string | number | boolean | null>;
+};
+export type RAGRetrievalStrategyInput = {
+    query: string;
+    transformedQuery: string;
+    variantQueries: string[];
+    topK: number;
+    candidateTopK: number;
+    filter?: Record<string, unknown>;
+    scoreThreshold?: number;
+    model?: string;
+    retrieval: RAGHybridSearchOptions;
+};
+export type RAGRetrievalStrategySelector = (input: RAGRetrievalStrategyInput) => Promise<RAGRetrievalStrategyDecision | undefined> | RAGRetrievalStrategyDecision | undefined;
+export type RAGRetrievalStrategyProvider = {
+    select: RAGRetrievalStrategySelector;
+    providerName?: string;
+    defaultLabel?: string;
+};
+export type RAGRetrievalStrategyProviderLike = RAGRetrievalStrategySelector | RAGRetrievalStrategyProvider;
 export type RAGRerankerInput = {
     query: string;
     queryVector: number[];
@@ -692,12 +735,13 @@ export type RAGCollectionSearchParams = {
     filter?: Record<string, unknown>;
     scoreThreshold?: number;
     queryTransform?: RAGQueryTransformProviderLike;
+    retrievalStrategy?: RAGRetrievalStrategyProviderLike;
     rerank?: RAGRerankerProviderLike;
     retrieval?: RAGHybridSearchOptions | RAGHybridRetrievalMode;
     model?: string;
     signal?: AbortSignal;
 };
-export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'diversity' | 'source_balance' | 'score_filter' | 'finalize';
+export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'routing' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'diversity' | 'source_balance' | 'score_filter' | 'finalize';
 export type RAGRetrievalTraceStep = {
     stage: RAGRetrievalTraceStage;
     label: string;
@@ -719,14 +763,21 @@ export type RAGRetrievalTrace = {
     query: string;
     transformedQuery: string;
     variantQueries: string[];
+    queryTransformProvider?: string;
+    queryTransformLabel?: string;
+    queryTransformReason?: string;
     topK: number;
     candidateTopK: number;
     lexicalTopK: number;
+    requestedMode?: RAGHybridRetrievalMode;
     maxResultsPerSource?: number;
     sourceBalanceStrategy?: RAGSourceBalanceStrategy;
     diversityStrategy?: RAGDiversityStrategy;
     mmrLambda?: number;
     mode: RAGHybridRetrievalMode;
+    routingProvider?: string;
+    routingLabel?: string;
+    routingReason?: string;
     runVector: boolean;
     runLexical: boolean;
     scoreThreshold?: number;

package/dist/vue/ai/index.js

@@ -3772,10 +3772,35 @@ var buildRAGRetrievalTracePresentation = (trace) => {
   ];
   const details = [
     { label: "Transformed query", value: trace.transformedQuery },
+    ...trace.queryTransformLabel || trace.queryTransformProvider ? [
+      {
+        label: "Query transform",
+        value: trace.queryTransformLabel ?? trace.queryTransformProvider ?? "configured"
+      },
+      ...trace.queryTransformReason ? [
+        {
+          label: "Query transform reason",
+          value: trace.queryTransformReason
+        }
+      ] : []
+    ] : [],
     {
       label: "Variant queries",
       value: trace.variantQueries.length > 0 ? trace.variantQueries.join(" \xB7 ") : "none"
     },
+    ...trace.requestedMode && trace.requestedMode !== trace.mode ? [{ label: "Requested mode", value: trace.requestedMode }] : [],
+    ...trace.routingLabel || trace.routingProvider ? [
+      {
+        label: "Routing decision",
+        value: trace.routingLabel ?? trace.routingProvider ?? "configured"
+      },
+      ...trace.routingReason ? [
+        {
+          label: "Routing reason",
+          value: trace.routingReason
+        }
+      ] : []
+    ] : [],
     { label: "Candidate topK", value: String(trace.candidateTopK) },
     { label: "Lexical topK", value: String(trace.lexicalTopK) }
   ];
@@ -4668,10 +4693,10 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     const vectorHits = channels.includes("vector") ? 1 : 0;
     const lexicalHits = channels.includes("lexical") ? 1 : 0;
     const hybridHits = isHybrid ? 1 : 0;
-    const queryOrigin = source.metadata?.retrievalQueryOrigin;
-    const primaryHits = queryOrigin === "primary" ? 1 : 0;
-    const transformedHits = queryOrigin === "transformed" ? 1 : 0;
-    const variantHits = queryOrigin === "variant" ? 1 : 0;
+    const queryOrigins = Array.isArray(source.metadata?.retrievalQueryOrigins) ? source.metadata.retrievalQueryOrigins.filter((value) => value === "primary" || value === "transformed" || value === "variant") : source.metadata?.retrievalQueryOrigin === "primary" || source.metadata?.retrievalQueryOrigin === "transformed" || source.metadata?.retrievalQueryOrigin === "variant" ? [source.metadata.retrievalQueryOrigin] : [];
+    const primaryHits = queryOrigins.includes("primary") ? 1 : 0;
+    const transformedHits = queryOrigins.includes("transformed") ? 1 : 0;
+    const variantHits = queryOrigins.includes("variant") ? 1 : 0;
     if (!existing) {
       sections.set(key, {
         bestScore: source.score,
@@ -4878,7 +4903,14 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
         transformedHits: section.transformedHits,
         variantHits: section.variantHits
       },
+      requestedMode: trace?.requestedMode,
       retrievalMode: trace?.mode,
+      routingLabel: trace?.routingLabel,
+      routingProvider: trace?.routingProvider,
+      routingReason: trace?.routingReason,
+      queryTransformLabel: trace?.queryTransformLabel,
+      queryTransformProvider: trace?.queryTransformProvider,
+      queryTransformReason: trace?.queryTransformReason,
       reasons,
       rerankApplied: trace?.steps.some((step) => step.stage === "rerank" && step.metadata?.applied === true),
       scoreShare,
@@ -8191,5 +8223,5 @@ export {
   AIStreamKey
 };
 
-//# debugId=B01D3BA3D00EF09B64756E2164756E21
+//# debugId=044DA3D708DF041064756E2164756E21
 //# sourceMappingURL=index.js.map