@absolutejs/absolute 0.19.0-beta.551 → 0.19.0-beta.553

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.
@@ -37,12 +37,5 @@ export declare const fuseRAGQueryResults: ({ fusion, fusionConstant, lexical, le
37
37
  source?: string;
38
38
  metadata?: Record<string, unknown>;
39
39
  }[];
40
- export declare const resolveRAGHybridSearchOptions: (retrieval: RAGHybridSearchOptions | RAGHybridRetrievalMode | undefined) => {
41
- fusion: RAGHybridFusionMode;
42
- fusionConstant: number;
43
- lexicalTopK: number | undefined;
44
- lexicalWeight: number;
45
- mode: RAGHybridRetrievalMode;
46
- vectorWeight: number;
47
- };
40
+ export declare const resolveRAGHybridSearchOptions: (retrieval: RAGHybridSearchOptions | RAGHybridRetrievalMode | undefined) => Required<Pick<RAGHybridSearchOptions, "fusion" | "fusionConstant" | "lexicalWeight" | "mode" | "sourceBalanceStrategy" | "vectorWeight">> & Pick<RAGHybridSearchOptions, "lexicalTopK" | "maxResultsPerSource">;
48
41
  export {};
@@ -329,6 +329,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
329
329
  lexical_search?: number | undefined;
330
330
  fusion?: number | undefined;
331
331
  rerank?: number | undefined;
332
+ source_balance?: number | undefined;
332
333
  score_filter?: number | undefined;
333
334
  finalize?: number | undefined;
334
335
  };
@@ -362,6 +363,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
362
363
  lexical_search?: number | undefined;
363
364
  fusion?: number | undefined;
364
365
  rerank?: number | undefined;
366
+ source_balance?: number | undefined;
365
367
  score_filter?: number | undefined;
366
368
  finalize?: number | undefined;
367
369
  };
@@ -373,6 +375,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
373
375
  lexical_search?: number | undefined;
374
376
  fusion?: number | undefined;
375
377
  rerank?: number | undefined;
378
+ source_balance?: number | undefined;
376
379
  score_filter?: number | undefined;
377
380
  finalize?: number | undefined;
378
381
  };
@@ -442,6 +445,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
442
445
  lexical_search?: number | undefined;
443
446
  fusion?: number | undefined;
444
447
  rerank?: number | undefined;
448
+ source_balance?: number | undefined;
445
449
  score_filter?: number | undefined;
446
450
  finalize?: number | undefined;
447
451
  };
@@ -475,6 +479,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
475
479
  lexical_search?: number | undefined;
476
480
  fusion?: number | undefined;
477
481
  rerank?: number | undefined;
482
+ source_balance?: number | undefined;
478
483
  score_filter?: number | undefined;
479
484
  finalize?: number | undefined;
480
485
  };
@@ -486,6 +491,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
486
491
  lexical_search?: number | undefined;
487
492
  fusion?: number | undefined;
488
493
  rerank?: number | undefined;
494
+ source_balance?: number | undefined;
489
495
  score_filter?: number | undefined;
490
496
  finalize?: number | undefined;
491
497
  };
