@kybernesis/brain-core 0.1.0

package/dist/timeline.js

@@ -0,0 +1,389 @@
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { sanitizeFtsQuery } from './fts-sanitizer.js';
+function rowToEvent(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        timestamp: row.timestamp,
+        endTimestamp: row.end_timestamp ?? undefined,
+        title: row.title,
+        summary: row.summary ?? undefined,
+        sourcePath: row.source_path,
+        entities: JSON.parse(row.entities_json || '[]'),
+        topics: JSON.parse(row.topics_json || '[]'),
+        priority: row.priority ?? 0.5,
+        decayScore: row.decay_score ?? 0.0,
+        tier: (row.tier ?? 'warm'),
+        tags: JSON.parse(row.tags_json || '[]'),
+        lastEnriched: row.last_enriched ?? undefined,
+        accessCount: row.access_count ?? 0,
+        isPinned: (row.is_pinned ?? 0) === 1,
+        lastAccessed: row.last_accessed ?? undefined,
+        projectId: row.project_id ?? undefined,
+        classification: row.classification ?? undefined,
+        connectionId: row.connection_id ?? undefined,
+        sourceDid: row.source_did ?? undefined,
+    };
+}
+// ─── Schema initialization ────────────────────────────────────────────────────
+const initialized = new Set();
+function ensureSchema(t) {
+    if (initialized.has(t.slug))
+        return;
+    const db = getDb(t, 'timeline');
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS timeline_events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      type TEXT NOT NULL CHECK(type IN ('conversation', 'idea', 'file', 'transcript', 'note', 'intake')),
+      timestamp TEXT NOT NULL,
+      end_timestamp TEXT,
+      title TEXT NOT NULL,
+      summary TEXT,
+      source_path TEXT NOT NULL UNIQUE,
+      entities_json TEXT DEFAULT '[]',
+      topics_json TEXT DEFAULT '[]',
+      priority REAL DEFAULT 0.5,
+      decay_score REAL DEFAULT 0.0,
+      tier TEXT DEFAULT 'warm',
+      tags_json TEXT DEFAULT '[]',
+      last_enriched TEXT,
+      access_count INTEGER DEFAULT 0,
+      is_pinned INTEGER DEFAULT 0,
+      last_accessed TEXT,
+      project_id TEXT,
+      classification TEXT,
+      connection_id TEXT,
+      source_did TEXT
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_timeline_timestamp ON timeline_events(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_timeline_type ON timeline_events(type);
+    CREATE INDEX IF NOT EXISTS idx_timeline_source ON timeline_events(source_path);
+    CREATE INDEX IF NOT EXISTS idx_timeline_tier ON timeline_events(tier);
+    CREATE INDEX IF NOT EXISTS idx_timeline_priority ON timeline_events(priority DESC);
+    CREATE INDEX IF NOT EXISTS idx_timeline_last_enriched ON timeline_events(last_enriched);
+    CREATE INDEX IF NOT EXISTS idx_timeline_project ON timeline_events(project_id);
+    CREATE INDEX IF NOT EXISTS idx_timeline_classification ON timeline_events(classification);
+    CREATE INDEX IF NOT EXISTS idx_timeline_connection ON timeline_events(connection_id);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS timeline_fts USING fts5(
+      title, summary, entities, topics, content=''
+    );
+
+    CREATE TRIGGER IF NOT EXISTS timeline_ai AFTER INSERT ON timeline_events BEGIN
+      INSERT INTO timeline_fts(rowid, title, summary, entities, topics)
+      VALUES (new.id, new.title, new.summary, new.entities_json, new.topics_json);
+    END;
+
+    CREATE TRIGGER IF NOT EXISTS timeline_ad AFTER DELETE ON timeline_events BEGIN
+      INSERT INTO timeline_fts(timeline_fts, rowid, title, summary, entities, topics)
+      VALUES ('delete', old.id, old.title, old.summary, old.entities_json, old.topics_json);
+    END;
+
+    CREATE TRIGGER IF NOT EXISTS timeline_au AFTER UPDATE ON timeline_events BEGIN
+      INSERT INTO timeline_fts(timeline_fts, rowid, title, summary, entities, topics)
+      VALUES ('delete', old.id, old.title, old.summary, old.entities_json, old.topics_json);
+      INSERT INTO timeline_fts(rowid, title, summary, entities, topics)
+      VALUES (new.id, new.title, new.summary, new.entities_json, new.topics_json);
+    END;
+
+    CREATE TABLE IF NOT EXISTS facts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      content TEXT NOT NULL,
+      source_path TEXT NOT NULL UNIQUE,
+      source_conversation_id TEXT NOT NULL,
+      entities_json TEXT DEFAULT '[]',
+      timestamp TEXT NOT NULL,
+      confidence REAL DEFAULT 0.7,
+      category TEXT DEFAULT 'general',
+      created_at TEXT DEFAULT (datetime('now')),
+      is_latest INTEGER DEFAULT 1,
+      superseded_by INTEGER,
+      expires_at TEXT,
+      updated_at TEXT,
+      access_count INTEGER DEFAULT 0,
+      source_type TEXT DEFAULT 'chat',
+      is_retracted INTEGER DEFAULT 0,
+      retracted_by TEXT,
+      last_reinforced_at TEXT,
+      project_id TEXT,
+      tags_json TEXT DEFAULT '[]',
+      classification TEXT,
+      connection_id TEXT,
+      source_did TEXT
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_facts_source_conv ON facts(source_conversation_id);
+    CREATE INDEX IF NOT EXISTS idx_facts_category ON facts(category);
+    CREATE INDEX IF NOT EXISTS idx_facts_timestamp ON facts(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_facts_source_path ON facts(source_path);
+    CREATE INDEX IF NOT EXISTS idx_facts_is_latest ON facts(is_latest);
+    CREATE INDEX IF NOT EXISTS idx_facts_expires_at ON facts(expires_at);
+    CREATE INDEX IF NOT EXISTS idx_facts_project ON facts(project_id);
+    CREATE INDEX IF NOT EXISTS idx_facts_classification ON facts(classification);
+    CREATE INDEX IF NOT EXISTS idx_facts_connection ON facts(connection_id);
+  `);
+    initialized.add(t.slug);
+}
+export function resetTimelineDb(t) {
+    if (t) {
+        initialized.delete(t.slug);
+    }
+    else {
+        initialized.clear();
+    }
+}
+// ─── Event operations ─────────────────────────────────────────────────────────
+export async function addToTimeline(t, event) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const result = db.prepare(`
+    INSERT INTO timeline_events
+      (type, timestamp, end_timestamp, title, summary, source_path,
+       entities_json, topics_json,
+       project_id, tags_json, classification, connection_id, source_did)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(source_path) DO UPDATE SET
+      type = excluded.type,
+      timestamp = excluded.timestamp,
+      end_timestamp = excluded.end_timestamp,
+      title = excluded.title,
+      summary = excluded.summary,
+      entities_json = excluded.entities_json,
+      topics_json = excluded.topics_json,
+      project_id = COALESCE(excluded.project_id, timeline_events.project_id),
+      tags_json = COALESCE(excluded.tags_json, timeline_events.tags_json),
+      classification = COALESCE(excluded.classification, timeline_events.classification),
+      connection_id = COALESCE(excluded.connection_id, timeline_events.connection_id),
+      source_did = COALESCE(excluded.source_did, timeline_events.source_did)
+  `).run(event.type, event.timestamp, event.endTimestamp ?? null, event.title, event.summary ?? '', event.sourcePath, JSON.stringify(event.entities), JSON.stringify(event.topics), event.projectId ?? null, JSON.stringify(event.tags), event.classification ?? null, event.connectionId ?? null, event.sourceDid ?? null);
+    return result.lastInsertRowid;
+}
+export async function removeFromTimeline(t, sourcePath) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const result = db.prepare('DELETE FROM timeline_events WHERE source_path = ?').run(sourcePath);
+    return result.changes > 0;
+}
+export async function updateTimelineEvent(t, id, updates) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const parts = [];
+    const params = [];
+    if (updates.title !== undefined) {
+        parts.push('title = ?');
+        params.push(updates.title);
+    }
+    if (updates.summary !== undefined) {
+        parts.push('summary = ?');
+        params.push(updates.summary);
+    }
+    if (updates.timestamp !== undefined) {
+        parts.push('timestamp = ?');
+        params.push(updates.timestamp);
+    }
+    if (updates.endTimestamp !== undefined) {
+        parts.push('end_timestamp = ?');
+        params.push(updates.endTimestamp);
+    }
+    if (updates.entities !== undefined) {
+        parts.push('entities_json = ?');
+        params.push(JSON.stringify(updates.entities));
+    }
+    if (updates.topics !== undefined) {
+        parts.push('topics_json = ?');
+        params.push(JSON.stringify(updates.topics));
+    }
+    if (updates.tags !== undefined) {
+        parts.push('tags_json = ?');
+        params.push(JSON.stringify(updates.tags));
+    }
+    if (updates.priority !== undefined) {
+        parts.push('priority = ?');
+        params.push(updates.priority);
+    }
+    if (updates.decayScore !== undefined) {
+        parts.push('decay_score = ?');
+        params.push(updates.decayScore);
+    }
+    if (updates.tier !== undefined) {
+        parts.push('tier = ?');
+        params.push(updates.tier);
+    }
+    if (updates.lastEnriched !== undefined) {
+        parts.push('last_enriched = ?');
+        params.push(updates.lastEnriched);
+    }
+    if (updates.isPinned !== undefined) {
+        parts.push('is_pinned = ?');
+        params.push(updates.isPinned ? 1 : 0);
+    }
+    if (parts.length === 0)
+        return;
+    params.push(id);
+    db.prepare(`UPDATE timeline_events SET ${parts.join(', ')} WHERE id = ?`).run(...params);
+}
+export async function deleteTimelineEventById(t, id) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const result = db.prepare('DELETE FROM timeline_events WHERE id = ?').run(id);
+    return result.changes > 0;
+}
+export async function getEventById(t, id) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const row = db.prepare('SELECT * FROM timeline_events WHERE id = ?').get(id);
+    return row ? rowToEvent(row) : null;
+}
+export async function getEventByPath(t, sourcePath) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const row = db.prepare('SELECT * FROM timeline_events WHERE source_path = ?').get(sourcePath);
+    return row ? rowToEvent(row) : null;
+}
+export async function queryTimeline(t, query = {}) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const conditions = [];
+    const params = [];
+    if (query.start) {
+        conditions.push('timestamp >= ?');
+        params.push(query.start);
+    }
+    if (query.end) {
+        conditions.push('timestamp <= ?');
+        params.push(query.end);
+    }
+    if (query.type) {
+        conditions.push('type = ?');
+        params.push(query.type);
+    }
+    if (query.search) {
+        const sanitized = sanitizeFtsQuery(query.search);
+        if (sanitized) {
+            conditions.push('id IN (SELECT rowid FROM timeline_fts WHERE timeline_fts MATCH ?)');
+            params.push(sanitized);
+        }
+    }
+    if (query.entities && query.entities.length > 0) {
+        const entityConds = query.entities.map(() => 'entities_json LIKE ?');
+        conditions.push(`(${entityConds.join(' OR ')})`);
+        for (const e of query.entities)
+            params.push(`%${e.toLowerCase()}%`);
+    }
+    if (query.topics && query.topics.length > 0) {
+        const topicConds = query.topics.map(() => 'topics_json LIKE ?');
+        conditions.push(`(${topicConds.join(' OR ')})`);
+        for (const topic of query.topics)
+            params.push(`%${topic.toLowerCase()}%`);
+    }
+    let sql = 'SELECT * FROM timeline_events';
+    if (conditions.length > 0)
+        sql += ' WHERE ' + conditions.join(' AND ');
+    sql += ' ORDER BY timestamp DESC';
+    sql += ' LIMIT ? OFFSET ?';
+    params.push(query.limit ?? 50, query.offset ?? 0);
+    const rows = db.prepare(sql).all(...params);
+    return rows.map(rowToEvent);
+}
+export async function getRecentActivity(t, limit = 20) {
+    return queryTimeline(t, { limit });
+}
+export async function getActivityOnDate(t, date) {
+    return queryTimeline(t, {
+        start: `${date}T00:00:00.000Z`,
+        end: `${date}T23:59:59.999Z`,
+    });
+}
+export async function getActivityInRange(t, start, end) {
+    return queryTimeline(t, { start, end });
+}
+export async function searchTimeline(t, searchQuery, options = {}) {
+    return queryTimeline(t, { search: searchQuery, limit: options.limit, type: options.type });
+}
+// ─── Deduplication ────────────────────────────────────────────────────────────
+export async function findRecentDuplicate(t, title, withinHours) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const cutoff = new Date(Date.now() - withinHours * 60 * 60 * 1000).toISOString();
+    const normalized = title.replace(/^\[.*?\]\s*/, '').replace(/\.{3}$/, '').trim().toLowerCase();
+    const rows = db.prepare(`
+    SELECT id, title FROM timeline_events
+    WHERE timestamp >= ?
+    ORDER BY timestamp DESC
+    LIMIT 100
+  `).all(cutoff);
+    for (const row of rows) {
+        const rowNorm = row.title.replace(/^\[.*?\]\s*/, '').replace(/\.{3}$/, '').trim().toLowerCase();
+        if (rowNorm === normalized)
+            return row;
+    }
+    return null;
+}
+export async function incrementTimelineEventCount(t, eventId) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    db.prepare(`
+    UPDATE timeline_events
+    SET access_count = COALESCE(access_count, 0) + 1,
+        last_accessed = datetime('now')
+    WHERE id = ?
+  `).run(eventId);
+}
+export async function getTimelineStats(t) {
+    ensureSchema(t);
+    const db = getDb(t, 'timeline');
+    const { count } = db.prepare('SELECT COUNT(*) as count FROM timeline_events').get();
+    const byTypeRows = db.prepare('SELECT type, COUNT(*) as count FROM timeline_events GROUP BY type').all();
+    const dateRange = db.prepare('SELECT MIN(timestamp) as earliest, MAX(timestamp) as latest FROM timeline_events').get();
+    const byType = {
+        conversation: 0, idea: 0, file: 0, transcript: 0, note: 0, intake: 0,
+    };
+    for (const row of byTypeRows) {
+        byType[row.type] = row.count;
+    }
+    return { totalEvents: count, byType, dateRange };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+export async function addConversationToTimeline(t, _conversationId, sourcePath, startedAt, finishedAt, title, summary, entities, topics, arpMetadata, eventType = 'conversation') {
+    return addToTimeline(t, {
+        type: eventType,
+        timestamp: startedAt,
+        endTimestamp: finishedAt,
+        title,
+        summary,
+        sourcePath,
+        entities,
+        topics,
+        priority: 0.5,
+        decayScore: 0.0,
+        tier: 'warm',
+        tags: arpMetadata?.tags ?? [],
+        isPinned: false,
+        accessCount: 0,
+        ...(arpMetadata ? {
+            projectId: arpMetadata.projectId,
+            classification: arpMetadata.classification,
+            connectionId: arpMetadata.connectionId,
+            sourceDid: arpMetadata.sourceDid,
+        } : {}),
+    });
+}
+export async function addIdeaToTimeline(t, _ideaId, sourcePath, createdAt, title, description, tags) {
+    return addToTimeline(t, {
+        type: 'idea',
+        timestamp: createdAt,
+        title,
+        summary: description,
+        sourcePath,
+        entities: [],
+        topics: tags,
+        priority: 0.5,
+        decayScore: 0.0,
+        tier: 'warm',
+        tags: [],
+        isPinned: false,
+        accessCount: 0,
+    });
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/user-profile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * User profile — port of KAD's user-profile.ts.
+ *
+ * Auto-generated profile from the fact store. Cached as JSON for instant
+ * (~1ms) access. Injected into system prompts so agents have key user context.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+export interface UserProfile {
+    generated_at: string;
+    fact_count: number;
+    sections: {
+        identity: string[];
+        preferences: string[];
+        relationships: string[];
+        current_plans: string[];
+        recent_events: string[];
+    };
+    top_entities: Array<{
+        name: string;
+        type: string;
+        mention_count: number;
+    }>;
+}
+export declare function generateUserProfile(t: TenantContext): Promise<UserProfile>;
+export declare function getCachedProfile(t: TenantContext): UserProfile | null;
+export declare function cacheProfile(t: TenantContext, profile: UserProfile): void;
+/** Returns age of cached profile in minutes, or Infinity if none. */
+export declare function getProfileAge(t: TenantContext): number;
+export declare function formatProfileForPrompt(profile: UserProfile): string;
+//# sourceMappingURL=user-profile.d.ts.map

package/dist/user-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../src/user-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAID,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBhF;AA4DD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,IAAI,CAQrE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAQzE;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAMtD;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAyBnE"}

package/dist/user-profile.js

@@ -0,0 +1,147 @@
+/**
+ * User profile — port of KAD's user-profile.ts.
+ *
+ * Auto-generated profile from the fact store. Cached as JSON for instant
+ * (~1ms) access. Injected into system prompts so agents have key user context.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { getDb } from '@kybernesis/brain-storage-sqlite';
+import { ensureFactsTable } from './fact-store.js';
+// ─── Generation ───────────────────────────────────────────────────────────────
+export async function generateUserProfile(t) {
+    await ensureFactsTable(t);
+    const db = getDb(t, 'timeline');
+    const identity = queryFacts(db, 'biographical', 15);
+    const preferences = queryFacts(db, 'preference', 10);
+    const relationships = queryFacts(db, 'relationship', 10);
+    const current_plans = queryFacts(db, 'plan', 5);
+    const recent_events = queryRecentFacts(db, 'event', 5);
+    const totalFacts = identity.length + preferences.length + relationships.length
+        + current_plans.length + recent_events.length;
+    const top_entities = queryTopEntities(t);
+    return {
+        generated_at: new Date().toISOString(),
+        fact_count: totalFacts,
+        sections: { identity, preferences, relationships, current_plans, recent_events },
+        top_entities,
+    };
+}
+function queryFacts(db, category, limit) {
+    try {
+        const rows = db.prepare(`
+      SELECT content FROM facts
+      WHERE category = ?
+        AND is_latest = 1
+        AND (expires_at IS NULL OR expires_at > datetime('now'))
+      ORDER BY confidence DESC, access_count DESC
+      LIMIT ?
+    `).all(category, limit);
+        return rows.map((r) => r.content);
+    }
+    catch {
+        // access_count column may not exist yet
+        try {
+            const rows = db.prepare(`
+        SELECT content FROM facts
+        WHERE category = ?
+          AND is_latest = 1
+          AND (expires_at IS NULL OR expires_at > datetime('now'))
+        ORDER BY confidence DESC
+        LIMIT ?
+      `).all(category, limit);
+            return rows.map((r) => r.content);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+function queryRecentFacts(db, category, limit) {
+    try {
+        const rows = db.prepare(`
+      SELECT content FROM facts
+      WHERE category = ?
+        AND is_latest = 1
+        AND (expires_at IS NULL OR expires_at > datetime('now'))
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `).all(category, limit);
+        return rows.map((r) => r.content);
+    }
+    catch {
+        return [];
+    }
+}
+function queryTopEntities(t) {
+    try {
+        const db = getDb(t, 'entityGraph');
+        return db.prepare('SELECT name, type, mention_count FROM entities ORDER BY mention_count DESC LIMIT 10').all();
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Cache operations ─────────────────────────────────────────────────────────
+export function getCachedProfile(t) {
+    const path = t.paths.userProfileJsonPath;
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function cacheProfile(t, profile) {
+    const path = t.paths.userProfileJsonPath;
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(profile, null, 2), 'utf-8');
+    }
+    catch (err) {
+        console.warn('[brain-core/user-profile] cache write failed', { err: String(err) });
+    }
+}
+/** Returns age of cached profile in minutes, or Infinity if none. */
+export function getProfileAge(t) {
+    const cached = getCachedProfile(t);
+    if (!cached?.generated_at)
+        return Infinity;
+    const generatedAt = new Date(cached.generated_at).getTime();
+    if (isNaN(generatedAt))
+        return Infinity;
+    return (Date.now() - generatedAt) / (1000 * 60);
+}
+// ─── Prompt formatting ────────────────────────────────────────────────────────
+export function formatProfileForPrompt(profile) {
+    const lines = ['## Auto-Generated User Profile'];
+    if (profile.sections.identity.length > 0) {
+        lines.push('', '### Identity');
+        for (const f of profile.sections.identity)
+            lines.push(`- ${f}`);
+    }
+    if (profile.sections.preferences.length > 0) {
+        lines.push('', '### Preferences');
+        for (const f of profile.sections.preferences)
+            lines.push(`- ${f}`);
+    }
+    if (profile.sections.relationships.length > 0) {
+        lines.push('', '### Key Relationships');
+        for (const f of profile.sections.relationships)
+            lines.push(`- ${f}`);
+    }
+    if (profile.sections.current_plans.length > 0) {
+        lines.push('', '### Current Plans');
+        for (const f of profile.sections.current_plans)
+            lines.push(`- ${f}`);
+    }
+    if (profile.sections.recent_events.length > 0) {
+        lines.push('', '### Recent Events');
+        for (const f of profile.sections.recent_events)
+            lines.push(`- ${f}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=user-profile.js.map

package/dist/user-profile.js.map

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

package/dist/vectors.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Vector indexing + semantic search — port of KAD's vectors.ts.
+ *
+ * Brain-core owns the operations; brain-storage-vec owns the connection
+ * + sqlite-vec extension. Embeddings are injected via setEmbeddingProvider
+ * (same pattern as setLLMProvider — see ADR-0009): the library has no
+ * default backend, the app wires one at startup. When no provider is set,
+ * indexChunk is a no-op and semanticSearch returns [].
+ *
+ * KAD's default backend is OpenAI text-embedding-3-small (1536-dim). Other
+ * backends (Voyage, local) can be wired identically.
+ */
+import type { TenantContext } from '@kybernesis/brain-contracts';
+export declare const EMBEDDING_DIM = 1536;
+export interface EmbeddingProvider {
+    /** Returns a 1536-dim vector, or null on failure. */
+    embed(text: string): Promise<number[] | null>;
+}
+export declare function setEmbeddingProvider(p: EmbeddingProvider): void;
+export declare function resetEmbeddingProvider(): void;
+export declare function embeddingAvailable(): boolean;
+export interface IndexChunkMeta {
+    ts: string;
+    source?: string;
+    origin_id?: string;
+}
+export interface IndexChunkResult {
+    indexed: boolean;
+    reason?: string;
+}
+export declare function indexChunk(t: TenantContext, content: string, meta: IndexChunkMeta): Promise<IndexChunkResult>;
+export interface SearchResult {
+    id: string;
+    content: string;
+    distance: number;
+    metadata: {
+        source_path: string;
+        title?: string;
+        timestamp?: string;
+        type?: string;
+        entities?: string[];
+        topics?: string[];
+        summary?: string;
+    };
+}
+export declare function semanticSearch(t: TenantContext, query: string, opts?: {
+    limit?: number;
+    type?: string;
+}): Promise<SearchResult[]>;
+export declare function vectorStats(t: TenantContext): Promise<{
+    count: number;
+    available: boolean;
+}>;
+/** Reset the cached storage module — for tests where we need a clean state. */
+export declare function _resetVecStorageCache(): void;
+//# sourceMappingURL=vectors.d.ts.map

package/dist/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../src/vectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,eAAO,MAAM,aAAa,OAAO,CAAC;AAGlC,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAC/C;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAmB;AACnF,wBAAgB,sBAAsB,IAAI,IAAI,CAAsB;AACpE,wBAAgB,kBAAkB,IAAI,OAAO,CAA+B;AAI5E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,CAAC,EAAE,aAAa,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAUD,wBAAsB,cAAc,CAClC,CAAC,EAAE,aAAa,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCzB;AAED,wBAAsB,WAAW,CAC/B,CAAC,EAAE,aAAa,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAUhD;AA2BD,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}