tracelattice 1.2.5

package/dist/persistence/SqlitePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqlitePersistence.js","sources":["../../src/persistence/SqlitePersistence.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport type { ThoughtData } from '../core/thought.js';\nimport type { PersistenceBackend, PersistenceConfig } from './PersistenceBackend.js';\n\n/**\n * Type definition for the better-sqlite3 Database interface.\n * This allows us to use the library without importing it directly.\n */\ninterface Database {\n\texec(sql: string): void;\n\tprepare(sql: string): Statement;\n\tclose(): void;\n\tpragma(pragma: string): unknown;\n}\n\ninterface Statement {\n\trun(...params: unknown[]): RunResult;\n\tget(...params: unknown[]): unknown;\n\tall(...params: unknown[]): unknown[];\n}\n\ninterface RunResult {\n\tchanges: number;\n\tlastInsertRowid: number;\n}\n\n/**\n * SQLite-based persistence backend.\n *\n * Provides efficient, transactional persistence using SQLite.\n * Requires the 'better-sqlite3' package to be installed.\n *\n * @example\n * ```typescript\n * const backend = await SqlitePersistence.create({\n *   dbPath: './data/history.db',\n *   enableWAL: true\n * });\n * ```\n */\nexport class SqlitePersistence implements PersistenceBackend {\n\tprivate _db: Database;\n\tprivate _maxHistorySize: number;\n\tprivate _persistBranches: boolean;\n\n\tprivate constructor(db: Database, options: PersistenceConfig['options']) {\n\t\tthis._db = db;\n\t\tthis._maxHistorySize = options?.maxHistorySize ?? 10000;\n\t\tthis._persistBranches = options?.persistBranches ?? true;\n\t\tthis._initializeSchema();\n\t}\n\n\t/**\n\t * Creates a new SqlitePersistence instance with dynamic import of better-sqlite3.\n\t *\n\t * @param options - Configuration options\n\t * @returns A Promise that resolves to a SqlitePersistence instance\n\t * @throws Error if better-sqlite3 is not installed\n\t *\n\t * @example\n\t * ```typescript\n\t * const backend = await SqlitePersistence.create({\n\t *   dbPath: './data/history.db',\n\t *   enableWAL: true\n\t * });\n\t * ```\n\t */\n\tstatic async create(options?: PersistenceConfig['options']): Promise<SqlitePersistence> {\n\t\t// Default to .claude/data in current directory or home directory\n\t\tconst defaultDataDir = existsSync('.claude/data')\n\t\t\t? '.claude/data'\n\t\t\t: join(homedir(), '.claude/data');\n\t\tconst dbPath = options?.dbPath ?? join(defaultDataDir, 'history.db');\n\n\t\t// Load better-sqlite3 dynamically (optional dependency)\n\t\tlet Database: new (path: string) => Database;\n\t\ttry {\n\t\t\tconst module = await import('better-sqlite3');\n\t\t\tDatabase = module.default;\n\t\t} catch {\n\t\t\tthrow new Error(\n\t\t\t\t`SQLite persistence requires 'better-sqlite3' package. Install it with: npm install better-sqlite3`\n\t\t\t);\n\t\t}\n\n\t\tconst db = new Database(dbPath);\n\n\t\t// Enable WAL mode for better concurrency if specified\n\t\tif (options?.enableWAL !== false) {\n\t\t\tdb.pragma('journal_mode = WAL');\n\t\t}\n\n\t\t// Performance and safety PRAGMAs\n\t\tdb.pragma('synchronous = NORMAL');\n\t\tdb.pragma('foreign_keys = ON');\n\t\tdb.pragma('busy_timeout = 5000');\n\t\tdb.pragma('cache_size = -64000'); // 64MB\n\t\tdb.pragma('temp_store = MEMORY');\n\n\t\treturn new SqlitePersistence(db, options);\n\t}\n\n\tprivate _initializeSchema(): void {\n\t\t// Create thoughts table\n\t\tthis._db.exec(`\n      CREATE TABLE IF NOT EXISTS thoughts (\n        id INTEGER PRIMARY KEY AUTOINCREMENT,\n        data TEXT NOT NULL,\n        created_at INTEGER DEFAULT (strftime('%s', 'now'))\n      )\n    `);\n\n\t\t// Create branches table\n\t\tif (this._persistBranches) {\n\t\t\tthis._db.exec(`\n        CREATE TABLE IF NOT EXISTS branches (\n          branch_id TEXT PRIMARY KEY,\n          data TEXT NOT NULL,\n          updated_at INTEGER DEFAULT (strftime('%s', 'now'))\n        )\n      `);\n\t\t}\n\n\t\t// Create indexes for better performance\n\t\tthis._db.exec(`\n      CREATE INDEX IF NOT EXISTS idx_thoughts_created_at ON thoughts(created_at)\n    `);\n\t}\n\n\tpublic async saveThought(thought: ThoughtData): Promise<void> {\n\t\tconst stmt = this._db.prepare('INSERT INTO thoughts (data) VALUES (?)');\n\t\tstmt.run(JSON.stringify(thought));\n\n\t\t// Trim old thoughts if over limit\n\t\tconst countStmt = this._db.prepare('SELECT COUNT(*) as count FROM thoughts');\n\t\tconst { count } = countStmt.get() as { count: number };\n\n\t\tif (count > this._maxHistorySize) {\n\t\t\tconst deleteStmt = this._db.prepare(\n\t\t\t\t`DELETE FROM thoughts WHERE id IN (\n          SELECT id FROM thoughts ORDER BY id ASC LIMIT ?\n        )`\n\t\t\t);\n\t\t\tdeleteStmt.run(count - this._maxHistorySize);\n\t\t}\n\t}\n\n\tpublic async loadHistory(): Promise<ThoughtData[]> {\n\t\tconst stmt = this._db.prepare('SELECT data FROM thoughts ORDER BY id ASC');\n\t\tconst rows = stmt.all() as { data: string }[];\n\n\t\treturn rows\n\t\t\t.map((row) => {\n\t\t\t\ttry {\n\t\t\t\t\treturn JSON.parse(row.data) as ThoughtData;\n\t\t\t\t} catch {\n\t\t\t\t\treturn null;\n\t\t\t\t}\n\t\t\t})\n\t\t\t.filter((t): t is ThoughtData => t !== null);\n\t}\n\n\tpublic async saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void> {\n\t\tif (!this._persistBranches) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst stmt = this._db.prepare(\n\t\t\t'INSERT OR REPLACE INTO branches (branch_id, data, updated_at) VALUES (?, ?, strftime(\"%s\", \"now\"))'\n\t\t);\n\t\tstmt.run(branchId, JSON.stringify(thoughts));\n\t}\n\n\tpublic async loadBranch(branchId: string): Promise<ThoughtData[] | undefined> {\n\t\tif (!this._persistBranches) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst stmt = this._db.prepare('SELECT data FROM branches WHERE branch_id = ?');\n\t\tconst row = stmt.get(branchId) as { data: string } | undefined;\n\n\t\tif (!row) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\ttry {\n\t\t\tconst data = JSON.parse(row.data) as ThoughtData[];\n\t\t\treturn Array.isArray(data) ? data : undefined;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tpublic async listBranches(): Promise<string[]> {\n\t\tif (!this._persistBranches) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst stmt = this._db.prepare('SELECT branch_id FROM branches ORDER BY branch_id ASC');\n\t\tconst rows = stmt.all() as { branch_id: string }[];\n\t\treturn rows.map((row) => row.branch_id);\n\t}\n\n\tpublic async clear(): Promise<void> {\n\t\tthis._db.exec('DELETE FROM thoughts');\n\t\tif (this._persistBranches) {\n\t\t\tthis._db.exec('DELETE FROM branches');\n\t\t}\n\t}\n\n\tpublic async healthy(): Promise<boolean> {\n\t\ttry {\n\t\t\t// Simple health check - try to execute a query\n\t\t\tthis._db.prepare('SELECT 1').get();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Close the database connection with proper cleanup.\n\t * Runs WAL checkpoint before closing to ensure all data is persisted.\n\t */\n\tpublic async close(): Promise<void> {\n\t\tif (this._db) {\n\t\t\ttry {\n\t\t\t\t// Run WAL checkpoint to ensure all data is persisted\n\t\t\t\tthis._db.pragma('wal_checkpoint(TRUNCATE)');\n\t\t\t} catch {\n\t\t\t\t// Ignore checkpoint errors - still try to close\n\t\t\t}\n\t\t\tthis._db.close();\n\t\t}\n\t}\n\n\t/**\n\t * Get statistics about the persisted data.\n\t */\n\tpublic getStats(): {\n\t\tthoughtCount: number;\n\t\tbranchCount: number;\n\t\tdbSize: number;\n\t} {\n\t\tconst thoughtStmt = this._db.prepare('SELECT COUNT(*) as count FROM thoughts');\n\t\tconst { count: thoughtCount } = thoughtStmt.get() as { count: number };\n\n\t\tlet branchCount = 0;\n\t\tif (this._persistBranches) {\n\t\t\tconst branchStmt = this._db.prepare('SELECT COUNT(*) as count FROM branches');\n\t\t\tconst result = branchStmt.get() as { count: number } | undefined;\n\t\t\tbranchCount = result?.count ?? 0;\n\t\t}\n\n\t\treturn {\n\t\t\tthoughtCount,\n\t\t\tbranchCount,\n\t\t\tdbSize: 0, // Would need to check file size\n\t\t};\n\t}\n}\n"],"names":["SqlitePersistence","db","options","defaultDataDir","existsSync","join","homedir","dbPath","Database","module","Error","thought","stmt","JSON","countStmt","count","deleteStmt","rows","row","t","branchId","thoughts","data","Array","undefined","thoughtStmt","thoughtCount","branchCount","branchStmt","result"],"mappings":"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"}

package/dist/pool/ConnectionPool.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Connection Pool for managing concurrent user sessions.
+ *
+ * This module provides session management for multi-user scenarios,
+ * allowing multiple concurrent clients to each have isolated state.
+ *
+ * @example
+ * ```typescript
+ * const pool = new ConnectionPool({
+ *   maxSessions: 100,
+ *   sessionTimeout: 300000 // 5 minutes
+ * });
+ *
+ * const sessionId = await pool.createSession();
+ * await pool.process(sessionId, thought);
+ * await pool.closeSession(sessionId);
+ * ```
+ */
+import type { ThoughtData } from '../core/thought.js';
+import type { Logger } from '../logger/StructuredLogger.js';
+import type { IDisposable } from '../types/disposable.js';
+export interface SessionOptions {
+    /**
+     * Maximum number of concurrent sessions
+     * @default 100
+     */
+    maxSessions?: number;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    serverFactory?: () => Promise<SessionServer>;
+    /**
+     * Session timeout in milliseconds
+     * @default 300000 (5 minutes)
+     */
+    sessionTimeout?: number;
+    /**
+     * Whether to enable automatic session cleanup
+     * @default true
+     */
+    autoCleanup?: boolean;
+    /**
+     * Cleanup interval in milliseconds
+     * @default 60000 (1 minute)
+     */
+    cleanupInterval?: number;
+}
+export interface SessionInfo {
+    id: string;
+    server: SessionServer;
+    createdAt: number;
+    lastActivityAt: number;
+    isActive: boolean;
+}
+export interface SessionServer {
+    processThought(input: ThoughtData): Promise<ProcessResult>;
+    stop(): void | Promise<void>;
+}
+export interface ProcessResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Represents a user session with its own server instance.
+ */
+export declare class Session {
+    private _server;
+    private _id;
+    private _createdAt;
+    private _lastActivityAt;
+    private _isActiveValue;
+    private _timeout;
+    private _cleanupTimer;
+    private _logger;
+    constructor(id: string, server: SessionServer, timeout: number, logger: Logger);
+    /**
+     * Check if the session is active.
+     */
+    get isActive(): boolean;
+    /**
+     * Process a thought through this session's server instance.
+     */
+    process(input: ThoughtData): Promise<ProcessResult>;
+    /**
+     * Get session information.
+     */
+    getInfo(): SessionInfo;
+    /**
+     * Check if the session has timed out.
+     */
+    isTimedOut(): boolean;
+    /**
+     * Close the session and stop the server.
+     */
+    close(): Promise<void>;
+    /**
+     * Start the session timeout timer.
+     */
+    private _startTimeout;
+    /**
+     * Reset the timeout timer after activity.
+     */
+    private _resetTimeout;
+}
+/**
+ * ConnectionPool manages multiple concurrent user sessions.
+ *
+ * Each session has its own server instance with isolated state,
+ * allowing multiple users to interact with the system simultaneously.
+ */
+export declare class ConnectionPool implements IDisposable {
+    private _sessions;
+    private _createSessionLock;
+    private _maxSessions;
+    private _sessionTimeout;
+    private _autoCleanup;
+    private _cleanupInterval;
+    private _cleanupTimerId;
+    private _terminated;
+    private _logger;
+    private _serverFactory;
+    constructor(options?: SessionOptions);
+    /**
+     * Create a no-op logger when none is provided.
+     */
+    private _createNoopLogger;
+    /**
+     * Create a new session.
+     *
+     * @returns The session ID
+     * @throws Error if max sessions reached
+     */
+    createSession(): Promise<string>;
+    /**
+     * Process a thought in the specified session.
+     *
+     * @param sessionId - The session ID
+     * @param input - The thought data to process
+     * @returns Promise with the processing result
+     * @throws Error if session not found
+     */
+    process(sessionId: string, input: ThoughtData): Promise<ProcessResult>;
+    /**
+     * Close a session and release resources.
+     *
+     * @param sessionId - The session ID to close
+     * @throws Error if session not found
+     */
+    closeSession(sessionId: string): Promise<void>;
+    /**
+     * Get information about a session.
+     *
+     * @param sessionId - The session ID
+     * @returns Session info or undefined if not found
+     */
+    getSessionInfo(sessionId: string): SessionInfo | undefined;
+    /**
+     * Get all active sessions.
+     *
+     * @returns Array of session information
+     */
+    getActiveSessions(): SessionInfo[];
+    /**
+     * Get connection pool statistics.
+     */
+    getStats(): {
+        totalSessions: number;
+        activeSessions: number;
+        maxSessions: number;
+        cleanupEnabled: boolean;
+        sessionTimeout: number;
+    };
+    /**
+     * Start the automatic cleanup timer.
+     */
+    private _startCleanup;
+    /**
+     * Remove timed-out sessions.
+     */
+    private _cleanupTimedOutSessions;
+    /**
+     * Close all sessions and stop the cleanup timer.
+     */
+    terminate(): Promise<void>;
+    /**
+     * Dispose of the connection pool, releasing all resources.
+     * Implements the IDisposable interface.
+     * Delegates to terminate() for backward compatibility.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Check if the connection pool is active.
+     */
+    isRunning(): boolean;
+}
+/**
+ * Create a connection pool with the given options.
+ *
+ * @param options - Connection pool configuration
+ * @returns A configured connection pool
+ *
+ * @example
+ * ```typescript
+ * const pool = createConnectionPool({
+ *   maxSessions: 50,
+ *   sessionTimeout: 300000
+ * });
+ * ```
+ */
+export declare function createConnectionPool(options?: SessionOptions): ConnectionPool;
+//# sourceMappingURL=ConnectionPool.d.ts.map

package/dist/pool/ConnectionPool.d.ts.map

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

package/dist/pool/ConnectionPool.js

@@ -0,0 +1,187 @@
+import { MaxSessionsReachedError, PoolTerminatedError, SessionNotActiveError, SessionNotFoundError } from "../errors.js";
+class Session {
+    _server;
+    _id;
+    _createdAt;
+    _lastActivityAt;
+    _isActiveValue;
+    _timeout;
+    _cleanupTimer = null;
+    _logger;
+    constructor(id, server, timeout, logger){
+        this._server = server;
+        this._id = id;
+        this._createdAt = Date.now();
+        this._lastActivityAt = this._createdAt;
+        this._isActiveValue = true;
+        this._timeout = timeout;
+        this._logger = logger;
+        this._startTimeout();
+    }
+    get isActive() {
+        return this._isActiveValue;
+    }
+    async process(input) {
+        if (!this.isActive) throw new SessionNotActiveError(this._id);
+        this._lastActivityAt = Date.now();
+        this._resetTimeout();
+        return this._server.processThought(input);
+    }
+    getInfo() {
+        return {
+            id: this._id,
+            server: this._server,
+            createdAt: this._createdAt,
+            lastActivityAt: this._lastActivityAt,
+            isActive: this.isActive
+        };
+    }
+    isTimedOut() {
+        return Date.now() - this._lastActivityAt > this._timeout;
+    }
+    async close() {
+        this._isActiveValue = false;
+        if (this._cleanupTimer) {
+            clearTimeout(this._cleanupTimer);
+            this._cleanupTimer = null;
+        }
+        this._server.stop();
+    }
+    _startTimeout() {
+        if (this._cleanupTimer) clearTimeout(this._cleanupTimer);
+        this._cleanupTimer = setTimeout(()=>{
+            if (this.isTimedOut()) {
+                this._logger.warn(`Session ${this._id} timed out, closing`);
+                this.close().catch((err)=>{
+                    this._logger.error(`Error closing timed out session ${this._id}:`, err);
+                });
+            }
+        }, this._timeout);
+    }
+    _resetTimeout() {
+        this._startTimeout();
+    }
+}
+class ConnectionPool {
+    _sessions = new Map();
+    _createSessionLock = null;
+    _maxSessions;
+    _sessionTimeout;
+    _autoCleanup;
+    _cleanupInterval;
+    _cleanupTimerId = null;
+    _terminated = false;
+    _logger;
+    _serverFactory;
+    constructor(options = {}){
+        this._maxSessions = options.maxSessions ?? 100;
+        this._sessionTimeout = options.sessionTimeout ?? 300000;
+        this._autoCleanup = options.autoCleanup ?? true;
+        this._cleanupInterval = options.cleanupInterval ?? 60000;
+        this._serverFactory = options.serverFactory ?? null;
+        this._logger = options.logger ?? this._createNoopLogger();
+        if (this._autoCleanup) this._startCleanup();
+    }
+    _createNoopLogger() {
+        return {
+            info: ()=>{},
+            warn: ()=>{},
+            error: ()=>{},
+            debug: ()=>{},
+            setLevel: ()=>{},
+            getLevel: ()=>'info'
+        };
+    }
+    async createSession() {
+        while(this._createSessionLock)await this._createSessionLock;
+        if (this._terminated) throw new PoolTerminatedError();
+        if (this._sessions.size >= this._maxSessions) throw new MaxSessionsReachedError(this._maxSessions);
+        if (!this._serverFactory) throw new Error('ConnectionPool requires a serverFactory option to create sessions');
+        let resolveLock;
+        this._createSessionLock = new Promise((resolve)=>{
+            resolveLock = resolve;
+        });
+        try {
+            const sessionId = `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+            const server = await this._serverFactory();
+            const session = new Session(sessionId, server, this._sessionTimeout, this._logger);
+            this._sessions.set(sessionId, session);
+            this._logger.info(`Created session ${sessionId} (${this._sessions.size}/${this._maxSessions} active sessions)`);
+            return sessionId;
+        } finally{
+            resolveLock();
+            this._createSessionLock = null;
+        }
+    }
+    async process(sessionId, input) {
+        const session = this._sessions.get(sessionId);
+        if (!session) throw new SessionNotFoundError(sessionId);
+        return session.process(input);
+    }
+    async closeSession(sessionId) {
+        const session = this._sessions.get(sessionId);
+        if (!session) throw new SessionNotFoundError(sessionId);
+        await session.close();
+        this._sessions.delete(sessionId);
+        this._logger.info(`Closed session ${sessionId} (${this._sessions.size}/${this._maxSessions} active sessions)`);
+    }
+    getSessionInfo(sessionId) {
+        return this._sessions.get(sessionId)?.getInfo();
+    }
+    getActiveSessions() {
+        return Array.from(this._sessions.values()).filter((s)=>s.isActive).map((s)=>s.getInfo());
+    }
+    getStats() {
+        const activeSessions = this.getActiveSessions();
+        return {
+            totalSessions: this._sessions.size,
+            activeSessions: activeSessions.length,
+            maxSessions: this._maxSessions,
+            cleanupEnabled: this._autoCleanup,
+            sessionTimeout: this._sessionTimeout
+        };
+    }
+    _startCleanup() {
+        if (null !== this._cleanupTimerId) clearInterval(this._cleanupTimerId);
+        this._cleanupTimerId = setInterval(()=>{
+            this._cleanupTimedOutSessions();
+        }, this._cleanupInterval);
+    }
+    _cleanupTimedOutSessions() {
+        let cleaned = 0;
+        for (const [sessionId, session] of this._sessions.entries())if (session.isTimedOut()) {
+            session.close().catch((err)=>{
+                this._logger.error(`Error closing timed out session ${sessionId}:`, err);
+            });
+            this._sessions.delete(sessionId);
+            cleaned++;
+        }
+        if (cleaned > 0) this._logger.info(`Cleaned ${cleaned} timed-out sessions (${this._sessions.size}/${this._maxSessions} active sessions)`);
+    }
+    async terminate() {
+        if (this._terminated) return;
+        this._terminated = true;
+        if (null !== this._cleanupTimerId) {
+            clearInterval(this._cleanupTimerId);
+            this._cleanupTimerId = null;
+        }
+        const closePromises = Array.from(this._sessions.values()).map((session)=>session.close().catch((err)=>{
+                this._logger.error(`Error closing session ${session.getInfo().id}:`, err);
+            }));
+        await Promise.all(closePromises);
+        this._sessions.clear();
+        this._logger.info('ConnectionPool terminated');
+    }
+    async dispose() {
+        await this.terminate();
+    }
+    isRunning() {
+        return !this._terminated;
+    }
+}
+function createConnectionPool(options) {
+    return new ConnectionPool(options);
+}
+export { ConnectionPool, Session, createConnectionPool };
+
+//# sourceMappingURL=ConnectionPool.js.map

package/dist/pool/ConnectionPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool/ConnectionPool.js","sources":["../../src/pool/ConnectionPool.ts"],"sourcesContent":["/**\n * Connection Pool for managing concurrent user sessions.\n *\n * This module provides session management for multi-user scenarios,\n * allowing multiple concurrent clients to each have isolated state.\n *\n * @example\n * ```typescript\n * const pool = new ConnectionPool({\n *   maxSessions: 100,\n *   sessionTimeout: 300000 // 5 minutes\n * });\n *\n * const sessionId = await pool.createSession();\n * await pool.process(sessionId, thought);\n * await pool.closeSession(sessionId);\n * ```\n */\n\nimport type { ThoughtData } from '../core/thought.js';\nimport {\n\tMaxSessionsReachedError,\n\tPoolTerminatedError,\n\tSessionNotActiveError,\n\tSessionNotFoundError,\n} from '../errors.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\nimport type { IDisposable } from '../types/disposable.js';\n\nexport interface SessionOptions {\n\t/**\n\t * Maximum number of concurrent sessions\n\t * @default 100\n\t */\n\tmaxSessions?: number;\n\n\t/**\n\t * Logger instance\n\t */\n\tlogger?: Logger;\n\n\tserverFactory?: () => Promise<SessionServer>;\n\n\t/**\n\t * Session timeout in milliseconds\n\t * @default 300000 (5 minutes)\n\t */\n\tsessionTimeout?: number;\n\n\t/**\n\t * Whether to enable automatic session cleanup\n\t * @default true\n\t */\n\tautoCleanup?: boolean;\n\n\t/**\n\t * Cleanup interval in milliseconds\n\t * @default 60000 (1 minute)\n\t */\n\tcleanupInterval?: number;\n}\n\nexport interface SessionInfo {\n\tid: string;\n\tserver: SessionServer;\n\tcreatedAt: number;\n\tlastActivityAt: number;\n\tisActive: boolean;\n}\n\nexport interface SessionServer {\n\tprocessThought(input: ThoughtData): Promise<ProcessResult>;\n\tstop(): void | Promise<void>;\n}\n\nexport interface ProcessResult {\n\tcontent: Array<{\n\t\ttype: string;\n\t\ttext: string;\n\t}>;\n\tisError?: boolean;\n}\n\n/**\n * Represents a user session with its own server instance.\n */\nexport class Session {\n\tprivate _server: SessionServer;\n\tprivate _id: string;\n\tprivate _createdAt: number;\n\tprivate _lastActivityAt: number;\n\tprivate _isActiveValue: boolean;\n\tprivate _timeout: number;\n\tprivate _cleanupTimer: NodeJS.Timeout | null = null;\n\tprivate _logger: Logger;\n\n\tconstructor(id: string, server: SessionServer, timeout: number, logger: Logger) {\n\t\tthis._server = server;\n\t\tthis._id = id;\n\t\tthis._createdAt = Date.now();\n\t\tthis._lastActivityAt = this._createdAt;\n\t\tthis._isActiveValue = true;\n\t\tthis._timeout = timeout;\n\t\tthis._logger = logger;\n\n\t\t// Start session timeout timer\n\t\tthis._startTimeout();\n\t}\n\n\t/**\n\t * Check if the session is active.\n\t */\n\tget isActive(): boolean {\n\t\treturn this._isActiveValue;\n\t}\n\n\t/**\n\t * Process a thought through this session's server instance.\n\t */\n\tasync process(input: ThoughtData): Promise<ProcessResult> {\n\t\tif (!this.isActive) {\n\t\t\tthrow new SessionNotActiveError(this._id);\n\t\t}\n\n\t\t// Update last activity\n\t\tthis._lastActivityAt = Date.now();\n\n\t\t// Reset timeout timer\n\t\tthis._resetTimeout();\n\n\t\t// Process the thought\n\t\treturn this._server.processThought(input);\n\t}\n\n\t/**\n\t * Get session information.\n\t */\n\tgetInfo(): SessionInfo {\n\t\treturn {\n\t\t\tid: this._id,\n\t\t\tserver: this._server,\n\t\t\tcreatedAt: this._createdAt,\n\t\t\tlastActivityAt: this._lastActivityAt,\n\t\t\tisActive: this.isActive,\n\t\t};\n\t}\n\n\t/**\n\t * Check if the session has timed out.\n\t */\n\tisTimedOut(): boolean {\n\t\treturn Date.now() - this._lastActivityAt > this._timeout;\n\t}\n\n\t/**\n\t * Close the session and stop the server.\n\t */\n\tasync close(): Promise<void> {\n\t\tthis._isActiveValue = false;\n\n\t\t// Stop timeout timer\n\t\tif (this._cleanupTimer) {\n\t\t\tclearTimeout(this._cleanupTimer);\n\t\t\tthis._cleanupTimer = null;\n\t\t}\n\n\t\t// Stop the server\n\t\tthis._server.stop();\n\t}\n\n\t/**\n\t * Start the session timeout timer.\n\t */\n\tprivate _startTimeout(): void {\n\t\tif (this._cleanupTimer) {\n\t\t\tclearTimeout(this._cleanupTimer);\n\t\t}\n\n\t\tthis._cleanupTimer = setTimeout(() => {\n\t\t\tif (this.isTimedOut()) {\n\t\t\t\tthis._logger.warn(`Session ${this._id} timed out, closing`);\n\t\t\t\tthis.close().catch((err) => {\n\t\t\t\t\tthis._logger.error(`Error closing timed out session ${this._id}:`, err);\n\t\t\t\t});\n\t\t\t}\n\t\t}, this._timeout);\n\t}\n\n\t/**\n\t * Reset the timeout timer after activity.\n\t */\n\tprivate _resetTimeout(): void {\n\t\tthis._startTimeout();\n\t}\n}\n\n/**\n * ConnectionPool manages multiple concurrent user sessions.\n *\n * Each session has its own server instance with isolated state,\n * allowing multiple users to interact with the system simultaneously.\n */\nexport class ConnectionPool implements IDisposable {\n\tprivate _sessions: Map<string, Session> = new Map();\n\tprivate _createSessionLock: Promise<void> | null = null;\n\tprivate _maxSessions: number;\n\tprivate _sessionTimeout: number;\n\tprivate _autoCleanup: boolean;\n\tprivate _cleanupInterval: number;\n\tprivate _cleanupTimerId: number | null = null;\n\tprivate _terminated: boolean = false;\n\tprivate _logger: Logger;\n\tprivate _serverFactory: (() => Promise<SessionServer>) | null;\n\n\tconstructor(options: SessionOptions = {}) {\n\t\tthis._maxSessions = options.maxSessions ?? 100;\n\t\tthis._sessionTimeout = options.sessionTimeout ?? 300000; // 5 minutes\n\t\tthis._autoCleanup = options.autoCleanup ?? true;\n\t\tthis._cleanupInterval = options.cleanupInterval ?? 60000; // 1 minute\n\t\tthis._serverFactory = options.serverFactory ?? null;\n\t\tthis._logger = options.logger ?? this._createNoopLogger();\n\n\t\tif (this._autoCleanup) {\n\t\t\tthis._startCleanup();\n\t\t}\n\t}\n\n\t/**\n\t * Create a no-op logger when none is provided.\n\t */\n\tprivate _createNoopLogger(): Logger {\n\t\treturn {\n\t\t\tinfo: (): void => {},\n\t\t\twarn: (): void => {},\n\t\t\terror: (): void => {},\n\t\t\tdebug: (): void => {},\n\t\t\tsetLevel: (): void => {},\n\t\t\tgetLevel: (): 'info' => 'info',\n\t\t};\n\t}\n\n\t/**\n\t * Create a new session.\n\t *\n\t * @returns The session ID\n\t * @throws Error if max sessions reached\n\t */\n\tasync createSession(): Promise<string> {\n\t\twhile (this._createSessionLock) {\n\t\t\tawait this._createSessionLock;\n\t\t}\n\n\t\tif (this._terminated) {\n\t\t\tthrow new PoolTerminatedError();\n\t\t}\n\n\t\tif (this._sessions.size >= this._maxSessions) {\n\t\t\tthrow new MaxSessionsReachedError(this._maxSessions);\n\t\t}\n\n\t\tif (!this._serverFactory) {\n\t\t\tthrow new Error('ConnectionPool requires a serverFactory option to create sessions');\n\t\t}\n\n\t\tlet resolveLock!: () => void;\n\t\tthis._createSessionLock = new Promise<void>((resolve) => {\n\t\t\tresolveLock = resolve;\n\t\t});\n\n\t\ttry {\n\t\t\t// Generate unique session ID\n\t\t\tconst sessionId = `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;\n\n\t\t\t// Create a new server instance for this session\n\t\t\tconst server = await this._serverFactory();\n\n\t\t\t// Create session\n\t\t\tconst session = new Session(sessionId, server, this._sessionTimeout, this._logger);\n\t\t\tthis._sessions.set(sessionId, session);\n\n\t\t\tthis._logger.info(\n\t\t\t\t`Created session ${sessionId} (${this._sessions.size}/${this._maxSessions} active sessions)`\n\t\t\t);\n\t\t\treturn sessionId;\n\t\t} finally {\n\t\t\tresolveLock();\n\t\t\tthis._createSessionLock = null;\n\t\t}\n\t}\n\n\t/**\n\t * Process a thought in the specified session.\n\t *\n\t * @param sessionId - The session ID\n\t * @param input - The thought data to process\n\t * @returns Promise with the processing result\n\t * @throws Error if session not found\n\t */\n\tasync process(sessionId: string, input: ThoughtData): Promise<ProcessResult> {\n\t\tconst session = this._sessions.get(sessionId);\n\n\t\tif (!session) {\n\t\t\tthrow new SessionNotFoundError(sessionId);\n\t\t}\n\n\t\treturn session.process(input);\n\t}\n\n\t/**\n\t * Close a session and release resources.\n\t *\n\t * @param sessionId - The session ID to close\n\t * @throws Error if session not found\n\t */\n\tasync closeSession(sessionId: string): Promise<void> {\n\t\tconst session = this._sessions.get(sessionId);\n\n\t\tif (!session) {\n\t\t\tthrow new SessionNotFoundError(sessionId);\n\t\t}\n\n\t\tawait session.close();\n\t\tthis._sessions.delete(sessionId);\n\n\t\tthis._logger.info(\n\t\t\t`Closed session ${sessionId} (${this._sessions.size}/${this._maxSessions} active sessions)`\n\t\t);\n\t}\n\n\t/**\n\t * Get information about a session.\n\t *\n\t * @param sessionId - The session ID\n\t * @returns Session info or undefined if not found\n\t */\n\tgetSessionInfo(sessionId: string): SessionInfo | undefined {\n\t\treturn this._sessions.get(sessionId)?.getInfo();\n\t}\n\n\t/**\n\t * Get all active sessions.\n\t *\n\t * @returns Array of session information\n\t */\n\tgetActiveSessions(): SessionInfo[] {\n\t\treturn Array.from(this._sessions.values())\n\t\t\t.filter((s) => s.isActive)\n\t\t\t.map((s) => s.getInfo());\n\t}\n\n\t/**\n\t * Get connection pool statistics.\n\t */\n\tgetStats(): {\n\t\ttotalSessions: number;\n\t\tactiveSessions: number;\n\t\tmaxSessions: number;\n\t\tcleanupEnabled: boolean;\n\t\tsessionTimeout: number;\n\t} {\n\t\tconst activeSessions = this.getActiveSessions();\n\n\t\treturn {\n\t\t\ttotalSessions: this._sessions.size,\n\t\t\tactiveSessions: activeSessions.length,\n\t\t\tmaxSessions: this._maxSessions,\n\t\t\tcleanupEnabled: this._autoCleanup,\n\t\t\tsessionTimeout: this._sessionTimeout,\n\t\t};\n\t}\n\n\t/**\n\t * Start the automatic cleanup timer.\n\t */\n\tprivate _startCleanup(): void {\n\t\tif (this._cleanupTimerId !== null) {\n\t\t\tclearInterval(this._cleanupTimerId);\n\t\t}\n\n\t\tthis._cleanupTimerId = setInterval(() => {\n\t\t\tthis._cleanupTimedOutSessions();\n\t\t}, this._cleanupInterval) as unknown as number;\n\t}\n\n\t/**\n\t * Remove timed-out sessions.\n\t */\n\tprivate _cleanupTimedOutSessions(): void {\n\t\tlet cleaned = 0;\n\n\t\tfor (const [sessionId, session] of this._sessions.entries()) {\n\t\t\tif (session.isTimedOut()) {\n\t\t\t\tsession.close().catch((err) => {\n\t\t\t\t\tthis._logger.error(`Error closing timed out session ${sessionId}:`, err);\n\t\t\t\t});\n\t\t\t\tthis._sessions.delete(sessionId);\n\t\t\t\tcleaned++;\n\t\t\t}\n\t\t}\n\n\t\tif (cleaned > 0) {\n\t\t\tthis._logger.info(\n\t\t\t\t`Cleaned ${cleaned} timed-out sessions (${this._sessions.size}/${this._maxSessions} active sessions)`\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Close all sessions and stop the cleanup timer.\n\t */\n\tasync terminate(): Promise<void> {\n\t\tif (this._terminated) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis._terminated = true;\n\n\t\t// Stop cleanup timer\n\t\tif (this._cleanupTimerId !== null) {\n\t\t\tclearInterval(this._cleanupTimerId);\n\t\t\tthis._cleanupTimerId = null;\n\t\t}\n\n\t\t// Close all sessions\n\t\tconst closePromises = Array.from(this._sessions.values()).map((session) =>\n\t\t\tsession.close().catch((err) => {\n\t\t\t\tthis._logger.error(`Error closing session ${session.getInfo().id}:`, err);\n\t\t\t})\n\t\t);\n\n\t\tawait Promise.all(closePromises);\n\t\tthis._sessions.clear();\n\n\t\tthis._logger.info('ConnectionPool terminated');\n\t}\n\n\t/**\n\t * Dispose of the connection pool, releasing all resources.\n\t * Implements the IDisposable interface.\n\t * Delegates to terminate() for backward compatibility.\n\t */\n\tasync dispose(): Promise<void> {\n\t\tawait this.terminate();\n\t}\n\n\t/**\n\t * Check if the connection pool is active.\n\t */\n\tisRunning(): boolean {\n\t\treturn !this._terminated;\n\t}\n}\n\n/**\n * Create a connection pool with the given options.\n *\n * @param options - Connection pool configuration\n * @returns A configured connection pool\n *\n * @example\n * ```typescript\n * const pool = createConnectionPool({\n *   maxSessions: 50,\n *   sessionTimeout: 300000\n * });\n * ```\n */\nexport function createConnectionPool(options?: SessionOptions): ConnectionPool {\n\treturn new ConnectionPool(options);\n}\n"],"names":["Session","id","server","timeout","logger","Date","input","SessionNotActiveError","clearTimeout","setTimeout","err","ConnectionPool","Map","options","PoolTerminatedError","MaxSessionsReachedError","Error","resolveLock","Promise","resolve","sessionId","Math","session","SessionNotFoundError","Array","s","activeSessions","clearInterval","setInterval","cleaned","closePromises","createConnectionPool"],"mappings":"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"}

package/dist/registry/BaseRegistry.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Base registry providing shared CRUD, caching, and discovery logic.
+ *
+ * This abstract generic class extracts the common patterns from `ToolRegistry`
+ * and `SkillRegistry` into a single reusable base. Subclasses only need to
+ * implement item-specific parsing, file filtering, and error construction.
+ *
+ * @template T - The registry item type (must have a `name` property)
+ * @module registry
+ */
+import { DiscoveryCache } from '../cache/DiscoveryCache.js';
+import type { Logger } from '../logger/StructuredLogger.js';
+/**
+ * Configuration options for creating a `BaseRegistry` instance.
+ */
+export interface BaseRegistryOptions {
+    /** Optional logger for diagnostics. */
+    logger?: Logger;
+    /** Optional cache for lookups. */
+    cache?: DiscoveryCache<{
+        name: string;
+    }>;
+    /**
+     * Directory paths to search for items.
+     */
+    searchDirs?: string[];
+    /**
+     * Enable lazy discovery (discover on first access instead of startup).
+     * @default false
+     */
+    lazyDiscovery?: boolean;
+}
+/**
+ * Abstract base registry for managing named items with discovery and caching.
+ *
+ * Provides shared CRUD operations, filesystem discovery with deduplication,
+ * and optional LRU caching. Subclasses implement item-specific parsing logic
+ * and error construction.
+ *
+ * @template T - The registry item type (must have a `name` property)
+ */
+export declare abstract class BaseRegistry<T extends {
+    name: string;
+}> {
+    /** Internal storage for items indexed by name. */
+    protected _items: Map<string, T>;
+    /** Logger for diagnostics. */
+    protected _logger: Logger;
+    /** Optional cache for lookups. */
+    protected _cache: DiscoveryCache<T>;
+    /** Directory paths to search for items. */
+    protected _searchDirs: string[];
+    /** Whether discovery has been performed. */
+    protected _discovered: boolean;
+    /** Promise for in-progress discovery (null if not in progress). */
+    protected _discoveryPromise: Promise<number> | null;
+    /** File extensions to match during discovery. */
+    protected abstract readonly _fileExtensions: string[];
+    /**
+     * Creates an error for invalid item data.
+     * @param reason - The reason for the validation failure
+     */
+    protected abstract _createInvalidError(reason: string): Error;
+    /**
+     * Creates an error for duplicate items.
+     * @param name - The name of the duplicate item
+     */
+    protected abstract _createDuplicateError(name: string): Error;
+    /**
+     * Creates an error for items not found.
+     * @param name - The name of the missing item
+     * @param action - The action that was attempted
+     */
+    protected abstract _createNotFoundError(name: string, action: string): Error;
+    /**
+     * Parses frontmatter content into a partial item.
+     * @param content - The file content to parse
+     * @returns A partial item, with an `_error` property if parsing failed
+     */
+    protected abstract _parseFrontmatter(content: string): Partial<T> & {
+        _error?: string;
+    };
+    /**
+     * Determines whether a file should be skipped during discovery.
+     * @param fileName - The name of the file to check
+     * @returns true if the file should be skipped
+     */
+    protected abstract _shouldSkipFile(fileName: string): boolean;
+    /**
+     * Constructs a complete item from parsed frontmatter data.
+     * Returns null if the parsed data is insufficient.
+     * @param parsed - The parsed frontmatter data
+     * @returns A complete item, or null if data is insufficient
+     */
+    protected abstract _buildItem(parsed: Partial<T>): T | null;
+    /**
+     * The entity name used in log messages (e.g., 'tool', 'skill').
+     */
+    protected abstract readonly _entityName: string;
+    constructor(options: BaseRegistryOptions & Record<string, unknown>);
+    /**
+     * Internal logging method.
+     * @param message - The message to log
+     * @param meta - Optional metadata
+     */
+    protected log(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Adds an item to the registry.
+     *
+     * @param item - The item to add
+     * @throws If item already exists or name is invalid
+     */
+    add(item: T): void;
+    /**
+     * Removes an item from the registry.
+     *
+     * @param name - The name of the item to remove
+     * @throws If item not found
+     */
+    remove(name: string): void;
+    /**
+     * Updates an existing item with partial data.
+     *
+     * @param name - The name of the item to update
+     * @param updates - Partial item data with fields to update
+     * @throws If item not found
+     */
+    update(name: string, updates: Partial<T>): void;
+    /**
+     * Gets an item by name.
+     *
+     * @param name - The name of the item to get
+     * @returns The item if found, undefined otherwise
+     */
+    get(name: string): T | undefined;
+    /**
+     * Gets all items as an array.
+     *
+     * Uses cache if available for performance.
+     *
+     * @returns An array of all registered items
+     */
+    getAll(): T[];
+    /**
+     * Checks if an item exists in the registry.
+     *
+     * @param name - The name of the item to check
+     * @returns true if the item exists, false otherwise
+     */
+    has(name: string): boolean;
+    /**
+     * Gets all item names as an array.
+     *
+     * @returns An array of item names
+     */
+    getNames(): string[];
+    /**
+     * Clears all items from the registry.
+     */
+    clear(): void;
+    /**
+     * Gets the number of items in the registry.
+     *
+     * @returns The count of registered items
+     */
+    size(): number;
+    /**
+     * Asynchronously discovers items from the configured directories.
+     *
+     * Multiple concurrent calls share the same discovery promise.
+     * Subsequent calls return cached results if discovery has already completed.
+     *
+     * @returns A Promise resolving to the number of items discovered
+     */
+    discoverAsync(): Promise<number>;
+    /**
+     * Performs the actual discovery operation.
+     *
+     * Scans configured directories for item files, parses their frontmatter,
+     * and adds valid items to the registry.
+     *
+     * @returns A Promise resolving to the number of items discovered
+     */
+    protected _performDiscovery(): Promise<number>;
+    /**
+     * Parses YAML frontmatter from file content.
+     *
+     * This is a shared utility for subclasses that parse YAML frontmatter.
+     *
+     * @param content - The file content to parse
+     * @returns The parsed YAML object, or null if no frontmatter found
+     */
+    protected _extractFrontmatter(content: string): Record<string, unknown> | null;
+    /**
+     * Sets items from an external source.
+     *
+     * Clears existing items and adds new ones from the provided array.
+     *
+     * @param items - Array of items from an external source
+     */
+    setAll(items: T[]): void;
+}
+//# sourceMappingURL=BaseRegistry.d.ts.map