instar 0.9.37 → 0.9.39

package/dist/memory/SemanticMemory.js

@@ -0,0 +1,635 @@
+/**
+ * SemanticMemory — Entity-relationship knowledge store with FTS5 search.
+ *
+ * A typed, confidence-tracked knowledge graph stored in SQLite. Entities
+ * represent knowledge (facts, people, projects, tools, patterns, decisions,
+ * lessons) and edges represent relationships between them.
+ *
+ * Key features:
+ *   - FTS5 full-text search with multi-signal ranking
+ *   - Exponential confidence decay (lessons decay slower than facts)
+ *   - BFS graph traversal with cycle detection
+ *   - Export/import for portability
+ *   - Formatted context generation for session injection
+ *
+ * Uses the same better-sqlite3 pattern as MemoryIndex and TopicMemory.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+/**
+ * Strip FTS5 special syntax characters from a query.
+ * Prevents query manipulation via AND, OR, NOT, NEAR, *, column filters.
+ */
+function sanitizeFts5Query(query) {
+    return query
+        .replace(/\b(AND|OR|NOT|NEAR)\b/gi, '')
+        .replace(/[*:"^{}().$@#!~`\\[\]]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export class SemanticMemory {
+    db = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────
+    async open() {
+        if (this.db)
+            return;
+        let BetterSqlite3;
+        try {
+            BetterSqlite3 = await import('better-sqlite3');
+        }
+        catch {
+            throw new Error('SemanticMemory requires better-sqlite3. Run: npm install better-sqlite3');
+        }
+        const constructor = BetterSqlite3.default || BetterSqlite3;
+        // Ensure parent directory exists
+        const dbDir = path.dirname(this.config.dbPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        this.db = constructor(this.config.dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.createSchema();
+    }
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    ensureOpen() {
+        if (!this.db)
+            throw new Error('Database not open. Call open() first.');
+        return this.db;
+    }
+    // ─── Schema ─────────────────────────────────────────────────────
+    createSchema() {
+        const db = this.ensureOpen();
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS entities (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        name TEXT NOT NULL,
+        content TEXT NOT NULL,
+        confidence REAL NOT NULL DEFAULT 1.0,
+        created_at TEXT NOT NULL,
+        last_verified TEXT NOT NULL,
+        last_accessed TEXT NOT NULL,
+        expires_at TEXT,
+        source TEXT NOT NULL,
+        source_session TEXT,
+        tags TEXT NOT NULL DEFAULT '[]',
+        domain TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS edges (
+        id TEXT PRIMARY KEY,
+        from_id TEXT NOT NULL,
+        to_id TEXT NOT NULL,
+        relation TEXT NOT NULL,
+        weight REAL NOT NULL DEFAULT 1.0,
+        context TEXT,
+        created_at TEXT NOT NULL,
+        UNIQUE(from_id, to_id, relation)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id);
+      CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_id);
+      CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type);
+      CREATE INDEX IF NOT EXISTS idx_entities_confidence ON entities(confidence);
+      CREATE INDEX IF NOT EXISTS idx_entities_domain ON entities(domain);
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS entities_fts USING fts5(
+        name,
+        content,
+        tags,
+        content='entities',
+        content_rowid='rowid',
+        tokenize='porter unicode61'
+      );
+
+      -- Triggers to keep FTS in sync with entities table
+      CREATE TRIGGER IF NOT EXISTS entities_fts_ai AFTER INSERT ON entities BEGIN
+        INSERT INTO entities_fts(rowid, name, content, tags)
+        VALUES (new.rowid, new.name, new.content, new.tags);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS entities_fts_ad AFTER DELETE ON entities BEGIN
+        INSERT INTO entities_fts(entities_fts, rowid, name, content, tags)
+        VALUES ('delete', old.rowid, old.name, old.content, old.tags);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS entities_fts_au AFTER UPDATE ON entities BEGIN
+        INSERT INTO entities_fts(entities_fts, rowid, name, content, tags)
+        VALUES ('delete', old.rowid, old.name, old.content, old.tags);
+        INSERT INTO entities_fts(rowid, name, content, tags)
+        VALUES (new.rowid, new.name, new.content, new.tags);
+      END;
+    `);
+    }
+    // ─── Entity CRUD ────────────────────────────────────────────────
+    /**
+     * Store a knowledge entity. Returns the generated UUID.
+     */
+    remember(input) {
+        const db = this.ensureOpen();
+        const id = crypto.randomUUID();
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT INTO entities (id, type, name, content, confidence, created_at, last_verified, last_accessed, expires_at, source, source_session, tags, domain)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, input.type, input.name, input.content, input.confidence, now, input.lastVerified, now, input.expiresAt ?? null, input.source, input.sourceSession ?? null, JSON.stringify(input.tags), input.domain ?? null);
+        return id;
+    }
+    /**
+     * Retrieve an entity by ID, including its connections.
+     * Updates lastAccessed on read.
+     */
+    recall(id) {
+        const db = this.ensureOpen();
+        const row = db.prepare('SELECT * FROM entities WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        // Update lastAccessed
+        const now = new Date().toISOString();
+        db.prepare('UPDATE entities SET last_accessed = ? WHERE id = ?').run(now, id);
+        const entity = rowToEntity({ ...row, last_accessed: now });
+        // Get connections (both outgoing and incoming)
+        const connections = this.getConnections(db, id);
+        return { entity, connections };
+    }
+    /**
+     * Delete an entity and all its edges.
+     */
+    forget(id, _reason) {
+        const db = this.ensureOpen();
+        // Delete edges first (both directions)
+        db.prepare('DELETE FROM edges WHERE from_id = ? OR to_id = ?').run(id, id);
+        // Delete entity
+        db.prepare('DELETE FROM entities WHERE id = ?').run(id);
+    }
+    // ─── Edge CRUD ──────────────────────────────────────────────────
+    /**
+     * Create a relationship between two entities.
+     * Returns the edge ID. Silently returns existing edge ID if duplicate.
+     */
+    connect(fromId, toId, relation, context, weight = 1.0) {
+        const db = this.ensureOpen();
+        // Check for existing edge with same (from, to, relation)
+        const existing = db.prepare('SELECT id FROM edges WHERE from_id = ? AND to_id = ? AND relation = ?').get(fromId, toId, relation);
+        if (existing)
+            return existing.id;
+        const id = crypto.randomUUID();
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT INTO edges (id, from_id, to_id, relation, weight, context, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(id, fromId, toId, relation, weight, context ?? null, now);
+        return id;
+    }
+    // ─── Search ─────────────────────────────────────────────────────
+    /**
+     * Full-text search with multi-signal ranking.
+     * Score = (fts5_rank * 0.4) + (confidence * 0.3) + (recency * 0.2) + (access_freq * 0.1)
+     */
+    search(query, options) {
+        const db = this.ensureOpen();
+        const sanitized = sanitizeFts5Query(query);
+        if (!sanitized)
+            return [];
+        const limit = options?.limit ?? 20;
+        // Build the query
+        let sql = `
+      SELECT e.*, entities_fts.rank as fts_rank
+      FROM entities_fts
+      JOIN entities e ON e.rowid = entities_fts.rowid
+      WHERE entities_fts MATCH ?
+    `;
+        const params = [sanitized];
+        if (options?.types && options.types.length > 0) {
+            const placeholders = options.types.map(() => '?').join(',');
+            sql += ` AND e.type IN (${placeholders})`;
+            params.push(...options.types);
+        }
+        if (options?.domain) {
+            sql += ` AND e.domain = ?`;
+            params.push(options.domain);
+        }
+        if (options?.minConfidence !== undefined) {
+            sql += ` AND e.confidence >= ?`;
+            params.push(options.minConfidence);
+        }
+        sql += ` ORDER BY entities_fts.rank LIMIT ?`;
+        params.push(limit * 3); // Fetch extra for re-ranking
+        const rows = db.prepare(sql).all(...params);
+        // Multi-signal re-ranking
+        const now = Date.now();
+        const scored = rows.map(row => {
+            const entity = rowToEntity(row);
+            // Normalize FTS rank (BM25 returns negative, more negative = more relevant)
+            const ftsScore = 1 / (1 + Math.abs(row.fts_rank));
+            // Recency: how recently was this verified?
+            const daysSinceVerified = (now - new Date(entity.lastVerified).getTime()) / (1000 * 60 * 60 * 24);
+            const recencyScore = Math.exp(-0.02 * daysSinceVerified); // Gentle decay
+            // Access frequency proxy: recent access = higher value
+            const daysSinceAccessed = (now - new Date(entity.lastAccessed).getTime()) / (1000 * 60 * 60 * 24);
+            const accessScore = Math.exp(-0.01 * daysSinceAccessed);
+            const score = ftsScore * 0.4 +
+                entity.confidence * 0.3 +
+                recencyScore * 0.2 +
+                accessScore * 0.1;
+            return { ...entity, score };
+        });
+        // Sort by composite score (descending) and trim to limit
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+    // ─── Confidence Decay ───────────────────────────────────────────
+    /**
+     * Apply exponential confidence decay to all entities.
+     * formula: new_confidence = confidence * exp(-0.693 * days_since_verified / half_life)
+     */
+    decayAll() {
+        const db = this.ensureOpen();
+        const rows = db.prepare('SELECT * FROM entities').all();
+        const now = Date.now();
+        let decayed = 0;
+        let expired = 0;
+        let minConf = Infinity;
+        let maxConf = -Infinity;
+        let sumConf = 0;
+        const update = db.prepare('UPDATE entities SET confidence = ? WHERE id = ?');
+        const del = db.prepare('DELETE FROM entities WHERE id = ?');
+        const delEdges = db.prepare('DELETE FROM edges WHERE from_id = ? OR to_id = ?');
+        const runDecay = db.transaction(() => {
+            for (const row of rows) {
+                const halfLife = row.type === 'lesson'
+                    ? this.config.lessonDecayHalfLifeDays
+                    : this.config.decayHalfLifeDays;
+                const daysSinceVerified = (now - new Date(row.last_verified).getTime()) / (1000 * 60 * 60 * 24);
+                const newConfidence = row.confidence * Math.exp(-0.693 * daysSinceVerified / halfLife);
+                // Check hard expiry
+                if (row.expires_at && new Date(row.expires_at).getTime() < now) {
+                    delEdges.run(row.id, row.id);
+                    del.run(row.id);
+                    expired++;
+                    continue;
+                }
+                if (Math.abs(newConfidence - row.confidence) > 0.001) {
+                    update.run(newConfidence, row.id);
+                    decayed++;
+                    minConf = Math.min(minConf, newConfidence);
+                    maxConf = Math.max(maxConf, newConfidence);
+                    sumConf += newConfidence;
+                }
+                else {
+                    minConf = Math.min(minConf, row.confidence);
+                    maxConf = Math.max(maxConf, row.confidence);
+                    sumConf += row.confidence;
+                }
+            }
+        });
+        runDecay();
+        const activeCount = rows.length - expired;
+        return {
+            entitiesProcessed: rows.length,
+            entitiesDecayed: decayed,
+            entitiesExpired: expired,
+            minConfidence: activeCount > 0 ? minConf : 0,
+            maxConfidence: activeCount > 0 ? maxConf : 0,
+            avgConfidence: activeCount > 0 ? sumConf / activeCount : 0,
+        };
+    }
+    // ─── Verify ─────────────────────────────────────────────────────
+    /**
+     * Re-verify an entity, refreshing lastVerified and optionally updating confidence.
+     */
+    verify(id, newConfidence) {
+        const db = this.ensureOpen();
+        const now = new Date().toISOString();
+        if (newConfidence !== undefined) {
+            db.prepare('UPDATE entities SET last_verified = ?, confidence = ? WHERE id = ?')
+                .run(now, newConfidence, id);
+        }
+        else {
+            db.prepare('UPDATE entities SET last_verified = ? WHERE id = ?')
+                .run(now, id);
+        }
+    }
+    // ─── Supersede ──────────────────────────────────────────────────
+    /**
+     * Mark an entity as superseded by a newer one.
+     * Creates a 'supersedes' edge and lowers the old entity's confidence.
+     */
+    supersede(oldId, newId, reason) {
+        const db = this.ensureOpen();
+        // Create supersedes edge (new -> old)
+        this.connect(newId, oldId, 'supersedes', reason);
+        // Lower old entity's confidence by half
+        const old = db.prepare('SELECT confidence FROM entities WHERE id = ?').get(oldId);
+        if (old) {
+            db.prepare('UPDATE entities SET confidence = ? WHERE id = ?')
+                .run(old.confidence * 0.5, oldId);
+        }
+    }
+    // ─── Graph Traversal ───────────────────────────────────────────
+    /**
+     * BFS graph traversal from a starting entity.
+     * Returns all reachable entities (excluding the start) up to maxDepth.
+     */
+    explore(startId, options) {
+        const db = this.ensureOpen();
+        const maxDepth = options?.maxDepth ?? 2;
+        const relations = options?.relations;
+        const minWeight = options?.minWeight ?? 0;
+        const visited = new Set([startId]);
+        const result = [];
+        let frontier = [startId];
+        for (let depth = 0; depth < maxDepth && frontier.length > 0; depth++) {
+            const nextFrontier = [];
+            for (const nodeId of frontier) {
+                // Get outgoing edges
+                let outgoing = db.prepare('SELECT * FROM edges WHERE from_id = ?').all(nodeId);
+                // Get incoming edges
+                let incoming = db.prepare('SELECT * FROM edges WHERE to_id = ?').all(nodeId);
+                // Filter by relation type
+                if (relations) {
+                    outgoing = outgoing.filter(e => relations.includes(e.relation));
+                    incoming = incoming.filter(e => relations.includes(e.relation));
+                }
+                // Filter by weight
+                if (minWeight > 0) {
+                    outgoing = outgoing.filter(e => e.weight >= minWeight);
+                    incoming = incoming.filter(e => e.weight >= minWeight);
+                }
+                // Process outgoing: neighbor is the "to" end
+                for (const edge of outgoing) {
+                    if (!visited.has(edge.to_id)) {
+                        visited.add(edge.to_id);
+                        const row = db.prepare('SELECT * FROM entities WHERE id = ?').get(edge.to_id);
+                        if (row) {
+                            result.push(rowToEntity(row));
+                            nextFrontier.push(edge.to_id);
+                        }
+                    }
+                }
+                // Process incoming: neighbor is the "from" end
+                for (const edge of incoming) {
+                    if (!visited.has(edge.from_id)) {
+                        visited.add(edge.from_id);
+                        const row = db.prepare('SELECT * FROM entities WHERE id = ?').get(edge.from_id);
+                        if (row) {
+                            result.push(rowToEntity(row));
+                            nextFrontier.push(edge.from_id);
+                        }
+                    }
+                }
+            }
+            frontier = nextFrontier;
+        }
+        return result;
+    }
+    // ─── Stale Detection ───────────────────────────────────────────
+    /**
+     * Find entities that are stale (low confidence or old).
+     */
+    findStale(options) {
+        const db = this.ensureOpen();
+        const limit = options?.limit ?? 50;
+        let sql = 'SELECT * FROM entities WHERE 1=1';
+        const params = [];
+        if (options?.maxConfidence !== undefined) {
+            sql += ' AND confidence <= ?';
+            params.push(options.maxConfidence);
+        }
+        if (options?.olderThan) {
+            sql += ' AND last_verified < ?';
+            params.push(options.olderThan);
+        }
+        sql += ' ORDER BY confidence ASC, last_verified ASC LIMIT ?';
+        params.push(limit);
+        const rows = db.prepare(sql).all(...params);
+        return rows.map(rowToEntity);
+    }
+    // ─── Export / Import ───────────────────────────────────────────
+    /**
+     * Export all entities and edges as a JSON-serializable structure.
+     */
+    export() {
+        const db = this.ensureOpen();
+        const entityRows = db.prepare('SELECT * FROM entities').all();
+        const edgeRows = db.prepare('SELECT * FROM edges').all();
+        return {
+            entities: entityRows.map(rowToEntity),
+            edges: edgeRows.map(rowToEdge),
+        };
+    }
+    /**
+     * Import entities and edges, skipping duplicates by ID.
+     */
+    import(data) {
+        const db = this.ensureOpen();
+        let entitiesImported = 0;
+        let edgesImported = 0;
+        let entitiesSkipped = 0;
+        let edgesSkipped = 0;
+        const insertEntity = db.prepare(`
+      INSERT INTO entities (id, type, name, content, confidence, created_at, last_verified, last_accessed, expires_at, source, source_session, tags, domain)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertEdge = db.prepare(`
+      INSERT INTO edges (id, from_id, to_id, relation, weight, context, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        const checkEntity = db.prepare('SELECT id FROM entities WHERE id = ?');
+        const checkEdge = db.prepare('SELECT id FROM edges WHERE id = ?');
+        const runImport = db.transaction(() => {
+            for (const entity of data.entities) {
+                if (checkEntity.get(entity.id)) {
+                    entitiesSkipped++;
+                    continue;
+                }
+                insertEntity.run(entity.id, entity.type, entity.name, entity.content, entity.confidence, entity.createdAt, entity.lastVerified, entity.lastAccessed, entity.expiresAt ?? null, entity.source, entity.sourceSession ?? null, JSON.stringify(entity.tags), entity.domain ?? null);
+                entitiesImported++;
+            }
+            for (const edge of data.edges) {
+                if (checkEdge.get(edge.id)) {
+                    edgesSkipped++;
+                    continue;
+                }
+                insertEdge.run(edge.id, edge.fromId, edge.toId, edge.relation, edge.weight, edge.context ?? null, edge.createdAt);
+                edgesImported++;
+            }
+        });
+        runImport();
+        return { entitiesImported, edgesImported, entitiesSkipped, edgesSkipped };
+    }
+    // ─── Statistics ─────────────────────────────────────────────────
+    /**
+     * Get aggregate statistics about the memory store.
+     */
+    stats() {
+        const db = this.ensureOpen();
+        const entityCount = db.prepare('SELECT COUNT(*) as cnt FROM entities').get().cnt;
+        const edgeCount = db.prepare('SELECT COUNT(*) as cnt FROM edges').get().cnt;
+        // Count by type
+        const typeCounts = db.prepare('SELECT type, COUNT(*) as cnt FROM entities GROUP BY type').all();
+        const entityCountsByType = {};
+        for (const row of typeCounts) {
+            entityCountsByType[row.type] = row.cnt;
+        }
+        // Avg confidence
+        const avgRow = db.prepare('SELECT AVG(confidence) as avg FROM entities').get();
+        const avgConfidence = avgRow.avg ?? 0;
+        // Stale count
+        const staleCount = db.prepare('SELECT COUNT(*) as cnt FROM entities WHERE confidence < ?').get(this.config.staleThreshold).cnt;
+        // DB file size
+        let dbSizeBytes = 0;
+        try {
+            dbSizeBytes = fs.statSync(this.config.dbPath).size;
+        }
+        catch {
+            // File may not exist yet  @silent-fallback-ok: stat before DB fully flushed
+        }
+        return {
+            totalEntities: entityCount,
+            totalEdges: edgeCount,
+            entityCountsByType: entityCountsByType,
+            avgConfidence: Math.round(avgConfidence * 100) / 100, // Round to 2 decimal places
+            staleCount,
+            dbSizeBytes,
+        };
+    }
+    // ─── Context Generation ─────────────────────────────────────────
+    /**
+     * Generate formatted markdown context for a query, suitable for session injection.
+     * Returns empty string if no relevant entities found.
+     */
+    getRelevantContext(query, options) {
+        const maxTokens = options?.maxTokens ?? 2000;
+        const limit = options?.limit ?? 10;
+        const results = this.search(query, { limit });
+        if (results.length === 0)
+            return '';
+        const lines = [];
+        let estimatedTokens = 0;
+        for (const entity of results) {
+            const entry = `### ${entity.name} (${entity.type})\n${entity.content}\n`;
+            // Rough token estimate: ~0.75 tokens per word
+            const entryTokens = entry.split(/\s+/).length / 0.75;
+            if (estimatedTokens + entryTokens > maxTokens)
+                break;
+            lines.push(entry);
+            estimatedTokens += entryTokens;
+        }
+        return lines.join('\n');
+    }
+    // ─── Private Helpers ───────────────────────────────────────────
+    getConnections(db, entityId) {
+        const connections = [];
+        // Outgoing edges — use explicit column aliases to avoid JOIN collisions
+        const outgoing = db.prepare(`
+      SELECT
+        e.id as edge_id, e.from_id, e.to_id, e.relation, e.weight,
+        e.context as edge_context, e.created_at as edge_created_at,
+        ent.id as ent_id, ent.type, ent.name, ent.content, ent.confidence,
+        ent.created_at as ent_created_at, ent.last_verified, ent.last_accessed,
+        ent.expires_at, ent.source, ent.source_session, ent.tags, ent.domain
+      FROM edges e
+      JOIN entities ent ON ent.id = e.to_id
+      WHERE e.from_id = ?
+    `).all(entityId);
+        for (const row of outgoing) {
+            connections.push({
+                entity: joinRowToEntity(row),
+                edge: joinRowToEdge(row),
+                direction: 'outgoing',
+            });
+        }
+        // Incoming edges
+        const incoming = db.prepare(`
+      SELECT
+        e.id as edge_id, e.from_id, e.to_id, e.relation, e.weight,
+        e.context as edge_context, e.created_at as edge_created_at,
+        ent.id as ent_id, ent.type, ent.name, ent.content, ent.confidence,
+        ent.created_at as ent_created_at, ent.last_verified, ent.last_accessed,
+        ent.expires_at, ent.source, ent.source_session, ent.tags, ent.domain
+      FROM edges e
+      JOIN entities ent ON ent.id = e.from_id
+      WHERE e.to_id = ?
+    `).all(entityId);
+        for (const row of incoming) {
+            connections.push({
+                entity: joinRowToEntity(row),
+                edge: joinRowToEdge(row),
+                direction: 'incoming',
+            });
+        }
+        return connections;
+    }
+}
+// ─── Converters ─────────────────────────────────────────────────
+function rowToEntity(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        name: row.name,
+        content: row.content,
+        confidence: row.confidence,
+        createdAt: row.created_at,
+        lastVerified: row.last_verified,
+        lastAccessed: row.last_accessed,
+        expiresAt: row.expires_at ?? undefined,
+        source: row.source,
+        sourceSession: row.source_session ?? undefined,
+        tags: JSON.parse(row.tags),
+        domain: row.domain ?? undefined,
+    };
+}
+function rowToEdge(row) {
+    return {
+        id: row.id,
+        fromId: row.from_id,
+        toId: row.to_id,
+        relation: row.relation,
+        weight: row.weight,
+        context: row.context ?? undefined,
+        createdAt: row.created_at,
+    };
+}
+/** Convert a JOIN row (with explicit aliases) to a MemoryEntity */
+function joinRowToEntity(row) {
+    return {
+        id: row.ent_id,
+        type: row.type,
+        name: row.name,
+        content: row.content,
+        confidence: row.confidence,
+        createdAt: row.ent_created_at,
+        lastVerified: row.last_verified,
+        lastAccessed: row.last_accessed,
+        expiresAt: row.expires_at ?? undefined,
+        source: row.source,
+        sourceSession: row.source_session ?? undefined,
+        tags: JSON.parse(row.tags),
+        domain: row.domain ?? undefined,
+    };
+}
+/** Convert a JOIN row (with explicit aliases) to a MemoryEdge */
+function joinRowToEdge(row) {
+    return {
+        id: row.edge_id,
+        fromId: row.from_id,
+        toId: row.to_id,
+        relation: row.relation,
+        weight: row.weight,
+        context: row.edge_context ?? undefined,
+        createdAt: row.edge_created_at,
+    };
+}
+//# sourceMappingURL=SemanticMemory.js.map

package/dist/memory/SemanticMemory.js.map

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

package/dist/server/AgentServer.d.ts

@@ -67,6 +67,7 @@ export declare class AgentServer {
         adaptiveTrust?: import('../core/AdaptiveTrust.js').AdaptiveTrust;
         memoryMonitor?: import('../monitoring/MemoryPressureMonitor.js').MemoryPressureMonitor;
         orphanReaper?: import('../monitoring/OrphanProcessReaper.js').OrphanProcessReaper;
+        semanticMemory?: import('../memory/SemanticMemory.js').SemanticMemory;
         coordinator?: MultiMachineCoordinator;
         localSigningKeyPem?: string;
     });