@t1nky/mem0-ts/dist/oss/index.d.ts

The Memory Layer For Your AI Apps

import { z } from 'zod';
import { QdrantClient } from '@qdrant/js-client-rest';
import { VectorStore as VectorStore$1 } from '@langchain/core/vectorstores';
import { Pool } from 'pg';

interface MultiModalMessages {
    type: "image_url";
    image_url: {
        url: string;
    };
}
interface Message {
    role: string;
    content: string | MultiModalMessages;
}
interface EmbeddingConfig {
    apiKey?: string;
    model?: string | any;
    url?: string;
    embeddingDims?: number;
    modelProperties?: Record<string, any>;
}
interface VectorStoreConfig {
    collectionName?: string;
    dimension?: number;
    client?: any;
    instance?: any;
    [key: string]: any;
}
interface HistoryStoreConfig {
    provider: string;
    config: {
        historyDbPath?: string;
        supabaseUrl?: string;
        supabaseKey?: string;
        tableName?: string;
    };
}
interface LLMConfig {
    provider?: string;
    baseURL?: string;
    config?: Record<string, any>;
    apiKey?: string;
    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: {
        provider: string;
        config: EmbeddingConfig;
    };
    vectorStore: {
        provider: string;
        config: VectorStoreConfig;
    };
    llm: {
        provider: string;
        config: LLMConfig;
    };
    historyStore?: HistoryStoreConfig;
    disableHistory?: boolean;
    historyDbPath?: string;
    customPrompt?: string;
    graphStore?: GraphStoreConfig;
    enableGraph?: boolean;
}
interface MemoryItem {
    id: string;
    memory: string;
    hash?: string;
    createdAt?: string;
    updatedAt?: string;
    score?: number;
    metadata?: Record<string, any>;
}
interface SearchFilters {
    userId?: string;
    agentId?: string;
    runId?: string;
    [key: string]: any;
}
interface SearchResult {
    results: MemoryItem[];
    relations?: any[];
}
interface VectorStoreResult {
    id: string;
    payload: Record<string, any>;
    score?: number;
}
declare const MemoryConfigSchema: z.ZodObject<{
    version: z.ZodOptional<z.ZodString>;
    embedder: z.ZodObject<{
        provider: z.ZodString;
        config: z.ZodObject<{
            modelProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
            apiKey: z.ZodOptional<z.ZodString>;
            model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodAny]>>;
            baseURL: z.ZodOptional<z.ZodString>;
            embeddingDims: z.ZodOptional<z.ZodNumber>;
            url: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        }, {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        }>;
    }, "strip", z.ZodTypeAny, {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        };
    }, {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        };
    }>;
    vectorStore: z.ZodObject<{
        provider: z.ZodString;
        config: z.ZodObject<{
            collectionName: z.ZodOptional<z.ZodString>;
            dimension: z.ZodOptional<z.ZodNumber>;
            client: z.ZodOptional<z.ZodAny>;
        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
            collectionName: z.ZodOptional<z.ZodString>;
            dimension: z.ZodOptional<z.ZodNumber>;
            client: z.ZodOptional<z.ZodAny>;
        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
            collectionName: z.ZodOptional<z.ZodString>;
            dimension: z.ZodOptional<z.ZodNumber>;
            client: z.ZodOptional<z.ZodAny>;
        }, z.ZodTypeAny, "passthrough">>;
    }, "strip", z.ZodTypeAny, {
        provider: string;
        config: {
            collectionName?: string | undefined;
            dimension?: number | undefined;
            client?: any;
        } & {
            [k: string]: unknown;
        };
    }, {
        provider: string;
        config: {
            collectionName?: string | undefined;
            dimension?: number | undefined;
            client?: any;
        } & {
            [k: string]: unknown;
        };
    }>;
    llm: z.ZodObject<{
        provider: z.ZodString;
        config: z.ZodObject<{
            apiKey: z.ZodOptional<z.ZodString>;
            model: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodAny]>>;
            modelProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
            baseURL: z.ZodOptional<z.ZodString>;
        }, "strip", z.ZodTypeAny, {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        }, {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        }>;
    }, "strip", z.ZodTypeAny, {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        };
    }, {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        };
    }>;
    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;
    }>>;
    historyStore: 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>;
    }>>;
    disableHistory: z.ZodOptional<z.ZodBoolean>;
}, "strip", z.ZodTypeAny, {
    embedder: {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        };
    };
    vectorStore: {
        provider: string;
        config: {
            collectionName?: string | undefined;
            dimension?: number | undefined;
            client?: any;
        } & {
            [k: string]: unknown;
        };
    };
    llm: {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        };
    };
    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;
    historyStore?: {
        provider: string;
        config: Record<string, any>;
    } | undefined;
    disableHistory?: boolean | undefined;
}, {
    embedder: {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
            embeddingDims?: number | undefined;
            url?: string | undefined;
        };
    };
    vectorStore: {
        provider: string;
        config: {
            collectionName?: string | undefined;
            dimension?: number | undefined;
            client?: any;
        } & {
            [k: string]: unknown;
        };
    };
    llm: {
        provider: string;
        config: {
            modelProperties?: Record<string, any> | undefined;
            apiKey?: string | undefined;
            model?: any;
            baseURL?: string | undefined;
        };
    };
    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;
    historyStore?: {
        provider: string;
        config: Record<string, any>;
    } | undefined;
    disableHistory?: boolean | undefined;
}>;

