@soleri/core 2.10.0 → 2.12.0

package/dist/chat/browser-session.js

@@ -0,0 +1,143 @@
+/**
+ * Browser Session Manager — per-chat Playwright isolation.
+ *
+ * Manages a pool of Playwright MCP client sessions, one per chat.
+ * Lazy initialization on first use, idle timeout eviction, FIFO
+ * eviction when max sessions reached.
+ *
+ * The actual Playwright MCP server is spawned as a child process
+ * via stdio transport. This module manages the lifecycle.
+ */
+import { spawn } from 'node:child_process';
+// ─── Session Manager ─────────────────────────────────────────────────
+const DEFAULT_IDLE_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_MAX_SESSIONS = 3;
+export class BrowserSessionManager {
+    sessions = new Map();
+    idleTimeoutMs;
+    maxSessions;
+    command;
+    args;
+    constructor(config = {}) {
+        this.idleTimeoutMs = config.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT;
+        this.maxSessions = config.maxSessions ?? DEFAULT_MAX_SESSIONS;
+        this.command = config.command ?? 'npx';
+        this.args = config.args ?? ['@playwright/mcp', '--headless'];
+    }
+    /**
+     * Get or create a browser session for a chat.
+     * Returns the session, spawning a new process if needed.
+     */
+    acquire(chatId) {
+        const existing = this.sessions.get(chatId);
+        if (existing) {
+            // Reset idle timer
+            if (existing.idleTimer)
+                clearTimeout(existing.idleTimer);
+            existing.lastUsed = Date.now();
+            existing.idleTimer = setTimeout(() => this.release(chatId), this.idleTimeoutMs);
+            return existing;
+        }
+        // Evict if at capacity
+        if (this.sessions.size >= this.maxSessions) {
+            this.evictOldest();
+        }
+        // Spawn new Playwright MCP process
+        const proc = spawn(this.command, this.args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        const session = {
+            chatId,
+            process: proc,
+            lastUsed: Date.now(),
+            idleTimer: setTimeout(() => this.release(chatId), this.idleTimeoutMs),
+        };
+        proc.on('exit', () => {
+            // Clean up if process dies unexpectedly
+            const s = this.sessions.get(chatId);
+            if (s && s.process === proc) {
+                if (s.idleTimer)
+                    clearTimeout(s.idleTimer);
+                this.sessions.delete(chatId);
+            }
+        });
+        this.sessions.set(chatId, session);
+        return session;
+    }
+    /**
+     * Release a browser session (close process, remove from pool).
+     */
+    release(chatId) {
+        const session = this.sessions.get(chatId);
+        if (!session)
+            return false;
+        if (session.idleTimer)
+            clearTimeout(session.idleTimer);
+        try {
+            session.process.kill();
+        }
+        catch {
+            // Process may already be dead
+        }
+        this.sessions.delete(chatId);
+        return true;
+    }
+    /**
+     * Check if a chat has an active browser session.
+     */
+    has(chatId) {
+        return this.sessions.has(chatId);
+    }
+    /**
+     * Close all browser sessions.
+     */
+    closeAll() {
+        let count = 0;
+        for (const chatId of this.sessions.keys()) {
+            if (this.release(chatId))
+                count++;
+        }
+        return count;
+    }
+    /**
+     * Get number of active sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * List active session chat IDs.
+     */
+    listSessions() {
+        return [...this.sessions.keys()];
+    }
+    /**
+     * Get session info.
+     */
+    getInfo(chatId) {
+        const session = this.sessions.get(chatId);
+        if (!session)
+            return null;
+        return {
+            lastUsed: session.lastUsed,
+            pid: session.process.pid ?? null,
+        };
+    }
+    /**
+     * Evict the oldest (least recently used) session.
+     */
+    evictOldest() {
+        let oldest = null;
+        let oldestTime = Infinity;
+        for (const [chatId, session] of this.sessions) {
+            if (session.lastUsed < oldestTime) {
+                oldestTime = session.lastUsed;
+                oldest = chatId;
+            }
+        }
+        if (oldest)
+            this.release(oldest);
+    }
+}
+//# sourceMappingURL=browser-session.js.map

package/dist/chat/browser-session.js.map

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

package/dist/chat/cancellation.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Task Cancellation Manager — per-chat AbortController management.
+ *
+ * Maps chat/session IDs to AbortControllers so running tasks can be
+ * cancelled from commands (e.g. /stop) or inline buttons.
+ *
+ * The agent loop already accepts AbortSignal — this provides the
+ * lifecycle management layer on top.
+ */
+export interface CancellationInfo {
+    /** The AbortController for this task. */
+    controller: AbortController;
+    /** Unix timestamp ms when the task started. */
+    startedAt: number;
+    /** Optional description of what's running. */
+    description?: string;
+}
+export declare class TaskCancellationManager {
+    private active;
+    /**
+     * Create a new AbortController for a chat/session.
+     * If one already exists, it is cancelled first.
+     */
+    create(chatId: string, description?: string): AbortSignal;
+    /**
+     * Cancel the running task for a chat. Returns info about what was cancelled.
+     */
+    cancel(chatId: string): CancellationInfo | null;
+    /**
+     * Mark a task as complete (remove without aborting).
+     */
+    complete(chatId: string): void;
+    /**
+     * Check if a chat has a running task.
+     */
+    isRunning(chatId: string): boolean;
+    /**
+     * Get info about a running task.
+     */
+    getInfo(chatId: string): CancellationInfo | null;
+    /**
+     * Get all running task IDs.
+     */
+    listRunning(): string[];
+    /**
+     * Number of active tasks.
+     */
+    get size(): number;
+    /**
+     * Cancel all running tasks.
+     */
+    cancelAll(): number;
+}
+//# sourceMappingURL=cancellation.d.ts.map

package/dist/chat/cancellation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../src/chat/cancellation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,UAAU,EAAE,eAAe,CAAC;IAC5B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAuC;IAErD;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW;IAczD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAS/C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIhD;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,SAAS,IAAI,MAAM;CAQpB"}

package/dist/chat/cancellation.js

@@ -0,0 +1,80 @@
+/**
+ * Task Cancellation Manager — per-chat AbortController management.
+ *
+ * Maps chat/session IDs to AbortControllers so running tasks can be
+ * cancelled from commands (e.g. /stop) or inline buttons.
+ *
+ * The agent loop already accepts AbortSignal — this provides the
+ * lifecycle management layer on top.
+ */
+export class TaskCancellationManager {
+    active = new Map();
+    /**
+     * Create a new AbortController for a chat/session.
+     * If one already exists, it is cancelled first.
+     */
+    create(chatId, description) {
+        // Cancel existing task if any
+        this.cancel(chatId);
+        const controller = new AbortController();
+        this.active.set(chatId, {
+            controller,
+            startedAt: Date.now(),
+            description,
+        });
+        return controller.signal;
+    }
+    /**
+     * Cancel the running task for a chat. Returns info about what was cancelled.
+     */
+    cancel(chatId) {
+        const info = this.active.get(chatId);
+        if (!info)
+            return null;
+        info.controller.abort();
+        this.active.delete(chatId);
+        return info;
+    }
+    /**
+     * Mark a task as complete (remove without aborting).
+     */
+    complete(chatId) {
+        this.active.delete(chatId);
+    }
+    /**
+     * Check if a chat has a running task.
+     */
+    isRunning(chatId) {
+        return this.active.has(chatId);
+    }
+    /**
+     * Get info about a running task.
+     */
+    getInfo(chatId) {
+        return this.active.get(chatId) ?? null;
+    }
+    /**
+     * Get all running task IDs.
+     */
+    listRunning() {
+        return [...this.active.keys()];
+    }
+    /**
+     * Number of active tasks.
+     */
+    get size() {
+        return this.active.size;
+    }
+    /**
+     * Cancel all running tasks.
+     */
+    cancelAll() {
+        let count = 0;
+        for (const [chatId] of this.active) {
+            this.cancel(chatId);
+            count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/chat/cancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../src/chat/cancellation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAErD;;;OAGG;IACH,MAAM,CAAC,MAAc,EAAE,WAAoB;QACzC,8BAA8B;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEpB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE;YACtB,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,WAAW;SACZ,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpB,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/chat/chat-session.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Chat Session Manager — per-conversation history with disk persistence.
+ *
+ * Ported from Salvador's session-manager.ts with improvements:
+ * - Transport-agnostic (no Telegram coupling)
+ * - Synchronous persistence (matches Soleri's better-sqlite3 heritage)
+ * - Simpler compaction (no personality tracking)
+ * - TTL-based reaping with unref'd timer
+ */
+import type { ChatSession, ChatSessionConfig, ChatMessage } from './types.js';
+export declare class ChatSessionManager {
+    private sessions;
+    private config;
+    private reaperTimer;
+    constructor(config: ChatSessionConfig);
+    /**
+     * Get or create a session. Loads from disk if not in memory.
+     */
+    getOrCreate(sessionId: string): ChatSession;
+    /**
+     * Get a session without creating one.
+     */
+    get(sessionId: string): ChatSession | undefined;
+    /**
+     * Check if a session exists (memory or disk).
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Append a message and persist.
+     */
+    appendMessage(sessionId: string, message: ChatMessage): void;
+    /**
+     * Append multiple messages (e.g. assistant response + tool blocks).
+     */
+    appendMessages(sessionId: string, messages: ChatMessage[]): void;
+    /**
+     * Get message count for a session.
+     */
+    messageCount(sessionId: string): number;
+    /**
+     * Clear session history (keep session alive, wipe messages).
+     */
+    clear(sessionId: string): void;
+    /**
+     * Delete a session entirely (memory + disk).
+     */
+    delete(sessionId: string): void;
+    /**
+     * List all active session IDs (memory only — disk sessions not loaded).
+     */
+    listActive(): string[];
+    /**
+     * List all session IDs (memory + disk).
+     */
+    listAll(): string[];
+    /**
+     * Number of active (in-memory) sessions.
+     */
+    get size(): number;
+    /**
+     * Update session metadata.
+     */
+    setMeta(sessionId: string, meta: Record<string, unknown>): void;
+    /**
+     * Start periodic TTL-based session cleanup.
+     */
+    startReaper(): void;
+    /**
+     * Stop the reaper.
+     */
+    stopReaper(): void;
+    /**
+     * Reap expired sessions. Returns number of sessions reaped.
+     */
+    reap(): number;
+    /**
+     * Close all sessions and stop reaper.
+     */
+    close(): void;
+    private compact;
+    private sessionPath;
+    private persistToDisk;
+    private loadFromDisk;
+    private removeFromDisk;
+}
+//# sourceMappingURL=chat-session.d.ts.map

package/dist/chat/chat-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/chat/chat-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9E,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,WAAW,CAA+C;gBAEtD,MAAM,EAAE,iBAAiB;IAarC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IA4B3C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAO/B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAa5D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAYhE;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOvC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAY9B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAenB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ/D;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,IAAI,IAAI,MAAM;IAkBd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/chat/chat-session.js

@@ -0,0 +1,252 @@
+/**
+ * Chat Session Manager — per-conversation history with disk persistence.
+ *
+ * Ported from Salvador's session-manager.ts with improvements:
+ * - Transport-agnostic (no Telegram coupling)
+ * - Synchronous persistence (matches Soleri's better-sqlite3 heritage)
+ * - Simpler compaction (no personality tracking)
+ * - TTL-based reaping with unref'd timer
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_TTL_MS = 7_200_000; // 2 hours
+const DEFAULT_COMPACTION_THRESHOLD = 100;
+const DEFAULT_COMPACTION_KEEP = 40;
+const REAPER_INTERVAL_MS = 60_000; // 1 minute
+export class ChatSessionManager {
+    sessions = new Map();
+    config;
+    reaperTimer = null;
+    constructor(config) {
+        this.config = {
+            storageDir: config.storageDir,
+            ttlMs: config.ttlMs ?? DEFAULT_TTL_MS,
+            compactionThreshold: config.compactionThreshold ?? DEFAULT_COMPACTION_THRESHOLD,
+            compactionKeep: config.compactionKeep ?? DEFAULT_COMPACTION_KEEP,
+        };
+        mkdirSync(this.config.storageDir, { recursive: true });
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────
+    /**
+     * Get or create a session. Loads from disk if not in memory.
+     */
+    getOrCreate(sessionId) {
+        let session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActiveAt = Date.now();
+            return session;
+        }
+        // Try loading from disk
+        session = this.loadFromDisk(sessionId);
+        if (session) {
+            session.lastActiveAt = Date.now();
+            this.sessions.set(sessionId, session);
+            return session;
+        }
+        // Create new
+        const now = Date.now();
+        session = {
+            id: sessionId,
+            messages: [],
+            createdAt: now,
+            lastActiveAt: now,
+        };
+        this.sessions.set(sessionId, session);
+        this.persistToDisk(session);
+        return session;
+    }
+    /**
+     * Get a session without creating one.
+     */
+    get(sessionId) {
+        return this.sessions.get(sessionId) ?? this.loadFromDisk(sessionId);
+    }
+    /**
+     * Check if a session exists (memory or disk).
+     */
+    has(sessionId) {
+        if (this.sessions.has(sessionId))
+            return true;
+        return existsSync(this.sessionPath(sessionId));
+    }
+    // ─── Message Management ─────────────────────────────────────────
+    /**
+     * Append a message and persist.
+     */
+    appendMessage(sessionId, message) {
+        const session = this.getOrCreate(sessionId);
+        session.messages.push(message);
+        session.lastActiveAt = Date.now();
+        // Auto-compact if threshold exceeded
+        if (session.messages.length > this.config.compactionThreshold) {
+            this.compact(session);
+        }
+        this.persistToDisk(session);
+    }
+    /**
+     * Append multiple messages (e.g. assistant response + tool blocks).
+     */
+    appendMessages(sessionId, messages) {
+        const session = this.getOrCreate(sessionId);
+        session.messages.push(...messages);
+        session.lastActiveAt = Date.now();
+        if (session.messages.length > this.config.compactionThreshold) {
+            this.compact(session);
+        }
+        this.persistToDisk(session);
+    }
+    /**
+     * Get message count for a session.
+     */
+    messageCount(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session?.messages.length ?? 0;
+    }
+    // ─── Session Operations ─────────────────────────────────────────
+    /**
+     * Clear session history (keep session alive, wipe messages).
+     */
+    clear(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.messages = [];
+            session.lastActiveAt = Date.now();
+            this.persistToDisk(session);
+        }
+        else {
+            // Remove from disk
+            this.removeFromDisk(sessionId);
+        }
+    }
+    /**
+     * Delete a session entirely (memory + disk).
+     */
+    delete(sessionId) {
+        this.sessions.delete(sessionId);
+        this.removeFromDisk(sessionId);
+    }
+    /**
+     * List all active session IDs (memory only — disk sessions not loaded).
+     */
+    listActive() {
+        return [...this.sessions.keys()];
+    }
+    /**
+     * List all session IDs (memory + disk).
+     */
+    listAll() {
+        const memoryIds = new Set(this.sessions.keys());
+        try {
+            const files = readdirSync(this.config.storageDir);
+            for (const f of files) {
+                if (f.endsWith('.json')) {
+                    memoryIds.add(f.replace('.json', ''));
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet
+        }
+        return [...memoryIds];
+    }
+    /**
+     * Number of active (in-memory) sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Update session metadata.
+     */
+    setMeta(sessionId, meta) {
+        const session = this.getOrCreate(sessionId);
+        session.meta = { ...session.meta, ...meta };
+        this.persistToDisk(session);
+    }
+    // ─── Reaping (TTL cleanup) ─────────────────────────────────────
+    /**
+     * Start periodic TTL-based session cleanup.
+     */
+    startReaper() {
+        if (this.reaperTimer)
+            return;
+        this.reaperTimer = setInterval(() => this.reap(), REAPER_INTERVAL_MS);
+        this.reaperTimer.unref();
+    }
+    /**
+     * Stop the reaper.
+     */
+    stopReaper() {
+        if (this.reaperTimer) {
+            clearInterval(this.reaperTimer);
+            this.reaperTimer = null;
+        }
+    }
+    /**
+     * Reap expired sessions. Returns number of sessions reaped.
+     */
+    reap() {
+        if (this.config.ttlMs <= 0)
+            return 0;
+        const now = Date.now();
+        const cutoff = now - this.config.ttlMs;
+        let reaped = 0;
+        for (const [id, session] of this.sessions) {
+            if (session.lastActiveAt < cutoff) {
+                this.sessions.delete(id);
+                this.removeFromDisk(id);
+                reaped++;
+            }
+        }
+        return reaped;
+    }
+    /**
+     * Close all sessions and stop reaper.
+     */
+    close() {
+        this.stopReaper();
+        this.sessions.clear();
+    }
+    // ─── Private ───────────────────────────────────────────────────
+    compact(session) {
+        const keep = this.config.compactionKeep;
+        if (session.messages.length <= keep)
+            return;
+        session.messages = session.messages.slice(-keep);
+    }
+    sessionPath(sessionId) {
+        // Sanitize ID for filesystem safety
+        const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return join(this.config.storageDir, `${safe}.json`);
+    }
+    persistToDisk(session) {
+        try {
+            writeFileSync(this.sessionPath(session.id), JSON.stringify(session), 'utf-8');
+        }
+        catch {
+            // Disk write failure is non-critical — session lives in memory
+        }
+    }
+    loadFromDisk(sessionId) {
+        const path = this.sessionPath(sessionId);
+        if (!existsSync(path))
+            return undefined;
+        try {
+            const data = readFileSync(path, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    removeFromDisk(sessionId) {
+        const path = this.sessionPath(sessionId);
+        try {
+            rmSync(path, { force: true });
+        }
+        catch {
+            // Removal failure is non-critical
+        }
+    }
+}
+//# sourceMappingURL=chat-session.js.map

package/dist/chat/chat-session.js.map

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