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

package/dist/terminal/pty-session.js

@@ -0,0 +1,327 @@
+/**
+ * Single PTY session: wraps node-pty with ring buffer, disk logging,
+ * WebSocket broadcast, and reconnection support.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { EventEmitter } from 'node:events';
+import { RingBuffer } from './ring-buffer.js';
+export class PtySession extends EventEmitter {
+    config;
+    id;
+    label;
+    createdAt;
+    ringBuffer;
+    pty = null;
+    shepherdClient = null;
+    _shepherdBacked = false;
+    _shepherdSessionId = null;
+    shepherdPid = -1;
+    cols;
+    rows;
+    exitCode;
+    logFd = null;
+    logBytes = 0;
+    logPath;
+    diskLogEnabled;
+    diskLogMaxBytes;
+    reconnectTimeoutMs;
+    disconnectTimer = null;
+    clients = new Set();
+    constructor(config) {
+        super();
+        this.config = config;
+        this.id = config.id;
+        this.label = config.label;
+        this.cols = config.cols;
+        this.rows = config.rows;
+        this.createdAt = new Date().toISOString();
+        this.ringBuffer = new RingBuffer(config.ringBufferLines ?? 1000);
+        this.diskLogEnabled = config.diskLogEnabled ?? true;
+        this.diskLogMaxBytes = config.diskLogMaxBytes ?? 50 * 1024 * 1024;
+        this.reconnectTimeoutMs = config.reconnectTimeoutMs ?? 300_000;
+        this.logPath = path.join(config.logDir, `${config.id}.log`);
+    }
+    /** Spawn the PTY process. Must be called after construction. */
+    async spawn() {
+        // Dynamic import to avoid hard dependency at module level
+        const nodePty = await import('node-pty');
+        // Ensure log directory exists
+        if (this.diskLogEnabled) {
+            fs.mkdirSync(path.dirname(this.logPath), { recursive: true });
+            this.logFd = fs.openSync(this.logPath, 'a');
+        }
+        this.pty = nodePty.spawn(this.config.command, this.config.args, {
+            name: 'xterm-256color',
+            cols: this.cols,
+            rows: this.rows,
+            cwd: this.config.cwd,
+            env: this.config.env,
+        });
+        this.pty.onData((data) => {
+            this.onPtyData(data);
+        });
+        this.pty.onExit(({ exitCode }) => {
+            this.exitCode = exitCode;
+            this.emit('exit', exitCode);
+            this.cleanup();
+        });
+    }
+    /**
+     * Attach a shepherd client as the I/O backend instead of node-pty.
+     * Data flows: shepherd → ring buffer → WebSocket clients.
+     * User input flows: WebSocket → write() → shepherd.
+     */
+    attachShepherd(client, replayData, shepherdPid, shepherdSessionId) {
+        this._shepherdBacked = true;
+        this.shepherdClient = client;
+        this.shepherdPid = shepherdPid;
+        this._shepherdSessionId = shepherdSessionId ?? null;
+        // Ensure log directory exists
+        if (this.diskLogEnabled) {
+            fs.mkdirSync(path.dirname(this.logPath), { recursive: true });
+            this.logFd = fs.openSync(this.logPath, 'a');
+        }
+        // Populate ring buffer with replay data from shepherd
+        if (replayData.length > 0) {
+            this.ringBuffer.pushData(replayData.toString('utf-8'));
+        }
+        // Forward shepherd data to ring buffer + WebSocket clients
+        client.on('data', (buf) => {
+            this.onPtyData(buf.toString('utf-8'));
+        });
+        // Handle shepherd exit (process inside shepherd exited)
+        client.on('exit', (exitInfo) => {
+            this.exitCode = exitInfo.code;
+            this.emit('exit', exitInfo.code);
+            // For shepherd-backed sessions, cleanup closes disk log and clients
+            // but doesn't clear the ring buffer (shepherd may still have replay data)
+            this.cleanupShepherd();
+        });
+        // Handle shepherd disconnect (socket closed without EXIT)
+        client.on('close', () => {
+            if (this.exitCode === undefined) {
+                // Unexpected disconnect — shepherd may have crashed
+                this.exitCode = -1;
+                this.emit('exit', -1);
+                this.cleanupShepherd();
+            }
+        });
+    }
+    /** Whether this session is backed by a shepherd process. */
+    get shepherdBacked() {
+        return this._shepherdBacked;
+    }
+    /** The SessionManager session ID for this shepherd-backed session, or null. */
+    get shepherdSessionId() {
+        return this._shepherdSessionId;
+    }
+    /**
+     * Detach from shepherd client during Tower shutdown.
+     * Removes all event listeners so that SessionManager.shutdown() disconnecting
+     * the client doesn't cascade into exit events and SQLite row deletion.
+     */
+    detachShepherd() {
+        if (this.shepherdClient) {
+            this.shepherdClient.removeAllListeners();
+            this.shepherdClient = null;
+        }
+        this.cleanupShepherd();
+    }
+    cleanupShepherd() {
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        this.clients.clear();
+        // Close disk log handle
+        if (this.logFd !== null) {
+            try {
+                fs.closeSync(this.logFd);
+            }
+            catch { /* ignore */ }
+            this.logFd = null;
+        }
+        // Note: ring buffer is NOT cleared — shepherd handles replay
+        // Note: shepherd client is NOT disconnected — SessionManager owns that lifecycle
+    }
+    onPtyData(data) {
+        // Store in ring buffer
+        this.ringBuffer.pushData(data);
+        // Write to disk log
+        if (this.diskLogEnabled && this.logFd !== null) {
+            const buf = Buffer.from(data, 'utf-8');
+            if (this.logBytes + buf.length <= this.diskLogMaxBytes) {
+                fs.writeSync(this.logFd, buf);
+                this.logBytes += buf.length;
+            }
+            else {
+                this.rotateDiskLog();
+                fs.writeSync(this.logFd, buf);
+                this.logBytes = buf.length;
+            }
+        }
+        // Broadcast to all connected WebSocket clients
+        for (const client of this.clients) {
+            try {
+                client.send(data);
+            }
+            catch {
+                this.clients.delete(client);
+            }
+        }
+        this.emit('data', data);
+    }
+    rotateDiskLog() {
+        if (this.logFd !== null) {
+            fs.closeSync(this.logFd);
+        }
+        const rotatedPath = this.logPath + '.1';
+        // Remove old rotation if exists
+        try {
+            fs.unlinkSync(rotatedPath + '.1');
+        }
+        catch { /* ignore */ }
+        try {
+            fs.renameSync(rotatedPath, rotatedPath + '.1');
+        }
+        catch { /* ignore */ }
+        try {
+            fs.renameSync(this.logPath, rotatedPath);
+        }
+        catch { /* ignore */ }
+        this.logFd = fs.openSync(this.logPath, 'a');
+        this.logBytes = 0;
+    }
+    /** Write user input to the PTY or shepherd. */
+    write(data) {
+        if (this._shepherdBacked) {
+            if (this.shepherdClient && this.status === 'running') {
+                this.shepherdClient.write(data);
+            }
+            return;
+        }
+        if (this.pty && this.status === 'running') {
+            this.pty.write(data);
+        }
+    }
+    /** Resize the PTY or shepherd. */
+    resize(cols, rows) {
+        this.cols = cols;
+        this.rows = rows;
+        if (this._shepherdBacked) {
+            if (this.shepherdClient && this.status === 'running') {
+                this.shepherdClient.resize(cols, rows);
+            }
+            return;
+        }
+        if (this.pty && this.status === 'running') {
+            this.pty.resize(cols, rows);
+        }
+    }
+    /** Kill the PTY process or send signal to shepherd. */
+    kill() {
+        if (this._shepherdBacked) {
+            if (this.shepherdClient && this.status === 'running') {
+                this.shepherdClient.signal(15); // SIGTERM
+            }
+            this.cleanupShepherd();
+            return;
+        }
+        if (this.pty && this.status === 'running') {
+            try {
+                // Kill process group to prevent orphans
+                process.kill(-this.pty.pid, 'SIGTERM');
+                setTimeout(() => {
+                    try {
+                        process.kill(-this.pty.pid, 'SIGKILL');
+                    }
+                    catch { /* already dead */ }
+                }, 5000);
+            }
+            catch {
+                // Process already exited
+            }
+        }
+        this.cleanup();
+    }
+    /** Attach a WebSocket client. Returns ring buffer contents for replay. */
+    attach(client) {
+        this.clients.add(client);
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        return this.ringBuffer.getAll();
+    }
+    /** Attach with resume from a specific sequence number. */
+    attachResume(client, sinceSeq) {
+        this.clients.add(client);
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        return this.ringBuffer.getSince(sinceSeq);
+    }
+    /** Detach a WebSocket client. Starts disconnect timer if no clients remain (non-shepherd only). */
+    detach(client) {
+        this.clients.delete(client);
+        // Shepherd-backed sessions don't need a disconnect timer — the shepherd
+        // keeps the process alive independently of WebSocket connections.
+        if (this._shepherdBacked)
+            return;
+        if (this.clients.size === 0 && this.status === 'running') {
+            this.disconnectTimer = setTimeout(() => {
+                this.emit('timeout');
+                this.kill();
+            }, this.reconnectTimeoutMs);
+        }
+    }
+    /** Working directory of the PTY session. */
+    get cwd() {
+        return this.config.cwd;
+    }
+    get status() {
+        return this.exitCode === undefined ? 'running' : 'exited';
+    }
+    get pid() {
+        if (this._shepherdBacked)
+            return this.shepherdPid;
+        return this.pty?.pid ?? -1;
+    }
+    get info() {
+        return {
+            id: this.id,
+            pid: this.pid,
+            cols: this.cols,
+            rows: this.rows,
+            label: this.label,
+            status: this.status,
+            createdAt: this.createdAt,
+            exitCode: this.exitCode,
+            persistent: this._shepherdBacked,
+        };
+    }
+    get clientCount() {
+        return this.clients.size;
+    }
+    cleanup() {
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        // Release all WebSocket clients
+        this.clients.clear();
+        // Release ring buffer memory
+        this.ringBuffer.clear();
+        // Close disk log handle
+        if (this.logFd !== null) {
+            try {
+                fs.closeSync(this.logFd);
+            }
+            catch { /* ignore */ }
+            this.logFd = null;
+        }
+    }
+}
+//# sourceMappingURL=pty-session.js.map

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

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

