devchain-cli 0.12.3 → 0.13.0

package/dist/server/modules/terminal/services/terminal-io/lifecycle.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSession = createSession;
+exports.destroySession = destroySession;
+exports.listSessions = listSessions;
+exports.sessionExists = sessionExists;
+exports.applyWindowTheme = applyWindowTheme;
+const STRICT_HEX_RE = /^#[0-9a-fA-F]{6}$/;
+function assertHexColor(color, field) {
+    if (!STRICT_HEX_RE.test(color)) {
+        throw new Error(`Invalid ${field}: "${color}" — must be a strict #RRGGBB hex color`);
+    }
+}
+function assertTmuxOptionApplied(result, target, optionName) {
+    if (result.success && !result.timedOut) {
+        return;
+    }
+    const reason = result.timedOut
+        ? 'timed out'
+        : result.stderr || `exit code ${result.exitCode ?? 'unknown'}`;
+    throw new Error(`Failed to apply tmux ${optionName} for session "${target.name}": ${reason}`);
+}
+async function createSession(executor, name, command, options) {
+    const createResult = await executor.run({
+        argv: ['tmux', 'new-session', '-d', '-s', name, '-c', options.cwd, ...command],
+        mode: 'pipe',
+        env: options.env ? { ...options.env } : undefined,
+    });
+    if (!createResult.success) {
+        throw new Error(`Failed to create tmux session "${name}": ${createResult.stderr}`);
+    }
+    await executor.run({
+        argv: ['tmux', 'set-option', '-t', name, 'status', 'off'],
+        mode: 'pipe',
+    });
+    await executor.run({
+        argv: ['tmux', 'set-option', '-s', 'set-clipboard', 'on'],
+        mode: 'pipe',
+    });
+    return { name };
+}
+async function destroySession(executor, target) {
+    const result = await executor.run({
+        argv: ['tmux', 'kill-session', '-t', `=${target.name}`],
+        mode: 'pipe',
+    });
+    if (!result.success) {
+        throw new Error(`Failed to destroy tmux session "${target.name}": ${result.stderr}`);
+    }
+}
+async function listSessions(executor) {
+    const result = await executor.run({
+        argv: ['tmux', 'list-sessions', '-F', '#{session_name}'],
+        mode: 'pipe',
+    });
+    if (!result.success) {
+        return [];
+    }
+    return result.stdout
+        .trim()
+        .split('\n')
+        .filter((name) => name.startsWith('devchain_'))
+        .map((name) => ({ name }));
+}
+async function sessionExists(executor, target) {
+    const result = await executor.run({
+        argv: ['tmux', 'has-session', '-t', `=${target.name}`],
+        mode: 'pipe',
+    });
+    return result.success;
+}
+async function applyWindowTheme(executor, target, foreground, background) {
+    assertHexColor(foreground, 'foreground');
+    assertHexColor(background, 'background');
+    const style = `fg=${foreground},bg=${background}`;
+    const windowStyleResult = await executor.run({
+        argv: ['tmux', 'set-window-option', '-t', `=${target.name}:`, 'window-style', style],
+        mode: 'pipe',
+    });
+    assertTmuxOptionApplied(windowStyleResult, target, 'window-style');
+    const activeStyleResult = await executor.run({
+        argv: ['tmux', 'set-window-option', '-t', `=${target.name}:`, 'window-active-style', style],
+        mode: 'pipe',
+    });
+    assertTmuxOptionApplied(activeStyleResult, target, 'window-active-style');
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/server/modules/terminal/services/terminal-io/lifecycle.js.map

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

package/dist/server/modules/terminal/services/terminal-io/monitoring.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessExecutor } from '../process-executor/process-executor.port';
+import type { SessionTarget, HealthResult, WaitForOutputOptions } from './types';
+export declare function healthCheck(executor: ProcessExecutor, target: SessionTarget): Promise<HealthResult>;
+export declare function waitForOutput(executor: ProcessExecutor, target: SessionTarget, predicate: (output: string) => boolean, options?: WaitForOutputOptions): Promise<boolean>;

