@kybernesis/brain-core 0.1.0

package/dist/sleep/steps/tier.js

@@ -0,0 +1,112 @@
+/**
+ * Tier step — port of KAD's sleep/steps/tier.ts.
+ *
+ * Promotes/demotes timeline events between hot/warm/archive tiers.
+ *
+ * Bug B11A regression-watchpoint: hot promotion uses **OR across 5 signals**
+ * (priority threshold OR low decay OR recent access OR relationshipScore OR
+ * edgeCount). A v1 port had AND across these signals, which dropped most
+ * promotions — the port-faithful library carries KAD's OR shape verbatim.
+ */
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { ensureSleepSchema } from '../db.js';
+export async function runTierStep(t, config) {
+    const timeline = getDb(t, 'timeline');
+    const sleep = ensureSleepSchema(t);
+    const now = Date.now();
+    const DAY_MS = 24 * 60 * 60 * 1000;
+    let changed = 0;
+    const errors = [];
+    try {
+        const items = timeline.prepare(`
+      SELECT id, source_path, priority, decay_score, tier, last_accessed, access_count, is_pinned
+      FROM timeline_events
+      LIMIT ?
+    `).all(config.batchSize);
+        for (const item of items) {
+            try {
+                if (item.is_pinned) {
+                    if (item.tier !== 'hot') {
+                        updateTier(timeline, sleep, item.id, 'hot', item.tier, 'pinned');
+                        changed++;
+                    }
+                    continue;
+                }
+                const edgeData = sleep.prepare(`
+          SELECT COUNT(*) as count, COALESCE(SUM(confidence), 0) as totalConfidence
+          FROM memory_edges
+          WHERE from_path = ? OR to_path = ?
+        `).get(item.source_path, item.source_path);
+                const relationshipScore = edgeData.totalConfidence;
+                const edgeCount = edgeData.count;
+                const daysSinceAccess = item.last_accessed
+                    ? (now - new Date(item.last_accessed + 'Z').getTime()) / DAY_MS
+                    : 30;
+                let newTier;
+                const priority = item.priority ?? 0.5;
+                const decayScore = item.decay_score ?? 0;
+                // Bug B11A: OR across 5 signals (NOT AND). Each signal alone is
+                // sufficient to promote to hot. KAD's contract.
+                if (priority >= config.hotPriorityThreshold ||
+                    decayScore <= config.hotDecayThreshold ||
+                    daysSinceAccess <= config.hotAccessDays ||
+                    relationshipScore >= config.hotEdgeCount ||
+                    edgeCount >= 4) {
+                    newTier = 'hot';
+                }
+                else if (priority >= config.warmPriorityThreshold ||
+                    daysSinceAccess <= config.warmAccessDays ||
+                    relationshipScore >= config.warmEdgeCount) {
+                    newTier = 'warm';
+                }
+                else {
+                    newTier = 'archive';
+                }
+                if (newTier !== (item.tier || 'warm')) {
+                    let reason = 'threshold';
+                    if (newTier === 'hot') {
+                        if (priority >= config.hotPriorityThreshold)
+                            reason = 'high_priority';
+                        else if (decayScore <= config.hotDecayThreshold)
+                            reason = 'low_decay';
+                        else if (daysSinceAccess <= config.hotAccessDays)
+                            reason = 'recent_access';
+                        else if (relationshipScore >= config.hotEdgeCount)
+                            reason = 'high_relationships';
+                    }
+                    else if (newTier === 'archive') {
+                        reason = 'low_activity';
+                    }
+                    updateTier(timeline, sleep, item.id, newTier, (item.tier || 'warm'), reason);
+                    changed++;
+                }
+            }
+            catch (err) {
+                errors.push(`tier item ${item.id}: ${String(err)}`);
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[brain-core/sleep/tier] step failed', { err: String(err) });
+        errors.push(`tier step: ${String(err)}`);
+    }
+    return { count: changed, errors: errors.length > 0 ? errors : undefined };
+}
+function updateTier(timeline, sleep, itemId, newTier, oldTier, reason) {
+    timeline.prepare(`
+    UPDATE timeline_events SET tier = ? WHERE id = ?
+  `).run(newTier, itemId);
+    sleep.prepare(`
+    INSERT OR REPLACE INTO maintenance_queue
+    (item_type, item_id, task, priority, created_at)
+    VALUES ('timeline', ?, 'resummarize', ?, datetime('now'))
+  `).run(itemId.toString(), newTier === 'hot' ? 2 : newTier === 'warm' ? 1 : 0);
+    try {
+        sleep.prepare(`
+      INSERT INTO tier_transitions (item_id, from_tier, to_tier, reason)
+      VALUES (?, ?, ?, ?)
+    `).run(itemId, oldTier, newTier, reason || 'threshold');
+    }
+    catch { /* non-critical */ }
+}
+//# sourceMappingURL=tier.js.map

package/dist/sleep/steps/tier.js.map

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

package/dist/sleep/utils/checkpoint.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sleep checkpoint helpers — port of KAD's sleep/utils/checkpoint.ts.
+ * Tracks which step is in progress so we can see where a crashed run died.
+ */
+import type Database from 'better-sqlite3';
+export declare function saveCheckpoint(db: Database.Database, runId: number, step: string, data?: Record<string, unknown>): void;
+export declare function getLastCheckpoint(db: Database.Database, runId: number): {
+    step: string;
+    data: Record<string, unknown>;
+} | null;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/sleep/utils/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/sleep/utils/checkpoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAYxD"}

package/dist/sleep/utils/checkpoint.js

@@ -0,0 +1,26 @@
+/**
+ * Sleep checkpoint helpers — port of KAD's sleep/utils/checkpoint.ts.
+ * Tracks which step is in progress so we can see where a crashed run died.
+ */
+export function saveCheckpoint(db, runId, step, data) {
+    db.prepare(`
+    UPDATE sleep_runs
+    SET checkpoint_step = ?,
+        checkpoint_data = ?
+    WHERE id = ?
+  `).run(step, JSON.stringify({ timestamp: new Date().toISOString(), ...data }), runId);
+}
+export function getLastCheckpoint(db, runId) {
+    const row = db.prepare(`
+    SELECT checkpoint_step, checkpoint_data
+    FROM sleep_runs
+    WHERE id = ?
+  `).get(runId);
+    if (!row || !row.checkpoint_step)
+        return null;
+    return {
+        step: row.checkpoint_step,
+        data: row.checkpoint_data ? JSON.parse(row.checkpoint_data) : {},
+    };
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/sleep/utils/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../../src/sleep/utils/checkpoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,cAAc,CAC5B,EAAqB,EACrB,KAAa,EACb,IAAY,EACZ,IAA8B;IAE9B,EAAE,CAAC,OAAO,CAAC;;;;;GAKV,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAqB,EACrB,KAAa;IAEb,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;;;;GAItB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAmF,CAAC;IAEhG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,eAAe;QACzB,IAAI,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;KACjE,CAAC;AACJ,CAAC"}

package/dist/sleep/utils/jaccard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Jaccard similarity — port of KAD's sleep/utils/jaccard.ts.
+ * |intersection| / |union|. 0 = disjoint, 1 = identical.
+ */
+export declare function jaccardSimilarity(setA: Set<string>, setB: Set<string>): number;
+export declare function jaccardSimilarityArrays(arrA: string[], arrB: string[]): number;
+//# sourceMappingURL=jaccard.d.ts.map

package/dist/sleep/utils/jaccard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jaccard.d.ts","sourceRoot":"","sources":["../../../src/sleep/utils/jaccard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQ9E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9E"}

package/dist/sleep/utils/jaccard.js

@@ -0,0 +1,19 @@
+/**
+ * Jaccard similarity — port of KAD's sleep/utils/jaccard.ts.
+ * |intersection| / |union|. 0 = disjoint, 1 = identical.
+ */
+export function jaccardSimilarity(setA, setB) {
+    if (setA.size === 0 && setB.size === 0)
+        return 0;
+    let intersectionSize = 0;
+    for (const item of setA) {
+        if (setB.has(item))
+            intersectionSize++;
+    }
+    const unionSize = setA.size + setB.size - intersectionSize;
+    return intersectionSize / unionSize;
+}
+export function jaccardSimilarityArrays(arrA, arrB) {
+    return jaccardSimilarity(new Set(arrA), new Set(arrB));
+}
+//# sourceMappingURL=jaccard.js.map

package/dist/sleep/utils/jaccard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jaccard.js","sourceRoot":"","sources":["../../../src/sleep/utils/jaccard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,iBAAiB,CAAC,IAAiB,EAAE,IAAiB;IACpE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,gBAAgB,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC3D,OAAO,gBAAgB,GAAG,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAc,EAAE,IAAc;IACpE,OAAO,iBAAiB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/store-conversation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Conversation memory storage — port of KAD's store-conversation.ts.
+ *
+ * Orchestrates storage across timeline, entity-graph, vectors, and fact
+ * extraction. Call fire-and-forget after a reply is sent.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+export declare function filterNoiseEntities(entities: Array<{
+    name: string;
+    type: string;
+}>, agentStoplist?: string[]): Array<{
+    name: string;
+    type: string;
+}>;
+export interface ConversationInput {
+    prompt: string;
+    response: string;
+    channel: string;
+    timestamp?: string;
+    metadata?: Record<string, unknown>;
+    eventType?: 'conversation' | 'idea' | 'file' | 'transcript' | 'note' | 'intake';
+}
+/** Returns true if a storeConversation call is in progress for this tenant. */
+export declare function isStoreActive(t: TenantContext): boolean;
+export declare function storeConversation(t: TenantContext, input: ConversationInput, options?: {
+    entityStoplist?: string[];
+    skipEmbeddings?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=store-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-conversation.d.ts","sourceRoot":"","sources":["../src/store-conversation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAoCjE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,aAAa,GAAE,MAAM,EAAO,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvC;AA+BD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;CACjF;AAWD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAEvD;AAID,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,aAAa,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/store-conversation.js

@@ -0,0 +1,227 @@
+/**
+ * Conversation memory storage — port of KAD's store-conversation.ts.
+ *
+ * Orchestrates storage across timeline, entity-graph, vectors, and fact
+ * extraction. Call fire-and-forget after a reply is sent.
+ */
+import { randomUUID } from 'node:crypto';
+import { SOURCE_CONFIDENCE } from '@kybernesis/brain-contracts';
+import { enqueueWrite, queueDepth } from './queue.js';
+import { addConversationToTimeline, findRecentDuplicate, incrementTimelineEventCount } from './timeline.js';
+import { findOrCreateEntity, addEntityMention, linkEntitiesWithType } from './entity-graph.js';
+import { extractRelationships } from './relationship-extractor.js';
+import { indexChunk } from './vectors.js';
+import { extractFactsRealtime } from './fact-extractor.js';
+// ─── Noise entity filtering ────────────────────────────────────────────────────
+const NOISE_ENTITY_PATTERNS = [
+    /^(curl|wget|bash|sh|zsh|npm|pnpm|yarn|pip|git|docker|node|python|make|gcc)$/i,
+    /^(BLOCKED|ERROR|FAIL|OK|SUCCESS|null|undefined|true|false|none|N\/A)$/i,
+    /^(max\s+turns?\s+limit|rate\s+limit|timeout|sandbox|retry|fallback|skip)$/i,
+    /^(settings|config|permissions?|terminal|shell|command|script)$/i,
+    /^(stdout|stderr|stdin|exit code|error|warning)$/i,
+    /\.(json|yaml|yml|md|ts|js|py|sh|env|toml|lock|log|txt|csv|db)$/i,
+    /^[./~].*\//,
+    /^\d+$/,
+    /^.{1,2}$/,
+    /^(the|this|that|it|they|we|i|you|he|she|my|our)$/i,
+    /^[a-f0-9-]{36}$/i,
+    /^(http|https|localhost|127\.0\.0\.1|0\.0\.0\.0)/i,
+    /^speaker\s*\d+$/i,
+];
+const NOISE_WORDS = new Set([
+    'speaker', 'user', 'assistant', 'narrator', 'host',
+    'ok', 'okay', 'yes', 'no', 'yeah', 'nah', 'yep', 'nope',
+    'hey', 'hi', 'hello', 'bye', 'goodbye', 'thanks', 'thank',
+    'the', 'this', 'that', 'thing', 'stuff', 'someone', 'something',
+    'everyone', 'anybody', 'nothing', 'everything',
+    'person', 'unknown', 'other', 'another',
+]);
+export function filterNoiseEntities(entities, agentStoplist = []) {
+    const stopSet = new Set(agentStoplist.map(s => s.toLowerCase()));
+    return entities.filter(e => {
+        const name = e.name.trim();
+        const lower = name.toLowerCase();
+        if (stopSet.has(lower))
+            return false;
+        if (NOISE_WORDS.has(lower))
+            return false;
+        if (NOISE_ENTITY_PATTERNS.some(p => p.test(name)))
+            return false;
+        return true;
+    });
+}
+// ─── Segment splitting ────────────────────────────────────────────────────────
+function segmentText(text, segmentSize = 250, overlap = 50) {
+    if (text.length <= segmentSize)
+        return [{ text, index: 0 }];
+    const segs = [];
+    let start = 0;
+    let index = 0;
+    while (start < text.length) {
+        let end = start + segmentSize;
+        if (end < text.length) {
+            const slice = text.slice(start, end + 50);
+            const bp = slice.lastIndexOf('\n');
+            const sp = slice.search(/[.!?]\s+[A-Z]/);
+            if (bp > segmentSize * 0.6)
+                end = start + bp + 1;
+            else if (sp > segmentSize * 0.6)
+                end = start + sp + 2;
+        }
+        else {
+            end = text.length;
+        }
+        segs.push({ text: text.slice(start, end).trim(), index });
+        index++;
+        const next = end - overlap;
+        start = next <= start ? end : next;
+        if (start >= text.length || index > 100)
+            break;
+    }
+    return segs;
+}
+function channelToSourceType(channel) {
+    switch (channel) {
+        case 'terminal': return 'user-direct';
+        case 'heartbeat': return 'heartbeat';
+        case 'watched-folder': return 'watched-folder';
+        default: return 'chat';
+    }
+}
+/** Returns true if a storeConversation call is in progress for this tenant. */
+export function isStoreActive(t) {
+    return queueDepth(t.slug) > 0;
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+export function storeConversation(t, input, options = {}) {
+    return enqueueWrite(t.slug, () => storeConversationImpl(t, input, options));
+}
+async function storeConversationImpl(t, input, options) {
+    const conversationId = randomUUID();
+    const timestamp = input.timestamp || new Date().toISOString();
+    const sourcePath = `channel://${input.channel}/${conversationId}`;
+    const fullText = `User: ${input.prompt}\n\nAssistant: ${input.response}`;
+    const timelineSummary = input.response.slice(0, 2000);
+    const sourceType = channelToSourceType(input.channel);
+    const sourceConfidence = SOURCE_CONFIDENCE[sourceType] ?? 0.85;
+    const meta = (input.metadata ?? {});
+    const arpMetadata = {
+        project_id: typeof meta['project_id'] === 'string' ? meta['project_id'] : undefined,
+        tags: Array.isArray(meta['tags']) ? meta['tags'].filter((t) => typeof t === 'string') : undefined,
+        classification: typeof meta['classification'] === 'string'
+            ? meta['classification']
+            : undefined,
+        connection_id: typeof meta['connection_id'] === 'string' ? meta['connection_id'] : undefined,
+        source_did: typeof meta['source_did'] === 'string' ? meta['source_did'] : undefined,
+    };
+    // Step 1: Extract entities + relationships
+    let entities = [];
+    let relationships = [];
+    try {
+        const extraction = await extractRelationships(t, fullText);
+        entities = extraction.entities;
+        relationships = extraction.relationships;
+    }
+    catch (err) {
+        console.warn('[brain-core/store-conversation] entity extraction failed', { err: String(err) });
+    }
+    // Step 1b: Filter noise
+    entities = filterNoiseEntities(entities, options.entityStoplist);
+    const entityNameSet = new Set(entities.map(e => e.name.toLowerCase()));
+    relationships = relationships.filter(r => entityNameSet.has(r.source.name.toLowerCase()) && entityNameSet.has(r.target.name.toLowerCase()));
+    const entityNames = entities.map(e => e.name);
+    const topicNames = entities.filter(e => e.type === 'topic').map(e => e.name);
+    // Step 2: Timeline
+    const title = input.prompt.length > 100 ? input.prompt.slice(0, 97) + '...' : input.prompt;
+    const dateMatch = input.prompt.match(/^DATE:\s*(.+?)$/m);
+    const sessionDate = dateMatch ? dateMatch[1].trim() : '';
+    const fullTitle = sessionDate ? `[${input.channel}] ${sessionDate} — ${title}` : `[${input.channel}] ${title}`;
+    const recentHours = input.channel === 'heartbeat' ? 24 : 0.033;
+    try {
+        const existing = await findRecentDuplicate(t, fullTitle, recentHours);
+        if (existing) {
+            await incrementTimelineEventCount(t, existing.id);
+        }
+        else {
+            await addConversationToTimeline(t, conversationId, sourcePath, timestamp, undefined, fullTitle, timelineSummary, entityNames, topicNames, arpMetadata, input.eventType);
+        }
+    }
+    catch (err) {
+        console.warn('[brain-core/store-conversation] timeline failed', { err: String(err) });
+    }
+    // Step 2b: Segment-level vector indexing (best-effort)
+    if (!options.skipEmbeddings) {
+        try {
+            const segs = segmentText(fullText, 250, 50);
+            if (segs.length > 1) {
+                for (const seg of segs) {
+                    try {
+                        await indexChunk(t, seg.text, {
+                            ts: timestamp,
+                            source: `${sourcePath}/seg_${seg.index}`,
+                            origin_id: `${conversationId}_seg_${seg.index}`,
+                        });
+                    }
+                    catch { /* best-effort */ }
+                }
+            }
+        }
+        catch (err) {
+            console.warn('[brain-core/store-conversation] segment indexing failed', { err: String(err) });
+        }
+    }
+    // Step 3: Entity graph
+    try {
+        const entityMap = new Map();
+        for (const entity of entities) {
+            try {
+                const dbEntity = await findOrCreateEntity(t, entity.name, entity.type, timestamp);
+                entityMap.set(entity.name, dbEntity.id);
+                await addEntityMention(t, dbEntity.id, conversationId, sourcePath, input.prompt.slice(0, 200), timestamp, sourceType, sourceConfidence);
+            }
+            catch (err) {
+                console.warn(`[brain-core/store-conversation] entity ${entity.name} failed`, { err: String(err) });
+            }
+        }
+        for (const rel of relationships) {
+            try {
+                const srcId = entityMap.get(rel.source.name);
+                const tgtId = entityMap.get(rel.target.name);
+                if (srcId && tgtId && srcId !== tgtId) {
+                    await linkEntitiesWithType(t, srcId, tgtId, {
+                        relationship: rel.relationship,
+                        confidence: rel.confidence,
+                        rationale: rel.rationale,
+                    });
+                }
+            }
+            catch (err) {
+                console.warn('[brain-core/store-conversation] entity link failed', { err: String(err) });
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[brain-core/store-conversation] entity graph failed', { err: String(err) });
+    }
+    // Step 3b: Real-time fact extraction (best-effort)
+    try {
+        await extractFactsRealtime(t, conversationId, fullText, {
+            entities: entityNames,
+            sourcePath,
+            timestamp,
+            sourceType,
+            arpMetadata,
+        });
+    }
+    catch { /* fact extraction is best-effort */ }
+    // Step 4: Parent-level embedding (only if no segments)
+    if (!options.skipEmbeddings && fullText.length <= 250) {
+        try {
+            await indexChunk(t, fullText, { ts: timestamp, source: sourcePath, origin_id: conversationId });
+        }
+        catch (err) {
+            console.warn('[brain-core/store-conversation] embedding failed', { err: String(err) });
+        }
+    }
+}
+//# sourceMappingURL=store-conversation.js.map

package/dist/store-conversation.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,50 @@
+import type { TenantContext } from '@kybernesis/brain-contracts';
+import type { EventType, TimelineEvent, TimelineEventInput } from '@kybernesis/brain-contracts';
+export declare function resetTimelineDb(t?: TenantContext): void;
+export declare function addToTimeline(t: TenantContext, event: TimelineEventInput): Promise<number>;
+export declare function removeFromTimeline(t: TenantContext, sourcePath: string): Promise<boolean>;
+export declare function updateTimelineEvent(t: TenantContext, id: number, updates: Partial<Omit<TimelineEventInput, 'sourcePath'>>): Promise<void>;
+export declare function deleteTimelineEventById(t: TenantContext, id: number): Promise<boolean>;
+export declare function getEventById(t: TenantContext, id: number): Promise<TimelineEvent | null>;
+export declare function getEventByPath(t: TenantContext, sourcePath: string): Promise<TimelineEvent | null>;
+export interface TimelineQuery {
+    start?: string;
+    end?: string;
+    type?: EventType;
+    search?: string;
+    entities?: string[];
+    topics?: string[];
+    limit?: number;
+    offset?: number;
+}
+export declare function queryTimeline(t: TenantContext, query?: TimelineQuery): Promise<TimelineEvent[]>;
+export declare function getRecentActivity(t: TenantContext, limit?: number): Promise<TimelineEvent[]>;
+export declare function getActivityOnDate(t: TenantContext, date: string): Promise<TimelineEvent[]>;
+export declare function getActivityInRange(t: TenantContext, start: string, end: string): Promise<TimelineEvent[]>;
+export declare function searchTimeline(t: TenantContext, searchQuery: string, options?: {
+    limit?: number;
+    type?: EventType;
+}): Promise<TimelineEvent[]>;
+export declare function findRecentDuplicate(t: TenantContext, title: string, withinHours: number): Promise<{
+    id: number;
+    title: string;
+} | null>;
+export declare function incrementTimelineEventCount(t: TenantContext, eventId: number): Promise<void>;
+export interface TimelineStats {
+    totalEvents: number;
+    byType: Record<EventType, number>;
+    dateRange: {
+        earliest: string | null;
+        latest: string | null;
+    };
+}
+export declare function getTimelineStats(t: TenantContext): Promise<TimelineStats>;
+export declare function addConversationToTimeline(t: TenantContext, _conversationId: string, sourcePath: string, startedAt: string, finishedAt: string | undefined, title: string, summary: string, entities: string[], topics: string[], arpMetadata?: {
+    projectId?: string;
+    tags?: string[];
+    classification?: string;
+    connectionId?: string;
+    sourceDid?: string;
+}, eventType?: EventType): Promise<number>;
+export declare function addIdeaToTimeline(t: TenantContext, _ideaId: string, sourcePath: string, createdAt: string, title: string, description: string, tags: string[]): Promise<number>;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

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