@traqr/memory 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  */
 export { createMemoryServer } from './server.js';
 export { getVectorDB, resetVectorDB } from './vectordb/index.js';
-export type { VectorDBProvider, Memory, MemoryInput, MemorySearchResult, MemoryUpdate, MemoryExport, MemoryDomain, SearchOptions, MemoryCategory, MemorySourceType, MemoryDurability, MemoryType, BM25SearchResult, TemporalSearchResult, GraphSearchResult, ProviderConfig, } from './vectordb/types.js';
+export type { VectorDBProvider, Memory, MemoryInput, MemorySearchResult, MemoryUpdate, MemoryExport, MemoryDomain, SearchOptions, MemoryCategory, MemorySourceType, MemoryDurability, MemoryType, BM25SearchResult, TemporalSearchResult, GraphSearchResult, BrowseResult, ProviderConfig, } from './vectordb/types.js';
 export { BOOTSTRAP_CONFIDENCE, DECAY_CONFIG } from './vectordb/types.js';
 export { deriveAll, deriveDomain, deriveCategory, deriveTopic, deriveSummary, deriveTags, deriveMemoryType, deriveForgetAfter, extractEntityCandidates, } from './lib/auto-derive.js';
 export type { DeriveResult, EntityCandidate } from './lib/auto-derive.js';
@@ -22,10 +22,10 @@ export type { EntityExtractionResult } from './lib/entity-pipeline.js';
 export type { StoreWithDedupResult, TriageResult, TriageZone, TriageAction, TriageOptions, RoundTripResult, DetailedStats, SystemHealth, } from './lib/memory.js';
 export { searchMemoriesV2, reciprocalRankFusion, detectStrategies, parseTemporalRange, findEntitiesInQuery, } from './lib/retrieval.js';
 export type { SearchV2Options, SearchStrategy, FusedItem, StrategyResult, DetectedStrategies, } from './lib/retrieval.js';
-export { generateEmbedding, generateEmbeddingsBatch, cosineSimilarity, formatEmbeddingForPgVector, parseEmbeddingFromPgVector, needsReembedding, checkEmbeddingHealth, EMBEDDING_CONFIG, } from './lib/embeddings.js';
-export type { EmbeddingResult, EmbeddingHealthStatus } from './lib/embeddings.js';
+export { generateEmbedding, generateEmbeddingsBatch, cosineSimilarity, formatEmbeddingForPgVector, parseEmbeddingFromPgVector, needsReembedding, checkEmbeddingHealth, EMBEDDING_CONFIG, getEmbeddingProvider, getEmbeddingConfig, resetEmbeddingProvider, } from './lib/embeddings.js';
+export type { EmbeddingResult, EmbeddingHealthStatus, EmbeddingProvider } from './lib/embeddings.js';
 export { CATEGORY_EMOJI, CATEGORY_EMOJI_SLACK, CATEGORY_EMOJI_TEXT, SOURCE_TYPE_EMOJI, getCategoryEmoji, } from './lib/formatting.js';
-export { getMemoryClient, resetMemoryClient, getUserId, getProjectId, configureMemory, getTableName } from './lib/client.js';
+export { getMemoryClient, resetMemoryClient, getUserId, getProjectId, configureMemory, getTableName, getMemoryConfig } from './lib/client.js';
 export type { MemoryClientConfig } from './lib/client.js';
 export { verifyAuth, requireAuth, getInternalSecret } from './lib/auth.js';
 export { assembleSessionContext } from './lib/context.js';

package/dist/index.js

@@ -24,11 +24,11 @@ export { processEntitiesForMemory } from './lib/entity-pipeline.js';
 // Multi-strategy retrieval (v2)
 export { searchMemoriesV2, reciprocalRankFusion, detectStrategies, parseTemporalRange, findEntitiesInQuery, } from './lib/retrieval.js';
 // Embeddings
-export { generateEmbedding, generateEmbeddingsBatch, cosineSimilarity, formatEmbeddingForPgVector, parseEmbeddingFromPgVector, needsReembedding, checkEmbeddingHealth, EMBEDDING_CONFIG, } from './lib/embeddings.js';
+export { generateEmbedding, generateEmbeddingsBatch, cosineSimilarity, formatEmbeddingForPgVector, parseEmbeddingFromPgVector, needsReembedding, checkEmbeddingHealth, EMBEDDING_CONFIG, getEmbeddingProvider, getEmbeddingConfig, resetEmbeddingProvider, } from './lib/embeddings.js';
 // Formatting
 export { CATEGORY_EMOJI, CATEGORY_EMOJI_SLACK, CATEGORY_EMOJI_TEXT, SOURCE_TYPE_EMOJI, getCategoryEmoji, } from './lib/formatting.js';
 // Client configuration
