adaptive-context-memory 1.0.0

package/dist/memory/add/updatePhase.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Upgraded Update Phase — v2 with:
+ *  1. Batch embeddings — embed ALL facts in 1 API call instead of N sequential calls
+ *  2. Parallel LLM calls — run all tool classifier decisions concurrently
+ *  3. Fast pre-dedup — cosine similarity > 0.95 → NOOP without any LLM call
+ *  4. Retry on all LLM calls (via withRetry in toolClassifier)
+ *  5. Atomic DB transaction — all updates committed together
+ */
+import type Database from "better-sqlite3";
+export declare function updatePhase(db: Database.Database, candidateFacts: string[], conversationId: number): Promise<void>;
+//# sourceMappingURL=updatePhase.d.ts.map

package/dist/memory/add/updatePhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updatePhase.d.ts","sourceRoot":"","sources":["../../../src/memory/add/updatePhase.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAiH3C,wBAAsB,WAAW,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/dist/memory/add/updatePhase.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Upgraded Update Phase — v2 with:
+ *  1. Batch embeddings — embed ALL facts in 1 API call instead of N sequential calls
+ *  2. Parallel LLM calls — run all tool classifier decisions concurrently
+ *  3. Fast pre-dedup — cosine similarity > 0.95 → NOOP without any LLM call
+ *  4. Retry on all LLM calls (via withRetry in toolClassifier)
+ *  5. Atomic DB transaction — all updates committed together
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updatePhase = updatePhase;
+const embeddings_js_1 = require("../embeddings.js");
+const toolClassifier_js_1 = require("../toolClassifier.js");
+const vectorStore_js_1 = require("../vectorStore.js");
+const settings_js_1 = require("../../core/settings.js");
+const FAST_DEDUP_THRESHOLD = 0.95; // cosine score above this → definitely duplicate
+/** Search similar memories via vector store */
+function searchSimilarMemories(db, conversationId, queryEmbedding, limit = 10) {
+    let store = (0, vectorStore_js_1.getVectorStore)(conversationId);
+    if (store.count === 0)
+        store = (0, vectorStore_js_1.rebuildIndexFromDb)(db, conversationId);
+    const results = store.search(queryEmbedding, limit);
+    if (results.length === 0)
+        return [];
+    const ids = results.map((r) => r.memoryId);
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = db
+        .prepare(`SELECT * FROM memories WHERE id IN (${placeholders}) AND is_active = 1`)
+        .all(...ids);
+    const byId = new Map(rows.map((r) => [r.id, r]));
+    return ids.filter((id) => byId.has(id)).map((id) => byId.get(id));
+}
+// ─── Apply a single decision to DB + vector store ───────────────────────────
+function applyDecision(db, conversationId, fact, embedding, decision, s) {
+    const store = (0, vectorStore_js_1.getVectorStore)(conversationId);
+    const now = new Date().toISOString();
+    if (decision.action === "ADD") {
+        const text = decision.text ?? fact;
+        const res = db
+            .prepare(`INSERT INTO memories
+         (conversation_id, memory_text, embedding, category, is_episodic, importance, is_active, created_at, updated_at)
+         VALUES (?, ?, ?, ?, 0, 0.5, 1, ?, ?)`)
+            .run(conversationId, text, JSON.stringify(embedding), decision.category ?? null, now, now);
+        const newId = res.lastInsertRowid;
+        store.add(newId, embedding);
+        if (s.debug)
+            console.log(`[ContextMemory] ✅ ADD memory ID ${newId}: "${text.slice(0, 60)}"`);
+    }
+    else if (decision.action === "UPDATE" && decision.memoryId != null) {
+        const old = db.prepare("SELECT * FROM memories WHERE id = ?").get(decision.memoryId);
+        if (old) {
+            const text = decision.text ?? fact;
+            db.prepare("UPDATE memories SET memory_text = ?, embedding = ?, category = ?, updated_at = ? WHERE id = ?").run(text, JSON.stringify(embedding), decision.category ?? old.category, now, old.id);
+            store.update(old.id, embedding);
+            if (s.debug)
+                console.log(`[ContextMemory] ✏️  UPDATE memory ID ${old.id}`);
+        }
+    }
+    else if (decision.action === "DELETE" && decision.memoryId != null) {
+        const old = db.prepare("SELECT * FROM memories WHERE id = ?").get(decision.memoryId);
+        if (old) {
+            store.remove(old.id);
+            db.prepare("UPDATE memories SET is_active = 0 WHERE id = ?").run(old.id);
+            if (s.debug)
+                console.log(`[ContextMemory] 🗑  DELETE memory ID ${old.id}`);
+        }
+    }
+    else if (decision.action === "REPLACE" && decision.memoryId != null) {
+        const old = db.prepare("SELECT * FROM memories WHERE id = ?").get(decision.memoryId);
+        if (old) {
+            store.remove(old.id);
+            db.prepare("UPDATE memories SET is_active = 0 WHERE id = ?").run(old.id);
+            if (s.debug)
+                console.log(`[ContextMemory] 🔄 REPLACE — deactivated ID ${old.id}`);
+        }
+        const text = decision.text ?? fact;
+        const res = db
+            .prepare(`INSERT INTO memories
+         (conversation_id, memory_text, embedding, category, is_episodic, importance, is_active, created_at, updated_at)
+         VALUES (?, ?, ?, ?, 0, 0.5, 1, ?, ?)`)
+            .run(conversationId, text, JSON.stringify(embedding), decision.category ?? null, now, now);
+        const newId = res.lastInsertRowid;
+        store.add(newId, embedding);
+        if (s.debug)
+            console.log(`[ContextMemory] ✅ REPLACE — added new ID ${newId}: "${text.slice(0, 60)}"`);
+    }
+    else if (decision.action === "NOOP") {
+        if (s.debug)
+            console.log(`[ContextMemory] ⏭  NOOP for: "${fact.slice(0, 60)}"`);
+    }
+}
+async function updatePhase(db, candidateFacts, conversationId) {
+    if (candidateFacts.length === 0)
+        return;
+    const s = (0, settings_js_1.getSettings)();
+    // ── Step 1: Batch embed ALL facts in 1 API call ───────────────────────────
+    if (s.debug)
+        console.log(`[ContextMemory] Batch embedding ${candidateFacts.length} facts...`);
+    const embeddings = await (0, embeddings_js_1.batchEmbedTexts)(candidateFacts);
+    const workItems = candidateFacts.map((fact, i) => {
+        const embedding = embeddings[i];
+        const similar = searchSimilarMemories(db, conversationId, embedding, 10);
+        // Fast dedup: if top match cosine > threshold, skip LLM call
+        let fastNoop = false;
+        if (similar.length > 0) {
+            const store = (0, vectorStore_js_1.getVectorStore)(conversationId);
+            const topResults = store.search(embedding, 1);
+            if (topResults.length > 0 && topResults[0].score >= FAST_DEDUP_THRESHOLD) {
+                fastNoop = true;
+                if (s.debug) {
+                    console.log(`[ContextMemory] ⚡ Fast-dedup NOOP (score=${topResults[0].score.toFixed(3)}): "${fact.slice(0, 60)}"`);
+                }
+            }
+        }
+        return { fact, embedding, similar, fastNoop };
+    });
+    // ── Step 3: Parallel LLM calls for non-deduped facts ─────────────────────
+    const llmWork = workItems.filter((w) => !w.fastNoop);
+    if (s.debug)
+        console.log(`[ContextMemory] ${workItems.length - llmWork.length} fast-deduped, ${llmWork.length} sent to LLM (parallel)`);
+    const decisions = await Promise.all(llmWork.map((w) => (0, toolClassifier_js_1.llmToolCall)(w.fact, w.similar)));
+    // ── Step 4: Apply all decisions in a single DB transaction ───────────────
+    const applyAll = db.transaction(() => {
+        for (let i = 0; i < llmWork.length; i++) {
+            const { fact, embedding } = llmWork[i];
+            const decision = decisions[i];
+            applyDecision(db, conversationId, fact, embedding, decision, s);
+        }
+    });
+    applyAll();
+    (0, vectorStore_js_1.saveVectorStore)(conversationId);
+}
+//# sourceMappingURL=updatePhase.js.map

