mem0ai 2.4.6 → 3.0.0-beta.1

package/dist/oss/index.d.ts

@@ -46,17 +46,6 @@ interface LLMConfig {
     model?: string | any;
     modelProperties?: Record<string, any>;
 }
-interface Neo4jConfig {
-    url: string;
-    username: string;
-    password: string;
-}
-interface GraphStoreConfig {
-    provider: string;
-    config: Neo4jConfig;
-    llm?: LLMConfig;
-    customPrompt?: string;
-}
 interface MemoryConfig {
     version?: string;
     embedder: {
@@ -74,9 +63,7 @@ interface MemoryConfig {
     historyStore?: HistoryStoreConfig;
     disableHistory?: boolean;
     historyDbPath?: string;
-    customPrompt?: string;
-    graphStore?: GraphStoreConfig;
-    enableGraph?: boolean;
+    customInstructions?: string;
 }
 interface MemoryItem {
     id: string;
@@ -88,14 +75,13 @@ interface MemoryItem {
     metadata?: Record<string, any>;
 }
 interface SearchFilters {
-    userId?: string;
-    agentId?: string;
-    runId?: string;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
     [key: string]: any;
 }
 interface SearchResult {
     results: MemoryItem[];
-    relations?: any[];
 }
 interface VectorStoreResult {
     id: string;
@@ -229,59 +215,7 @@ declare const MemoryConfigSchema: z.ZodObject<{
         };
     }>;
     historyDbPath: z.ZodOptional<z.ZodString>;
-    customPrompt: z.ZodOptional<z.ZodString>;
-    enableGraph: z.ZodOptional<z.ZodBoolean>;
-    graphStore: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
-        config: z.ZodObject<{
-            url: z.ZodString;
-            username: z.ZodString;
-            password: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            url: string;
-            username: string;
-            password: string;
-        }, {
-            url: string;
-            username: string;
-            password: string;
-        }>;
-        llm: z.ZodOptional<z.ZodObject<{
-            provider: z.ZodString;
-            config: z.ZodRecord<z.ZodString, z.ZodAny>;
-        }, "strip", z.ZodTypeAny, {
-            provider: string;
-            config: Record<string, any>;
-        }, {
-            provider: string;
-            config: Record<string, any>;
-        }>>;
-        customPrompt: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        provider: string;
-        config: {
-            url: string;
-            username: string;
-            password: string;
-        };
-        llm?: {
-            provider: string;
-            config: Record<string, any>;
-        } | undefined;
-        customPrompt?: string | undefined;
-    }, {
-        provider: string;
-        config: {
-            url: string;
-            username: string;
-            password: string;
-        };
-        llm?: {
-            provider: string;
-            config: Record<string, any>;
-        } | undefined;
-        customPrompt?: string | undefined;
-    }>>;
+    customInstructions: z.ZodOptional<z.ZodString>;
     historyStore: z.ZodOptional<z.ZodObject<{
         provider: z.ZodString;
         config: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -328,21 +262,7 @@ declare const MemoryConfigSchema: z.ZodObject<{
     };
     version?: string | undefined;
     historyDbPath?: string | undefined;
-    customPrompt?: string | undefined;
-    enableGraph?: boolean | undefined;
-    graphStore?: {
-        provider: string;
-        config: {
-            url: string;
-            username: string;
-            password: string;
-        };
-        llm?: {
-            provider: string;
-            config: Record<string, any>;
-        } | undefined;
-        customPrompt?: string | undefined;
-    } | undefined;
+    customInstructions?: string | undefined;
     historyStore?: {
         provider: string;
         config: Record<string, any>;
@@ -383,21 +303,7 @@ declare const MemoryConfigSchema: z.ZodObject<{
     };
     version?: string | undefined;
     historyDbPath?: string | undefined;
-    customPrompt?: string | undefined;
-    enableGraph?: boolean | undefined;
-    graphStore?: {
-        provider: string;
-        config: {
-            url: string;
-            username: string;
-            password: string;
-        };
-        llm?: {
-            provider: string;
-            config: Record<string, any>;
-        } | undefined;
-        customPrompt?: string | undefined;
-    } | undefined;
+    customInstructions?: string | undefined;
     historyStore?: {
         provider: string;
         config: Record<string, any>;
@@ -415,30 +321,31 @@ interface AddMemoryOptions extends Entity {
     filters?: SearchFilters;
     infer?: boolean;
 }
-interface SearchMemoryOptions extends Entity {
-    limit?: number;
+interface SearchMemoryOptions {
+    topK?: number;
     filters?: SearchFilters;
+    threshold?: number;
 }
-interface GetAllMemoryOptions extends Entity {
-    limit?: number;
+interface GetAllMemoryOptions {
+    topK?: number;
+    filters?: SearchFilters;
 }
 interface DeleteAllMemoryOptions extends Entity {
 }
 
 declare class Memory {
     private config;
-    private customPrompt;
+    private customInstructions;
     private embedder;
     private vectorStore;
     private llm;
     private db;
     private collectionName;
     private apiVersion;
-    private graphMemory?;
-    private enableGraph;
     telemetryId: string;
     private _initPromise;
     private _initError?;
+    private _entityStore?;
     constructor(config?: Partial<MemoryConfig>);
     /**
      * If no explicit dimension was provided, runs a probe embedding to
@@ -451,6 +358,8 @@ declare class Memory {
      * If a previous init attempt failed, retries automatically.
      */
     private _ensureInitialized;
+    private getEntityStore;
+    private buildSessionScope;
     private _initializeTelemetry;
     private _getTelemetryId;
     private _captureEvent;
@@ -474,6 +383,15 @@ declare class Memory {
     private createMemory;
     private updateMemory;
     private deleteMemory;
+    /**
+     * Check if filters contain advanced operators that need special processing.
+     */
+    private _hasAdvancedOperators;
+    /**
+     * Process enhanced metadata filters and convert them to vector store compatible format.
+     * Converts AND/OR/NOT to $or/$not format that vector stores can interpret.
+     */
+    private _processMetadataFilters;
 }
 
 interface Embedder {
@@ -647,12 +565,13 @@ declare class LangchainLLM implements LLM {
 
 interface VectorStore {
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch?(query: string, topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[] | null>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
     initialize(): Promise<void>;
@@ -665,14 +584,25 @@ declare class MemoryVectorStore implements VectorStore {
     constructor(config: VectorStoreConfig);
     private init;
     private cosineSimilarity;
+    /**
+     * Check if a single field condition matches the payload.
+     * Supports comparison operators: eq, ne, gt, gte, lt, lte, in, nin, contains, icontains
+     */
+    private matchFieldCondition;
+    /**
+     * Filter a vector by the given filters.
+     * Supports logical operators (AND, OR, NOT) and comparison operators.
+     */
     private filterVector;
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    private tokenize;
+    keywordSearch(query: string, topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[] | null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
     initialize(): Promise<void>;
@@ -710,14 +640,24 @@ declare class Qdrant implements VectorStore {
     private dimension;
     private _initPromise?;
     constructor(config: QdrantConfig);
+    /**
+     * Build a single field condition from a key-value filter pair.
+     * Supports enhanced filter syntax with comparison operators.
+     */
+    private buildFieldCondition;
+    /**
+     * Create a Filter object from the provided filters.
+     * Supports logical operators (AND, OR, NOT) and comparison operators.
+     */
     private createFilter;
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(): Promise<null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     private generateUUID;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
@@ -744,12 +684,13 @@ declare class RedisDB implements VectorStore {
     initialize(): Promise<void>;
     private _doInitialize;
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(): Promise<null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     close(): Promise<void>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
@@ -772,12 +713,13 @@ declare class SupabaseDB implements VectorStore {
     initialize(): Promise<void>;
     private _doInitialize;
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(): Promise<null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
 }
@@ -791,11 +733,12 @@ declare class LangchainVectorStore implements VectorStore {
     private storeUserId;
     constructor(config: LangchainStoreConfig);
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(): Promise<null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     deleteCol(): Promise<void>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
@@ -815,12 +758,13 @@ declare class VectorizeDB implements VectorStore {
     private _initPromise?;
     constructor(config: VectorizeConfig);
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(): Promise<null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     private generateUUID;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
@@ -916,10 +860,14 @@ declare class AzureAISearch implements VectorStore {
      * Handles cases where payload might have extra text
      */
     private extractJson;
+    /**
+     * Keyword search using Azure AI Search native full-text (BM25) capabilities
+     */
+    keywordSearch(query: string, topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[] | null>;
     /**
      * Search for similar vectors
      */
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     /**
      * Delete a vector by ID
      */
@@ -947,7 +895,7 @@ declare class AzureAISearch implements VectorStore {
     /**
      * List all vectors in the index
      */
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     /**
      * Generate a random user ID
      */
@@ -991,13 +939,14 @@ declare class PGVector implements VectorStore {
     private createDatabase;
     private createCol;
     insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
-    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
+    keywordSearch(query: string, topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[] | null>;
+    search(query: number[], topK?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
     get(vectorId: string): Promise<VectorStoreResult | null>;
     update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
     delete(vectorId: string): Promise<void>;
     deleteCol(): Promise<void>;
     private listCols;
-    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
+    list(filters?: SearchFilters, topK?: number): Promise<[VectorStoreResult[], number]>;
     close(): Promise<void>;
     getUserId(): Promise<string>;
     setUserId(userId: string): Promise<void>;
@@ -1008,6 +957,26 @@ interface HistoryManager {
     getHistory(memoryId: string): Promise<any[]>;
     reset(): Promise<void>;
     close(): void;
+    saveMessages?(messages: Array<{
+        role: string;
+        content: string;
+        name?: string;
+    }>, sessionScope: string): Promise<void>;
+    getLastMessages?(sessionScope: string, limit?: number): Promise<Array<{
+        role: string;
+        content: string;
+        name?: string;
+        createdAt: string;
+    }>>;
+    batchAddHistory?(records: Array<{
+        memoryId: string;
+        previousValue: string | null;
+        newValue: string | null;
+        action: string;
+        createdAt?: string;
+        updatedAt?: string;
+        isDeleted?: number;
+    }>): Promise<void>;
 }
 
 declare class EmbedderFactory {
@@ -1023,4 +992,4 @@ declare class HistoryManagerFactory {
     static create(provider: string, config: HistoryStoreConfig): HistoryManager;
 }
 
-export { type AddMemoryOptions, AnthropicLLM, AzureAISearch, AzureOpenAIEmbedder, type DeleteAllMemoryOptions, type Embedder, EmbedderFactory, type EmbeddingConfig, type Entity, type GetAllMemoryOptions, GoogleEmbedder, GoogleLLM, type GraphStoreConfig, GroqLLM, HistoryManagerFactory, type HistoryStoreConfig, type LLM, type LLMConfig, LLMFactory, type LLMResponse, LMStudioEmbedder, LMStudioLLM, LangchainEmbedder, LangchainLLM, LangchainVectorStore, Memory, type MemoryConfig, MemoryConfigSchema, type MemoryItem, MemoryVectorStore, type Message, MistralLLM, type MultiModalMessages, type Neo4jConfig, OllamaEmbedder, OllamaLLM, OpenAIEmbedder, OpenAILLM, OpenAIStructuredLLM, PGVector, Qdrant, RedisDB, type SearchFilters, type SearchMemoryOptions, type SearchResult, SupabaseDB, type VectorStore, type VectorStoreConfig, VectorStoreFactory, type VectorStoreResult, VectorizeDB };
+export { type AddMemoryOptions, AnthropicLLM, AzureAISearch, AzureOpenAIEmbedder, type DeleteAllMemoryOptions, type Embedder, EmbedderFactory, type EmbeddingConfig, type Entity, type GetAllMemoryOptions, GoogleEmbedder, GoogleLLM, GroqLLM, HistoryManagerFactory, type HistoryStoreConfig, type LLM, type LLMConfig, LLMFactory, type LLMResponse, LMStudioEmbedder, LMStudioLLM, LangchainEmbedder, LangchainLLM, LangchainVectorStore, Memory, type MemoryConfig, MemoryConfigSchema, type MemoryItem, MemoryVectorStore, type Message, MistralLLM, type MultiModalMessages, OllamaEmbedder, OllamaLLM, OpenAIEmbedder, OpenAILLM, OpenAIStructuredLLM, PGVector, Qdrant, RedisDB, type SearchFilters, type SearchMemoryOptions, type SearchResult, SupabaseDB, type VectorStore, type VectorStoreConfig, VectorStoreFactory, type VectorStoreResult, VectorizeDB };