diff --git a/docs/changelog.mdx b/docs/changelog.mdx index ca6fe9a9..92ac558b 100644 --- a/docs/changelog.mdx +++ b/docs/changelog.mdx @@ -209,6 +209,11 @@ mode: "wide" + +**Improvements:** +- **Client:** Improved error handling in client. + + **New Features:** - **Client:** Added new param `output_format` to match Python SDK. @@ -482,6 +487,11 @@ mode: "wide" + +**Improvements:** +- **Vercel AI SDK:** Added support for graceful failure in cases services are down. + + **New Features:** - **Vercel AI SDK:** Added support for graph memories diff --git a/mem0-ts/package.json b/mem0-ts/package.json index 3e554e53..5f3f7b75 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -1,6 +1,6 @@ { "name": "mem0ai", - "version": "2.1.24", + "version": "2.1.25", "description": "The Memory Layer For Your AI Apps", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.ts index ec0ed541..e4aece97 100644 --- a/mem0-ts/src/client/mem0.ts +++ b/mem0-ts/src/client/mem0.ts @@ -179,23 +179,41 @@ export default class MemoryClient { } async ping(): Promise { - const response = await fetch(`${this.host}/v1/ping/`, { - headers: { - Authorization: `Token ${this.apiKey}`, - }, - }); + try { + const response = await this._fetchWithErrorHandling( + `${this.host}/v1/ping/`, + { + method: "GET", + headers: { + Authorization: `Token ${this.apiKey}`, + }, + }, + ); - const data = await response.json(); + if (!response || typeof response !== "object") { + throw new APIError("Invalid response format from ping endpoint"); + } - if (data.status !== "ok") { - throw new Error("API Key is invalid"); + if (response.status !== "ok") { + throw new APIError(response.message || "API Key is invalid"); + } + + const { org_id, project_id, user_email } = response; + + // Only update if values are actually present + if (org_id && !this.organizationId) this.organizationId = org_id; + if (project_id && !this.projectId) this.projectId = project_id; + if (user_email) this.telemetryId = user_email; + } catch (error: any) { + // Convert generic errors to APIError with meaningful messages + if (error instanceof APIError) { + throw error; + } else { + throw new APIError( + `Failed to ping server: ${error.message || "Unknown error"}`, + ); + } } - - const { org_id, project_id, user_email } = data; - - this.organizationId = this.organizationId || org_id || null; - this.projectId = this.projectId || project_id || null; - this.telemetryId = user_email || ""; } async add( diff --git a/vercel-ai-sdk/package.json b/vercel-ai-sdk/package.json index d58cae85..91d79137 100644 --- a/vercel-ai-sdk/package.json +++ b/vercel-ai-sdk/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/vercel-ai-provider", - "version": "1.0.2", + "version": "1.0.3", "description": "Vercel AI Provider for providing memory to LLMs", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/vercel-ai-sdk/src/index.ts b/vercel-ai-sdk/src/index.ts index 99328722..39fa9efc 100644 --- a/vercel-ai-sdk/src/index.ts +++ b/vercel-ai-sdk/src/index.ts @@ -2,4 +2,4 @@ export * from './mem0-facade' export type { Mem0Provider, Mem0ProviderSettings } from './mem0-provider' export { createMem0, mem0 } from './mem0-provider' export type { Mem0ConfigSettings, Mem0ChatConfig, Mem0ChatSettings } from './mem0-types' -export {addMemories, retrieveMemories, searchMemories, getMemories } from './mem0-utils' \ No newline at end of file +export { addMemories, retrieveMemories, searchMemories, getMemories } from './mem0-utils' \ No newline at end of file diff --git a/vercel-ai-sdk/src/mem0-generic-language-model.ts b/vercel-ai-sdk/src/mem0-generic-language-model.ts index f8b594ce..6618278e 100644 --- a/vercel-ai-sdk/src/mem0-generic-language-model.ts +++ b/vercel-ai-sdk/src/mem0-generic-language-model.ts @@ -31,9 +31,13 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { provider: string; private async processMemories(messagesPrompts: LanguageModelV1Message[], mem0Config: Mem0ConfigSettings) { + try { // Add New Memories addMemories(messagesPrompts, mem0Config).then((res) => { return res; + }).catch((e) => { + console.error("Error while adding memories"); + return { memories: [], messagesPrompts: [] }; }); // Get Memories @@ -41,23 +45,23 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { const mySystemPrompt = "These are the memories I have stored. Give more weightage to the question by users and try to answer that first. You have to modify your answer based on the memories I have provided. If the memories are irrelevant you can ignore them. Also don't reply to this section of the prompt, or the memories, they are only for your reference. The System prompt starts after text System Message: \n\n"; - const isGraphEnabled = mem0Config.enable_graph; + const isGraphEnabled = mem0Config?.enable_graph; let memoriesText = ""; let memoriesText2 = ""; try { // @ts-ignore if (isGraphEnabled) { - memoriesText = memories.results.map((memory: any) => { - return `Memory: ${memory.memory}\n\n`; + memoriesText = memories?.results?.map((memory: any) => { + return `Memory: ${memory?.memory}\n\n`; }).join("\n\n"); - memoriesText2 = memories.relations.map((memory: any) => { - return `Relation: ${memory.source} -> ${memory.relationship} -> ${memory.target} \n\n`; + memoriesText2 = memories?.relations?.map((memory: any) => { + return `Relation: ${memory?.source} -> ${memory?.relationship} -> ${memory?.target} \n\n`; }).join("\n\n"); } else { - memoriesText = memories.map((memory: any) => { - return `Memory: ${memory.memory}\n\n`; + memoriesText = memories?.map((memory: any) => { + return `Memory: ${memory?.memory}\n\n`; }).join("\n\n"); } } catch(e) { @@ -78,15 +82,19 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { }; // Add the system prompt to the beginning of the messages if there are memories - if (memories.length > 0) { + if (memories?.length > 0) { messagesPrompts.unshift(systemPrompt); } if (isGraphEnabled) { - memories = memories.results; + memories = memories?.results; } return { memories, messagesPrompts }; + } catch(e) { + console.error("Error while processing memories"); + return { memories: [], messagesPrompts }; + } } async doGenerate(options: LanguageModelV1CallOptions): Promise>> { @@ -121,7 +129,7 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { }); // If there are no memories, return the original response - if (!memories || memories.length === 0) { + if (!memories || memories?.length === 0) { return ans; } @@ -129,7 +137,7 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { const sources = [...(ans.sources || [])]; // Add a combined source with all memories - if (Array.isArray(memories) && memories.length > 0) { + if (Array.isArray(memories) && memories?.length > 0) { sources.push({ title: "Mem0 Memories", sourceType: "url", @@ -138,13 +146,13 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { providerMetadata: { mem0: { memories: memories, - memoriesText: memories.map((memory: any) => memory.memory).join("\n\n") + memoriesText: memories?.map((memory: any) => memory?.memory).join("\n\n") } } }); // Add individual memory sources for more detailed information - memories.forEach((memory: any) => { + memories?.forEach((memory: any) => { sources.push({ title: memory.title || "Memory", sourceType: "url", @@ -153,7 +161,7 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { providerMetadata: { mem0: { memory: memory, - memoryText: memory.memory + memoryText: memory?.memory } } }); @@ -204,7 +212,7 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { }); // If there are no memories, return the original stream - if (!memories || memories.length === 0) { + if (!memories || memories?.length === 0) { return streamResponse; } @@ -216,7 +224,7 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { start(controller) { // Add source chunks for each memory at the beginning try { - if (Array.isArray(memories) && memories.length > 0) { + if (Array.isArray(memories) && memories?.length > 0) { // Create a single source that contains all memories controller.enqueue({ type: 'source', @@ -228,25 +236,25 @@ export class Mem0GenericLanguageModel implements LanguageModelV1 { providerMetadata: { mem0: { memories: memories, - memoriesText: memories.map((memory: any) => memory.memory).join("\n\n") + memoriesText: memories?.map((memory: any) => memory?.memory).join("\n\n") } } } }); // Also add individual memory sources for more detailed information - memories.forEach((memory: any) => { + memories?.forEach((memory: any) => { controller.enqueue({ type: 'source', source: { - title: memory.title || "Memory", + title: memory?.title || "Memory", sourceType: "url", id: "mem0-memory-" + generateRandomId(), url: "https://app.mem0.ai", providerMetadata: { mem0: { memory: memory, - memoryText: memory.memory + memoryText: memory?.memory } } } diff --git a/vercel-ai-sdk/src/mem0-utils.ts b/vercel-ai-sdk/src/mem0-utils.ts index 5543c09a..a0690661 100644 --- a/vercel-ai-sdk/src/mem0-utils.ts +++ b/vercel-ai-sdk/src/mem0-utils.ts @@ -7,170 +7,231 @@ interface Message { } const flattenPrompt = (prompt: LanguageModelV1Prompt) => { - return prompt.map((part) => { - if (part.role === "user") { - return part.content - .filter((obj) => obj.type === 'text') - .map((obj) => obj.text) - .join(" "); - } + try { + return prompt.map((part) => { + if (part.role === "user") { + return part.content + .filter((obj) => obj.type === 'text') + .map((obj) => obj.text) + .join(" "); + } + return ""; + }).join(" "); + } catch (error) { + console.error("Error in flattenPrompt:", error); return ""; - }).join(" "); + } } const convertToMem0Format = (messages: LanguageModelV1Prompt) => { - return messages.flatMap((message: any) => { - if (typeof message.content === 'string') { - return { - role: message.role, - content: message.content, - }; + try { + return messages.flatMap((message: any) => { + try { + if (typeof message.content === 'string') { + return { + role: message.role, + content: message.content, + }; + } + else { + return message.content.map((obj: any) => { + try { + if (obj.type === "text") { + return { + role: message.role, + content: obj.text, + }; + } + return null; + } catch (error) { + console.error("Error processing content object:", error); + return null; + } + }).filter((item: null) => item !== null); + } + } catch (error) { + console.error("Error processing message:", error); + return []; + } + }); + } catch (error) { + console.error("Error in convertToMem0Format:", error); + return []; } - else{ - return message.content.map((obj: any) => { - if (obj.type === "text") { - return { - role: message.role, - content: obj.text, - }; +} + +const searchInternalMemories = async (query: string, config?: Mem0ConfigSettings, top_k: number = 5) => { + try { + const filters: { AND: Array<{ [key: string]: string | undefined }> } = { + AND: [], + }; + if (config?.user_id) { + filters.AND.push({ + user_id: config.user_id, + }); + } + if (config?.app_id) { + filters.AND.push({ + app_id: config.app_id, + }); + } + if (config?.agent_id) { + filters.AND.push({ + agent_id: config.agent_id, + }); + } + if (config?.run_id) { + filters.AND.push({ + run_id: config.run_id, + }); + } + const org_project_filters = { + org_id: config&&config.org_id, + project_id: config&&config.project_id, + org_name: !config?.org_id ? config&&config.org_name : undefined, + project_name: !config?.org_id ? config&&config.project_name : undefined, + } + + const apiKey = loadApiKey({ + apiKey: (config&&config.mem0ApiKey), + environmentVariableName: "MEM0_API_KEY", + description: "Mem0", + }); + + const options = { + method: 'POST', + headers: { + Authorization: `Token ${apiKey}`, + 'Content-Type': 'application/json' + }, + body: JSON.stringify({ + query, + filters, + ...config, + top_k: config&&config.top_k || top_k, + version: "v2", + output_format: "v1.1", + ...org_project_filters + }), + }; + + const response = await fetch('https://api.mem0.ai/v2/memories/search/', options); + if (!response.ok) { + throw new Error(`HTTP error! status: ${response.status}`); + } + const data = await response.json(); + return data; + } catch (error) { + console.error("Error in searchInternalMemories:", error); + throw error; + } +} + +const addMemories = async (messages: LanguageModelV1Prompt, config?: Mem0ConfigSettings) => { + try { + let finalMessages: Array = []; + if (typeof messages === "string") { + finalMessages = [{ role: "user", content: messages }]; } else { - return null; // Handle other cases or return null/undefined as needed + finalMessages = convertToMem0Format(messages); } - }).filter((item: null) => item !== null); // Filter out null values if necessary + const response = await updateMemories(finalMessages, config); + return response; + } catch (error) { + console.error("Error in addMemories:", error); + throw error; } -})}; +} -const searchInternalMemories = async (query: string, config?: Mem0ConfigSettings, top_k: number = 5)=> { - const filters: { AND: Array<{ [key: string]: string | undefined }> } = { - AND: [], - }; - if (config?.user_id) { - filters.AND.push({ - user_id: config.user_id, - }); - } - if (config?.app_id) { - filters.AND.push({ - app_id: config.app_id, - }); - } - if (config?.agent_id) { - filters.AND.push({ - agent_id: config.agent_id, - }); - } - if (config?.run_id) { - filters.AND.push({ - run_id: config.run_id, - }); - } - const org_project_filters = { - org_id: config&&config.org_id, - project_id: config&&config.project_id, - org_name: !config?.org_id ? config&&config.org_name : undefined, // deprecated - project_name: !config?.org_id ? config&&config.project_name : undefined, // deprecated - } - const options = { - method: 'POST', - // headers: {Authorization: `Token ${(config&&config.mem0ApiKey) || (typeof process !== 'undefined' && process.env && process.env.MEM0_API_KEY) || ""}`, 'Content-Type': 'application/json'}, - headers: {Authorization: `Token ${loadApiKey({ +const updateMemories = async (messages: Array, config?: Mem0ConfigSettings) => { + try { + const apiKey = loadApiKey({ apiKey: (config&&config.mem0ApiKey), environmentVariableName: "MEM0_API_KEY", description: "Mem0", - })}`, 'Content-Type': 'application/json'}, - body: JSON.stringify({query, filters, ...config, top_k: config&&config.top_k || top_k, version: "v2", output_format: "v1.1", ...org_project_filters}), - }; - const response = await fetch('https://api.mem0.ai/v2/memories/search/', options); - const data = await response.json(); - return data; -} + }); -const addMemories = async (messages: LanguageModelV1Prompt, config?: Mem0ConfigSettings)=>{ - let finalMessages: Array = []; - if (typeof messages === "string") { - finalMessages = [{ role: "user", content: messages }]; - }else { - finalMessages = convertToMem0Format(messages); + const options = { + method: 'POST', + headers: { + Authorization: `Token ${apiKey}`, + 'Content-Type': 'application/json' + }, + body: JSON.stringify({messages, ...config}), + }; + + const response = await fetch('https://api.mem0.ai/v1/memories/', options); + if (!response.ok) { + throw new Error(`HTTP error! status: ${response.status}`); + } + const data = await response.json(); + return data; + } catch (error) { + console.error("Error in updateMemories:", error); + throw error; } - const response = await updateMemories(finalMessages, config); - return response; } -const updateMemories = async (messages: Array, config?: Mem0ConfigSettings)=>{ - const options = { - method: 'POST', - headers: {Authorization: `Token ${loadApiKey({ - apiKey: (config&&config.mem0ApiKey), - environmentVariableName: "MEM0_API_KEY", - description: "Mem0", - })}`, 'Content-Type': 'application/json'}, - body: JSON.stringify({messages, ...config}), - }; +const retrieveMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings) => { + try { + const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); + const systemPrompt = "These are the memories I have stored. Give more weightage to the question by users and try to answer that first. You have to modify your answer based on the memories I have provided. If the memories are irrelevant you can ignore them. Also don't reply to this section of the prompt, or the memories, they are only for your reference. The System prompt starts after text System Message: \n\n"; + + const memories = await searchInternalMemories(message, config); + let memoriesText1 = ""; + let memoriesText2 = ""; + let graphPrompt = ""; - const response = await fetch('https://api.mem0.ai/v1/memories/', options); - const data = await response.json(); - return data; -} - -const retrieveMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings)=>{ - const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); - const systemPrompt = "These are the memories I have stored. Give more weightage to the question by users and try to answer that first. You have to modify your answer based on the memories I have provided. If the memories are irrelevant you can ignore them. Also don't reply to this section of the prompt, or the memories, they are only for your reference. The System prompt starts after text System Message: \n\n"; - const memories = await searchInternalMemories(message, config); - let memoriesText1 = ""; - let memoriesText2 = ""; - let graphPrompt = ""; - try{ - // @ts-ignore - memoriesText1 = memories.results.map((memory: any)=>{ - return `Memory: ${memory.memory}\n\n`; - }).join("\n\n"); - - if (config?.enable_graph) { - memoriesText2 = memories.relations.map((memory: any)=>{ - return `Relation: ${memory.source} -> ${memory.relationship} -> ${memory.target} \n\n`; + try { + memoriesText1 = memories?.results?.map((memory: any) => { + return `Memory: ${memory.memory}\n\n`; }).join("\n\n"); + + if (config?.enable_graph) { + memoriesText2 = memories?.relations?.map((memory: any) => { + return `Relation: ${memory.source} -> ${memory.relationship} -> ${memory.target} \n\n`; + }).join("\n\n"); + graphPrompt = `HERE ARE THE GRAPHS RELATIONS FOR THE PREFERENCES OF THE USER:\n\n ${memoriesText2}`; + } + } catch (error) { + console.error("Error while parsing memories:", error); } - if (config?.enable_graph) { - graphPrompt = `HERE ARE THE GRAPHS RELATIONS FOR THE PREFERENCES OF THE USER:\n\n ${memoriesText2}`; + if (!memories || memories?.length === 0) { + return ""; } - }catch(e){ - console.error("Error while parsing memories"); - // console.log(e); + + return `System Message: ${systemPrompt} ${memoriesText1} ${graphPrompt}`; + } catch (error) { + console.error("Error in retrieveMemories:", error); + throw error; } - if(memories.length === 0){ - return ""; - } - return `System Message: ${systemPrompt} ${memoriesText1} ${graphPrompt}`; } -const getMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings)=>{ - const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); - let memories = []; - try{ - // @ts-ignore - memories = await searchInternalMemories(message, config); +const getMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings) => { + try { + const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); + const memories = await searchInternalMemories(message, config); + if (!config?.enable_graph) { - memories = memories.results; + return memories?.results; } + return memories; + } catch (error) { + console.error("Error in getMemories:", error); + throw error; } - catch(e){ - console.error("Error while searching memories"); - } - return memories; } -const searchMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings)=>{ - const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); - let memories = []; - try{ - // @ts-ignore - memories = await searchInternalMemories(message, config); +const searchMemories = async (prompt: LanguageModelV1Prompt | string, config?: Mem0ConfigSettings) => { + try { + const message = typeof prompt === 'string' ? prompt : flattenPrompt(prompt); + const memories = await searchInternalMemories(message, config); + return memories; + } catch (error) { + console.error("Error in searchMemories:", error); + return []; } - catch(e){ - console.error("Error while searching memories"); - } - return memories; } export {addMemories, updateMemories, retrieveMemories, flattenPrompt, searchMemories, getMemories}; \ No newline at end of file