@cartisien/engram 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cartisien Interactive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# Engram
+
+> **Persistent memory for AI assistants.**
+
+```typescript
+import { Engram } from '@cartisien/engram';
+
+const memory = new Engram({ dbPath: './memory.db' });
+
+// Store
+await memory.remember('user_123', 'I ride a Triumph Bonneville', 'user');
+
+// Recall
+const context = await memory.recall('user_123', 'What motorcycle?', 5);
+// [{ role: 'user', content: 'I ride a Triumph Bonneville', ... }]
+```
+
+---
+
+## The Problem
+
+AI assistants are amnesiacs. Every conversation starts fresh. Context windows fill up. Important details get lost.
+
+You wouldn't hire an employee who forgot every meeting. Why accept it from your AI?
+
+## The Solution
+
+Engram gives your assistants **persistent, queryable memory** — backed by SQLite, designed for simplicity.
+
+- **Zero config:** Works out of the box
+- **Fast:** SQLite with proper indexes
+- **Portable:** Single file database
+- **Typed:** Full TypeScript support
+
+## Installation
+
+```bash
+npm install @cartisien/engram
+```
+
+## Quick Start
+
+```typescript
+import { Engram } from '@cartisien/engram';
+
+const memory = new Engram({
+  dbPath: './bot-memory.db'  // or ':memory:' for ephemeral
+});
+
+// In your chat handler
+async function handleChat(sessionId: string, message: string) {
+  // 1. Store the user's message
+  await memory.remember(sessionId, message, 'user');
+  
+  // 2. Retrieve relevant context
+  const context = await memory.recall(sessionId, message, 5);
+  
+  // 3. Build prompt with memory
+  const prompt = buildPrompt(context, message);
+  
+  // 4. Get AI response
+  const response = await openai.chat.completions.create({ messages: prompt });
+  
+  // 5. Store the response
+  await memory.remember(sessionId, response.choices[0].message.content, 'assistant');
+  
+  return response;
+}
+```
+
+## API
+
+### `new Engram(config?)`
+
+Create a memory instance.
+
+```typescript
+const memory = new Engram({
+  dbPath: './memory.db',        // Database file path
+  maxContextLength: 4000        // Max characters per entry
+});
+```
+
+### `remember(sessionId, content, role?, metadata?)`
+
+Store a memory entry.
+
+```typescript
+await memory.remember('session_abc', 'User loves Thai food', 'user', {
+  source: 'preference_extraction'
+});
+```
+
+### `recall(sessionId, query?, limit?, options?)`
+
+Retrieve memories for a session.
+
+```typescript
+// Recent memories
+const recent = await memory.recall('session_abc', undefined, 10);
+
+// Keyword search
+const relevant = await memory.recall('session_abc', 'food preferences', 5);
+
+// Filtered
+const userOnly = await memory.recall('session_abc', undefined, 10, { role: 'user' });
+```
+
+### `history(sessionId, limit?)`
+
+Get chronological conversation history.
+
+```typescript
+const chat = await memory.history('session_abc', 20);
+```
+
+### `forget(sessionId, options?)`
+
+Delete memories.
+
+```typescript
+// Delete all for session
+await memory.forget('session_abc');
+
+// Delete specific entry
+await memory.forget('session_abc', { id: 'entry_id' });
+
+// Delete old entries
+await memory.forget('session_abc', { before: new Date('2024-01-01') });
+```
+
+### `stats(sessionId)`
+
+Get memory statistics.
+
+```typescript
+const stats = await memory.stats('session_abc');
+// { total: 42, byRole: { user: 21, assistant: 21 }, ... }
+```
+
+## Philosophy
+
+> *"The trace precedes presence."* — Derrida
+
+Memory isn't storage. It's the substrate of self.
+
+Engram doesn't just persist data. It gives your assistants **continuity** — the ability to learn, reference, and grow across conversations. The Cartesian cogito assumed memory was given. We're making it so.
+
+## Roadmap
+
+- **v0.1** ✅ SQLite persistence, keyword search
+- **v0.2** 🚧 Semantic search with embeddings
+- **v0.3** 📋 Multi-session context, memory consolidation
+- **v0.4** 📋 Cloud sync, distributed memory
+
+## The Trilogy
+
+Engram is part of the **Cartisien Memory Suite**:
+
+| Package | Purpose |
+|---------|---------|
+| `@cartisien/engram` | **This package** — persistent memory SDK |
+| `@cartisien/extensa` | Vector infrastructure (coming soon) |
+| `@cartisien/cogito` | Identity & state management (coming soon) |
+
+*Res cogitans meets res extensa.*
+
+## License
+
+MIT © Cartisien Interactive
+
+---
+
+**Built with 🖤 by people who think forgetting is a bug.**

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+export interface MemoryEntry {
+    id: string;
+    sessionId: string;
+    content: string;
+    role: 'user' | 'assistant' | 'system';
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface RecallOptions {
+    limit?: number;
+    before?: Date;
+    after?: Date;
+    role?: 'user' | 'assistant' | 'system';
+}
+export interface EngramConfig {
+    dbPath?: string;
+    maxContextLength?: number;
+}
+/**
+ * Engram - Persistent memory for AI assistants
+ *
+ * A lightweight, SQLite-backed memory system that gives your AI assistants
+ * the ability to remember conversations across sessions.
+ *
+ * @example
+ * ```typescript
+ * import { Engram } from '@cartisien/engram';
+ *
+ * const memory = new Engram({ dbPath: './memory.db' });
+ *
+ * // Store a memory
+ * await memory.remember('user_123', 'Jeff loves Triumph motorcycles', 'user');
+ *
+ * // Retrieve relevant memories
+ * const context = await memory.recall('user_123', 'What does Jeff like?', 3);
+ * ```
+ */
+export declare class Engram {
+    private db;
+    private maxContextLength;
+    private dbPath;
+    private initialized;
+    constructor(config?: EngramConfig);
+    private init;
+    /**
+     * Store a memory entry
+     */
+    remember(sessionId: string, content: string, role?: 'user' | 'assistant' | 'system', metadata?: Record<string, unknown>): Promise<MemoryEntry>;
+    /**
+     * Recall memories for a session
+     *
+     * Simple keyword-based retrieval for v0.1.
+     * Semantic search coming in v0.2.
+     */
+    recall(sessionId: string, query?: string, limit?: number, options?: RecallOptions): Promise<MemoryEntry[]>;
+    /**
+     * Get recent conversation history for a session
+     */
+    history(sessionId: string, limit?: number): Promise<MemoryEntry[]>;
+    /**
+     * Forget (delete) memories
+     */
+    forget(sessionId: string, options?: {
+        before?: Date;
+        id?: string;
+    }): Promise<number>;
+    /**
+     * Get memory statistics for a session
+     */
+    stats(sessionId: string): Promise<{
+        total: number;
+        byRole: Record<string, number>;
+        oldest: Date | null;
+        newest: Date | null;
+    }>;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+}
+export default Engram;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,EAAE,CAAkB;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAkB;gBAEzB,MAAM,GAAE,YAAiB;YAKvB,IAAI;IAuClB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,WAAW,GAAG,QAAiB,EAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAuCvB;;;;;OAKG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC;IAiDzB;;OAEG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzB;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;KACrB,CAAC;IA+BF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Engram = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Engram - Persistent memory for AI assistants
+ *
+ * A lightweight, SQLite-backed memory system that gives your AI assistants
+ * the ability to remember conversations across sessions.
+ *
+ * @example
+ * ```typescript
+ * import { Engram } from '@cartisien/engram';
+ *
+ * const memory = new Engram({ dbPath: './memory.db' });
+ *
+ * // Store a memory
+ * await memory.remember('user_123', 'Jeff loves Triumph motorcycles', 'user');
+ *
+ * // Retrieve relevant memories
+ * const context = await memory.recall('user_123', 'What does Jeff like?', 3);
+ * ```
+ */
+class Engram {
+    db;
+    maxContextLength;
+    dbPath;
+    initialized = false;
+    constructor(config = {}) {
+        this.dbPath = config.dbPath || ':memory:';
+        this.maxContextLength = config.maxContextLength || 4000;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        const sqlite3 = require('sqlite3').verbose();
+        const { open } = require('sqlite');
+        this.db = await open({
+            filename: this.dbPath,
+            driver: sqlite3.Database
+        });
+        // Create memories table
+        await this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        content TEXT NOT NULL,
+        role TEXT CHECK(role IN ('user', 'assistant', 'system')),
+        timestamp INTEGER NOT NULL,
+        metadata TEXT,
+        content_hash TEXT NOT NULL
+      );
+    `);
+        // Create index for fast session lookups
+        await this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_session_timestamp 
+      ON memories(session_id, timestamp DESC);
+    `);
+        // Create index for content search
+        await this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_content 
+      ON memories(content);
+    `);
+        this.initialized = true;
+    }
+    /**
+     * Store a memory entry
+     */
+    async remember(sessionId, content, role = 'user', metadata) {
+        await this.init();
+        const id = (0, crypto_1.createHash)('sha256')
+            .update(`${sessionId}:${content}:${Date.now()}`)
+            .digest('hex')
+            .slice(0, 16);
+        const contentHash = (0, crypto_1.createHash)('sha256')
+            .update(content)
+            .digest('hex')
+            .slice(0, 16);
+        const entry = {
+            id,
+            sessionId,
+            content: content.slice(0, this.maxContextLength),
+            role,
+            timestamp: new Date(),
+            metadata
+        };
+        await this.db.run(`INSERT INTO memories (id, session_id, content, role, timestamp, metadata, content_hash)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            entry.id,
+            entry.sessionId,
+            entry.content,
+            entry.role,
+            entry.timestamp.getTime(),
+            metadata ? JSON.stringify(metadata) : null,
+            contentHash
+        ]);
+        return entry;
+    }
+    /**
+     * Recall memories for a session
+     *
+     * Simple keyword-based retrieval for v0.1.
+     * Semantic search coming in v0.2.
+     */
+    async recall(sessionId, query, limit = 10, options = {}) {
+        await this.init();
+        let sql = `
+      SELECT id, session_id, content, role, timestamp, metadata
+      FROM memories
+      WHERE session_id = ?
+    `;
+        const params = [sessionId];
+        if (options.role) {
+            sql += ` AND role = ?`;
+            params.push(options.role);
+        }
+        if (options.after) {
+            sql += ` AND timestamp >= ?`;
+            params.push(options.after.getTime());
+        }
+        if (options.before) {
+            sql += ` AND timestamp <= ?`;
+            params.push(options.before.getTime());
+        }
+        // Simple keyword matching if query provided
+        if (query && query.trim()) {
+            const keywords = query.toLowerCase().split(/\s+/).filter(k => k.length > 2);
+            if (keywords.length > 0) {
+                sql += ` AND (` + keywords.map(() => `LOWER(content) LIKE ?`).join(' OR ') + `)`;
+                params.push(...keywords.map(k => `%${k}%`));
+            }
+        }
+        sql += ` ORDER BY timestamp DESC LIMIT ?`;
+        params.push(limit);
+        const rows = await this.db.all(sql, params);
+        return rows.map((row) => ({
+            id: row.id,
+            sessionId: row.session_id,
+            content: row.content,
+            role: row.role,
+            timestamp: new Date(row.timestamp),
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined
+        }));
+    }
+    /**
+     * Get recent conversation history for a session
+     */
+    async history(sessionId, limit = 20) {
+        return this.recall(sessionId, undefined, limit, {});
+    }
+    /**
+     * Forget (delete) memories
+     */
+    async forget(sessionId, options) {
+        await this.init();
+        if (options?.id) {
+            const result = await this.db.run('DELETE FROM memories WHERE session_id = ? AND id = ?', [sessionId, options.id]);
+            return result.changes || 0;
+        }
+        let sql = 'DELETE FROM memories WHERE session_id = ?';
+        const params = [sessionId];
+        if (options?.before) {
+            sql += ' AND timestamp < ?';
+            params.push(options.before.getTime());
+        }
+        const result = await this.db.run(sql, params);
+        return result.changes || 0;
+    }
+    /**
+     * Get memory statistics for a session
+     */
+    async stats(sessionId) {
+        await this.init();
+        const totalRow = await this.db.get('SELECT COUNT(*) as count FROM memories WHERE session_id = ?', [sessionId]);
+        const total = totalRow?.count || 0;
+        const roleRows = await this.db.all('SELECT role, COUNT(*) as count FROM memories WHERE session_id = ? GROUP BY role', [sessionId]);
+        const byRole = {};
+        roleRows.forEach((row) => {
+            byRole[row.role] = row.count;
+        });
+        const range = await this.db.get('SELECT MIN(timestamp) as oldest, MAX(timestamp) as newest FROM memories WHERE session_id = ?', [sessionId]);
+        return {
+            total,
+            byRole,
+            oldest: range?.oldest ? new Date(range.oldest) : null,
+            newest: range?.newest ? new Date(range.newest) : null
+        };
+    }
+    /**
+     * Close the database connection
+     */
+    async close() {
+        if (this.db) {
+            await this.db.close();
+            this.initialized = false;
+        }
+    }
+}
+exports.Engram = Engram;
+exports.default = Engram;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cartisien/engram",
+  "version": "0.1.0",
+  "description": "Persistent memory for AI assistants. SQLite-backed conversational memory with semantic search.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "openai",
+    "assistant",
+    "sqlite",
+    "embeddings",
+    "conversational-memory"
+  ],
+  "author": "Cartisien Interactive",
+  "license": "MIT",
+  "dependencies": {
+    "sqlite": "^5.1.1",
+    "sqlite3": "^5.1.7"
+  },
+  "devDependencies": {
+    "@types/sqlite3": "^3.1.11",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cartisien/engram.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}