package/dist/memory/add/updatePhase.js.map

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

package/dist/memory/bubbleCreator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bubble Creator — TypeScript port of Python bubble_creator.py
+ *
+ * Creates episodic memory "bubbles" with embeddings and bidirectional connections.
+ */
+import type Database from "better-sqlite3";
+import type { BubbleData } from "./extractor.js";
+import type { MemoryRow } from "../db/database.js";
+export declare function createBubbles(db: Database.Database, bubbles: BubbleData[], conversationId: number, sessionId?: number | null): Promise<MemoryRow[]>;
+//# sourceMappingURL=bubbleCreator.d.ts.map

package/dist/memory/bubbleCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubbleCreator.d.ts","sourceRoot":"","sources":["../../src/memory/bubbleCreator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAAM,GAAG,IAAW,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CAqDtB"}

package/dist/memory/bubbleCreator.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Bubble Creator — TypeScript port of Python bubble_creator.py
+ *
+ * Creates episodic memory "bubbles" with embeddings and bidirectional connections.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBubbles = createBubbles;
+const embeddings_js_1 = require("./embeddings.js");
+const vectorStore_js_1 = require("./vectorStore.js");
+const connectionFinder_js_1 = require("./connectionFinder.js");
+async function createBubbles(db, bubbles, conversationId, sessionId = null) {
+    const store = (0, vectorStore_js_1.getVectorStore)(conversationId);
+    const created = [];
+    const now = new Date().toISOString();
+    for (const bubbleData of bubbles) {
+        const text = bubbleData.text?.trim();
+        if (!text)
+            continue;
+        let importance = typeof bubbleData.importance === "number" ? bubbleData.importance : 0.5;
+        importance = Math.max(0, Math.min(1, importance)); // clamp to [0, 1]
+        // Generate embedding
+        const embedding = await (0, embeddings_js_1.embedText)(text);
+        // Insert bubble into DB
+        const res = db
+            .prepare(`INSERT INTO memories
+         (conversation_id, memory_text, embedding, memory_metadata, is_episodic,
+          occurred_at, session_id, importance, is_active, created_at, updated_at)
+         VALUES (?, ?, ?, '{}', 1, ?, ?, ?, 1, ?, ?)`)
+            .run(conversationId, text, JSON.stringify(embedding), now, // occurred_at
+        sessionId, importance, now, now);
+        const bubbleId = res.lastInsertRowid;
+        // Add to vector store
+        store.add(bubbleId, embedding);
+        // Fetch the row we just inserted
+        const bubble = db
+            .prepare("SELECT * FROM memories WHERE id = ?")
+            .get(bubbleId);
+        // Find + write connections
+        (0, connectionFinder_js_1.findConnections)(db, bubble, embedding, conversationId);
+        created.push(bubble);
+    }
+    (0, vectorStore_js_1.saveVectorStore)(conversationId);
+    return created;
+}
+//# sourceMappingURL=bubbleCreator.js.map