interface Entity {
    userId?: string;
    agentId?: string;
    runId?: string;
}
interface AddMemoryOptions extends Entity {
    metadata?: Record<string, any>;
    filters?: SearchFilters;
    infer?: boolean;
}
interface SearchMemoryOptions extends Entity {
    limit?: number;
    filters?: SearchFilters;
}
interface GetAllMemoryOptions extends Entity {
    limit?: number;
}
interface DeleteAllMemoryOptions extends Entity {
}

declare class Memory {
    private config;
    private customPrompt;
    private embedder;
    private vectorStore;
    private llm;
    private db;
    private collectionName;
    private apiVersion;
    private graphMemory?;
    private enableGraph;
    telemetryId: string;
    constructor(config?: Partial<MemoryConfig>);
    private _initializeTelemetry;
    private _getTelemetryId;
    private _captureEvent;
    static fromConfig(configDict: Record<string, any>): Memory;
    add(messages: string | Message[], config: AddMemoryOptions): Promise<SearchResult>;
    private addToVectorStore;
    get(memoryId: string): Promise<MemoryItem | null>;
    search(query: string, config: SearchMemoryOptions): Promise<SearchResult>;
    update(memoryId: string, data: string): Promise<{
        message: string;
    }>;
    delete(memoryId: string): Promise<{
        message: string;
    }>;
    deleteAll(config: DeleteAllMemoryOptions): Promise<{
        message: string;
    }>;
    history(memoryId: string): Promise<any[]>;
    reset(): Promise<void>;
    getAll(config: GetAllMemoryOptions): Promise<SearchResult>;
    private createMemory;
    private updateMemory;
    private deleteMemory;
}

interface Embedder {
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
}

declare class OpenAIEmbedder implements Embedder {
    private openai;
    private model;
    private embeddingDims?;
    constructor(config: EmbeddingConfig);
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
}

declare class OllamaEmbedder implements Embedder {
    private ollama;
    private model;
    private embeddingDims?;
    private initialized;
    constructor(config: EmbeddingConfig);
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
    private ensureModelExists;
}

declare class GoogleEmbedder implements Embedder {
    private google;
    private model;
    private embeddingDims?;
    constructor(config: EmbeddingConfig);
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
}

