@aiconnect/easy-rag 0.3.0 → 1.0.0

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.
Files changed (66) hide show
  1. package/README.md +100 -28
  2. package/dist/commands/init.d.ts.map +1 -1
  3. package/dist/commands/init.js +213 -66
  4. package/dist/commands/init.js.map +1 -1
  5. package/dist/config/types.d.ts +3 -0
  6. package/dist/config/types.d.ts.map +1 -1
  7. package/dist/eval/index.d.ts +10 -0
  8. package/dist/eval/index.d.ts.map +1 -0
  9. package/dist/eval/index.js +37 -0
  10. package/dist/eval/index.js.map +1 -0
  11. package/dist/eval/metrics.d.ts +12 -0
  12. package/dist/eval/metrics.d.ts.map +1 -0
  13. package/dist/eval/metrics.js +43 -0
  14. package/dist/eval/metrics.js.map +1 -0
  15. package/dist/eval/reporter.d.ts +7 -0
  16. package/dist/eval/reporter.d.ts.map +1 -0
  17. package/dist/eval/reporter.js +105 -0
  18. package/dist/eval/reporter.js.map +1 -0
  19. package/dist/eval/runner.d.ts +8 -0
  20. package/dist/eval/runner.d.ts.map +1 -0
  21. package/dist/eval/runner.js +43 -0
  22. package/dist/eval/runner.js.map +1 -0
  23. package/dist/eval/test-cases.d.ts +3 -0
  24. package/dist/eval/test-cases.d.ts.map +1 -0
  25. package/dist/eval/test-cases.js +98 -0
  26. package/dist/eval/test-cases.js.map +1 -0
  27. package/dist/eval/types.d.ts +49 -0
  28. package/dist/eval/types.d.ts.map +1 -0
  29. package/dist/eval/types.js +2 -0
  30. package/dist/eval/types.js.map +1 -0
  31. package/dist/index.js +10 -45
  32. package/dist/index.js.map +1 -1
  33. package/dist/indexer/orchestrator.d.ts.map +1 -1
  34. package/dist/indexer/orchestrator.js +24 -6
  35. package/dist/indexer/orchestrator.js.map +1 -1
  36. package/dist/query/hybrid.d.ts +17 -0
  37. package/dist/query/hybrid.d.ts.map +1 -0
  38. package/dist/query/hybrid.js +116 -0
  39. package/dist/query/hybrid.js.map +1 -0
  40. package/dist/query/index.d.ts.map +1 -1
  41. package/dist/query/index.js +81 -16
  42. package/dist/query/index.js.map +1 -1
  43. package/dist/query/search.d.ts +7 -4
  44. package/dist/query/search.d.ts.map +1 -1
  45. package/dist/query/search.js +45 -40
  46. package/dist/query/search.js.map +1 -1
  47. package/dist/query/types.d.ts +8 -0
  48. package/dist/query/types.d.ts.map +1 -1
  49. package/dist/vector-store/index.d.ts +3 -2
  50. package/dist/vector-store/index.d.ts.map +1 -1
  51. package/dist/vector-store/index.js +2 -2
  52. package/dist/vector-store/index.js.map +1 -1
  53. package/dist/vector-store/tokenizer.d.ts +3 -0
  54. package/dist/vector-store/tokenizer.d.ts.map +1 -0
  55. package/dist/vector-store/tokenizer.js +91 -0
  56. package/dist/vector-store/tokenizer.js.map +1 -0
  57. package/dist/vector-store/utils.d.ts +4 -1
  58. package/dist/vector-store/utils.d.ts.map +1 -1
  59. package/dist/vector-store/utils.js +17 -6
  60. package/dist/vector-store/utils.js.map +1 -1
  61. package/dist/vector-store/zvec.d.ts +15 -0
  62. package/dist/vector-store/zvec.d.ts.map +1 -0
  63. package/dist/vector-store/zvec.js +136 -0
  64. package/dist/vector-store/zvec.js.map +1 -0
  65. package/package.json +6 -5
  66. package/skills/easy-rag/SKILL.md +40 -9
@@ -2,7 +2,9 @@ import { scanFolder } from './scanner.js';
2
2
  import { parseDocument } from '../parsers/index.js';