package/dist/memory/bubbleCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubbleCreator.js","sourceRoot":"","sources":["../../src/memory/bubbleCreator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AASH,sCA0DC;AAhED,mDAA4C;AAC5C,qDAAmE;AACnE,+DAAwD;AAIjD,KAAK,UAAU,aAAa,CACjC,EAAqB,EACrB,OAAqB,EACrB,cAAsB,EACtB,YAA2B,IAAI;IAE/B,MAAM,KAAK,GAAG,IAAA,+BAAc,EAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,UAAU,GACZ,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1E,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,kBAAkB;QAErE,qBAAqB;QACrB,MAAM,SAAS,GAAG,MAAM,IAAA,yBAAS,EAAC,IAAI,CAAC,CAAC;QAExC,wBAAwB;QACxB,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CACN;;;qDAG6C,CAC9C;aACA,GAAG,CACF,cAAc,EACd,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EACzB,GAAG,EAAE,cAAc;QACnB,SAAS,EACT,UAAU,EACV,GAAG,EACH,GAAG,CACJ,CAAC;QAEJ,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAyB,CAAC;QAE/C,sBAAsB;QACtB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE/B,iCAAiC;QACjC,MAAM,MAAM,GAAG,EAAE;aACd,OAAO,CAAC,qCAAqC,CAAC;aAC9C,GAAG,CAAC,QAAQ,CAAc,CAAC;QAE9B,2BAA2B;QAC3B,IAAA,qCAAe,EAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QAEvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,IAAA,gCAAe,EAAC,cAAc,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/memory/connectionFinder.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Connection Finder — TypeScript port of Python connection_finder.py
+ *
+ * Finds bidirectional connections between episodic bubbles
+ * using cosine similarity from the vector store.
+ */
+import type Database from "better-sqlite3";
+import type { MemoryRow } from "../db/database.js";
+/**
+ * Find similar bubbles and write bidirectional connection metadata.
+ * Returns an array of connected memory IDs.
+ */
+export declare function findConnections(db: Database.Database, newBubble: MemoryRow, embedding: number[], conversationId: number): number[];
+//# sourceMappingURL=connectionFinder.d.ts.map

