@dcyfr/ai 1.0.3 → 2.1.0

package/dist/ai/memory/dcyfr-memory.js

@@ -0,0 +1,308 @@
+/**
+ * DCYFR Memory implementation wrapping mem0 OSS client
+ */
+import { getMemoryConfig } from './config.js';
+import { getMem0Client, resetMem0Client as resetClient } from './mem0-client.js';
+// Default limits for memory queries
+const DEFAULTS = {
+    USER_MEMORY_LIMIT: 100,
+    AGENT_MEMORY_LIMIT: 50,
+    SESSION_MEMORY_LIMIT: 30,
+    CONSISTENCY_RETRIES: 4,
+    CONSISTENCY_RETRY_DELAY_MS: 150,
+    GET_ALL_QUERY: '*',
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * DCYFRMemory implementation using mem0 OSS as the backend
+ */
+export class DCYFRMemoryImpl {
+    mem0ClientPromise = null;
+    /**
+     * Lazy initialization of mem0 client
+     */
+    async ensureInitialized() {
+        if (!this.mem0ClientPromise) {
+            const memoryConfig = getMemoryConfig();
+            this.mem0ClientPromise = getMem0Client(memoryConfig);
+        }
+        return this.mem0ClientPromise;
+    }
+    /**
+     * Retry semantic search briefly to smooth over vector index eventual consistency.
+     */
+    async searchWithConsistencyRetries(client, query, options) {
+        let result = await client.search(query, options);
+        if (result.results.length > 0) {
+            return result;
+        }
+        for (let attempt = 1; attempt <= DEFAULTS.CONSISTENCY_RETRIES; attempt++) {
+            await sleep(DEFAULTS.CONSISTENCY_RETRY_DELAY_MS * attempt);
+            result = await client.search(query, options);
+            if (result.results.length > 0) {
+                return result;
+            }
+        }
+        return result;
+    }
+    // ============================================================================
+    // User Memory Operations
+    // ============================================================================
+    /**
+     * Add memory associated with a specific user
+     */
+    async addUserMemory(userId, message, context) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await client.add(message, {
+                userId,
+                metadata: {
+                    ownerType: 'user',
+                    topic: context?.topic,
+                    importance: context?.importance || 0.5,
+                    ...context?.metadata,
+                },
+            });
+            const directId = result.results[0]?.id;
+            if (directId) {
+                return directId;
+            }
+            // Some providers may return empty add results until embeddings are fully indexed.
+            try {
+                const fallback = await this.searchWithConsistencyRetries(client, message, {
+                    userId,
+                    limit: 1,
+                });
+                return fallback.results[0]?.id || '';
+            }
+            catch {
+                // Keep legacy behavior when add succeeded but no ID is returned.
+                return '';
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to add user memory: ${error.message}`);
+        }
+    }
+    /**
+     * Search user memories using semantic search
+     */
+    async searchUserMemories(userId, query, limit = DEFAULTS.USER_MEMORY_LIMIT) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await this.searchWithConsistencyRetries(client, query, {
+                userId,
+                limit,
+            });
+            return result.results.map((item) => ({
+                id: item.id,
+                content: item.memory,
+                owner: userId,
+                ownerType: 'user',
+                importance: item.metadata?.importance || 0.5,
+                topic: item.metadata?.topic,
+                createdAt: item.createdAt ? new Date(item.createdAt) : new Date(),
+                metadata: item.metadata,
+                relevance: item.score || 1.0,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to search user memories: ${error.message}`);
+        }
+    }
+    /**
+     * Get all memories for a user
+     */
+    async getUserMemories(userId, topic) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await client.search(DEFAULTS.GET_ALL_QUERY, {
+                userId,
+                limit: DEFAULTS.USER_MEMORY_LIMIT,
+                filters: topic ? { topic } : undefined,
+            });
+            return result.results.map((item) => ({
+                id: item.id,
+                content: item.memory,
+                owner: userId,
+                ownerType: 'user',
+                importance: item.metadata?.importance || 0.5,
+                topic: item.metadata?.topic,
+                createdAt: item.createdAt ? new Date(item.createdAt) : new Date(),
+                metadata: item.metadata,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to get user memories: ${error.message}`);
+        }
+    }
+    /**
+     * Delete all memories for a user
+     */
+    async deleteUserMemories(userId) {
+        try {
+            const client = await this.ensureInitialized();
+            await client.deleteAll({ userId });
+        }
+        catch (error) {
+            throw new Error(`Failed to delete user memories: ${error.message}`);
+        }
+    }
+    // ============================================================================
+    // Agent Memory Operations
+    // ============================================================================
+    /**
+     * Store agent workflow state
+     */
+    async addAgentMemory(agentId, sessionId, state) {
+        try {
+            const client = await this.ensureInitialized();
+            const message = `Agent state: ${JSON.stringify(state)}`;
+            const result = await client.add(message, {
+                agentId,
+                runId: sessionId,
+                metadata: {
+                    ownerType: 'agent',
+                    agentId,
+                    sessionId,
+                    state,
+                },
+            });
+            return result.results[0]?.id || '';
+        }
+        catch (error) {
+            throw new Error(`Failed to add agent memory: ${error.message}`);
+        }
+    }
+    /**
+     * Search agent memories
+     */
+    async searchAgentMemories(agentId, query, limit = DEFAULTS.AGENT_MEMORY_LIMIT) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await client.search(query, {
+                agentId,
+                limit,
+            });
+            return result.results.map((item) => ({
+                id: item.id,
+                content: item.memory,
+                owner: item.metadata?.agentId || agentId,
+                ownerType: 'agent',
+                relevance: item.score || 0.5,
+                agentId: item.metadata?.agentId || agentId,
+                sessionId: item.metadata?.sessionId,
+                state: item.metadata?.state,
+                createdAt: item.createdAt ? new Date(item.createdAt) : new Date(),
+                metadata: item.metadata,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to search agent memories: ${error.message}`);
+        }
+    }
+    /**
+     * Get agent workflow state for a specific session
+     */
+    async getAgentState(agentId, sessionId) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await client.search(DEFAULTS.GET_ALL_QUERY, {
+                agentId,
+                runId: sessionId,
+                limit: 1,
+            });
+            if (result.results.length === 0) {
+                return null;
+            }
+            return result.results[0].metadata?.state || null;
+        }
+        catch (error) {
+            throw new Error(`Failed to get agent state: ${error.message}`);
+        }
+    }
+    // ============================================================================
+    // Session Memory Operations
+    // ============================================================================
+    /**
+     * Add temporary session context with TTL
+     */
+    async addSessionMemory(sessionId, message, ttl = 3600) {
+        try {
+            const client = await this.ensureInitialized();
+            const expiresAt = new Date(Date.now() + ttl * 1000);
+            const result = await client.add(message, {
+                runId: sessionId,
+                metadata: {
+                    ownerType: 'session',
+                    sessionId,
+                    expiresAt: expiresAt.toISOString(),
+                },
+            });
+            return result.results[0]?.id || '';
+        }
+        catch (error) {
+            throw new Error(`Failed to add session memory: ${error.message}`);
+        }
+    }
+    /**
+     * Get concatenated session context (filters out expired memories)
+     */
+    async getSessionContext(sessionId) {
+        try {
+            const client = await this.ensureInitialized();
+            const result = await client.search(DEFAULTS.GET_ALL_QUERY, {
+                runId: sessionId,
+                limit: DEFAULTS.SESSION_MEMORY_LIMIT,
+            });
+            const now = new Date();
+            // Filter out expired memories
+            const validMemories = result.results.filter((item) => {
+                const expiresAt = item.metadata?.expiresAt;
+                if (!expiresAt)
+                    return true; // No expiration = keep
+                return new Date(expiresAt) > now;
+            });
+            // Concatenate all memory content
+            return validMemories
+                .map((item) => item.memory)
+                .join('\n\n');
+        }
+        catch (error) {
+            throw new Error(`Failed to get session context: ${error.message}`);
+        }
+    }
+    /**
+     * Delete all memories for a session
+     */
+    async deleteSessionMemories(sessionId) {
+        try {
+            const client = await this.ensureInitialized();
+            await client.deleteAll({ runId: sessionId });
+        }
+        catch (error) {
+            throw new Error(`Failed to delete session memories: ${error.message}`);
+        }
+    }
+}
+// ============================================================================
+// Singleton Factory
+// ============================================================================
+let memoryInstance = null;
+/**
+ * Get singleton DCYFRMemory instance
+ */
+export function getMemory() {
+    if (!memoryInstance) {
+        memoryInstance = new DCYFRMemoryImpl();
+    }
+    return memoryInstance;
+}
+/**
+ * Reset memory instance (for testing)
+ */
+export function resetMemory() {
+    memoryInstance = null;
+    resetClient();
+}
+//# sourceMappingURL=dcyfr-memory.js.map

