@bip-krishna/agentmind 0.1.0

package/dist/cli/src/index.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+import { Memory } from "../../packages/core/src/memory.js";
+import { SqliteMemoryStore } from "../../packages/storage/src/sqlite-store.js";
+import { LocalEmbeddingProvider } from "../../packages/embeddings/src/local.js";
+import * as fs from "node:fs";
+const DB_PATH = process.env.AGENTMIND_DB ?? process.env.CTX_MEMORY_DB ?? "./.agentmind/memory.db";
+const store = new SqliteMemoryStore({ path: DB_PATH });
+const embed = new LocalEmbeddingProvider();
+const [, , cmd, ...args] = process.argv;
+function help() {
+    console.log(`
+agentmind (formerly context-memory)
+
+Usage:
+  agentmind init [--project <name>]
+  agentmind project list
+  agentmind project create <name>
+  agentmind project delete <name>
+  agentmind memory list --project <name> [--type <type>] [--limit <n>]
+  agentmind memory search --project <name> --query "text" [--limit 5]
+  agentmind memory show <id>
+  agentmind memory delete <id>
+  agentmind memory consolidate --project <name>
+  agentmind ingest --project <name> --content "text" [--role user]
+  agentmind export --project <name> [--include-archived]
+  agentmind dashboard [--port 4317]
+
+Aliases: context-memory (legacy)
+`);
+}
+async function main() {
+    if (!cmd || cmd === "help" || cmd === "--help")
+        return help();
+    if (cmd === "init") {
+        fs.mkdirSync("./.agentmind", { recursive: true });
+        // legacy compat
+        if (!fs.existsSync("./.context-memory"))
+            fs.mkdirSync("./.context-memory", { recursive: true });
+        console.log("Initialized .agentmind/");
+        console.log(`DB: ${DB_PATH}`);
+        const pIdx = args.indexOf("--project");
+        if (pIdx !== -1) {
+            const name = args[pIdx + 1];
+            const mem = await Memory.create({ project: name, store });
+            console.log(`Project: ${mem.project.name} (${mem.project.id})`);
+        }
+        return;
+    }
+    if (cmd === "project") {
+        const sub = args[0];
+        if (sub === "list") {
+            const projects = await store.listProjects();
+            console.log(JSON.stringify(projects, null, 2));
+            return;
+        }
+        if (sub === "create") {
+            const name = args[1];
+            if (!name)
+                throw new Error("name required");
+            const mem = await Memory.create({ project: name, store });
+            console.log(`Created project: ${mem.project.name} (${mem.project.id})`);
+            return;
+        }
+        if (sub === "delete") {
+            const name = args[1];
+            if (!name)
+                throw new Error("name required");
+            const proj = await store.getProjectByName(name) ?? await store.getProject(name);
+            if (!proj)
+                throw new Error("not found");
+            await store.deleteProject(proj.id);
+            console.log(`Deleted ${name}`);
+            return;
+        }
+    }
+    if (cmd === "memory") {
+        const sub = args[0];
+        if (sub === "list") {
+            const pIdx = args.indexOf("--project");
+            const project = pIdx !== -1 ? args[pIdx + 1] : null;
+            if (!project)
+                throw new Error("--project required");
+            const mem = await Memory.create({ project, store });
+            const exported = await mem.export();
+            console.log(JSON.stringify(exported.memories, null, 2));
+            return;
+        }
+        if (sub === "search") {
+            const pIdx = args.indexOf("--project");
+            const qIdx = args.indexOf("--query");
+            const lIdx = args.indexOf("--limit");
+            const project = pIdx !== -1 ? args[pIdx + 1] : null;
+            const query = qIdx !== -1 ? args[qIdx + 1] : null;
+            const limit = lIdx !== -1 ? Number(args[lIdx + 1]) : 5;
+            if (!project || !query)
+                throw new Error("--project and --query required");
+            const mem = await Memory.create({ project, store, embeddingProvider: embed });
+            const results = await mem.search(query, { limit });
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        if (sub === "consolidate") {
+            const pIdx = args.indexOf("--project");
+            const project = pIdx !== -1 ? args[pIdx + 1] : null;
+            if (!project)
+                throw new Error("--project required");
+            const mem = await Memory.create({ project, store, embeddingProvider: embed });
+            const results = await mem.consolidate();
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        if (sub === "show") {
+            const id = args[1];
+            const m = await store.getMemory(id);
+            console.log(JSON.stringify(m, null, 2));
+            return;
+        }
+        if (sub === "delete") {
+            const id = args[1];
+            await store.deleteMemory(id);
+            console.log(`Deleted ${id}`);
+            return;
+        }
+    }
+    if (cmd === "ingest") {
+        const pIdx = args.indexOf("--project");
+        const cIdx = args.indexOf("--content");
+        const rIdx = args.indexOf("--role");
+        const project = pIdx !== -1 ? args[pIdx + 1] : null;
+        const content = cIdx !== -1 ? args[cIdx + 1] : null;
+        const role = rIdx !== -1 ? args[rIdx + 1] : "user";
+        if (!project || !content)
+            throw new Error("--project and --content required");
+        const mem = await Memory.create({ project, store });
+        const res = await mem.ingest({ role, content });
+        console.log(JSON.stringify(res, null, 2));
+        return;
+    }
+    if (cmd === "export") {
+        const pIdx = args.indexOf("--project");
+        const project = pIdx !== -1 ? args[pIdx + 1] : null;
+        if (!project)
+            throw new Error("--project required");
+        const includeArchived = args.includes("--include-archived");
+        const mem = await Memory.create({ project, store });
+        const data = await mem.export({ includeArchived });
+        const out = `${project}.export.json`;
+        fs.writeFileSync(out, JSON.stringify(data, null, 2));
+        console.log(`Exported to ${out} (${data.memories.length} memories)`);
+        return;
+    }
+    if (cmd === "dashboard") {
+        const pIdx = args.indexOf("--port");
+        const port = pIdx !== -1 ? args[pIdx + 1] : "4317";
+        process.env.PORT = port;
+        await import("../../apps/dashboard/src/server.js");
+        return;
+    }
+    help();
+}
+main().catch(e => { console.error(e.message); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/cli/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../cli/src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wBAAwB,CAAC;AAClG,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACvD,MAAM,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;AAE3C,MAAM,CAAC,EAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAEvC,SAAS,IAAI;IACX,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;CAkBb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,EAAE,CAAC;IAE9D,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,gBAAgB;QAChB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAChF,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;YACxC,MAAM,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAClD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAClD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,GAAG,OAAO,cAAc,CAAC;QACrC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,EAAE,CAAC;AACT,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/examples/advanced.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=advanced.d.ts.map

package/dist/examples/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../examples/advanced.ts"],"names":[],"mappings":""}

package/dist/examples/advanced.js

@@ -0,0 +1,41 @@
+import { Memory } from "../packages/core/src/memory.js";
+import { InMemoryStore } from "../packages/storage/src/memory-store.js";
+import { LocalEmbeddingProvider } from "../packages/embeddings/src/local.js";
+import { HeuristicExtractor } from "../packages/core/src/extraction.js";
+// Policy + autoExtract + observability + consolidation demo
+const store = new InMemoryStore();
+const memory = await Memory.create({
+    project: "research-mesh",
+    store,
+    embeddingProvider: new LocalEmbeddingProvider(),
+    extractor: new HeuristicExtractor(),
+    policy: {
+        autoExtract: true,
+        minimumImportance: 0.6,
+        maxMemoriesPerProject: 10000,
+        storeSensitiveData: false,
+    },
+});
+memory.on("memory.created", (m) => console.log("[event] created:", m.content.slice(0, 40)));
+memory.on("retrieval.completed", (e) => console.log("[event] retrieval:", e.query, "->", e.retrievedMemoryIds.length));
+// Ingest conversation — auto-extracts memories
+await memory.ingest({ role: "user", content: "We decided to use PostgreSQL with pgvector. SQLite isn't going to work for production because we need concurrent writes. Let's proceed with that." });
+const ctx = await memory.context({ query: "What database did we decide to use?", maxTokens: 6000 });
+console.log(ctx.text);
+// Consolidation
+for (let i = 0; i < 5; i++)
+    await memory.remember({ content: `Payment gateway timeout on API-4821 occurrence ${i}`, importance: 0.6 });
+const consolidated = await memory.consolidate({ threshold: 0.5, minClusterSize: 3 });
+console.log("Consolidated:", consolidated.length);
+// OpenAI integration example (pseudo)
+/*
+import { withMemory, createOpenAICaller } from "@agentmind/integrations/openai";
+import OpenAI from "openai";
+const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+const { response } = await withMemory({
+  memory,
+  messages: [{ role: "user", content: "What's our DB?" }],
+  callLLM: createOpenAICaller(openai, "gpt-4o"),
+});
+*/
+//# sourceMappingURL=advanced.js.map

package/dist/examples/advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.js","sourceRoot":"","sources":["../../examples/advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,4DAA4D;AAE5D,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;AAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,eAAe;IACxB,KAAK;IACL,iBAAiB,EAAE,IAAI,sBAAsB,EAAE;IAC/C,SAAS,EAAE,IAAI,kBAAkB,EAAE;IACnC,MAAM,EAAE;QACN,WAAW,EAAE,IAAI;QACjB,iBAAiB,EAAE,GAAG;QACtB,qBAAqB,EAAE,KAAK;QAC5B,kBAAkB,EAAE,KAAK;KAC1B;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACjG,MAAM,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5H,+CAA+C;AAC/C,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mJAAmJ,EAAE,CAAC,CAAC;AAEpM,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAEtB,gBAAgB;AAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;IAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,kDAAkD,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;AACvI,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;AACrF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;AAElD,sCAAsC;AACtC;;;;;;;;;EASE"}

package/dist/examples/basic.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=basic.d.ts.map

package/dist/examples/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../examples/basic.ts"],"names":[],"mappings":""}

package/dist/examples/basic.js

@@ -0,0 +1,22 @@
+import { Memory } from "../packages/core/src/memory.js";
+import { InMemoryStore } from "../packages/storage/src/memory-store.js";
+import { LocalEmbeddingProvider } from "../packages/embeddings/src/local.js";
+const store = new InMemoryStore();
+const memory = await Memory.create({
+    project: "research-mesh",
+    store,
+    embeddingProvider: new LocalEmbeddingProvider(),
+});
+await memory.remember({
+    type: "decision",
+    content: "We decided to use PostgreSQL with pgvector.",
+    importance: 0.9,
+});
+const context = await memory.context({
+    query: "What database did we decide to use?",
+    maxTokens: 6000,
+});
+console.log(context.text);
+// Relevant project memory (research-mesh):
+// - We decided to use PostgreSQL with pgvector.
+//# sourceMappingURL=basic.js.map

package/dist/examples/basic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.js","sourceRoot":"","sources":["../../examples/basic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;AAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,eAAe;IACxB,KAAK;IACL,iBAAiB,EAAE,IAAI,sBAAsB,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,6CAA6C;IACtD,UAAU,EAAE,GAAG;CAChB,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,qCAAqC;IAC5C,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1B,2CAA2C;AAC3C,gDAAgD"}

package/dist/packages/core/src/consolidation.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryStore } from "./memory-store.js";
+import type { Memory } from "./types.js";
+import type { EmbeddingProvider } from "../../embeddings/src/provider.js";
+/**
+ * Memory consolidation: 1000 memories -> 150 useful memories.
+ * Keeps originals as archived, creates summary memories.
+ * Uses embedding similarity to cluster, then heuristic summary.
+ */
+export interface ConsolidationResult {
+    summary: Memory;
+    sourceIds: string[];
+}
+export declare class Consolidator {
+    private store;
+    private embed?;
+    constructor(store: MemoryStore, embed?: EmbeddingProvider | undefined);
+    /**
+     * Consolidate a project. Groups memories with cosine > threshold (0.82) and creates summaries.
+     * Returns summaries created.
+     */
+    consolidate(projectId: string, opts?: {
+        threshold?: number;
+        minClusterSize?: number;
+    }): Promise<ConsolidationResult[]>;
+    private summarizeCluster;
+}
+//# sourceMappingURL=consolidation.d.ts.map

package/dist/packages/core/src/consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/consolidation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG1E;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,KAAK;IAAe,OAAO,CAAC,KAAK,CAAC;gBAAlC,KAAK,EAAE,WAAW,EAAU,KAAK,CAAC,EAAE,iBAAiB,YAAA;IAEzE;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAuE5H,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/packages/core/src/consolidation.js

@@ -0,0 +1,97 @@
+import { randomUUID } from "node:crypto";
+import { cosineSimilarity } from "../../embeddings/src/provider.js";
+export class Consolidator {
+    store;
+    embed;
+    constructor(store, embed) {
+        this.store = store;
+        this.embed = embed;
+    }
+    /**
+     * Consolidate a project. Groups memories with cosine > threshold (0.82) and creates summaries.
+     * Returns summaries created.
+     */
+    async consolidate(projectId, opts) {
+        const threshold = opts?.threshold ?? 0.82;
+        const minClusterSize = opts?.minClusterSize ?? 3;
+        const memories = (await this.store.listMemories(projectId)).filter((m) => !m.archived && m.status === "active");
+        if (memories.length < minClusterSize)
+            return [];
+        // Build embedding map
+        const vectors = new Map();
+        for (const m of memories) {
+            const emb = await this.store.getEmbedding(m.id);
+            if (emb)
+                vectors.set(m.id, emb.vector);
+            else if (this.embed) {
+                const v = await this.embed.embed(m.content);
+                vectors.set(m.id, v);
+            }
+        }
+        // Greedy clustering
+        const clusters = [];
+        const visited = new Set();
+        for (const m of memories) {
+            if (visited.has(m.id))
+                continue;
+            const cluster = [m.id];
+            visited.add(m.id);
+            const vecA = vectors.get(m.id);
+            if (!vecA)
+                continue;
+            for (const other of memories) {
+                if (visited.has(other.id))
+                    continue;
+                const vecB = vectors.get(other.id);
+                if (!vecB)
+                    continue;
+                if (cosineSimilarity(vecA, vecB) > threshold) {
+                    cluster.push(other.id);
+                    visited.add(other.id);
+                }
+            }
+            if (cluster.length >= minClusterSize)
+                clusters.push(cluster);
+        }
+        const results = [];
+        for (const cluster of clusters) {
+            const sourceMems = cluster.map((id) => memories.find((m) => m.id === id)).filter(Boolean);
+            const summaryContent = this.summarizeCluster(sourceMems);
+            const now = new Date();
+            const summary = {
+                id: randomUUID(),
+                projectId,
+                type: "summary",
+                content: summaryContent,
+                importance: Math.max(...sourceMems.map((m) => m.importance)),
+                confidence: 0.85,
+                status: "active",
+                createdAt: now,
+                updatedAt: now,
+                accessCount: 0,
+                metadata: { consolidatedFrom: cluster, count: cluster.length },
+                archived: false,
+            };
+            await this.store.createMemory(summary);
+            if (this.embed) {
+                const vec = await this.embed.embed(summaryContent);
+                await this.store.upsertEmbedding(summary.id, vec, this.embed.model);
+            }
+            // Archive sources but keep traceable
+            for (const id of cluster) {
+                await this.store.updateMemory(id, { archived: true, status: "archived", updatedAt: now });
+            }
+            results.push({ summary, sourceIds: cluster });
+        }
+        return results;
+    }
+    summarizeCluster(mems) {
+        // Simple heuristic: most important + common prefix extraction
+        const byImp = [...mems].sort((a, b) => b.importance - a.importance);
+        const top = byImp[0].content;
+        const count = mems.length;
+        const types = [...new Set(mems.map((m) => m.type))].join(", ");
+        return `Consolidated ${count} memories (${types}): ${top} (and ${count - 1} related memories about similar topic)`;
+    }
+}
+//# sourceMappingURL=consolidation.js.map

package/dist/packages/core/src/consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.js","sourceRoot":"","sources":["../../../../packages/core/src/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAapE,MAAM,OAAO,YAAY;IACH;IAA4B;IAAhD,YAAoB,KAAkB,EAAU,KAAyB;QAArD,UAAK,GAAL,KAAK,CAAa;QAAU,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAE7E;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,IAAsD;QACzF,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC;QAC1C,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,IAAI,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QAChH,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAc;YAAE,OAAO,EAAE,CAAC;QAEhD,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,GAAG;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;iBAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACpB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAe,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,SAAS;YAChC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAE,SAAS;gBACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3F,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAW;gBACtB,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS;gBACT,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,cAAc;gBACvB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBAC5D,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC9D,QAAQ,EAAE,KAAK;aAChB,CAAC;YACF,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtE,CAAC;YACD,qCAAqC;YACrC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5F,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,gBAAgB,CAAC,IAAc;QACrC,8DAA8D;QAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,gBAAgB,KAAK,cAAc,KAAK,MAAM,GAAG,SAAS,KAAK,GAAG,CAAC,wCAAwC,CAAC;IACrH,CAAC;CACF"}

package/dist/packages/core/src/events.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from "node:events";
+import type { Memory, RetrievalEvent } from "./types.js";
+export type MemoryEventMap = {
+    "memory.created": (memory: Memory) => void;
+    "memory.updated": (memory: Memory) => void;
+    "memory.deleted": (id: string) => void;
+    "memory.retrieved": (memories: Memory[], query: string) => void;
+    "memory.archived": (memory: Memory) => void;
+    "memory.superseded": (old: Memory, next: Memory) => void;
+    "retrieval.completed": (event: RetrievalEvent) => void;
+    "consolidation.completed": (summary: Memory, sources: string[]) => void;
+};
+export declare class MemoryEvents extends EventEmitter {
+    emit<K extends keyof MemoryEventMap>(event: K, ...args: Parameters<MemoryEventMap[K]>): boolean;
+    on<K extends keyof MemoryEventMap>(event: K, listener: MemoryEventMap[K]): this;
+    off<K extends keyof MemoryEventMap>(event: K, listener: MemoryEventMap[K]): this;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/packages/core/src/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG;IAC3B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,qBAAqB,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,yBAAyB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,qBAAa,YAAa,SAAQ,YAAY;IAC5C,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAG/F,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAG/E,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;CAGjF"}

package/dist/packages/core/src/events.js

@@ -0,0 +1,13 @@
+import { EventEmitter } from "node:events";
+export class MemoryEvents extends EventEmitter {
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/packages/core/src/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../packages/core/src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC5C,IAAI,CAAiC,KAAQ,EAAE,GAAG,IAAmC;QACnF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,EAAE,CAAiC,KAAQ,EAAE,QAA2B;QACtE,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAiC,KAAQ,EAAE,QAA2B;QACvE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/packages/core/src/extraction.d.ts

@@ -0,0 +1,32 @@
+import type { MemoryType } from "./types.js";
+export interface ExtractedMemory {
+    type: MemoryType;
+    content: string;
+    importance: number;
+    confidence: number;
+}
+export interface ExtractorOptions {
+    minimumImportance?: number;
+}
+export interface ExtractorProvider {
+    extract(conversation: string, opts?: ExtractorOptions): Promise<ExtractedMemory[]>;
+}
+/** Prompt template for LLM extraction */
+export declare const EXTRACTION_PROMPT = "Extract only information that is likely to remain useful in future interactions.\n\nDo not store:\n- greetings\n- temporary conversation\n- obvious information\n- filler\n- transient thoughts\n- sensitive information unless explicitly configured\n\nReturn JSON array of {type, content, importance, confidence} where type is one of: fact, preference, decision, event, knowledge, procedure, task, summary.\nImportance 0-1, confidence 0-1. Content must be a concise standalone statement.\n\nConversation:\n{{conversation}}\n";
+/**
+ * Deterministic regex-based extractor for offline / tests.
+ * Real provider would call OpenAI / Anthropic with structured output.
+ */
+export declare class HeuristicExtractor implements ExtractorProvider {
+    extract(conversation: string): Promise<ExtractedMemory[]>;
+}
+/**
+ * LLM-backed extractor (generic). Provide a chat completion function.
+ */
+export declare class LLMExtractor implements ExtractorProvider {
+    private callLLM;
+    private minImportance;
+    constructor(callLLM: (prompt: string) => Promise<string>, minImportance?: number);
+    extract(conversation: string, opts?: ExtractorOptions): Promise<ExtractedMemory[]>;
+}
+//# sourceMappingURL=extraction.d.ts.map

package/dist/packages/core/src/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/extraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACpF;AAED,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,8gBAe7B,CAAC;AAEF;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IACpD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAkBhE;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,iBAAiB;IAElD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,aAAa;gBADb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5C,aAAa,SAAO;IAGxB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAWzF"}

package/dist/packages/core/src/extraction.js

@@ -0,0 +1,65 @@
+/** Prompt template for LLM extraction */
+export const EXTRACTION_PROMPT = `Extract only information that is likely to remain useful in future interactions.
+
+Do not store:
+- greetings
+- temporary conversation
+- obvious information
+- filler
+- transient thoughts
+- sensitive information unless explicitly configured
+
+Return JSON array of {type, content, importance, confidence} where type is one of: fact, preference, decision, event, knowledge, procedure, task, summary.
+Importance 0-1, confidence 0-1. Content must be a concise standalone statement.
+
+Conversation:
+{{conversation}}
+`;
+/**
+ * Deterministic regex-based extractor for offline / tests.
+ * Real provider would call OpenAI / Anthropic with structured output.
+ */
+export class HeuristicExtractor {
+    async extract(conversation) {
+        const results = [];
+        const sentences = conversation.split(/[.!?]+/).map((s) => s.trim()).filter(Boolean);
+        const keywords = ["decided", "will use", "using", "prefer", "need", "should", "must", "database", "postgres", "mongodb", "api", "always", "never"];
+        for (const s of sentences) {
+            const lower = s.toLowerCase();
+            if (keywords.some((k) => lower.includes(k)) && s.length > 20 && s.length < 300) {
+                const type = lower.includes("decided") || lower.includes("will use") ? "decision" : lower.includes("prefer") ? "preference" : "fact";
+                results.push({
+                    type,
+                    content: s + ".",
+                    importance: lower.includes("decided") ? 0.9 : 0.6,
+                    confidence: 0.8,
+                });
+            }
+        }
+        return results;
+    }
+}
+/**
+ * LLM-backed extractor (generic). Provide a chat completion function.
+ */
+export class LLMExtractor {
+    callLLM;
+    minImportance;
+    constructor(callLLM, minImportance = 0.65) {
+        this.callLLM = callLLM;
+        this.minImportance = minImportance;
+    }
+    async extract(conversation, opts) {
+        const prompt = EXTRACTION_PROMPT.replace("{{conversation}}", conversation);
+        const raw = await this.callLLM(prompt);
+        try {
+            const parsed = JSON.parse(raw);
+            const threshold = opts?.minimumImportance ?? this.minImportance;
+            return parsed.filter((m) => m.importance >= threshold);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=extraction.js.map

package/dist/packages/core/src/extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.js","sourceRoot":"","sources":["../../../../packages/core/src/extraction.ts"],"names":[],"mappings":"AAiBA,yCAAyC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;CAehC,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,OAAO,CAAC,YAAoB;QAChC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpF,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnJ,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC/E,MAAM,IAAI,GAAe,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;gBACjJ,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,OAAO,EAAE,CAAC,GAAG,GAAG;oBAChB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;oBACjD,UAAU,EAAE,GAAG;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAEb;IACA;IAFV,YACU,OAA4C,EAC5C,gBAAgB,IAAI;QADpB,YAAO,GAAP,OAAO,CAAqC;QAC5C,kBAAa,GAAb,aAAa,CAAO;IAC3B,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,YAAoB,EAAE,IAAuB;QACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC3E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;YACpD,MAAM,SAAS,GAAG,IAAI,EAAE,iBAAiB,IAAI,IAAI,CAAC,aAAa,CAAC;YAChE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/packages/core/src/index.d.ts

@@ -0,0 +1,10 @@
+export type { Project, Source, SourceType, MemoryType, MemoryStatus, RetrievalEvent, SearchQuery, CandidateMemory, SearchResult, ContextOptions, ContextResult, CreateMemoryInput, } from "./types.js";
+export type { Memory as MemoryData } from "./types.js";
+export { MemoryTypeSchema, MemoryStatusSchema, CreateMemoryInputSchema } from "./types.js";
+export type { MemoryStore } from "./memory-store.js";
+export { MemoryEngine, Memory } from "./memory.js";
+export * from "./extraction.js";
+export * from "./policy.js";
+export * from "./events.js";
+export * from "./consolidation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,MAAM,EACN,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC3F,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/packages/core/src/index.js

@@ -0,0 +1,7 @@
+export { MemoryTypeSchema, MemoryStatusSchema, CreateMemoryInputSchema } from "./types.js";
+export { MemoryEngine, Memory } from "./memory.js";
+export * from "./extraction.js";
+export * from "./policy.js";
+export * from "./events.js";
+export * from "./consolidation.js";
+//# sourceMappingURL=index.js.map

package/dist/packages/core/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/core/src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/packages/core/src/memory-store.d.ts

@@ -0,0 +1,36 @@
+import type { Memory, Project, Source, SearchQuery, SearchResult, RetrievalEvent } from "./types.js";
+/**
+ * Core abstraction — Memory Store.
+ * LocalStore (SQLite) and PostgresStore both implement this.
+ * Dashboard / CLI / core engine depend only on this interface.
+ */
+export interface MemoryStore {
+    createProject(project: Project): Promise<Project>;
+    getProject(id: string): Promise<Project | null>;
+    getProjectByName(name: string): Promise<Project | null>;
+    listProjects(): Promise<Project[]>;
+    deleteProject(projectId: string): Promise<void>;
+    createSource(source: Source): Promise<Source>;
+    getSource(id: string): Promise<Source | null>;
+    createMemory(memory: Memory): Promise<void>;
+    getMemory(id: string): Promise<Memory | null>;
+    updateMemory(id: string, update: Partial<Memory>): Promise<void>;
+    deleteMemory(id: string): Promise<void>;
+    archiveMemory(id: string): Promise<void>;
+    listMemories(projectId: string): Promise<Memory[]>;
+    search(query: SearchQuery): Promise<SearchResult[]>;
+    upsertEmbedding(memoryId: string, vector: number[], model: string): Promise<void>;
+    getEmbedding(memoryId: string): Promise<{
+        vector: number[];
+        model: string;
+    } | null>;
+    deleteEmbedding?(memoryId: string): Promise<void>;
+    vectorSearch?(projectId: string, queryVector: number[], limit: number): Promise<Array<{
+        memory: Memory;
+        distance: number;
+    }>>;
+    logRetrieval(event: RetrievalEvent): Promise<void>;
+    listRetrievals(projectId: string, limit?: number): Promise<RetrievalEvent[]>;
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/packages/core/src/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,MAAM,EACN,WAAW,EACX,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAE1B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxD,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAG9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAGpD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpF,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGlD,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAG7H,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAG7E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/packages/core/src/memory-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-store.js.map