@seflless/ghosttown 1.7.0 → 2.0.0

package/src/session/output-recorder.js

@@ -0,0 +1,247 @@
+/**
+ * Output Recorder
+ *
+ * Records PTY output to disk for scrollback persistence.
+ * Uses JSONL format for append-only, corruption-isolated storage.
+ *
+ * Each line in the JSONL file is a chunk of PTY output with timestamp:
+ * {"t": 1234567890123, "d": "raw output data"}
+ *
+ * The recorder batches writes to disk for performance (flushes every 100ms
+ * or when buffer exceeds 64KB).
+ */
+import { EventEmitter } from 'events';
+import { existsSync, mkdirSync } from 'fs';
+import path from 'path';
+import fs from 'fs/promises';
+const DEFAULTS = {
+    maxChunks: 50000, // ~50K chunks (each chunk is a PTY output event)
+    flushInterval: 100, // 100ms
+    maxBufferSize: 65536, // 64KB
+};
+/**
+ * Records PTY output to disk with batched writes.
+ *
+ * @example
+ * ```typescript
+ * const recorder = new OutputRecorder({
+ *   filePath: '/path/to/scrollback.jsonl'
+ * });
+ *
+ * await recorder.init();
+ *
+ * // Record output as it comes from PTY
+ * recorder.record('Hello, world!\r\n');
+ * recorder.record('\x1b[32mGreen text\x1b[0m\r\n');
+ *
+ * // Flush pending writes
+ * await recorder.flush();
+ *
+ * // Read all chunks
+ * const chunks = await recorder.readAll();
+ *
+ * // Clean up
+ * await recorder.close();
+ * ```
+ */
+export class OutputRecorder extends EventEmitter {
+    constructor(config) {
+        super();
+        this.buffer = [];
+        this.bufferSize = 0;
+        this.flushTimer = null;
+        this.isWriting = false;
+        this.pendingFlush = null;
+        this.closed = false;
+        this.chunkCount = 0; // Track total chunks on disk
+        this.config = {
+            filePath: config.filePath,
+            maxChunks: config.maxChunks ?? DEFAULTS.maxChunks,
+            flushInterval: config.flushInterval ?? DEFAULTS.flushInterval,
+            maxBufferSize: config.maxBufferSize ?? DEFAULTS.maxBufferSize,
+        };
+    }
+    /**
+     * Initialize the recorder.
+     * Creates the directory and counts existing chunks.
+     */
+    async init() {
+        // Ensure directory exists
+        const dir = path.dirname(this.config.filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Count existing chunks
+        if (existsSync(this.config.filePath)) {
+            this.chunkCount = await this.countChunks();
+        }
+        // Start flush timer
+        this.flushTimer = setInterval(() => {
+            if (this.buffer.length > 0 && !this.isWriting) {
+                this.flush().catch((err) => this.emit('error', err));
+            }
+        }, this.config.flushInterval);
+    }
+    /**
+     * Record a chunk of output.
+     * The data is buffered and flushed to disk periodically.
+     */
+    record(data) {
+        if (this.closed) {
+            throw new Error('OutputRecorder is closed');
+        }
+        const chunk = {
+            t: Date.now(),
+            d: data,
+        };
+        this.buffer.push(chunk);
+        this.bufferSize += data.length;
+        // Flush if buffer exceeds size limit
+        if (this.bufferSize >= this.config.maxBufferSize) {
+            this.flush().catch((err) => this.emit('error', err));
+        }
+    }
+    /**
+     * Flush buffered chunks to disk.
+     * Returns immediately if already flushing (coalesces concurrent calls).
+     */
+    async flush() {
+        if (this.closed || this.buffer.length === 0) {
+            return;
+        }
+        // Coalesce concurrent flush calls
+        if (this.pendingFlush) {
+            return this.pendingFlush;
+        }
+        this.pendingFlush = this.doFlush();
+        try {
+            await this.pendingFlush;
+        }
+        finally {
+            this.pendingFlush = null;
+        }
+    }
+    /**
+     * Internal flush implementation.
+     */
+    async doFlush() {
+        if (this.buffer.length === 0) {
+            return;
+        }
+        this.isWriting = true;
+        try {
+            // Grab current buffer and reset
+            const chunks = this.buffer;
+            this.buffer = [];
+            this.bufferSize = 0;
+            // Convert to JSONL
+            const lines = chunks.map((c) => JSON.stringify(c)).join('\n') + '\n';
+            // Append to file
+            await fs.appendFile(this.config.filePath, lines, 'utf-8');
+            this.chunkCount += chunks.length;
+            this.emit('flush', chunks.length);
+            // Trim if over limit
+            if (this.chunkCount > this.config.maxChunks) {
+                await this.trimOldChunks();
+            }
+        }
+        finally {
+            this.isWriting = false;
+        }
+    }
+    /**
+     * Read all chunks from disk.
+     * Returns chunks in chronological order.
+     */
+    async readAll() {
+        // Flush pending writes first
+        await this.flush();
+        if (!existsSync(this.config.filePath)) {
+            return [];
+        }
+        const content = await fs.readFile(this.config.filePath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        const chunks = [];
+        for (const line of lines) {
+            try {
+                chunks.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return chunks;
+    }
+    /**
+     * Read chunks with pagination.
+     * @param offset Number of chunks to skip from the start
+     * @param limit Maximum number of chunks to return
+     */
+    async read(offset, limit) {
+        const all = await this.readAll();
+        return all.slice(offset, offset + limit);
+    }
+    /**
+     * Get the total number of chunks (on disk + in buffer).
+     */
+    getChunkCount() {
+        return this.chunkCount + this.buffer.length;
+    }
+    /**
+     * Clear all recorded data.
+     */
+    async clear() {
+        this.buffer = [];
+        this.bufferSize = 0;
+        this.chunkCount = 0;
+        if (existsSync(this.config.filePath)) {
+            await fs.unlink(this.config.filePath);
+        }
+    }
+    /**
+     * Close the recorder and flush remaining data.
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        // Stop flush timer
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Final flush
+        await this.flush();
+        this.removeAllListeners();
+    }
+    /**
+     * Count chunks in the file.
+     */
+    async countChunks() {
+        if (!existsSync(this.config.filePath)) {
+            return 0;
+        }
+        const content = await fs.readFile(this.config.filePath, 'utf-8');
+        return content.trim().split('\n').filter(Boolean).length;
+    }
+    /**
+     * Trim old chunks to stay under the limit.
+     * Removes the oldest chunks by rewriting the file.
+     */
+    async trimOldChunks() {
+        if (!existsSync(this.config.filePath)) {
+            return;
+        }
+        const content = await fs.readFile(this.config.filePath, 'utf-8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        if (lines.length <= this.config.maxChunks) {
+            return;
+        }
+        // Keep only the most recent chunks
+        const keepCount = Math.floor(this.config.maxChunks * 0.9); // Keep 90% of max
+        const trimmedLines = lines.slice(-keepCount);
+        await fs.writeFile(this.config.filePath, trimmedLines.join('\n') + '\n', 'utf-8');
+        this.chunkCount = trimmedLines.length;
+    }
+}
+//# sourceMappingURL=output-recorder.js.map

package/src/session/output-recorder.js.map

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

package/src/session/session-manager.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Session Manager
+ *
+ * Core session management without tmux. Handles:
+ * - Direct PTY spawning via node-pty
+ * - Session persistence to disk
+ * - Session restoration on server restart
+ * - Multi-client connections
+ */
+import { EventEmitter } from 'events';
+import type { IPty } from '@lydell/node-pty';
+import { HistoryReplay } from './history-replay.js';
+import { type OutputChunk } from './output-recorder.js';
+import type { CreateSessionOptions, Session, SessionId, SessionInfo, SessionManagerConfig, SessionPaths } from './types.js';
+/**
+ * Get the default shell for the current platform.
+ */
+declare function getDefaultShell(): string;
+/**
+ * Get default environment variables for terminal sessions.
+ */
+declare function getDefaultEnv(): Record<string, string>;
+/**
+ * SessionManager handles all session lifecycle operations.
+ *
+ * @example
+ * ```typescript
+ * const manager = new SessionManager();
+ * await manager.init();
+ *
+ * // Create a new session
+ * const session = await manager.createSession({ name: 'dev' });
+ *
+ * // Get the PTY for I/O
+ * const pty = manager.getPty(session.id);
+ * pty.onData((data) => console.log(data));
+ * pty.write('echo hello\n');
+ *
+ * // List all sessions
+ * const sessions = await manager.listSessions();
+ *
+ * // Delete a session
+ * await manager.deleteSession(session.id);
+ * ```
+ */
+export declare class SessionManager extends EventEmitter {
+    private config;
+    private paths;
+    private sessions;
+    private ptyProcesses;
+    private outputRecorders;
+    private initialized;
+    constructor(config?: SessionManagerConfig);
+    /**
+     * Initialize the session manager.
+     * Loads persisted sessions from disk.
+     */
+    init(): Promise<void>;
+    /**
+     * Create a new session.
+     */
+    createSession(options?: CreateSessionOptions): Promise<Session>;
+    /**
+     * Get a session by ID.
+     */
+    getSession(sessionId: SessionId): Session | undefined;
+    /**
+     * Get the PTY process for a session.
+     * Returns undefined if the process is not running.
+     */
+    getPty(sessionId: SessionId): IPty | undefined;
+    /**
+     * List all sessions with summary info.
+     */
+    listSessions(): Promise<SessionInfo[]>;
+    /**
+     * Delete a session and all associated data.
+     */
+    deleteSession(sessionId: SessionId): Promise<void>;
+    /**
+     * Rename a session.
+     */
+    renameSession(sessionId: SessionId, newName: string): Promise<void>;
+    /**
+     * Resize a session's terminal.
+     */
+    resizeSession(sessionId: SessionId, cols: number, rows: number): Promise<void>;
+    /**
+     * Connect to a session, respawning the process if needed.
+     * Returns the PTY for I/O.
+     */
+    connectToSession(sessionId: SessionId): Promise<IPty>;
+    /**
+     * Write data to a session's PTY.
+     */
+    write(sessionId: SessionId, data: string): void;
+    /**
+     * Get the storage paths for session data.
+     */
+    getPaths(): SessionPaths;
+    /**
+     * Get the buffered output for a session (for replay on reconnect).
+     * Returns the concatenated output as a single string.
+     * Note: This loads all scrollback into memory. For large histories,
+     * use getScrollbackChunks() instead.
+     */
+    getScrollback(sessionId: SessionId): Promise<string>;
+    /**
+     * Get scrollback chunks for a session with pagination.
+     * @param sessionId Session ID
+     * @param offset Number of chunks to skip from the start
+     * @param limit Maximum number of chunks to return
+     */
+    getScrollbackChunks(sessionId: SessionId, offset?: number, limit?: number): Promise<OutputChunk[]>;
+    /**
+     * Get the total number of scrollback chunks for a session.
+     */
+    getScrollbackLength(sessionId: SessionId): number;
+    /**
+     * Create a history replay for streaming scrollback to a client.
+     * The replay emits 'data', 'progress', and 'complete' events.
+     */
+    createHistoryReplay(sessionId: SessionId): Promise<HistoryReplay | null>;
+    /**
+     * Spawn a PTY process for a session.
+     */
+    private spawnProcess;
+    /**
+     * Persist a session's metadata to disk.
+     */
+    private persistSession;
+    /**
+     * Load persisted sessions from disk.
+     */
+    private loadPersistedSessions;
+    /**
+     * Generate a display name for a new session.
+     * Returns the next available number (1, 2, 3, ...).
+     */
+    private generateDisplayName;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): Promise<void>;
+}
+export declare function getSessionManager(config?: SessionManagerConfig): SessionManager;
+export { getDefaultShell, getDefaultEnv };