package/dist/server/modules/terminal/services/terminal-io/monitoring.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthCheck = healthCheck;
+exports.waitForOutput = waitForOutput;
+const capture_1 = require("./capture");
+async function healthCheck(executor, target) {
+    const result = await executor.run({
+        argv: ['tmux', 'has-session', '-t', `=${target.name}`],
+        mode: 'pipe',
+    });
+    return { alive: result.success };
+}
+async function waitForOutput(executor, target, predicate, options) {
+    const pollIntervalMs = Math.max(1, Math.floor(options?.pollIntervalMs ?? 500));
+    const timeoutMs = Math.max(1, Math.floor(options?.timeoutMs ?? 30_000));
+    const settleMs = Math.max(0, Math.floor(options?.settleMs ?? 1_000));
+    const lines = Math.max(1, Math.floor(options?.lines ?? 150));
+    const startedAt = Date.now();
+    const baselineResult = await (0, capture_1.captureHistory)(executor, target, lines, false);
+    let previous = baselineResult.output;
+    let skipFirstPoll = true;
+    let outputDetected = false;
+    let lastContentChangeAt = 0;
+    while (true) {
+        await new Promise((resolve) => {
+            setTimeout(resolve, pollIntervalMs);
+        });
+        const elapsedAfterSleep = Date.now() - startedAt;
+        if (elapsedAfterSleep >= timeoutMs) {
+            return false;
+        }
+        const currentResult = await (0, capture_1.captureHistory)(executor, target, lines, false);
+        const current = currentResult.output;
+        if (current === '' && previous !== '') {
+            continue;
+        }
+        if (predicate(current)) {
+            return true;
+        }
+        if (skipFirstPoll) {
+            skipFirstPoll = false;
+            previous = current;
+            continue;
+        }
+        if (!outputDetected) {
+            const hasNonEmptyChange = current !== baselineResult.output && current.trim().length > 0;
+            if (hasNonEmptyChange) {
+                outputDetected = true;
+                lastContentChangeAt = Date.now();
+            }
+            previous = current;
+            continue;
+        }
+        if (current !== previous) {
+            previous = current;
+            lastContentChangeAt = Date.now();
+            continue;
+        }
+        const settledForMs = Date.now() - lastContentChangeAt;
+        if (settledForMs >= settleMs) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=monitoring.js.map

package/dist/server/modules/terminal/services/terminal-io/monitoring.js.map

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

package/dist/server/modules/terminal/services/terminal-io/quote-shell-arg.d.ts

@@ -0,0 +1 @@
+export declare function quoteShellArg(arg: string): string;

package/dist/server/modules/terminal/services/terminal-io/quote-shell-arg.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteShellArg = quoteShellArg;
+function quoteShellArg(arg) {
+    if (arg.length === 0)
+        return "''";
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=quote-shell-arg.js.map

package/dist/server/modules/terminal/services/terminal-io/quote-shell-arg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-shell-arg.js","sourceRoot":"","sources":["../../../../../src/modules/terminal/services/terminal-io/quote-shell-arg.ts"],"names":[],"mappings":";;AAAA,sCAGC;AAHD,SAAgB,aAAa,CAAC,GAAW;IACvC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC3C,CAAC"}

package/dist/server/modules/terminal/services/terminal-io/terminal-io.service.d.ts

@@ -0,0 +1,35 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { EventsService } from '../../../events/services/events.service';
+import { ProcessExecutor } from '../process-executor/process-executor.port';
+import type { SessionTarget, CreateSessionOptions, CaptureResult, CursorPosition, HealthResult, WaitForOutputOptions, DeliveryOptions, DeliveryResult } from './types';
+export declare class TerminalIOService implements OnModuleDestroy {
+    private readonly executor;
+    private readonly eventsService;
+    private readonly gap;
+    private readonly healthCheckIntervals;
+    constructor(executor: ProcessExecutor, eventsService: EventsService);
+    onModuleDestroy(): void;
+    createSession(name: string, command: string[], options: CreateSessionOptions): Promise<SessionTarget>;
+    destroySession(target: SessionTarget): Promise<void>;
+    listSessions(): Promise<SessionTarget[]>;
+    sessionExists(target: SessionTarget): Promise<boolean>;
+    createEmptySession(name: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<SessionTarget>;
+    disableAlternateScreen(target: SessionTarget): Promise<void>;
+    applyWindowTheme(target: SessionTarget, foreground: string, background: string): Promise<void>;
+    typeCommand(target: SessionTarget, argv: string[]): Promise<void>;
+    listAllSessionNames(): Promise<Set<string>>;
+    captureHistory(target: SessionTarget, lines?: number, includeEscapes?: boolean): Promise<CaptureResult>;
+    captureStrict(target: SessionTarget, tailLines?: number): Promise<CaptureResult>;
+    getCursorPosition(target: SessionTarget): Promise<CursorPosition | null>;
+    getSessionCwd(target: SessionTarget): Promise<string | null>;
+    waitForOutput(target: SessionTarget, predicate: (output: string) => boolean, options?: WaitForOutputOptions): Promise<boolean>;
+    healthCheck(target: SessionTarget): Promise<HealthResult>;
+    startHealthCheck(sessionName: string, sessionId: string, intervalMs?: number): void;
+    stopHealthCheck(sessionName: string): void;
+    deliver(target: SessionTarget, text: string, options: DeliveryOptions): Promise<DeliveryResult>;
+    deliverImmediate(target: SessionTarget, text: string, options: Omit<DeliveryOptions, 'agentId'>): Promise<DeliveryResult>;
+    sendControl(target: SessionTarget, keys: readonly string[]): Promise<void>;
+}

package/dist/server/modules/terminal/services/terminal-io/terminal-io.service.js

@@ -0,0 +1,210 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalIOService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../../common/logging/logger");
+const events_service_1 = require("../../../events/services/events.service");
+const process_executor_port_1 = require("../process-executor/process-executor.port");
+const lifecycle = __importStar(require("./lifecycle"));
+const capture = __importStar(require("./capture"));
+const monitoring = __importStar(require("./monitoring"));
+const deliveryMod = __importStar(require("./delivery"));
+const delivery_1 = require("./delivery");
+const quote_shell_arg_1 = require("./quote-shell-arg");
+const logger = (0, logger_1.createLogger)('TerminalIOService');
+let TerminalIOService = class TerminalIOService {
+    constructor(executor, eventsService) {
+        this.executor = executor;
+        this.eventsService = eventsService;
+        this.healthCheckIntervals = new Map();
+        this.gap = new InMemorySendGap();
+    }
+    onModuleDestroy() {
+        for (const interval of this.healthCheckIntervals.values()) {
+            clearInterval(interval);
+        }
+        this.healthCheckIntervals.clear();
+    }
+    async createSession(name, command, options) {
+        return lifecycle.createSession(this.executor, name, command, options);
+    }
+    async destroySession(target) {
+        return lifecycle.destroySession(this.executor, target);
+    }
+    async listSessions() {
+        return lifecycle.listSessions(this.executor);
+    }
+    async sessionExists(target) {
+        return lifecycle.sessionExists(this.executor, target);
+    }
+    async createEmptySession(name, options) {
+        return lifecycle.createSession(this.executor, name, [], {
+            cwd: options?.cwd ?? process.cwd(),
+            env: options?.env,
+        });
+    }
+    async disableAlternateScreen(target) {
+        await this.executor.run({
+            argv: ['tmux', 'set-window-option', '-t', `=${target.name}`, 'alternate-screen', 'off'],
+            mode: 'pipe',
+        });
+    }
+    async applyWindowTheme(target, foreground, background) {
+        return lifecycle.applyWindowTheme(this.executor, target, foreground, background);
+    }
+    async typeCommand(target, argv) {
+        if (!argv.length)
+            throw new Error('Attempted to send empty argv command');
+        await this.gap.ensureGap(target.name);
+        const commandString = argv.map(quote_shell_arg_1.quoteShellArg).join(' ');
+        const literalResult = await this.executor.run({
+            argv: ['tmux', 'send-keys', '-t', `=${target.name}:`, '-l', '--', commandString],
+            mode: 'pipe',
+        });
+        if (!literalResult.success || literalResult.timedOut) {
+            throw new delivery_1.TypeCommandFailedError(target.name, 'literal', literalResult.timedOut
+                ? 'timed out'
+                : literalResult.stderr || `exit code ${literalResult.exitCode}`);
+        }
+        const enterResult = await this.executor.run({
+            argv: ['tmux', 'send-keys', '-t', `=${target.name}:`, 'Enter'],
+            mode: 'pipe',
+        });
+        if (!enterResult.success || enterResult.timedOut) {
+            throw new delivery_1.TypeCommandFailedError(target.name, 'enter', enterResult.timedOut
+                ? 'timed out'
+                : enterResult.stderr || `exit code ${enterResult.exitCode}`);
+        }
+    }
+    async listAllSessionNames() {
+        const result = await this.executor.run({
+            argv: ['tmux', 'list-sessions', '-F', '#{session_name}'],
+            mode: 'pipe',
+        });
+        if (!result.success)
+            return new Set();
+        return new Set(result.stdout.split('\n').filter(Boolean));
+    }
+    async captureHistory(target, lines = 2000, includeEscapes = true) {
+        return capture.captureHistory(this.executor, target, lines, includeEscapes);
+    }
+    async captureStrict(target, tailLines = 10) {
+        return capture.captureStrict(this.executor, target, tailLines);
+    }
+    async getCursorPosition(target) {
+        return capture.getCursorPosition(this.executor, target);
+    }
+    async getSessionCwd(target) {
+        return capture.getSessionCwd(this.executor, target);
+    }
+    async waitForOutput(target, predicate, options) {
+        return monitoring.waitForOutput(this.executor, target, predicate, options);
+    }
+    async healthCheck(target) {
+        return monitoring.healthCheck(this.executor, target);
+    }
+    startHealthCheck(sessionName, sessionId, intervalMs = 5000) {
+        this.stopHealthCheck(sessionName);
+        const interval = setInterval(async () => {
+            try {
+                const result = await this.healthCheck({ name: sessionName });
+                if (!result.alive) {
+                    logger.warn({ sessionName, sessionId }, 'Tmux session lost - emitting crashed event');
+                    await this.eventsService.publish('session.crashed', { sessionId, sessionName });
+                    this.stopHealthCheck(sessionName);
+                }
+            }
+            catch (error) {
+                logger.error({ sessionName, sessionId, error: String(error) }, 'Health check failed');
+            }
+        }, intervalMs);
+        this.healthCheckIntervals.set(sessionName, interval);
+        logger.info({ sessionName, intervalMs }, 'Started health check');
+    }
+    stopHealthCheck(sessionName) {
+        const interval = this.healthCheckIntervals.get(sessionName);
+        if (interval) {
+            clearInterval(interval);
+            this.healthCheckIntervals.delete(sessionName);
+            logger.info({ sessionName }, 'Stopped health check');
+        }
+    }
+    async deliver(target, text, options) {
+        return deliveryMod.deliver(this.executor, this.gap, target, text, options);
+    }
+    async deliverImmediate(target, text, options) {
+        return deliveryMod.deliverImmediate(this.executor, target, text, options);
+    }
+    async sendControl(target, keys) {
+        return deliveryMod.sendControl(this.executor, target, keys);
+    }
+};
+exports.TerminalIOService = TerminalIOService;
+exports.TerminalIOService = TerminalIOService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [process_executor_port_1.ProcessExecutor,
+        events_service_1.EventsService])
+], TerminalIOService);
+class InMemorySendGap {
+    constructor() {
+        this.lastByAgent = new Map();
+        this.tailByAgent = new Map();
+    }
+    async ensureGap(agentId, minMs = 500) {
+        const prev = this.tailByAgent.get(agentId) ?? Promise.resolve();
+        const next = prev.then(async () => {
+            const now = Date.now();
+            const last = this.lastByAgent.get(agentId) ?? 0;
+            const delta = now - last;
+            if (delta < minMs) {
+                await new Promise((r) => setTimeout(r, minMs - delta));
+            }
+            this.lastByAgent.set(agentId, Date.now());
+        });
+        this.tailByAgent.set(agentId, next.catch(() => { }));
+        return next;
+    }
+}
+//# sourceMappingURL=terminal-io.service.js.map

package/dist/server/modules/terminal/services/terminal-io/terminal-io.service.js.map

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

package/dist/server/modules/terminal/services/terminal-io/types.d.ts

@@ -0,0 +1,42 @@
+export interface SessionTarget {
+    readonly name: string;
+}
+export interface CreateSessionOptions {
+    readonly cwd: string;
+    readonly env?: Readonly<Record<string, string>>;
+}
+export interface CaptureResult {
+    readonly ok: boolean;
+    readonly output: string;
+    readonly error?: string;
+}
+export interface CursorPosition {
+    readonly x: number;
+    readonly y: number;
+}
+export interface HealthResult {
+    readonly alive: boolean;
+}
+export interface WaitForOutputOptions {
+    readonly pollIntervalMs?: number;
+    readonly timeoutMs?: number;
+    readonly settleMs?: number;
+    readonly lines?: number;
+}
+export interface DeliveryOptions {
+    readonly agentId: string;
+    readonly bracketed?: boolean;
+    readonly submitKeys?: readonly string[];
+    readonly preKeys?: readonly string[];
+    readonly preDelayMs?: number;
+    readonly postPasteDelayMs?: number;
+    readonly confirm?: boolean;
+    readonly confirmTimeoutMs?: number;
+    readonly maxAttempts?: number;
+}
+export interface DeliveryResult {
+    readonly confirmed: boolean;
+    readonly nonce: string;
+    readonly retryCount: number;
+    readonly method?: 'nonce' | 'paste_indicator' | 'paste_changed';
+}

package/dist/server/modules/terminal/services/terminal-io/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/server/modules/terminal/services/terminal-io/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/terminal/services/terminal-io/types.ts"],"names":[],"mappings":""}

package/dist/server/modules/terminal/services/terminal-registry-rehydrator.service.d.ts

@@ -0,0 +1,11 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { SessionsService } from '../../sessions/services/sessions.service';
+import { TerminalSessionRegistry } from './terminal-session/terminal-session-registry';
+import { TerminalIOService } from './terminal-io/terminal-io.service';
+export declare class TerminalRegistryRehydrator implements OnApplicationBootstrap {
+    private readonly sessionsService;
+    private readonly registry;
+    private readonly terminalIO;
+    constructor(sessionsService: SessionsService, registry: TerminalSessionRegistry, terminalIO: TerminalIOService);
+    onApplicationBootstrap(): Promise<void>;
+}

package/dist/server/modules/terminal/services/terminal-registry-rehydrator.service.js

@@ -0,0 +1,63 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalRegistryRehydrator = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../../common/logging/logger");
+const sessions_service_1 = require("../../sessions/services/sessions.service");
+const terminal_session_registry_1 = require("./terminal-session/terminal-session-registry");
+const terminal_io_service_1 = require("./terminal-io/terminal-io.service");
+const logger = (0, logger_1.createLogger)('TerminalRegistryRehydrator');
+let TerminalRegistryRehydrator = class TerminalRegistryRehydrator {
+    constructor(sessionsService, registry, terminalIO) {
+        this.sessionsService = sessionsService;
+        this.registry = registry;
+        this.terminalIO = terminalIO;
+    }
+    async onApplicationBootstrap() {
+        const metas = this.sessionsService.listRunningSessionMetas();
+        if (metas.length === 0)
+            return;
+        logger.info({ count: metas.length }, 'Rehydrating terminal session registry');
+        for (const meta of metas) {
+            if (this.registry.get(meta.sessionId))
+                continue;
+            const alive = await this.terminalIO.sessionExists({ name: meta.tmuxSessionName });
+            if (!alive) {
+                logger.warn({ sessionId: meta.sessionId, tmuxSessionName: meta.tmuxSessionName }, 'Dead tmux orphan at bootstrap — marking session failed');
+                this.sessionsService.markSessionFailed(meta.sessionId, 'tmux session no longer exists at bootstrap');
+                continue;
+            }
+            try {
+                this.registry.create(meta.sessionId, meta.tmuxSessionName, {
+                    normalizeCapturedLineEndings: this.sessionsService.shouldNormalizeLfFor(meta.sessionId),
+                });
+                this.registry.bind(meta.sessionId, this.terminalIO);
+                logger.info({ sessionId: meta.sessionId, tmuxSessionName: meta.tmuxSessionName }, 'Rehydrated registry entry');
+            }
+            catch {
+                logger.debug({ sessionId: meta.sessionId }, 'Concurrent rehydration; entry already exists');
+            }
+        }
+    }
+};
+exports.TerminalRegistryRehydrator = TerminalRegistryRehydrator;
+exports.TerminalRegistryRehydrator = TerminalRegistryRehydrator = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)((0, common_1.forwardRef)(() => sessions_service_1.SessionsService))),
+    __metadata("design:paramtypes", [sessions_service_1.SessionsService,
+        terminal_session_registry_1.TerminalSessionRegistry,
+        terminal_io_service_1.TerminalIOService])
+], TerminalRegistryRehydrator);
+//# sourceMappingURL=terminal-registry-rehydrator.service.js.map

