@seflless/ghosttown 1.7.0 → 1.10.0

package/src/session/history-replay.js

@@ -0,0 +1,174 @@
+/**
+ * History Replay
+ *
+ * Streams scrollback history to clients in chunks.
+ * Handles large histories (10,000+ lines) without blocking.
+ *
+ * Replay is throttled to prevent overwhelming the client with data
+ * and to show a progress indicator for long replays.
+ */
+import { EventEmitter } from 'events';
+const DEFAULTS = {
+    chunkSize: 100,
+    batchDelay: 10,
+    maxReplayTime: 30000,
+};
+/**
+ * Replays scrollback history to a client.
+ *
+ * @example
+ * ```typescript
+ * const replay = new HistoryReplay({
+ *   chunkSize: 100,
+ *   batchDelay: 10
+ * });
+ *
+ * replay.on('data', (data) => {
+ *   // Send data to client via WebSocket
+ *   ws.send(JSON.stringify({ type: 'scrollback', data }));
+ * });
+ *
+ * replay.on('progress', (progress) => {
+ *   // Update progress indicator
+ *   console.log(`Replay: ${progress.percent}% complete`);
+ * });
+ *
+ * replay.on('complete', () => {
+ *   console.log('Replay finished');
+ * });
+ *
+ * // Start replay
+ * await replay.start(chunks);
+ * ```
+ */
+export class HistoryReplay extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.aborted = false;
+        this.startTime = 0;
+        this.config = {
+            chunkSize: config.chunkSize ?? DEFAULTS.chunkSize,
+            batchDelay: config.batchDelay ?? DEFAULTS.batchDelay,
+            maxReplayTime: config.maxReplayTime ?? DEFAULTS.maxReplayTime,
+        };
+    }
+    /**
+     * Start replaying chunks.
+     * Emits 'data' events with concatenated output for each batch.
+     * Emits 'progress' events periodically.
+     * Emits 'complete' when done.
+     *
+     * @param chunks Array of output chunks to replay
+     * @returns Promise that resolves when replay completes or is aborted
+     */
+    async start(chunks) {
+        this.aborted = false;
+        this.startTime = Date.now();
+        const total = chunks.length;
+        if (total === 0) {
+            this.emitProgress(0, 0);
+            this.emit('complete');
+            return;
+        }
+        let sent = 0;
+        while (sent < total && !this.aborted) {
+            // Check timeout
+            if (Date.now() - this.startTime > this.config.maxReplayTime) {
+                this.emit('error', new Error('Replay timeout exceeded'));
+                return;
+            }
+            // Get next batch
+            const batch = chunks.slice(sent, sent + this.config.chunkSize);
+            // Concatenate output data
+            const data = batch.map((c) => c.d).join('');
+            // Emit data
+            if (data) {
+                this.emit('data', data);
+            }
+            sent += batch.length;
+            // Emit progress
+            this.emitProgress(sent, total);
+            // Delay between batches (unless this is the last batch)
+            if (sent < total && this.config.batchDelay > 0) {
+                await this.delay(this.config.batchDelay);
+            }
+        }
+        if (!this.aborted) {
+            this.emit('complete');
+        }
+    }
+    /**
+     * Start replay from an async generator.
+     * Useful for streaming from disk without loading all chunks into memory.
+     */
+    async startFromGenerator(generator, total) {
+        this.aborted = false;
+        this.startTime = Date.now();
+        let sent = 0;
+        for await (const batch of generator) {
+            if (this.aborted)
+                break;
+            // Check timeout
+            if (Date.now() - this.startTime > this.config.maxReplayTime) {
+                this.emit('error', new Error('Replay timeout exceeded'));
+                return;
+            }
+            // Concatenate output data
+            const data = batch.map((c) => c.d).join('');
+            // Emit data
+            if (data) {
+                this.emit('data', data);
+            }
+            sent += batch.length;
+            // Emit progress
+            this.emitProgress(sent, total);
+            // Delay between batches
+            if (this.config.batchDelay > 0) {
+                await this.delay(this.config.batchDelay);
+            }
+        }
+        if (!this.aborted) {
+            this.emit('complete');
+        }
+    }
+    /**
+     * Abort the replay.
+     */
+    abort() {
+        this.aborted = true;
+    }
+    /**
+     * Check if replay was aborted.
+     */
+    isAborted() {
+        return this.aborted;
+    }
+    /**
+     * Emit progress event.
+     */
+    emitProgress(sent, total) {
+        const progress = {
+            sent,
+            total,
+            percent: total === 0 ? 100 : Math.round((sent / total) * 100),
+            complete: sent >= total,
+        };
+        this.emit('progress', progress);
+    }
+    /**
+     * Delay for a specified time.
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create an async generator that reads chunks in batches.
+ * Useful for memory-efficient replay of large scrollback files.
+ */
+export async function* createChunkGenerator(chunks, batchSize) {
+    for (let i = 0; i < chunks.length; i += batchSize) {
+        yield chunks.slice(i, i + batchSize);
+    }
+}
+//# sourceMappingURL=history-replay.js.map

