@operor/memory 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { ConversationMessage, Customer, MemoryStore } from "@operor/core";
+
+//#region src/in-memory.d.ts
+/**
+ * In-memory implementation of MemoryStore.
+ * Extracts the existing Map-based behavior from Operor core.
+ * Data is lost on restart.
+ */
+declare class InMemoryStore implements MemoryStore {
+  private customers;
+  private phoneIndex;
+  private conversations;
+  initialize(): Promise<void>;
+  getCustomer(id: string): Promise<Customer | null>;
+  getCustomerByPhone(phone: string): Promise<Customer | null>;
+  upsertCustomer(customer: Customer): Promise<void>;
+  getHistory(customerId: string, limit?: number, agentId?: string): Promise<ConversationMessage[]>;
+  addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void>;
+  clearHistory(customerId?: string, agentId?: string): Promise<{
+    deletedCount: number;
+  }>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/sqlite.d.ts
+/**
+ * SQLite-backed implementation of MemoryStore.
+ * Persists customers and conversation history to a local file.
+ */
+declare class SQLiteMemory implements MemoryStore {
+  private db;
+  constructor(dbPath?: string);
+  initialize(): Promise<void>;
+  getCustomer(id: string): Promise<Customer | null>;
+  getCustomerByPhone(phone: string): Promise<Customer | null>;
+  upsertCustomer(customer: Customer): Promise<void>;
+  getHistory(customerId: string, limit?: number, agentId?: string): Promise<ConversationMessage[]>;
+  addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void>;
+  clearHistory(customerId?: string, agentId?: string): Promise<{
+    deletedCount: number;
+  }>;
+  getSetting(key: string): Promise<string | null>;
+  setSetting(key: string, value: string | null): Promise<void>;
+  close(): Promise<void>;
+  private rowToCustomer;
+}
+//#endregion
+export { InMemoryStore, type MemoryStore, SQLiteMemory };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/in-memory.ts","../src/sqlite.ts"],"mappings":";;;;AAQA;;;;cAAa,aAAA,YAAyB,WAAA;EAAA,QAC5B,SAAA;EAAA,QACA,UAAA;EAAA,QACA,aAAA;EAEF,UAAA,CAAA,GAAc,OAAA;EAId,WAAA,CAAY,EAAA,WAAa,OAAA,CAAQ,QAAA;EAIjC,kBAAA,CAAmB,KAAA,WAAgB,OAAA,CAAQ,QAAA;EAM3C,cAAA,CAAe,QAAA,EAAU,QAAA,GAAW,OAAA;EAOpC,UAAA,CAAW,UAAA,UAAoB,KAAA,WAAY,OAAA,YAAmB,OAAA,CAAQ,mBAAA;EAMtE,UAAA,CAAW,UAAA,UAAoB,OAAA,EAAS,mBAAA,EAAqB,OAAA,YAAmB,OAAA;EAchF,YAAA,CAAa,UAAA,WAAqB,OAAA,YAAmB,OAAA;IAAU,YAAA;EAAA;EAmB/D,KAAA,CAAA,GAAS,OAAA;AAAA;;;;AAjEjB;;;cCAa,YAAA,YAAwB,WAAA;EAAA,QAC3B,EAAA;cAEI,MAAA;EAMN,UAAA,CAAA,GAAc,OAAA;EAmDd,WAAA,CAAY,EAAA,WAAa,OAAA,CAAQ,QAAA;EAKjC,kBAAA,CAAmB,KAAA,WAAgB,OAAA,CAAQ,QAAA;EAK3C,cAAA,CAAe,QAAA,EAAU,QAAA,GAAW,OAAA;EA8BpC,UAAA,CAAW,UAAA,UAAoB,KAAA,WAAY,OAAA,YAAmB,OAAA,CAAQ,mBAAA;EAetE,UAAA,CAAW,UAAA,UAAoB,OAAA,EAAS,mBAAA,EAAqB,OAAA,YAAmB,OAAA;EAahF,YAAA,CAAa,UAAA,WAAqB,OAAA,YAAmB,OAAA;IAAU,YAAA;EAAA;EAqB/D,UAAA,CAAW,GAAA,WAAc,OAAA;EAKzB,UAAA,CAAW,GAAA,UAAa,KAAA,kBAAuB,OAAA;EAQ/C,KAAA,CAAA,GAAS,OAAA;EAAA,QAIP,aAAA;AAAA"}

package/dist/index.js

@@ -0,0 +1,199 @@
+import Database from "better-sqlite3";
+
+//#region src/in-memory.ts
+/**
+* In-memory implementation of MemoryStore.
+* Extracts the existing Map-based behavior from Operor core.
+* Data is lost on restart.
+*/
+var InMemoryStore = class {
+	customers = /* @__PURE__ */ new Map();
+	phoneIndex = /* @__PURE__ */ new Map();
+	conversations = /* @__PURE__ */ new Map();
+	async initialize() {}
+	async getCustomer(id) {
+		return this.customers.get(id) || null;
+	}
+	async getCustomerByPhone(phone) {
+		const customerId = this.phoneIndex.get(phone);
+		if (!customerId) return null;
+		return this.customers.get(customerId) || null;
+	}
+	async upsertCustomer(customer) {
+		this.customers.set(customer.id, customer);
+		if (customer.phone) this.phoneIndex.set(customer.phone, customer.id);
+	}
+	async getHistory(customerId, limit = 50, agentId) {
+		const key = agentId ? `${customerId}:${agentId}` : customerId;
+		return (this.conversations.get(key) || []).slice(-limit);
+	}
+	async addMessage(customerId, message, agentId) {
+		const key = agentId ? `${customerId}:${agentId}` : customerId;
+		if (!this.conversations.has(key)) this.conversations.set(key, []);
+		const history = this.conversations.get(key);
+		history.push(message);
+		if (history.length > 50) history.splice(0, history.length - 50);
+	}
+	async clearHistory(customerId, agentId) {
+		let deletedCount = 0;
+		if (customerId) for (const [key, messages] of this.conversations) {
+			const [cid, aid] = key.includes(":") ? key.split(":") : [key, void 0];
+			if (cid === customerId && (!agentId || aid === agentId)) {
+				deletedCount += messages.length;
+				this.conversations.delete(key);
+			}
+		}
+		else {
+			for (const messages of this.conversations.values()) deletedCount += messages.length;
+			this.conversations.clear();
+		}
+		return { deletedCount };
+	}
+	async close() {
+		this.customers.clear();
+		this.phoneIndex.clear();
+		this.conversations.clear();
+	}
+};
+
+//#endregion
+//#region src/sqlite.ts
+/**
+* SQLite-backed implementation of MemoryStore.
+* Persists customers and conversation history to a local file.
+*/
+var SQLiteMemory = class {
+	db;
+	constructor(dbPath = "./operor.db") {
+		this.db = new Database(dbPath);
+		this.db.pragma("journal_mode = WAL");
+		this.db.pragma("foreign_keys = ON");
+	}
+	async initialize() {
+		this.db.exec(`
+      CREATE TABLE IF NOT EXISTS customers (
+        id TEXT PRIMARY KEY,
+        phone TEXT,
+        email TEXT,
+        name TEXT,
+        whatsapp_id TEXT,
+        instagram_id TEXT,
+        facebook_id TEXT,
+        metadata TEXT,
+        lifetime_value REAL,
+        first_interaction INTEGER,
+        last_interaction INTEGER,
+        created_at INTEGER DEFAULT (unixepoch()),
+        updated_at INTEGER DEFAULT (unixepoch())
+      );
+      CREATE INDEX IF NOT EXISTS idx_customers_phone ON customers(phone);
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        customer_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        tool_calls TEXT,
+        agent_id TEXT,
+        timestamp INTEGER NOT NULL,
+        FOREIGN KEY (customer_id) REFERENCES customers(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_customer ON messages(customer_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(customer_id, timestamp);
+    `);
+		if (!this.db.prepare("PRAGMA table_info(messages)").all().some((c) => c.name === "agent_id")) this.db.exec("ALTER TABLE messages ADD COLUMN agent_id TEXT");
+		this.db.exec("CREATE INDEX IF NOT EXISTS idx_messages_agent ON messages(customer_id, agent_id)");
+		this.db.exec(`
+      CREATE TABLE IF NOT EXISTS settings (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+	}
+	async getCustomer(id) {
+		const row = this.db.prepare("SELECT * FROM customers WHERE id = ?").get(id);
+		return row ? this.rowToCustomer(row) : null;
+	}
+	async getCustomerByPhone(phone) {
+		const row = this.db.prepare("SELECT * FROM customers WHERE phone = ?").get(phone);
+		return row ? this.rowToCustomer(row) : null;
+	}
+	async upsertCustomer(customer) {
+		this.db.prepare(`
+      INSERT INTO customers (id, phone, email, name, whatsapp_id, instagram_id, facebook_id, metadata, lifetime_value, first_interaction, last_interaction, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, unixepoch())
+      ON CONFLICT(id) DO UPDATE SET
+        phone = excluded.phone,
+        email = excluded.email,
+        name = excluded.name,
+        whatsapp_id = excluded.whatsapp_id,
+        instagram_id = excluded.instagram_id,
+        facebook_id = excluded.facebook_id,
+        metadata = excluded.metadata,
+        lifetime_value = excluded.lifetime_value,
+        last_interaction = excluded.last_interaction,
+        updated_at = unixepoch()
+    `).run(customer.id, customer.phone || null, customer.email || null, customer.name || null, customer.whatsappId || null, customer.instagramId || null, customer.facebookId || null, customer.metadata ? JSON.stringify(customer.metadata) : null, customer.lifetimeValue || null, customer.firstInteraction ? customer.firstInteraction.getTime() : null, customer.lastInteraction ? customer.lastInteraction.getTime() : null);
+	}
+	async getHistory(customerId, limit = 50, agentId) {
+		const query = agentId ? "SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? AND agent_id = ? ORDER BY timestamp DESC LIMIT ?" : "SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? ORDER BY timestamp DESC LIMIT ?";
+		const params = agentId ? [
+			customerId,
+			agentId,
+			limit
+		] : [customerId, limit];
+		return this.db.prepare(query).all(...params).reverse().map((row) => ({
+			role: row.role,
+			content: row.content,
+			timestamp: row.timestamp,
+			toolCalls: row.tool_calls ? JSON.parse(row.tool_calls) : void 0
+		}));
+	}
+	async addMessage(customerId, message, agentId) {
+		this.db.prepare("INSERT INTO messages (customer_id, role, content, tool_calls, agent_id, timestamp) VALUES (?, ?, ?, ?, ?, ?)").run(customerId, message.role, message.content, message.toolCalls ? JSON.stringify(message.toolCalls) : null, agentId || null, message.timestamp);
+	}
+	async clearHistory(customerId, agentId) {
+		let query = "DELETE FROM messages";
+		const conditions = [];
+		const params = [];
+		if (customerId) {
+			conditions.push("customer_id = ?");
+			params.push(customerId);
+		}
+		if (agentId) {
+			conditions.push("agent_id = ?");
+			params.push(agentId);
+		}
+		if (conditions.length > 0) query += " WHERE " + conditions.join(" AND ");
+		return { deletedCount: this.db.prepare(query).run(...params).changes };
+	}
+	async getSetting(key) {
+		return this.db.prepare("SELECT value FROM settings WHERE key = ?").get(key)?.value ?? null;
+	}
+	async setSetting(key, value) {
+		if (value === null) this.db.prepare("DELETE FROM settings WHERE key = ?").run(key);
+		else this.db.prepare("INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key, value);
+	}
+	async close() {
+		this.db.close();
+	}
+	rowToCustomer(row) {
+		return {
+			id: row.id,
+			phone: row.phone || void 0,
+			email: row.email || void 0,
+			name: row.name || void 0,
+			whatsappId: row.whatsapp_id || void 0,
+			instagramId: row.instagram_id || void 0,
+			facebookId: row.facebook_id || void 0,
+			metadata: row.metadata ? JSON.parse(row.metadata) : void 0,
+			lifetimeValue: row.lifetime_value || void 0,
+			firstInteraction: row.first_interaction ? new Date(row.first_interaction) : void 0,
+			lastInteraction: row.last_interaction ? new Date(row.last_interaction) : void 0
+		};
+	}
+};
+
+//#endregion
+export { InMemoryStore, SQLiteMemory };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/in-memory.ts","../src/sqlite.ts"],"sourcesContent":["import type { Customer, ConversationMessage } from '@operor/core';\nimport type { MemoryStore } from './types.js';\n\n/**\n * In-memory implementation of MemoryStore.\n * Extracts the existing Map-based behavior from Operor core.\n * Data is lost on restart.\n */\nexport class InMemoryStore implements MemoryStore {\n  private customers: Map<string, Customer> = new Map();\n  private phoneIndex: Map<string, string> = new Map(); // phone -> customerId\n  private conversations: Map<string, ConversationMessage[]> = new Map();\n\n  async initialize(): Promise<void> {\n    // Nothing to initialize for in-memory store\n  }\n\n  async getCustomer(id: string): Promise<Customer | null> {\n    return this.customers.get(id) || null;\n  }\n\n  async getCustomerByPhone(phone: string): Promise<Customer | null> {\n    const customerId = this.phoneIndex.get(phone);\n    if (!customerId) return null;\n    return this.customers.get(customerId) || null;\n  }\n\n  async upsertCustomer(customer: Customer): Promise<void> {\n    this.customers.set(customer.id, customer);\n    if (customer.phone) {\n      this.phoneIndex.set(customer.phone, customer.id);\n    }\n  }\n\n  async getHistory(customerId: string, limit = 50, agentId?: string): Promise<ConversationMessage[]> {\n    const key = agentId ? `${customerId}:${agentId}` : customerId;\n    const history = this.conversations.get(key) || [];\n    return history.slice(-limit);\n  }\n\n  async addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void> {\n    const key = agentId ? `${customerId}:${agentId}` : customerId;\n    if (!this.conversations.has(key)) {\n      this.conversations.set(key, []);\n    }\n    const history = this.conversations.get(key)!;\n    history.push(message);\n\n    // Keep only last 50 messages\n    if (history.length > 50) {\n      history.splice(0, history.length - 50);\n    }\n  }\n\n  async clearHistory(customerId?: string, agentId?: string): Promise<{ deletedCount: number }> {\n    let deletedCount = 0;\n    if (customerId) {\n      for (const [key, messages] of this.conversations) {\n        const [cid, aid] = key.includes(':') ? key.split(':') : [key, undefined];\n        if (cid === customerId && (!agentId || aid === agentId)) {\n          deletedCount += messages.length;\n          this.conversations.delete(key);\n        }\n      }\n    } else {\n      for (const messages of this.conversations.values()) {\n        deletedCount += messages.length;\n      }\n      this.conversations.clear();\n    }\n    return { deletedCount };\n  }\n\n  async close(): Promise<void> {\n    this.customers.clear();\n    this.phoneIndex.clear();\n    this.conversations.clear();\n  }\n}\n","import Database from 'better-sqlite3';\nimport type { Customer, ConversationMessage } from '@operor/core';\nimport type { MemoryStore } from './types.js';\n\n/**\n * SQLite-backed implementation of MemoryStore.\n * Persists customers and conversation history to a local file.\n */\nexport class SQLiteMemory implements MemoryStore {\n  private db: Database.Database;\n\n  constructor(dbPath: string = './operor.db') {\n    this.db = new Database(dbPath);\n    this.db.pragma('journal_mode = WAL');\n    this.db.pragma('foreign_keys = ON');\n  }\n\n  async initialize(): Promise<void> {\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS customers (\n        id TEXT PRIMARY KEY,\n        phone TEXT,\n        email TEXT,\n        name TEXT,\n        whatsapp_id TEXT,\n        instagram_id TEXT,\n        facebook_id TEXT,\n        metadata TEXT,\n        lifetime_value REAL,\n        first_interaction INTEGER,\n        last_interaction INTEGER,\n        created_at INTEGER DEFAULT (unixepoch()),\n        updated_at INTEGER DEFAULT (unixepoch())\n      );\n      CREATE INDEX IF NOT EXISTS idx_customers_phone ON customers(phone);\n\n      CREATE TABLE IF NOT EXISTS messages (\n        id INTEGER PRIMARY KEY AUTOINCREMENT,\n        customer_id TEXT NOT NULL,\n        role TEXT NOT NULL,\n        content TEXT NOT NULL,\n        tool_calls TEXT,\n        agent_id TEXT,\n        timestamp INTEGER NOT NULL,\n        FOREIGN KEY (customer_id) REFERENCES customers(id)\n      );\n      CREATE INDEX IF NOT EXISTS idx_messages_customer ON messages(customer_id);\n      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(customer_id, timestamp);\n    `);\n\n    // Migration: add agent_id column if missing (existing databases)\n    const columns = this.db.prepare(\"PRAGMA table_info(messages)\").all() as any[];\n    if (!columns.some((c: any) => c.name === 'agent_id')) {\n      this.db.exec('ALTER TABLE messages ADD COLUMN agent_id TEXT');\n    }\n\n    // Create agent_id index after migration ensures the column exists\n    this.db.exec('CREATE INDEX IF NOT EXISTS idx_messages_agent ON messages(customer_id, agent_id)');\n\n    // Settings table for key-value storage (whitelist, etc.)\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS settings (\n        key TEXT PRIMARY KEY,\n        value TEXT NOT NULL\n      );\n    `);\n  }\n\n  async getCustomer(id: string): Promise<Customer | null> {\n    const row = this.db.prepare('SELECT * FROM customers WHERE id = ?').get(id) as any;\n    return row ? this.rowToCustomer(row) : null;\n  }\n\n  async getCustomerByPhone(phone: string): Promise<Customer | null> {\n    const row = this.db.prepare('SELECT * FROM customers WHERE phone = ?').get(phone) as any;\n    return row ? this.rowToCustomer(row) : null;\n  }\n\n  async upsertCustomer(customer: Customer): Promise<void> {\n    this.db.prepare(`\n      INSERT INTO customers (id, phone, email, name, whatsapp_id, instagram_id, facebook_id, metadata, lifetime_value, first_interaction, last_interaction, updated_at)\n      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, unixepoch())\n      ON CONFLICT(id) DO UPDATE SET\n        phone = excluded.phone,\n        email = excluded.email,\n        name = excluded.name,\n        whatsapp_id = excluded.whatsapp_id,\n        instagram_id = excluded.instagram_id,\n        facebook_id = excluded.facebook_id,\n        metadata = excluded.metadata,\n        lifetime_value = excluded.lifetime_value,\n        last_interaction = excluded.last_interaction,\n        updated_at = unixepoch()\n    `).run(\n      customer.id,\n      customer.phone || null,\n      customer.email || null,\n      customer.name || null,\n      customer.whatsappId || null,\n      customer.instagramId || null,\n      customer.facebookId || null,\n      customer.metadata ? JSON.stringify(customer.metadata) : null,\n      customer.lifetimeValue || null,\n      customer.firstInteraction ? customer.firstInteraction.getTime() : null,\n      customer.lastInteraction ? customer.lastInteraction.getTime() : null,\n    );\n  }\n\n  async getHistory(customerId: string, limit = 50, agentId?: string): Promise<ConversationMessage[]> {\n    const query = agentId\n      ? 'SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? AND agent_id = ? ORDER BY timestamp DESC LIMIT ?'\n      : 'SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? ORDER BY timestamp DESC LIMIT ?';\n    const params = agentId ? [customerId, agentId, limit] : [customerId, limit];\n    const rows = this.db.prepare(query).all(...params) as any[];\n\n    return rows.reverse().map(row => ({\n      role: row.role,\n      content: row.content,\n      timestamp: row.timestamp,\n      toolCalls: row.tool_calls ? JSON.parse(row.tool_calls) : undefined,\n    }));\n  }\n\n  async addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void> {\n    this.db.prepare(\n      'INSERT INTO messages (customer_id, role, content, tool_calls, agent_id, timestamp) VALUES (?, ?, ?, ?, ?, ?)'\n    ).run(\n      customerId,\n      message.role,\n      message.content,\n      message.toolCalls ? JSON.stringify(message.toolCalls) : null,\n      agentId || null,\n      message.timestamp,\n    );\n  }\n\n  async clearHistory(customerId?: string, agentId?: string): Promise<{ deletedCount: number }> {\n    let query = 'DELETE FROM messages';\n    const conditions: string[] = [];\n    const params: any[] = [];\n\n    if (customerId) {\n      conditions.push('customer_id = ?');\n      params.push(customerId);\n    }\n    if (agentId) {\n      conditions.push('agent_id = ?');\n      params.push(agentId);\n    }\n    if (conditions.length > 0) {\n      query += ' WHERE ' + conditions.join(' AND ');\n    }\n\n    const result = this.db.prepare(query).run(...params);\n    return { deletedCount: result.changes };\n  }\n\n  async getSetting(key: string): Promise<string | null> {\n    const row = this.db.prepare('SELECT value FROM settings WHERE key = ?').get(key) as { value: string } | undefined;\n    return row?.value ?? null;\n  }\n\n  async setSetting(key: string, value: string | null): Promise<void> {\n    if (value === null) {\n      this.db.prepare('DELETE FROM settings WHERE key = ?').run(key);\n    } else {\n      this.db.prepare('INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value').run(key, value);\n    }\n  }\n\n  async close(): Promise<void> {\n    this.db.close();\n  }\n\n  private rowToCustomer(row: any): Customer {\n    return {\n      id: row.id,\n      phone: row.phone || undefined,\n      email: row.email || undefined,\n      name: row.name || undefined,\n      whatsappId: row.whatsapp_id || undefined,\n      instagramId: row.instagram_id || undefined,\n      facebookId: row.facebook_id || undefined,\n      metadata: row.metadata ? JSON.parse(row.metadata) : undefined,\n      lifetimeValue: row.lifetime_value || undefined,\n      firstInteraction: row.first_interaction ? new Date(row.first_interaction) : undefined,\n      lastInteraction: row.last_interaction ? new Date(row.last_interaction) : undefined,\n    };\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@operor/memory",
+  "version": "0.1.0",
+  "description": "Memory layer for Agent OS with SQLite and in-memory implementations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.0.0",
+    "@operor/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/in-memory.ts

@@ -0,0 +1,79 @@
+import type { Customer, ConversationMessage } from '@operor/core';
+import type { MemoryStore } from './types.js';
+
+/**
+ * In-memory implementation of MemoryStore.
+ * Extracts the existing Map-based behavior from Operor core.
+ * Data is lost on restart.
+ */
+export class InMemoryStore implements MemoryStore {
+  private customers: Map<string, Customer> = new Map();
+  private phoneIndex: Map<string, string> = new Map(); // phone -> customerId
+  private conversations: Map<string, ConversationMessage[]> = new Map();
+
+  async initialize(): Promise<void> {
+    // Nothing to initialize for in-memory store
+  }
+
+  async getCustomer(id: string): Promise<Customer | null> {
+    return this.customers.get(id) || null;
+  }
+
+  async getCustomerByPhone(phone: string): Promise<Customer | null> {
+    const customerId = this.phoneIndex.get(phone);
+    if (!customerId) return null;
+    return this.customers.get(customerId) || null;
+  }
+
+  async upsertCustomer(customer: Customer): Promise<void> {
+    this.customers.set(customer.id, customer);
+    if (customer.phone) {
+      this.phoneIndex.set(customer.phone, customer.id);
+    }
+  }
+
+  async getHistory(customerId: string, limit = 50, agentId?: string): Promise<ConversationMessage[]> {
+    const key = agentId ? `${customerId}:${agentId}` : customerId;
+    const history = this.conversations.get(key) || [];
+    return history.slice(-limit);
+  }
+
+  async addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void> {
+    const key = agentId ? `${customerId}:${agentId}` : customerId;
+    if (!this.conversations.has(key)) {
+      this.conversations.set(key, []);
+    }
+    const history = this.conversations.get(key)!;
+    history.push(message);
+
+    // Keep only last 50 messages
+    if (history.length > 50) {
+      history.splice(0, history.length - 50);
+    }
+  }
+
+  async clearHistory(customerId?: string, agentId?: string): Promise<{ deletedCount: number }> {
+    let deletedCount = 0;
+    if (customerId) {
+      for (const [key, messages] of this.conversations) {
+        const [cid, aid] = key.includes(':') ? key.split(':') : [key, undefined];
+        if (cid === customerId && (!agentId || aid === agentId)) {
+          deletedCount += messages.length;
+          this.conversations.delete(key);
+        }
+      }
+    } else {
+      for (const messages of this.conversations.values()) {
+        deletedCount += messages.length;
+      }
+      this.conversations.clear();
+    }
+    return { deletedCount };
+  }
+
+  async close(): Promise<void> {
+    this.customers.clear();
+    this.phoneIndex.clear();
+    this.conversations.clear();
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export type { MemoryStore } from './types.js';
+export { InMemoryStore } from './in-memory.js';
+export { SQLiteMemory } from './sqlite.js';

package/src/memory.test.ts

@@ -0,0 +1,243 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { InMemoryStore } from '../src/in-memory.js';
+import { SQLiteMemory } from '../src/sqlite.js';
+import type { Customer, ConversationMessage } from '@operor/core';
+import { unlinkSync } from 'fs';
+
+const testDbPath = './test-operor.db';
+
+describe('MemoryStore implementations', () => {
+  describe('InMemoryStore', () => {
+    let store: InMemoryStore;
+
+    beforeEach(async () => {
+      store = new InMemoryStore();
+      await store.initialize();
+    });
+
+    afterEach(async () => {
+      await store.close();
+    });
+
+    it('should store and retrieve customers', async () => {
+      const customer: Customer = {
+        id: 'cust_1',
+        phone: '+1234567890',
+        name: 'Test User',
+        firstInteraction: new Date(),
+        lastInteraction: new Date(),
+      };
+
+      await store.upsertCustomer(customer);
+      const retrieved = await store.getCustomer('cust_1');
+
+      expect(retrieved).toEqual(customer);
+    });
+
+    it('should retrieve customer by phone', async () => {
+      const customer: Customer = {
+        id: 'cust_2',
+        phone: '+9876543210',
+        name: 'Phone User',
+      };
+
+      await store.upsertCustomer(customer);
+      const retrieved = await store.getCustomerByPhone('+9876543210');
+
+      expect(retrieved?.id).toBe('cust_2');
+    });
+
+    it('should update existing customer', async () => {
+      const customer: Customer = {
+        id: 'cust_3',
+        phone: '+1111111111',
+        name: 'Original Name',
+      };
+
+      await store.upsertCustomer(customer);
+
+      customer.name = 'Updated Name';
+      await store.upsertCustomer(customer);
+
+      const retrieved = await store.getCustomer('cust_3');
+      expect(retrieved?.name).toBe('Updated Name');
+    });
+
+    it('should store and retrieve conversation history', async () => {
+      const customerId = 'cust_4';
+      const messages: ConversationMessage[] = [
+        { role: 'user', content: 'Hello', timestamp: Date.now() },
+        { role: 'assistant', content: 'Hi there!', timestamp: Date.now() + 1000 },
+      ];
+
+      for (const msg of messages) {
+        await store.addMessage(customerId, msg);
+      }
+
+      const history = await store.getHistory(customerId);
+      expect(history).toHaveLength(2);
+      expect(history[0].content).toBe('Hello');
+      expect(history[1].content).toBe('Hi there!');
+    });
+
+    it('should limit history to specified number', async () => {
+      const customerId = 'cust_5';
+
+      for (let i = 0; i < 10; i++) {
+        await store.addMessage(customerId, {
+          role: 'user',
+          content: `Message ${i}`,
+          timestamp: Date.now() + i,
+        });
+      }
+
+      const history = await store.getHistory(customerId, 5);
+      expect(history).toHaveLength(5);
+      expect(history[0].content).toBe('Message 5');
+    });
+  });
+
+  describe('SQLiteMemory', () => {
+    let store: SQLiteMemory;
+
+    beforeEach(async () => {
+      // Clean up any existing test database
+      try {
+        unlinkSync(testDbPath);
+      } catch {}
+
+      store = new SQLiteMemory(testDbPath);
+      await store.initialize();
+    });
+
+    afterEach(async () => {
+      await store.close();
+      try {
+        unlinkSync(testDbPath);
+      } catch {}
+    });
+
+    it('should store and retrieve customers', async () => {
+      const customer: Customer = {
+        id: 'cust_1',
+        phone: '+1234567890',
+        name: 'Test User',
+        email: 'test@example.com',
+        whatsappId: 'wa_123',
+        metadata: { source: 'test' },
+        lifetimeValue: 100.50,
+        firstInteraction: new Date(),
+        lastInteraction: new Date(),
+      };
+
+      await store.upsertCustomer(customer);
+      const retrieved = await store.getCustomer('cust_1');
+
+      expect(retrieved).toBeDefined();
+      expect(retrieved?.id).toBe('cust_1');
+      expect(retrieved?.phone).toBe('+1234567890');
+      expect(retrieved?.name).toBe('Test User');
+      expect(retrieved?.email).toBe('test@example.com');
+      expect(retrieved?.whatsappId).toBe('wa_123');
+      expect(retrieved?.metadata).toEqual({ source: 'test' });
+      expect(retrieved?.lifetimeValue).toBe(100.50);
+    });
+
+    it('should retrieve customer by phone', async () => {
+      const customer: Customer = {
+        id: 'cust_2',
+        phone: '+9876543210',
+        name: 'Phone User',
+      };
+
+      await store.upsertCustomer(customer);
+      const retrieved = await store.getCustomerByPhone('+9876543210');
+
+      expect(retrieved?.id).toBe('cust_2');
+    });
+
+    it('should update existing customer', async () => {
+      const customer: Customer = {
+        id: 'cust_3',
+        phone: '+1111111111',
+        name: 'Original Name',
+      };
+
+      await store.upsertCustomer(customer);
+
+      customer.name = 'Updated Name';
+      customer.email = 'updated@example.com';
+      await store.upsertCustomer(customer);
+
+      const retrieved = await store.getCustomer('cust_3');
+      expect(retrieved?.name).toBe('Updated Name');
+      expect(retrieved?.email).toBe('updated@example.com');
+    });
+
+    it('should store and retrieve conversation history', async () => {
+      const customerId = 'cust_4';
+      await store.upsertCustomer({ id: customerId, phone: '+4444444444' });
+
+      const messages: ConversationMessage[] = [
+        { role: 'user', content: 'Hello', timestamp: Date.now() },
+        { role: 'assistant', content: 'Hi there!', timestamp: Date.now() + 1000, toolCalls: [] },
+      ];
+
+      for (const msg of messages) {
+        await store.addMessage(customerId, msg);
+      }
+
+      const history = await store.getHistory(customerId);
+      expect(history).toHaveLength(2);
+      expect(history[0].content).toBe('Hello');
+      expect(history[1].content).toBe('Hi there!');
+    });
+
+    it('should limit history to specified number', async () => {
+      const customerId = 'cust_5';
+      await store.upsertCustomer({ id: customerId, phone: '+5555555555' });
+
+      for (let i = 0; i < 10; i++) {
+        await store.addMessage(customerId, {
+          role: 'user',
+          content: `Message ${i}`,
+          timestamp: Date.now() + i,
+        });
+      }
+
+      const history = await store.getHistory(customerId, 5);
+      expect(history).toHaveLength(5);
+      expect(history[0].content).toBe('Message 5');
+    });
+
+    it('should persist data across instances', async () => {
+      const customer: Customer = {
+        id: 'cust_persist',
+        phone: '+5555555555',
+        name: 'Persistent User',
+      };
+
+      await store.upsertCustomer(customer);
+      await store.addMessage('cust_persist', {
+        role: 'user',
+        content: 'Persistent message',
+        timestamp: Date.now(),
+      });
+
+      await store.close();
+
+      // Create new instance with same database
+      const store2 = new SQLiteMemory(testDbPath);
+      await store2.initialize();
+
+      const retrieved = await store2.getCustomer('cust_persist');
+      expect(retrieved?.name).toBe('Persistent User');
+
+      const history = await store2.getHistory('cust_persist');
+      expect(history).toHaveLength(1);
+      expect(history[0].content).toBe('Persistent message');
+
+      await store2.close();
+    });
+  });
+});

package/src/sqlite.ts

@@ -0,0 +1,190 @@
+import Database from 'better-sqlite3';
+import type { Customer, ConversationMessage } from '@operor/core';
+import type { MemoryStore } from './types.js';
+
+/**
+ * SQLite-backed implementation of MemoryStore.
+ * Persists customers and conversation history to a local file.
+ */
+export class SQLiteMemory implements MemoryStore {
+  private db: Database.Database;
+
+  constructor(dbPath: string = './operor.db') {
+    this.db = new Database(dbPath);
+    this.db.pragma('journal_mode = WAL');
+    this.db.pragma('foreign_keys = ON');
+  }
+
+  async initialize(): Promise<void> {
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS customers (
+        id TEXT PRIMARY KEY,
+        phone TEXT,
+        email TEXT,
+        name TEXT,
+        whatsapp_id TEXT,
+        instagram_id TEXT,
+        facebook_id TEXT,
+        metadata TEXT,
+        lifetime_value REAL,
+        first_interaction INTEGER,
+        last_interaction INTEGER,
+        created_at INTEGER DEFAULT (unixepoch()),
+        updated_at INTEGER DEFAULT (unixepoch())
+      );
+      CREATE INDEX IF NOT EXISTS idx_customers_phone ON customers(phone);
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        customer_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        tool_calls TEXT,
+        agent_id TEXT,
+        timestamp INTEGER NOT NULL,
+        FOREIGN KEY (customer_id) REFERENCES customers(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_customer ON messages(customer_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(customer_id, timestamp);
+    `);
+
+    // Migration: add agent_id column if missing (existing databases)
+    const columns = this.db.prepare("PRAGMA table_info(messages)").all() as any[];
+    if (!columns.some((c: any) => c.name === 'agent_id')) {
+      this.db.exec('ALTER TABLE messages ADD COLUMN agent_id TEXT');
+    }
+
+    // Create agent_id index after migration ensures the column exists
+    this.db.exec('CREATE INDEX IF NOT EXISTS idx_messages_agent ON messages(customer_id, agent_id)');
+
+    // Settings table for key-value storage (whitelist, etc.)
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS settings (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+  }
+
+  async getCustomer(id: string): Promise<Customer | null> {
+    const row = this.db.prepare('SELECT * FROM customers WHERE id = ?').get(id) as any;
+    return row ? this.rowToCustomer(row) : null;
+  }
+
+  async getCustomerByPhone(phone: string): Promise<Customer | null> {
+    const row = this.db.prepare('SELECT * FROM customers WHERE phone = ?').get(phone) as any;
+    return row ? this.rowToCustomer(row) : null;
+  }
+
+  async upsertCustomer(customer: Customer): Promise<void> {
+    this.db.prepare(`
+      INSERT INTO customers (id, phone, email, name, whatsapp_id, instagram_id, facebook_id, metadata, lifetime_value, first_interaction, last_interaction, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, unixepoch())
+      ON CONFLICT(id) DO UPDATE SET
+        phone = excluded.phone,
+        email = excluded.email,
+        name = excluded.name,
+        whatsapp_id = excluded.whatsapp_id,
+        instagram_id = excluded.instagram_id,
+        facebook_id = excluded.facebook_id,
+        metadata = excluded.metadata,
+        lifetime_value = excluded.lifetime_value,
+        last_interaction = excluded.last_interaction,
+        updated_at = unixepoch()
+    `).run(
+      customer.id,
+      customer.phone || null,
+      customer.email || null,
+      customer.name || null,
+      customer.whatsappId || null,
+      customer.instagramId || null,
+      customer.facebookId || null,
+      customer.metadata ? JSON.stringify(customer.metadata) : null,
+      customer.lifetimeValue || null,
+      customer.firstInteraction ? customer.firstInteraction.getTime() : null,
+      customer.lastInteraction ? customer.lastInteraction.getTime() : null,
+    );
+  }
+
+  async getHistory(customerId: string, limit = 50, agentId?: string): Promise<ConversationMessage[]> {
+    const query = agentId
+      ? 'SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? AND agent_id = ? ORDER BY timestamp DESC LIMIT ?'
+      : 'SELECT role, content, tool_calls, timestamp FROM messages WHERE customer_id = ? ORDER BY timestamp DESC LIMIT ?';
+    const params = agentId ? [customerId, agentId, limit] : [customerId, limit];
+    const rows = this.db.prepare(query).all(...params) as any[];
+
+    return rows.reverse().map(row => ({
+      role: row.role,
+      content: row.content,
+      timestamp: row.timestamp,
+      toolCalls: row.tool_calls ? JSON.parse(row.tool_calls) : undefined,
+    }));
+  }
+
+  async addMessage(customerId: string, message: ConversationMessage, agentId?: string): Promise<void> {
+    this.db.prepare(
+      'INSERT INTO messages (customer_id, role, content, tool_calls, agent_id, timestamp) VALUES (?, ?, ?, ?, ?, ?)'
+    ).run(
+      customerId,
+      message.role,
+      message.content,
+      message.toolCalls ? JSON.stringify(message.toolCalls) : null,
+      agentId || null,
+      message.timestamp,
+    );
+  }
+
+  async clearHistory(customerId?: string, agentId?: string): Promise<{ deletedCount: number }> {
+    let query = 'DELETE FROM messages';
+    const conditions: string[] = [];
+    const params: any[] = [];
+
+    if (customerId) {
+      conditions.push('customer_id = ?');
+      params.push(customerId);
+    }
+    if (agentId) {
+      conditions.push('agent_id = ?');
+      params.push(agentId);
+    }
+    if (conditions.length > 0) {
+      query += ' WHERE ' + conditions.join(' AND ');
+    }
+
+    const result = this.db.prepare(query).run(...params);
+    return { deletedCount: result.changes };
+  }
+
+  async getSetting(key: string): Promise<string | null> {
+    const row = this.db.prepare('SELECT value FROM settings WHERE key = ?').get(key) as { value: string } | undefined;
+    return row?.value ?? null;
+  }
+
+  async setSetting(key: string, value: string | null): Promise<void> {
+    if (value === null) {
+      this.db.prepare('DELETE FROM settings WHERE key = ?').run(key);
+    } else {
+      this.db.prepare('INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value').run(key, value);
+    }
+  }
+
+  async close(): Promise<void> {
+    this.db.close();
+  }
+
+  private rowToCustomer(row: any): Customer {
+    return {
+      id: row.id,
+      phone: row.phone || undefined,
+      email: row.email || undefined,
+      name: row.name || undefined,
+      whatsappId: row.whatsapp_id || undefined,
+      instagramId: row.instagram_id || undefined,
+      facebookId: row.facebook_id || undefined,
+      metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+      lifetimeValue: row.lifetime_value || undefined,
+      firstInteraction: row.first_interaction ? new Date(row.first_interaction) : undefined,
+      lastInteraction: row.last_interaction ? new Date(row.last_interaction) : undefined,
+    };
+  }
+}

package/src/types.ts

@@ -0,0 +1,2 @@
+// Re-export MemoryStore interface from core to avoid duplication
+export type { MemoryStore } from '@operor/core';

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  outExtensions: () => ({ js: '.js', dts: '.d.ts' }),
+});