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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  export { aiChat } from '../plugins/aiChat';
2
2
  export { streamAI } from './streamAI';
3
3
  export { ragChat } from './rag';
4
- export { buildRAGContext, compareRAGRetrievalStrategies, compareRAGRerankers, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createHeuristicRAGQueryTransform, createHeuristicRAGReranker, createLegacyDocumentExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createRAGBunS3SyncClient, createRAGCollection, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGEmbeddingProvider, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGFileEvaluationHistoryStore, createRAGFileRetrievalBaselineStore, createRAGFileRetrievalComparisonHistoryStore, createRAGFileRetrievalLaneHandoffDecisionStore, createRAGFileRetrievalLaneHandoffIncidentStore, createRAGFileRetrievalLaneHandoffIncidentHistoryStore, createRAGFileRetrievalIncidentRemediationDecisionStore, createRAGFileRetrievalIncidentRemediationExecutionHistoryStore, createRAGFileRetrievalLaneHandoffAutoCompletePolicyHistoryStore, createRAGFileRetrievalReleaseLanePolicyHistoryStore, createRAGFileRetrievalBaselineGatePolicyHistoryStore, createRAGFileRetrievalReleaseLaneEscalationPolicyHistoryStore, createRAGFileRetrievalReleaseDecisionStore, createRAGFileRetrievalReleaseIncidentStore, createRAGFileSearchTraceStore, createRAGFileSearchTracePruneHistoryStore, createRAGSQLiteSearchTraceStore, createRAGFileExtractor, createRAGFileSyncStateStore, createRAGGmailEmailSyncClient, createRAGGraphEmailSyncClient, createRAGHTMXConfig, createRAGHTMXWorkflowRenderConfig, createRAGImageOCRExtractor, createRAGIMAPEmailSyncClient, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGPDFOCRExtractor, createRAGQueryTransform, createRAGReranker, createRAGStorageSyncSource, createRAGSyncManager, createRAGSyncScheduler, createRAGStaticEmailSyncClient, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, buildRAGUpsertInputFromUploads, buildRAGUpsertInputFromURLs, createRAGUrlSyncSource, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGOCRProvider, createTextFileExtractor, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, loadRAGRetrievalBaselines, loadRAGRetrievalComparisonHistory, loadRAGRetrievalLaneHandoffDecisions, loadRAGRetrievalLaneHandoffIncidents, loadRAGRetrievalLaneHandoffIncidentHistory, loadRAGRetrievalIncidentRemediationDecisions, loadRAGRetrievalIncidentRemediationExecutionHistory, loadRAGRetrievalLaneHandoffAutoCompletePolicyHistory, loadRAGRetrievalReleaseLanePolicyHistory, loadRAGRetrievalBaselineGatePolicyHistory, loadRAGRetrievalReleaseLaneEscalationPolicyHistory, loadRAGRetrievalReleaseDecisions, loadRAGRetrievalReleaseIncidents, loadRAGSearchTraceGroupHistory, loadRAGSearchTraceHistory, loadRAGSearchTracePruneHistory, previewRAGSearchTraceStorePrune, persistRAGRetrievalBaseline, persistRAGRetrievalComparisonRun, persistRAGRetrievalLaneHandoffDecision, persistRAGRetrievalLaneHandoffIncident, persistRAGRetrievalLaneHandoffIncidentHistory, persistRAGRetrievalIncidentRemediationDecision, persistRAGRetrievalIncidentRemediationExecutionHistory, persistRAGRetrievalLaneHandoffAutoCompletePolicyHistory, persistRAGRetrievalReleaseLanePolicyHistory, persistRAGRetrievalBaselineGatePolicyHistory, persistRAGRetrievalReleaseLaneEscalationPolicyHistory, persistRAGRetrievalReleaseDecision, persistRAGRetrievalReleaseIncident, persistRAGSearchTracePruneRun, pruneRAGSearchTraceStore, summarizeRAGSearchTraceStore, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentsFromUploads, loadRAGDocumentsFromURLs, loadRAGDocumentUpload, loadRAGDocumentFromURL, prepareRAGDirectoryDocuments, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, persistRAGSearchTraceRecord, ragPlugin, runRAGEvaluationSuite, resolveRAGEmbeddingProvider, resolveRAGHybridSearchOptions, resolveRAGQueryTransform, resolveRAGReranker, searchDocuments, buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGAdminActionPresentation, buildRAGAdminActionPresentations, buildRAGAdminJobPresentation, buildRAGAdminJobPresentations, buildRAGAnswerGroundingCaseSnapshotPresentations, buildRAGAnswerGroundingHistoryPresentation, buildRAGAnswerGroundingHistoryRows, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGCorpusHealthPresentation, buildRAGEvaluationCaseTracePresentations, buildRAGEvaluationHistoryPresentation, buildRAGEvaluationHistoryRows, buildRAGGroundedAnswer, buildRAGGroundingOverviewPresentation, buildRAGGroundingProviderCaseComparisonPresentations, buildRAGGroundingProviderOverviewPresentation, buildRAGGroundingProviderPresentations, buildRAGGroundingReferences, buildRAGQualityOverviewPresentation, buildRAGReadinessPresentation, buildRAGRerankerComparisonOverviewPresentation, buildRAGRerankerComparisonPresentations, buildRAGRerankerOverviewPresentation, buildRAGRetrievalComparisonOverviewPresentation, buildRAGRetrievalComparisonPresentations, buildRAGRetrievalComparisonDecisionSummary, buildRAGRetrievalReleaseVerdict, buildRAGRetrievalOverviewPresentation, buildRAGRetrievalTracePresentation, buildRAGEvaluationLeaderboard, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, buildRAGSearchTraceDiff, buildRAGSearchTraceRecord, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGSyncOverviewPresentation, buildRAGSyncSourcePresentation, buildRAGSyncSourcePresentations, scoreRAGLexicalMatch, compareRAGRetrievalTraceSummaries, summarizeRAGRetrievalTraces, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison, applyRAGQueryTransform, applyRAGReranking, fuseRAGQueryResults, ingestDocuments, ingestRAGDocuments, buildRAGRetrievalTraceHistoryTrend, createRAGEvaluationSuite, buildRAGLexicalHaystack, validateRAGEmbeddingDimensions, alibabaEmbeddings, anthropicOCR, deepseekEmbeddings, googleEmbeddings, geminiEmbeddings, geminiOCR, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, ollamaOCR, ollamaTranscriber, openaiCompatibleEmbeddings, openaiCompatibleOCR, openaiCompatibleTranscriber, openaiEmbeddings, openaiOCR, openaiTranscriber, xaiEmbeddings } from './rag';
4
+ export { buildRAGContext, compareRAGRetrievalStrategies, compareRAGRerankers, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createHeuristicRAGQueryTransform, createHeuristicRAGRetrievalStrategy, createHeuristicRAGReranker, createLegacyDocumentExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createRAGBunS3SyncClient, createRAGCollection, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGEmbeddingProvider, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGFileEvaluationHistoryStore, createRAGFileRetrievalBaselineStore, createRAGFileRetrievalComparisonHistoryStore, createRAGFileRetrievalLaneHandoffDecisionStore, createRAGFileRetrievalLaneHandoffIncidentStore, createRAGFileRetrievalLaneHandoffIncidentHistoryStore, createRAGFileRetrievalIncidentRemediationDecisionStore, createRAGFileRetrievalIncidentRemediationExecutionHistoryStore, createRAGFileRetrievalLaneHandoffAutoCompletePolicyHistoryStore, createRAGFileRetrievalReleaseLanePolicyHistoryStore, createRAGFileRetrievalBaselineGatePolicyHistoryStore, createRAGFileRetrievalReleaseLaneEscalationPolicyHistoryStore, createRAGFileRetrievalReleaseDecisionStore, createRAGFileRetrievalReleaseIncidentStore, createRAGFileSearchTraceStore, createRAGFileSearchTracePruneHistoryStore, createRAGSQLiteSearchTraceStore, createRAGFileExtractor, createRAGFileSyncStateStore, createRAGGmailEmailSyncClient, createRAGGraphEmailSyncClient, createRAGHTMXConfig, createRAGHTMXWorkflowRenderConfig, createRAGImageOCRExtractor, createRAGIMAPEmailSyncClient, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGPDFOCRExtractor, createRAGQueryTransform, createRAGReranker, createRAGStorageSyncSource, createRAGSyncManager, createRAGSyncScheduler, createRAGStaticEmailSyncClient, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, buildRAGUpsertInputFromUploads, buildRAGUpsertInputFromURLs, createRAGUrlSyncSource, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGOCRProvider, createTextFileExtractor, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, loadRAGRetrievalBaselines, loadRAGRetrievalComparisonHistory, loadRAGRetrievalLaneHandoffDecisions, loadRAGRetrievalLaneHandoffIncidents, loadRAGRetrievalLaneHandoffIncidentHistory, loadRAGRetrievalIncidentRemediationDecisions, loadRAGRetrievalIncidentRemediationExecutionHistory, loadRAGRetrievalLaneHandoffAutoCompletePolicyHistory, loadRAGRetrievalReleaseLanePolicyHistory, loadRAGRetrievalBaselineGatePolicyHistory, loadRAGRetrievalReleaseLaneEscalationPolicyHistory, loadRAGRetrievalReleaseDecisions, loadRAGRetrievalReleaseIncidents, loadRAGSearchTraceGroupHistory, loadRAGSearchTraceHistory, loadRAGSearchTracePruneHistory, previewRAGSearchTraceStorePrune, persistRAGRetrievalBaseline, persistRAGRetrievalComparisonRun, persistRAGRetrievalLaneHandoffDecision, persistRAGRetrievalLaneHandoffIncident, persistRAGRetrievalLaneHandoffIncidentHistory, persistRAGRetrievalIncidentRemediationDecision, persistRAGRetrievalIncidentRemediationExecutionHistory, persistRAGRetrievalLaneHandoffAutoCompletePolicyHistory, persistRAGRetrievalReleaseLanePolicyHistory, persistRAGRetrievalBaselineGatePolicyHistory, persistRAGRetrievalReleaseLaneEscalationPolicyHistory, persistRAGRetrievalReleaseDecision, persistRAGRetrievalReleaseIncident, persistRAGSearchTracePruneRun, pruneRAGSearchTraceStore, summarizeRAGSearchTraceStore, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentsFromUploads, loadRAGDocumentsFromURLs, loadRAGDocumentUpload, loadRAGDocumentFromURL, prepareRAGDirectoryDocuments, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, persistRAGSearchTraceRecord, ragPlugin, runRAGEvaluationSuite, resolveRAGEmbeddingProvider, resolveRAGHybridSearchOptions, resolveRAGQueryTransform, resolveRAGReranker, searchDocuments, buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGRetrievalComparisonDecisionSummary, buildRAGRetrievalReleaseVerdict, buildRAGEvaluationLeaderboard, buildRAGEvaluationResponse, buildRAGEvaluationRunDiff, buildRAGSearchTraceDiff, buildRAGSearchTraceRecord, scoreRAGLexicalMatch, compareRAGRetrievalTraceSummaries, summarizeRAGRetrievalTraces, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison, applyRAGQueryTransform, applyRAGReranking, fuseRAGQueryResults, ingestDocuments, ingestRAGDocuments, buildRAGRetrievalTraceHistoryTrend, createRAGEvaluationSuite, buildRAGLexicalHaystack, validateRAGEmbeddingDimensions, alibabaEmbeddings, anthropicOCR, deepseekEmbeddings, googleEmbeddings, geminiEmbeddings, geminiOCR, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, ollamaOCR, ollamaTranscriber, openaiCompatibleEmbeddings, openaiCompatibleOCR, openaiCompatibleTranscriber, openaiEmbeddings, openaiOCR, openaiTranscriber, xaiEmbeddings } from './rag';
5
5
  export { createInMemoryRAGStore } from './rag/adapters/inMemory';
