aiden-runtime 3.16.0

package/dist/core/memoryExtractor.js

@@ -0,0 +1,212 @@
+"use strict";
+// ============================================================
+// DevOS — Autonomous AI Execution System
+// Copyright (c) 2026 Shiva Deore. All rights reserved.
+// ============================================================
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryExtractor = void 0;
+// core/memoryExtractor.ts — Post-conversation durable memory extraction.
+// After every conversation ends, scans messages and writes facts to
+// workspace/memory/ as typed frontmatter markdown files.
+// Maintains workspace/memory/MEMORY_INDEX.md (max 100 entries).
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const auxiliaryClient_1 = require("./auxiliaryClient");
+const MEMORY_DIR = path_1.default.join(process.cwd(), 'workspace', 'memory');
+const INDEX_PATH = path_1.default.join(MEMORY_DIR, 'MEMORY_INDEX.md');
+const SESSIONS_DIR = path_1.default.join(process.cwd(), 'workspace', 'sessions');
+const SOURCE_CONFIDENCE = {
+    user_stated: 1.0,
+    tool_result: 0.8,
+    llm_inferred: 0.5,
+};
+// ── Helpers ───────────────────────────────────────────────────
+function memoryFilePath(filename) {
+    return path_1.default.join(MEMORY_DIR, filename);
+}
+function today() {
+    return new Date().toISOString().split('T')[0];
+}
+function readIndex() {
+    try {
+        if (!fs_1.default.existsSync(INDEX_PATH))
+            return [];
+        const content = fs_1.default.readFileSync(INDEX_PATH, 'utf-8');
+        return content.trim().split('\n')
+            .filter(l => l.startsWith('- ['))
+            .map(l => {
+            const m = l.match(/^- \[(.+?)\]\((.+?)\) — (.+)$/);
+            if (!m)
+                return null;
+            return { filename: m[2], title: m[1], type: 'project_fact', summary: m[3] };
+        })
+            .filter((e) => e !== null);
+    }
+    catch {
+        return [];
+    }
+}
+function writeIndex(entries) {
+    try {
+        const lines = entries.slice(0, 100).map(e => `- [${e.title}](${e.filename}) — ${e.summary}`);
+        fs_1.default.writeFileSync(INDEX_PATH, lines.join('\n') + '\n', 'utf-8');
+    }
+    catch (e) {
+        console.error('[MemoryExtractor] Index write failed:', e.message);
+    }
+}
+function buildExtractionPrompt(sessionContent, existingIndex) {
+    return `You are a memory extractor for DevOS. Read the session below and extract durable facts worth remembering.
+
+EXISTING MEMORY INDEX:
+${existingIndex || '(empty)'}
+
+SESSION CONTENT:
+${sessionContent.slice(0, 3000)}
+
+Extract 1-5 memory items. For each one output JSON in this format:
+[
+  {
+    "type": "user_preference|project_fact|tool_pattern|learned_behavior",
+    "filename": "user_name.md or project_architecture.md (use type prefix + snake_case descriptor)",
+    "title": "Short descriptive title",
+    "content": "Concise actionable fact. 1-4 sentences.",
+    "summary": "One-line summary for index",
+    "source": "user_stated|tool_result|llm_inferred",
+    "confidence": 0.5
+  }
+]
+
+Rules:
+- Only extract facts that are genuinely useful in a future conversation
+- Skip trivial or already-indexed facts
+- learned_behavior: corrections, things to avoid
+- tool_pattern: commands that work/fail, file paths
+- project_fact: architecture, design decisions
+- user_preference: communication style, preferences
+- source rules:
+  - "user_stated": the user directly said/told this fact → confidence 1.0
+  - "tool_result": fact came from a tool's returned data → confidence 0.8
+  - "llm_inferred": you are summarizing or inferring from context → confidence 0.5
+- Output ONLY valid JSON array, nothing else`;
+}
+// ── MemoryExtractor ───────────────────────────────────────────
+class MemoryExtractor {
+    constructor() {
+        try {
+            fs_1.default.mkdirSync(MEMORY_DIR, { recursive: true });
+        }
+        catch { }
+    }
+    // ── Extract from session ───────────────────────────────────
+    async extractFromSession(sessionId) {
+        const sessionFile = path_1.default.join(SESSIONS_DIR, `${sessionId}.md`);
+        if (!fs_1.default.existsSync(sessionFile))
+            return;
+        try {
+            const sessionContent = fs_1.default.readFileSync(sessionFile, 'utf-8');
+            if (sessionContent.length < 100)
+                return; // too short
+            const existingIndex = fs_1.default.existsSync(INDEX_PATH)
+                ? fs_1.default.readFileSync(INDEX_PATH, 'utf-8').slice(0, 2000)
+                : '';
+            const prompt = buildExtractionPrompt(sessionContent, existingIndex);
+            const raw = await auxiliaryClient_1.auxiliaryClient.complete(prompt, { task: 'memory_extraction', maxTokens: 300 });
+            if (!raw)
+                return;
+            // Parse JSON array from response
+            const jsonMatch = raw.replace(/```json\s*/g, '').replace(/```\s*/g, '').match(/\[[\s\S]*\]/);
+            if (!jsonMatch)
+                return;
+            const items = JSON.parse(jsonMatch[0]);
+            if (!Array.isArray(items) || items.length === 0)
+                return;
+            const existingEntries = readIndex();
+            for (const item of items) {
+                if (!item.filename || !item.title || !item.content)
+                    continue;
+                const source = item.source || 'llm_inferred';
+                const confidence = item.confidence ?? SOURCE_CONFIDENCE[source];
+                await this.writeMemoryFile(item.filename, item.type, item.title, item.content, existingEntries, source, confidence, sessionId);
+            }
+            // Update index
+            writeIndex(existingEntries);
+            console.log(`[MemoryExtractor] Extracted ${items.length} memory item(s) from session ${sessionId}`);
+        }
+        catch (e) {
+            console.error('[MemoryExtractor] Extraction failed:', e.message);
+        }
+    }
+    // ── Write a single memory file ─────────────────────────────
+    async writeMemoryFile(filename, type, title, content, indexEntries, source = 'llm_inferred', confidence = 0.5, sessionId = '') {
+        const filePath = memoryFilePath(filename);
+        const now = today();
+        // Check if file already exists — update rather than duplicate
+        let created = now;
+        if (fs_1.default.existsSync(filePath)) {
+            try {
+                const existing = fs_1.default.readFileSync(filePath, 'utf-8');
+                const m = existing.match(/^created:\s*(.+)$/m);
+                if (m)
+                    created = m[1].trim();
+            }
+            catch { }
+        }
+        const frontmatter = `---
+title: ${title}
+type: ${type}
+created: ${created}
+updated: ${now}
+source: ${source}
+confidence: ${confidence}
+session: ${sessionId}
+---
+
+${content.trim()}
+`;
+        try {
+            fs_1.default.writeFileSync(filePath, frontmatter, 'utf-8');
+        }
+        catch (e) {
+            console.error(`[MemoryExtractor] Write failed for ${filename}:`, e.message);
+            return;
+        }
+        // Update or add index entry
+        const existing = indexEntries.findIndex(e => e.filename === filename);
+        const entry = { filename, title, type, summary: content.slice(0, 80).replace(/\n/g, ' ') };
+        if (existing >= 0) {
+            indexEntries[existing] = entry;
+        }
+        else {
+            indexEntries.unshift(entry);
+        }
+    }
+    // ── Load memory index for system prompt injection ──────────
+    loadMemoryIndex() {
+        try {
+            if (!fs_1.default.existsSync(INDEX_PATH))
+                return '';
+            return fs_1.default.readFileSync(INDEX_PATH, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+    }
+    // ── Load a specific memory file ────────────────────────────
+    loadMemoryFile(filename) {
+        try {
+            const p = memoryFilePath(filename);
+            if (!fs_1.default.existsSync(p))
+                return '';
+            return fs_1.default.readFileSync(p, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────
+exports.memoryExtractor = new MemoryExtractor();

package/dist/core/memoryIds.js

@@ -0,0 +1,213 @@
+"use strict";
+// ============================================================
+// DevOS — Autonomous AI Execution System
+// Copyright (c) 2026 Shiva Deore. All rights reserved.
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextId = nextId;
+exports.appendRecord = appendRecord;
+exports.loadAllRecords = loadAllRecords;
+exports.loadRecordById = loadRecordById;
+exports.assignId = assignId;
+exports.runMigrationIfNeeded = runMigrationIfNeeded;
+/**
+ * core/memoryIds.ts — Stable mem_NNNNNN IDs + append-only records.jsonl
+ *
+ * Sits on top of the existing 6-layer memory architecture.
+ * Does NOT touch conversationMemory, semanticMemory, knowledgeBase, etc.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ── Paths ──────────────────────────────────────────────────────────────────
+const MEM_DIR = path.join(process.cwd(), 'workspace', 'memory');
+const SEQUENCE_FILE = path.join(MEM_DIR, 'sequence.json');
+const RECORDS_FILE = path.join(MEM_DIR, 'records.jsonl');
+// ── Sequence counter ────────────────────────────────────────────────────────
+function _ensureDir() {
+    fs.mkdirSync(MEM_DIR, { recursive: true });
+}
+function _readSeq() {
+    try {
+        if (!fs.existsSync(SEQUENCE_FILE))
+            return 0;
+        const d = JSON.parse(fs.readFileSync(SEQUENCE_FILE, 'utf-8'));
+        return typeof d.next === 'number' ? d.next : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function _writeSeq(n) {
+    _ensureDir();
+    fs.writeFileSync(SEQUENCE_FILE, JSON.stringify({ next: n }), 'utf-8');
+}
+function nextId() {
+    const n = _readSeq();
+    _writeSeq(n + 1);
+    return `mem_${String(n + 1).padStart(6, '0')}`;
+}
+// ── Record persistence ──────────────────────────────────────────────────────
+function appendRecord(record) {
+    _ensureDir();
+    fs.appendFileSync(RECORDS_FILE, JSON.stringify(record) + '\n', 'utf-8');
+}
+function loadAllRecords() {
+    try {
+        if (!fs.existsSync(RECORDS_FILE))
+            return [];
+        return fs.readFileSync(RECORDS_FILE, 'utf-8')
+            .split('\n')
+            .filter(l => l.trim())
+            .map(l => {
+            try {
+                return JSON.parse(l);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+function loadRecordById(id) {
+    const all = loadAllRecords();
+    return all.find(r => r.id === id) ?? null;
+}
+// ── ID assignment helper ────────────────────────────────────────────────────
+function assignId(partial) {
+    const record = {
+        id: partial.id ?? nextId(),
+        timestamp: partial.timestamp ?? new Date().toISOString(),
+        type: partial.type ?? 'observation',
+        content: partial.content ?? '',
+        summary: partial.summary ?? _autoSummary(partial.content ?? ''),
+        sessionId: partial.sessionId,
+        tags: partial.tags,
+        entityRefs: partial.entityRefs,
+    };
+    appendRecord(record);
+    return record;
+}
+function _autoSummary(content) {
+    // Take first non-empty line, trim to 100 chars
+    const first = content.split('\n').find(l => l.trim()) ?? content;
+    return first.slice(0, 100).trim();
+}
+// ── One-time migration ──────────────────────────────────────────────────────
+function runMigrationIfNeeded() {
+    if (fs.existsSync(RECORDS_FILE))
+        return 0; // already migrated
+    _ensureDir();
+    const records = [];
+    // Source 1: workspace/memory/memory.json  (task/agent results)
+    try {
+        const raw = fs.readFileSync(path.join(MEM_DIR, 'memory.json'), 'utf-8');
+        const parsed = JSON.parse(raw);
+        const items = Array.isArray(parsed) ? parsed : (parsed.value ?? []);
+        for (const item of items) {
+            const v = item.value ?? {};
+            const content = [
+                v.goal ? `Goal: ${v.goal}` : '',
+                v.result ? `Result: ${String(v.result).slice(0, 800)}` : '',
+                v.role ? `Role: ${v.role}` : '',
+            ].filter(Boolean).join('\n');
+            if (!content)
+                continue;
+            records.push({
+                timestamp: item.createdAt ?? new Date().toISOString(),
+                type: item.tags?.includes('task') ? 'interaction' : 'observation',
+                content,
+                summary: _autoSummary(v.goal ?? v.result ?? content),
+                tags: item.tags ?? [],
+            });
+        }
+    }
+    catch { /* non-fatal */ }
+    // Source 2: workspace/conversation-memory.json  (conversation messages)
+    try {
+        const raw = fs.readFileSync(path.join(process.cwd(), 'workspace', 'conversation-memory.json'), 'utf-8');
+        const parsed = JSON.parse(raw);
+        const msgs = parsed.messages ?? [];
+        // Only migrate assistant messages that have meaningful content
+        for (const msg of msgs) {
+            if (msg.role !== 'assistant')
+                continue;
+            const content = String(msg.content ?? '').trim();
+            if (content.length < 20)
+                continue;
+            records.push({
+                timestamp: msg.timestamp ?? new Date().toISOString(),
+                type: 'interaction',
+                content: content.slice(0, 1000),
+                summary: _autoSummary(content),
+                sessionId: msg.sessionId,
+                tags: ['conversation'],
+            });
+        }
+    }
+    catch { /* non-fatal */ }
+    // Source 3: workspace/memory/MEMORY_INDEX.md  (.md lines as facts)
+    try {
+        const raw = fs.readFileSync(path.join(MEM_DIR, 'MEMORY_INDEX.md'), 'utf-8');
+        const lines = raw.split('\n').filter(l => l.startsWith('- '));
+        for (const line of lines) {
+            const cleaned = line.replace(/^-\s*/, '').trim();
+            if (cleaned.length < 10)
+                continue;
+            records.push({
+                timestamp: new Date().toISOString(),
+                type: 'fact',
+                content: cleaned,
+                summary: cleaned.slice(0, 100),
+                tags: ['index'],
+            });
+        }
+    }
+    catch { /* non-fatal */ }
+    // Sort by timestamp ascending, assign IDs, write
+    records.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    let count = 0;
+    for (const rec of records) {
+        const id = nextId();
+        const record = { id, ...rec };
+        appendRecord(record);
+        count++;
+    }
+    return count;
+}

package/dist/core/memoryPreamble.js

@@ -0,0 +1,113 @@
+"use strict";
+// ============================================================
+// DevOS — Autonomous AI Execution System
+// Copyright (c) 2026 Shiva Deore. All rights reserved.
+// ============================================================
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGreetingPreamble = buildGreetingPreamble;
+// core/memoryPreamble.ts — Phase 4: Greeting fast-path memory surface.
+//
+// When the user sends a greeting ("hi", "good morning", etc.) the semantic
+// memory recall in streamChat produces no matches because there is no
+// substantive query to match against.  This module builds a compact
+// "what I know right now" preamble from the live conversation facts so
+// Aiden can open with context-aware continuity even on the very first
+// sentence of a new session.
+//
+// Usage:
+//   const preamble = await buildGreetingPreamble()
+//   // => "GREETING CONTEXT:\nRecent files: report.py\nActive goals: ..." | null
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const conversationMemory_1 = require("./conversationMemory");
+const goalTracker_1 = require("./goalTracker");
+const sessionMemory_1 = require("./sessionMemory");
+const USER_MD = path_1.default.join(process.env.AIDEN_USER_DATA || process.cwd(), 'workspace', 'USER.md');
+function readUserName() {
+    try {
+        if (!fs_1.default.existsSync(USER_MD))
+            return null;
+        const content = fs_1.default.readFileSync(USER_MD, 'utf-8');
+        const match = content.match(/^Name:\s*(.+)/m);
+        if (!match)
+            return null;
+        const name = match[1].trim();
+        if (!name || name.toLowerCase() === 'user')
+            return null;
+        return name;
+    }
+    catch {
+        return null;
+    }
+}
+function extractLastSessionSummary(raw) {
+    if (!raw)
+        return null;
+    const titleMatch = raw.match(/# Session Title\s*\n_?([^\n_#]+)/);
+    const stateMatch = raw.match(/# Current State\s*\n_?([\s\S]*?)(?=\n#|$)/);
+    const parts = [];
+    if (titleMatch?.[1]?.trim())
+        parts.push(`Last session: ${titleMatch[1].trim()}`);
+    if (stateMatch?.[1]?.trim()) {
+        const state = stateMatch[1].replace(/^_|_$/g, '').trim().slice(0, 120);
+        if (state)
+            parts.push(`State: ${state}`);
+    }
+    return parts.length > 0 ? parts.join(' — ') : null;
+}
+// ── Main export ───────────────────────────────────────────────────────────────
+/**
+ * Build a compact preamble from live memory facts.
+ * Returns null when there is nothing meaningful to surface
+ * (e.g. a brand-new session with no prior history).
+ */
+async function buildGreetingPreamble(sessionId) {
+    try {
+        const facts = conversationMemory_1.conversationMemory.getFacts();
+        const goals = (0, goalTracker_1.getActiveGoalsSummary)();
+        const parts = [];
+        // User name from USER.md
+        const name = readUserName();
+        if (name)
+            parts.push(`User name: ${name}`);
+        // Last session context
+        if (sessionId) {
+            const lastCtx = sessionMemory_1.sessionMemory.getLastContext(sessionId);
+            const sessionSummary = extractLastSessionSummary(lastCtx);
+            if (sessionSummary)
+                parts.push(sessionSummary);
+        }
+        if (facts.lastFilesCreated.length > 0) {
+            parts.push(`Recent files: ${facts.lastFilesCreated.slice(-3).join(', ')}`);
+        }
+        if (facts.lastSearchQueries.length > 0) {
+            parts.push(`Recent searches: ${facts.lastSearchQueries.slice(-2).join(', ')}`);
+        }
+        if (facts.mentionedEntities.length > 0) {
+            parts.push(`Recent topics: ${facts.mentionedEntities.slice(-6).join(', ')}`);
+        }
+        if (facts.preferredPaths.length > 0) {
+            parts.push(`Frequent paths: ${facts.preferredPaths.slice(-2).join(', ')}`);
+        }
+        if (goals) {
+            // getActiveGoalsSummary() returns "Active goals:\n- title [status]: action\n..."
+            // Extract compact single-line titles to avoid double-labeling and regex capture bugs
+            const goalLines = goals.split('\n').filter((l) => l.trim().startsWith('- '));
+            const goalTitles = goalLines.map((l) => {
+                const m = l.match(/^-\s+(.+?)\s+\[/);
+                return m ? m[1] : l.replace(/^-\s+/, '').split('[')[0].trim();
+            }).filter(Boolean).join(', ');
+            if (goalTitles)
+                parts.push(`Active goals: ${goalTitles}`);
+        }
+        if (parts.length === 0)
+            return null;
+        return `GREETING CONTEXT (reference naturally if relevant — do not recite mechanically):\n${parts.join('\n')}`;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/core/memoryQuery.js

@@ -0,0 +1,136 @@
+"use strict";
+// ============================================================
+// DevOS — Autonomous AI Execution System
+// Copyright (c) 2026 Shiva Deore. All rights reserved.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackCitation = trackCitation;
+exports.getSessionCitations = getSessionCitations;
+exports.clearSessionCitations = clearSessionCitations;
+exports.memsearch = memsearch;
+exports.memtimeline = memtimeline;
+exports.memget = memget;
+/**
+ * core/memoryQuery.ts — 3-layer progressive disclosure memory query
+ *
+ * Layer 1  memsearch()   — [{id, summary, type, date, score}]   ~50 tok/hit
+ * Layer 2  memtimeline() — chronological ±window around a record ~200 tok
+ * Layer 3  memget()      — full record bodies for selected IDs   ~500-1000 tok each
+ */
+const memoryIds_1 = require("./memoryIds");
+const _sessionCitations = new Map();
+function trackCitation(id, summary) {
+    const c = _sessionCitations.get(id);
+    if (c) {
+        c.refs++;
+    }
+    else {
+        _sessionCitations.set(id, { id, summary, refs: 1 });
+    }
+}
+function getSessionCitations() {
+    return Array.from(_sessionCitations.values());
+}
+function clearSessionCitations() {
+    _sessionCitations.clear();
+}
+async function memsearch(query, opts = {}) {
+    const limit = opts.limit ?? 10;
+    const records = (0, memoryIds_1.loadAllRecords)();
+    const words = query.toLowerCase().split(/\s+/).filter(w => w.length > 1);
+    if (words.length === 0) {
+        // No query words — return most recent
+        return records
+            .slice(-limit)
+            .reverse()
+            .map(r => _toHit(r, 0));
+    }
+    // Filter by type
+    let filtered = opts.type
+        ? records.filter(r => r.type === opts.type)
+        : records;
+    // Filter by since
+    if (opts.since) {
+        const sinceMs = new Date(opts.since).getTime();
+        filtered = filtered.filter(r => new Date(r.timestamp).getTime() >= sinceMs);
+    }
+    // Score each record
+    const scored = filtered.map(r => {
+        const hay = (r.summary + ' ' + r.content).toLowerCase();
+        const hits = words.filter(w => hay.includes(w)).length;
+        const score = hits / words.length;
+        return { record: r, score };
+    });
+    // Filter zero-score, sort desc by score then recency
+    const hits = scored
+        .filter(x => x.score > 0)
+        .sort((a, b) => {
+        if (Math.abs(a.score - b.score) > 0.01)
+            return b.score - a.score;
+        return new Date(b.record.timestamp).getTime() - new Date(a.record.timestamp).getTime();
+    })
+        .slice(0, limit)
+        .map(x => _toHit(x.record, x.score));
+    // Track citations for pulse
+    for (const h of hits)
+        trackCitation(h.id, h.summary);
+    return hits;
+}
+function _toHit(r, score) {
+    return {
+        id: r.id,
+        summary: r.summary.slice(0, 120),
+        type: r.type,
+        date: r.timestamp.slice(0, 10),
+        score: Math.round(score * 100) / 100,
+    };
+}
+async function memtimeline(centerId, opts = {}) {
+    const center = (0, memoryIds_1.loadRecordById)(centerId);
+    if (!center)
+        return null;
+    const windowMs = (opts.windowHours ?? 6) * 60 * 60 * 1000;
+    const centerMs = new Date(center.timestamp).getTime();
+    const allRecords = (0, memoryIds_1.loadAllRecords)();
+    const before = [];
+    const after = [];
+    for (const r of allRecords) {
+        if (r.id === centerId)
+            continue;
+        const t = new Date(r.timestamp).getTime();
+        const delta = t - centerMs;
+        if (Math.abs(delta) > windowMs)
+            continue;
+        const slim = {
+            id: r.id,
+            summary: r.summary.slice(0, 100),
+            type: r.type,
+            timestamp: r.timestamp,
+        };
+        if (delta < 0)
+            before.push(slim);
+        else
+            after.push(slim);
+    }
+    // Keep at most 5 before (most recent 5) and 5 after (earliest 5)
+    before.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    after.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    // Track citation
+    trackCitation(center.id, center.summary);
+    return {
+        center,
+        before: before.slice(0, 5),
+        after: after.slice(0, 5),
+        sessionContext: center.sessionId,
+    };
+}
+async function memget(ids) {
+    const allRecords = (0, memoryIds_1.loadAllRecords)();
+    const byId = new Map(allRecords.map(r => [r.id, r]));
+    return ids.map(id => {
+        const record = byId.get(id) ?? null;
+        if (record)
+            trackCitation(id, record.summary);
+        return { id, record, found: record !== null };
+    });
+}