package/dist/terminal/ring-buffer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Fixed-size circular buffer for storing terminal output lines.
+ * Used for reconnection replay — stores last N lines in memory.
+ */
+export declare class RingBuffer {
+    private readonly capacity;
+    private buffer;
+    private head;
+    private count;
+    private seq;
+    private partial;
+    constructor(capacity?: number);
+    /** Push a complete line into the buffer. Returns the assigned sequence number. */
+    push(line: string): number;
+    /**
+     * Push raw data, splitting on newlines. Handles partial lines across
+     * chunk boundaries: if data doesn't end with \n, the trailing fragment
+     * is held and prepended to the next pushData call.
+     *
+     * Returns last sequence number.
+     */
+    pushData(data: string): number;
+    /** Get all stored lines in order, including any incomplete trailing line. */
+    getAll(): string[];
+    /** Get lines starting from a given sequence number (for resume). */
+    getSince(sinceSeq: number): string[];
+    /** Current sequence number (last written). */
+    get currentSeq(): number;
+    /** Number of lines currently stored. */
+    get size(): number;
+    /** Clear the buffer and release memory. */
+    clear(): void;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/terminal/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/terminal/ring-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,UAAU;IAOT,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,OAAO,CAAc;gBAEA,QAAQ,GAAE,MAAa;IAIpD,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW1B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiB9B,6EAA6E;IAC7E,MAAM,IAAI,MAAM,EAAE;IAWlB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBpC,8CAA8C;IAC9C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2CAA2C;IAC3C,KAAK,IAAI,IAAI;CAOd"}

package/dist/terminal/ring-buffer.js

@@ -0,0 +1,94 @@
+/**
+ * Fixed-size circular buffer for storing terminal output lines.
+ * Used for reconnection replay — stores last N lines in memory.
+ */
+export class RingBuffer {
+    capacity;
+    buffer;
+    head = 0;
+    count = 0;
+    seq = 0; // monotonically increasing sequence number
+    partial = ''; // incomplete line from previous pushData call
+    constructor(capacity = 1000) {
+        this.capacity = capacity;
+        this.buffer = new Array(capacity);
+    }
+    /** Push a complete line into the buffer. Returns the assigned sequence number. */
+    push(line) {
+        const index = (this.head + this.count) % this.capacity;
+        this.buffer[index] = line;
+        if (this.count < this.capacity) {
+            this.count++;
+        }
+        else {
+            this.head = (this.head + 1) % this.capacity;
+        }
+        return ++this.seq;
+    }
+    /**
+     * Push raw data, splitting on newlines. Handles partial lines across
+     * chunk boundaries: if data doesn't end with \n, the trailing fragment
+     * is held and prepended to the next pushData call.
+     *
+     * Returns last sequence number.
+     */
+    pushData(data) {
+        const combined = this.partial + data;
+        const parts = combined.split('\n');
+        // Last element is either:
+        // - "" if data ended with \n (all lines complete)
+        // - non-empty if data ended mid-line (incomplete line)
+        // Either way, save it as the new partial.
+        this.partial = parts.pop();
+        let lastSeq = this.seq;
+        for (const line of parts) {
+            lastSeq = this.push(line);
+        }
+        return lastSeq;
+    }
+    /** Get all stored lines in order, including any incomplete trailing line. */
+    getAll() {
+        const result = [];
+        for (let i = 0; i < this.count; i++) {
+            result.push(this.buffer[(this.head + i) % this.capacity]);
+        }
+        if (this.partial) {
+            result.push(this.partial);
+        }
+        return result;
+    }
+    /** Get lines starting from a given sequence number (for resume). */
+    getSince(sinceSeq) {
+        const linesAvailable = this.count;
+        const oldestSeq = this.seq - linesAvailable + 1;
+        const startSeq = Math.max(sinceSeq + 1, oldestSeq);
+        if (startSeq > this.seq)
+            return [];
+        const skip = startSeq - oldestSeq;
+        const result = [];
+        for (let i = skip; i < this.count; i++) {
+            result.push(this.buffer[(this.head + i) % this.capacity]);
+        }
+        if (this.partial) {
+            result.push(this.partial);
+        }
+        return result;
+    }
+    /** Current sequence number (last written). */
+    get currentSeq() {
+        return this.seq;
+    }
+    /** Number of lines currently stored. */
+    get size() {
+        return this.count;
+    }
+    /** Clear the buffer and release memory. */
+    clear() {
+        this.buffer = [];
+        this.head = 0;
+        this.count = 0;
+        this.partial = '';
+        // Don't reset seq — it should be monotonic
+    }
+}
+//# sourceMappingURL=ring-buffer.js.map

package/dist/terminal/ring-buffer.js.map

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

package/dist/terminal/session-manager.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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 { EventEmitter } from 'node:events';
+import { type IShepherdClient } from './shepherd-client.js';
+export interface SessionManagerConfig {
+    socketDir: string;
+    shepherdScript: string;
+    nodeExecutable: string;
+}
+export interface CreateSessionOptions {
+    sessionId: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    cols: number;
+    rows: number;
+    restartOnExit?: boolean;
+    restartDelay?: number;
+    maxRestarts?: number;
+    restartResetAfter?: number;
+}
+export interface ReconnectRestartOptions {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    restartDelay?: number;
+    maxRestarts?: number;
+    restartResetAfter?: number;
+}
+export declare class SessionManager extends EventEmitter {
+    private readonly config;
+    private sessions;
+    constructor(config: SessionManagerConfig);
+    /**
+     * Spawn a new shepherd process and connect to it.
+     * Returns the connected client.
+     */
+    createSession(opts: CreateSessionOptions): Promise<IShepherdClient>;
+    /**
+     * 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.
+     */
+    reconnectSession(sessionId: string, socketPath: string, pid: number, startTime: number, restartOptions?: ReconnectRestartOptions): Promise<IShepherdClient | null>;
+    /**
+     * Kill a session: SIGTERM, wait 5s, SIGKILL if needed.
+     * Cleans up socket file and removes from session map.
+     */
+    killSession(sessionId: string): Promise<void>;
+    /**
+     * List all active sessions.
+     */
+    listSessions(): Map<string, IShepherdClient>;
+    /**
+     * Get session metadata (pid, startTime, socketPath) for a session.
+     */
+    getSessionInfo(sessionId: string): {
+        pid: number;
+        startTime: number;
+        socketPath: string;
+    } | null;
+    /**
+     * 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.
+     */
+    cleanupStaleSockets(): Promise<number>;
+    /**
+     * Test if a Unix socket has a listener by attempting a brief connection.
+     * Returns true if connection succeeds, false if refused/timed out.
+     */
+    private probeSocket;
+    /**
+     * 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(): void;
+    /**
+     * 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.
+     */
+    private removeDeadSession;
+    private getSocketPath;
+    private unlinkSocketIfExists;
+    private readShepherdInfo;
+    private waitForSocket;
+    private isProcessAlive;
+    private waitForProcessExit;
+    private setupAutoRestart;
+    private startRestartResetTimer;
+}
+/**
+ * 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 declare function getProcessStartTime(pid: number): Promise<number | null>;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/terminal/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/terminal/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD,qBAAa,cAAe,SAAQ,YAAY;IAGlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAqC;gBAExB,MAAM,EAAE,oBAAoB;IAIzD;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiGzE;;;;OAIG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,uBAAuB,GACvC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAwFlC;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCnD;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAQ5C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAUhG;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IA+C5C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAahB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,sBAAsB;CAc/B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2DvE"}