6
6
  export { createSQLiteRAGStore } from './rag/adapters/sqlite';
7
7
  export { resolveAbsoluteSQLiteVec, resolveAbsoluteSQLiteVecExtensionPath } from './rag/resolveAbsoluteSQLiteVec';
@@ -1,4 +1,4 @@
1
- import type { RAGCollection, RAGCollectionSearchParams, RAGRerankerProviderLike, RAGDocumentIngestInput, RAGEmbeddingProviderLike, RAGQueryResult, RAGQueryTransformProviderLike, RAGUpsertInput, RAGVectorStore } from '../../../types/ai';
1
+ import type { RAGCollection, RAGCollectionSearchParams, RAGRerankerProviderLike, RAGDocumentIngestInput, RAGEmbeddingProviderLike, RAGQueryResult, RAGQueryTransformProviderLike, RAGRetrievalStrategyProviderLike, RAGUpsertInput, RAGVectorStore } from '../../../types/ai';
2
2
  export type CreateRAGCollectionOptions = {
3
3
  store: RAGVectorStore;
4
4
  embedding?: RAGEmbeddingProviderLike;
@@ -6,6 +6,7 @@ export type CreateRAGCollectionOptions = {
6
6
  defaultCandidateMultiplier?: number;
7
7
  defaultModel?: string;
8
8
  queryTransform?: RAGQueryTransformProviderLike;
9
+ retrievalStrategy?: RAGRetrievalStrategyProviderLike;
9
10
  rerank?: RAGRerankerProviderLike;
10
11
  };
11
12
  export declare const createRAGCollection: (options: CreateRAGCollectionOptions) => RAGCollection;
@@ -3,6 +3,7 @@ export { createRAGHTMXConfig, createRAGHTMXWorkflowRenderConfig } from './htmxCo
3
3
  export { createRAGEmbeddingProvider, resolveRAGEmbeddingProvider, validateRAGEmbeddingDimensions } from './embedding';
4
4
  export { applyRAGReranking, createHeuristicRAGReranker, createRAGReranker, resolveRAGReranker } from './reranking';
5
5
  export { applyRAGQueryTransform, createHeuristicRAGQueryTransform, createRAGQueryTransform, resolveRAGQueryTransform } from './queryTransforms';
6
+ export { createHeuristicRAGRetrievalStrategy } from './retrievalStrategies';
6
7
  export { buildRAGLexicalHaystack, fuseRAGQueryResults, resolveRAGHybridSearchOptions, scoreRAGLexicalMatch } from './lexical';
7
8
  export { alibabaEmbeddings, deepseekEmbeddings, geminiEmbeddings, googleEmbeddings, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, openaiCompatibleEmbeddings, openaiEmbeddings, xaiEmbeddings } from './embeddingProviders';
8
9
  export { anthropicOCR, geminiOCR, ollamaOCR, ollamaTranscriber, openaiCompatibleOCR, openaiCompatibleTranscriber, openaiOCR, openaiTranscriber } from './extractorProviders';
@@ -0,0 +1,6 @@
1
+ import type { RAGRetrievalStrategyProvider } from '../../../types/ai';
2
+ export type HeuristicRAGRetrievalStrategyOptions = {
3
+ providerName?: string;
4
+ defaultLabel?: string;
5
+ };
6
+ export declare const createHeuristicRAGRetrievalStrategy: (options?: HeuristicRAGRetrievalStrategyOptions) => RAGRetrievalStrategyProvider;
@@ -171,6 +171,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
171
171
  candidateTopK?: number | undefined;
172
172
  scoreThreshold?: number | undefined;
173
173
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
174
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
174
175
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
175
176
  model?: string | undefined;
176
177
  persistTrace?: boolean | undefined;
@@ -184,6 +185,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
184
185
  candidateTopK?: number | undefined;
185
186
  scoreThreshold?: number | undefined;
186
187
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
188
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
187
189
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
188
190
  model?: string | undefined;
189
191
  persistTrace?: boolean | undefined;
@@ -173,6 +173,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
173
173
  candidateTopK?: number | undefined;
174
174
  scoreThreshold?: number | undefined;
175
175
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
176
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
176
177
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
177
178
  model?: string | undefined;
178
179
  persistTrace?: boolean | undefined;
@@ -186,6 +187,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
186
187
  candidateTopK?: number | undefined;
187
188
  scoreThreshold?: number | undefined;
188
189
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
190
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
189
191
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
190
192
  model?: string | undefined;
191
193
  persistTrace?: boolean | undefined;
@@ -473,6 +473,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
473
473
  input?: number | undefined;
474
474
  embed?: number | undefined;
475
475
  query_transform?: number | undefined;
476
+ routing?: number | undefined;
476
477
  vector_search?: number | undefined;
477
478
  lexical_search?: number | undefined;
478
479
  fusion?: number | undefined;
@@ -536,6 +537,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
536
537
  input?: number | undefined;
537
538
  embed?: number | undefined;
538
539
  query_transform?: number | undefined;
540
+ routing?: number | undefined;
539
541
  vector_search?: number | undefined;
540
542
  lexical_search?: number | undefined;
541
543
  fusion?: number | undefined;
@@ -549,6 +551,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
549
551
  input?: number | undefined;
550
552
  embed?: number | undefined;
551
553
  query_transform?: number | undefined;
554
+ routing?: number | undefined;
552
555
  vector_search?: number | undefined;
553
556
  lexical_search?: number | undefined;
554
557
  fusion?: number | undefined;
@@ -623,6 +626,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
623
626
  input?: number | undefined;
624
627
  embed?: number | undefined;
625
628
  query_transform?: number | undefined;
629
+ routing?: number | undefined;
626
630
  vector_search?: number | undefined;
627
631
  lexical_search?: number | undefined;
628
632
  fusion?: number | undefined;
@@ -686,6 +690,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
686
690
  input?: number | undefined;
687
691
  embed?: number | undefined;
688
692
  query_transform?: number | undefined;
693
+ routing?: number | undefined;
689
694
  vector_search?: number | undefined;
690
695
  lexical_search?: number | undefined;
691
696
  fusion?: number | undefined;
@@ -699,6 +704,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
699
704
  input?: number | undefined;
700
705
  embed?: number | undefined;
701
706
  query_transform?: number | undefined;
707
+ routing?: number | undefined;
702
708
  vector_search?: number | undefined;
703
709
  lexical_search?: number | undefined;
704
710
  fusion?: number | undefined;
@@ -1316,6 +1322,11 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1316
1322
  defaultModel?: string | undefined;
1317
1323
  providerName?: string | undefined;
1318
1324
  } | undefined;