package/dist/memory/connectionFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionFinder.d.ts","sourceRoot":"","sources":["../../src/memory/connectionFinder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,EAAE,CAoDV"}

package/dist/memory/connectionFinder.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Connection Finder — TypeScript port of Python connection_finder.py
+ *
+ * Finds bidirectional connections between episodic bubbles
+ * using cosine similarity from the vector store.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findConnections = findConnections;
+const vectorStore_js_1 = require("./vectorStore.js");
+const database_js_1 = require("../db/database.js");
+const CONNECTION_THRESHOLD = 0.6;
+const MAX_CONNECTIONS = 5;
+/**
+ * Find similar bubbles and write bidirectional connection metadata.
+ * Returns an array of connected memory IDs.
+ */
+function findConnections(db, newBubble, embedding, conversationId) {
+    const store = (0, vectorStore_js_1.getVectorStore)(conversationId);
+    const results = store.search(embedding, MAX_CONNECTIONS * 2);
+    const connections = [];
+    for (const r of results) {
+        if (r.memoryId !== newBubble.id && r.score >= CONNECTION_THRESHOLD) {
+            connections.push({ id: r.memoryId, score: Math.round(r.score * 1000) / 1000 });
+        }
+    }
+    const topConns = connections.slice(0, MAX_CONNECTIONS);
+    if (topConns.length === 0)
+        return [];
+    const connectionIds = topConns.map((c) => c.id);
+    const connectionScores = {};
+    for (const c of topConns)
+        connectionScores[String(c.id)] = c.score;
+    // Write to new bubble's metadata
+    const newMeta = (0, database_js_1.parseMeta)(newBubble);
+    newMeta.connections = { bubble_ids: connectionIds, scores: connectionScores };
+    db.prepare("UPDATE memories SET memory_metadata = ? WHERE id = ?").run(JSON.stringify(newMeta), newBubble.id);
+    // Write reverse connections (bidirectional)
+    for (const conn of topConns) {
+        const connRow = db
+            .prepare("SELECT * FROM memories WHERE id = ?")
+            .get(conn.id);
+        if (connRow) {
+            const cm = (0, database_js_1.parseMeta)(connRow);
+            const cmc = cm.connections ?? { bubble_ids: [], scores: {} };
+            if (!cmc.bubble_ids.includes(newBubble.id)) {
+                cmc.bubble_ids.push(newBubble.id);
+                cmc.scores[String(newBubble.id)] = conn.score;
+                cm.connections = cmc;
+                db.prepare("UPDATE memories SET memory_metadata = ? WHERE id = ?").run(JSON.stringify(cm), conn.id);
+            }
+        }
+    }
+    return connectionIds;
+}
+//# sourceMappingURL=connectionFinder.js.map