@@ -1042,6 +1048,8 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1042
1048
  retrieval?: import("../..").RAGHybridRetrievalMode | {
1043
1049
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
1044
1050
  lexicalTopK?: number | undefined;
1051
+ maxResultsPerSource?: number | undefined;
1052
+ sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
1045
1053
  fusion?: import("../..").RAGHybridFusionMode | undefined;
1046
1054
  fusionConstant?: number | undefined;
1047
1055
  lexicalWeight?: number | undefined;
@@ -1063,6 +1071,8 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
1063
1071
  retrieval?: import("../..").RAGHybridRetrievalMode | {
1064
1072
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
1065
1073
  lexicalTopK?: number | undefined;
1074
+ maxResultsPerSource?: number | undefined;
1075
+ sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
1066
1076
  fusion?: import("../..").RAGHybridFusionMode | undefined;
1067
1077
  fusionConstant?: number | undefined;
1068
1078
  lexicalWeight?: number | undefined;
@@ -193,6 +193,7 @@ export declare const useRAGEvaluate: (path: string) => {
193
193
  lexical_search?: number | undefined;
194
194
  fusion?: number | undefined;
195
195
  rerank?: number | undefined;
196
+ source_balance?: number | undefined;
196
197
  score_filter?: number | undefined;
197
198
  finalize?: number | undefined;
198
199
  };
@@ -226,6 +227,7 @@ export declare const useRAGEvaluate: (path: string) => {
226
227
  lexical_search?: number | undefined;
227
228
  fusion?: number | undefined;
228
229
  rerank?: number | undefined;
230
+ source_balance?: number | undefined;
229
231
  score_filter?: number | undefined;
230
232
  finalize?: number | undefined;
231
233
  };
@@ -237,6 +239,7 @@ export declare const useRAGEvaluate: (path: string) => {
237
239
  lexical_search?: number | undefined;
238
240
  fusion?: number | undefined;
239
241
  rerank?: number | undefined;
242
+ source_balance?: number | undefined;
240
243
  score_filter?: number | undefined;
241
244
  finalize?: number | undefined;
242
245
  };
@@ -306,6 +309,7 @@ export declare const useRAGEvaluate: (path: string) => {
306
309
  lexical_search?: number | undefined;
307
310
  fusion?: number | undefined;
308
311
  rerank?: number | undefined;
312
+ source_balance?: number | undefined;
309
313
  score_filter?: number | undefined;
310
314
  finalize?: number | undefined;
311
315
  };
@@ -339,6 +343,7 @@ export declare const useRAGEvaluate: (path: string) => {
339
343
  lexical_search?: number | undefined;
340
344
  fusion?: number | undefined;
341
345
  rerank?: number | undefined;
346
+ source_balance?: number | undefined;
342
347
  score_filter?: number | undefined;
343
348
  finalize?: number | undefined;
344
349
  };
@@ -350,6 +355,7 @@ export declare const useRAGEvaluate: (path: string) => {
350
355
  lexical_search?: number | undefined;
351
356
  fusion?: number | undefined;
352
357
  rerank?: number | undefined;
358
+ source_balance?: number | undefined;
353
359
  score_filter?: number | undefined;
354
360
  finalize?: number | undefined;
355
361
  };
@@ -17,6 +17,8 @@ export declare const useRAGSearch: (path: string) => {
17
17
  retrieval?: import("../..").RAGHybridRetrievalMode | {
18
18
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
19
19
  lexicalTopK?: number | undefined;
20
+ maxResultsPerSource?: number | undefined;
21
+ sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
20
22
  fusion?: import("../..").RAGHybridFusionMode | undefined;
21
23
  fusionConstant?: number | undefined;
22
24
  lexicalWeight?: number | undefined;
@@ -38,6 +40,8 @@ export declare const useRAGSearch: (path: string) => {
38
40
  retrieval?: import("../..").RAGHybridRetrievalMode | {
39
41
  mode?: import("../..").RAGHybridRetrievalMode | undefined;
40
42
  lexicalTopK?: number | undefined;
43
+ maxResultsPerSource?: number | undefined;
44
+ sourceBalanceStrategy?: import("../..").RAGSourceBalanceStrategy | undefined;
41
45
  fusion?: import("../..").RAGHybridFusionMode | undefined;
42
46
  fusionConstant?: number | undefined;
43
47
  lexicalWeight?: number | undefined;
@@ -335,9 +335,12 @@ export type RAGQueryResult = {
335
335
  };
336
336
  export type RAGHybridRetrievalMode = 'vector' | 'lexical' | 'hybrid';
337
337
  export type RAGHybridFusionMode = 'rrf' | 'max';
338
+ export type RAGSourceBalanceStrategy = 'cap' | 'round_robin';
338
339
  export type RAGHybridSearchOptions = {
339
340
  mode?: RAGHybridRetrievalMode;
340
341
  lexicalTopK?: number;
342
+ maxResultsPerSource?: number;
343
+ sourceBalanceStrategy?: RAGSourceBalanceStrategy;
341
344
  fusion?: RAGHybridFusionMode;
342
345
  fusionConstant?: number;
343
346
  lexicalWeight?: number;
@@ -480,7 +483,7 @@ export type RAGCollectionSearchParams = {
480
483
  model?: string;
481
484
  signal?: AbortSignal;
482
485
  };
483
- export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'score_filter' | 'finalize';
486
+ export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'source_balance' | 'score_filter' | 'finalize';
484
487
  export type RAGRetrievalTraceStep = {
485
488
  stage: RAGRetrievalTraceStage;
486
489
  label: string;
@@ -495,6 +498,8 @@ export type RAGRetrievalTrace = {
495
498
  topK: number;
496
499
  candidateTopK: number;
497
500
  lexicalTopK: number;
501
+ maxResultsPerSource?: number;
502
+ sourceBalanceStrategy?: RAGSourceBalanceStrategy;
498
503
  mode: RAGHybridRetrievalMode;
499
504
  runVector: boolean;
500
505
  runLexical: boolean;
package/package.json CHANGED
@@ -228,12 +228,12 @@
228
228
  "main": "./dist/index.js",
229
229
  "name": "@absolutejs/absolute",
230
230
  "optionalDependencies": {
231
- "@absolutejs/native-darwin-arm64": "0.19.0-beta.551",
232
- "@absolutejs/native-darwin-x64": "0.19.0-beta.551",
233
- "@absolutejs/native-linux-arm64": "0.19.0-beta.551",
234
- "@absolutejs/native-linux-x64": "0.19.0-beta.551",
235
- "@absolutejs/native-windows-arm64": "0.19.0-beta.551",
236
- "@absolutejs/native-windows-x64": "0.19.0-beta.551"
231
+ "@absolutejs/native-darwin-arm64": "0.19.0-beta.553",
232
+ "@absolutejs/native-darwin-x64": "0.19.0-beta.553",
233
+ "@absolutejs/native-linux-arm64": "0.19.0-beta.553",
234
+ "@absolutejs/native-linux-x64": "0.19.0-beta.553",
235
+ "@absolutejs/native-windows-arm64": "0.19.0-beta.553",
236
+ "@absolutejs/native-windows-x64": "0.19.0-beta.553"
237
237
  },
238
238
  "overrides": {
239
239
  "@typescript-eslint/utils": "8.56.1"
@@ -314,5 +314,5 @@
314
314
  "typecheck": "bun run src/cli/index.ts typecheck --config example/absolute.config.ts"
315
315
  },
316
316
  "types": "./dist/src/index.d.ts",
317
- "version": "0.19.0-beta.551"
317
+ "version": "0.19.0-beta.553"
318
318
  }