crewly 1.20.105 → 1.20.107

package/dist/backend/backend/src/services/restart/restart-drain.service.js

@@ -0,0 +1,298 @@
+/**
+ * Restart Drain Service
+ *
+ * Owns the "safe restart" state of the process:
+ * - a delivery pause: once shutdown starts, nothing new is written into an
+ *   agent's PTY — messages stay on the persistent queues instead;
+ * - the drain: wait until no agent is mid-turn, capped by a timeout, and
+ *   interruptible by a second signal;
+ * - restart readiness for operators (`GET /api/system/restart-readiness`);
+ * - a hook through which the REST restart endpoint asks the server for the
+ *   same graceful, drained shutdown a SIGTERM gets.
+ *
+ * "Queue empty" is not "safe to restart": a delivered message is off the
+ * queue while the agent is still working on it (2026-09-24, Ella). Readiness
+ * therefore reports in-flight turns, not queue depth.
+ *
+ * @module services/restart/restart-drain
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { SAFE_RESTART } from '../../constants.js';
+import { InFlightTurnTracker } from './in-flight-turn-tracker.service.js';
+/**
+ * Resolve the drain timeout from the environment.
+ *
+ * @param env - Environment (defaults to process.env)
+ * @returns Timeout in ms; 0 disables the wait. Invalid or negative values fall back to the default.
+ *
+ * @example
+ * ```typescript
+ * resolveRestartDrainMs({ CREWLY_RESTART_DRAIN_MS: '0' }); // 0
+ * resolveRestartDrainMs({}); // 120000
+ * ```
+ */
+export function resolveRestartDrainMs(env = process.env) {
+    const raw = env[SAFE_RESTART.DRAIN_ENV_VAR];
+    if (raw === undefined || raw.trim() === '')
+        return SAFE_RESTART.DRAIN_TIMEOUT_MS;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return SAFE_RESTART.DRAIN_TIMEOUT_MS;
+    return Math.floor(parsed);
+}
+/**
+ * Process-wide safe-restart state. Singleton.
+ */
+export class RestartDrainService {
+    tracker;
+    static instance = null;
+    logger;
+    paused = false;
+    pauseReason = null;
+    draining = false;
+    skipRequested = false;
+    wakeSleeper = null;
+    queueCounter = null;
+    shutdownHandler = null;
+    constructor(tracker) {
+        this.tracker = tracker;
+        this.logger = LoggerService.getInstance().createComponentLogger('RestartDrain');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The service
+     */
+    static getInstance() {
+        if (!RestartDrainService.instance) {
+            RestartDrainService.instance = new RestartDrainService(InFlightTurnTracker.getInstance());
+        }
+        return RestartDrainService.instance;
+    }
+    /**
+     * Reset the singleton (tests only).
+     */
+    static resetInstance() {
+        RestartDrainService.instance = null;
+    }
+    /**
+     * Whether deliveries into agent PTYs are paused (shutdown in progress).
+     *
+     * @returns True while paused
+     */
+    isDeliveryPaused() {
+        return this.paused;
+    }
+    /**
+     * Whether the drain wait is running right now.
+     *
+     * @returns True during the wait
+     */
+    isDraining() {
+        return this.draining;
+    }
+    /**
+     * Stop writing new messages into agent PTYs. Idempotent; never undone in
+     * this process (the next boot starts unpaused).
+     *
+     * @param reason - Why (for logs)
+     */
+    pauseDelivery(reason) {
+        if (this.paused)
+            return;
+        this.paused = true;
+        this.pauseReason = reason;
+        this.logger.info('Agent message delivery paused for shutdown; new messages stay queued', { reason });
+    }
+    /**
+     * Ask a running drain to stop waiting (second signal, supervisor escalation).
+     *
+     * @param reason - Why (for logs)
+     * @returns True if a drain was running and will now end
+     */
+    requestSkip(reason) {
+        if (!this.draining)
+            return false;
+        if (!this.skipRequested) {
+            this.logger.warn('Drain skipped on request; in-flight turns will be resumed after restart', { reason });
+        }
+        this.skipRequested = true;
+        this.wakeSleeper?.();
+        return true;
+    }
+    /**
+     * Register the counter used for `queued` in readiness.
+     *
+     * @param counter - Returns the number of messages on the persistent queues
+     */
+    setQueueCounter(counter) {
+        this.queueCounter = counter;
+    }
+    /**
+     * Register the server's graceful-shutdown entry point.
+     *
+     * @param handler - Runs the drained shutdown and exits the process
+     */
+    setShutdownHandler(handler) {
+        this.shutdownHandler = handler;
+    }
+    /**
+     * Run the server's graceful (drained) shutdown, if one is registered.
+     *
+     * @param request - Reason and exit code
+     * @returns True if a handler was registered and has been started
+     */
+    requestGracefulShutdown(request) {
+        if (!this.shutdownHandler)
+            return false;
+        void this.shutdownHandler(request).catch((error) => {
+            this.logger.error('Graceful shutdown handler failed', {
+                reason: request.reason,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        });
+        return true;
+    }
+    /**
+     * Current restart readiness.
+     *
+     * @returns Busy agents, queued count, and whether a restart is safe now
+     */
+    getReadiness() {
+        const busy = this.tracker.getMidTurn();
+        let queued = 0;
+        try {
+            queued = this.queueCounter ? this.queueCounter() : 0;
+        }
+        catch {
+            queued = 0;
+        }
+        return {
+            safe: busy.length === 0,
+            busyAgents: busy.map(toBusyAgent),
+            queued,
+            draining: this.draining,
+        };
+    }
+    /**
+     * Wait until no agent is mid-turn, the timeout passes, or a skip arrives.
+     * Pauses delivery first (idempotent) so the set of turns can only shrink.
+     *
+     * @param options - Timeout and test hooks
+     * @returns How it ended and the turns still in flight
+     */
+    async drain(options) {
+        const now = options.now ?? Date.now;
+        const pollMs = options.pollMs ?? SAFE_RESTART.DRAIN_POLL_INTERVAL_MS;
+        const logIntervalMs = options.logIntervalMs ?? SAFE_RESTART.DRAIN_LOG_INTERVAL_MS;
+        const sleep = options.sleep ?? null;
+        const start = now();
+        this.pauseDelivery(this.pauseReason ?? 'drain');
+        if (options.timeoutMs <= 0) {
+            const remaining = this.tracker.getMidTurn(now());
+            this.logger.info('Restart drain disabled; not waiting for agents', {
+                envVar: SAFE_RESTART.DRAIN_ENV_VAR,
+                inFlight: remaining.map(describeTurn),
+            });
+            return { outcome: 'disabled', waitedMs: 0, remaining };
+        }
+        this.draining = true;
+        let lastLogAt = -Infinity;
+        let lastLoggedKey = '';
+        try {
+            for (;;) {
+                const t = now();
+                const busy = this.tracker.getMidTurn(t);
+                const waitedMs = t - start;
+                if (busy.length === 0) {
+                    this.logger.info('Restart drain complete: no agent is mid-turn', { waitedMs });
+                    return { outcome: 'drained', waitedMs, remaining: [] };
+                }
+                if (this.skipRequested) {
+                    this.logger.warn('Restart drain skipped; these turns will be resumed after restart', {
+                        waitedMs,
+                        interrupted: busy.map(describeTurn),
+                    });
+                    return { outcome: 'skipped', waitedMs, remaining: busy };
+                }
+                if (waitedMs >= options.timeoutMs) {
+                    this.logger.warn('Restart drain timed out; these turns will be resumed after restart', {
+                        waitedMs,
+                        timeoutMs: options.timeoutMs,
+                        interrupted: busy.map(describeTurn),
+                    });
+                    return { outcome: 'timed-out', waitedMs, remaining: busy };
+                }
+                const key = busy.map((b) => b.sessionName).join(',');
+                if (key !== lastLoggedKey || t - lastLogAt >= logIntervalMs) {
+                    this.logger.info('Restart drain: waiting for agents to finish their current turn', {
+                        waitingOn: busy.map(describeTurn),
+                        waitedMs,
+                        timeoutMs: options.timeoutMs,
+                        hint: 'send the signal again to stop waiting',
+                    });
+                    lastLoggedKey = key;
+                    lastLogAt = t;
+                }
+                await this.sleepUnlessSkipped(sleep, Math.min(pollMs, options.timeoutMs - waitedMs));
+            }
+        }
+        finally {
+            this.draining = false;
+            this.wakeSleeper = null;
+        }
+    }
+    /**
+     * Sleep, but wake early when a skip is requested.
+     *
+     * @param sleep - Injected sleep (tests), or null for a cancellable timer
+     * @param ms - Duration
+     */
+    async sleepUnlessSkipped(sleep, ms) {
+        if (this.skipRequested)
+            return;
+        let timer = null;
+        const wait = sleep
+            ? sleep(Math.max(0, ms))
+            : new Promise((resolve) => {
+                timer = setTimeout(resolve, Math.max(0, ms));
+            });
+        try {
+            await Promise.race([
+                wait,
+                new Promise((resolve) => {
+                    this.wakeSleeper = resolve;
+                }),
+            ]);
+        }
+        finally {
+            // A skip must not leave the poll timer holding the process open.
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+}
+/**
+ * Map an in-flight turn to the readiness shape.
+ *
+ * @param turn - Open turn
+ * @returns Busy-agent entry
+ */
+function toBusyAgent(turn) {
+    const newest = turn.messages[turn.messages.length - 1];
+    return {
+        session: turn.sessionName,
+        since: new Date(turn.since).toISOString(),
+        messagePreview: newest?.preview ?? '',
+    };
+}
+/**
+ * Compact log description of a turn.
+ *
+ * @param turn - Open turn
+ * @returns Session, age and preview
+ */
+function describeTurn(turn) {
+    return toBusyAgent(turn);
+}
+//# sourceMappingURL=restart-drain.service.js.map

package/dist/backend/backend/src/services/restart/restart-drain.service.js.map

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

package/dist/backend/backend/src/services/restart/turn-probe.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Turn probe for PTY agent sessions.
+ *
+ * Decides whether an agent is mid-turn from two signals the codebase already
+ * trusts:
+ * - the "esc to interrupt" status bar (`containsBusyStatusBar`), which Claude
+ *   Code and Codex show for the whole of a turn — thinking, streaming, and
+ *   while a tool runs — and remove when the turn ends;
+ * - the PtyActivityTracker's last meaningful output time, which catches
+ *   runtimes without that bar (Gemini) and the gap between two tool calls.
+ *
+ * A session is resting only when both agree: no status bar and a quiet PTY.
+ * A missing session or an exited runtime is 'gone' — there is nothing left to
+ * wait for.
+ *
+ * @module services/restart/turn-probe
+ */
+import type { TurnProbe } from './in-flight-turn-tracker.service.js';
+/** The session-backend calls the probe needs. */
+export interface ProbeSessionBackend {
+    sessionExists(name: string): boolean;
+    captureOutput(name: string, lines?: number): string;
+    isChildProcessAlive?(name: string): boolean;
+}
+/** Dependencies of the PTY turn probe. */
+export interface PtyTurnProbeDeps {
+    /** Current session backend, or null when none is running */
+    getBackend: () => ProbeSessionBackend | null;
+    /** Ms since the session last produced meaningful output, or null if never */
+    getIdleTimeMs: (sessionName: string) => number | null;
+    /** Quiet period that counts as "resting" (defaults to SAFE_RESTART.TURN_QUIET_MS) */
+    quietMs?: number;
+    /** Trailing lines to inspect (defaults to SAFE_RESTART.PROBE_TAIL_LINES) */
+    tailLines?: number;
+}
+/**
+ * Create a probe that inspects a PTY session.
+ *
+ * @param deps - Backend and activity accessors
+ * @returns A TurnProbe
+ *
+ * @example
+ * ```typescript
+ * const probe = createPtyTurnProbe({
+ *   getBackend: () => getSessionBackendSync(),
+ *   getIdleTimeMs: (s) => tracker.hasActivity(s) ? tracker.getIdleTimeMs(s) : null,
+ * });
+ * probe('ella-1234'); // 'busy' | 'idle' | 'gone'
+ * ```
+ */
+export declare function createPtyTurnProbe(deps: PtyTurnProbeDeps): TurnProbe;
+//# sourceMappingURL=turn-probe.d.ts.map

package/dist/backend/backend/src/services/restart/turn-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-probe.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/restart/turn-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpD,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5C;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAChC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAC7C,6EAA6E;IAC7E,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAwBpE"}

package/dist/backend/backend/src/services/restart/turn-probe.js

@@ -0,0 +1,61 @@
+/**
+ * Turn probe for PTY agent sessions.
+ *
+ * Decides whether an agent is mid-turn from two signals the codebase already
+ * trusts:
+ * - the "esc to interrupt" status bar (`containsBusyStatusBar`), which Claude
+ *   Code and Codex show for the whole of a turn — thinking, streaming, and
+ *   while a tool runs — and remove when the turn ends;
+ * - the PtyActivityTracker's last meaningful output time, which catches
+ *   runtimes without that bar (Gemini) and the gap between two tool calls.
+ *
+ * A session is resting only when both agree: no status bar and a quiet PTY.
+ * A missing session or an exited runtime is 'gone' — there is nothing left to
+ * wait for.
+ *
+ * @module services/restart/turn-probe
+ */
+import { containsBusyStatusBar, stripAnsiCodes } from '../../utils/terminal-string-ops.js';
+import { SAFE_RESTART } from '../../constants.js';
+/**
+ * Create a probe that inspects a PTY session.
+ *
+ * @param deps - Backend and activity accessors
+ * @returns A TurnProbe
+ *
+ * @example
+ * ```typescript
+ * const probe = createPtyTurnProbe({
+ *   getBackend: () => getSessionBackendSync(),
+ *   getIdleTimeMs: (s) => tracker.hasActivity(s) ? tracker.getIdleTimeMs(s) : null,
+ * });
+ * probe('ella-1234'); // 'busy' | 'idle' | 'gone'
+ * ```
+ */
+export function createPtyTurnProbe(deps) {
+    const quietMs = deps.quietMs ?? SAFE_RESTART.TURN_QUIET_MS;
+    const tailLines = deps.tailLines ?? SAFE_RESTART.PROBE_TAIL_LINES;
+    return (sessionName) => {
+        const backend = deps.getBackend();
+        if (!backend || !backend.sessionExists(sessionName))
+            return 'gone';
+        if (backend.isChildProcessAlive?.(sessionName) === false)
+            return 'gone';
+        // Capture generously, then look only at the last non-empty lines: the
+        // status bar sits at the bottom of the TUI, and older screens in the
+        // scrollback must not count.
+        const raw = backend.captureOutput(sessionName, tailLines * 4) ?? '';
+        const tail = stripAnsiCodes(raw)
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .slice(-tailLines)
+            .join('\n');
+        if (containsBusyStatusBar(tail))
+            return 'busy';
+        const idleMs = deps.getIdleTimeMs(sessionName);
+        if (idleMs !== null && idleMs < quietMs)
+            return 'busy';
+        return 'idle';
+    };
+}
+//# sourceMappingURL=turn-probe.js.map

package/dist/backend/backend/src/services/restart/turn-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-probe.js","sourceRoot":"","sources":["../../../../../../backend/src/services/restart/turn-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC,aAAa,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,gBAAgB,CAAC;IAElE,OAAO,CAAC,WAAmB,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC;YAAE,OAAO,MAAM,CAAC;QACnE,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK;YAAE,OAAO,MAAM,CAAC;QAExE,sEAAsE;QACtE,qEAAqE;QACrE,6BAA6B;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC;aAC9B,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aACxC,KAAK,CAAC,CAAC,SAAS,CAAC;aACjB,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,IAAI,qBAAqB,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QAE/C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,GAAG,OAAO;YAAE,OAAO,MAAM,CAAC;QACvD,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;AACH,CAAC"}

package/dist/backend/backend/src/services/session/pty/node-pty-install.utils.d.ts

@@ -0,0 +1,70 @@
+/**
+ * node-pty install-state helpers (spawn-helper exec bit, native dirs).
+ *
+ * Crewly depends on node-pty's prebuilt binaries (`prebuilds/<platform>-<arch>/`)
+ * so `npm i -g crewly` works without a C/C++ toolchain (#778). On Unix the
+ * PTY fork goes through a small `spawn-helper` executable next to `pty.node`;
+ * if it loses its exec bit (node-pty 1.1.0's npm tarball shipped it as 0644,
+ * microsoft/node-pty#850/#919, and some package managers / copy steps still
+ * drop the mode) every spawn fails with a bare `posix_spawnp failed.` — which
+ * Crewly's retry loop would otherwise misreport as a process-table spike.
+ *
+ * Dependency-free (node builtins only): imported by the backend at spawn time
+ * and by the CLI's postinstall script, where no other dependency is guaranteed.
+ *
+ * @module services/session/pty/node-pty-install.utils
+ */
+/** File name of node-pty's Unix fork helper. */
+export declare const SPAWN_HELPER_NAME = "spawn-helper";
+/**
+ * Directories node-pty's `loadNativeModule` searches for `pty.node`, in its
+ * lookup order (compiled build first, prebuild last). `spawn-helper` is read
+ * from whichever directory `pty.node` loaded from.
+ *
+ * @param packageDir - The node-pty package directory
+ * @param platform - Platform tag (defaults to the current one)
+ * @param arch - Arch tag (defaults to the current one)
+ * @returns Absolute candidate directories
+ */
+export declare function nodePtyNativeDirs(packageDir: string, platform?: string, arch?: string): string[];
+/** Result of {@link ensureSpawnHelperExecutable}. */
+export interface SpawnHelperFixResult {
+    /** Helpers that were not executable and were chmod'ed to 0755. */
+    fixed: string[];
+    /** Helpers that are not executable and could not be fixed (e.g. read-only install). */
+    failed: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Make sure every `spawn-helper` node-pty may use is executable.
+ *
+ * No-op on Windows (ConPTY has no helper) and for directories without one
+ * (Linux prebuilds do not ship a helper).
+ *
+ * @param packageDir - The node-pty package directory
+ * @param platform - Platform tag (defaults to the current one)
+ * @param arch - Arch tag (defaults to the current one)
+ * @param chmod - chmod implementation (injectable for tests)
+ * @returns Which helpers were fixed and which could not be
+ */
+export declare function ensureSpawnHelperExecutable(packageDir: string, platform?: string, arch?: string, chmod?: (file: string, mode: number) => void): SpawnHelperFixResult;
+/**
+ * Locate the node-pty package directory through a resolver.
+ *
+ * @param resolve - A `require.resolve`-compatible function anchored where node-pty is installed
+ * @returns The package directory, or null when node-pty cannot be resolved
+ */
+export declare function resolveNodePtyDir(resolve: (request: string) => string): string | null;
+/**
+ * Locate the node-pty copy this process has ALREADY loaded, from the CJS
+ * module cache (Node records CJS modules there even when they were reached
+ * through an ESM `import`). Unlike resolving, this does not depend on where
+ * the entry script lives — `process.argv[1]` may be outside the package.
+ *
+ * @param cache - `require.cache` (shared across all `createRequire` instances)
+ * @returns The loaded package directory, or null when node-pty is not in the cache
+ */
+export declare function findLoadedNodePtyDir(cache: Record<string, unknown> | undefined): string | null;
+//# sourceMappingURL=node-pty-install.utils.d.ts.map

package/dist/backend/backend/src/services/session/pty/node-pty-install.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-pty-install.utils.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/session/pty/node-pty-install.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GACzB,MAAM,EAAE,CAMV;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACpC,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAC1C,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,EAC3B,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAmB,GACxD,oBAAoB,CAoBtB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAK9F"}

package/dist/backend/backend/src/services/session/pty/node-pty-install.utils.js

@@ -0,0 +1,105 @@
+/**
+ * node-pty install-state helpers (spawn-helper exec bit, native dirs).
+ *
+ * Crewly depends on node-pty's prebuilt binaries (`prebuilds/<platform>-<arch>/`)
+ * so `npm i -g crewly` works without a C/C++ toolchain (#778). On Unix the
+ * PTY fork goes through a small `spawn-helper` executable next to `pty.node`;
+ * if it loses its exec bit (node-pty 1.1.0's npm tarball shipped it as 0644,
+ * microsoft/node-pty#850/#919, and some package managers / copy steps still
+ * drop the mode) every spawn fails with a bare `posix_spawnp failed.` — which
+ * Crewly's retry loop would otherwise misreport as a process-table spike.
+ *
+ * Dependency-free (node builtins only): imported by the backend at spawn time
+ * and by the CLI's postinstall script, where no other dependency is guaranteed.
+ *
+ * @module services/session/pty/node-pty-install.utils
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** File name of node-pty's Unix fork helper. */
+export const SPAWN_HELPER_NAME = 'spawn-helper';
+/**
+ * Directories node-pty's `loadNativeModule` searches for `pty.node`, in its
+ * lookup order (compiled build first, prebuild last). `spawn-helper` is read
+ * from whichever directory `pty.node` loaded from.
+ *
+ * @param packageDir - The node-pty package directory
+ * @param platform - Platform tag (defaults to the current one)
+ * @param arch - Arch tag (defaults to the current one)
+ * @returns Absolute candidate directories
+ */
+export function nodePtyNativeDirs(packageDir, platform = process.platform, arch = process.arch) {
+    return [
+        path.join(packageDir, 'build', 'Release'),
+        path.join(packageDir, 'build', 'Debug'),
+        path.join(packageDir, 'prebuilds', `${platform}-${arch}`),
+    ];
+}
+/**
+ * Make sure every `spawn-helper` node-pty may use is executable.
+ *
+ * No-op on Windows (ConPTY has no helper) and for directories without one
+ * (Linux prebuilds do not ship a helper).
+ *
+ * @param packageDir - The node-pty package directory
+ * @param platform - Platform tag (defaults to the current one)
+ * @param arch - Arch tag (defaults to the current one)
+ * @param chmod - chmod implementation (injectable for tests)
+ * @returns Which helpers were fixed and which could not be
+ */
+export function ensureSpawnHelperExecutable(packageDir, platform = process.platform, arch = process.arch, chmod = fs.chmodSync) {
+    const result = { fixed: [], failed: [] };
+    if (platform === 'win32')
+        return result;
+    for (const dir of nodePtyNativeDirs(packageDir, platform, arch)) {
+        const helper = path.join(dir, SPAWN_HELPER_NAME);
+        if (!fs.existsSync(helper))
+            continue;
+        try {
+            fs.accessSync(helper, fs.constants.X_OK);
+            continue;
+        }
+        catch {
+            // not executable — fix below
+        }
+        try {
+            chmod(helper, 0o755);
+            result.fixed.push(helper);
+        }
+        catch (error) {
+            result.failed.push({ path: helper, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return result;
+}
+/**
+ * Locate the node-pty package directory through a resolver.
+ *
+ * @param resolve - A `require.resolve`-compatible function anchored where node-pty is installed
+ * @returns The package directory, or null when node-pty cannot be resolved
+ */
+export function resolveNodePtyDir(resolve) {
+    try {
+        return path.dirname(resolve('node-pty/package.json'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Locate the node-pty copy this process has ALREADY loaded, from the CJS
+ * module cache (Node records CJS modules there even when they were reached
+ * through an ESM `import`). Unlike resolving, this does not depend on where
+ * the entry script lives — `process.argv[1]` may be outside the package.
+ *
+ * @param cache - `require.cache` (shared across all `createRequire` instances)
+ * @returns The loaded package directory, or null when node-pty is not in the cache
+ */
+export function findLoadedNodePtyDir(cache) {
+    if (!cache)
+        return null;
+    const suffix = path.join('node-pty', 'lib', 'index.js');
+    const entry = Object.keys(cache).find((key) => key.endsWith(path.sep + suffix));
+    return entry ? path.dirname(path.dirname(entry)) : null;
+}
+//# sourceMappingURL=node-pty-install.utils.js.map

package/dist/backend/backend/src/services/session/pty/node-pty-install.utils.js.map

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

package/dist/backend/backend/src/services/session/pty/pty-session.d.ts

@@ -34,6 +34,8 @@ declare class PtySpawnExhaustedError extends Error {
         platform: string;
     });
 }
+/** Test affordance: forget the once-per-process spawn-helper check. */
+export declare function _resetSpawnHelperCheckForTesting(): void;
 export { PtySpawnExhaustedError };
 /**
  * PTY Session implementation using node-pty.

package/dist/backend/backend/src/services/session/pty/pty-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pty-session.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/session/pty/pty-session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAchF,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,OAAO,GAAG,CAAC,KAAK,GACpB,MAAM,IAAI,CAMZ;AAsED;;;;;;GAMG;AACH,cAAM,sBAAuB,SAAQ,KAAK;aAGxB,WAAW,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACjB;gBARD,OAAO,EAAE,MAAM,EACC,WAAW,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACjB;CAKF;AA6DD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAW,YAAW,QAAQ;aAsDzB,IAAI,EAAE,MAAM;aACZ,GAAG,EAAE,MAAM;IAtD5B;;OAEG;IACH,OAAO,CAAC,UAAU,CAAW;IAE7B;;OAEG;IACH,OAAO,CAAC,aAAa,CAA0C;IAE/D;;OAEG;IACH,OAAO,CAAC,aAAa,CAA0C;IAE/D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;;;;;;;;;;;;;;;;;OAmBG;gBAEc,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EAC3B,OAAO,EAAE,cAAc;IAqExB;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAepD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAepD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB3B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;;;;;;;;;OAaG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA+ChC;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;;;;OAQG;IACH,mBAAmB,IAAI,OAAO;IAgB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;CAanB"}
+{"version":3,"file":"pty-session.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/session/pty/pty-session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAoBhF,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,OAAO,GAAG,CAAC,KAAK,GACpB,MAAM,IAAI,CAMZ;AAsED;;;;;;GAMG;AACH,cAAM,sBAAuB,SAAQ,KAAK;aAGxB,WAAW,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACjB;gBARD,OAAO,EAAE,MAAM,EACC,WAAW,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACjB;CAKF;AA4CD,uEAAuE;AACvE,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAgED,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAW,YAAW,QAAQ;aAsDzB,IAAI,EAAE,MAAM;aACZ,GAAG,EAAE,MAAM;IAtD5B;;OAEG;IACH,OAAO,CAAC,UAAU,CAAW;IAE7B;;OAEG;IACH,OAAO,CAAC,aAAa,CAA0C;IAE/D;;OAEG;IACH,OAAO,CAAC,aAAa,CAA0C;IAE/D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;;;;;;;;;;;;;;;;;OAmBG;gBAEc,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EAC3B,OAAO,EAAE,cAAc;IAqExB;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAepD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAepD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB3B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;;;;;;;;;OAaG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA+ChC;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;;;;OAQG;IACH,mBAAmB,IAAI,OAAO;IAgB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6C1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;CAanB"}