@cats-inc/cats-platform 0.1.0

package/build/server/products/code/livePreview/realProcessAdapter.d.ts

@@ -0,0 +1,41 @@
+import { spawn } from 'node:child_process';
+import type { LivePreviewProcessAdapter } from './processAdapter.js';
+type SpawnProcess = typeof spawn;
+export interface RealLivePreviewProcessAdapterOptions {
+    /**
+     * Test seam only. Production callers should use the default node
+     * child_process.spawn implementation.
+     */
+    spawnProcess?: SpawnProcess;
+    /**
+     * Test seam for exercising Windows tree-kill behavior on non-Windows CI.
+     */
+    platform?: NodeJS.Platform;
+}
+/**
+ * Real subprocess adapter for Cats Code live previews (PLAN-097 Task 5.3).
+ *
+ * SECURITY POSTURE
+ * - The adapter is **only** instantiated by the supervisor when the operator
+ *   has flipped `livePreview.enabled = true` AND
+ *   `livePreview.useRealProcessAdapter = true` AND has registered an
+ *   approved command profile (start with `VITE_LIVE_PREVIEW_PROFILE`).
+ * - Profile validation (`validateLivePreviewCommandProfile`) has already
+ *   rejected raw shell strings, unsupported placeholders, and shell
+ *   metacharacters before any input reaches this module.
+ * - The adapter never invokes a shell. `child_process.spawn` is called
+ *   with `shell: false` and a fixed executable plus argv array.
+ * - Stdout/stderr capture is line-bounded by the supervisor; this adapter
+ *   only forwards chunks. The supervisor enforces `logMaxBytes`.
+ * - On stop, SIGTERM is sent first; if the process has not exited within
+ *   `graceMs`, SIGKILL is escalated. `killProcessTree` triggers a graceful
+ *   `taskkill /T` on Windows or a process-group SIGTERM on POSIX first, then
+ *   `taskkill /T /F` or process-group SIGKILL on escalation.
+ *
+ * Operators enabling the real adapter must complete PLAN-097 Task 5.1
+ * security review and Task 5.4 end-to-end validation in an isolated temp
+ * workspace before pointing this at user dev state.
+ */
+export declare function createRealLivePreviewProcessAdapter(options?: RealLivePreviewProcessAdapterOptions): LivePreviewProcessAdapter;
+export {};
+//# sourceMappingURL=realProcessAdapter.d.ts.map

package/build/server/products/code/livePreview/realProcessAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realProcessAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/products/code/livePreview/realProcessAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EACV,yBAAyB,EAK1B,MAAM,qBAAqB,CAAC;AAE7B,KAAK,YAAY,GAAG,OAAO,KAAK,CAAC;AAEjC,MAAM,WAAW,oCAAoC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAOD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,GAAE,oCAAyC,GACjD,yBAAyB,CAkB3B"}

package/build/server/products/code/livePreview/realProcessAdapter.js

