@auxiora/sessions 1.0.0

package/dist/manager.js

@@ -0,0 +1,269 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as crypto from 'node:crypto';
+import { getSessionsDir } from '@auxiora/core';
+import { audit } from '@auxiora/audit';
+import { SessionDatabase } from './db.js';
+function generateMessageId() {
+    const timestamp = Date.now().toString(36);
+    const random = crypto.randomBytes(4).toString('hex');
+    return `${timestamp}-${random}`;
+}
+export class SessionManager {
+    sessions = new Map();
+    config;
+    db;
+    sessionsDir;
+    cleanupInterval = null;
+    constructor(config) {
+        this.config = config;
+        this.sessionsDir = config.sessionsDir ?? getSessionsDir();
+        const dbPath = config.dbPath ?? path.join(this.sessionsDir, 'sessions.db');
+        fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        this.db = new SessionDatabase(dbPath);
+        // Cleanup expired sessions every 5 minutes (non-webchat channels only)
+        this.cleanupInterval = setInterval(() => this.cleanupExpired(), 5 * 60 * 1000);
+    }
+    async initialize() {
+        // Migrate legacy JSON session files to SQLite
+        let files;
+        try {
+            files = fs.readdirSync(this.sessionsDir).filter(f => f.endsWith('.json'));
+        }
+        catch {
+            return; // Directory doesn't exist or not readable
+        }
+        if (files.length === 0)
+            return;
+        const migratedDir = path.join(this.sessionsDir, 'migrated');
+        fs.mkdirSync(migratedDir, { recursive: true });
+        for (const file of files) {
+            const filePath = path.join(this.sessionsDir, file);
+            try {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                const data = JSON.parse(raw);
+                const title = data.metadata.channelType === 'webchat' ? 'New Chat' : `${data.metadata.channelType} session`;
+                this.db.insertChatWithId(data.id, title, data.metadata.channelType, data.metadata.createdAt, data.metadata.lastActiveAt, data.metadata.senderId);
+                for (const msg of data.messages) {
+                    this.db.addMessage(data.id, msg.id, msg.role, msg.content, msg.timestamp, msg.tokens?.input, msg.tokens?.output);
+                }
+                // Move original to migrated/
+                fs.renameSync(filePath, path.join(migratedDir, file));
+            }
+            catch {
+                // Skip corrupt files — leave them in place
+            }
+        }
+    }
+    async create(metadata) {
+        const title = metadata.channelType === 'webchat' ? 'New Chat' : `${metadata.channelType} session`;
+        const chat = this.db.createChat(title, metadata.channelType, metadata.senderId);
+        const now = Date.now();
+        const session = {
+            id: chat.id,
+            messages: [],
+            metadata: {
+                channelType: metadata.channelType,
+                senderId: metadata.senderId,
+                clientId: metadata.clientId,
+                createdAt: now,
+                lastActiveAt: now,
+            },
+        };
+        this.sessions.set(chat.id, session);
+        await audit('session.created', { sessionId: chat.id, channelType: metadata.channelType });
+        return session;
+    }
+    async get(id) {
+        // Check in-memory cache
+        if (this.sessions.has(id)) {
+            return this.sessions.get(id);
+        }
+        // Check DB
+        const chat = this.db.getChat(id);
+        if (!chat)
+            return null;
+        const messages = this.db.getMessages(id);
+        const session = {
+            id: chat.id,
+            messages,
+            metadata: {
+                channelType: chat.channel,
+                senderId: chat.metadata?.senderId,
+                clientId: chat.metadata?.clientId,
+                createdAt: chat.createdAt,
+                lastActiveAt: chat.updatedAt,
+            },
+        };
+        this.sessions.set(id, session);
+        return session;
+    }
+    async getOrCreate(key, metadata) {
+        // Check in-memory cache first
+        for (const session of this.sessions.values()) {
+            if (session.metadata.senderId === metadata.senderId &&
+                session.metadata.channelType === metadata.channelType) {
+                session.metadata.lastActiveAt = Date.now();
+                return session;
+            }
+        }
+        // Check DB
+        if (metadata.senderId) {
+            const chat = this.db.getOrCreateSessionChat(metadata.senderId, metadata.channelType);
+            const existing = this.sessions.get(chat.id);
+            if (existing) {
+                existing.metadata.lastActiveAt = Date.now();
+                return existing;
+            }
+            const messages = this.db.getMessages(chat.id);
+            const session = {
+                id: chat.id,
+                messages,
+                metadata: {
+                    channelType: metadata.channelType,
+                    senderId: metadata.senderId,
+                    clientId: metadata.clientId,
+                    createdAt: chat.createdAt,
+                    lastActiveAt: Date.now(),
+                },
+            };
+            this.sessions.set(chat.id, session);
+            return session;
+        }
+        // No senderId — create new
+        return this.create(metadata);
+    }
+    async addMessage(sessionId, role, content, tokens) {
+        const session = await this.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        const message = {
+            id: generateMessageId(),
+            role,
+            content,
+            timestamp: Date.now(),
+            tokens,
+        };
+        session.messages.push(message);
+        session.metadata.lastActiveAt = Date.now();
+        // Persist to DB
+        this.db.addMessage(sessionId, message.id, role, content, message.timestamp, tokens?.input, tokens?.output);
+        return message;
+    }
+    getMessages(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session)
+            return session.messages;
+        // Fall back to DB
+        return this.db.getMessages(sessionId);
+    }
+    getContextMessages(sessionId, maxTokens) {
+        const limit = maxTokens || this.config.maxContextTokens;
+        // Try in-memory first
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            const messages = [];
+            let tokenCount = 0;
+            for (let i = session.messages.length - 1; i >= 0; i--) {
+                const msg = session.messages[i];
+                const msgTokens = Math.ceil(msg.content.length / 4);
+                if (tokenCount + msgTokens > limit)
+                    break;
+                messages.unshift(msg);
+                tokenCount += msgTokens;
+            }
+            return messages;
+        }
+        // Fall back to DB
+        return this.db.getContextMessages(sessionId, limit);
+    }
+    async setSystemPrompt(sessionId, prompt) {
+        const session = await this.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        session.systemPrompt = prompt;
+    }
+    async save(_sessionId) {
+        // No-op — writes are immediate with SQLite
+    }
+    async delete(sessionId) {
+        const existed = this.sessions.delete(sessionId);
+        this.db.deleteChat(sessionId);
+        if (existed) {
+            await audit('session.destroyed', { sessionId });
+        }
+        return existed;
+    }
+    async clear(sessionId) {
+        const session = await this.get(sessionId);
+        if (!session)
+            return;
+        session.messages = [];
+        session.metadata.lastActiveAt = Date.now();
+        this.db.clearMessages(sessionId);
+    }
+    async compact(sessionId, summary) {
+        const session = await this.get(sessionId);
+        if (!session || !this.config.compactionEnabled)
+            return;
+        const originalCount = session.messages.length;
+        this.db.clearMessages(sessionId);
+        const summaryMessage = {
+            id: generateMessageId(),
+            role: 'system',
+            content: `[Previous conversation summary]\n${summary}`,
+            timestamp: Date.now(),
+        };
+        session.messages = [summaryMessage];
+        session.metadata.lastActiveAt = Date.now();
+        this.db.addMessage(sessionId, summaryMessage.id, 'system', summaryMessage.content, summaryMessage.timestamp);
+        await audit('session.compacted', { sessionId, originalCount });
+    }
+    cleanupExpired() {
+        const now = Date.now();
+        const ttlMs = this.config.ttlMinutes * 60 * 1000;
+        for (const [id, session] of this.sessions) {
+            // Only expire non-webchat sessions from memory
+            if (session.metadata.channelType === 'webchat')
+                continue;
+            if (now - session.metadata.lastActiveAt > ttlMs) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+    getActiveSessions() {
+        return Array.from(this.sessions.values());
+    }
+    // ── Chat management ──
+    createChat(title) {
+        return this.db.createChat(title ?? 'New Chat', 'webchat');
+    }
+    listChats(options) {
+        return this.db.listChats(options);
+    }
+    renameChat(chatId, title) {
+        this.db.renameChat(chatId, title);
+    }
+    archiveChat(chatId) {
+        this.db.archiveChat(chatId);
+        this.sessions.delete(chatId);
+    }
+    deleteChat(chatId) {
+        this.db.deleteChat(chatId);
+        this.sessions.delete(chatId);
+    }
+    getChatMessages(chatId) {
+        return this.db.getMessages(chatId);
+    }
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.sessions.clear();
+        this.db.close();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export type MessageRole = 'user' | 'assistant' | 'system';
+export interface Message {
+    id: string;
+    role: MessageRole;
+    content: string;
+    timestamp: number;
+    tokens?: {
+        input?: number;
+        output?: number;
+    };
+}
+export interface SessionMetadata {
+    channelType: string;
+    senderId?: string;
+    clientId?: string;
+    createdAt: number;
+    lastActiveAt: number;
+    activeMode?: string;
+    modeAutoDetected?: boolean;
+    escalationLevel?: string;
+    suspendedMode?: string;
+}
+export interface Session {
+    id: string;
+    messages: Message[];
+    metadata: SessionMetadata;
+    systemPrompt?: string;
+}
+export interface SessionConfig {
+    maxContextTokens: number;
+    ttlMinutes: number;
+    autoSave: boolean;
+    compactionEnabled: boolean;
+    dbPath?: string;
+    sessionsDir?: string;
+}
+export interface Chat {
+    id: string;
+    title: string;
+    channel: string;
+    createdAt: number;
+    updatedAt: number;
+    archived: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface ListChatsOptions {
+    archived?: boolean;
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@auxiora/sessions",
+  "version": "1.0.0",
+  "description": "Session management for Auxiora",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@auxiora/audit": "1.0.0",
+    "@auxiora/core": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/db.ts

@@ -0,0 +1,180 @@
+import { DatabaseSync } from 'node:sqlite';
+import * as crypto from 'node:crypto';
+import type { Message, Chat, ListChatsOptions } from './types.js';
+
+function generateId(): string {
+  return crypto.randomUUID();
+}
+
+export class SessionDatabase {
+  private db: DatabaseSync;
+
+  constructor(dbPath: string) {
+    this.db = new DatabaseSync(dbPath);
+    this.db.exec('PRAGMA journal_mode=WAL');
+    this.db.exec('PRAGMA foreign_keys=ON');
+    this.migrate();
+  }
+
+  private migrate(): void {
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS chats (
+        id          TEXT PRIMARY KEY,
+        title       TEXT NOT NULL,
+        channel     TEXT NOT NULL DEFAULT 'webchat',
+        created_at  INTEGER NOT NULL,
+        updated_at  INTEGER NOT NULL,
+        archived    INTEGER NOT NULL DEFAULT 0,
+        metadata    TEXT,
+        sender_id   TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id          TEXT PRIMARY KEY,
+        chat_id     TEXT NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
+        role        TEXT NOT NULL,
+        content     TEXT NOT NULL,
+        timestamp   INTEGER NOT NULL,
+        tokens_in   INTEGER,
+        tokens_out  INTEGER
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_messages_chat_ts ON messages(chat_id, timestamp);
+      CREATE INDEX IF NOT EXISTS idx_chats_updated ON chats(updated_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_chats_sender ON chats(sender_id, channel);
+    `);
+  }
+
+  // ── Chat operations ──
+
+  createChat(title: string, channel: string, senderId?: string): Chat {
+    const id = generateId();
+    const now = Date.now();
+    this.db.prepare(
+      'INSERT INTO chats (id, title, channel, created_at, updated_at, sender_id) VALUES (?, ?, ?, ?, ?, ?)',
+    ).run(id, title, channel, now, now, senderId ?? null);
+    return { id, title, channel, createdAt: now, updatedAt: now, archived: false };
+  }
+
+  getChat(id: string): Chat | undefined {
+    const row = this.db.prepare('SELECT * FROM chats WHERE id = ?').get(id) as Record<string, unknown> | undefined;
+    return row ? this.rowToChat(row) : undefined;
+  }
+
+  listChats(options?: ListChatsOptions): Chat[] {
+    const limit = options?.limit ?? 50;
+    const offset = options?.offset ?? 0;
+    if (options?.archived) {
+      return (this.db.prepare('SELECT * FROM chats ORDER BY updated_at DESC LIMIT ? OFFSET ?').all(limit, offset) as Record<string, unknown>[]).map(r => this.rowToChat(r));
+    }
+    return (this.db.prepare('SELECT * FROM chats WHERE archived = 0 ORDER BY updated_at DESC LIMIT ? OFFSET ?').all(limit, offset) as Record<string, unknown>[]).map(r => this.rowToChat(r));
+  }
+
+  renameChat(id: string, title: string): void {
+    this.db.prepare('UPDATE chats SET title = ?, updated_at = ? WHERE id = ?').run(title, Date.now(), id);
+  }
+
+  archiveChat(id: string): void {
+    this.db.prepare('UPDATE chats SET archived = 1, updated_at = ? WHERE id = ?').run(Date.now(), id);
+  }
+
+  deleteChat(id: string): void {
+    this.db.prepare('DELETE FROM chats WHERE id = ?').run(id);
+  }
+
+  // ── Message operations ──
+
+  addMessage(
+    chatId: string,
+    msgId: string,
+    role: string,
+    content: string,
+    timestamp: number,
+    tokensIn?: number,
+    tokensOut?: number,
+  ): void {
+    this.db.prepare(
+      'INSERT INTO messages (id, chat_id, role, content, timestamp, tokens_in, tokens_out) VALUES (?, ?, ?, ?, ?, ?, ?)',
+    ).run(msgId, chatId, role, content, timestamp, tokensIn ?? null, tokensOut ?? null);
+    this.db.prepare('UPDATE chats SET updated_at = ? WHERE id = ?').run(timestamp, chatId);
+  }
+
+  getMessages(chatId: string): Message[] {
+    return (this.db.prepare('SELECT * FROM messages WHERE chat_id = ? ORDER BY timestamp ASC').all(chatId) as Record<string, unknown>[]).map(r => this.rowToMessage(r));
+  }
+
+  getContextMessages(chatId: string, maxTokens: number): Message[] {
+    const rows = this.db.prepare('SELECT * FROM messages WHERE chat_id = ? ORDER BY timestamp DESC').all(chatId) as Record<string, unknown>[];
+    const messages: Message[] = [];
+    let tokenCount = 0;
+    for (const row of rows) {
+      const msg = this.rowToMessage(row);
+      const msgTokens = Math.ceil(msg.content.length / 4);
+      if (tokenCount + msgTokens > maxTokens) break;
+      messages.unshift(msg);
+      tokenCount += msgTokens;
+    }
+    return messages;
+  }
+
+  clearMessages(chatId: string): void {
+    this.db.prepare('DELETE FROM messages WHERE chat_id = ?').run(chatId);
+    this.db.prepare('UPDATE chats SET updated_at = ? WHERE id = ?').run(Date.now(), chatId);
+  }
+
+  // ── Session compatibility ──
+
+  getOrCreateSessionChat(senderId: string, channel: string): Chat {
+    const row = this.db.prepare(
+      'SELECT * FROM chats WHERE sender_id = ? AND channel = ? ORDER BY updated_at DESC LIMIT 1',
+    ).get(senderId, channel) as Record<string, unknown> | undefined;
+    if (row) {
+      this.db.prepare('UPDATE chats SET updated_at = ? WHERE id = ?').run(Date.now(), row.id as string);
+      return this.rowToChat(row);
+    }
+    return this.createChat(`${channel} session`, channel, senderId);
+  }
+
+  insertChatWithId(
+    id: string,
+    title: string,
+    channel: string,
+    createdAt: number,
+    updatedAt: number,
+    senderId?: string,
+  ): void {
+    this.db.prepare(
+      'INSERT INTO chats (id, title, channel, created_at, updated_at, sender_id) VALUES (?, ?, ?, ?, ?, ?)',
+    ).run(id, title, channel, createdAt, updatedAt, senderId ?? null);
+  }
+
+  // ── Helpers ──
+
+  private rowToChat(row: Record<string, unknown>): Chat {
+    return {
+      id: row.id as string,
+      title: row.title as string,
+      channel: row.channel as string,
+      createdAt: row.created_at as number,
+      updatedAt: row.updated_at as number,
+      archived: row.archived === 1,
+      metadata: row.metadata ? JSON.parse(row.metadata as string) : undefined,
+    };
+  }
+
+  private rowToMessage(row: Record<string, unknown>): Message {
+    return {
+      id: row.id as string,
+      role: row.role as 'user' | 'assistant' | 'system',
+      content: row.content as string,
+      timestamp: row.timestamp as number,
+      tokens: (row.tokens_in != null || row.tokens_out != null)
+        ? { input: (row.tokens_in as number) ?? undefined, output: (row.tokens_out as number) ?? undefined }
+        : undefined,
+    };
+  }
+
+  close(): void {
+    this.db.close();
+  }
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+export { SessionManager } from './manager.js';
+export { SessionDatabase } from './db.js';
+export type {
+  Session,
+  SessionConfig,
+  SessionMetadata,
+  Message,
+  MessageRole,
+  Chat,
+  ListChatsOptions,
+} from './types.js';