package/dist/ai/memory/dcyfr-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dcyfr-memory.js","sourceRoot":"","sources":["../../../packages/ai/memory/dcyfr-memory.ts"],"names":[],"mappings":"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"}

package/dist/ai/memory/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Memory Layer Module - Barrel Exports
+ *
+ * Main entry point for @dcyfr/ai/memory module.
+ * Exports all public APIs for memory operations.
+ *
+ * @module @dcyfr/ai/memory
+ */
+export { getMemory, resetMemory, DCYFRMemoryImpl } from './dcyfr-memory.js';
+export { getMemoryConfig, loadMemoryConfig, validateMemoryConfig, DEFAULT_CONFIG, } from './config.js';
+export type { DCYFRMemory, Memory, MemorySearchResult, MemoryContext, AgentMemory, SessionMemory, MemoryProvider, } from './types.js';
+export type { VectorDBProvider, VectorDBConfig, LLMConfig, MemoryConfig, } from './config.js';
+export { createMem0Client, getMem0Client, resetMem0Client, } from './mem0-client.js';
+export type { Mem0Client } from './mem0-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/ai/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,MAAM,EACN,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai/memory/index.js

@@ -0,0 +1,15 @@
+/**
+ * Memory Layer Module - Barrel Exports
+ *
+ * Main entry point for @dcyfr/ai/memory module.
+ * Exports all public APIs for memory operations.
+ *
+ * @module @dcyfr/ai/memory
+ */
+// Main API
+export { getMemory, resetMemory, DCYFRMemoryImpl } from './dcyfr-memory.js';
+// Configuration
+export { getMemoryConfig, loadMemoryConfig, validateMemoryConfig, DEFAULT_CONFIG, } from './config.js';
+// Client utilities (for advanced users)
+export { createMem0Client, getMem0Client, resetMem0Client, } from './mem0-client.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/ai/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE5E,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAoBrB,wCAAwC;AACxC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/ai/memory/mem0-client.d.ts