package/dist/memory/connectionFinder.js.map

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

package/dist/memory/embeddings.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Embedding generation — v2 with LRU cache + batch support + retry.
+ *
+ * Upgrades over v1:
+ *  1. LRU cache — repeated text → zero API calls
+ *  2. batchEmbedTexts() — N texts in 1 API call instead of N calls
+ *  3. Exponential backoff retry on all calls
+ */
+/**
+ * Embed a single text. Cached — identical text never calls the API twice.
+ */
+export declare function embedText(text: string): Promise<number[]>;
+/**
+ * Embed multiple texts in a single API call. Much faster than N sequential calls.
+ * Results are cached individually for future reuse.
+ */
+export declare function batchEmbedTexts(texts: string[]): Promise<number[][]>;
+/** Clear the embedding cache (useful for testing) */
+export declare function clearEmbeddingCache(): void;
+/** Cache stats for monitoring */
+export declare function getEmbeddingCacheStats(): {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: string;
+};
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/memory/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/memory/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuDH;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa/D;AAGD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAuD1E;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED,iCAAiC;AACjC,wBAAgB,sBAAsB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQxG"}

package/dist/memory/embeddings.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Embedding generation — v2 with LRU cache + batch support + retry.
+ *
+ * Upgrades over v1:
+ *  1. LRU cache — repeated text → zero API calls
+ *  2. batchEmbedTexts() — N texts in 1 API call instead of N calls
+ *  3. Exponential backoff retry on all calls
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.embedText = embedText;
+exports.batchEmbedTexts = batchEmbedTexts;
+exports.clearEmbeddingCache = clearEmbeddingCache;
+exports.getEmbeddingCacheStats = getEmbeddingCacheStats;
+const llmClient_js_1 = require("../core/llmClient.js");
+const settings_js_1 = require("../core/settings.js");
+const retry_js_1 = require("../core/retry.js");
+// ─── LRU Cache ────────────────────────────────────────────────────────────────
+const MAX_CACHE_SIZE = 512;
+/** Simple LRU map: evicts oldest entry when at capacity */
+class LRUCache {
+    map = new Map();
+    capacity;
+    constructor(capacity) {
+        this.capacity = capacity;
+    }
+    get(key) {
+        if (!this.map.has(key))
+            return undefined;
+        // Move to end (most recently used)
+        const val = this.map.get(key);
+        this.map.delete(key);
+        this.map.set(key, val);
+        return val;
+    }
+    set(key, val) {
+        if (this.map.has(key))
+            this.map.delete(key);
+        this.map.set(key, val);
+        // Evict oldest if over capacity
+        if (this.map.size > this.capacity) {
+            const oldest = this.map.keys().next().value;
+            if (oldest !== undefined)
+                this.map.delete(oldest);
+        }
+    }
+    get size() { return this.map.size; }
+}
+const _cache = new LRUCache(MAX_CACHE_SIZE);
+let _cacheHits = 0;
+let _cacheMisses = 0;
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function getModelName() {
+    const s = (0, settings_js_1.getSettings)();
+    let model = s.embeddingModel;
+    if (s.llmProvider === "openrouter" && !model.startsWith("openai/")) {
+        model = `openai/${model}`;
+    }
+    return model;
+}
+// ─── Single embedding (with cache + retry) ───────────────────────────────────
+/**
+ * Embed a single text. Cached — identical text never calls the API twice.
+ */
+async function embedText(text) {
+    const cached = _cache.get(text);
+    if (cached) {
+        _cacheHits++;
+        if ((0, settings_js_1.getSettings)().debug) {
+            console.log(`[ContextMemory] Embedding cache hit (${_cacheHits} hits / ${_cacheMisses} misses)`);
+        }
+        return cached;
+    }
+    _cacheMisses++;
+    const embedding = await batchEmbedTexts([text]);
+    return embedding[0];
+}
+// ─── Batch embedding (core — 1 API call for N texts) ─────────────────────────
+/**
+ * Embed multiple texts in a single API call. Much faster than N sequential calls.
+ * Results are cached individually for future reuse.
+ */
+async function batchEmbedTexts(texts) {
+    if (texts.length === 0)
+        return [];
+    const s = (0, settings_js_1.getSettings)();
+    const model = getModelName();
+    // Check cache first — only call API for uncached texts
+    const uncachedIndices = [];
+    const uncachedTexts = [];
+    const result = texts.map((text, i) => {
+        const cached = _cache.get(text);
+        if (cached) {
+            _cacheHits++;
+            return cached;
+        }
+        _cacheMisses++;
+        uncachedIndices.push(i);
+        uncachedTexts.push(text);
+        return null;
+    });
+    if (uncachedTexts.length > 0) {
+        const client = (0, llmClient_js_1.getEmbeddingClient)();
+        // OpenAI batch limit is 2048 inputs; chunk if needed
+        const BATCH_SIZE = 100;
+        const apiEmbeddings = [];
+        for (let i = 0; i < uncachedTexts.length; i += BATCH_SIZE) {
+            const chunk = uncachedTexts.slice(i, i + BATCH_SIZE);
+            const response = await (0, retry_js_1.withRetry)(() => client.embeddings.create({ model, input: chunk }));
+            // API returns embeddings sorted by index
+            for (const item of response.data) {
+                apiEmbeddings.push(item.embedding);
+            }
+        }
+        // Fill results + update cache
+        for (let i = 0; i < uncachedIndices.length; i++) {
+            const originalIdx = uncachedIndices[i];
+            const embedding = apiEmbeddings[i];
+            result[originalIdx] = embedding;
+            _cache.set(texts[originalIdx], embedding);
+        }
+        if (s.debug) {
+            console.log(`[ContextMemory] Batch embed: ${uncachedTexts.length} API calls saved by batching. Cache: ${_cacheHits}H/${_cacheMisses}M`);
+        }
+    }
+    return result;
+}
+/** Clear the embedding cache (useful for testing) */
+function clearEmbeddingCache() {
+    _cacheHits = 0;
+    _cacheMisses = 0;
+    // Re-create cache (no clear method on Map-based LRU)
+    Object.assign(_cache, new LRUCache(MAX_CACHE_SIZE));
+}
+/** Cache stats for monitoring */
+function getEmbeddingCacheStats() {
+    const total = _cacheHits + _cacheMisses;
+    return {
+        hits: _cacheHits,
+        misses: _cacheMisses,
+        size: _cache.size,
+        hitRate: total > 0 ? `${Math.round((_cacheHits / total) * 100)}%` : "0%",
+    };
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/memory/embeddings.js.map

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

package/dist/memory/extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Memory extractor — TypeScript port of Python extractor.py
+ *
+ * Uses an LLM to extract semantic facts and episodic bubbles
+ * from the latest user/assistant interaction.
+ */
+export interface BubbleData {
+    text: string;
+    importance: number;
+}
+export interface ExtractionResult {
+    semantic: string[];
+    bubbles: BubbleData[];
+}
+/**
+ * Ask the LLM to extract semantic facts and episodic bubbles
+ * from the latest conversation exchange.
+ */
+export declare function extractMemories(latestPair: string[], summaryText: string, recentMessages: string[]): Promise<ExtractionResult>;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/memory/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/memory/extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAmBD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/memory/extractor.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Memory extractor — TypeScript port of Python extractor.py
+ *
+ * Uses an LLM to extract semantic facts and episodic bubbles
+ * from the latest user/assistant interaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMemories = extractMemories;
+const llmClient_js_1 = require("../core/llmClient.js");
+const settings_js_1 = require("../core/settings.js");
+const retry_js_1 = require("../core/retry.js");
+const prompts_js_1 = require("../utils/prompts.js");
+/** Parse raw LLM JSON output, stripping any markdown code fences */
+function parseJson(raw) {
+    let str = raw.trim();
+    const fence = str.match(/```(?:json)?\s*([\s\S]*?)\s*```/);
+    if (fence)
+        str = fence[1].trim();
+    try {
+        const parsed = JSON.parse(str);
+        return {
+            semantic: Array.isArray(parsed.semantic) ? parsed.semantic : [],
+            bubbles: Array.isArray(parsed.bubbles) ? parsed.bubbles : [],
+        };
+    }
+    catch {
+        return { semantic: [], bubbles: [] };
+    }
+}
+/**
+ * Ask the LLM to extract semantic facts and episodic bubbles
+ * from the latest conversation exchange.
+ */
+async function extractMemories(latestPair, summaryText, recentMessages) {
+    const s = (0, settings_js_1.getSettings)();
+    const client = (0, llmClient_js_1.getLlmClient)();
+    const recentText = recentMessages.join("\n");
+    const latestText = latestPair.join("\n");
+    const messages = [
+        { role: "system", content: prompts_js_1.EXTRACTION_SYSTEM_PROMPT },
+        {
+            role: "user",
+            content: `Conversation Summary:\n${summaryText}\n\nRecent Messages:\n${recentText}\n\nLatest Interaction:\n${latestText}\n\nExtract memory facts (semantic facts and bubbles).`,
+        },
+    ];
+    const response = await (0, retry_js_1.withRetry)(() => client.chat.completions.create({
+        model: s.llmModel,
+        messages,
+        temperature: 0.1,
+    }));
+    const raw = response.choices[0].message.content ?? "";
+    if (s.debug)
+        console.log("[ContextMemory] Extraction raw:", raw.slice(0, 300));
+    const result = parseJson(raw);
+    if (s.debug)
+        console.log(`[ContextMemory] Extracted: ${result.semantic.length} semantic, ${result.bubbles.length} bubbles`);
+    return result;
+}
+//# sourceMappingURL=extractor.js.map

package/dist/memory/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/memory/extractor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsCH,0CAqCC;AAzED,uDAAoD;AACpD,qDAAkD;AAClD,+CAA6C;AAC7C,oDAA+D;AAY/D,oEAAoE;AACpE,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC3D,IAAI,KAAK;QAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8B,CAAC;QAC5D,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC/D,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SAC7D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,eAAe,CACnC,UAAoB,EACpB,WAAmB,EACnB,cAAwB;IAExB,MAAM,CAAC,GAAG,IAAA,yBAAW,GAAE,CAAC;IACxB,MAAM,MAAM,GAAG,IAAA,2BAAY,GAAE,CAAC;IAE9B,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG;QACf,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,qCAAwB,EAAE;QAC9D;YACE,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,0BAA0B,WAAW,yBAAyB,UAAU,4BAA4B,UAAU,wDAAwD;SAChL;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAS,EAAC,GAAG,EAAE,CACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7B,KAAK,EAAE,CAAC,CAAC,QAAQ;QACjB,QAAQ;QACR,WAAW,EAAE,GAAG;KACjB,CAAC,CACH,CAAC;IAEF,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,KAAK;QACT,OAAO,CAAC,GAAG,CACT,8BAA8B,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,UAAU,CAClG,CAAC;IAEJ,OAAO,MAAM,CAAC;AAChB,CAAC"}