@aman_asmuei/amem 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+import { createDatabase } from "./database.js";
+import { recallMemories, MemoryType } from "./memory.js";
+import { generateEmbedding } from "./embeddings.js";
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+const AMEM_DIR = process.env.AMEM_DIR || path.join(os.homedir(), ".amem");
+const DB_PATH = process.env.AMEM_DB || path.join(AMEM_DIR, "memory.db");
+const args = process.argv.slice(2);
+const command = args[0];
+if (!command || command === "help" || command === "--help" || command === "-h") {
+    printHelp();
+    process.exit(0);
+}
+if (!fs.existsSync(DB_PATH)) {
+    console.error(`No memory database found at ${DB_PATH}`);
+    console.error("Start the Amem MCP server first, or set AMEM_DB to your database path.");
+    process.exit(1);
+}
+const db = createDatabase(DB_PATH);
+try {
+    switch (command) {
+        case "recall":
+        case "search":
+            await handleRecall(args.slice(1));
+            break;
+        case "stats":
+            handleStats();
+            break;
+        case "export":
+            handleExport(args.slice(1));
+            break;
+        case "forget":
+        case "delete":
+            handleForget(args.slice(1));
+            break;
+        case "list":
+        case "ls":
+            handleList(args.slice(1));
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+finally {
+    db.close();
+}
+function printHelp() {
+    console.log(`
+amem — The memory layer for AI coding tools
+
+USAGE
+  amem <command> [options]
+
+COMMANDS
+  recall <query>       Search memories semantically
+  stats                Show memory statistics
+  export [--file path] Export all memories as markdown
+  list [--type TYPE]   List memories, optionally filtered by type
+  forget <id>          Delete a memory by ID
+  help                 Show this help
+
+MEMORY TYPES
+  correction  Don't do X (highest priority)
+  decision    Architectural choices + rationale
+  pattern     Coding style / habits
+  preference  Tool / style preferences
+  topology    Where things are in the codebase
+  fact        General knowledge (lowest priority)
+
+EXAMPLES
+  amem recall "authentication approach"
+  amem stats
+  amem list --type correction
+  amem export --file memories.md
+  amem forget abc12345
+`.trim());
+}
+async function handleRecall(args) {
+    const query = args.join(" ");
+    if (!query) {
+        console.error("Usage: amem recall <query>");
+        process.exit(1);
+    }
+    console.log(`Searching for: "${query}"\n`);
+    const queryEmbedding = await generateEmbedding(query);
+    const results = recallMemories(db, {
+        query,
+        queryEmbedding,
+        limit: 20,
+    });
+    if (results.length === 0) {
+        console.log("No memories found.");
+        return;
+    }
+    for (const r of results) {
+        const age = formatAge(r.createdAt);
+        const conf = (r.confidence * 100).toFixed(0);
+        const typeTag = r.type.toUpperCase().padEnd(11);
+        console.log(`  ${typeTag} ${r.content}`);
+        console.log(`             Score: ${r.score.toFixed(3)} | Confidence: ${conf}% | Age: ${age} | ID: ${r.id.slice(0, 8)}`);
+        if (r.tags.length > 0) {
+            console.log(`             Tags: ${r.tags.join(", ")}`);
+        }
+        console.log();
+    }
+    console.log(`${results.length} memories found.`);
+}
+function handleStats() {
+    const stats = db.getStats();
+    const all = db.getAll();
+    console.log("Amem Memory Statistics\n");
+    console.log(`  Total memories: ${stats.total}`);
+    console.log(`  Database: ${DB_PATH}`);
+    console.log();
+    if (stats.total === 0) {
+        console.log("  No memories stored yet.");
+        return;
+    }
+    console.log("  By type:");
+    const typeOrder = ["correction", "decision", "pattern", "preference", "topology", "fact"];
+    for (const t of typeOrder) {
+        const count = stats.byType[t] || 0;
+        if (count > 0) {
+            const bar = "\u2588".repeat(Math.min(count, 40));
+            console.log(`    ${t.padEnd(12)} ${bar} ${count}`);
+        }
+    }
+    console.log();
+    // Confidence distribution
+    const highConf = all.filter(m => m.confidence >= 0.8).length;
+    const medConf = all.filter(m => m.confidence >= 0.5 && m.confidence < 0.8).length;
+    const lowConf = all.filter(m => m.confidence < 0.5).length;
+    console.log("  Confidence:");
+    console.log(`    High (\u226580%)   ${highConf}`);
+    console.log(`    Medium (50-79%) ${medConf}`);
+    console.log(`    Low (<50%)    ${lowConf}`);
+    console.log();
+    // Embedding coverage
+    const withEmbeddings = db.getAllWithEmbeddings().length;
+    console.log(`  Embeddings: ${withEmbeddings}/${stats.total} memories have embeddings`);
+    // Age stats
+    if (all.length > 0) {
+        const oldest = Math.min(...all.map(m => m.createdAt));
+        const newest = Math.max(...all.map(m => m.createdAt));
+        console.log(`  Oldest memory: ${formatAge(oldest)}`);
+        console.log(`  Newest memory: ${formatAge(newest)}`);
+    }
+}
+function handleExport(args) {
+    let outputPath = null;
+    for (let i = 0; i < args.length; i++) {
+        if ((args[i] === "--file" || args[i] === "-f") && args[i + 1]) {
+            outputPath = args[i + 1];
+            break;
+        }
+    }
+    const all = db.getAll();
+    if (all.length === 0) {
+        console.log("No memories to export.");
+        return;
+    }
+    const typeOrder = ["correction", "decision", "pattern", "preference", "topology", "fact"];
+    let md = `# Amem Memory Export\n\n`;
+    md += `*Exported: ${new Date().toISOString()}*\n`;
+    md += `*Total: ${all.length} memories*\n\n`;
+    for (const t of typeOrder) {
+        const memories = all.filter(m => m.type === t);
+        if (memories.length === 0)
+            continue;
+        md += `## ${t.charAt(0).toUpperCase() + t.slice(1)}s\n\n`;
+        for (const m of memories) {
+            const conf = (m.confidence * 100).toFixed(0);
+            const age = formatAge(m.createdAt);
+            md += `- **${m.content}**\n`;
+            md += `  Confidence: ${conf}% | Age: ${age} | Tags: [${m.tags.join(", ")}] | ID: ${m.id.slice(0, 8)}\n\n`;
+        }
+    }
+    if (outputPath) {
+        fs.writeFileSync(outputPath, md);
+        console.log(`Exported ${all.length} memories to ${outputPath}`);
+    }
+    else {
+        process.stdout.write(md);
+    }
+}
+function handleList(args) {
+    let typeFilter;
+    for (let i = 0; i < args.length; i++) {
+        if ((args[i] === "--type" || args[i] === "-t") && args[i + 1]) {
+            typeFilter = args[i + 1];
+            break;
+        }
+    }
+    let memories;
+    if (typeFilter) {
+        const validTypes = Object.values(MemoryType);
+        if (!validTypes.includes(typeFilter)) {
+            console.error(`Invalid type: ${typeFilter}. Valid types: ${validTypes.join(", ")}`);
+            process.exit(1);
+        }
+        memories = db.searchByType(typeFilter);
+    }
+    else {
+        memories = db.getAll();
+    }
+    if (memories.length === 0) {
+        console.log("No memories found.");
+        return;
+    }
+    for (const m of memories) {
+        const conf = (m.confidence * 100).toFixed(0);
+        const typeTag = m.type.toUpperCase().padEnd(11);
+        console.log(`  ${m.id.slice(0, 8)}  ${typeTag} ${m.content}  (${conf}%)`);
+    }
+    console.log(`\n${memories.length} memories.`);
+}
+function handleForget(args) {
+    const id = args[0];
+    if (!id) {
+        console.error("Usage: amem forget <memory-id>");
+        console.error("Use 'amem list' to see memory IDs.");
+        process.exit(1);
+    }
+    // Support short IDs (first 8 chars)
+    const all = db.getAll();
+    const match = all.find(m => m.id.startsWith(id));
+    if (!match) {
+        console.error(`No memory found matching ID: ${id}`);
+        process.exit(1);
+    }
+    db.deleteMemory(match.id);
+    console.log(`Deleted: "${match.content}" (${match.type})`);
+}
+function formatAge(timestamp) {
+    const ms = Date.now() - timestamp;
+    const minutes = Math.floor(ms / 60000);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 30)
+        return `${days}d ago`;
+    const months = Math.floor(days / 30);
+    return `${months}mo ago`;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,29 @@
+import type { Memory, MemoryTypeValue } from "./memory.js";
+export interface MemoryInput {
+    content: string;
+    type: MemoryTypeValue;
+    tags: string[];
+    confidence: number;
+    source: string;
+    embedding: Float32Array | null;
+}
+export interface MemoryStats {
+    total: number;
+    byType: Record<string, number>;
+}
+export interface AmemDatabase {
+    insertMemory(input: MemoryInput): string;
+    getById(id: string): Memory | null;
+    searchByType(type: MemoryTypeValue): Memory[];
+    searchByTag(tag: string): Memory[];
+    getAllWithEmbeddings(): Memory[];
+    getAll(): Memory[];
+    updateConfidence(id: string, confidence: number): void;
+    updateEmbedding(id: string, embedding: Float32Array): void;
+    touchAccess(id: string): void;
+    deleteMemory(id: string): void;
+    getStats(): MemoryStats;
+    listTables(): string[];
+    close(): void;
+}
+export declare function createDatabase(dbPath: string): AmemDatabase;

package/dist/database.js

@@ -0,0 +1,124 @@
+import Database from "better-sqlite3";
+import { randomUUID } from "node:crypto";
+function rowToMemory(row) {
+    return {
+        id: row.id,
+        content: row.content,
+        type: row.type,
+        tags: JSON.parse(row.tags),
+        confidence: row.confidence,
+        accessCount: row.access_count,
+        createdAt: row.created_at,
+        lastAccessed: row.last_accessed,
+        source: row.source,
+        embedding: row.embedding
+            ? new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4)
+            : null,
+    };
+}
+export function createDatabase(dbPath) {
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS memories (
+      id TEXT PRIMARY KEY,
+      content TEXT NOT NULL,
+      type TEXT NOT NULL,
+      tags TEXT NOT NULL DEFAULT '[]',
+      confidence REAL NOT NULL DEFAULT 1.0,
+      access_count INTEGER NOT NULL DEFAULT 0,
+      created_at INTEGER NOT NULL,
+      last_accessed INTEGER NOT NULL,
+      source TEXT NOT NULL,
+      embedding BLOB
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+    CREATE INDEX IF NOT EXISTS idx_memories_created_at ON memories(created_at);
+    CREATE INDEX IF NOT EXISTS idx_memories_confidence ON memories(confidence);
+  `);
+    const stmts = {
+        insert: db.prepare(`
+      INSERT INTO memories (id, content, type, tags, confidence, access_count, created_at, last_accessed, source, embedding)
+      VALUES (?, ?, ?, ?, ?, 0, ?, ?, ?, ?)
+    `),
+        getById: db.prepare(`SELECT * FROM memories WHERE id = ?`),
+        searchByType: db.prepare(`SELECT * FROM memories WHERE type = ? ORDER BY last_accessed DESC`),
+        searchByTag: db.prepare(`SELECT * FROM memories WHERE tags LIKE ? ORDER BY last_accessed DESC`),
+        getAllWithEmbeddings: db.prepare(`SELECT * FROM memories WHERE embedding IS NOT NULL`),
+        getAll: db.prepare(`SELECT * FROM memories ORDER BY last_accessed DESC`),
+        updateConfidence: db.prepare(`
+      UPDATE memories SET confidence = ?, access_count = access_count + 1, last_accessed = ? WHERE id = ?
+    `),
+        updateEmbedding: db.prepare(`UPDATE memories SET embedding = ? WHERE id = ?`),
+        touchAccess: db.prepare(`
+      UPDATE memories SET access_count = access_count + 1, last_accessed = ? WHERE id = ?
+    `),
+        deleteMemory: db.prepare(`DELETE FROM memories WHERE id = ?`),
+        countAll: db.prepare(`SELECT COUNT(*) as count FROM memories`),
+        countByType: db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`),
+        listTables: db.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' ORDER BY name`),
+    };
+    return {
+        insertMemory(input) {
+            const id = randomUUID();
+            const now = Date.now();
+            const embeddingBuffer = input.embedding
+                ? Buffer.from(input.embedding.buffer, input.embedding.byteOffset, input.embedding.byteLength)
+                : null;
+            stmts.insert.run(id, input.content, input.type, JSON.stringify(input.tags), input.confidence, now, now, input.source, embeddingBuffer);
+            return id;
+        },
+        getById(id) {
+            const row = stmts.getById.get(id);
+            return row ? rowToMemory(row) : null;
+        },
+        searchByType(type) {
+            const rows = stmts.searchByType.all(type);
+            return rows.map(rowToMemory);
+        },
+        searchByTag(tag) {
+            const pattern = `%"${tag}"%`;
+            const rows = stmts.searchByTag.all(pattern);
+            return rows.map(rowToMemory);
+        },
+        getAllWithEmbeddings() {
+            const rows = stmts.getAllWithEmbeddings.all();
+            return rows.map(rowToMemory);
+        },
+        getAll() {
+            const rows = stmts.getAll.all();
+            return rows.map(rowToMemory);
+        },
+        updateConfidence(id, confidence) {
+            stmts.updateConfidence.run(confidence, Date.now(), id);
+        },
+        updateEmbedding(id, embedding) {
+            const buffer = Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+            stmts.updateEmbedding.run(buffer, id);
+        },
+        touchAccess(id) {
+            stmts.touchAccess.run(Date.now(), id);
+        },
+        deleteMemory(id) {
+            stmts.deleteMemory.run(id);
+        },
+        getStats() {
+            const total = stmts.countAll.get().count;
+            const typeCounts = stmts.countByType.all();
+            const byType = {};
+            for (const row of typeCounts) {
+                byType[row.type] = row.count;
+            }
+            return { total, byType };
+        },
+        listTables() {
+            const rows = stmts.listTables.all();
+            return rows.map((r) => r.name);
+        },
+        close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8CzC,SAAS,WAAW,CAAC,GAAc;IACjC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,GAAG,CAAC,IAAuB;QACjC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAa;QACtC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACtB,CAAC,CAAC,IAAI,YAAY,CACd,GAAG,CAAC,SAAS,CAAC,MAAM,EACpB,GAAG,CAAC,SAAS,CAAC,UAAU,EACxB,GAAG,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAC7B;YACH,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;GAiBP,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;;;KAGlB,CAAC;QACF,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC;QAC1D,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,mEAAmE,CAAC;QAC7F,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC;QAC/F,oBAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC;QACtF,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC;QACxE,gBAAgB,EAAE,EAAE,CAAC,OAAO,CAAC;;KAE5B,CAAC;QACF,eAAe,EAAE,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC;QAC7E,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC;;KAEvB,CAAC;QACF,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC;QAC7D,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC;QAC9D,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,4DAA4D,CAAC;QACrF,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,mEAAmE,CAAC;KAC5F,CAAC;IAEF,OAAO;QACL,YAAY,CAAC,KAAkB;YAC7B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS;gBACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC;gBAC7F,CAAC,CAAC,IAAI,CAAC;YACT,KAAK,CAAC,MAAM,CAAC,GAAG,CACd,EAAE,EACF,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAC1B,KAAK,CAAC,UAAU,EAChB,GAAG,EACH,GAAG,EACH,KAAK,CAAC,MAAM,EACZ,eAAe,CAChB,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,EAAU;YAChB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAA0B,CAAC;YAC3D,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC,CAAC;QAED,YAAY,CAAC,IAAqB;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAgB,CAAC;YACzD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAED,WAAW,CAAC,GAAW;YACrB,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAgB,CAAC;YAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAED,oBAAoB;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,oBAAoB,CAAC,GAAG,EAAiB,CAAC;YAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM;YACJ,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAiB,CAAC;YAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAED,gBAAgB,CAAC,EAAU,EAAE,UAAkB;YAC7C,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,eAAe,CAAC,EAAU,EAAE,SAAuB;YACjD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YACzF,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,WAAW,CAAC,EAAU;YACpB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,YAAY,CAAC,EAAU;YACrB,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,QAAQ;YACN,MAAM,KAAK,GAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAwB,CAAC,KAAK,CAAC;YAChE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAuC,CAAC;YAChF,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YAC/B,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC;QAED,UAAU;YACR,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAwB,CAAC;YAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,KAAK;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/embeddings.d.ts

@@ -0,0 +1,14 @@
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+export interface EmbeddingCandidate<T> {
+    id: string;
+    embedding: Float32Array;
+    data: T;
+}
+export interface SimilarityResult<T> {
+    id: string;
+    similarity: number;
+    data: T;
+}
+export declare function findTopK<T>(query: Float32Array, candidates: EmbeddingCandidate<T>[], k: number): SimilarityResult<T>[];
+export declare function generateEmbedding(text: string): Promise<Float32Array | null>;
+export declare function isEmbeddingAvailable(): Promise<boolean>;

package/dist/embeddings.js

@@ -0,0 +1,54 @@
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+export function findTopK(query, candidates, k) {
+    const scored = candidates.map((c) => ({
+        id: c.id,
+        similarity: cosineSimilarity(query, c.embedding),
+        data: c.data,
+    }));
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, k);
+}
+let pipelineInstance = null;
+let pipelineLoading = null;
+async function getEmbeddingPipeline() {
+    if (pipelineInstance)
+        return pipelineInstance;
+    if (pipelineLoading)
+        return pipelineLoading;
+    pipelineLoading = (async () => {
+        try {
+            const mod = await import("@huggingface/transformers");
+            pipelineInstance = await mod.pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+            return pipelineInstance;
+        }
+        catch {
+            return null;
+        }
+    })();
+    return pipelineLoading;
+}
+export async function generateEmbedding(text) {
+    const extractor = await getEmbeddingPipeline();
+    if (!extractor)
+        return null;
+    const result = await extractor(text, { pooling: "mean", normalize: true });
+    return new Float32Array(result.data);
+}
+export async function isEmbeddingAvailable() {
+    const extractor = await getEmbeddingPipeline();
+    return extractor !== null;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC/D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,GAAG,GAAG,KAAK,CAAC;AACrB,CAAC;AAcD,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,UAAmC,EACnC,CAAS;IAET,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC;QAChD,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,IAAI,gBAAgB,GAAQ,IAAI,CAAC;AACjC,IAAI,eAAe,GAAwB,IAAI,CAAC;AAEhD,KAAK,UAAU,oBAAoB;IACjC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACtD,gBAAgB,GAAG,MAAM,GAAG,CAAC,QAAQ,CACnC,oBAAoB,EACpB,yBAAyB,CAC1B,CAAC;YACF,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY;IAEZ,MAAM,SAAS,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC/C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,SAAS,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC/C,OAAO,SAAS,KAAK,IAAI,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createDatabase } from "./database.js";
+import { registerTools } from "./tools.js";
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+const AMEM_DIR = process.env.AMEM_DIR || path.join(os.homedir(), ".amem");
+const DB_PATH = process.env.AMEM_DB || path.join(AMEM_DIR, "memory.db");
+fs.mkdirSync(path.dirname(DB_PATH), { recursive: true });
+const db = createDatabase(DB_PATH);
+const server = new McpServer({
+    name: "amem",
+    version: "0.1.0",
+});
+registerTools(server, db);
+// Register MCP prompts — these teach AI clients how to use Amem effectively
+server.prompt("extraction-guide", "Guidelines for what to extract from conversations into Amem memory", () => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: `You have access to Amem, a persistent memory system. Use it to remember important information across conversations.
+
+## What to Extract
+
+Watch for these during conversation and extract them using memory_extract:
+
+| Signal | Type | Confidence | Example |
+|--------|------|------------|---------|
+| User corrects you | correction | 1.0 | "Don't mock the DB in integration tests" |
+| Architecture/design choice made | decision | 0.9 | "Chose event sourcing for audit trail" |
+| User shows preferred coding style | pattern | 0.7 | "Prefers early returns over nested ifs" |
+| Tool or workflow preference expressed | preference | 0.8 | "Uses pnpm, not npm" |
+| Codebase location revealed | topology | 0.7 | "Auth module is in src/auth/" |
+| Project fact established | fact | 0.6 | "API uses REST, not GraphQL" |
+
+## When to Extract
+
+- After every ~10 exchanges
+- After any significant decision or correction
+- Before the conversation ends
+- When you notice something the user would want remembered
+
+## How to Extract
+
+Call memory_extract with an array of memories. Each memory should be:
+- **Self-contained**: Understandable without conversation context
+- **Specific**: "Uses Tailwind with custom theme" not "Has a CSS framework"
+- **Actionable**: Useful for future coding decisions
+
+## What NOT to Extract
+
+- Ephemeral task details ("currently debugging X")
+- Things obvious from the code itself
+- Sensitive data (API keys, passwords)
+- Exact file contents (just reference the path)`,
+            },
+        }],
+}));
+// Register MCP resources — proactive context that clients can read automatically
+server.resource("corrections", "amem://corrections", { mimeType: "text/plain", description: "All active corrections — hard constraints that should always be followed" }, () => {
+    const corrections = db.searchByType("correction");
+    if (corrections.length === 0) {
+        return { contents: [{ uri: "amem://corrections", mimeType: "text/plain", text: "No corrections stored." }] };
+    }
+    const text = corrections
+        .sort((a, b) => b.confidence - a.confidence)
+        .map(c => `- ${c.content} (${(c.confidence * 100).toFixed(0)}% confidence)`)
+        .join("\n");
+    return {
+        contents: [{ uri: "amem://corrections", mimeType: "text/plain", text: `# Corrections (${corrections.length})\n\n${text}` }],
+    };
+});
+server.resource("decisions", "amem://decisions", { mimeType: "text/plain", description: "Active architectural decisions and their rationale" }, () => {
+    const decisions = db.searchByType("decision");
+    if (decisions.length === 0) {
+        return { contents: [{ uri: "amem://decisions", mimeType: "text/plain", text: "No decisions stored." }] };
+    }
+    const text = decisions
+        .sort((a, b) => b.confidence - a.confidence)
+        .map(d => `- ${d.content} (${(d.confidence * 100).toFixed(0)}% confidence)`)
+        .join("\n");
+    return {
+        contents: [{ uri: "amem://decisions", mimeType: "text/plain", text: `# Decisions (${decisions.length})\n\n${text}` }],
+    };
+});
+server.resource("profile", "amem://profile", { mimeType: "text/plain", description: "Developer profile — preferences, patterns, and tool choices" }, () => {
+    const preferences = db.searchByType("preference");
+    const patterns = db.searchByType("pattern");
+    const all = [...preferences, ...patterns].sort((a, b) => b.confidence - a.confidence);
+    if (all.length === 0) {
+        return { contents: [{ uri: "amem://profile", mimeType: "text/plain", text: "No profile data stored." }] };
+    }
+    const prefText = preferences.length > 0
+        ? "## Preferences\n\n" + preferences.map(p => `- ${p.content}`).join("\n")
+        : "";
+    const patText = patterns.length > 0
+        ? "## Patterns\n\n" + patterns.map(p => `- ${p.content}`).join("\n")
+        : "";
+    return {
+        contents: [{ uri: "amem://profile", mimeType: "text/plain", text: [prefText, patText].filter(Boolean).join("\n\n") }],
+    };
+});
+server.resource("summary", "amem://summary", { mimeType: "text/plain", description: "Quick summary of all stored memories" }, () => {
+    const stats = db.getStats();
+    if (stats.total === 0) {
+        return { contents: [{ uri: "amem://summary", mimeType: "text/plain", text: "No memories stored yet." }] };
+    }
+    const typeOrder = ["correction", "decision", "pattern", "preference", "topology", "fact"];
+    const lines = typeOrder
+        .filter(t => (stats.byType[t] || 0) > 0)
+        .map(t => `  ${t}: ${stats.byType[t]}`);
+    const text = `Amem: ${stats.total} memories\n\n${lines.join("\n")}`;
+    return {
+        contents: [{ uri: "amem://summary", mimeType: "text/plain", text }],
+    };
+});
+server.prompt("session-start", "Load relevant context at the start of a conversation", () => ({
+    messages: [{
+            role: "user",
+            content: {
+                type: "text",
+                text: `You have access to Amem memory. At the start of this conversation:
+
+1. Call memory_context with the likely topic (based on what the user asks about)
+2. Use any corrections as hard constraints — they override other context
+3. Use decisions and patterns to inform your approach
+4. Mention relevant memories naturally: "I remember you prefer X" not "According to my memory database..."
+
+If the user seems to be continuing previous work, call memory_recall to find relevant history.`,
+            },
+        }],
+}));
+process.on("SIGINT", () => {
+    db.close();
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    db.close();
+    process.exit(0);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Amem running. DB: " + DB_PATH);
+//# sourceMappingURL=index.js.map