1325
+ retrievalStrategy?: import("../..").RAGRetrievalStrategySelector | {
1326
+ select: import("../..").RAGRetrievalStrategySelector;
1327
+ providerName?: string | undefined;
1328
+ defaultLabel?: string | undefined;
1329
+ } | undefined;
1319
1330
  retrieval?: import("../..").RAGHybridRetrievalMode | {
1320
1331
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
1321
1332
  lexicalTopK?: number | undefined;
@@ -1344,6 +1355,11 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1344
1355
  defaultModel?: string | undefined;
1345
1356
  providerName?: string | undefined;
1346
1357
  } | undefined;
1358
+ retrievalStrategy?: import("../..").RAGRetrievalStrategySelector | {
1359
+ select: import("../..").RAGRetrievalStrategySelector;
1360
+ providerName?: string | undefined;
1361
+ defaultLabel?: string | undefined;
1362
+ } | undefined;
1347
1363
  retrieval?: import("../..").RAGHybridRetrievalMode | {
1348
1364
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
1349
1365
  lexicalTopK?: number | undefined;
@@ -1425,6 +1441,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1425
1441
  candidateTopK?: number | undefined;
1426
1442
  scoreThreshold?: number | undefined;
1427
1443
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
1444
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
1428
1445
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
1429
1446
  model?: string | undefined;
1430
1447
  persistTrace?: boolean | undefined;
@@ -1438,6 +1455,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1438
1455
  candidateTopK?: number | undefined;
1439
1456
  scoreThreshold?: number | undefined;
1440
1457
  queryTransform?: import("../..").RAGQueryTransformProviderLike | undefined;
1458
+ retrievalStrategy?: import("../..").RAGRetrievalStrategyProviderLike | undefined;
1441
1459
  retrieval?: (import("../..").RAGHybridSearchOptions | import("../..").RAGHybridRetrievalMode) | undefined;
1442
1460
  model?: string | undefined;
1443
1461
  persistTrace?: boolean | undefined;
@@ -240,6 +240,7 @@ export declare const useRAGEvaluate: (path: string) => {
240
240
  input?: number | undefined;
241
241
  embed?: number | undefined;
242
242
  query_transform?: number | undefined;
243
+ routing?: number | undefined;
243
244
  vector_search?: number | undefined;
244
245
  lexical_search?: number | undefined;
245
246
  fusion?: number | undefined;
@@ -303,6 +304,7 @@ export declare const useRAGEvaluate: (path: string) => {
303
304
  input?: number | undefined;
304
305
  embed?: number | undefined;
305
306
  query_transform?: number | undefined;
307
+ routing?: number | undefined;
306
308
  vector_search?: number | undefined;
307
309
  lexical_search?: number | undefined;
308
310
  fusion?: number | undefined;
@@ -316,6 +318,7 @@ export declare const useRAGEvaluate: (path: string) => {
316
318
  input?: number | undefined;
317
319
  embed?: number | undefined;
318
320
  query_transform?: number | undefined;
321
+ routing?: number | undefined;
319
322
  vector_search?: number | undefined;
320
323
  lexical_search?: number | undefined;
321
324
  fusion?: number | undefined;
@@ -390,6 +393,7 @@ export declare const useRAGEvaluate: (path: string) => {
390
393
  input?: number | undefined;
391
394
  embed?: number | undefined;
392
395
  query_transform?: number | undefined;
396
+ routing?: number | undefined;
393
397
  vector_search?: number | undefined;
394
398
  lexical_search?: number | undefined;
395
399
  fusion?: number | undefined;
@@ -453,6 +457,7 @@ export declare const useRAGEvaluate: (path: string) => {
453
457
  input?: number | undefined;
454
458
  embed?: number | undefined;
455
459
  query_transform?: number | undefined;
460
+ routing?: number | undefined;
456
461
  vector_search?: number | undefined;
457
462
  lexical_search?: number | undefined;
458
463
  fusion?: number | undefined;
@@ -466,6 +471,7 @@ export declare const useRAGEvaluate: (path: string) => {
466
471
  input?: number | undefined;
467
472
  embed?: number | undefined;
468
473
  query_transform?: number | undefined;
474
+ routing?: number | undefined;
469
475
  vector_search?: number | undefined;
470
476
  lexical_search?: number | undefined;
471
477
  fusion?: number | undefined;
@@ -16,6 +16,11 @@ export declare const useRAGSearch: (path: string) => {
16
16
  defaultModel?: string | undefined;
17
17
  providerName?: string | undefined;
18
18
  } | undefined;
19
+ retrievalStrategy?: import("../..").RAGRetrievalStrategySelector | {
20
+ select: import("../..").RAGRetrievalStrategySelector;
21
+ providerName?: string | undefined;
22
+ defaultLabel?: string | undefined;
23
+ } | undefined;
19
24
  retrieval?: import("../..").RAGHybridRetrievalMode | {
20
25
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
21
26
  lexicalTopK?: number | undefined;
@@ -44,6 +49,11 @@ export declare const useRAGSearch: (path: string) => {
44
49
  defaultModel?: string | undefined;
45
50
  providerName?: string | undefined;
46
51
  } | undefined;
52
+ retrievalStrategy?: import("../..").RAGRetrievalStrategySelector | {
53
+ select: import("../..").RAGRetrievalStrategySelector;
54
+ providerName?: string | undefined;
55
+ defaultLabel?: string | undefined;
56
+ } | undefined;
47
57
  retrieval?: import("../..").RAGHybridRetrievalMode | {
48
58
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
49
59
  lexicalTopK?: number | undefined;
@@ -3772,10 +3772,35 @@ var buildRAGRetrievalTracePresentation = (trace) => {
3772
3772
  ];
3773
3773
  const details = [
3774
3774
  { label: "Transformed query", value: trace.transformedQuery },
3775
+ ...trace.queryTransformLabel || trace.queryTransformProvider ? [
3776
+ {
3777
+ label: "Query transform",
3778
+ value: trace.queryTransformLabel ?? trace.queryTransformProvider ?? "configured"
3779
+ },
3780
+ ...trace.queryTransformReason ? [
3781
+ {
3782
+ label: "Query transform reason",
3783
+ value: trace.queryTransformReason
3784
+ }
3785
+ ] : []
3786
+ ] : [],
3775
3787
  {
3776
3788
  label: "Variant queries",
3777
3789
  value: trace.variantQueries.length > 0 ? trace.variantQueries.join(" \xB7 ") : "none"
3778
3790
  },
3791
+ ...trace.requestedMode && trace.requestedMode !== trace.mode ? [{ label: "Requested mode", value: trace.requestedMode }] : [],
3792
+ ...trace.routingLabel || trace.routingProvider ? [
3793
+ {
3794
+ label: "Routing decision",
3795
+ value: trace.routingLabel ?? trace.routingProvider ?? "configured"
3796
+ },
3797
+ ...trace.routingReason ? [
3798
+ {
3799
+ label: "Routing reason",
3800
+ value: trace.routingReason
3801
+ }
3802
+ ] : []
3803
+ ] : [],
3779
3804
  { label: "Candidate topK", value: String(trace.candidateTopK) },
3780
3805
  { label: "Lexical topK", value: String(trace.lexicalTopK) }
3781
3806
  ];
@@ -4668,10 +4693,10 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
4668
4693
  const vectorHits = channels.includes("vector") ? 1 : 0;
4669
4694
  const lexicalHits = channels.includes("lexical") ? 1 : 0;
4670
4695
  const hybridHits = isHybrid ? 1 : 0;
4671
- const queryOrigin = source.metadata?.retrievalQueryOrigin;
4672
- const primaryHits = queryOrigin === "primary" ? 1 : 0;
4673
- const transformedHits = queryOrigin === "transformed" ? 1 : 0;
4674
- const variantHits = queryOrigin === "variant" ? 1 : 0;
4696
+ 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] : [];
4697
+ const primaryHits = queryOrigins.includes("primary") ? 1 : 0;
4698
+ const transformedHits = queryOrigins.includes("transformed") ? 1 : 0;
4699
+ const variantHits = queryOrigins.includes("variant") ? 1 : 0;
4675
4700
  if (!existing) {
4676
4701
  sections.set(key, {
4677
4702
  bestScore: source.score,
@@ -4878,7 +4903,14 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
4878
4903
  transformedHits: section.transformedHits,
4879
4904
  variantHits: section.variantHits
4880
4905
  },
4906
+ requestedMode: trace?.requestedMode,
4881
4907
  retrievalMode: trace?.mode,
4908
+ routingLabel: trace?.routingLabel,
4909
+ routingProvider: trace?.routingProvider,
4910
+ routingReason: trace?.routingReason,
4911
+ queryTransformLabel: trace?.queryTransformLabel,
4912
+ queryTransformProvider: trace?.queryTransformProvider,
4913
+ queryTransformReason: trace?.queryTransformReason,
4882
4914
  reasons,
4883
4915
  rerankApplied: trace?.steps.some((step) => step.stage === "rerank" && step.metadata?.applied === true),
4884
4916
  scoreShare,
@@ -8220,5 +8252,5 @@ export {
8220
8252
  createAIStream
8221
8253
  };
8222
8254
 
8223
- //# debugId=6D07F2B76E9A078764756E2164756E21
8255
+ //# debugId=1D6E316C833884A664756E2164756E21
8224
8256
  //# sourceMappingURL=index.js.map