@@ -0,0 +1,220 @@
+import { spawn } from 'node:child_process';
+/**
+ * Real subprocess adapter for Cats Code live previews (PLAN-097 Task 5.3).
+ *
+ * SECURITY POSTURE
+ * - The adapter is **only** instantiated by the supervisor when the operator
+ *   has flipped `livePreview.enabled = true` AND
+ *   `livePreview.useRealProcessAdapter = true` AND has registered an
+ *   approved command profile (start with `VITE_LIVE_PREVIEW_PROFILE`).
+ * - Profile validation (`validateLivePreviewCommandProfile`) has already
+ *   rejected raw shell strings, unsupported placeholders, and shell
+ *   metacharacters before any input reaches this module.
+ * - The adapter never invokes a shell. `child_process.spawn` is called
+ *   with `shell: false` and a fixed executable plus argv array.
+ * - Stdout/stderr capture is line-bounded by the supervisor; this adapter
+ *   only forwards chunks. The supervisor enforces `logMaxBytes`.
+ * - On stop, SIGTERM is sent first; if the process has not exited within
+ *   `graceMs`, SIGKILL is escalated. `killProcessTree` triggers a graceful
+ *   `taskkill /T` on Windows or a process-group SIGTERM on POSIX first, then
+ *   `taskkill /T /F` or process-group SIGKILL on escalation.
+ *
+ * Operators enabling the real adapter must complete PLAN-097 Task 5.1
+ * security review and Task 5.4 end-to-end validation in an isolated temp
+ * workspace before pointing this at user dev state.
+ */
+export function createRealLivePreviewProcessAdapter(options = {}) {
+    const runtime = {
+        spawnProcess: options.spawnProcess ?? spawn,
+        platform: options.platform ?? process.platform,
+    };
+    return {
+        spawn(input) {
+            const child = runtime.spawnProcess(input.executable, input.args, {
+                cwd: input.cwd,
+                env: { ...process.env, ...input.env, PORT: String(input.port) },
+                shell: false,
+                windowsHide: true,
+                detached: runtime.platform !== 'win32',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            return waitForSpawn(child, runtime);
+        },
+    };
+}
+function waitForSpawn(child, runtime) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const onError = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            child.removeListener('spawn', onSpawn);
+            reject(error);
+        };
+        const onSpawn = () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            child.removeListener('error', onError);
+            resolve(wrapChildProcess(child, runtime));
+        };
+        child.once('error', onError);
+        child.once('spawn', onSpawn);
+    });
+}
+function wrapChildProcess(child, runtime) {
+    const stdoutListeners = new Set();
+    const stderrListeners = new Set();
+    const exitListeners = new Set();
+    let exited = false;
+    let lastExit = null;
+    const recordExit = (exit) => {
+        if (exited) {
+            return;
+        }
+        exited = true;
+        lastExit = exit;
+        for (const listener of exitListeners) {
+            listener(exit);
+        }
+        exitListeners.clear();
+    };
+    child.stdout?.setEncoding('utf-8');
+    child.stderr?.setEncoding('utf-8');
+    child.stdout?.on('data', (chunk) => {
+        for (const listener of stdoutListeners) {
+            listener(chunk);
+        }
+    });
+    child.stderr?.on('data', (chunk) => {
+        for (const listener of stderrListeners) {
+            listener(chunk);
+        }
+    });
+    child.on('exit', (code, signal) => {
+        recordExit({ code, signal });
+    });
+    // Once spawn has succeeded, runtime errors from the child process should
+    // not crash the host. Surface them as an exit if the child has not already
+    // emitted one.
+    child.on('error', (error) => {
+        void error;
+        recordExit({ code: null, signal: null });
+    });
+    return {
+        processId: child.pid ?? null,
+        onStdout(listener) {
+            stdoutListeners.add(listener);
+        },
+        onStderr(listener) {
+            stderrListeners.add(listener);
+        },
+        onExit(listener) {
+            // Late subscribers (registered after the child has already exited)
+            // must still observe the terminal event. Without this the supervisor
+            // could miss the `process_exited` signal for short-lived processes
+            // that exit between spawn-promise resolve and `onExit` registration,
+            // and would only later notice via readiness timeout.
+            if (exited && lastExit) {
+                listener(lastExit);
+                return;
+            }
+            exitListeners.add(listener);
+        },
+        async stop(options) {
+            if (exited) {
+                return;
+            }
+            await terminateChildProcess(child, options, runtime);
+        },
+    };
+}
+async function terminateChildProcess(child, options, runtime) {
+    trySendSignal(child, 'SIGTERM', options.killProcessTree, /* force */ false, runtime);
+    await new Promise((resolve) => {
+        if (child.exitCode !== null || child.signalCode) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            trySendSignal(child, 'SIGKILL', options.killProcessTree, /* force */ true, runtime);
+            resolve();
+        }, Math.max(0, options.graceMs));
+        child.once('exit', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+}
+function trySendSignal(child, signal, killProcessTree, force, runtime) {
+    try {
+        if (!killProcessTree || child.pid === undefined) {
+            child.kill(signal);
+            return;
+        }
+        if (runtime.platform === 'win32') {
+            tryTaskkill(child, signal, force, runtime);
+            return;
+        }
+        try {
+            process.kill(-child.pid, signal);
+        }
+        catch {
+            child.kill(signal);
+        }
+    }
+    catch {
+        // child has already exited; nothing to signal
+    }
+}
+function tryTaskkill(child, fallbackSignal, force, runtime) {
+    if (child.pid === undefined) {
+        child.kill(fallbackSignal);
+        return;
+    }
+    // Honour the documented stop contract: graceful first (taskkill /T sends
+    // WM_CLOSE / Ctrl+Break-style termination to the tree without /F so
+    // children can run their shutdown handlers), then escalate to /F on
+    // SIGKILL when the grace period expires.
+    const args = force
+        ? ['/pid', String(child.pid), '/T', '/F']
+        : ['/pid', String(child.pid), '/T'];
+    try {
+        const tree = runtime.spawnProcess('taskkill', args, {
+            windowsHide: true,
+            stdio: 'ignore',
+        });
+        // Swallow taskkill's own error events so a missing taskkill (extremely
+        // unlikely on Windows) does not crash the host. Direct kill fallback only
+        // runs in the force phase so graceful failures still respect `graceMs`.
+        tree.once('error', () => {
+            fallbackFromTaskkillFailure(child, fallbackSignal, force);
+        });
+        tree.once('exit', (code) => {
+            if (code !== 0) {
+                fallbackFromTaskkillFailure(child, fallbackSignal, force);
+            }
+        });
+    }
+    catch {
+        fallbackFromTaskkillFailure(child, fallbackSignal, force);
+    }
+}
+function fallbackFromTaskkillFailure(child, fallbackSignal, force) {
+    if (!force) {
+        // Preserve the grace window. If graceful tree termination fails, the stop
+        // timer will escalate and retry with `/F` before we fall back to direct
+        // process kill.
+        return;
+    }
+    try {
+        child.kill(fallbackSignal);
+    }
+    catch {
+        // child already gone
+    }
+}
+//# sourceMappingURL=realProcessAdapter.js.map

package/build/server/products/code/livePreview/realProcessAdapter.js.map

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

package/build/server/products/code/livePreview/supervisor.d.ts

@@ -0,0 +1,36 @@
+import { type LivePreviewConfig, type LivePreviewLease, type LivePreviewStartResult, type LivePreviewStopResult } from './contracts.js';
+import { type LivePreviewProcessAdapter, type LivePreviewReadinessProbe } from './processAdapter.js';
+export interface LivePreviewSupervisorOptions {
+    config?: LivePreviewConfig;
+    processAdapter: LivePreviewProcessAdapter;
+    readinessProbe?: LivePreviewReadinessProbe;
+    now?: () => Date;
+    sleep?: (ms: number) => Promise<void>;
+    idFactory?: () => string;
+}
+export declare class LivePreviewSupervisor {
+    private readonly config;
+    private readonly processAdapter;
+    private readonly readinessProbe;
+    private readonly now;
+    private readonly sleep;
+    private readonly idFactory;
+    private readonly previews;
+    private readonly leasedPorts;
+    constructor(options: LivePreviewSupervisorOptions);
+    getLease(previewId: string): LivePreviewLease | null;
+    readLogs(previewId: string): string | null;
+    listLeases(): LivePreviewLease[];
+    start(input: unknown): Promise<LivePreviewStartResult>;
+    stop(previewId: string, reason?: string): Promise<LivePreviewStopResult>;
+    expireLeases(now?: Date): Promise<string[]>;
+    private activePreviews;
+    private allocatePort;
+    private releasePort;
+    private attachProcessListeners;
+    private handleProcessExit;
+    private appendLog;
+    private waitForReadiness;
+    private markStopped;
+}
+//# sourceMappingURL=supervisor.d.ts.map

package/build/server/products/code/livePreview/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../../../src/products/code/livePreview/supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAGtB,KAAK,gBAAgB,EAErB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,yBAAyB,EAI9B,KAAK,yBAAyB,EAE/B,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,EAAE,yBAAyB,CAAC;IAC1C,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAWD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,OAAO,EAAE,4BAA4B;IAUjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIpD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI1C,UAAU,IAAI,gBAAgB,EAAE;IAI1B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4FtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwCjF,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe7D,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,SAAS;YAOH,gBAAgB;IA6C9B,OAAO,CAAC,WAAW;CAUpB"}

package/build/server/products/code/livePreview/supervisor.js

@@ -0,0 +1,273 @@
+import { DEFAULT_LIVE_PREVIEW_CONFIG, } from './contracts.js';
+import { fetchLivePreviewReadiness, } from './processAdapter.js';
+import { validateLivePreviewConfig, validateLivePreviewStartRequest, } from './profileValidation.js';
+const ACTIVE_STATUSES = new Set(['ready', 'starting']);
+export class LivePreviewSupervisor {
+    config;
+    processAdapter;
+    readinessProbe;
+    now;
+    sleep;
+    idFactory;
+    previews = new Map();
+    leasedPorts = new Set();
+    constructor(options) {
+        this.config = options.config ?? DEFAULT_LIVE_PREVIEW_CONFIG;
+        validateLivePreviewConfig(this.config);
+        this.processAdapter = options.processAdapter;
+        this.readinessProbe = options.readinessProbe ?? fetchLivePreviewReadiness;
+        this.now = options.now ?? (() => new Date());
+        this.sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.idFactory = options.idFactory ?? createPreviewId;
+    }
+    getLease(previewId) {
+        return this.previews.get(previewId)?.lease ?? null;
+    }
+    readLogs(previewId) {
+        return this.previews.get(previewId)?.logs ?? null;
+    }
+    listLeases() {
+        return [...this.previews.values()].map((preview) => preview.lease);
+    }
+    async start(input) {
+        const validation = validateLivePreviewStartRequest(input, this.config);
+        if (validation.status === 'rejected') {
+            return validation;
+        }
+        const activeGlobal = this.activePreviews().length;
+        if (activeGlobal >= this.config.maxConcurrentGlobal) {
+            return rejected('live_preview_concurrency_limit_exceeded', 'Global Cats Code live-preview concurrency limit reached.');
+        }
+        const activeWorkspace = this.activePreviews().filter((preview) => preview.lease.workspaceRef.id === validation.request.workspace.id).length;
+        if (activeWorkspace >= this.config.maxConcurrentPerWorkspace) {
+            return rejected('live_preview_concurrency_limit_exceeded', 'Workspace Cats Code live-preview concurrency limit reached.');
+        }
+        const port = this.allocatePort();
+        if (port === null) {
+            return rejected('live_preview_port_unavailable', 'No Cats Code live-preview ports are available.');
+        }
+        const previewId = this.idFactory();
+        const startedAt = this.now();
+        const host = this.config.allowIpv6Loopback ? '[::1]' : '127.0.0.1';
+        const origin = `http://${host}:${port}`;
+        const lease = {
+            previewId,
+            commandProfileId: validation.profile.id,
+            surface: validation.request.surface,
+            workspaceRef: validation.request.workspace,
+            origin,
+            host,
+            port,
+            processId: null,
+            status: 'starting',
+            logPath: `live-preview/${previewId}.log`,
+            artifactId: null,
+            createdAt: startedAt.toISOString(),
+            readyAt: null,
+            expiresAt: new Date(startedAt.getTime() + this.config.defaultLeaseTtlMs).toISOString(),
+            stoppedAt: null,
+            stopReason: null,
+        };
+        const managed = {
+            lease,
+            profile: validation.profile,
+            handle: null,
+            logs: '',
+        };
+        this.previews.set(previewId, managed);
+        try {
+            const handle = await this.processAdapter.spawn(buildSpawnInput(validation.profile, validation.request.workspace.rootPath, port, origin));
+            managed.handle = handle;
+            lease.processId = handle.processId;
+            this.attachProcessListeners(managed, handle);
+        }
+        catch (error) {
+            lease.status = 'failed';
+            lease.stopReason = 'spawn_failed';
+            lease.stoppedAt = this.now().toISOString();
+            this.releasePort(port);
+            return rejected('live_preview_spawn_failed', error instanceof Error ? error.message : 'Live preview process failed to spawn.');
+        }
+        const readiness = await this.waitForReadiness(managed);
+        if (readiness.status === 'rejected') {
+            return readiness;
+        }
+        return {
+            status: 'accepted',
+            previewId,
+            origin,
+            artifactId: null,
+        };
+    }
+    async stop(previewId, reason = 'explicit_stop') {
+        const managed = this.previews.get(previewId);
+        if (!managed) {
+            return rejected('live_preview_not_found', `Live preview was not found: ${previewId}.`);
+        }
+        if (managed.lease.status === 'stopped' || managed.lease.status === 'expired') {
+            return {
+                status: 'accepted',
+                previewId,
+                stopReason: managed.lease.stopReason ?? reason,
+            };
+        }
+        if (managed.lease.status === 'failed') {
+            return {
+                status: 'accepted',
+                previewId,
+                stopReason: managed.lease.stopReason ?? 'failed',
+            };
+        }
+        managed.lease.status = 'stopping';
+        try {
+            await managed.handle?.stop({
+                graceMs: managed.profile.stop.graceMs,
+                killProcessTree: managed.profile.stop.killProcessTree,
+            });
+        }
+        catch (error) {
+            managed.lease.status = 'failed';
+            managed.lease.stopReason = 'stop_failed';
+            this.releasePort(managed.lease.port);
+            return rejected('live_preview_stop_failed', error instanceof Error ? error.message : 'Live preview process failed to stop.');
+        }
+        this.markStopped(managed, 'stopped', reason);
+        return { status: 'accepted', previewId, stopReason: reason };
+    }
+    async expireLeases(now = this.now()) {
+        const expired = [];
+        for (const managed of this.activePreviews()) {
+            if (Date.parse(managed.lease.expiresAt) > now.getTime()) {
+                continue;
+            }
+            const result = await this.stop(managed.lease.previewId, 'expired');
+            if (result.status === 'accepted') {
+                managed.lease.status = 'expired';
+                expired.push(managed.lease.previewId);
+            }
+        }
+        return expired;
+    }
+    activePreviews() {
+        return [...this.previews.values()].filter((preview) => ACTIVE_STATUSES.has(preview.lease.status));
+    }
+    allocatePort() {
+        for (let port = this.config.portRange.start; port <= this.config.portRange.end; port += 1) {
+            if (!this.leasedPorts.has(port)) {
+                this.leasedPorts.add(port);
+                return port;
+            }
+        }
+        return null;
+    }
+    releasePort(port) {
+        this.leasedPorts.delete(port);
+    }
+    attachProcessListeners(managed, handle) {
+        handle.onStdout((chunk) => {
+            this.appendLog(managed, chunk);
+        });
+        handle.onStderr((chunk) => {
+            this.appendLog(managed, chunk);
+        });
+        handle.onExit((exit) => {
+            this.handleProcessExit(managed, exit);
+        });
+    }
+    handleProcessExit(managed, exit) {
+        if (!ACTIVE_STATUSES.has(managed.lease.status)) {
+            return;
+        }
+        managed.lease.status = 'failed';
+        managed.lease.stopReason =
+            `process_exited:${exit.code ?? 'null'}:${exit.signal ?? 'null'}`;
+        managed.lease.stoppedAt = this.now().toISOString();
+        this.releasePort(managed.lease.port);
+    }
+    appendLog(managed, chunk) {
+        const next = `${managed.logs}${chunk}`;
+        managed.logs = next.length > this.config.logMaxBytes
+            ? next.slice(next.length - this.config.logMaxBytes)
+            : next;
+    }
+    async waitForReadiness(managed) {
+        const expectedStatus = managed.profile.readiness.expectedStatus ?? 200;
+        const attempts = Math.max(1, Math.ceil(managed.profile.readiness.timeoutMs / managed.profile.readiness.intervalMs));
+        const probeUrl = `${managed.lease.origin}${managed.profile.readiness.path}`;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            if (managed.lease.status === 'failed') {
+                return rejected('live_preview_process_exited', 'Live preview process exited before readiness.');
+            }
+            try {
+                const result = await this.readinessProbe(probeUrl);
+                if (result.status === expectedStatus) {
+                    managed.lease.status = 'ready';
+                    managed.lease.readyAt = this.now().toISOString();
+                    return {
+                        status: 'accepted',
+                        previewId: managed.lease.previewId,
+                        origin: managed.lease.origin,
+                        artifactId: managed.lease.artifactId,
+                    };
+                }
+            }
+            catch {
+                // Retry until the readiness budget is exhausted.
+            }
+            await this.sleep(managed.profile.readiness.intervalMs);
+        }
+        await managed.handle?.stop({
+            graceMs: managed.profile.stop.graceMs,
+            killProcessTree: managed.profile.stop.killProcessTree,
+        });
+        managed.lease.status = 'failed';
+        managed.lease.stopReason = 'readiness_timeout';
+        managed.lease.stoppedAt = this.now().toISOString();
+        this.releasePort(managed.lease.port);
+        return rejected('live_preview_readiness_timeout', 'Live preview readiness timed out.');
+    }
+    markStopped(managed, status, reason) {
+        managed.lease.status = status;
+        managed.lease.stopReason = reason;
+        managed.lease.stoppedAt = this.now().toISOString();
+        this.releasePort(managed.lease.port);
+    }
+}
+function buildSpawnInput(profile, workspaceRoot, port, origin) {
+    const replacements = {
+        artifactDirectory: workspaceRoot,
+        port: String(port),
+        workspaceRoot,
+    };
+    const env = Object.fromEntries(Object.entries(profile.env ?? {}).map(([key, value]) => [
+        key,
+        renderTemplate(value, replacements),
+    ]));
+    if (profile.port.mode === 'env') {
+        env[profile.port.name] = String(port);
+    }
+    return {
+        commandProfileId: profile.id,
+        executable: profile.executable,
+        args: profile.args.map((arg) => renderTemplate(arg, replacements)),
+        cwd: profile.workingDirectory === 'artifactDirectory'
+            ? replacements.artifactDirectory
+            : workspaceRoot,
+        env,
+        port,
+        origin,
+    };
+}
+function renderTemplate(input, replacements) {
+    return input.replace(/\{([A-Za-z][A-Za-z0-9]*)\}/gu, (_match, key) => replacements[key] ?? '');
+}
+function createPreviewId() {
+    return `preview-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function rejected(code, message, details) {
+    return {
+        status: 'rejected',
+        error: { code, message, details },
+    };
+}
+//# sourceMappingURL=supervisor.js.map

package/build/server/products/code/livePreview/supervisor.js.map

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

package/build/server/products/code/renderer/api/appShell.d.ts

@@ -0,0 +1,5 @@
+export * from '../../../shared/renderer/api/appShell.js';
+import type { AppShellPayload } from '../../api/contracts.js';
+import type { SurfaceConversationBehaviorPatch } from '../../../shared/conversationBehavior.js';
+export declare function updateCodeConversationBehaviorPreference(patch: SurfaceConversationBehaviorPatch, signal?: AbortSignal): Promise<AppShellPayload>;
+//# sourceMappingURL=appShell.d.ts.map

package/build/server/products/code/renderer/api/appShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appShell.d.ts","sourceRoot":"","sources":["../../../../../../src/products/code/renderer/api/appShell.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAGhG,wBAAsB,wCAAwC,CAC5D,KAAK,EAAE,gCAAgC,EACvC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CAE1B"}

package/build/server/products/code/renderer/api/appShell.js

@@ -0,0 +1,6 @@
+export * from '../../../shared/renderer/api/appShell.js';
+import { updateConversationBehaviorPreference as updateWorkspaceConversationBehaviorPreference } from '../../../shared/renderer/api/appShell.js';
+export async function updateCodeConversationBehaviorPreference(patch, signal) {
+    return updateWorkspaceConversationBehaviorPreference('code', patch, signal);
+}
+//# sourceMappingURL=appShell.js.map

package/build/server/products/code/renderer/api/appShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appShell.js","sourceRoot":"","sources":["../../../../../../src/products/code/renderer/api/appShell.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC;AAIzD,OAAO,EAAE,oCAAoC,IAAI,6CAA6C,EAAE,MAAM,0CAA0C,CAAC;AAEjJ,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,KAAuC,EACvC,MAAoB;IAEpB,OAAO,6CAA6C,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAA6B,CAAC;AAC1G,CAAC"}

package/build/server/products/code/settings-cats/telegramDiagnostics.d.ts

@@ -0,0 +1,2 @@
+export * from '../../shared/settings-cats/telegramDiagnostics.js';
+//# sourceMappingURL=telegramDiagnostics.d.ts.map

package/build/server/products/code/settings-cats/telegramDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegramDiagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/products/code/settings-cats/telegramDiagnostics.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC"}

package/build/server/products/code/settings-cats/telegramDiagnostics.js

@@ -0,0 +1,2 @@
+export * from '../../shared/settings-cats/telegramDiagnostics.js';
+//# sourceMappingURL=telegramDiagnostics.js.map

package/build/server/products/code/settings-cats/telegramDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegramDiagnostics.js","sourceRoot":"","sources":["../../../../../src/products/code/settings-cats/telegramDiagnostics.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC"}