@psiclawops/hypermem 0.5.0 → 0.5.1

package/dist/temporal-store.js

@@ -0,0 +1,149 @@
+/**
+ * hypermem Temporal Store
+ *
+ * Time-range retrieval over indexed facts. Uses the temporal_index table
+ * in library.db to answer LoCoMo-style temporal questions:
+ *   "What happened before X?"
+ *   "What changed between January and March?"
+ *   "What was the most recent thing about Y?"
+ *
+ * occurred_at is initially populated from created_at (ingest time as proxy,
+ * confidence=0.5). Future: date extraction from fact text (confidence=0.9).
+ *
+ * Query path: SQL time-range filter on temporal_index JOIN facts.
+ * No vector search involved — purely temporal ordering.
+ */
+/**
+ * Temporal signal keywords. If any of these appear in a query string,
+ * the temporal retrieval path fires alongside vector/FTS retrieval.
+ */
+const TEMPORAL_SIGNALS = [
+    'before', 'after', 'when', 'during', 'between', 'since', 'until',
+    'last', 'first', 'recent', 'earlier', 'later', 'previously', 'at the time',
+    'used to', 'now', 'still', 'anymore', 'changed', 'updated', 'latest',
+    'yesterday', 'today', 'week', 'month', 'year', 'january', 'february',
+    'march', 'april', 'may', 'june', 'july', 'august', 'september',
+    'october', 'november', 'december', 'q1', 'q2', 'q3', 'q4',
+];
+/**
+ * Returns true if the query string contains temporal signals.
+ */
+export function hasTemporalSignals(query) {
+    const lower = query.toLowerCase();
+    return TEMPORAL_SIGNALS.some(signal => lower.includes(signal));
+}
+export class TemporalStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Index a newly created or updated fact into temporal_index.
+     * Uses created_at as occurred_at proxy (confidence=0.5).
+     * Safe to call multiple times — uses INSERT OR REPLACE.
+     */
+    indexFact(factId, agentId, createdAt, opts) {
+        const ingestMs = new Date(createdAt).getTime();
+        const occurredMs = opts?.occurredAt ?? ingestMs;
+        this.db.prepare(`
+      INSERT OR REPLACE INTO temporal_index
+        (fact_id, agent_id, occurred_at, ingest_at, time_ref, confidence)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(factId, agentId, occurredMs, ingestMs, opts?.timeRef ?? null, opts?.confidence ?? 0.5);
+    }
+    /**
+     * Time-range query. Returns facts in temporal order.
+     * Joins temporal_index with facts to get content.
+     */
+    timeRangeQuery(opts = {}) {
+        const limit = opts.limit ?? 20;
+        const order = opts.order ?? 'DESC';
+        const minConf = opts.minConfidence ?? 0;
+        const params = [];
+        const conditions = [
+            'f.superseded_by IS NULL',
+            'f.decay_score < 0.8',
+            `t.confidence >= ${minConf}`,
+        ];
+        if (opts.agentId) {
+            conditions.push('t.agent_id = ?');
+            params.push(opts.agentId);
+        }
+        if (opts.domain) {
+            conditions.push('f.domain = ?');
+            params.push(opts.domain);
+        }
+        if (opts.fromMs !== undefined) {
+            conditions.push('t.occurred_at >= ?');
+            params.push(opts.fromMs);
+        }
+        if (opts.toMs !== undefined) {
+            conditions.push('t.occurred_at <= ?');
+            params.push(opts.toMs);
+        }
+        const where = conditions.length > 0
+            ? `WHERE ${conditions.join(' AND ')}`
+            : '';
+        const sql = `
+      SELECT
+        t.fact_id,
+        t.agent_id,
+        f.content,
+        f.domain,
+        t.occurred_at,
+        t.ingest_at,
+        t.time_ref,
+        t.confidence
+      FROM temporal_index t
+      JOIN facts f ON f.id = t.fact_id
+      ${where}
+      ORDER BY t.occurred_at ${order}
+      LIMIT ?
+    `;
+        params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(r => ({
+            factId: r.fact_id,
+            agentId: r.agent_id,
+            content: r.content,
+            domain: r.domain || null,
+            occurredAt: r.occurred_at,
+            ingestAt: r.ingest_at,
+            timeRef: r.time_ref || null,
+            confidence: r.confidence,
+        }));
+    }
+    /**
+     * Get the most recent N facts for an agent (no time bounds).
+     * Useful for "what was the last thing about X" style queries.
+     */
+    mostRecent(agentId, limit = 10) {
+        return this.timeRangeQuery({ agentId, limit, order: 'DESC' });
+    }
+    /**
+     * Get fact count in the temporal index for an agent.
+     */
+    getIndexedCount(agentId) {
+        const row = this.db.prepare('SELECT COUNT(*) AS count FROM temporal_index WHERE agent_id = ?').get(agentId);
+        return row.count;
+    }
+    /**
+     * Backfill any facts not yet in the temporal index.
+     * Safe to run multiple times. Uses INSERT OR IGNORE.
+     */
+    backfill() {
+        const result = this.db.prepare(`
+      INSERT OR IGNORE INTO temporal_index (fact_id, agent_id, occurred_at, ingest_at, confidence)
+      SELECT
+        id,
+        agent_id,
+        CAST((julianday(created_at) - 2440587.5) * 86400000 AS INTEGER),
+        CAST((julianday(created_at) - 2440587.5) * 86400000 AS INTEGER),
+        0.5
+      FROM facts
+      WHERE superseded_by IS NULL
+    `).run();
+        return result.changes;
+    }
+}
+//# sourceMappingURL=temporal-store.js.map

package/dist/topic-detector.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Topic Detector (P3.1)
+ *
+ * Heuristic-based topic shift detection. No model calls.
+ * Uses explicit markers, entity shift, conversation gap, and continuation signals.
+ */
+import type { NeutralMessage } from './types.js';
+/**
+ * Strip inbound protocol metadata from message text before topic detection.
+ *
+ * Removes:
+ *   - "Sender (untrusted metadata):" header blocks through next blank line
+ *   - Pure timestamp lines: ISO 8601, bracket format, System YYYY-MM-DD
+ *   - JSON code blocks containing "\"schema\": \"openclaw" or "inbound_meta"
+ *   - Any ```json...``` block whose content contains those markers
+ *
+ * Called as the FIRST step in detectTopicShift() so that pattern matching
+ * operates on clean user content, not on injected transport headers.
+ */
+export declare function stripMessageMetadata(text: string): string;
+export interface TopicSignal {
+    topicId: string | null;
+    isNewTopic: boolean;
+    confidence: number;
+    topicName: string | null;
+}
+/**
+ * Detect whether the incoming message starts a new conversation topic.
+ *
+ * @param incomingMessage  The new user message to evaluate
+ * @param recentMessages   Last N messages for context (any role)
+ * @param currentTopicId   The active topic id, or null if none
+ */
+export declare function detectTopicShift(incomingMessage: NeutralMessage, recentMessages: NeutralMessage[], currentTopicId: string | null): TopicSignal;
+//# sourceMappingURL=topic-detector.d.ts.map

package/dist/topic-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-detector.d.ts","sourceRoot":"","sources":["../src/topic-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6EzD;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AA6GD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,cAAc,EAC/B,cAAc,EAAE,cAAc,EAAE,EAChC,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,WAAW,CAkEb"}

package/dist/topic-detector.js

@@ -0,0 +1,249 @@
+/**
+ * Topic Detector (P3.1)
+ *
+ * Heuristic-based topic shift detection. No model calls.
+ * Uses explicit markers, entity shift, conversation gap, and continuation signals.
+ */
+// ─── Metadata Stripping ───────────────────────────────────────────────────────
+/**
+ * Strip inbound protocol metadata from message text before topic detection.
+ *
+ * Removes:
+ *   - "Sender (untrusted metadata):" header blocks through next blank line
+ *   - Pure timestamp lines: ISO 8601, bracket format, System YYYY-MM-DD
+ *   - JSON code blocks containing "\"schema\": \"openclaw" or "inbound_meta"
+ *   - Any ```json...``` block whose content contains those markers
+ *
+ * Called as the FIRST step in detectTopicShift() so that pattern matching
+ * operates on clean user content, not on injected transport headers.
+ */
+export function stripMessageMetadata(text) {
+    if (!text)
+        return text;
+    const lines = text.split('\n');
+    const result = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // ── ```json blocks containing openclaw markers ──────────────────────────
+        if (/^```json\s*$/i.test(line)) {
+            // Peek ahead to collect the block
+            const blockLines = [line];
+            let j = i + 1;
+            let closed = false;
+            while (j < lines.length) {
+                blockLines.push(lines[j]);
+                if (lines[j].trim() === '```') {
+                    closed = true;
+                    j++;
+                    break;
+                }
+                j++;
+            }
+            const blockContent = blockLines.join('\n');
+            if (blockContent.includes('"schema": "openclaw') ||
+                blockContent.includes('inbound_meta')) {
+                // Skip the whole block
+                i = j;
+                continue;
+            }
+            // Not an openclaw block — keep as-is
+            result.push(...blockLines.slice(0, closed ? blockLines.length : blockLines.length));
+            i = j;
+            continue;
+        }
+        // ── Sender (untrusted metadata): block ──────────────────────────────────
+        if (/^Sender \(untrusted metadata\):/i.test(line)) {
+            // Skip through next blank line or closing ```
+            i++;
+            while (i < lines.length) {
+                const l = lines[i];
+                if (l.trim() === '' || l.trim() === '```') {
+                    i++; // consume the blank/closing line too
+                    break;
+                }
+                i++;
+            }
+            continue;
+        }
+        // ── Pure timestamp lines ─────────────────────────────────────────────────
+        // ISO 8601: 2026-04-05T02:43:00Z  /  2026-04-05T02:43:00.000Z
+        if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?$/.test(line.trim())) {
+            i++;
+            continue;
+        }
+        // Bracket format: [Mon 2026-04-05 02:43 MST]
+        if (/^\[\w{3}\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}\s+\w+\]$/.test(line.trim())) {
+            i++;
+            continue;
+        }
+        // System YYYY-MM-DD
+        if (/^System\s+\d{4}-\d{2}-\d{2}$/.test(line.trim())) {
+            i++;
+            continue;
+        }
+        result.push(line);
+        i++;
+    }
+    return result.join('\n').trim();
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+const GAP_MS = 30 * 60 * 1000; // 30 minutes
+// Explicit topic-shift markers
+const SHIFT_PATTERNS = [
+    /^(?:let'?s?|can we)\s+(?:talk|discuss|chat)\s+about\s+(.+)/i,
+    /^switching\s+to\s+(.+)/i,
+    /^new\s+topic\s*[:—-]\s*(.+)/i,
+    /^regarding\s+(.+)/i,
+    /^on\s+(?:the\s+)?(?:topic\s+of\s+)?(.+)/i,
+    /^(?:i\s+want\s+to\s+)?(?:talk|ask)\s+about\s+(.+)/i,
+    /^(?:change\s+of\s+)?subject\s*[:—-]\s*(.+)/i,
+];
+// Continuation markers — if any match, this is almost certainly same topic
+const CONTINUATION_PATTERNS = [
+    /^\s*(?:also|and|additionally|furthermore|moreover|plus)\b/i,
+    /^\s*(?:what\s+about|how\s+about)\s+/i,
+    /^\s*(?:following\s+up|follow[- ]up|just\s+to\s+follow\s+up)\b/i,
+    /^\s*(?:actually|wait|oh)\s*[,—-]/i,
+    /^\s*(?:one\s+more\s+thing|another\s+thing|by\s+the\s+way)\b/i,
+];
+// Stop words for noun-phrase extraction
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'this', 'that', 'these', 'those', 'i', 'you', 'we', 'they',
+    'it', 'he', 'she', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should',
+    'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'on', 'at', 'for', 'with',
+    'by', 'from', 'up', 'about', 'into', 'through', 'and', 'or', 'but', 'not',
+    'so', 'yet', 'both', 'either', 'neither', 'nor', 'as', 'just', 'than',
+    'then', 'because', 'while', 'although', 'if', 'when', 'where', 'how', 'what',
+    'which', 'who', 'whom', 'whose',
+]);
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Extract a short heuristic topic name from message text (max 40 chars).
+ * Returns the first meaningful noun phrase or the first substantive clause.
+ */
+function extractTopicName(text) {
+    // First, check if any shift pattern captured a phrase
+    for (const pattern of SHIFT_PATTERNS) {
+        const m = text.match(pattern);
+        if (m?.[1]) {
+            const phrase = m[1].replace(/[?!.]+$/, '').trim();
+            return phrase.slice(0, 40);
+        }
+    }
+    // Fall back: split into words, skip stop words, take first 5 content words
+    const words = text
+        .replace(/[^\w\s'-]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length > 1 && !STOP_WORDS.has(w.toLowerCase()));
+    if (words.length === 0) {
+        // Last resort: first 40 chars
+        return text.slice(0, 40).trim();
+    }
+    return words.slice(0, 5).join(' ').slice(0, 40);
+}
+/**
+ * Naive named-entity heuristic: extract capitalized words (length ≥ 3) and
+ * quoted strings as "entities". Returns a Set<string> (lowercased).
+ */
+function extractEntities(text) {
+    const entities = new Set();
+    // Quoted strings
+    const quoted = text.match(/["']([^"']{2,30})["']/g);
+    if (quoted) {
+        for (const q of quoted)
+            entities.add(q.replace(/["']/g, '').toLowerCase());
+    }
+    // Capitalized words (simple NER proxy — excludes sentence-start)
+    const words = text.split(/\s+/);
+    for (let i = 1; i < words.length; i++) {
+        const w = words[i].replace(/[^a-zA-Z-]/g, '');
+        if (w.length >= 3 && /^[A-Z]/.test(w)) {
+            entities.add(w.toLowerCase());
+        }
+    }
+    return entities;
+}
+/**
+ * Jaccard similarity between two entity sets (0 = no overlap, 1 = identical).
+ */
+function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1;
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let intersect = 0;
+    for (const x of a) {
+        if (b.has(x))
+            intersect++;
+    }
+    const union = a.size + b.size - intersect;
+    return intersect / union;
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+/**
+ * Detect whether the incoming message starts a new conversation topic.
+ *
+ * @param incomingMessage  The new user message to evaluate
+ * @param recentMessages   Last N messages for context (any role)
+ * @param currentTopicId   The active topic id, or null if none
+ */
+export function detectTopicShift(incomingMessage, recentMessages, currentTopicId) {
+    // Strip inbound protocol metadata FIRST — pattern matching must operate on
+    // clean user content, not on transport headers (timestamps, sender blocks, etc.)
+    const text = stripMessageMetadata(incomingMessage.textContent ?? '');
+    // Guard: if the message is entirely metadata with no real content, never
+    // create a new topic — there is nothing to name or classify.
+    if (!text) {
+        return { topicId: currentTopicId, isNewTopic: false, confidence: 0.9, topicName: null };
+    }
+    // ── 1. Continuation check (highest priority) ──────────────────────────────
+    for (const pat of CONTINUATION_PATTERNS) {
+        if (pat.test(text)) {
+            return { topicId: currentTopicId, isNewTopic: false, confidence: 0.85, topicName: null };
+        }
+    }
+    // ── 2. Explicit shift marker ───────────────────────────────────────────────
+    for (const pat of SHIFT_PATTERNS) {
+        if (pat.test(text)) {
+            const name = extractTopicName(text);
+            return { topicId: null, isNewTopic: true, confidence: 0.95, topicName: name };
+        }
+    }
+    // ── 3. Conversation gap (empty history or >30 min since last message) ──────
+    if (recentMessages.length === 0) {
+        const name = extractTopicName(text);
+        return { topicId: null, isNewTopic: true, confidence: 0.8, topicName: name };
+    }
+    // Find last message with a timestamp in metadata
+    const lastMsg = recentMessages[recentMessages.length - 1];
+    const lastTs = lastMsg.metadata?.createdAt
+        ? new Date(lastMsg.metadata.createdAt).getTime()
+        : null;
+    if (lastTs !== null && !isNaN(lastTs)) {
+        const now = Date.now();
+        if (now - lastTs > GAP_MS) {
+            const name = extractTopicName(text);
+            return { topicId: null, isNewTopic: true, confidence: 0.75, topicName: name };
+        }
+    }
+    // ── 4. Entity shift (compare incoming to last 3 messages) ─────────────────
+    const incomingEntities = extractEntities(text);
+    const contextWindow = recentMessages.slice(-3);
+    const contextText = contextWindow
+        .map(m => m.textContent ?? '')
+        .join(' ');
+    if (incomingEntities.size > 0 && contextText.length > 0) {
+        const contextEntities = extractEntities(contextText);
+        const similarity = jaccardSimilarity(incomingEntities, contextEntities);
+        // Low similarity + no continuation marker → likely a new topic
+        if (similarity < 0.1) {
+            const name = extractTopicName(text);
+            return { topicId: null, isNewTopic: true, confidence: 0.6, topicName: name };
+        }
+    }
+    // ── 5. Default: continue current topic ────────────────────────────────────
+    return { topicId: currentTopicId, isNewTopic: false, confidence: 0.7, topicName: null };
+}
+//# sourceMappingURL=topic-detector.js.map

package/dist/topic-store.d.ts

@@ -0,0 +1,45 @@
+/**
+ * hypermem Topic Store
+ *
+ * Cross-session topic tracking. Topics are conversation threads that
+ * can span multiple sessions and channels.
+ * Lives in the central library DB.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { Topic, TopicStatus } from './types.js';
+export declare class TopicStore {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /**
+     * Create a new topic.
+     */
+    create(agentId: string, name: string, description?: string, visibility?: string): Topic;
+    /**
+     * Touch a topic — update activity tracking.
+     */
+    touch(topicId: number, sessionKey: string, messagesDelta?: number): void;
+    /**
+     * Get active topics for an agent.
+     */
+    getActive(agentId: string, limit?: number): Topic[];
+    /**
+     * Get all topics for an agent.
+     */
+    getAll(agentId: string, opts?: {
+        status?: TopicStatus;
+        limit?: number;
+    }): Topic[];
+    /**
+     * Find topics matching a query.
+     */
+    search(agentId: string, query: string, limit?: number): Topic[];
+    /**
+     * Mark dormant topics (no activity for dormantAfterHours).
+     */
+    markDormant(agentId: string, dormantAfterHours?: number): number;
+    /**
+     * Close dormant topics.
+     */
+    closeDormant(agentId: string, closedAfterDays?: number): number;
+}
+//# sourceMappingURL=topic-store.d.ts.map

package/dist/topic-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-store.d.ts","sourceRoot":"","sources":["../src/topic-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqBrD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK;IAwBvF;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,IAAI;IAY3E;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,EAAE;IAWvD;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,KAAK,EAAE;IAoBV;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,EAAE;IAanE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAW,GAAG,MAAM;IAYpE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM;CAWnE"}

package/dist/topic-store.js

@@ -0,0 +1,136 @@
+/**
+ * hypermem Topic Store
+ *
+ * Cross-session topic tracking. Topics are conversation threads that
+ * can span multiple sessions and channels.
+ * Lives in the central library DB.
+ */
+function nowIso() {
+    return new Date().toISOString();
+}
+function parseTopicRow(row) {
+    return {
+        id: row.id,
+        agentId: row.agent_id,
+        name: row.name,
+        description: row.description || null,
+        status: row.status,
+        visibility: row.visibility || 'org',
+        lastSessionKey: row.last_session_key || null,
+        messageCount: row.message_count,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export class TopicStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a new topic.
+     */
+    create(agentId, name, description, visibility) {
+        const now = nowIso();
+        const result = this.db.prepare(`
+      INSERT INTO topics (agent_id, name, description, status, visibility, message_count, created_at, updated_at)
+      VALUES (?, ?, ?, 'active', ?, 0, ?, ?)
+    `).run(agentId, name, description || null, visibility || 'org', now, now);
+        const id = Number(result.lastInsertRowid);
+        return {
+            id,
+            agentId,
+            name,
+            description: description || null,
+            status: 'active',
+            visibility: visibility || 'org',
+            lastSessionKey: null,
+            messageCount: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /**
+     * Touch a topic — update activity tracking.
+     */
+    touch(topicId, sessionKey, messagesDelta = 1) {
+        const now = nowIso();
+        this.db.prepare(`
+      UPDATE topics
+      SET last_session_key = ?,
+          message_count = message_count + ?,
+          status = 'active',
+          updated_at = ?
+      WHERE id = ?
+    `).run(sessionKey, messagesDelta, now, topicId);
+    }
+    /**
+     * Get active topics for an agent.
+     */
+    getActive(agentId, limit = 20) {
+        const rows = this.db.prepare(`
+      SELECT * FROM topics
+      WHERE agent_id = ? AND status = 'active'
+      ORDER BY updated_at DESC
+      LIMIT ?
+    `).all(agentId, limit);
+        return rows.map(parseTopicRow);
+    }
+    /**
+     * Get all topics for an agent.
+     */
+    getAll(agentId, opts) {
+        let sql = 'SELECT * FROM topics WHERE agent_id = ?';
+        const params = [agentId];
+        if (opts?.status) {
+            sql += ' AND status = ?';
+            params.push(opts.status);
+        }
+        sql += ' ORDER BY updated_at DESC';
+        if (opts?.limit) {
+            sql += ' LIMIT ?';
+            params.push(opts.limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(parseTopicRow);
+    }
+    /**
+     * Find topics matching a query.
+     */
+    search(agentId, query, limit = 10) {
+        const rows = this.db.prepare(`
+      SELECT * FROM topics
+      WHERE agent_id = ?
+      AND (name LIKE ? OR description LIKE ?)
+      AND status != 'closed'
+      ORDER BY updated_at DESC
+      LIMIT ?
+    `).all(agentId, `%${query}%`, `%${query}%`, limit);
+        return rows.map(parseTopicRow);
+    }
+    /**
+     * Mark dormant topics (no activity for dormantAfterHours).
+     */
+    markDormant(agentId, dormantAfterHours = 24) {
+        const cutoff = new Date(Date.now() - dormantAfterHours * 60 * 60 * 1000).toISOString();
+        const result = this.db.prepare(`
+      UPDATE topics
+      SET status = 'dormant', updated_at = ?
+      WHERE agent_id = ? AND status = 'active' AND updated_at < ?
+    `).run(nowIso(), agentId, cutoff);
+        return result.changes;
+    }
+    /**
+     * Close dormant topics.
+     */
+    closeDormant(agentId, closedAfterDays = 7) {
+        const cutoff = new Date(Date.now() - closedAfterDays * 24 * 60 * 60 * 1000).toISOString();
+        const result = this.db.prepare(`
+      UPDATE topics
+      SET status = 'closed', updated_at = ?
+      WHERE agent_id = ? AND status = 'dormant' AND updated_at < ?
+    `).run(nowIso(), agentId, cutoff);
+        return result.changes;
+    }
+}
+//# sourceMappingURL=topic-store.js.map

package/dist/topic-synthesizer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Topic Synthesizer
+ *
+ * Synthesizes compiled knowledge pages (wiki-style) from stale topics.
+ * Heuristic-only: no LLM calls. Uses content-type classifier + keystone scoring.
+ *
+ * Architecture: Karpathy LLM Wiki Pattern adapted for hypermem.
+ * Raw sources (messages.db) → Wiki (knowledge table) → Compositor (compose-time)
+ */
+import type { DatabaseSync } from 'node:sqlite';
+declare const SYNTHESIS_STALE_MINUTES = 30;
+declare const SYNTHESIS_MIN_MESSAGES = 5;
+declare const SYNTHESIS_REGROWTH_THRESHOLD = 5;
+declare const SYNTHESIS_MAX_SUMMARY_CHARS = 800;
+declare const SYNTHESIS_MAX_DECISIONS = 10;
+declare const SYNTHESIS_MAX_QUESTIONS = 5;
+declare const LINT_FREQUENCY = 10;
+declare const LINT_STALE_DAYS = 7;
+export { SYNTHESIS_STALE_MINUTES, SYNTHESIS_MIN_MESSAGES, SYNTHESIS_REGROWTH_THRESHOLD, SYNTHESIS_MAX_SUMMARY_CHARS, SYNTHESIS_MAX_DECISIONS, SYNTHESIS_MAX_QUESTIONS, LINT_FREQUENCY, LINT_STALE_DAYS, };
+export interface SynthesisConfig {
+    SYNTHESIS_STALE_MINUTES: number;
+    SYNTHESIS_MIN_MESSAGES: number;
+    SYNTHESIS_REGROWTH_THRESHOLD: number;
+    SYNTHESIS_MAX_SUMMARY_CHARS: number;
+    SYNTHESIS_MAX_DECISIONS: number;
+    SYNTHESIS_MAX_QUESTIONS: number;
+    LINT_FREQUENCY: number;
+    LINT_STALE_DAYS: number;
+}
+export interface SynthesisResult {
+    topicsSynthesized: number;
+    topicsSkipped: number;
+    knowledgeEntriesWritten: number;
+}
+export declare class TopicSynthesizer {
+    private readonly libraryDb;
+    private readonly getMessageDb;
+    private readonly config?;
+    private readonly effectiveConfig;
+    constructor(libraryDb: DatabaseSync, getMessageDb: (agentId: string) => DatabaseSync | null, config?: Partial<SynthesisConfig> | undefined);
+    /**
+     * Run one synthesis pass for an agent.
+     * Finds stale topics, synthesizes wiki pages, writes to knowledge table.
+     */
+    tick(agentId: string): SynthesisResult;
+    /**
+     * Synthesize a wiki page for a topic from its messages.
+     */
+    private synthesizeTopic;
+}
+//# sourceMappingURL=topic-synthesizer.d.ts.map

package/dist/topic-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-synthesizer.d.ts","sourceRoot":"","sources":["../src/topic-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,sBAAsB,IAAI,CAAC;AACjC,QAAA,MAAM,4BAA4B,IAAI,CAAC;AACvC,QAAA,MAAM,2BAA2B,MAAM,CAAC;AACxC,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,uBAAuB,IAAI,CAAC;AAClC,QAAA,MAAM,cAAc,KAAK,CAAC;AAC1B,QAAA,MAAM,eAAe,IAAI,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AA6HD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAG/B,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,EACtD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,YAAA;IAcpD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAkFtC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+GxB"}