@psiclawops/hypermem 0.1.0 → 0.5.1

package/dist/cache.d.ts

@@ -0,0 +1,110 @@
+/**
+ * hypermem Cache Layer
+ *
+ * Drop-in replacement for RedisLayer using SQLite :memory: ATTACH.
+ * Same public interface, zero external dependencies, zero TCP overhead.
+ */
+import { DatabaseSync } from 'node:sqlite';
+import type { CacheConfig, SessionMeta, SessionCursor, StoredMessage, NeutralMessage } from './types.js';
+export interface ModelState {
+    model: string;
+    tokenBudget: number;
+    composedAt: string;
+    historyDepth: number;
+    reshapedAt?: string;
+}
+export declare class CacheLayer {
+    private db;
+    private readonly config;
+    private _connected;
+    private stmtSetSlot;
+    private stmtGetSlot;
+    private stmtSetTopicSlot;
+    private stmtGetTopicSlot;
+    private stmtTouchSlots;
+    private stmtEvictSlots;
+    private stmtActivateSession;
+    private stmtDeactivateSession;
+    private stmtGetActiveSessions;
+    private stmtSetMeta;
+    private stmtGetMeta;
+    private stmtTouchSession;
+    private stmtGetMaxSeq;
+    private stmtInsertHistory;
+    private stmtGetHistory;
+    private stmtGetHistoryLimit;
+    private stmtHistoryExists;
+    private stmtDeleteHistory;
+    private stmtDeleteOldHistory;
+    private stmtGetAllHistoryDesc;
+    private stmtDeleteHistoryBeforeSeq;
+    private stmtEvictHistory;
+    private stmtSetWindow;
+    private stmtGetWindow;
+    private stmtDeleteWindow;
+    private stmtEvictWindows;
+    private stmtSetKv;
+    private stmtGetKv;
+    private stmtDeleteKv;
+    constructor(config?: Partial<CacheConfig>);
+    connect(db?: DatabaseSync): Promise<boolean>;
+    private _prepareStatements;
+    get isConnected(): boolean;
+    setProfile(agentId: string, profile: Record<string, unknown>): Promise<void>;
+    getProfile(agentId: string): Promise<Record<string, unknown> | null>;
+    addActiveSession(agentId: string, sessionKey: string): Promise<void>;
+    removeActiveSession(agentId: string, sessionKey: string): Promise<void>;
+    getActiveSessions(agentId: string): Promise<string[]>;
+    setSlot(agentId: string, sessionKey: string, slot: string, value: string): Promise<void>;
+    getSlot(agentId: string, sessionKey: string, slot: string): Promise<string | null>;
+    setSessionMeta(agentId: string, sessionKey: string, meta: SessionMeta): Promise<void>;
+    getSessionMeta(agentId: string, sessionKey: string): Promise<SessionMeta | null>;
+    pushHistory(agentId: string, sessionKey: string, messages: StoredMessage[], maxMessages?: number): Promise<void>;
+    replaceHistory(agentId: string, sessionKey: string, messages: NeutralMessage[], maxMessages?: number): Promise<void>;
+    getHistory(agentId: string, sessionKey: string, limit?: number): Promise<StoredMessage[]>;
+    sessionExists(agentId: string, sessionKey: string): Promise<boolean>;
+    trimHistoryToTokenBudget(agentId: string, sessionKey: string, tokenBudget: number): Promise<number>;
+    setWindow(agentId: string, sessionKey: string, messages: NeutralMessage[], ttlSeconds?: number): Promise<void>;
+    getWindow(agentId: string, sessionKey: string): Promise<NeutralMessage[] | null>;
+    invalidateWindow(agentId: string, sessionKey: string): Promise<void>;
+    setCursor(agentId: string, sessionKey: string, cursor: SessionCursor): Promise<void>;
+    getCursor(agentId: string, sessionKey: string): Promise<SessionCursor | null>;
+    warmSession(agentId: string, sessionKey: string, slots: {
+        system?: string;
+        identity?: string;
+        context?: string;
+        facts?: string;
+        tools?: string;
+        meta?: SessionMeta;
+        history?: StoredMessage[];
+    }): Promise<void>;
+    evictSession(agentId: string, sessionKey: string): Promise<void>;
+    touchSession(agentId: string, sessionKey: string): Promise<void>;
+    flushPrefix(): Promise<number>;
+    setFleetCache(key: string, value: string, ttl?: number): Promise<void>;
+    getFleetCache(key: string): Promise<string | null>;
+    delFleetCache(key: string): Promise<void>;
+    cacheFleetAgent(agentId: string, data: Record<string, unknown>): Promise<void>;
+    getCachedFleetAgent(agentId: string): Promise<Record<string, unknown> | null>;
+    cacheFleetSummary(summary: Record<string, unknown>): Promise<void>;
+    getCachedFleetSummary(): Promise<Record<string, unknown> | null>;
+    invalidateFleetAgent(agentId: string): Promise<void>;
+    setQueryEmbedding(agentId: string, sessionKey: string, embedding: Float32Array): Promise<void>;
+    getQueryEmbedding(agentId: string, sessionKey: string): Promise<Float32Array | null>;
+    setTopicSlot(agentId: string, sessionKey: string, topicId: string, slot: string, value: string): Promise<void>;
+    getTopicSlot(agentId: string, sessionKey: string, topicId: string, slot: string): Promise<string | null>;
+    setTopicWindow(agentId: string, sessionKey: string, topicId: string, messages: NeutralMessage[], ttl?: number): Promise<void>;
+    getTopicWindow(agentId: string, sessionKey: string, topicId: string): Promise<NeutralMessage[] | null>;
+    invalidateTopicWindow(agentId: string, sessionKey: string, topicId: string): Promise<void>;
+    warmTopicSession(agentId: string, sessionKey: string, topicId: string, slots: {
+        history?: StoredMessage[];
+        window?: NeutralMessage[];
+        context?: string;
+        facts?: string;
+        cursor?: string;
+    }): Promise<void>;
+    setModelState(agentId: string, sessionKey: string, state: ModelState): Promise<void>;
+    getModelState(agentId: string, sessionKey: string): Promise<ModelState | null>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

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

package/dist/cache.js

@@ -0,0 +1,495 @@
+/**
+ * hypermem Cache Layer
+ *
+ * Drop-in replacement for RedisLayer using SQLite :memory: ATTACH.
+ * Same public interface, zero external dependencies, zero TCP overhead.
+ */
+import { DatabaseSync } from 'node:sqlite';
+const DEFAULT_CONFIG = {
+    keyPrefix: 'hm:',
+    sessionTTL: 14400,
+    historyTTL: 86400,
+};
+function now() {
+    return Math.floor(Date.now() / 1000);
+}
+export class CacheLayer {
+    db = null;
+    config;
+    _connected = false;
+    stmtSetSlot;
+    stmtGetSlot;
+    stmtSetTopicSlot;
+    stmtGetTopicSlot;
+    stmtTouchSlots;
+    stmtEvictSlots;
+    stmtActivateSession;
+    stmtDeactivateSession;
+    stmtGetActiveSessions;
+    stmtSetMeta;
+    stmtGetMeta;
+    stmtTouchSession;
+    stmtGetMaxSeq;
+    stmtInsertHistory;
+    stmtGetHistory;
+    stmtGetHistoryLimit;
+    stmtHistoryExists;
+    stmtDeleteHistory;
+    stmtDeleteOldHistory;
+    stmtGetAllHistoryDesc;
+    stmtDeleteHistoryBeforeSeq;
+    stmtEvictHistory;
+    stmtSetWindow;
+    stmtGetWindow;
+    stmtDeleteWindow;
+    stmtEvictWindows;
+    stmtSetKv;
+    stmtGetKv;
+    stmtDeleteKv;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    async connect(db) {
+        if (this._connected)
+            return true;
+        this.db = db ?? new DatabaseSync(':memory:');
+        this.db.exec("ATTACH DATABASE ':memory:' AS cache");
+        this.db.exec([
+            "CREATE TABLE IF NOT EXISTS cache.slots (agent_id TEXT NOT NULL, session_key TEXT NOT NULL, topic_id TEXT NOT NULL DEFAULT '', slot_name TEXT NOT NULL, value TEXT NOT NULL, expires_at INTEGER NOT NULL, PRIMARY KEY (agent_id, session_key, topic_id, slot_name));",
+            "CREATE TABLE IF NOT EXISTS cache.history (agent_id TEXT NOT NULL, session_key TEXT NOT NULL, topic_id TEXT NOT NULL DEFAULT '', seq INTEGER NOT NULL, message TEXT NOT NULL, PRIMARY KEY (agent_id, session_key, topic_id, seq));",
+            "CREATE TABLE IF NOT EXISTS cache.sessions (agent_id TEXT NOT NULL, session_key TEXT NOT NULL, meta TEXT, active INTEGER NOT NULL DEFAULT 1, touched_at INTEGER NOT NULL, PRIMARY KEY (agent_id, session_key));",
+            "CREATE TABLE IF NOT EXISTS cache.windows (agent_id TEXT NOT NULL, session_key TEXT NOT NULL, topic_id TEXT NOT NULL DEFAULT '', messages TEXT NOT NULL, expires_at INTEGER NOT NULL, PRIMARY KEY (agent_id, session_key, topic_id));",
+            "CREATE TABLE IF NOT EXISTS cache.kv (key TEXT PRIMARY KEY, value TEXT NOT NULL, expires_at INTEGER NOT NULL DEFAULT 0);"
+        ].join(' '));
+        this._prepareStatements();
+        this._connected = true;
+        return true;
+    }
+    _prepareStatements() {
+        const db = this.db;
+        this.stmtSetSlot = db.prepare("INSERT OR REPLACE INTO cache.slots (agent_id,session_key,topic_id,slot_name,value,expires_at) VALUES (?,?,'',?,?,?)");
+        this.stmtGetSlot = db.prepare("SELECT value FROM cache.slots WHERE agent_id=? AND session_key=? AND topic_id='' AND slot_name=? AND expires_at>?");
+        this.stmtSetTopicSlot = db.prepare("INSERT OR REPLACE INTO cache.slots (agent_id,session_key,topic_id,slot_name,value,expires_at) VALUES (?,?,?,?,?,?)");
+        this.stmtGetTopicSlot = db.prepare("SELECT value FROM cache.slots WHERE agent_id=? AND session_key=? AND topic_id=? AND slot_name=? AND expires_at>?");
+        this.stmtTouchSlots = db.prepare("UPDATE cache.slots SET expires_at=? WHERE agent_id=? AND session_key=? AND topic_id=''");
+        this.stmtEvictSlots = db.prepare("DELETE FROM cache.slots WHERE agent_id=? AND session_key=?");
+        this.stmtActivateSession = db.prepare("INSERT INTO cache.sessions (agent_id,session_key,meta,active,touched_at) VALUES (?,?,NULL,1,?) ON CONFLICT (agent_id,session_key) DO UPDATE SET active=1,touched_at=excluded.touched_at");
+        this.stmtDeactivateSession = db.prepare("UPDATE cache.sessions SET active=0 WHERE agent_id=? AND session_key=?");
+        this.stmtGetActiveSessions = db.prepare("SELECT session_key FROM cache.sessions WHERE agent_id=? AND active=1");
+        this.stmtSetMeta = db.prepare("INSERT INTO cache.sessions (agent_id,session_key,meta,active,touched_at) VALUES (?,?,?,COALESCE((SELECT active FROM cache.sessions WHERE agent_id=? AND session_key=?),1),?) ON CONFLICT (agent_id,session_key) DO UPDATE SET meta=excluded.meta,touched_at=excluded.touched_at");
+        this.stmtGetMeta = db.prepare("SELECT meta FROM cache.sessions WHERE agent_id=? AND session_key=?");
+        this.stmtTouchSession = db.prepare("UPDATE cache.sessions SET touched_at=? WHERE agent_id=? AND session_key=?");
+        this.stmtGetMaxSeq = db.prepare("SELECT MAX(seq) AS max_seq FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id=?");
+        this.stmtInsertHistory = db.prepare("INSERT OR IGNORE INTO cache.history (agent_id,session_key,topic_id,seq,message) VALUES (?,?,?,?,?)");
+        this.stmtGetHistory = db.prepare("SELECT message FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' ORDER BY seq ASC");
+        this.stmtGetHistoryLimit = db.prepare("SELECT message FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' AND seq IN (SELECT seq FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' ORDER BY seq DESC LIMIT ?) ORDER BY seq ASC");
+        this.stmtHistoryExists = db.prepare("SELECT 1 FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' LIMIT 1");
+        this.stmtDeleteHistory = db.prepare("DELETE FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id=''");
+        this.stmtDeleteOldHistory = db.prepare("DELETE FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' AND seq NOT IN (SELECT seq FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' ORDER BY seq DESC LIMIT ?)");
+        this.stmtGetAllHistoryDesc = db.prepare("SELECT seq,message FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' ORDER BY seq DESC");
+        this.stmtDeleteHistoryBeforeSeq = db.prepare("DELETE FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' AND seq<?");
+        this.stmtEvictHistory = db.prepare("DELETE FROM cache.history WHERE agent_id=? AND session_key=?");
+        this.stmtSetWindow = db.prepare("INSERT OR REPLACE INTO cache.windows (agent_id,session_key,topic_id,messages,expires_at) VALUES (?,?,?,?,?)");
+        this.stmtGetWindow = db.prepare("SELECT messages FROM cache.windows WHERE agent_id=? AND session_key=? AND topic_id=? AND expires_at>?");
+        this.stmtDeleteWindow = db.prepare("DELETE FROM cache.windows WHERE agent_id=? AND session_key=? AND topic_id=?");
+        this.stmtEvictWindows = db.prepare("DELETE FROM cache.windows WHERE agent_id=? AND session_key=?");
+        this.stmtSetKv = db.prepare("INSERT OR REPLACE INTO cache.kv (key,value,expires_at) VALUES (?,?,?)");
+        this.stmtGetKv = db.prepare("SELECT value FROM cache.kv WHERE key=? AND (expires_at=0 OR expires_at>?)");
+        this.stmtDeleteKv = db.prepare("DELETE FROM cache.kv WHERE key=?");
+    }
+    get isConnected() {
+        return this._connected && this.db !== null;
+    }
+    // ─── Agent-Level Operations ──────────────────────────────────
+    async setProfile(agentId, profile) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetKv.run(`${this.config.keyPrefix}${agentId}:profile`, JSON.stringify(profile), 0);
+    }
+    async getProfile(agentId) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetKv.get(`${this.config.keyPrefix}${agentId}:profile`, now());
+        return row ? JSON.parse(row.value) : null;
+    }
+    async addActiveSession(agentId, sessionKey) {
+        if (!this.isConnected)
+            return;
+        this.stmtActivateSession.run(agentId, sessionKey, now());
+    }
+    async removeActiveSession(agentId, sessionKey) {
+        if (!this.isConnected)
+            return;
+        this.stmtDeactivateSession.run(agentId, sessionKey);
+    }
+    async getActiveSessions(agentId) {
+        if (!this.isConnected)
+            return [];
+        const rows = this.stmtGetActiveSessions.all(agentId);
+        return rows.map(r => r.session_key);
+    }
+    // ─── Session Slot Operations ─────────────────────────────────
+    async setSlot(agentId, sessionKey, slot, value) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetSlot.run(agentId, sessionKey, slot, value, now() + this.config.sessionTTL);
+    }
+    async getSlot(agentId, sessionKey, slot) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetSlot.get(agentId, sessionKey, slot, now());
+        return row?.value ?? null;
+    }
+    async setSessionMeta(agentId, sessionKey, meta) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetMeta.run(agentId, sessionKey, JSON.stringify(meta), agentId, sessionKey, now());
+    }
+    async getSessionMeta(agentId, sessionKey) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetMeta.get(agentId, sessionKey);
+        if (!row?.meta)
+            return null;
+        return JSON.parse(row.meta);
+    }
+    // ─── History Operations ──────────────────────────────────────
+    async pushHistory(agentId, sessionKey, messages, maxMessages = 250) {
+        if (!this.isConnected || messages.length === 0)
+            return;
+        // Get current max seq for dedup
+        const maxRow = this.stmtGetMaxSeq.get(agentId, sessionKey, '');
+        const maxSeq = maxRow?.max_seq ?? -1;
+        // Filter already-stored messages (same dedup logic as Redis path)
+        let filteredMessages = messages;
+        if (maxSeq >= 0) {
+            filteredMessages = messages.filter(m => m.id > maxSeq);
+        }
+        if (filteredMessages.length === 0)
+            return;
+        let seq = maxSeq + 1;
+        for (const msg of filteredMessages) {
+            this.stmtInsertHistory.run(agentId, sessionKey, '', seq++, JSON.stringify(msg));
+        }
+        // Soft cap: keep only last maxMessages
+        this.stmtDeleteOldHistory.run(agentId, sessionKey, agentId, sessionKey, maxMessages);
+    }
+    async replaceHistory(agentId, sessionKey, messages, maxMessages = 250) {
+        if (!this.isConnected)
+            return;
+        this.stmtDeleteHistory.run(agentId, sessionKey);
+        const slice = messages.slice(-maxMessages);
+        for (let i = 0; i < slice.length; i++) {
+            this.stmtInsertHistory.run(agentId, sessionKey, '', i, JSON.stringify(slice[i]));
+        }
+    }
+    async getHistory(agentId, sessionKey, limit) {
+        if (!this.isConnected)
+            return [];
+        let rows;
+        if (limit) {
+            rows = this.stmtGetHistoryLimit.all(agentId, sessionKey, agentId, sessionKey, limit);
+        }
+        else {
+            rows = this.stmtGetHistory.all(agentId, sessionKey);
+        }
+        return rows.map(r => JSON.parse(r.message));
+    }
+    async sessionExists(agentId, sessionKey) {
+        if (!this.isConnected)
+            return false;
+        const row = this.stmtHistoryExists.get(agentId, sessionKey);
+        return row !== undefined;
+    }
+    async trimHistoryToTokenBudget(agentId, sessionKey, tokenBudget) {
+        if (!this.isConnected || tokenBudget <= 0)
+            return 0;
+        const rows = this.stmtGetAllHistoryDesc.all(agentId, sessionKey);
+        if (rows.length <= 10)
+            return 0;
+        const estimateMessageTokens = (msg) => {
+            let msgTokens = Math.ceil((msg.textContent?.length ?? 0) / 4);
+            if (msg.toolCalls)
+                msgTokens += Math.ceil(JSON.stringify(msg.toolCalls).length / 2);
+            if (msg.toolResults)
+                msgTokens += Math.ceil(JSON.stringify(msg.toolResults).length / 2);
+            return msgTokens;
+        };
+        const chronological = rows
+            .slice()
+            .reverse()
+            .map(row => {
+            try {
+                return { seq: row.seq, msg: JSON.parse(row.message), fallback: false };
+            }
+            catch {
+                return { seq: row.seq, msg: null, fallback: true };
+            }
+        });
+        const clusters = [];
+        for (let i = 0; i < chronological.length; i++) {
+            const current = chronological[i];
+            if (current.fallback || !current.msg) {
+                clusters.push({ startSeq: current.seq, endSeq: current.seq, tokenCost: 500 });
+                continue;
+            }
+            let endSeq = current.seq;
+            let tokenCost = estimateMessageTokens(current.msg);
+            if (current.msg.toolCalls && current.msg.toolCalls.length > 0) {
+                const callIds = new Set(current.msg.toolCalls.map(tc => tc.id).filter(Boolean));
+                let j = i + 1;
+                while (j < chronological.length) {
+                    const candidate = chronological[j];
+                    if (candidate.fallback || !candidate.msg || !candidate.msg.toolResults || candidate.msg.toolResults.length === 0)
+                        break;
+                    const resultIds = candidate.msg.toolResults.map(tr => tr.callId).filter(Boolean);
+                    if (callIds.size > 0 && resultIds.length > 0 && !resultIds.some(id => callIds.has(id)))
+                        break;
+                    tokenCost += estimateMessageTokens(candidate.msg);
+                    endSeq = candidate.seq;
+                    j++;
+                }
+                i = j - 1;
+            }
+            else if (current.msg.toolResults && current.msg.toolResults.length > 0) {
+                let j = i + 1;
+                while (j < chronological.length) {
+                    const candidate = chronological[j];
+                    if (candidate.fallback || !candidate.msg || !candidate.msg.toolResults || candidate.msg.toolResults.length === 0 || (candidate.msg.toolCalls && candidate.msg.toolCalls.length > 0))
+                        break;
+                    tokenCost += estimateMessageTokens(candidate.msg);
+                    endSeq = candidate.seq;
+                    j++;
+                }
+                i = j - 1;
+            }
+            clusters.push({ startSeq: current.seq, endSeq, tokenCost });
+        }
+        let tokenSum = 0;
+        let keepFromSeq = null;
+        for (let i = clusters.length - 1; i >= 0; i--) {
+            const cluster = clusters[i];
+            if (tokenSum + cluster.tokenCost > tokenBudget)
+                break;
+            tokenSum += cluster.tokenCost;
+            keepFromSeq = cluster.startSeq;
+        }
+        if (keepFromSeq === null) {
+            keepFromSeq = clusters[clusters.length - 1]?.startSeq ?? null;
+        }
+        if (keepFromSeq === null)
+            return 0;
+        const oldestSeq = clusters[0]?.startSeq ?? keepFromSeq;
+        if (keepFromSeq <= oldestSeq)
+            return 0;
+        const cutSeq = keepFromSeq - 1;
+        const stmt = this.db.prepare("DELETE FROM cache.history WHERE agent_id=? AND session_key=? AND topic_id='' AND seq<=?");
+        stmt.run(agentId, sessionKey, cutSeq);
+        const trimmed = rows.filter(r => r.seq <= cutSeq).length;
+        console.log(`[hypermem-cache] trimHistoryToTokenBudget: trimmed ${trimmed} messages from ${agentId}/${sessionKey}`);
+        return trimmed;
+    }
+    // ─── Window Cache Operations ─────────────────────────────────
+    async setWindow(agentId, sessionKey, messages, ttlSeconds = 120) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetWindow.run(agentId, sessionKey, '', JSON.stringify(messages), now() + ttlSeconds);
+    }
+    async getWindow(agentId, sessionKey) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetWindow.get(agentId, sessionKey, '', now());
+        return row ? JSON.parse(row.messages) : null;
+    }
+    async invalidateWindow(agentId, sessionKey) {
+        if (!this.isConnected)
+            return;
+        this.stmtDeleteWindow.run(agentId, sessionKey, '');
+    }
+    // ─── Session Cursor Operations ────────────────────────────────
+    async setCursor(agentId, sessionKey, cursor) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetKv.run(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:cursor`, JSON.stringify(cursor), now() + this.config.historyTTL);
+    }
+    async getCursor(agentId, sessionKey) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetKv.get(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:cursor`, now());
+        return row ? JSON.parse(row.value) : null;
+    }
+    // ─── Bulk Session Operations ──────────────────────────────────
+    async warmSession(agentId, sessionKey, slots) {
+        if (!this.isConnected)
+            return;
+        const exp = now() + this.config.sessionTTL;
+        if (slots.system)
+            this.stmtSetSlot.run(agentId, sessionKey, 'system', slots.system, exp);
+        if (slots.identity)
+            this.stmtSetSlot.run(agentId, sessionKey, 'identity', slots.identity, exp);
+        if (slots.context)
+            this.stmtSetSlot.run(agentId, sessionKey, 'context', slots.context, exp);
+        if (slots.facts)
+            this.stmtSetSlot.run(agentId, sessionKey, 'facts', slots.facts, exp);
+        if (slots.tools)
+            this.stmtSetSlot.run(agentId, sessionKey, 'tools', slots.tools, exp);
+        if (slots.meta)
+            await this.setSessionMeta(agentId, sessionKey, slots.meta);
+        if (slots.history && slots.history.length > 0)
+            await this.pushHistory(agentId, sessionKey, slots.history);
+        await this.addActiveSession(agentId, sessionKey);
+    }
+    async evictSession(agentId, sessionKey) {
+        if (!this.isConnected)
+            return;
+        this.stmtEvictSlots.run(agentId, sessionKey);
+        this.stmtEvictHistory.run(agentId, sessionKey);
+        this.stmtEvictWindows.run(agentId, sessionKey);
+        this.stmtDeactivateSession.run(agentId, sessionKey);
+        // cursor
+        this.stmtDeleteKv.run(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:cursor`);
+    }
+    // ─── Touch / TTL ─────────────────────────────────────────────
+    async touchSession(agentId, sessionKey) {
+        if (!this.isConnected)
+            return;
+        const exp = now() + this.config.sessionTTL;
+        this.stmtTouchSlots.run(exp, agentId, sessionKey);
+        this.stmtTouchSession.run(now(), agentId, sessionKey);
+    }
+    async flushPrefix() {
+        if (!this.isConnected)
+            return 0;
+        const db = this.db;
+        const counts = [
+            db.prepare("DELETE FROM cache.slots").run().changes,
+            db.prepare("DELETE FROM cache.history").run().changes,
+            db.prepare("DELETE FROM cache.sessions").run().changes,
+            db.prepare("DELETE FROM cache.windows").run().changes,
+            db.prepare("DELETE FROM cache.kv").run().changes,
+        ];
+        return counts.reduce((a, b) => a + b, 0);
+    }
+    // ─── Fleet Cache (Library L4 Hot Layer) ──────────────────────
+    async setFleetCache(key, value, ttl = 600) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetKv.run(`${this.config.keyPrefix}fleet:${key}`, value, now() + ttl);
+    }
+    async getFleetCache(key) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetKv.get(`${this.config.keyPrefix}fleet:${key}`, now());
+        return row?.value ?? null;
+    }
+    async delFleetCache(key) {
+        if (!this.isConnected)
+            return;
+        this.stmtDeleteKv.run(`${this.config.keyPrefix}fleet:${key}`);
+    }
+    async cacheFleetAgent(agentId, data) {
+        await this.setFleetCache(`agent:${agentId}`, JSON.stringify(data));
+    }
+    async getCachedFleetAgent(agentId) {
+        const val = await this.getFleetCache(`agent:${agentId}`);
+        return val ? JSON.parse(val) : null;
+    }
+    async cacheFleetSummary(summary) {
+        await this.setFleetCache('summary', JSON.stringify(summary), 120);
+    }
+    async getCachedFleetSummary() {
+        const val = await this.getFleetCache('summary');
+        return val ? JSON.parse(val) : null;
+    }
+    async invalidateFleetAgent(agentId) {
+        await this.delFleetCache(`agent:${agentId}`);
+        await this.delFleetCache('summary');
+    }
+    // ─── Query Embedding Cache ────────────────────────────────────
+    async setQueryEmbedding(agentId, sessionKey, embedding) {
+        if (!this.isConnected)
+            return;
+        const encoded = Buffer.from(embedding.buffer).toString('base64');
+        this.stmtSetKv.run(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:qembed`, encoded, now() + this.config.sessionTTL);
+    }
+    async getQueryEmbedding(agentId, sessionKey) {
+        if (!this.isConnected)
+            return null;
+        try {
+            const row = this.stmtGetKv.get(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:qembed`, now());
+            if (!row)
+                return null;
+            const buf = Buffer.from(row.value, 'base64');
+            return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Topic-Scoped Session Operations ─────────────────────────
+    async setTopicSlot(agentId, sessionKey, topicId, slot, value) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetTopicSlot.run(agentId, sessionKey, topicId, slot, value, now() + this.config.sessionTTL);
+    }
+    async getTopicSlot(agentId, sessionKey, topicId, slot) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetTopicSlot.get(agentId, sessionKey, topicId, slot, now());
+        return row?.value ?? null;
+    }
+    async setTopicWindow(agentId, sessionKey, topicId, messages, ttl = 120) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetWindow.run(agentId, sessionKey, topicId, JSON.stringify(messages), now() + ttl);
+    }
+    async getTopicWindow(agentId, sessionKey, topicId) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetWindow.get(agentId, sessionKey, topicId, now());
+        return row ? JSON.parse(row.messages) : null;
+    }
+    async invalidateTopicWindow(agentId, sessionKey, topicId) {
+        if (!this.isConnected)
+            return;
+        this.stmtDeleteWindow.run(agentId, sessionKey, topicId);
+    }
+    async warmTopicSession(agentId, sessionKey, topicId, slots) {
+        if (!this.isConnected)
+            return;
+        const exp = now() + this.config.sessionTTL;
+        if (slots.context)
+            this.stmtSetTopicSlot.run(agentId, sessionKey, topicId, 'context', slots.context, exp);
+        if (slots.facts)
+            this.stmtSetTopicSlot.run(agentId, sessionKey, topicId, 'facts', slots.facts, exp);
+        if (slots.cursor)
+            this.stmtSetTopicSlot.run(agentId, sessionKey, topicId, 'cursor', slots.cursor, exp);
+        if (slots.window)
+            this.stmtSetWindow.run(agentId, sessionKey, topicId, JSON.stringify(slots.window), now() + 120);
+        if (slots.history && slots.history.length > 0) {
+            // Topic history goes into the topic_id-scoped rows
+            const maxRow = this.stmtGetMaxSeq.get(agentId, sessionKey, topicId);
+            let seq = (maxRow?.max_seq ?? -1) + 1;
+            for (const msg of slots.history) {
+                this.stmtInsertHistory.run(agentId, sessionKey, topicId, seq++, JSON.stringify(msg));
+            }
+        }
+    }
+    // ─── Model State ─────────────────────────────────────────────
+    async setModelState(agentId, sessionKey, state) {
+        if (!this.isConnected)
+            return;
+        this.stmtSetKv.run(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:modelstate`, JSON.stringify(state), now() + this.config.sessionTTL);
+    }
+    async getModelState(agentId, sessionKey) {
+        if (!this.isConnected)
+            return null;
+        const row = this.stmtGetKv.get(`${this.config.keyPrefix}${agentId}:s:${sessionKey}:modelstate`, now());
+        return row ? JSON.parse(row.value) : null;
+    }
+    async disconnect() {
+        this._connected = false;
+        this.db = null;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/compaction-fence.d.ts

@@ -1,5 +1,5 @@
 /**
- * HyperMem Compaction Fence
+ * hypermem Compaction Fence
  *
  * Protects the recent conversation tail from being compacted.
  *

package/dist/compaction-fence.js

@@ -1,5 +1,5 @@
 /**
- * HyperMem Compaction Fence
+ * hypermem Compaction Fence
  *
  * Protects the recent conversation tail from being compacted.
  *