@@ -0,0 +1,108 @@
+/**
+ * mem0 Client Integration
+ *
+ * Factory functions and utilities for initializing mem0 memory client.
+ * Handles connection to vector database and LLM configuration.
+ *
+ * @module @dcyfr/ai/memory/mem0-client
+ */
+import type { MemoryConfig } from './config.js';
+/**
+ * mem0 Memory Item result
+ */
+export interface MemoryItem {
+    id: string;
+    memory: string;
+    hash?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    score?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * mem0 Message format
+ */
+export interface Message {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/**
+ * mem0 Search Result
+ */
+export interface SearchResult {
+    results: MemoryItem[];
+    relations?: any[];
+}
+/**
+ * Add Memory Options
+ */
+export interface AddMemoryOptions {
+    userId?: string;
+    agentId?: string;
+    runId?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Search Memory Options
+ */
+export interface SearchMemoryOptions {
+    userId?: string;
+    agentId?: string;
+    runId?: string;
+    limit?: number;
+    filters?: Record<string, any>;
+}
+/**
+ * Delete All Memory Options
+ */
+export interface DeleteAllMemoryOptions {
+    userId?: string;
+    agentId?: string;
+    runId?: string;
+}
+/**
+ * mem0 OSS Memory instance interface (from mem0ai/oss)
+ */
+export interface Mem0Client {
+    add(messages: string | Message[], config: AddMemoryOptions): Promise<SearchResult>;
+    search(query: string, config: SearchMemoryOptions): Promise<SearchResult>;
+    get(memoryId: string): Promise<MemoryItem | null>;
+    update(memoryId: string, data: string): Promise<{
+        message: string;
+    }>;
+    delete(memoryId: string): Promise<{
+        message: string;
+    }>;
+    deleteAll(config: DeleteAllMemoryOptions): Promise<{
+        message: string;
+    }>;
+}
+/**
+ * Create and initialize mem0 OSS client
+ *
+ * This function:
+ * 1. Converts DCYFR config to mem0 OSS config format
+ * 2. Dynamically imports mem0ai/oss package
+ * 3. Initializes Memory client with vector DB and LLM
+ * 4. Tests connection (throws on failure)
+ *
+ * @param config - DCYFR memory configuration
+ * @returns Initialized mem0 Memory instance
+ * @throws Error if mem0 initialization fails or connection test fails
+ */
+export declare function createMem0Client(config: MemoryConfig): Promise<Mem0Client>;
+/**
+ * Get or create singleton mem0 client
+ *
+ * Reuses existing client if already initialized, otherwise creates new one.
+ *
+ * @param config - Memory configuration (required on first call)
+ * @returns mem0 client instance
+ * @throws Error if called without config before initialization
+ */
+export declare function getMem0Client(config?: MemoryConfig): Promise<Mem0Client>;
+/**
+ * Reset mem0 client singleton (for testing)
+ */
+export declare function resetMem0Client(): void;
+//# sourceMappingURL=mem0-client.d.ts.map

package/dist/ai/memory/mem0-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-client.d.ts","sourceRoot":"","sources":["../../../packages/ai/memory/mem0-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA6B,MAAM,aAAa,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAC,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AA8JD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA2ChF;AAaD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB9E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/ai/memory/mem0-client.js

@@ -0,0 +1,205 @@
+/**
+ * mem0 Client Integration
+ *
+ * Factory functions and utilities for initializing mem0 memory client.
+ * Handles connection to vector database and LLM configuration.
+ *
+ * @module @dcyfr/ai/memory/mem0-client
+ */
+/**
+ * Determine embedding/vector dimensions from configured embedder provider.
+ */
+function resolveEmbeddingDimension(config) {
+    if (config.embeddingDims) {
+        return config.embeddingDims;
+    }
+    const provider = config.embeddingProvider || config.provider;
+    // Sensible provider defaults for common models
+    if (provider === 'ollama') {
+        return 1024;
+    }
+    // OpenAI text-embedding-3-small default
+    return 1536;
+}
+/**
+ * Convert DCYFR VectorDBConfig to mem0 OSS vector_store config
+ */
+function buildVectorStoreConfig(config, embeddingDimension) {
+    switch (config.provider) {
+        case 'qdrant':
+            const qdrantConfig = {
+                collectionName: config.index || 'dcyfr_memories',
+                dimension: embeddingDimension,
+            };
+            if (config.url) {
+                // Qdrant client expects either URL or host/port, not both.
+                qdrantConfig.url = config.url;
+            }
+            if (config.apiKey) {
+                qdrantConfig.apiKey = config.apiKey;
+            }
+            return {
+                provider: 'qdrant',
+                config: qdrantConfig,
+            };
+        case 'pinecone':
+            return {
+                provider: 'pinecone',
+                config: {
+                    apiKey: config.apiKey,
+                    collectionName: config.index || 'dcyfr-memories',
+                    dimension: embeddingDimension,
+                },
+            };
+        case 'weaviate':
+            const weaviateConfig = {
+                collectionName: config.index || 'dcyfr_memories',
+                dimension: embeddingDimension,
+            };
+            if (config.url) {
+                weaviateConfig.url = config.url;
+            }
+            if (config.apiKey) {
+                weaviateConfig.apiKey = config.apiKey;
+            }
+            return {
+                provider: 'weaviate',
+                config: weaviateConfig,
+            };
+        default:
+            throw new Error(`Unsupported vector DB provider: ${config.provider}`);
+    }
+}
+/**
+ * Convert DCYFR LLMConfig to mem0 OSS llm config
+ */
+function buildLLMConfig(config) {
+    return {
+        provider: config.provider,
+        config: {
+            model: config.model || 'gpt-4',
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+        },
+    };
+}
+/**
+ * Convert DCYFR LLMConfig to mem0 OSS embedder config
+ */
+function buildEmbedderConfig(config) {
+    const provider = config.embeddingProvider || config.provider;
+    // mem0 OSS embedder providers differ from LLM providers.
+    // Fall back to OpenAI-compatible embeddings when no native embedder exists.
+    const normalizedProvider = ['anthropic', 'groq', 'mistral'].includes(provider)
+        ? 'openai'
+        : provider;
+    const defaultEmbeddingDims = normalizedProvider === 'ollama' ? 768 : 1536;
+    return {
+        provider: normalizedProvider,
+        config: {
+            model: config.embeddingModel || 'text-embedding-3-small',
+            apiKey: config.embeddingApiKey || config.apiKey,
+            url: config.embeddingBaseURL || (normalizedProvider === 'ollama' ? process.env.OLLAMA_URL : undefined),
+            embeddingDims: config.embeddingDims || defaultEmbeddingDims,
+        },
+    };
+}
+/**
+ * Create and initialize mem0 OSS client
+ *
+ * This function:
+ * 1. Converts DCYFR config to mem0 OSS config format
+ * 2. Dynamically imports mem0ai/oss package
+ * 3. Initializes Memory client with vector DB and LLM
+ * 4. Tests connection (throws on failure)
+ *
+ * @param config - DCYFR memory configuration
+ * @returns Initialized mem0 Memory instance
+ * @throws Error if mem0 initialization fails or connection test fails
+ */
+export async function createMem0Client(config) {
+    try {
+        const embeddingDimension = resolveEmbeddingDimension(config.llm);
+        // Build mem0 OSS configuration
+        const mem0Config = {
+            version: 'v1.1',
+            embedder: buildEmbedderConfig(config.llm),
+            vectorStore: buildVectorStoreConfig(config.vectorDB, embeddingDimension),
+            llm: buildLLMConfig(config.llm),
+            disableHistory: true, // Disable history DB for simplicity
+        };
+        // Dynamic import of mem0ai/oss package
+        const { Memory } = await import('mem0ai/oss');
+        // Initialize client
+        const client = new Memory(mem0Config);
+        // Test connection with a simple search
+        try {
+            await client.search('_health_check', {
+                userId: '_system',
+                limit: 1,
+            });
+        }
+        catch (error) {
+            // If error is about connection, throw
+            if (error.message?.includes('connection') || error.message?.includes('timeout')) {
+                throw new Error(`mem0 connection test failed: ${error.message}`);
+            }
+            // Other errors (like no memories) are acceptable
+        }
+        return client;
+    }
+    catch (error) {
+        if (error.message?.includes('Cannot find module') || error.message?.includes('Cannot find package')) {
+            throw new Error('mem0ai runtime dependency missing. Ensure mem0ai and required provider SDKs (e.g. openai) are installed.\n' +
+                'Original error: ' + error.message);
+        }
+        throw new Error(`Failed to initialize mem0 client: ${error.message}`);
+    }
+}
+/**
+ * Singleton mem0 client instance
+ * Initialized lazily on first use
+ */
+let mem0ClientInstance = null;
+let mem0ClientConfigFingerprint = null;
+function fingerprintConfig(config) {
+    return JSON.stringify(config);
+}
+/**
+ * Get or create singleton mem0 client
+ *
+ * Reuses existing client if already initialized, otherwise creates new one.
+ *
+ * @param config - Memory configuration (required on first call)
+ * @returns mem0 client instance
+ * @throws Error if called without config before initialization
+ */
+export async function getMem0Client(config) {
+    if (mem0ClientInstance) {
+        if (!config) {
+            return mem0ClientInstance;
+        }
+        const incomingFingerprint = fingerprintConfig(config);
+        if (mem0ClientConfigFingerprint === incomingFingerprint) {
+            return mem0ClientInstance;
+        }
+        // Runtime profile changed (provider/base URL/vector DB, etc) — recreate client.
+        mem0ClientInstance = await createMem0Client(config);
+        mem0ClientConfigFingerprint = incomingFingerprint;
+        return mem0ClientInstance;
+    }
+    if (!config) {
+        throw new Error('Memory configuration required for first-time initialization');
+    }
+    mem0ClientInstance = await createMem0Client(config);
+    mem0ClientConfigFingerprint = fingerprintConfig(config);
+    return mem0ClientInstance;
+}
+/**
+ * Reset mem0 client singleton (for testing)
+ */
+export function resetMem0Client() {
+    mem0ClientInstance = null;
+    mem0ClientConfigFingerprint = null;
+}
+//# sourceMappingURL=mem0-client.js.map