mem0ai 1.0.2-beta → 1.0.2

package/README.md

@@ -17,8 +17,6 @@ npm install mem0ai
 
 ## 3. Instantiate Client
 
-### JavaScript
-
 ```javascript
 const MemoryClient = require('mem0ai');
 const client = new MemoryClient('your-api-key');
@@ -31,20 +29,6 @@ const MemoryClient = require('mem0ai');
 const client = new MemoryClient();
 ```
 
-### TypeScript
-
-```typescript
-import MemoryClient from 'mem0ai';
-const client = new MemoryClient('your-api-key');
-```
-
-Alternatively, you can set the `MEM0_API_KEY` environment variable and instantiate the client without passing the API key:
-
-```typescript
-import MemoryClient from 'mem0ai';
-const client = new MemoryClient();
-```
-
 ## 4. Memory Operations
 
 Mem0 provides a simple and customizable interface for performing CRUD operations on memory.
@@ -55,8 +39,6 @@ You can create long-term and short-term memories for your users, AI Agents, etc.
 
 #### Long-term memory for a user
 
-### JavaScript
-
 ```javascript
 const messages = [
   { role: "user", content: "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts." },
@@ -68,23 +50,8 @@ client.add(messages, { user_id: "alex" })
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-const messages: { role: string, content: string }[] = [
-  { role: "user", content: "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts." },
-  { role: "assistant", content: "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions." }
-];
-
-client.add(messages, { user_id: "alex" })
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 #### Short-term memory for a user session
 
-### JavaScript
-
 ```javascript
 const messages = [
   { role: "user", content: "I'm planning a trip to Japan next month." },
@@ -98,25 +65,8 @@ client.add(messages, { user_id: "alex123", session_id: "trip-planning-2024" })
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-const messages: { role: string, content: string }[] = [
-  { role: "user", content: "I'm planning a trip to Japan next month." },
-  { role: "assistant", content: "That's exciting, Alex! A trip to Japan next month sounds wonderful. Would you like some recommendations for vegetarian-friendly restaurants in Japan?" },
-  { role: "user", content: "Yes, please! Especially in Tokyo." },
-  { role: "assistant", content: "Great! I'll remember that you're interested in vegetarian restaurants in Tokyo for your upcoming trip. I'll prepare a list for you in our next interaction." }
-];
-
-client.add(messages, { user_id: "alex123", session_id: "trip-planning-2024" })
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 #### Long-term memory for agents
 
-### JavaScript
-
 ```javascript
 const messages = [
   { role: "system", content: "You are a personalized travel assistant. Remember user preferences and provide tailored recommendations." },
@@ -128,25 +78,10 @@ client.add(messages, { agent_id: "travel-assistant" })
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-const messages: { role: string, content: string }[] = [
-  { role: "system", content: "You are a personalized travel assistant. Remember user preferences and provide tailored recommendations." },
-  { role: "assistant", content: "Understood. I'll maintain personalized travel preferences for each user and provide customized recommendations based on their dietary restrictions, interests, and past interactions." }
-];
-
-client.add(messages, { agent_id: "travel-assistant" })
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 ### 4.2 Search Relevant Memories
 
 You can get related memories for a given natural language question using our search method.
 
-### JavaScript
-
 ```javascript
 const query = "What do you know about me?";
 client.search(query, { user_id: "alex" })
@@ -154,115 +89,64 @@ client.search(query, { user_id: "alex" })
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-const query: string = "What do you know about me?";
-client.search(query, { user_id: "alex" })
-  .then(results => console.log(results))
-  .catch(error => console.error(error));
-```
-
 Similarly, you can search for agent memories by passing the `agent_id` option:
 
-### JavaScript
-
 ```javascript
 client.search("What are the learnings from previous runs?", { agent_id: "travel-assistant" })
   .then(results => console.log(results))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.search("What are the learnings from previous runs?", { agent_id: "travel-assistant" })
-  .then(results => console.log(results))
-  .catch(error => console.error(error));
-```
-
 ### 4.3 Get All Memories
 
 Fetch all memories for a user, agent, or session using the getAll() method.
 
 #### Get all memories of an AI Agent
 
-### JavaScript
-
 ```javascript
 client.getAll({ agent_id: "travel-assistant" })
   .then(memories => console.log(memories))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.getAll({ agent_id: "travel-assistant" })
-  .then(memories => console.log(memories))
-  .catch(error => console.error(error));
-```
-
 #### Get all memories of a user
 
-### JavaScript
-
 ```javascript
 client.getAll({ user_id: "alex" })
   .then(memories => console.log(memories))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.getAll({ user_id: "alex" })
-  .then(memories => console.log(memories))
-  .catch(error => console.error(error));
-```
-
 #### Get short-term memories for a session
 
-### JavaScript
-
 ```javascript
 client.getAll({ user_id: "alex123", session_id: "trip-planning-2024" })
   .then(memories => console.log(memories))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.getAll({ user_id: "alex123", session_id: "trip-planning-2024" })
-  .then(memories => console.log(memories))
-  .catch(error => console.error(error));
-```
-
 #### Get specific memory
 
-### JavaScript
-
 ```javascript
 client.get("memory-id-here")
   .then(memory => console.log(memory))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
+### 4.4 Get all users
 
-```typescript
-client.get("memory-id-here")
-  .then(memory => console.log(memory))
+Get all users for which you have memories.
+
+```javascript
+client.users()
+  .then(users => console.log(users))
   .catch(error => console.error(error));
 ```
 
-### 4.4 Memory History
+### 4.5 Memory History
 
 Get history of how a memory has changed over time:
 
-### JavaScript
-
 ```javascript
 // Add some message to create history
 let messages = [{ role: "user", content: "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.." }];
@@ -281,88 +165,36 @@ client.add(messages, { user_id: "alex" })
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-// Add some message to create history
-let messages: { role: string, content: string }[] = [{ role: "user", content: "I recently tried chicken and I loved it. I'm thinking of trying more non-vegetarian dishes.." }];
-client.add(messages, { user_id: "alex" })
-  .then(result => {
-    // Add second message to update history
-    messages.push({ role: 'user', content: 'I turned vegetarian now.' });
-    return client.add(messages, { user_id: "alex" });
-  })
-  .then(result => {
-    // Get history of how memory changed over time
-    const memoryId = result.id; // Assuming the API returns the memory ID
-    return client.history(memoryId);
-  })
-  .then(history => console.log(history))
-  .catch(error => console.error(error));
-```
-
-### 4.5 Delete Memory
+### 4.6 Delete Memory
 
 Delete specific memory:
 
-### JavaScript
-
 ```javascript
 client.delete("memory-id-here")
   .then(result => console.log(result))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.delete("memory-id-here")
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 Delete all memories of a user:
 
-### JavaScript
-
 ```javascript
 client.deleteAll({ user_id: "alex" })
   .then(result => console.log(result))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.deleteAll({ user_id: "alex" })
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 Fun fact: You can also delete the memory using the `add()` method by passing a natural language command:
 
-### JavaScript
-
 ```javascript
 client.add("Delete all of my food preferences", { user_id: "alex" })
   .then(result => console.log(result))
   .catch(error => console.error(error));
 ```
 
-### TypeScript
-
-```typescript
-client.add("Delete all of my food preferences", { user_id: "alex" })
-  .then(result => console.log(result))
-  .catch(error => console.error(error));
-```
-
 ## 5. Error Handling
 
 The MemoryClient throws `APIError` for any API-related errors. You can catch and handle these errors as follows:
 
-### JavaScript
-
 ```javascript
 client.add(messages, { user_id: "alex" })
   .then(result => console.log(result))
@@ -375,26 +207,10 @@ client.add(messages, { user_id: "alex" })
   });
 ```
 
-### TypeScript
-
-```typescript
-client.add(messages, { user_id: "alex" })
-  .then(result => console.log(result))
-  .catch(error => {
-    if (error.name === 'APIError') {
-      console.error('API Error:', error.message);
-    } else {
-      console.error('Unexpected error:', error);
-    }
-  });
-```
-
 ## 6. Using with async/await
 
 All methods of the MemoryClient return promises, so you can use them with async/await:
 
-### JavaScript
-
 ```javascript
 async function addMemory() {
   try {
@@ -408,21 +224,6 @@ async function addMemory() {
 addMemory();
 ```
 
-### TypeScript
-
-```typescript
-async function addMemory() {
-  try {
-    const result = await client.add(messages, { user_id: "alex" });
-    console.log(result);
-  } catch (error) {
-    console.error('Error adding memory:', error);
-  }
-}
-
-addMemory();
-```
-
 ## Getting Help
 
 If you have any questions or need assistance, please reach out to us:
@@ -430,4 +231,4 @@ If you have any questions or need assistance, please reach out to us:
 - Email: founders@mem0.ai
 - [Join our discord community](https://mem0.ai/discord)
 - [Join our slack community](https://mem0.ai/slack)
-- GitHub Issues: [Report bugs or request features](https://github.com/mem0ai/mem0ai-node/issues)
+- GitHub Issues: [Report bugs or request features](https://github.com/mem0ai/mem0ai-node/issues)

package/examples/basic-usage.js

@@ -0,0 +1,39 @@
+const MemoryClient = require('../src/index');
+
+async function main() {
+  const apiKey = 'm0-UlqGB4SLcLgVcZ7YmYNlzHum3BxEqS0TzaYd09U0';
+  const client = new MemoryClient(apiKey);
+
+  try {
+    // Add a new memory
+    const messages = [
+        { "role": "user", "content": "Hey, I am Alex. I'm a vegetarian."},
+        {"role": "assistant", "content": "Hello Alex! I am vegetarian too!"},
+    ];
+    const addResult = await client.add(messages, { user_id: "alex" });
+    console.log('Memory added:', addResult);
+
+    // Get all memories
+    const allMemories = await client.getAll({ user_id: "alex" });
+    console.log('All memories:', allMemories);
+
+    // Search memories
+    const searchResult = await client.search('What do you know about me?', { user_id: "alex"});
+    console.log('Search results:', searchResult);
+
+    // Get all users
+    const allUsers = await client.users();
+    console.log('All users:', allUsers);
+
+    // // Delete a memory (assuming we have a memory ID from the add result)
+    if (addResult && addResult.id) {
+      const deleteResult = await client.delete(addResult.id);
+      console.log('Memory deleted:', deleteResult);
+    }
+
+  } catch (error) {
+    console.error('Error:', error.message);
+  }
+}
+
+main();

package/package.json

@@ -1,26 +1,15 @@
 {
     "name": "mem0ai",
-    "version": "1.0.2-beta",
+    "version": "1.0.2",
     "description": "The memory layer for personalized AI",
-    "main": "src/index.ts",
+    "main": "src/index.js",
     "scripts": {
-        "test": "echo \"Error: no test specified\" && exit 1"
+      "test": "echo \"Error: no test specified\" && exit 1"
     },
-    "keywords": [
-        "mem0",
-        "api",
-        "client",
-        "memory",
-        "llm",
-        "long-term-memory",
-        "ai"
-    ],
-    "author": "Team Mem0",
+    "keywords": ["mem0", "api", "client", "memory", "llm", "long-term-memory", "ai"],
+    "author": "Deshraj Yadav",
     "license": "Apache-2.0",
     "dependencies": {
-        "axios": "^1.7.3"
-    },
-    "devDependencies": {
-        "@types/node": "^22.1.0"
+      "axios": "^0.21.1"
     }
-}
+  }

package/src/index.js

@@ -0,0 +1,120 @@
+const axios = require('axios');
+
+class APIError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'APIError';
+  }
+}
+
+function apiErrorHandler(fn) {
+  return async function (...args) {
+    try {
+      return await fn.apply(this, args);
+    } catch (error) {
+      if (error.response) {
+        throw new APIError(`API request failed: ${error.response.data}`);
+      } else if (error.request) {
+        throw new APIError(`Request failed: ${error.message}`);
+      } else {
+        throw error;
+      }
+    }
+  };
+}
+
+class MemoryClient {
+  constructor(apiKey, host = 'https://api.mem0.ai/v1') {
+    this.apiKey = apiKey || process.env.MEM0_API_KEY;
+    this.host = host;
+
+    if (!this.apiKey) {
+      throw new Error('API Key not provided. Please provide an API Key.');
+    }
+
+    this.client = axios.create({
+      baseURL: this.host,
+      headers: { Authorization: `Token ${this.apiKey}` },
+      timeout: 60000,
+    });
+
+    this._validateApiKey();
+
+    // Apply error handler to methods
+    this.add = apiErrorHandler(this.add.bind(this));
+    this.get = apiErrorHandler(this.get.bind(this));
+    this.getAll = apiErrorHandler(this.getAll.bind(this));
+    this.search = apiErrorHandler(this.search.bind(this));
+    this.delete = apiErrorHandler(this.delete.bind(this));
+    this.deleteAll = apiErrorHandler(this.deleteAll.bind(this));
+    this.history = apiErrorHandler(this.history.bind(this));
+  }
+
+  async _validateApiKey() {
+    try {
+      await this.client.get('/memories/', { params: { user_id: 'test' } });
+    } catch (error) {
+      throw new Error('Invalid API Key. Please get a valid API Key from https://app.mem0.ai');
+    }
+  }
+
+  async add(messages, options = {}) {
+    const payload = this._preparePayload(messages, options);
+    const response = await this.client.post('/memories/', payload);
+    return response.data;
+  }
+
+  async get(memoryId) {
+    const response = await this.client.get(`/memories/${memoryId}/`);
+    return response.data;
+  }
+
+  async getAll(options = {}) {
+    const params = this._prepareParams(options);
+    const response = await this.client.get('/memories/', { params });
+    return response.data;
+  }
+
+  async search(query, options = {}) {
+    const payload = { query, ...options };
+    const response = await this.client.post('/memories/search/', payload);
+    return response.data;
+  }
+
+  async delete(memoryId) {
+    const response = await this.client.delete(`/memories/${memoryId}/`);
+    return response.data;
+  }
+
+  async deleteAll(options = {}) {
+    const params = this._prepareParams(options);
+    const response = await this.client.delete('/memories/', { params });
+    return response.data;
+  }
+
+  async history(memoryId) {
+    const response = await this.client.get(`/memories/${memoryId}/history/`);
+    return response.data;
+  }
+
+  async users() {
+    const response = await this.client.get('/entities/');
+    return response.data;
+  }
+
+  _preparePayload(messages, options) {
+    const payload = {};
+    if (typeof messages === 'string') {
+      payload.messages = [{ role: 'user', content: messages }];
+    } else if (Array.isArray(messages)) {
+      payload.messages = messages;
+    }
+    return { ...payload, ...options };
+  }
+
+  _prepareParams(options) {
+    return Object.fromEntries(Object.entries(options).filter(([_, v]) => v != null));
+  }
+}
+
+module.exports = MemoryClient;

package/examples/basic-usage.ts

@@ -1,40 +0,0 @@
-import MemoryClient from 'mem0ai';
-
-async function main() {
-  const client = new MemoryClient();
-
-  try {
-    // Add a new memory
-    const addResult = await client.add('This is a test memory');
-    console.log('Memory added:', addResult);
-
-    // Get all memories
-    const allMemories = await client.getAll();
-    console.log('All memories:', allMemories);
-
-    // Search memories
-    const searchResult = await client.search('test');
-    console.log('Search results:', searchResult);
-
-    // Delete a memory (assuming we have a memory ID from the add result)
-    if (addResult && addResult.id) {
-      const deleteResult = await client.delete(addResult.id);
-      console.log('Memory deleted:', deleteResult);
-    }
-
-    // Simple example from README
-    const simpleAddResult = await client.add('Simple example memory');
-    console.log('Simple memory added:', simpleAddResult);
-
-    const simpleGetResult = await client.get(simpleAddResult.id);
-    console.log('Simple memory retrieved:', simpleGetResult);
-
-    const simpleDeleteResult = await client.delete(simpleAddResult.id);
-    console.log('Simple memory deleted:', simpleDeleteResult);
-
-  } catch (error: any) {
-    console.error('Error:', error.message);
-  }
-}
-
-main();

package/src/index.ts

@@ -1,143 +0,0 @@
-import axios, { AxiosInstance, AxiosResponse } from 'axios';
-
-class APIError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'APIError';
-  }
-}
-
-function apiErrorHandler<T extends (...args: any[]) => Promise<any>>(fn: T): T {
-  return (async function (...args: any[]) {
-    try {
-      return await fn.apply(this, args);
-    } catch (error: any) {
-      if (error.response) {
-        throw new APIError(`API request failed: ${error.response.data}`);
-      } else if (error.request) {
-        throw new APIError(`Request failed: ${error.message}`);
-      } else {
-        throw error;
-      }
-    }
-  }) as T;
-}
-
-interface Message {
-  role: string;
-  content: string;
-}
-
-interface AddOptions {
-  [key: string]: any;
-}
-
-interface SearchOptions {
-  [key: string]: any;
-}
-
-interface GetAllOptions {
-  [key: string]: any;
-}
-
-interface DeleteAllOptions {
-  [key: string]: any;
-}
-
-export class MemoryClient {
-  private apiKey: string;
-  private host: string;
-  private client: AxiosInstance;
-
-  constructor(apiKey?: string, host: string = 'https://api.mem0.ai/v1') {
-    this.apiKey = apiKey || process.env.MEM0_API_KEY!;
-    this.host = host;
-
-    if (!this.apiKey) {
-      throw new Error('API Key not provided. Please provide an API Key.');
-    }
-
-    this.client = axios.create({
-      baseURL: this.host,
-      headers: { Authorization: `Token ${this.apiKey}` },
-      timeout: 60000,
-    });
-
-    this._validateApiKey();
-
-    // Apply error handler to methods
-    this.add = apiErrorHandler(this.add.bind(this));
-    this.get = apiErrorHandler(this.get.bind(this));
-    this.getAll = apiErrorHandler(this.getAll.bind(this));
-    this.search = apiErrorHandler(this.search.bind(this));
-    this.delete = apiErrorHandler(this.delete.bind(this));
-    this.deleteAll = apiErrorHandler(this.deleteAll.bind(this));
-    this.history = apiErrorHandler(this.history.bind(this));
-  }
-
-  private async _validateApiKey(): Promise<void> {
-    try {
-      await this.client.get('/memories/', { params: { user_id: 'test' } });
-    } catch (error) {
-      throw new Error('Invalid API Key. Please get a valid API Key from https://app.mem0.ai');
-    }
-  }
-
-  async add(messages: string | Message[], options: AddOptions = {}): Promise<any> {
-    const payload = this._preparePayload(messages, options);
-    const response: AxiosResponse = await this.client.post('/memories/', payload);
-    return response.data;
-  }
-
-  async get(memoryId: string): Promise<any> {
-    const response: AxiosResponse = await this.client.get(`/memories/${memoryId}/`);
-    return response.data;
-  }
-
-  async getAll(options: GetAllOptions = {}): Promise<any> {
-    const params = this._prepareParams(options);
-    const response: AxiosResponse = await this.client.get('/memories/', { params });
-    return response.data;
-  }
-
-  async search(query: string, options: SearchOptions = {}): Promise<any> {
-    const payload = { query, ...options };
-    const response: AxiosResponse = await this.client.post('/memories/search/', payload);
-    return response.data;
-  }
-
-  async delete(memoryId: string): Promise<any> {
-    const response: AxiosResponse = await this.client.delete(`/memories/${memoryId}/`);
-    return response.data;
-  }
-
-  async deleteAll(options: DeleteAllOptions = {}): Promise<any> {
-    const params = this._prepareParams(options);
-    const response: AxiosResponse = await this.client.delete('/memories/', { params });
-    return response.data;
-  }
-
-  async history(memoryId: string): Promise<any> {
-    const response: AxiosResponse = await this.client.get(`/memories/${memoryId}/history/`);
-    return response.data;
-  }
-
-  async users(): Promise<any> {
-    const response: AxiosResponse = await this.client.get('/entities/');
-    return response.data;
-  }
-
-  private _preparePayload(messages: string | Message[], options: AddOptions): any {
-    const payload: { messages?: Message[] } = {};
-    if (typeof messages === 'string') {
-      payload.messages = [{ role: 'user', content: messages }];
-    } else if (Array.isArray(messages)) {
-      payload.messages = messages;
-    }
-    return { ...payload, ...options };
-  }
-
-  private _prepareParams(options: { [key: string]: any }): { [key: string]: any } {
-    return Object.fromEntries(Object.entries(options).filter(([_, v]) => v != null));
-  }
-}