package/src/session/history-replay.js.map

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

package/src/session/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Session Management Module
+ *
+ * Custom PTY session management that replaces tmux.
+ * Provides session persistence, multi-client connections, and read-only sharing.
+ */
+export * from './types.js';
+export * from './session-manager.js';
+export * from './output-recorder.js';
+export * from './history-replay.js';

package/src/session/index.js

@@ -0,0 +1,11 @@
+/**
+ * Session Management Module
+ *
+ * Custom PTY session management that replaces tmux.
+ * Provides session persistence, multi-client connections, and read-only sharing.
+ */
+export * from './types.js';
+export * from './session-manager.js';
+export * from './output-recorder.js';
+export * from './history-replay.js';
+//# sourceMappingURL=index.js.map

package/src/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/src/session/output-recorder.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 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';
+/**
+ * A single output chunk stored in the scrollback file.
+ */
+export interface OutputChunk {
+    /** Unix timestamp in milliseconds */
+    t: number;
+    /** Raw output data */
+    d: string;
+}
+/**
+ * Configuration for OutputRecorder.
+ */
+export interface OutputRecorderConfig {
+    /** Path to the scrollback file */
+    filePath: string;
+    /** Maximum number of chunks to keep (default: 50000) */
+    maxChunks?: number;
+    /** Flush interval in milliseconds (default: 100) */
+    flushInterval?: number;
+    /** Maximum buffer size in bytes before flush (default: 65536 = 64KB) */
+    maxBufferSize?: number;
+}
+/**
+ * Events emitted by OutputRecorder.
+ */
+export interface OutputRecorderEvents {
+    /** Emitted when data is flushed to disk */
+    flush: (chunkCount: number) => void;
+    /** Emitted on error */
+    error: (error: Error) => void;
+}
+/**
+ * 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 declare class OutputRecorder extends EventEmitter {
+    private config;
+    private buffer;
+    private bufferSize;
+    private flushTimer;
+    private isWriting;
+    private pendingFlush;
+    private closed;
+    private chunkCount;
+    constructor(config: OutputRecorderConfig);
+    /**
+     * Initialize the recorder.
+     * Creates the directory and counts existing chunks.
+     */
+    init(): Promise<void>;
+    /**
+     * Record a chunk of output.
+     * The data is buffered and flushed to disk periodically.
+     */
+    record(data: string): void;
+    /**
+     * Flush buffered chunks to disk.
+     * Returns immediately if already flushing (coalesces concurrent calls).
+     */
+    flush(): Promise<void>;
+    /**
+     * Internal flush implementation.
+     */
+    private doFlush;
+    /**
+     * Read all chunks from disk.
+     * Returns chunks in chronological order.
+     */
+    readAll(): Promise<OutputChunk[]>;
+    /**
+     * Read chunks with pagination.
+     * @param offset Number of chunks to skip from the start
+     * @param limit Maximum number of chunks to return
+     */
+    read(offset: number, limit: number): Promise<OutputChunk[]>;
+    /**
+     * Get the total number of chunks (on disk + in buffer).
+     */
+    getChunkCount(): number;
+    /**
+     * Clear all recorded data.
+     */
+    clear(): Promise<void>;
+    /**
+     * Close the recorder and flush remaining data.
+     */
+    close(): Promise<void>;
+    /**
+     * Count chunks in the file.
+     */
+    private countChunks;
+    /**
+     * Trim old chunks to stay under the limit.
+     * Removes the oldest chunks by rewriting the file.
+     */
+    private trimOldChunks;
+}

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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"}