@cluesmith/codev 2.0.0-rc.7 → 2.0.0-rc.70

package/dist/terminal/session-manager.js

@@ -0,0 +1,582 @@
+/**
+ * SessionManager: orchestrates shepherd process lifecycle.
+ *
+ * Responsibilities:
+ * - Spawn shepherd processes as detached children
+ * - Connect ShepherdClient to each shepherd
+ * - Kill sessions (SIGTERM → wait → SIGKILL)
+ * - Detect and clean up stale sockets
+ * - Auto-restart on exit (configurable per session)
+ * - Reconnect to existing shepherds after Tower restart
+ *
+ * Process start time validation prevents PID reuse reconnection.
+ */
+import { spawn as cpSpawn } from 'node:child_process';
+import fs from 'node:fs';
+import net from 'node:net';
+import path from 'node:path';
+import { EventEmitter } from 'node:events';
+import { execFile } from 'node:child_process';
+import { ShepherdClient } from './shepherd-client.js';
+export class SessionManager extends EventEmitter {
+    config;
+    sessions = new Map();
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Spawn a new shepherd process and connect to it.
+     * Returns the connected client.
+     */
+    async createSession(opts) {
+        const socketPath = this.getSocketPath(opts.sessionId);
+        // Ensure socket directory exists with 0700 permissions
+        fs.mkdirSync(this.config.socketDir, { recursive: true, mode: 0o700 });
+        // Clean up any stale socket file
+        this.unlinkSocketIfExists(socketPath);
+        // Build config for shepherd-main.js
+        const shepherdConfig = JSON.stringify({
+            command: opts.command,
+            args: opts.args,
+            cwd: opts.cwd,
+            env: opts.env,
+            cols: opts.cols,
+            rows: opts.rows,
+            socketPath,
+        });
+        // Spawn shepherd as detached process
+        const child = cpSpawn(this.config.nodeExecutable, [this.config.shepherdScript, shepherdConfig], {
+            detached: true,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        // Read PID + startTime from stdout
+        const info = await this.readShepherdInfo(child);
+        child.unref();
+        // Post-spawn setup with rollback: if anything fails after the shepherd
+        // is spawned, kill the orphaned process and clean up the socket.
+        let client;
+        try {
+            // Wait briefly for socket to be ready
+            await this.waitForSocket(socketPath);
+            // Connect client
+            client = new ShepherdClient(socketPath);
+            await client.connect();
+        }
+        catch (err) {
+            // Rollback: kill the orphaned shepherd process
+            try {
+                process.kill(info.pid, 'SIGKILL');
+            }
+            catch { /* already dead */ }
+            this.unlinkSocketIfExists(socketPath);
+            throw err;
+        }
+        const session = {
+            client,
+            socketPath,
+            pid: info.pid,
+            startTime: info.startTime,
+            options: opts,
+            restartCount: 0,
+            restartResetTimer: null,
+        };
+        this.sessions.set(opts.sessionId, session);
+        // Set up auto-restart if configured
+        if (opts.restartOnExit) {
+            this.setupAutoRestart(session, opts.sessionId);
+        }
+        // Forward exit events and clean up dead sessions
+        client.on('exit', (exitInfo) => {
+            this.emit('session-exit', opts.sessionId, exitInfo);
+            // If not auto-restarting, remove the dead session from the map
+            // so listSessions() doesn't report it and cleanupStaleSockets()
+            // can clean its socket file.
+            if (!opts.restartOnExit) {
+                this.removeDeadSession(opts.sessionId);
+            }
+        });
+        client.on('error', (err) => {
+            this.emit('session-error', opts.sessionId, err);
+        });
+        // Handle shepherd crash (socket disconnects without EXIT frame)
+        client.on('close', () => {
+            // If the session is still in the map (wasn't already cleaned up by exit/kill),
+            // the shepherd died without sending EXIT. Remove the dead session.
+            if (this.sessions.has(opts.sessionId)) {
+                this.removeDeadSession(opts.sessionId);
+                this.emit('session-error', opts.sessionId, new Error('Shepherd disconnected unexpectedly'));
+            }
+        });
+        // Start restart reset timer if configured
+        if (opts.restartOnExit) {
+            this.startRestartResetTimer(session);
+        }
+        return client;
+    }
+    /**
+     * Reconnect to an existing shepherd process after Tower restart.
+     * Validates PID is alive and start time matches.
+     * Returns connected client, or null if shepherd is stale/dead.
+     */
+    async reconnectSession(sessionId, socketPath, pid, startTime, restartOptions) {
+        // Check if process is alive
+        if (!this.isProcessAlive(pid)) {
+            return null;
+        }
+        // Validate process start time to prevent PID reuse
+        const actualStartTime = await getProcessStartTime(pid);
+        if (actualStartTime === null || Math.abs(actualStartTime - startTime) > 2000) {
+            // Start time mismatch or couldn't determine — PID was reused
+            return null;
+        }
+        // Check socket file exists
+        try {
+            const stat = fs.lstatSync(socketPath);
+            if (!stat.isSocket()) {
+                return null;
+            }
+        }
+        catch {
+            return null;
+        }
+        // Connect client
+        const client = new ShepherdClient(socketPath);
+        try {
+            await client.connect();
+        }
+        catch {
+            return null;
+        }
+        const hasRestart = !!restartOptions;
+        const session = {
+            client,
+            socketPath,
+            pid,
+            startTime,
+            options: {
+                sessionId,
+                command: restartOptions?.command ?? '',
+                args: restartOptions?.args ?? [],
+                cwd: restartOptions?.cwd ?? '',
+                env: restartOptions?.env ?? {},
+                cols: 80,
+                rows: 24,
+                restartOnExit: hasRestart,
+                restartDelay: restartOptions?.restartDelay,
+                maxRestarts: restartOptions?.maxRestarts,
+                restartResetAfter: restartOptions?.restartResetAfter,
+            },
+            restartCount: 0,
+            restartResetTimer: null,
+        };
+        this.sessions.set(sessionId, session);
+        // Set up auto-restart if configured (e.g. architect sessions after Tower restart)
+        if (hasRestart) {
+            this.setupAutoRestart(session, sessionId);
+        }
+        client.on('exit', (exitInfo) => {
+            this.emit('session-exit', sessionId, exitInfo);
+            if (!hasRestart) {
+                this.removeDeadSession(sessionId);
+            }
+        });
+        client.on('error', (err) => {
+            this.emit('session-error', sessionId, err);
+        });
+        // Handle shepherd crash (socket disconnects without EXIT frame)
+        client.on('close', () => {
+            if (this.sessions.has(sessionId)) {
+                this.removeDeadSession(sessionId);
+                this.emit('session-error', sessionId, new Error('Shepherd disconnected unexpectedly'));
+            }
+        });
+        // Start restart reset timer if auto-restart is enabled
+        if (hasRestart) {
+            this.startRestartResetTimer(session);
+        }
+        return client;
+    }
+    /**
+     * Kill a session: SIGTERM, wait 5s, SIGKILL if needed.
+     * Cleans up socket file and removes from session map.
+     */
+    async killSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        // Clear restart timer
+        if (session.restartResetTimer) {
+            clearTimeout(session.restartResetTimer);
+            session.restartResetTimer = null;
+        }
+        // Disable auto-restart by removing the session from the map before killing
+        this.sessions.delete(sessionId);
+        // Send SIGTERM
+        try {
+            process.kill(session.pid, 'SIGTERM');
+        }
+        catch {
+            // Process already dead
+        }
+        // Wait up to 5s for process to die
+        const died = await this.waitForProcessExit(session.pid, 5000);
+        if (!died) {
+            // Force kill
+            try {
+                process.kill(session.pid, 'SIGKILL');
+            }
+            catch {
+                // Already dead
+            }
+        }
+        // Disconnect client
+        session.client.disconnect();
+        // Clean up socket file
+        this.unlinkSocketIfExists(session.socketPath);
+    }
+    /**
+     * List all active sessions.
+     */
+    listSessions() {
+        const result = new Map();
+        for (const [id, session] of this.sessions) {
+            result.set(id, session.client);
+        }
+        return result;
+    }
+    /**
+     * Get session metadata (pid, startTime, socketPath) for a session.
+     */
+    getSessionInfo(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        return {
+            pid: session.pid,
+            startTime: session.startTime,
+            socketPath: session.socketPath,
+        };
+    }
+    /**
+     * Scan socket directory for stale sockets (no live process).
+     * A socket is stale if nothing is listening on it (connection refused).
+     * Returns the number of sockets cleaned up.
+     */
+    async cleanupStaleSockets() {
+        let cleaned = 0;
+        let files;
+        try {
+            files = fs.readdirSync(this.config.socketDir);
+        }
+        catch {
+            return 0;
+        }
+        for (const file of files) {
+            if (!file.startsWith('shepherd-') || !file.endsWith('.sock'))
+                continue;
+            const fullPath = path.join(this.config.socketDir, file);
+            // Safety: reject symlinks
+            try {
+                const stat = fs.lstatSync(fullPath);
+                if (stat.isSymbolicLink())
+                    continue;
+                if (!stat.isSocket())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            // Extract session ID from filename: shepherd-{sessionId}.sock
+            const sessionId = file.replace('shepherd-', '').replace('.sock', '');
+            // Skip if we have an active session for this
+            if (this.sessions.has(sessionId))
+                continue;
+            // Probe the socket: try connecting to see if a shepherd is alive.
+            // If connection is refused, the socket is stale and safe to delete.
+            // If connection succeeds, a shepherd is still running — leave it alone.
+            const isAlive = await this.probeSocket(fullPath);
+            if (isAlive)
+                continue;
+            // No live process — it's stale
+            try {
+                fs.unlinkSync(fullPath);
+                cleaned++;
+            }
+            catch {
+                // Permission error or already gone
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Test if a Unix socket has a listener by attempting a brief connection.
+     * Returns true if connection succeeds, false if refused/timed out.
+     */
+    probeSocket(socketPath) {
+        return new Promise((resolve) => {
+            const socket = net.createConnection(socketPath);
+            const timeout = setTimeout(() => {
+                socket.destroy();
+                resolve(false);
+            }, 2000);
+            socket.on('connect', () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve(true);
+            });
+            socket.on('error', () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve(false);
+            });
+        });
+    }
+    /**
+     * Disconnect from all sessions without killing shepherd processes.
+     * Per spec: "When Tower intentionally stops, Tower closes its socket
+     * connections to shepherds. Shepherds continue running."
+     */
+    shutdown() {
+        for (const [id, session] of this.sessions) {
+            if (session.restartResetTimer) {
+                clearTimeout(session.restartResetTimer);
+                session.restartResetTimer = null;
+            }
+            session.client.disconnect();
+        }
+        this.sessions.clear();
+    }
+    // --- Private helpers ---
+    /**
+     * Remove a dead session from the map, clear its timers, and clean up socket.
+     * Called when a session exits naturally (no restart) or exhausts maxRestarts.
+     */
+    removeDeadSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        if (session.restartResetTimer) {
+            clearTimeout(session.restartResetTimer);
+            session.restartResetTimer = null;
+        }
+        this.sessions.delete(sessionId);
+        this.unlinkSocketIfExists(session.socketPath);
+    }
+    getSocketPath(sessionId) {
+        return path.join(this.config.socketDir, `shepherd-${sessionId}.sock`);
+    }
+    unlinkSocketIfExists(socketPath) {
+        try {
+            const stat = fs.lstatSync(socketPath);
+            if (stat.isSocket()) {
+                fs.unlinkSync(socketPath);
+            }
+        }
+        catch {
+            // Doesn't exist — fine
+        }
+    }
+    readShepherdInfo(child) {
+        return new Promise((resolve, reject) => {
+            let data = '';
+            const timeout = setTimeout(() => {
+                reject(new Error('Timed out reading shepherd info from stdout'));
+            }, 10_000);
+            child.stdout.on('data', (chunk) => {
+                data += chunk.toString();
+            });
+            child.stdout.on('end', () => {
+                clearTimeout(timeout);
+                try {
+                    const info = JSON.parse(data);
+                    resolve(info);
+                }
+                catch {
+                    reject(new Error(`Invalid shepherd info JSON: ${data}`));
+                }
+            });
+            child.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+            child.on('exit', (code) => {
+                if (code !== null && code !== 0 && data === '') {
+                    clearTimeout(timeout);
+                    reject(new Error(`Shepherd exited with code ${code} before writing info`));
+                }
+            });
+        });
+    }
+    waitForSocket(socketPath, timeout = 5000) {
+        return new Promise((resolve, reject) => {
+            const start = Date.now();
+            const check = () => {
+                try {
+                    fs.statSync(socketPath);
+                    resolve();
+                }
+                catch {
+                    if (Date.now() - start > timeout) {
+                        reject(new Error(`Socket ${socketPath} not created within ${timeout}ms`));
+                    }
+                    else {
+                        setTimeout(check, 50);
+                    }
+                }
+            };
+            check();
+        });
+    }
+    isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    waitForProcessExit(pid, timeout) {
+        return new Promise((resolve) => {
+            const start = Date.now();
+            const check = () => {
+                if (!this.isProcessAlive(pid)) {
+                    resolve(true);
+                    return;
+                }
+                if (Date.now() - start > timeout) {
+                    resolve(false);
+                    return;
+                }
+                setTimeout(check, 100);
+            };
+            check();
+        });
+    }
+    setupAutoRestart(session, sessionId) {
+        session.client.on('exit', () => {
+            // Check if session was removed (killed intentionally)
+            if (!this.sessions.has(sessionId))
+                return;
+            // Cancel the reset timer while the process is down — it should only
+            // run while the process is alive, preventing restartResetAfter < restartDelay
+            // from resetting the counter during downtime.
+            if (session.restartResetTimer) {
+                clearTimeout(session.restartResetTimer);
+                session.restartResetTimer = null;
+            }
+            const maxRestarts = session.options.maxRestarts ?? 50;
+            if (session.restartCount >= maxRestarts) {
+                this.emit('session-error', sessionId, new Error(`Max restarts (${maxRestarts}) exceeded`));
+                // Remove the exhausted session from the map
+                this.removeDeadSession(sessionId);
+                return;
+            }
+            session.restartCount++;
+            const delay = session.options.restartDelay ?? 2000;
+            this.emit('session-restart', sessionId, {
+                restartCount: session.restartCount,
+                delay,
+            });
+            setTimeout(() => {
+                // Re-check session still exists after delay
+                if (!this.sessions.has(sessionId))
+                    return;
+                session.client.spawn({
+                    command: session.options.command,
+                    args: session.options.args,
+                    cwd: session.options.cwd,
+                    env: session.options.env,
+                });
+                // Only restart the reset timer after a successful spawn
+                this.startRestartResetTimer(session);
+            }, delay);
+        });
+    }
+    startRestartResetTimer(session) {
+        if (session.restartResetTimer) {
+            clearTimeout(session.restartResetTimer);
+        }
+        const restartDelay = session.options.restartDelay ?? 2000;
+        const resetAfter = session.options.restartResetAfter ?? 300_000; // 5 minutes
+        // Enforce minimum: reset window must be at least as long as restartDelay
+        // to prevent the counter from resetting while the process is restarting
+        const effectiveResetAfter = Math.max(resetAfter, restartDelay);
+        session.restartResetTimer = setTimeout(() => {
+            session.restartCount = 0;
+        }, effectiveResetAfter);
+    }
+}
+/**
+ * Get the start time of a process by PID.
+ * Returns epoch milliseconds, or null if the process doesn't exist or can't be queried.
+ *
+ * Platform-specific:
+ * - macOS: parse `ps -p {pid} -o lstart=`
+ * - Linux: read `/proc/{pid}/stat` field 22 (starttime in clock ticks)
+ */
+export function getProcessStartTime(pid) {
+    return new Promise((resolve) => {
+        try {
+            if (process.platform === 'darwin') {
+                // macOS: use ps to get launch time
+                execFile('ps', ['-p', String(pid), '-o', 'lstart='], (err, stdout) => {
+                    if (err || !stdout.trim()) {
+                        resolve(null);
+                        return;
+                    }
+                    const date = new Date(stdout.trim());
+                    if (isNaN(date.getTime())) {
+                        resolve(null);
+                        return;
+                    }
+                    resolve(date.getTime());
+                });
+            }
+            else if (process.platform === 'linux') {
+                // Linux: read /proc/{pid}/stat and parse starttime (field 22)
+                fs.readFile(`/proc/${pid}/stat`, 'utf-8', (err, data) => {
+                    if (err) {
+                        resolve(null);
+                        return;
+                    }
+                    // Fields in /proc/PID/stat are space-separated, but field 2 (comm) may
+                    // contain spaces in parentheses. Find the last ')' to skip past it.
+                    const closeParenIdx = data.lastIndexOf(')');
+                    if (closeParenIdx === -1) {
+                        resolve(null);
+                        return;
+                    }
+                    const fields = data.substring(closeParenIdx + 2).split(' ');
+                    // Field 22 is starttime, but after stripping comm it's at index 19
+                    // (fields 3-51, so starttime = field 22 → index 22-3 = 19)
+                    const startTimeTicks = parseInt(fields[19], 10);
+                    if (isNaN(startTimeTicks)) {
+                        resolve(null);
+                        return;
+                    }
+                    // Convert clock ticks to ms: we need the system boot time + starttime
+                    // This is complex — use a simpler approach via /proc/PID/stat creation time
+                    fs.stat(`/proc/${pid}`, (statErr, stat) => {
+                        if (statErr) {
+                            resolve(null);
+                            return;
+                        }
+                        // /proc/PID directory creation time approximates process start time
+                        resolve(stat.ctimeMs);
+                    });
+                });
+            }
+            else {
+                resolve(null);
+            }
+        }
+        catch {
+            // Defensive: if execFile/readFile throws synchronously (e.g., EPERM
+            // in restricted environments), return null instead of rejecting.
+            resolve(null);
+        }
+    });
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/terminal/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/terminal/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AA0C5E,MAAM,OAAO,cAAe,SAAQ,YAAY;IAGjB;IAFrB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,YAA6B,MAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAsB;IAEzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,IAA0B;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEtD,uDAAuD;QACvD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAEtE,iCAAiC;QACjC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAEtC,oCAAoC;QACpC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU;SACX,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE;YAC9F,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChD,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,uEAAuE;QACvE,iEAAiE;QACjE,IAAI,MAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YAErC,iBAAiB;YACjB,MAAM,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,+CAA+C;YAC/C,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACvE,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAmB;YAC9B,MAAM;YACN,UAAU;YACV,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,IAAI;SACxB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE3C,oCAAoC;QACpC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACpD,+DAA+D;YAC/D,gEAAgE;YAChE,6BAA6B;YAC7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,gEAAgE;QAChE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,+EAA+E;YAC/E,mEAAmE;YACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,UAAkB,EAClB,GAAW,EACX,SAAiB,EACjB,cAAwC;QAExC,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mDAAmD;QACnD,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC;YAC7E,6DAA6D;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iBAAiB;QACjB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,CAAC,cAAc,CAAC;QACpC,MAAM,OAAO,GAAmB;YAC9B,MAAM;YACN,UAAU;YACV,GAAG;YACH,SAAS;YACT,OAAO,EAAE;gBACP,SAAS;gBACT,OAAO,EAAE,cAAc,EAAE,OAAO,IAAI,EAAE;gBACtC,IAAI,EAAE,cAAc,EAAE,IAAI,IAAI,EAAE;gBAChC,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE;gBAC9B,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE;gBAC9B,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,EAAE;gBACR,aAAa,EAAE,UAAU;gBACzB,YAAY,EAAE,cAAc,EAAE,YAAY;gBAC1C,WAAW,EAAE,cAAc,EAAE,WAAW;gBACxC,iBAAiB,EAAE,cAAc,EAAE,iBAAiB;aACrD;YACD,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,IAAI;SACxB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtC,kFAAkF;QAClF,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,gEAAgE;QAChE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;YACzF,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uDAAuD;QACvD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,sBAAsB;QACtB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACxC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEhC,eAAe;QACf,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,mCAAmC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,aAAa;YACb,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAE5B,uBAAuB;QACvB,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;QAClD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAiB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAExD,0BAA0B;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACpC,IAAI,IAAI,CAAC,cAAc,EAAE;oBAAE,SAAS;gBACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;oBAAE,SAAS;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,8DAA8D;YAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAErE,6CAA6C;YAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YAE3C,kEAAkE;YAClE,oEAAoE;YACpE,wEAAwE;YACxE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,OAAO;gBAAE,SAAS;YAEtB,+BAA+B;YAC/B,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,UAAkB;QACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EAAE,IAAI,CAAC,CAAC;YAET,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACxB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAC9B,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBACxC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YACnC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,0BAA0B;IAE1B;;;OAGG;IACK,iBAAiB,CAAC,SAAiB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACxC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAEO,aAAa,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,SAAS,OAAO,CAAC,CAAC;IACxE,CAAC;IAEO,oBAAoB,CAAC,UAAkB;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACpB,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAEO,gBAAgB,CACtB,KAAiC;QAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACnE,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,KAAK,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC3B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuC,CAAC;oBACpE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;oBAC/C,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,IAAI,sBAAsB,CAAC,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,UAAkB,EAAE,OAAO,GAAG,IAAI;QACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;oBACxB,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;wBACjC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,UAAU,uBAAuB,OAAO,IAAI,CAAC,CAAC,CAAC;oBAC5E,CAAC;yBAAM,CAAC;wBACN,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC,CAAC;YACF,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,GAAW;QAChC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,GAAW,EAAE,OAAe;QACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;oBACjC,OAAO,CAAC,KAAK,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACzB,CAAC,CAAC;YACF,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,OAAuB,EAAE,SAAiB;QACjE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YAC7B,sDAAsD;YACtD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO;YAE1C,oEAAoE;YACpE,8EAA8E;YAC9E,8CAA8C;YAC9C,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAC9B,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBACxC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;YACnC,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;YACtD,IAAI,OAAO,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,KAAK,CAAC,iBAAiB,WAAW,YAAY,CAAC,CAAC,CAAC;gBAC3F,4CAA4C;gBAC5C,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;YAEnD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,EAAE;gBACtC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,KAAK;aACN,CAAC,CAAC;YAEH,UAAU,CAAC,GAAG,EAAE;gBACd,4CAA4C;gBAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;oBAAE,OAAO;gBAE1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBACnB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;oBAChC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;oBAC1B,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;oBACxB,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;iBACzB,CAAC,CAAC;gBAEH,wDAAwD;gBACxD,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,sBAAsB,CAAC,OAAuB;QACpD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,CAAC,YAAY;QAC7E,yEAAyE;QACzE,wEAAwE;QACxE,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/D,OAAO,CAAC,iBAAiB,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1C,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC;QAC3B,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACL,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAClC,mCAAmC;gBACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;oBACnE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;wBAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBACrC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;wBAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1B,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACxC,8DAA8D;gBAC9D,EAAE,CAAC,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;oBACtD,IAAI,GAAG,EAAE,CAAC;wBACR,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,uEAAuE;oBACvE,oEAAoE;oBACpE,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;oBAC5C,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;wBACzB,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC5D,mEAAmE;oBACnE,2DAA2D;oBAC3D,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChD,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;wBAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,sEAAsE;oBACtE,4EAA4E;oBAC5E,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;wBACxC,IAAI,OAAO,EAAE,CAAC;4BACZ,OAAO,CAAC,IAAI,CAAC,CAAC;4BACd,OAAO;wBACT,CAAC;wBACD,oEAAoE;wBACpE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACxB,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACD,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,iEAAiE;YACjE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/terminal/shepherd-client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ShepherdClient: Tower's connection to a single shepherd process.
+ *
+ * Connects to a shepherd via Unix socket, performs HELLO/WELCOME handshake,
+ * and provides a typed API for sending/receiving frames. Emits events for
+ * data, exit, replay, and errors.
+ *
+ * Usage:
+ *   const client = new ShepherdClient('/path/to/shepherd.sock');
+ *   const welcome = await client.connect();
+ *   client.on('data', (buf) => { ... });
+ *   client.write('ls\n');
+ *   client.disconnect();
+ */
+import { EventEmitter } from 'node:events';
+import { type WelcomeMessage, type SpawnMessage } from './shepherd-protocol.js';
+export interface IShepherdClient extends EventEmitter {
+    connect(): Promise<WelcomeMessage>;
+    disconnect(): void;
+    write(data: string | Buffer): void;
+    resize(cols: number, rows: number): void;
+    signal(sig: number): void;
+    spawn(msg: SpawnMessage): void;
+    ping(): void;
+    getReplayData(): Buffer | null;
+    readonly connected: boolean;
+}
+export declare class ShepherdClient extends EventEmitter implements IShepherdClient {
+    private readonly socketPath;
+    private socket;
+    private _connected;
+    private replayData;
+    constructor(socketPath: string);
+    /**
+     * Emit an 'error' event only if listeners are attached.
+     * Prevents Node.js from throwing on unhandled 'error' events,
+     * which would crash Tower.
+     */
+    private safeEmitError;
+    get connected(): boolean;
+    /**
+     * Connect to the shepherd, perform HELLO/WELCOME handshake.
+     * Resolves with the WelcomeMessage on success.
+     * Rejects on connection error or handshake failure.
+     */
+    connect(): Promise<WelcomeMessage>;
+    private handleFrame;
+    disconnect(): void;
+    private cleanup;
+    write(data: string | Buffer): void;
+    resize(cols: number, rows: number): void;
+    signal(sig: number): void;
+    spawn(msg: SpawnMessage): void;
+    ping(): void;
+    /** Get the last received replay data, or null if none. */
+    getReplayData(): Buffer | null;
+}
+//# sourceMappingURL=shepherd-client.d.ts.map

package/dist/terminal/shepherd-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shepherd-client.d.ts","sourceRoot":"","sources":["../../src/terminal/shepherd-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAcL,KAAK,cAAc,EAEnB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,cAAe,SAAQ,YAAa,YAAW,eAAe;IAK7D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAuB;gBAEZ,UAAU,EAAE,MAAM;IAI/C;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAgGlC,OAAO,CAAC,WAAW;IAuCnB,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,OAAO;IAQf,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKlC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAK9B,IAAI,IAAI,IAAI;IAKZ,0DAA0D;IAC1D,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}