package/dist/server/modules/terminal/services/terminal-registry-rehydrator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-registry-rehydrator.service.js","sourceRoot":"","sources":["../../../../src/modules/terminal/services/terminal-registry-rehydrator.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwF;AACxF,2DAA8D;AAC9D,+EAA2E;AAC3E,4FAAuF;AACvF,2EAAsE;AAEtE,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,4BAA4B,CAAC,CAAC;AAGnD,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAEmB,eAAgC,EAChC,QAAiC,EACjC,UAA6B;QAF7B,oBAAe,GAAf,eAAe,CAAiB;QAChC,aAAQ,GAAR,QAAQ,CAAyB;QACjC,eAAU,GAAV,UAAU,CAAmB;IAC7C,CAAC;IAEJ,KAAK,CAAC,sBAAsB;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,uBAAuB,EAAE,CAAC;QAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE/B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAE9E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,SAAS;YAEhD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CACT,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EACpE,wDAAwD,CACzD,CAAC;gBACF,IAAI,CAAC,eAAe,CAAC,iBAAiB,CACpC,IAAI,CAAC,SAAS,EACd,4CAA4C,CAC7C,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE;oBACzD,4BAA4B,EAAE,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;iBACxF,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpD,MAAM,CAAC,IAAI,CACT,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,EACpE,2BAA2B,CAC5B,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,8CAA8C,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AA5CY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,kCAAe,CAAC,CAAC,CAAA;qCACR,kCAAe;QACtB,mDAAuB;QACrB,uCAAiB;GALrC,0BAA0B,CA4CtC"}

package/dist/server/modules/terminal/services/terminal-seed.service.d.ts

@@ -1,15 +1,17 @@
-import { ModuleRef } from '@nestjs/core';
 import { Socket } from 'socket.io';
 import { SettingsService } from '../../settings/services/settings.service';
-import { PtyService } from './pty.service';
+import { TerminalIOService } from './terminal-io/terminal-io.service';
+import { SessionsService } from '../../sessions/services/sessions.service';
+import { TerminalSessionRegistry } from './terminal-session/terminal-session-registry';
 export declare class TerminalSeedService {
     private readonly settingsService;
-    private readonly ptyService;
-    private readonly moduleRef;
+    private readonly terminalSessionRegistry;
+    private readonly terminalIO;
+    private readonly sessionsService;
     private readonly captureCache;
     private readonly CAPTURE_CACHE_TTL;
     private readonly SEED_CHUNK_SIZE;
-    constructor(settingsService: SettingsService, ptyService: PtyService, moduleRef: ModuleRef);
+    constructor(settingsService: SettingsService, terminalSessionRegistry: TerminalSessionRegistry, terminalIO: TerminalIOService, sessionsService: SessionsService);
     resolveSeedingConfig(): {
         maxBytes: number;
     };