crewly 1.20.174 → 1.20.175

package/dist/backend/backend/src/services/system/system-control.service.js

@@ -0,0 +1,574 @@
+/**
+ * System Control Service — the owner's Upgrade and Restart buttons.
+ *
+ * Jenkins-style "safe restart" for Crewly
+ * (specs/2026-10-01-upgrade-restart-controls.md):
+ *
+ * - **Status.** Running version, latest on npm, install kind, who relaunches
+ *   the backend, agents mid-turn, and the current / last action.
+ * - **Upgrade** (`when: idle | now`). npm global installs only. It reuses the
+ *   AutoUpdateService install path (same prefix, same npm, same verify), then
+ *   restarts. A source checkout is refused: it is updated with git.
+ * - **Restart** (`when: idle | now`). The graceful drained shutdown, exiting
+ *   with RESTART_REQUESTED. When nothing is known to relaunch the backend, a
+ *   detached launcher is started first so the machine never stays down.
+ * - **When idle** waits until no agent is mid-turn, capped (30 min), then
+ *   goes ahead. Asking again with `now` cuts the wait short.
+ * - **One at a time.** A second request while one is running is refused,
+ *   as is any request while a shutdown is already under way.
+ * - **Survives the restart.** Progress and outcome are kept in
+ *   `<crewlyHome>/system-action.json`; the next boot settles the record
+ *   ("Restarted at …", "Upgraded to x.y.z", or what went wrong), so the
+ *   dashboard can show it after it reconnects.
+ *
+ * All I/O goes through {@link SystemControlDeps}.
+ *
+ * @module services/system/system-control.service
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+import { PROCESS_EXIT_CODES, SYSTEM_CONTROL_CONSTANTS } from '../../constants.js';
+import { isNewerVersion } from './auto-update.utils.js';
+/** Statuses that mean "still running". */
+const ACTIVE_STATUSES = new Set(['waiting-idle', 'installing', 'restarting']);
+/**
+ * Map the AutoUpdate install kind onto the public one.
+ *
+ * @param install - Install info
+ * @returns Public kind
+ */
+export function toPublicInstallKind(install) {
+    if (install.kind === 'npm-global')
+        return 'npm-global';
+    if (install.kind === 'dev-checkout')
+        return 'dev-checkout';
+    return 'other';
+}
+/**
+ * Read the persisted action record.
+ *
+ * @param file - State file
+ * @returns The record, or null when missing / malformed
+ */
+export function readActionRecord(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return parsed && typeof parsed.id === 'string' && typeof parsed.status === 'string' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write the action record atomically.
+ *
+ * @param file - State file
+ * @param record - Record
+ */
+export function writeActionRecord(file, record) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(record, null, 2), 'utf-8');
+    fs.renameSync(tmp, file);
+}
+/**
+ * Upgrade / restart controller for the running backend.
+ */
+export class SystemControlService {
+    deps;
+    static instance = null;
+    action = null;
+    stateFile;
+    /** Resolves the current idle wait early ("now" pressed while waiting) */
+    cutIdleWaitShort = null;
+    /**
+     * @param deps - Injected I/O
+     */
+    constructor(deps) {
+        this.deps = deps;
+        this.stateFile = path.join(deps.crewlyHome, SYSTEM_CONTROL_CONSTANTS.STATE_FILE);
+    }
+    /**
+     * Register the process-wide instance.
+     *
+     * @param service - Instance, or null to clear
+     */
+    static setInstance(service) {
+        SystemControlService.instance = service;
+    }
+    /**
+     * The process-wide instance, when the server registered one.
+     *
+     * @returns The instance or null
+     */
+    static getInstance() {
+        return SystemControlService.instance;
+    }
+    /**
+     * Boot: settle the record a previous process left behind, so the
+     * dashboard can say "Restarted at …" / "Upgraded to x.y.z" after it
+     * reconnects.
+     */
+    handleBoot() {
+        const record = readActionRecord(this.stateFile);
+        if (!record || !ACTIVE_STATUSES.has(record.status) || record.pid === this.deps.pid)
+            return;
+        const now = new Date(this.deps.now()).toISOString();
+        const running = this.deps.currentVersion;
+        let settled;
+        if (record.status === 'restarting') {
+            if (record.kind === 'upgrade' && record.toVersion && running !== record.toVersion) {
+                settled = {
+                    ...record,
+                    status: 'failed',
+                    message: `Crewly came back on ${running ?? 'an unknown version'} instead of ${record.toVersion}.`,
+                };
+            }
+            else {
+                settled = {
+                    ...record,
+                    status: 'completed',
+                    message: record.kind === 'upgrade' ? `Upgraded to ${running} and restarted at ${now}.` : `Restarted at ${now}.`,
+                };
+            }
+        }
+        else {
+            settled = {
+                ...record,
+                status: 'interrupted',
+                message: record.kind === 'upgrade'
+                    ? 'Crewly stopped before the upgrade finished. Nothing was installed or the install was not confirmed; try again.'
+                    : 'Crewly stopped before the restart started.',
+            };
+        }
+        settled = { ...settled, completedAt: now, updatedAt: now, resultVersion: running };
+        this.action = settled;
+        this.persist();
+        this.deps.logger.info('Previous upgrade/restart settled at boot', {
+            id: settled.id,
+            kind: settled.kind,
+            status: settled.status,
+            requestedBy: settled.requestedBy,
+            message: settled.message,
+        });
+    }
+    /**
+     * Whether an upgrade or restart from this process is still running.
+     *
+     * @returns True while one is
+     */
+    isActionInProgress() {
+        return !!this.action && ACTIVE_STATUSES.has(this.action.status) && this.action.pid === this.deps.pid;
+    }
+    /**
+     * The current or last action (this boot, or the one settled at boot).
+     *
+     * @returns The record or null
+     */
+    getAction() {
+        if (this.action)
+            return this.action;
+        return readActionRecord(this.stateFile);
+    }
+    /**
+     * How the backend comes back after an exit.
+     *
+     * @param supervisor - Supervisor info
+     * @returns supervisor or replacement
+     */
+    relaunchMethod(supervisor) {
+        return supervisor.willRelaunch === 'yes' ? 'supervisor' : 'replacement';
+    }
+    /**
+     * Status for the dashboard.
+     *
+     * @param options - `refresh` re-asks the registry when the cached answer is over a minute old
+     * @returns Status
+     */
+    async getStatus(options = {}) {
+        const { install, currentVersion } = this.deps;
+        let latest = null;
+        try {
+            latest = await this.deps.fetchLatestVersion(options.refresh ? SYSTEM_CONTROL_CONSTANTS.REGISTRY_MAX_AGE_MS : SYSTEM_CONTROL_CONSTANTS.STATUS_REGISTRY_MAX_AGE_MS);
+        }
+        catch {
+            latest = null;
+        }
+        const updateAvailable = !!latest && !!currentVersion && isNewerVersion(latest, currentVersion);
+        const installKind = toPublicInstallKind(install);
+        const busy = this.inProgressReason();
+        const supervisor = this.deps.getSupervisor();
+        let upgradeBlockedReason = null;
+        if (installKind === 'dev-checkout')
+            upgradeBlockedReason = SYSTEM_CONTROL_CONSTANTS.MESSAGES.DEV_CHECKOUT;
+        else if (installKind === 'other')
+            upgradeBlockedReason = SYSTEM_CONTROL_CONSTANTS.MESSAGES.NOT_NPM_GLOBAL;
+        else if (busy)
+            upgradeBlockedReason = busy;
+        else if (!latest)
+            upgradeBlockedReason = SYSTEM_CONTROL_CONSTANTS.MESSAGES.REGISTRY_UNREACHABLE;
+        else if (!updateAvailable)
+            upgradeBlockedReason = `Crewly is up to date (${currentVersion}).`;
+        else if (!this.deps.getInstaller())
+            upgradeBlockedReason = SYSTEM_CONTROL_CONSTANTS.MESSAGES.UNAVAILABLE;
+        return {
+            currentVersion,
+            latestVersion: latest,
+            updateAvailable,
+            installKind,
+            packageRoot: install.packageRoot,
+            canUpgrade: upgradeBlockedReason === null,
+            upgradeBlockedReason,
+            canRestart: busy === null,
+            restartBlockedReason: busy,
+            supervisor,
+            relaunch: this.relaunchMethod(supervisor),
+            busyAgents: this.safeBusyAgents(),
+            inProgress: busy !== null,
+            action: this.getAction(),
+            bootId: this.deps.bootId,
+            startedAt: this.deps.startedAt,
+        };
+    }
+    /**
+     * Why nothing new can start right now (null when it can).
+     *
+     * @returns Owner-readable reason or null
+     */
+    inProgressReason() {
+        if (this.isActionInProgress() && this.action) {
+            return this.action.kind === 'upgrade'
+                ? `An upgrade to ${this.action.toVersion} is already in progress.`
+                : 'A restart is already in progress.';
+        }
+        if (this.deps.isShutdownInProgress())
+            return SYSTEM_CONTROL_CONSTANTS.MESSAGES.RESTART_IN_PROGRESS;
+        if (this.deps.getInstaller()?.isBusy())
+            return 'An automatic update is running right now. Try again in a few minutes.';
+        return null;
+    }
+    /**
+     * Busy agents, never throwing.
+     *
+     * @returns Agents mid-turn
+     */
+    safeBusyAgents() {
+        try {
+            return this.deps.getBusyAgents();
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Escalate a running "when idle" wait of the same kind to "now".
+     *
+     * @param kind - Requested kind
+     * @param request - Request
+     * @returns Accepted answer, or null when this is not an escalation
+     */
+    tryEscalate(kind, request) {
+        const action = this.action;
+        if (request.when !== 'now' ||
+            !action ||
+            !this.isActionInProgress() ||
+            action.kind !== kind ||
+            action.status !== 'waiting-idle' ||
+            !this.cutIdleWaitShort) {
+            return null;
+        }
+        this.deps.logger.info(`${kind === 'upgrade' ? 'Upgrade' : 'Restart'}: "now" requested while waiting for idle`, {
+            id: action.id,
+            requestedBy: request.actor,
+        });
+        this.update({ when: 'now', message: `${request.actor} asked to go ahead now.` });
+        this.cutIdleWaitShort();
+        return { ok: true, action: this.action, escalated: true };
+    }
+    /**
+     * Refusal for "something is already running", or null.
+     *
+     * @returns Refusal or null
+     */
+    busyRefusal() {
+        if (this.isActionInProgress()) {
+            return { ok: false, httpStatus: 409, code: SYSTEM_CONTROL_CONSTANTS.CODES.IN_PROGRESS, error: this.inProgressReason() };
+        }
+        const reason = this.inProgressReason();
+        if (reason) {
+            return { ok: false, httpStatus: 409, code: SYSTEM_CONTROL_CONSTANTS.CODES.RESTART_IN_PROGRESS, error: reason };
+        }
+        return null;
+    }
+    /**
+     * Owner pressed "Upgrade".
+     *
+     * @param request - When, and who
+     * @returns Accepted (work continues in the background) or a refusal
+     */
+    async requestUpgrade(request) {
+        const { install, currentVersion } = this.deps;
+        if (install.kind === 'dev-checkout') {
+            this.deps.logger.info('Upgrade refused: source checkout', { requestedBy: request.actor, packageRoot: install.packageRoot });
+            return { ok: false, httpStatus: 409, code: SYSTEM_CONTROL_CONSTANTS.CODES.DEV_CHECKOUT, error: SYSTEM_CONTROL_CONSTANTS.MESSAGES.DEV_CHECKOUT };
+        }
+        if (install.kind !== 'npm-global') {
+            this.deps.logger.info('Upgrade refused: not an npm global install', { requestedBy: request.actor, detail: install.detail });
+            return { ok: false, httpStatus: 409, code: SYSTEM_CONTROL_CONSTANTS.CODES.NOT_NPM_GLOBAL, error: SYSTEM_CONTROL_CONSTANTS.MESSAGES.NOT_NPM_GLOBAL };
+        }
+        const escalated = this.tryEscalate('upgrade', request);
+        if (escalated)
+            return escalated;
+        const busy = this.busyRefusal();
+        if (busy)
+            return busy;
+        const installer = this.deps.getInstaller();
+        if (!installer) {
+            return { ok: false, httpStatus: 503, code: SYSTEM_CONTROL_CONSTANTS.CODES.UNAVAILABLE, error: SYSTEM_CONTROL_CONSTANTS.MESSAGES.UNAVAILABLE };
+        }
+        let latest = null;
+        try {
+            latest = await this.deps.fetchLatestVersion(SYSTEM_CONTROL_CONSTANTS.REGISTRY_MAX_AGE_MS);
+        }
+        catch {
+            latest = null;
+        }
+        if (!latest) {
+            return { ok: false, httpStatus: 502, code: SYSTEM_CONTROL_CONSTANTS.CODES.REGISTRY_UNREACHABLE, error: SYSTEM_CONTROL_CONSTANTS.MESSAGES.REGISTRY_UNREACHABLE };
+        }
+        if (!currentVersion || !isNewerVersion(latest, currentVersion)) {
+            return { ok: false, httpStatus: 409, code: SYSTEM_CONTROL_CONSTANTS.CODES.UP_TO_DATE, error: `Crewly is already up to date (${currentVersion ?? latest}).` };
+        }
+        // The registry await gave another request a chance to start.
+        const raced = this.busyRefusal();
+        if (raced)
+            return raced;
+        const action = this.begin('upgrade', request, latest);
+        installer.appendLogLine(`${new Date(this.deps.now()).toISOString()} Manual upgrade to ${latest} requested by ${request.actor} (${request.when})`);
+        void this.runUpgrade(installer, latest).catch((error) => this.fail(`Upgrade crashed: ${errorText(error)}`));
+        return { ok: true, action };
+    }
+    /**
+     * Owner pressed "Restart".
+     *
+     * @param request - When, and who
+     * @returns Accepted (work continues in the background) or a refusal
+     */
+    async requestRestart(request) {
+        const escalated = this.tryEscalate('restart', request);
+        if (escalated)
+            return escalated;
+        const busy = this.busyRefusal();
+        if (busy)
+            return busy;
+        const action = this.begin('restart', request, null);
+        void this.runRestart().catch((error) => this.fail(`Restart crashed: ${errorText(error)}`));
+        return { ok: true, action };
+    }
+    /**
+     * Create and persist a new action.
+     *
+     * @param kind - upgrade or restart
+     * @param request - Request
+     * @param toVersion - Upgrade target
+     * @returns The record
+     */
+    begin(kind, request, toVersion) {
+        const now = new Date(this.deps.now()).toISOString();
+        const supervisor = this.deps.getSupervisor();
+        const label = kind === 'upgrade' ? `Upgrade to ${toVersion}` : 'Restart';
+        this.action = {
+            id: randomUUID(),
+            kind,
+            when: request.when,
+            status: request.when === 'idle' ? 'waiting-idle' : kind === 'upgrade' ? 'installing' : 'restarting',
+            requestedBy: request.actor,
+            requestedAt: now,
+            updatedAt: now,
+            fromVersion: this.deps.currentVersion,
+            toVersion,
+            pid: this.deps.pid,
+            relaunch: this.relaunchMethod(supervisor),
+            message: request.when === 'idle' ? `${label} will start when no agent is mid-turn.` : `${label} is starting.`,
+        };
+        this.persist();
+        this.deps.logger.info(`${label} requested`, {
+            id: this.action.id,
+            when: request.when,
+            requestedBy: request.actor,
+            fromVersion: this.deps.currentVersion,
+            supervisor: supervisor.kind,
+            willRelaunch: supervisor.willRelaunch,
+        });
+        return this.action;
+    }
+    /**
+     * Upgrade body: (wait for idle) → install → verify → marker → restart.
+     *
+     * @param installer - AutoUpdate install path
+     * @param version - Target
+     */
+    async runUpgrade(installer, version) {
+        if (this.action?.when === 'idle')
+            await this.waitForIdle();
+        if (this.deps.isShutdownInProgress()) {
+            this.fail('Crewly started shutting down for another reason before the upgrade began.');
+            return;
+        }
+        this.update({ status: 'installing', message: `Installing ${version}…` });
+        const attempt = await installer.installVersion(version);
+        if (!attempt.ok) {
+            this.deps.logger.warn('Manual upgrade install failed; not restarting', { version, outcome: attempt.outcome, reason: attempt.reason, ...attempt.details });
+            this.fail(`Could not install ${version}: ${attempt.reason}. Crewly keeps running ${this.deps.currentVersion}.`);
+            return;
+        }
+        installer.writeUpgradeMarker(this.deps.currentVersion ?? 'unknown', version);
+        const restarted = this.restartNow(`owner upgrade ${this.deps.currentVersion} -> ${version}`, `Installed ${version}. Restarting…`);
+        if (!restarted)
+            installer.clearUpgradeMarker();
+    }
+    /**
+     * Restart body: (wait for idle) → restart.
+     */
+    async runRestart() {
+        if (this.action?.when === 'idle')
+            await this.waitForIdle();
+        if (this.deps.isShutdownInProgress()) {
+            this.fail('Crewly started shutting down for another reason before the restart began.');
+            return;
+        }
+        await this.deps.sleep(SYSTEM_CONTROL_CONSTANTS.RESPONSE_FLUSH_MS);
+        this.restartNow('owner restart', 'Restarting… agents finish their current turn first.');
+    }
+    /**
+     * Make sure something brings the backend back, then run the graceful
+     * restart.
+     *
+     * @param reason - Shutdown reason (logs)
+     * @param message - Owner-readable progress
+     * @returns False when the restart could not be started
+     */
+    restartNow(reason, message) {
+        const supervisor = this.deps.getSupervisor();
+        const relaunch = this.relaunchMethod(supervisor);
+        if (relaunch === 'replacement') {
+            try {
+                this.deps.spawnReplacement(supervisor.willRelaunch === 'unknown');
+                this.deps.logger.info('Started the replacement launcher; it brings Crewly back after this process exits', {
+                    supervisor: supervisor.kind,
+                });
+            }
+            catch (error) {
+                this.fail(`Could not arrange for Crewly to come back (${errorText(error)}), so it was not restarted.`);
+                return false;
+            }
+        }
+        this.update({ status: 'restarting', relaunch, message });
+        this.deps.logger.info('Restarting Crewly', { reason, relaunch, requestedBy: this.action?.requestedBy });
+        let started = false;
+        try {
+            started = this.deps.requestGracefulRestart(reason);
+        }
+        catch (error) {
+            this.deps.logger.warn('Graceful restart unavailable; exiting directly', { error: errorText(error) });
+        }
+        if (!started) {
+            this.deps.logger.warn('No graceful shutdown handler; exiting with the restart code');
+            this.deps.exit(PROCESS_EXIT_CODES.RESTART_REQUESTED);
+        }
+        return true;
+    }
+    /**
+     * Wait until no agent is mid-turn, at most IDLE_WAIT_CAP_MS; a later "now"
+     * request ends the wait at once.
+     */
+    async waitForIdle() {
+        const deadline = this.deps.now() + SYSTEM_CONTROL_CONSTANTS.IDLE_WAIT_CAP_MS;
+        let cut = false;
+        const cutPromise = new Promise((resolve) => {
+            this.cutIdleWaitShort = () => {
+                cut = true;
+                resolve();
+            };
+        });
+        let lastBusy = '';
+        try {
+            for (;;) {
+                if (cut) {
+                    this.update({ idleWaitEndedBy: 'now' });
+                    return;
+                }
+                const busy = this.safeBusyAgents().map((a) => a.session);
+                if (busy.length === 0) {
+                    this.update({ idleWaitEndedBy: 'idle', waitingFor: [] });
+                    this.deps.logger.info('No agent is mid-turn; going ahead', { id: this.action?.id });
+                    return;
+                }
+                if (this.deps.now() >= deadline) {
+                    this.update({ idleWaitEndedBy: 'cap', waitingFor: busy });
+                    this.deps.logger.info('Waited the maximum for agents to go idle; going ahead (the restart drain still lets turns finish)', {
+                        id: this.action?.id,
+                        busy,
+                    });
+                    return;
+                }
+                const key = busy.join(',');
+                if (key !== lastBusy) {
+                    lastBusy = key;
+                    this.update({ waitingFor: busy, message: `Waiting for ${busy.length} agent${busy.length === 1 ? '' : 's'} to finish: ${busy.join(', ')}.` });
+                }
+                await Promise.race([this.deps.sleep(SYSTEM_CONTROL_CONSTANTS.IDLE_POLL_MS), cutPromise]);
+            }
+        }
+        finally {
+            this.cutIdleWaitShort = null;
+        }
+    }
+    /**
+     * Mark the current action failed.
+     *
+     * @param message - Owner-readable reason
+     */
+    fail(message) {
+        if (!this.action)
+            return;
+        const now = new Date(this.deps.now()).toISOString();
+        this.update({ status: 'failed', message, completedAt: now, resultVersion: this.deps.currentVersion });
+        this.deps.logger.warn('Upgrade/restart failed', { id: this.action.id, kind: this.action.kind, message, requestedBy: this.action.requestedBy });
+    }
+    /**
+     * Merge a patch into the current action and persist it.
+     *
+     * @param patch - Fields to change
+     */
+    update(patch) {
+        if (!this.action)
+            return;
+        this.action = { ...this.action, ...patch, updatedAt: new Date(this.deps.now()).toISOString() };
+        this.persist();
+    }
+    /**
+     * Write the current action (best-effort).
+     */
+    persist() {
+        if (!this.action)
+            return;
+        try {
+            writeActionRecord(this.stateFile, this.action);
+        }
+        catch (error) {
+            this.deps.logger.warn('Could not save upgrade/restart progress', { error: errorText(error) });
+        }
+    }
+}
+/**
+ * Error text.
+ *
+ * @param error - Anything thrown
+ * @returns Message
+ */
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=system-control.service.js.map

package/dist/backend/backend/src/services/system/system-control.service.js.map

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

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "16684dd54ffa9bdc9bf61e94f2e485d76a41df8b",
-  "builtAt": "2026-10-01T04:06:11.280Z"
+  "commit": "de41f146d6fb3f2a49a1eebc06da78c1c28653b2",
+  "builtAt": "2026-10-01T05:25:01.649Z"
 }

package/dist/cli/backend/src/constants.d.ts

@@ -4815,4 +4815,59 @@ export declare const SECRET_SCRUB_CONSTANTS: {
     /** settings.json under CREWLY_HOME, whose apiKeys are masked by exact value */
     readonly SETTINGS_FILE: "settings.json";
 };
+/**
+ * Owner-facing Upgrade / Restart controls in the dashboard
+ * (specs/2026-10-01-upgrade-restart-controls.md).
+ */
+export declare const SYSTEM_CONTROL_CONSTANTS: {
+    /** Progress / outcome of the last upgrade or restart, under CREWLY_HOME */
+    readonly STATE_FILE: "system-action.json";
+    /** Log file under `<crewlyHome>/logs/` written by the detached replacement launcher */
+    readonly REPLACEMENT_LOG_FILE: "restart-replacement.log";
+    /** "When idle": longest wait for agents to finish their turns before going ahead anyway (ms) — 30 min */
+    readonly IDLE_WAIT_CAP_MS: number;
+    /** "When idle": how often the busy check runs while waiting (ms) */
+    readonly IDLE_POLL_MS: number;
+    /** Pause before shutting down so the HTTP answer reaches the dashboard (ms) */
+    readonly RESPONSE_FLUSH_MS: 500;
+    /** A registry answer older than this is re-fetched when the owner asks to upgrade (ms) */
+    readonly REGISTRY_MAX_AGE_MS: number;
+    /** Registry answer age accepted for the status read (ms) — matches auto-update */
+    readonly STATUS_REGISTRY_MAX_AGE_MS: number;
+    /** Replacement launcher: how often it checks whether the old process is gone (ms) */
+    readonly REPLACEMENT_PID_POLL_MS: 500;
+    /** Replacement launcher: give up waiting for the old process after this long (ms) — drain is ≤ 2 min */
+    readonly REPLACEMENT_MAX_WAIT_MS: number;
+    /** Replacement launcher: grace before checking the port when nothing is expected to relaunch us (ms) */
+    readonly REPLACEMENT_PORT_GRACE_MS: number;
+    /** Replacement launcher: grace when an unknown supervisor might relaunch us first (ms) */
+    readonly REPLACEMENT_PORT_GRACE_UNKNOWN_MS: number;
+    /** Login item script that keeps `crewly start` running on the owner's Mac */
+    readonly LOGIN_WRAPPER_SCRIPT: "crewly-start.command";
+    /** systemd unit `crewly service install` writes */
+    readonly SYSTEMD_UNIT: "crewly.service";
+    /** Accepted values of the `when` body field */
+    readonly WHEN_VALUES: readonly ["idle", "now"];
+    /** Refusal codes returned with 4xx/5xx answers */
+    readonly CODES: {
+        readonly OWNER_ONLY: "owner-only";
+        readonly DEV_CHECKOUT: "dev-checkout";
+        readonly NOT_NPM_GLOBAL: "not-npm-global";
+        readonly UP_TO_DATE: "up-to-date";
+        readonly IN_PROGRESS: "in-progress";
+        readonly RESTART_IN_PROGRESS: "restart-in-progress";
+        readonly REGISTRY_UNREACHABLE: "registry-unreachable";
+        readonly UNAVAILABLE: "unavailable";
+        readonly BAD_REQUEST: "bad-request";
+    };
+    /** Owner-facing messages (the dashboard shows these as-is; English only) */
+    readonly MESSAGES: {
+        readonly OWNER_ONLY: "Only the owner can upgrade or restart Crewly. Agents cannot trigger this.";
+        readonly DEV_CHECKOUT: "This machine runs Crewly from a source checkout — update it with git (git pull, npm run build), then restart.";
+        readonly NOT_NPM_GLOBAL: "This copy of Crewly is not a global npm install, so it cannot upgrade itself. Update it the way it was installed.";
+        readonly UNAVAILABLE: "Upgrade and restart controls are not ready yet — Crewly is still starting. Try again in a minute.";
+        readonly REGISTRY_UNREACHABLE: "Could not reach the npm registry to find the latest version. Try again later.";
+        readonly RESTART_IN_PROGRESS: "Crewly is already shutting down or restarting.";
+    };
+};
 //# sourceMappingURL=constants.d.ts.map