3
3
  import { chunkDocument } from '../chunker/index.js';
4
4
  import { generateEmbeddings } from '../embeddings/index.js';
5
- import { getOrCreateCollection, storeEmbeddings, initializeChromaDB } from '../vector-store/index.js';
5
+ import { getOrCreateCollection, storeEmbeddings, ensureCollectionsDirectory } from '../vector-store/index.js';
6
+ import { generateSparseEmbedding } from '../vector-store/tokenizer.js';
7
+ import { getEmbeddingModel } from '../config/index.js';
6
8
  import path from 'path';
7
9
  import crypto from 'crypto';
8
10
  import fs from 'fs/promises';
@@ -25,7 +27,7 @@ export async function indexFolder(folderPath) {
25
27
  }
26
28
  const folderName = path.basename(folderPath);
27
29
  try {
28
- await initializeChromaDB();
30
+ ensureCollectionsDirectory();
29
31
  }
30
32
  catch (error) {
31
33
  stats.errors.push(error instanceof Error ? error.message : String(error));
@@ -35,9 +37,10 @@ export async function indexFolder(folderPath) {
35
37
  collectionName: '',
36
38
  };
37
39
  }
40
+ const embeddingModel = await getEmbeddingModel();
38
41
  let collection;
39
42
  try {
40
- collection = await getOrCreateCollection(folderName);
43
+ collection = getOrCreateCollection(folderName, embeddingModel);
41
44
  }
42
45
  catch (error) {
43
46
  stats.errors.push(error instanceof Error ? error.message : String(error));
@@ -47,9 +50,22 @@ export async function indexFolder(folderPath) {
47
50
  collectionName: '',
48
51
  };
49
52
  }