-export { getMemoryClient, resetMemoryClient, getUserId, getProjectId, configureMemory, getTableName } from './lib/client.js';
+export { getMemoryClient, resetMemoryClient, getUserId, getProjectId, configureMemory, getTableName, getMemoryConfig } from './lib/client.js';
 // Auth middleware
 export { verifyAuth, requireAuth, getInternalSecret } from './lib/auth.js';
 // Context assembly

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAmBhE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAExE,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAG7B,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAGxD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,+BAA+B;AAC/B,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAG3B,6BAA6B;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAcnE,gCAAgC;AAChC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAS3B,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAG5B,aAAa;AACb,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAE5B,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG5H,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAE1E,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAoBhE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAExE,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAG7B,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAGxD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,+BAA+B;AAC/B,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,sBAAsB;AACtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAG3B,6BAA6B;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAcnE,gCAAgC;AAChC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAS3B,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAG5B,aAAa;AACb,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAE5B,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAG7I,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAE1E,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,6BAA6B,CAAA"}

package/dist/lib/client.d.ts

@@ -9,6 +9,7 @@ import { SupabaseClient } from '@supabase/supabase-js';
 export interface MemoryClientConfig {
     supabaseUrl?: string;
     supabaseKey?: string;
+    databaseUrl?: string;
     userId?: string;
     projectId?: string;
     tableName?: string;
@@ -21,8 +22,13 @@ export declare function getProjectId(): string;
 /**
  * Configure the memory system in one shot.
  * Resets the singleton so next getMemoryClient() uses the new config.
+ * For raw Postgres (DATABASE_URL), pass databaseUrl instead of supabaseUrl.
  */
 export declare function configureMemory(config: MemoryClientConfig): void;
 export declare function getTableName(): string;
+/** Get the stored memory config (used by VectorDB factory for provider auto-detection) */
+export declare function getMemoryConfig(): MemoryClientConfig & {
+    databaseUrl?: string;
+};
 /** Reset singleton (for testing) */
 export declare function resetMemoryClient(): void;

package/dist/lib/client.js

@@ -13,6 +13,7 @@ export const DEFAULT_PROJECT_ID = 'b0000000-0000-0000-0000-000000000001';
 let _userId = DEFAULT_USER_ID;
 let _projectId = DEFAULT_PROJECT_ID;
 let _tableName = 'traqr_memories';
+let _databaseUrl;
 export function getMemoryClient(config) {
     if (clientInstance)
         return clientInstance;
@@ -43,18 +44,39 @@ export function getProjectId() {
 /**
  * Configure the memory system in one shot.
  * Resets the singleton so next getMemoryClient() uses the new config.
+ * For raw Postgres (DATABASE_URL), pass databaseUrl instead of supabaseUrl.
  */
 export function configureMemory(config) {
     clientInstance = null;
     if (config.tableName)
         _tableName = config.tableName;
-    getMemoryClient(config);
+    if (config.userId)
+        _userId = config.userId;
+    if (config.projectId)
+        _projectId = config.projectId;
+    _databaseUrl = config.databaseUrl;
+    // Only initialize Supabase client if supabaseUrl is provided
+    if (config.supabaseUrl && config.supabaseKey) {
+        getMemoryClient(config);
+    }
 }
 export function getTableName() {
     return _tableName;
 }
+/** Get the stored memory config (used by VectorDB factory for provider auto-detection) */
+export function getMemoryConfig() {
+    return {
+        supabaseUrl: process.env.SUPABASE_URL || process.env.TRAQR_SUPABASE_URL,
+        supabaseKey: process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.TRAQR_SUPABASE_SERVICE_ROLE_KEY,
+        databaseUrl: _databaseUrl || process.env.DATABASE_URL,
+        userId: _userId,
+        projectId: _projectId,
+        tableName: _tableName,
+    };
+}
 /** Reset singleton (for testing) */
 export function resetMemoryClient() {
     clientInstance = null;
+    _databaseUrl = undefined;
 }
 //# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAEpE,IAAI,cAAc,GAA0B,IAAI,CAAA;AAUhD,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAA;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAA;AAExE,IAAI,OAAO,GAAG,eAAe,CAAA;AAC7B,IAAI,UAAU,GAAG,kBAAkB,CAAA;AACnC,IAAI,UAAU,GAAG,gBAAgB,CAAA;AAEjC,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IAEzC,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC7F,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAA;IAEvH,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,2DAA2D;YAC3D,uEAAuE,CACxE,CAAA;IACH,CAAC;IAED,IAAI,MAAM,EAAE,MAAM;QAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAA;IAC3C,IAAI,MAAM,EAAE,SAAS;QAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAA;IAEpD,cAAc,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;QACtC,IAAI,EAAE;YACJ,gBAAgB,EAAE,KAAK;YACvB,cAAc,EAAE,KAAK;SACtB;KACF,CAAC,CAAA;IAEF,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,cAAc,GAAG,IAAI,CAAA;IACrB,IAAI,MAAM,CAAC,SAAS;QAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAA;IACnD,eAAe,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,iBAAiB;IAC/B,cAAc,GAAG,IAAI,CAAA;AACvB,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAEpE,IAAI,cAAc,GAA0B,IAAI,CAAA;AAWhD,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAA;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAA;AAExE,IAAI,OAAO,GAAG,eAAe,CAAA;AAC7B,IAAI,UAAU,GAAG,kBAAkB,CAAA;AACnC,IAAI,UAAU,GAAG,gBAAgB,CAAA;AACjC,IAAI,YAAgC,CAAA;AAEpC,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IAEzC,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC7F,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAA;IAEvH,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,2DAA2D;YAC3D,uEAAuE,CACxE,CAAA;IACH,CAAC;IAED,IAAI,MAAM,EAAE,MAAM;QAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAA;IAC3C,IAAI,MAAM,EAAE,SAAS;QAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAA;IAEpD,cAAc,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;QACtC,IAAI,EAAE;YACJ,gBAAgB,EAAE,KAAK;YACvB,cAAc,EAAE,KAAK;SACtB;KACF,CAAC,CAAA;IAEF,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,cAAc,GAAG,IAAI,CAAA;IACrB,IAAI,MAAM,CAAC,SAAS;QAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAA;IACnD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAA;IAC1C,IAAI,MAAM,CAAC,SAAS;QAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAA;IACnD,YAAY,GAAG,MAAM,CAAC,WAAW,CAAA;IACjC,6DAA6D;IAC7D,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC7C,eAAe,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QACvE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B;QACjG,WAAW,EAAE,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;QACrD,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,UAAU;KACtB,CAAA;AACH,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,iBAAiB;IAC/B,cAAc,GAAG,IAAI,CAAA;IACrB,YAAY,GAAG,SAAS,CAAA;AAC1B,CAAC"}

package/dist/lib/embeddings.d.ts

@@ -1,17 +1,16 @@
 /**
- * Embeddings Utility
+ * Embeddings Provider System
  *
- * Generates vector embeddings using configurable provider.
- * Supports OpenAI text-embedding-3-small and Google Gemini Embedding 2.
- * Set EMBEDDING_PROVIDER env var: 'openai' (default) or 'gemini'.
+ * Provider-agnostic embedding generation. Supports:
+ * - OpenAI (text-embedding-3-small)
+ * - Gemini (gemini-embedding-001)
+ * - Amazon Bedrock (Nova Embeddings, Titan, etc.)
+ * - Ollama (local models)
+ * - None (BM25-only keyword search, no embeddings)
+ *
+ * Set EMBEDDING_PROVIDER env var: 'openai', 'gemini', 'bedrock', 'ollama', 'none'
+ * If not set, auto-detects from available API keys.
  */
-export declare const EMBEDDING_CONFIG: {
-    readonly MODEL: "gemini-embedding-001" | "text-embedding-3-small";
-    readonly MODEL_VERSION: "v1";
-    readonly DIMENSIONS: 1536;
-    readonly PROVIDER: string;
-    readonly MAX_TOKENS: 8191;
-};
 export interface EmbeddingResult {
     embedding: number[];
     model: string;
@@ -22,8 +21,37 @@ export interface EmbeddingResult {
         totalTokens: number;
     };
 }
+export interface EmbeddingProvider {
+    generate(text: string): Promise<EmbeddingResult>;
+    generateBatch(texts: string[]): Promise<EmbeddingResult[]>;
+    readonly dimensions: number;
+    readonly model: string;
+    readonly provider: string;
+}
+/**
+ * Get the configured embedding provider.
+ * Auto-detects from EMBEDDING_PROVIDER env var, or falls back to API key detection.
+ */
+export declare function getEmbeddingProvider(): EmbeddingProvider;
+/** Reset singleton (for testing or reconfiguration) */
+export declare function resetEmbeddingProvider(): void;
+/** Dynamic config based on active provider */
+export declare function getEmbeddingConfig(): {
+    MODEL: string;
+    MODEL_VERSION: string;
+    DIMENSIONS: number;
+    PROVIDER: string;
+    MAX_TOKENS: number;
+};
+export declare const EMBEDDING_CONFIG: {
+    readonly MODEL: string;
+    readonly MODEL_VERSION: "v1";
+    readonly DIMENSIONS: number;
+    readonly PROVIDER: string;
+    readonly MAX_TOKENS: 8191;
+};
 /**
- * Generate embedding for a single text (provider-agnostic)
+ * Generate embedding for a single text (backward-compatible entry point)
  */
 export declare function generateEmbedding(text: string): Promise<EmbeddingResult>;
 /**