declare class AzureOpenAIEmbedder implements Embedder {
    private client;
    private model;
    private embeddingDims?;
    constructor(config: EmbeddingConfig);
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
}

declare class LangchainEmbedder implements Embedder {
    private embedderInstance;
    private batchSize?;
    constructor(config: EmbeddingConfig);
    embed(text: string): Promise<number[]>;
    embedBatch(texts: string[]): Promise<number[][]>;
}

interface LLMResponse {
    content: string;
    role: string;
    toolCalls?: Array<{
        name: string;
        arguments: string;
    }>;
}
interface LLM {
    generateResponse(messages: Array<{
        role: string;
        content: string;
    }>, response_format?: {
        type: string;
    }, tools?: any[]): Promise<any>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class OpenAILLM implements LLM {
    private openai;
    private model;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class GoogleLLM implements LLM {
    private google;
    private model;
    private providerConfig;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class OpenAIStructuredLLM implements LLM {
    private openai;
    private model;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    } | null, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class AnthropicLLM implements LLM {
    private client;
    private model;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }): Promise<string>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class GroqLLM implements LLM {
    private client;
    private model;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }): Promise<string>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class OllamaLLM implements LLM {
    private ollama;
    private model;
    private initialized;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
    private ensureModelExists;
}

declare class MistralLLM implements LLM {
    private client;
    private model;
    constructor(config: LLMConfig);
    private contentToString;
    generateResponse(messages: Message[], responseFormat?: {
        type: string;
    }, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

declare class LangchainLLM implements LLM {
    private llmInstance;
    private modelName;
    constructor(config: LLMConfig);
    generateResponse(messages: Message[], response_format?: {
        type: string;
    }, tools?: any[]): Promise<string | LLMResponse>;
    generateChat(messages: Message[]): Promise<LLMResponse>;
}

interface VectorStore {
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
    initialize(): Promise<void>;
}

declare class MemoryVectorStore implements VectorStore {
    private db;
    private dimension;
    private dbPath;
    constructor(config: VectorStoreConfig);
    private init;
    private run;
    private all;
    private getOne;
    private cosineSimilarity;
    private filterVector;
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
    initialize(): Promise<void>;
}

interface QdrantConfig extends VectorStoreConfig {
    client?: QdrantClient;
    host?: string;
    port?: number;
    path?: string;
    url?: string;
    apiKey?: string;
    onDisk?: boolean;
    collectionName: string;
    embeddingModelDims: number;
    dimension?: number;
}
declare class Qdrant implements VectorStore {
    private client;
    private readonly collectionName;
    private dimension;
    constructor(config: QdrantConfig);
    private createFilter;
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    private generateUUID;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
    initialize(): Promise<void>;
}

interface RedisConfig extends VectorStoreConfig {
    redisUrl: string;
    collectionName: string;
    embeddingModelDims: number;
    username?: string;
    password?: string;
}
declare class RedisDB implements VectorStore {
    private client;
    private readonly indexName;
    private readonly indexPrefix;
    private readonly schema;
    constructor(config: RedisConfig);
    private createIndex;
    initialize(): Promise<void>;
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    close(): Promise<void>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
}

interface SupabaseConfig extends VectorStoreConfig {
    supabaseUrl: string;
    supabaseKey: string;
    tableName: string;
    embeddingColumnName?: string;
    metadataColumnName?: string;
}
declare class SupabaseDB implements VectorStore {
    private client;
    private readonly tableName;
    private readonly embeddingColumnName;
    private readonly metadataColumnName;
    constructor(config: SupabaseConfig);
    initialize(): Promise<void>;
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
}

interface LangchainStoreConfig extends VectorStoreConfig {
    client: VectorStore$1;
}
declare class LangchainVectorStore implements VectorStore {
    private lcStore;
    private dimension?;
    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[]>;
    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]>;
    deleteCol(): Promise<void>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
    initialize(): Promise<void>;
}

interface VectorizeConfig extends VectorStoreConfig {
    apiKey?: string;
    indexName: string;
    accountId: string;
}
declare class VectorizeDB implements VectorStore {
    private client;
    private dimensions;
    private indexName;
    private accountId;
    constructor(config: VectorizeConfig);
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    private generateUUID;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
    initialize(): Promise<void>;
}

/**
 * Configuration interface for Azure AI Search vector store
 */
interface AzureAISearchConfig extends VectorStoreConfig {
    /**
     * Azure AI Search service name (e.g., "my-search-service")
     */
    serviceName: string;
    /**
     * Index/collection name to use
     */
    collectionName: string;
    /**
     * API key for authentication (if not provided, uses DefaultAzureCredential)
     */
    apiKey?: string;
    /**
     * Vector embedding dimensions
     */
    embeddingModelDims: number;
    /**
     * Compression type: 'none', 'scalar', or 'binary'
     * @default 'none'
     */
    compressionType?: "none" | "scalar" | "binary";
    /**
     * Use half precision (float16) instead of full precision (float32)
     * @default false
     */
    useFloat16?: boolean;
    /**
     * Enable hybrid search (combines vector + text search)
     * @default false
     */
    hybridSearch?: boolean;
    /**
     * Vector filter mode: 'preFilter' or 'postFilter'
     * @default 'preFilter'
     */
    vectorFilterMode?: string;
}
/**
 * Azure AI Search vector store implementation
 * Supports vector search with hybrid search, compression, and filtering
 */
declare class AzureAISearch implements VectorStore {
    private searchClient;
    private indexClient;
    private readonly serviceName;
    private readonly indexName;
    private readonly embeddingModelDims;
    private readonly compressionType;
    private readonly useFloat16;
    private readonly hybridSearch;
    private readonly vectorFilterMode;
    private readonly apiKey;
    constructor(config: AzureAISearchConfig);
    /**
     * Initialize the Azure AI Search index if it doesn't exist
     */
    initialize(): Promise<void>;
    /**
     * Create a new index in Azure AI Search
     */
    private createCol;
    /**
     * Generate a document for insertion
     */
    private generateDocument;
    /**
     * Insert vectors into the index
     */
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    /**
     * Sanitize filter keys to remove non-alphanumeric characters
     */
    private sanitizeKey;
    /**
     * Build OData filter expression from SearchFilters
     */
    private buildFilterExpression;
    /**
     * Extract JSON from payload string
     * Handles cases where payload might have extra text
     */
    private extractJson;
    /**
     * Search for similar vectors
     */
    search(query: number[], limit?: number, filters?: SearchFilters): Promise<VectorStoreResult[]>;
    /**
     * Delete a vector by ID
     */
    delete(vectorId: string): Promise<void>;
    /**
     * Update a vector and its payload
     */
    update(vectorId: string, vector: number[], payload: Record<string, any>): Promise<void>;
    /**
     * Retrieve a vector by ID
     */
    get(vectorId: string): Promise<VectorStoreResult | null>;
    /**
     * List all collections (indexes)
     */
    private listCols;
    /**
     * Delete the index
     */
    deleteCol(): Promise<void>;
    /**
     * Get information about the index
     */
    private colInfo;
    /**
     * List all vectors in the index
     */
    list(filters?: SearchFilters, limit?: number): Promise<[VectorStoreResult[], number]>;
    /**
     * Generate a random user ID
     */
    private generateUUID;
    /**
     * Get user ID from memory_migrations collection
     * Required by VectorStore interface
     */
    getUserId(): Promise<string>;
    /**
     * Set user ID in memory_migrations collection
     * Required by VectorStore interface
     */
    setUserId(userId: string): Promise<void>;
    /**
     * Reset the index by deleting and recreating it
     */
    reset(): Promise<void>;
}

interface PGVectorConfigBase extends VectorStoreConfig {
    embeddingModelDims: number;
    diskann?: boolean;
    hnsw?: boolean;
    minconn?: number;
    maxconn?: number;
}
interface PGVectorConfigWithPool extends PGVectorConfigBase {
    connectionPool: Pool;
    dbname?: string;
    connectionString?: never;
    user?: never;
    password?: never;
    host?: never;
    port?: never;
    sslmode?: never;
}
interface PGVectorConfigWithConnectionString extends PGVectorConfigBase {
    connectionString: string;
    dbname?: string;
    sslmode?: string;
    connectionPool?: never;
    user?: never;
    password?: never;
    host?: never;
    port?: never;
}
interface PGVectorConfigWithIndividualParams extends PGVectorConfigBase {
    user: string;
    password: string;
    host: string;
    port: number;
    dbname?: string;
    sslmode?: string;
    connectionPool?: never;
    connectionString?: never;
}
type PGVectorConfig = PGVectorConfigWithPool | PGVectorConfigWithConnectionString | PGVectorConfigWithIndividualParams;
declare class PGVector implements VectorStore {
    private pool;
    private collectionName;
    private sanitizedCollectionName;
    private quotedTableName;
    private useDiskann;
    private useHnsw;
    private readonly dbName;
    private sanitizedDbName;
    private config;
    constructor(config: PGVectorConfig);
    /**
     * Extract database name from PostgreSQL connection string
     */
    private extractDbNameFromConnectionString;
    /**
     * Build connection string with optional sslmode
     */
    private buildConnectionString;
    /**
     * Build connection string from individual parameters
     */
    private buildConnectionStringFromParams;
    /**
     * Sanitize SQL identifier to prevent SQL injection
     * Only allows alphanumeric characters and underscores
     */
    private sanitizeIdentifier;
    /**
     * Sanitize filter key to prevent SQL injection in JSONB path expressions
     * Since -> operator requires literal keys, we validate and sanitize the key
     */
    private sanitizeFilterKey;
    /**
     * Build filter conditions for SQL queries
     * Supports both equality and range filters (gte, gt, lte, lt)
     */
    private buildFilterConditions;
    initialize(): Promise<void>;
    private checkDatabaseExists;
    private createDatabase;
    private createCol;
    /**
     * Get quoted identifier using PostgreSQL's quote_ident function
     * Caches the result for the table name to avoid repeated queries
     */
    private getQuotedIdentifier;
    insert(vectors: number[][], ids: string[], payloads: Record<string, any>[]): Promise<void>;
    search(query: number[], limit?: 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]>;
    close(): Promise<void>;
    getUserId(): Promise<string>;
    setUserId(userId: string): Promise<void>;
}

interface HistoryManager {
    addHistory(memoryId: string, previousValue: string | null, newValue: string | null, action: string, createdAt?: string, updatedAt?: string, isDeleted?: number): Promise<void>;
    getHistory(memoryId: string): Promise<any[]>;
    reset(): Promise<void>;
    close(): void;
}

declare class EmbedderFactory {
    static create(provider: string, config: EmbeddingConfig): Embedder;
}
declare class LLMFactory {
    static create(provider: string, config: LLMConfig): LLM;
}
declare class VectorStoreFactory {
    static create(provider: string, config: VectorStoreConfig): VectorStore;
}
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, LangchainEmbedder, LangchainLLM, LangchainVectorStore, Memory, type MemoryConfig, MemoryConfigSchema, type MemoryItem, MemoryVectorStore, type Message, MistralLLM, type MultiModalMessages, type Neo4jConfig, OllamaEmbedder, OllamaLLM, OpenAIEmbedder, OpenAILLM, OpenAIStructuredLLM, PGVector, type PGVectorConfig, Qdrant, RedisDB, type SearchFilters, type SearchMemoryOptions, type SearchResult, SupabaseDB, type VectorStore, type VectorStoreConfig, VectorStoreFactory, type VectorStoreResult, VectorizeDB };