50
- const files = await scanFolder(folderPath);
53
+ let files;
54
+ try {
55
+ files = await scanFolder(folderPath);
56
+ }
57
+ catch (error) {
58
+ collection.closeSync();
59
+ stats.errors.push(error instanceof Error ? error.message : String(error));
60
+ return {
61
+ success: false,
62
+ stats,
63
+ collectionName: '',
64
+ };
65
+ }
51
66
  if (files.length === 0) {
52
67
  console.log('No supported files found in the folder.');
68
+ collection.closeSync();
53
69
  return {
54
70
  success: true,
55
71
  stats,
@@ -71,13 +87,14 @@ export async function indexFolder(folderPath) {
71
87
  }
72
88
  const texts = chunks.map((c) => c.content);
73
89
  const embeddings = await generateEmbeddings(texts);
74
- const vectorChunks = chunks.map((chunk, idx) => ({
90
+ const sparseChunks = chunks.map((chunk, idx) => ({
75
91
  id: crypto.createHash('md5').update(`${filePath}:${idx}`).digest('hex'),
76
92
  embedding: embeddings[idx],
93
+ sparseEmbedding: generateSparseEmbedding(chunk.content),
77
94
  metadata: chunk.metadata,
78
95
  content: chunk.content,
79
96
  }));
80
- await storeEmbeddings(collection, vectorChunks);
97
+ storeEmbeddings(collection, sparseChunks);
81
98
  stats.filesProcessed++;
82
99
  stats.chunksIndexed += chunks.length;
83
100
  console.log(` Indexed ${chunks.length} chunk(s)`);
@@ -89,6 +106,7 @@ export async function indexFolder(folderPath) {
89
106
  stats.filesSkipped++;
90
107
  }
91
108
  }
109
+ collection.closeSync();
92
110
  console.log(`\nIndexing complete!`);
93
111
  console.log(`Files processed: ${stats.filesProcessed}`);
94
112
  console.log(`Files skipped: ${stats.filesSkipped}`);
@@ -1 +1 @@
1
- {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/indexer/orchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,KAAK,GAAe;QACxB,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,kBAAkB,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC;IACf,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK;YACL,cAAc,EAAE,UAAU;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAExD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAsB,aAAa,CAAC,MAAM,CAAC,CAAC;YAExD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;gBAChE,KAAK,CAAC,YAAY,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAEnD,MAAM,YAAY,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9D,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBACvE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YAEJ,MAAM,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAEhD,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC,gCAAgC,QAAQ,KAAK,YAAY,EAAE,CAAC,CAAC;YAC1E,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,YAAY,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK;QACL,cAAc,EAAE,UAAU;KAC3B,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/indexer/orchestrator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { HybridQueryResult } from './types.js';
2
+ export type { HybridQueryResult } from './types.js';
3
+ export interface HybridSearchOptions {
4
+ top: number;
5
+ vectorWeight?: number;
6
+ bm25Weight?: number;
7
+ collection?: string;
8
+ }
9
+ /**
10
+ * Auto search: RRF fusion with equal weights (no configuration needed).
11
+ */
12
+ export declare function autoSearch(queryEmbedding: number[], queryText: string, options: Omit<HybridSearchOptions, 'vectorWeight' | 'bm25Weight'>): HybridQueryResult[];
13
+ /**
14
+ * Weighted search: RRF fusion with configurable weights.
15
+ */
16
+ export declare function weightedSearch(queryEmbedding: number[], queryText: string, options: HybridSearchOptions): HybridQueryResult[];
17
+ //# sourceMappingURL=hybrid.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/query/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,GAAG,YAAY,CAAC,GAChE,iBAAiB,EAAE,CAMrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAC3B,iBAAiB,EAAE,CAMrB"}
@@ -0,0 +1,116 @@
1
+ import { searchVectorStore, searchSparse, getCollection } from './search.js';
2
+ import { generateSparseEmbedding } from '../vector-store/tokenizer.js';
3
+ const RRF_K = 60;
4
+ /**
5
+ * Auto search: RRF fusion with equal weights (no configuration needed).
6
+ */
7
+ export function autoSearch(queryEmbedding, queryText, options) {
8
+ return fusionSearch(queryEmbedding, queryText, {
9
+ ...options,
10
+ vectorWeight: 0.5,
11
+ bm25Weight: 0.5,
12
+ });
13
+ }
14
+ /**
15
+ * Weighted search: RRF fusion with configurable weights.
16
+ */
17
+ export function weightedSearch(queryEmbedding, queryText, options) {
18
+ return fusionSearch(queryEmbedding, queryText, {
19
+ ...options,
20
+ vectorWeight: options.vectorWeight ?? 0.6,
21
+ bm25Weight: options.bm25Weight ?? 0.4,
22
+ });
23
+ }
24
+ /**
25
+ * Core fusion logic: runs dense + sparse queries and merges via RRF.
26
+ */
27
+ function fusionSearch(queryEmbedding, queryText, options) {
28
+ const { top, vectorWeight, bm25Weight } = options;
29
+ const fetchN = top * 2;
30
+ if (!options.collection) {
31
+ throw new Error('Collection name is required for hybrid search');
32
+ }
33
+ let vectorResults = [];
34
+ let sparseResults = [];
35
+ let vectorError = null;
36
+ let sparseError = null;
37
+ const collection = getCollection(options.collection);
38
+ try {
39
+ vectorResults = searchVectorStore(collection, queryEmbedding, fetchN);
40
+ }
41
+ catch (error) {
42
+ vectorError = error instanceof Error ? error : new Error(String(error));
43
+ }
44
+ try {
45
+ const sparseVector = generateSparseEmbedding(queryText);
46
+ sparseResults = searchSparse(collection, sparseVector, fetchN);
47
+ }
48
+ catch (error) {
49
+ sparseError = error instanceof Error ? error : new Error(String(error));
50
+ }
51
+ collection.closeSync();
52
+ if (vectorError && sparseError) {
53
+ throw vectorError;
54
+ }
55
+ if (vectorError) {
56
+ console.warn('Warning: Vector search failed, falling back to sparse-only');
57
+ return sparseResults.slice(0, top).map((r, idx) => ({
58
+ ...r,
59
+ hybridScore: r.similarity,
60
+ vectorScore: undefined,
61
+ bm25Score: r.similarity,
62
+ vectorRank: undefined,
63
+ bm25Rank: idx + 1,
64
+ }));
65
+ }
66
+ if (sparseError) {
67
+ console.warn('Warning: Sparse search failed, falling back to vector-only');
68
+ return vectorResults.slice(0, top).map((r, idx) => ({
69
+ ...r,
70
+ hybridScore: r.similarity,
71
+ vectorScore: r.similarity,
72
+ bm25Score: undefined,
73
+ vectorRank: idx + 1,
74
+ bm25Rank: undefined,
75
+ }));
76
+ }
77
+ const mergedResults = new Map();
78
+ for (let i = 0; i < vectorResults.length; i++) {
79
+ const result = vectorResults[i];
80
+ const key = `${result.metadata.sourcePath}:${result.metadata.chunkIndex}`;
81
+ const rrfScore = vectorWeight / (RRF_K + i + 1);
82
+ mergedResults.set(key, {
83
+ ...result,
84
+ hybridScore: rrfScore,
85
+ vectorScore: result.similarity,
86
+ bm25Score: undefined,
87
+ vectorRank: i + 1,
88
+ bm25Rank: undefined,
89
+ });
90
+ }
91
+ for (let i = 0; i < sparseResults.length; i++) {
92
+ const result = sparseResults[i];
93
+ const key = `${result.metadata.sourcePath}:${result.metadata.chunkIndex}`;
94
+ const rrfScore = bm25Weight / (RRF_K + i + 1);
95
+ const existing = mergedResults.get(key);
96
+ if (existing) {
97
+ existing.hybridScore += rrfScore;
98
+ existing.bm25Score = result.similarity;
99
+ existing.bm25Rank = i + 1;
100
+ }
101
+ else {
102
+ mergedResults.set(key, {
103
+ ...result,
104
+ hybridScore: rrfScore,
105
+ vectorScore: undefined,
106
+ bm25Score: result.similarity,
107
+ vectorRank: undefined,
108
+ bm25Rank: i + 1,
109
+ });
110
+ }
111
+ }
112
+ return Array.from(mergedResults.values())
113
+ .sort((a, b) => b.hybridScore - a.hybridScore)
114
+ .slice(0, top);
115
+ }
116
+ //# sourceMappingURL=hybrid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hybrid.js","sourceRoot":"","sources":["../../src/query/hybrid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAIvE,MAAM,KAAK,GAAG,EAAE,CAAC;AASjB;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,cAAwB,EACxB,SAAiB,EACjB,OAAiE;IAEjE,OAAO,YAAY,CAAC,cAAc,EAAE,SAAS,EAAE;QAC7C,GAAG,OAAO;QACV,YAAY,EAAE,GAAG;QACjB,UAAU,EAAE,GAAG;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,cAAwB,EACxB,SAAiB,EACjB,OAA4B;IAE5B,OAAO,YAAY,CAAC,cAAc,EAAE,SAAS,EAAE;QAC7C,GAAG,OAAO;QACV,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,GAAG;QACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;KACtC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,cAAwB,EACxB,SAAiB,EACjB,OAA6H;IAE7H,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IAEvB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,aAAa,GAAkB,EAAE,CAAC;IACtC,IAAI,aAAa,GAAkB,EAAE,CAAC;IACtC,IAAI,WAAW,GAAiB,IAAI,CAAC;IACrC,IAAI,WAAW,GAAiB,IAAI,CAAC;IAErC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,aAAa,GAAG,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACxD,aAAa,GAAG,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,UAAU,CAAC,SAAS,EAAE,CAAC;IAEvB,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,WAAW,CAAC;IACpB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC3E,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC;YACJ,WAAW,EAAE,CAAC,CAAC,UAAU;YACzB,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,GAAG,GAAG,CAAC;SAClB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC3E,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC;YACJ,WAAW,EAAE,CAAC,CAAC,UAAU;YACzB,WAAW,EAAE,CAAC,CAAC,UAAU;YACzB,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,GAAG,GAAG,CAAC;YACnB,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1E,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;YACrB,GAAG,MAAM;YACT,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,CAAC,GAAG,CAAC;YACjB,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1E,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC;YACjC,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;YACvC,QAAQ,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,GAAG,MAAM;gBACT,WAAW,EAAE,QAAQ;gBACrB,WAAW,EAAE,SAAS;gBACtB,SAAS,EAAE,MAAM,CAAC,UAAU;gBAC5B,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,CAAC,GAAG,CAAC;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;SAC7C,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAI5D,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEzF"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ5D,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmHzF"}
@@ -1,5 +1,8 @@
1
1
  import { generateQueryEmbedding } from './embedding.js';
2
- import { listAllCollections, getCollection, searchChromaDB } from './search.js';
2
+ import { listAllCollections, getCollection, searchVectorStore, searchSparse } from './search.js';
3
+ import { autoSearch, weightedSearch } from './hybrid.js';
4
+ import { generateSparseEmbedding } from '../vector-store/tokenizer.js';
5
+ import { loadConfig } from '../config/index.js';
3
6
  export async function executeQuery(question, options) {
4
7
  if (!process.env.OPENAI_API_KEY) {
5
8
  console.error('Error: OPENAI_API_KEY environment variable is required');
@@ -9,19 +12,56 @@ export async function executeQuery(question, options) {
9
12
  console.error(' OPENAI_API_KEY=your-api-key-here easy-rag query "<question>"');
10
13
  process.exit(1);
11
14
  }
12
- const queryEmbedding = await generateQueryEmbedding(question);
13
- const allResults = [];
15
+ const config = await loadConfig();
16
+ const mode = options.mode ?? config.search_mode ?? 'auto';
17
+ let allResults = [];
14
18
  if (options.collection) {
15
19
  try {
16
- const collection = await getCollection(options.collection);
17
- const results = await searchChromaDB(collection, queryEmbedding, options.top);
18
- allResults.push(...results);
20
+ if (mode === 'auto') {
21
+ const queryEmbedding = await generateQueryEmbedding(question);
22
+ const results = autoSearch(queryEmbedding, question, {
23
+ top: options.top,
24
+ collection: options.collection,
25
+ });
26
+ allResults = results;
27
+ }
28
+ else if (mode === 'hybrid') {
29
+ const queryEmbedding = await generateQueryEmbedding(question);
30
+ const results = weightedSearch(queryEmbedding, question, {
31
+ top: options.top,
32
+ collection: options.collection,
33
+ vectorWeight: config.vector_weight,
34
+ bm25Weight: config.bm25_weight,
35
+ });
36
+ allResults = results;
37
+ }
38
+ else if (mode === 'vector') {
39
+ const queryEmbedding = await generateQueryEmbedding(question);
40
+ const collection = getCollection(options.collection);
41
+ const results = searchVectorStore(collection, queryEmbedding, options.top);
42
+ collection.closeSync();
43
+ allResults = results;
44
+ }
45
+ else if (mode === 'bm25') {
46
+ const collection = getCollection(options.collection);
47
+ const sparseVector = generateSparseEmbedding(question);
48
+ const results = searchSparse(collection, sparseVector, options.top);
49
+ collection.closeSync();
50
+ allResults = results.map((r, idx) => ({
51
+ ...r,
52
+ hybridScore: r.similarity,
53
+ vectorScore: undefined,
54
+ bm25Score: r.similarity,
55
+ vectorRank: undefined,
56
+ bm25Rank: idx + 1,
57
+ }));
58
+ }
19
59
  }
20
60
  catch (error) {
21
61
  if (error instanceof Error && error.message.includes('Collection')) {
22
62
  console.error(`Error: Collection "${options.collection}" not found`);
23
63
  console.error('\nAvailable collections:');
24
- const collections = await listAllCollections();
64
+ const collections = listAllCollections();
25
65
  if (collections.length === 0) {
26
66
  console.error(' (no collections found)');
27
67
  }
@@ -34,34 +74,48 @@ export async function executeQuery(question, options) {
34
74
  }
35
75
  }
36
76
  else {
37
- const collectionNames = await listAllCollections();
77
+ const collectionNames = listAllCollections();
38
78
  if (collectionNames.length === 0) {
39
- console.error('Error: No collections found in ChromaDB');
79
+ console.error('Error: No collections found');
40
80
  console.error('\nPlease run "easy-rag index <folder>" to create a collection first.');
41
81
  process.exit(1);
42
82
  }
83
+ if (mode !== 'auto' && mode !== 'hybrid') {
84
+ console.error('Error: Searching across all collections is only supported in auto/hybrid mode');
85
+ console.error('Please specify a collection with the -c flag');
86
+ process.exit(1);
87
+ }
88
+ const queryEmbedding = await generateQueryEmbedding(question);
43
89
  for (const name of collectionNames) {
44
90
  try {
45
- const collection = await getCollection(name);
46
- const results = await searchChromaDB(collection, queryEmbedding, options.top);
91
+ const results = mode === 'auto'
92
+ ? autoSearch(queryEmbedding, question, { top: options.top, collection: name })
93
+ : weightedSearch(queryEmbedding, question, {
94
+ top: options.top,
95
+ collection: name,
96
+ vectorWeight: config.vector_weight,
97
+ bm25Weight: config.bm25_weight,
98
+ });
47
99
  allResults.push(...results);
48
100
  }
49
101
  catch (error) {
50
102
  console.error(`Warning: Failed to search collection "${name}": ${error instanceof Error ? error.message : String(error)}`);
51
103
  }
52
104
  }
105
+ if (allResults.length > 1) {
106
+ allResults.sort((a, b) => b.hybridScore - a.hybridScore);
107
+ allResults = allResults.slice(0, options.top);
108
+ }
53
109
  }
54
110
  if (allResults.length === 0) {
55
111
  console.log('No results found.');
56
112
  return;
57
113
  }
58
- allResults.sort((a, b) => b.similarity - a.similarity);
59
- const topResults = allResults.slice(0, options.top);
60
114
  if (options.includeMetadata) {
61
- displayResultsWithMetadata(topResults);
115
+ displayResultsWithMetadata(allResults);
62
116
  }
63
117
  else {
64
- displayResults(topResults);
118
+ displayResults(allResults);
65
119
  }
66
120
  }
67
121
  function displayResults(results) {
@@ -77,7 +131,18 @@ function displayResultsWithMetadata(results) {
77
131
  results.forEach((result, index) => {
78
132
  console.log(`--- Result ${index + 1} ---`);
79
133
  console.log(`Source: ${result.metadata.sourcePath}`);
80
- console.log(`Similarity: ${(result.similarity * 100).toFixed(1)}%`);
134
+ if (result.hybridScore !== undefined) {
135
+ console.log(`Hybrid Score: ${result.hybridScore.toFixed(4)}`);
136
+ }
137
+ if (result.vectorScore !== undefined) {
138
+ console.log(`Vector Score: ${result.vectorScore.toFixed(4)} (rank: ${result.vectorRank})`);
139
+ }
140
+ if (result.bm25Score !== undefined) {
141
+ console.log(`BM25 Score: ${result.bm25Score.toFixed(4)} (rank: ${result.bm25Rank})`);
142
+ }
143
+ if (result.similarity > 0) {
144
+ console.log(`Similarity: ${(result.similarity * 100).toFixed(1)}%`);
145
+ }
81
146
  console.log(`Chunk: ${result.metadata.chunkIndex}`);
82
147
  console.log(`\nContent:\n${result.content}`);
83
148
  console.log();
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,9 @@
1
- import { type Collection } from 'chromadb';
2
1
  import type { QueryResult } from './types.js';
3
- export declare function listAllCollections(): Promise<string[]>;
4
- export declare function getCollection(collectionName: string): Promise<Collection>;
5
- export declare function searchChromaDB(collection: Collection, queryEmbedding: number[], top: number): Promise<QueryResult[]>;
2
+ import { openCollection } from '../vector-store/index.js';
3
+ type ZVecCollection = ReturnType<typeof openCollection>;
4
+ export declare function listAllCollections(): string[];
5
+ export declare function getCollection(collectionName: string): ZVecCollection;
6
+ export declare function searchVectorStore(collection: ZVecCollection, queryEmbedding: number[], top: number): QueryResult[];
7
+ export declare function searchSparse(collection: ZVecCollection, sparseVector: Record<number, number>, top: number): QueryResult[];
8
+ export {};
6
9
  //# sourceMappingURL=search.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/query/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAG5D;AAED,wBAAsB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK/E;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,MAAM,EAAE,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,EAAE,CAAC,CAiCxB"}
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/query/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAmB,MAAM,0BAA0B,CAAC;AAE3E,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,CAEpE;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,cAAc,EAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,GAAG,EAAE,MAAM,GACV,WAAW,EAAE,CAqBf;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,cAAc,EAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,MAAM,GACV,WAAW,EAAE,CAqBf"}
@@ -1,45 +1,50 @@
1
- import { ChromaClient } from 'chromadb';
2
- const client = new ChromaClient({
3
- path: process.env.CHROMA_URL || 'http://localhost:8000',
4
- });
5
- export async function listAllCollections() {
6
- const collections = await client.listCollections();
7
- return collections.map((c) => String(c));
1
+ import { openCollection, listCollections } from '../vector-store/index.js';
2
+ export function listAllCollections() {
3
+ return listCollections().map((c) => c.name);
8
4
  }
9
- export async function getCollection(collectionName) {
10
- const sanitized = collectionName
11
- .replace(/[^a-zA-Z0-9_-]/g, '_')
12
- .toLowerCase();
13
- return await client.getCollection({ name: sanitized });
5
+ export function getCollection(collectionName) {
6
+ return openCollection(collectionName);
14
7
  }
15
- export async function searchChromaDB(collection, queryEmbedding, top) {
16
- const result = await collection.query({
17
- queryEmbeddings: [queryEmbedding],
18
- nResults: top,
8
+ export function searchVectorStore(collection, queryEmbedding, top) {
9
+ const results = collection.querySync({
10
+ fieldName: 'embedding',
11
+ vector: queryEmbedding,
12
+ topk: top,
13
+ outputFields: ['content', 'sourcePath', 'contentType', 'chunkIndex', 'sectionTitle', 'startPosition', 'endPosition', 'rowNumber'],
19
14
  });
20
- const queryResults = [];
21
- if (result.documents && result.documents[0]) {
22
- for (let i = 0; i < result.documents[0].length; i++) {
23
- const content = result.documents[0][i];
24
- const metadata = result.metadatas?.[0]?.[i];
25
- const distance = result.distances?.[0]?.[i];
26
- if (content && metadata) {
27
- queryResults.push({
28
- content,
29
- metadata: {
30
- sourcePath: String(metadata.sourcePath),
31
- contentType: String(metadata.contentType),
32
- chunkIndex: Number(metadata.chunkIndex),
33
- sectionTitle: metadata.sectionTitle !== undefined ? String(metadata.sectionTitle) : undefined,
34
- startPosition: metadata.startPosition !== undefined ? Number(metadata.startPosition) : undefined,
35
- endPosition: metadata.endPosition !== undefined ? Number(metadata.endPosition) : undefined,
36
- rowNumber: metadata.rowNumber !== undefined ? Number(metadata.rowNumber) : undefined,
37
- },
38
- similarity: distance !== undefined ? Math.max(0, 1 - distance) : 0,
39
- });
40
- }
41
- }
42
- }
43
- return queryResults;
15
+ return results.map((doc) => ({
16
+ content: String(doc.fields.content ?? ''),
17
+ metadata: {
18
+ sourcePath: String(doc.fields.sourcePath),
19
+ contentType: String(doc.fields.contentType),
20
+ chunkIndex: Number(doc.fields.chunkIndex),
21
+ sectionTitle: doc.fields.sectionTitle !== undefined ? String(doc.fields.sectionTitle) : undefined,
22
+ startPosition: doc.fields.startPosition !== undefined ? Number(doc.fields.startPosition) : undefined,
23
+ endPosition: doc.fields.endPosition !== undefined ? Number(doc.fields.endPosition) : undefined,
24
+ rowNumber: doc.fields.rowNumber !== undefined ? Number(doc.fields.rowNumber) : undefined,
25
+ },
26
+ similarity: doc.score,
27
+ }));
28
+ }
29
+ export function searchSparse(collection, sparseVector, top) {
30
+ const results = collection.querySync({
31
+ fieldName: 'sparse_embedding',
32
+ vector: sparseVector,
33
+ topk: top,
34
+ outputFields: ['content', 'sourcePath', 'contentType', 'chunkIndex', 'sectionTitle', 'startPosition', 'endPosition', 'rowNumber'],
35
+ });
36
+ return results.map((doc) => ({
37
+ content: String(doc.fields.content ?? ''),
38
+ metadata: {
39
+ sourcePath: String(doc.fields.sourcePath),
40
+ contentType: String(doc.fields.contentType),
41
+ chunkIndex: Number(doc.fields.chunkIndex),
42
+ sectionTitle: doc.fields.sectionTitle !== undefined ? String(doc.fields.sectionTitle) : undefined,
43
+ startPosition: doc.fields.startPosition !== undefined ? Number(doc.fields.startPosition) : undefined,
44
+ endPosition: doc.fields.endPosition !== undefined ? Number(doc.fields.endPosition) : undefined,
45
+ rowNumber: doc.fields.rowNumber !== undefined ? Number(doc.fields.rowNumber) : undefined,
46
+ },
47
+ similarity: doc.score,
48
+ }));
44
49
  }
45
50
  //# sourceMappingURL=search.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/query/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,UAAU,CAAC;AAGzD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,uBAAuB;CACxD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;IACnD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,cAAsB;IACxD,MAAM,SAAS,GAAG,cAAc;SAC7B,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,WAAW,EAAE,CAAC;IACjB,OAAO,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAsB,EACtB,cAAwB,EACxB,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC;QACpC,eAAe,EAAE,CAAC,cAAc,CAAC;QACjC,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,MAAM,YAAY,GAAkB,EAAE,CAAC;IAEvC,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAA4B,CAAC;YACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAE5C,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;gBACxB,YAAY,CAAC,IAAI,CAAC;oBAChB,OAAO;oBACP,QAAQ,EAAE;wBACR,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;wBACvC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;wBACzC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;wBACvC,YAAY,EAAE,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;wBAC7F,aAAa,EAAE,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;wBAChG,WAAW,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;wBAC1F,SAAS,EAAE,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;qBACrF;oBACD,UAAU,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;iBACnE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/query/search.ts"],"names":[],"mappings":"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"}
@@ -11,9 +11,17 @@ export interface QueryResult {
11
11
  };
12
12
  similarity: number;
13
13
  }
14
+ export interface HybridQueryResult extends QueryResult {
15
+ hybridScore: number;
16
+ vectorScore?: number;
17
+ bm25Score?: number;
18
+ vectorRank?: number;
19
+ bm25Rank?: number;
20
+ }
14
21
  export interface QueryOptions {
15
22
  top: number;
16
23
  includeMetadata: boolean;
17
24
  collection?: string;
25
+ mode?: 'auto' | 'hybrid' | 'vector' | 'bm25';
18
26
  }
19
27
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9C"}
@@ -1,4 +1,5 @@
1
- export { getOrCreateCollection, storeEmbeddings, initializeChromaDB, listCollections, deleteCollection } from './chromadb.js';
2
- export { ensureChromaDataDirectory } from './utils.js';
1
+ export { getOrCreateCollection, openCollection, storeEmbeddings, listCollections, deleteCollection, getDimensionForModel, } from './zvec.js';
2
+ export type { SparseChunk } from './zvec.js';
3
+ export { ensureCollectionsDirectory, getCollectionPath, sanitizeCollectionName } from './utils.js';
3
4
  export type { VectorChunk, CollectionInfo } from './types.js';
4
5
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector-store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9H,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector-store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
@@ -1,3 +1,3 @@
1
- export { getOrCreateCollection, storeEmbeddings, initializeChromaDB, listCollections, deleteCollection } from './chromadb.js';
2
- export { ensureChromaDataDirectory } from './utils.js';
1
+ export { getOrCreateCollection, openCollection, storeEmbeddings, listCollections, deleteCollection, getDimensionForModel, } from './zvec.js';
2
+ export { ensureCollectionsDirectory, getCollectionPath, sanitizeCollectionName } from './utils.js';
3
3
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector-store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9H,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vector-store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,3 @@
1
+ export declare function tokenize(text: string): string[];
2
+ export declare function generateSparseEmbedding(text: string): Record<number, number>;
3
+ //# sourceMappingURL=tokenizer.d.ts.map