@intentic/machine 1.304.0 → 1.306.0

package/dist/environments/children.js

@@ -0,0 +1,106 @@
+import { spawn } from "node:child_process";
+import { LOG_ROTATE_BYTES, ROTATE_LOG_SH } from "@intentic/local-agent";
+import { MACHINE_AUTOSTART } from "../autostart.js";
+import { listDistros } from "../wsl.js";
+import { crossEnv, NO_AGENT_EXIT } from "./crossing.js";
+import { SUPERVISOR_ENV, WINDOWS_SUPERVISOR } from "./machine.js";
+const CHILD_SH = [
+    `a="$HOME/.intentic/machine/bin/intentic-machine"; [ -x "$a" ] || exit ${NO_AGENT_EXIT}`,
+    `log="$HOME/.intentic/machine/machine.log"; mkdir -p "$HOME/.intentic/machine"`,
+    `rotate() { ${ROTATE_LOG_SH}; }; rotate "$log" "$1"`,
+    `PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin" exec "$a" ${MACHINE_AUTOSTART.foregroundArgs.join(" ")} >>"$log" 2>&1`,
+].join("\n");
+export const childArgv = (distro) => ({
+    command: "wsl.exe",
+    args: ["-d", distro, "--cd", "~", "--exec", "sh", "-c", CHILD_SH, "sh", String(LOG_ROTATE_BYTES)],
+});
+const STOPPED_EXITS = new Set([129, 130, 143]);
+const RESTART_LADDER_MS = [1_000, 5_000, 15_000, 60_000, 300_000];
+const HEALTHY_RUN_MS = 10 * 60_000;
+export const childVerdict = (code, ranForMs, failures) => {
+    if (code === 0) {
+        return { kind: "drop", why: "its agent has nothing left to serve" };
+    }
+    if (code === NO_AGENT_EXIT) {
+        return { kind: "drop", why: "no agent is installed there any more" };
+    }
+    if (code !== null && STOPPED_EXITS.has(code)) {
+        return { kind: "restart", delayMs: RESTART_LADDER_MS[0] ?? 1_000, failures: 0 };
+    }
+    const next = ranForMs >= HEALTHY_RUN_MS ? 1 : failures + 1;
+    return { kind: "restart", delayMs: RESTART_LADDER_MS[Math.min(next, RESTART_LADDER_MS.length) - 1] ?? 300_000, failures: next };
+};
+const realSpawner = {
+    spawn: (distro) => {
+        const { command, args } = childArgv(distro);
+        return spawn(command, [...args], { windowsHide: true, stdio: "ignore", env: crossEnv({ [SUPERVISOR_ENV]: WINDOWS_SUPERVISOR }, "u") });
+    },
+    distros: async () => await listDistros(),
+    now: Date.now,
+};
+export const superviseChildren = (log, drop, spawner = realSpawner) => {
+    const held = new Map();
+    let stopping = false;
+    const start = (distro, entry) => {
+        entry.timer = undefined;
+        entry.startedAt = spawner.now();
+        const child = spawner.spawn(distro);
+        entry.process = child;
+        child.once("error", (error) => log(`${distro}: could not start its agent through wsl.exe (${error.message})`));
+        child.once("exit", (code) => void exited(distro, entry, child, code));
+    };
+    const exited = async (distro, entry, child, code) => {
+        if (held.get(distro) !== entry || entry.process !== child || stopping) {
+            return;
+        }
+        entry.process = undefined;
+        const listed = code === 0 || code === NO_AGENT_EXIT ? undefined : await spawner.distros();
+        const verdict = listed !== undefined && !listed.includes(distro)
+            ? { kind: "drop", why: "WSL no longer has that distro" }
+            : childVerdict(code, spawner.now() - entry.startedAt, entry.failures);
+        if (verdict.kind === "drop") {
+            held.delete(distro);
+            log(`${distro}: no longer kept running from here, ${verdict.why}.`);
+            await drop(distro, verdict.why).catch((error) => log(`${distro}: could not be taken off the list (${String(error)})`));
+            return;
+        }
+        entry.failures = verdict.failures;
+        log(`${distro}: its agent stopped (exit ${code ?? "by signal"}); starting it again in ${Math.round(verdict.delayMs / 1000)}s.`);
+        entry.timer = setTimeout(() => {
+            if (held.get(distro) === entry && !stopping) {
+                start(distro, entry);
+            }
+        }, verdict.delayMs);
+    };
+    const release = (distro, entry) => {
+        clearTimeout(entry.timer);
+        held.delete(distro);
+        entry.process?.kill();
+    };
+    return {
+        reconcile: (wanted) => {
+            for (const [distro, entry] of held) {
+                if (!wanted.includes(distro)) {
+                    release(distro, entry);
+                    log(`${distro}: let go, it is no longer attached to this PC's Windows side.`);
+                }
+            }
+            for (const distro of wanted) {
+                if (!held.has(distro)) {
+                    const entry = { process: undefined, startedAt: 0, failures: 0, timer: undefined };
+                    held.set(distro, entry);
+                    log(`${distro}: keeping its agent running from here.`);
+                    start(distro, entry);
+                }
+            }
+        },
+        held: () => [...held.keys()],
+        stopAll: () => {
+            stopping = true;
+            for (const [distro, entry] of held) {
+                release(distro, entry);
+            }
+        },
+    };
+};
+//# sourceMappingURL=children.js.map

package/dist/environments/children.js.map

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

package/dist/environments/commands.d.ts

@@ -0,0 +1,12 @@
+import type { Log } from "@intentic/local-agent";
+import { type CommandContext } from "@stricli/core";
+import { type MachineConfig } from "./machine.js";
+export declare const environmentRoutes: import("@stricli/core").RouteMap<CommandContext>;
+export declare const adoptRunningDistros: (log: Log) => Promise<void>;
+export interface UpdatesFlags {
+    readonly agent?: "on" | "off";
+    readonly sandboxes?: "on" | "off";
+}
+export declare const withSwitches: (config: MachineConfig, flags: UpdatesFlags) => MachineConfig;
+export declare const updates: import("@stricli/core").Command<CommandContext>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/environments/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/environments/commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EAAc,KAAK,aAAa,EAAgF,MAAM,cAAc,CAAC;AA8B5I,eAAO,MAAM,iBAAiB,kDAG5B,CAAC;AAMH,eAAO,MAAM,mBAAmB,QAAe,GAAG,KAAG,OAAO,CAAC,IAAI,CAiBhE,CAAC;AASF,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;CACrC;AAGD,eAAO,MAAM,YAAY,WAAY,aAAa,SAAS,YAAY,KAAG,aAKzE,CAAC;AAQF,eAAO,MAAM,OAAO,iDAqClB,CAAC"}

package/dist/environments/commands.js

@@ -0,0 +1,102 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { buildCommand, buildRouteMap } from "@stricli/core";
+import { ensureResident } from "../resident.js";
+import { listDistros } from "../wsl.js";
+import { childrenOf, readMachineConfig, runOnWindows, updateMachineConfig, windowsRoot, withChild } from "./machine.js";
+const exec = promisify(execFile);
+const attach = buildCommand({
+    docs: { brief: "Keep a WSL distro's agent running from this PC's Windows side (the distro's own agent asks for this)" },
+    parameters: {
+        positional: { kind: "tuple", parameters: [{ brief: "The distro, as `wsl -l` names it", parse: String, placeholder: "distro" }] },
+    },
+    async func(_flags, distro) {
+        const out = (message) => void this.process.stdout.write(`${message}\n`);
+        if (process.platform !== "win32") {
+            throw new Error("only the Windows side of a PC keeps its distros running.");
+        }
+        const listed = await listDistros();
+        if (listed === undefined) {
+            throw new Error("wsl.exe could not be asked which distros this PC has.");
+        }
+        if (!listed.includes(distro)) {
+            throw new Error(`WSL has no distro called "${distro}"; it lists ${listed.join(", ") || "none"}.`);
+        }
+        const before = childrenOf(await readMachineConfig());
+        await updateMachineConfig((config) => withChild(config, distro));
+        await ensureResident(out);
+        out(before.includes(distro) ? `${distro} is already kept running from here.` : `${distro}'s agent is kept running from here now.`);
+    },
+});
+export const environmentRoutes = buildRouteMap({
+    routes: { attach },
+    docs: { brief: "How the environments of this PC (Windows and its WSL distros) run as one machine" },
+});
+const HAS_RESIDENT_SH = `[ -x "$HOME/.intentic/machine/bin/intentic-machine" ] && [ -s "$HOME/.intentic/machine/machine.pid" ]`;
+export const adoptRunningDistros = async (log) => {
+    if (process.platform !== "win32") {
+        return;
+    }
+    const held = childrenOf(await readMachineConfig());
+    const running = ((await listDistros({ running: true })) ?? []).filter((distro) => !held.includes(distro));
+    for (const distro of running) {
+        const has = await exec("wsl.exe", ["-d", distro, "--exec", "sh", "-c", HAS_RESIDENT_SH], { timeout: 30_000, windowsHide: true })
+            .then(() => true)
+            .catch(() => false);
+        if (has) {
+            await updateMachineConfig((config) => withChild(config, distro));
+            log(`${distro} runs an agent too: it is kept running from this side now.`);
+        }
+    }
+};
+const onOff = (value) => {
+    if (value === "on" || value === "off") {
+        return value;
+    }
+    throw new Error(`"${value}" is not on or off.`);
+};
+export const withSwitches = (config, flags) => {
+    const { agentUpdates, sandboxUpdates, ...rest } = config;
+    const agent = flags.agent === undefined ? agentUpdates : flags.agent === "on" ? undefined : false;
+    const sandboxes = flags.sandboxes === undefined ? sandboxUpdates : flags.sandboxes === "on" ? undefined : false;
+    return { ...rest, ...(agent === undefined ? {} : { agentUpdates: agent }), ...(sandboxes === undefined ? {} : { sandboxUpdates: sandboxes }) };
+};
+const updatesArgs = (flags) => [
+    ...(flags.agent === undefined ? [] : ["--agent", flags.agent]),
+    ...(flags.sandboxes === undefined ? [] : ["--sandboxes", flags.sandboxes]),
+];
+export const updates = buildCommand({
+    docs: { brief: "What this machine updates by itself: its agent (the whole PC at once) and the next image of each sandbox" },
+    parameters: {
+        flags: {
+            agent: { kind: "parsed", parse: onOff, optional: true, brief: "Update the agent on this PC by itself when a release is published (on by default)" },
+            sandboxes: {
+                kind: "parsed",
+                parse: onOff,
+                optional: true,
+                brief: "Download each sandbox's next update in the background, so applying it is a short restart (on by default)",
+            },
+        },
+    },
+    async func(flags) {
+        const out = (message) => void this.process.stdout.write(`${message}\n`);
+        const root = await windowsRoot();
+        if (root !== undefined) {
+            if (runOnWindows(root, ["updates", ...updatesArgs(flags)], { inherit: true }).status !== 0) {
+                throw new Error("the Windows side's agent did not take that; run it there: intentic-machine updates");
+            }
+            return;
+        }
+        if (flags.agent !== undefined || flags.sandboxes !== undefined) {
+            await updateMachineConfig((config) => withSwitches(config, flags));
+        }
+        const config = await readMachineConfig();
+        out(config.agentUpdates === false
+            ? "Agent: updated only when asked (`intentic-machine upgrade`, or Update on the sandbox's Devices tab). Turn it back on with --agent on."
+            : "Agent: updated by itself when a release is published, the whole PC at once. Turn it off with --agent off.");
+        out(config.sandboxUpdates === false
+            ? "Sandboxes: each update downloads when you take it, a wait of minutes. Turn background downloads back on with --sandboxes on."
+            : "Sandboxes: each one's next update is downloaded in the background, so applying it is a restart of about half a minute. Turn it off with --sandboxes off.");
+    },
+});
+//# sourceMappingURL=commands.js.map

package/dist/environments/commands.js.map

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

package/dist/environments/crossing.d.ts

@@ -0,0 +1,31 @@
+export declare const POWERSHELL_FLAGS: string[];
+export type CommandTarget = {
+    readonly kind: "native";
+} | {
+    readonly kind: "wsl";
+    readonly distro: string | undefined;
+} | {
+    readonly kind: "windows";
+};
+export declare const targetOf: (raw: string | undefined) => CommandTarget;
+export interface Interpreter {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string | undefined;
+    readonly env: NodeJS.ProcessEnv;
+}
+export declare const WINDOWS_POWERSHELL: string[];
+export declare const crossInterpreter: (target: Exclude<CommandTarget, {
+    kind: "native";
+}>, script: string, cwd: string | undefined, { platform, inWsl, exists }: {
+    platform: NodeJS.Platform;
+    inWsl: boolean;
+    exists: (path: string) => boolean;
+}) => Interpreter;
+export declare const crossEnv: (vars: Readonly<Record<string, string>>, direction: "u" | "w", base?: NodeJS.ProcessEnv) => NodeJS.ProcessEnv;
+export declare const NO_AGENT_EXIT = 64;
+export declare const agentInDistro: (distro: string, args: readonly string[]) => {
+    readonly command: string;
+    readonly args: readonly string[];
+};
+//# sourceMappingURL=crossing.d.ts.map

package/dist/environments/crossing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossing.d.ts","sourceRoot":"","sources":["../../src/environments/crossing.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,UAA8E,CAAC;AAG5G,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAGvJ,eAAO,MAAM,QAAQ,QAAS,MAAM,GAAG,SAAS,KAAG,aAclD,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACnC;AAGD,eAAO,MAAM,kBAAkB,UAI9B,CAAC;AA0CF,eAAO,MAAM,gBAAgB,WACjB,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,UAC1C,MAAM,OACT,MAAM,GAAG,SAAS,+BACM;IAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,KAC9G,WAA8I,CAAC;AAIlJ,eAAO,MAAM,QAAQ,SAAU,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,aAAa,GAAG,GAAG,GAAG,SAAQ,MAAM,CAAC,UAAU,KAAiB,MAAM,CAAC,UAGrI,CAAC;AAGF,eAAO,MAAM,aAAa,KAAK,CAAC;AAKhC,eAAO,MAAM,aAAa,WAAY,MAAM,QAAQ,SAAS,MAAM,EAAE,KAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAGlI,CAAC"}

package/dist/environments/crossing.js

@@ -0,0 +1,64 @@
+import { wslPathOf } from "@intentic/sandbox-contract";
+export const POWERSHELL_FLAGS = ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command"];
+export const targetOf = (raw) => {
+    if (raw === undefined || raw === "") {
+        return { kind: "native" };
+    }
+    if (raw === "windows") {
+        return { kind: "windows" };
+    }
+    if (raw === "wsl") {
+        return { kind: "wsl", distro: undefined };
+    }
+    if (raw.startsWith("wsl:") && raw.length > "wsl:".length) {
+        return { kind: "wsl", distro: raw.slice("wsl:".length) };
+    }
+    throw new Error(`Unknown \`in\` "${raw}": use "wsl", "wsl:<distro>" or "windows".`);
+};
+export const WINDOWS_POWERSHELL = [
+    "/mnt/c/Program Files/PowerShell/7/pwsh.exe",
+    "/mnt/c/Program Files/PowerShell/7-preview/pwsh.exe",
+    "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe",
+];
+const wslInterpreter = (distro, script, cwd, platform) => {
+    if (platform !== "win32") {
+        throw new Error(`Only a Windows PC can run a command in WSL; this device runs ${platform}.`);
+    }
+    return {
+        command: "wsl.exe",
+        args: [...(distro === undefined ? [] : ["-d", distro]), "--cd", cwd ?? "~", "--exec", "sh", "-lc", script],
+        cwd: undefined,
+        env: { ...process.env, WSL_UTF8: "1" },
+    };
+};
+const windowsInterpreter = (script, cwd, inWsl, exists) => {
+    if (!inWsl) {
+        throw new Error("Only a WSL distro can run a command on Windows; this device is not one.");
+    }
+    const command = WINDOWS_POWERSHELL.find(exists);
+    if (command === undefined) {
+        throw new Error("No PowerShell is reachable from this distro: Windows interop is off, or C: is not mounted at /mnt/c.");
+    }
+    const start = cwd === undefined ? undefined : cwd.startsWith("/mnt/") ? cwd : wslPathOf(cwd);
+    if (cwd !== undefined && start === undefined) {
+        throw new Error(`A Windows working directory is a drive path (C:\\Users\\you) or its /mnt form, not "${cwd}".`);
+    }
+    return {
+        command,
+        args: [...POWERSHELL_FLAGS, start === undefined ? `Set-Location -LiteralPath $env:USERPROFILE\n${script}` : script],
+        cwd: start,
+        env: process.env,
+    };
+};
+export const crossInterpreter = (target, script, cwd, { platform, inWsl, exists }) => (target.kind === "wsl" ? wslInterpreter(target.distro, script, cwd, platform) : windowsInterpreter(script, cwd, inWsl, exists));
+export const crossEnv = (vars, direction, base = process.env) => {
+    const existing = (base["WSLENV"] ?? "").split(":").filter((entry) => entry !== "" && !Object.hasOwn(vars, entry.split("/")[0] ?? ""));
+    return { ...base, ...vars, WSLENV: [...existing, ...Object.keys(vars).map((name) => `${name}/${direction}`)].join(":") };
+};
+export const NO_AGENT_EXIT = 64;
+const AGENT_IN_DISTRO_SH = `a="$HOME/.intentic/machine/bin/intentic-machine"; [ -x "$a" ] || exit ${NO_AGENT_EXIT}; exec "$a" "$@"`;
+export const agentInDistro = (distro, args) => ({
+    command: "wsl.exe",
+    args: ["-d", distro, "--cd", "~", "--exec", "sh", "-c", AGENT_IN_DISTRO_SH, "sh", ...args],
+});
+//# sourceMappingURL=crossing.js.map

package/dist/environments/crossing.js.map

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

package/dist/environments/machine-upgrade.d.ts

@@ -0,0 +1,26 @@
+import { type Log } from "@intentic/local-agent";
+import { type UpgradeOutcome } from "../upgrade.js";
+export declare const UPGRADE_ENV = "INTENTIC_MACHINE_UPGRADE";
+export declare const machineTarget: (published: string | undefined, installed: readonly (string | undefined)[]) => string | undefined;
+export declare const upgradeHere: (target: string, force: boolean, log: Log) => Promise<UpgradeOutcome>;
+export declare const installedIn: (distro: string) => Promise<string | undefined>;
+export interface MachineIo {
+    readonly leg: string | undefined;
+    readonly windowsRoot: () => Promise<string | undefined>;
+    readonly delegate: (agent: string, args: readonly string[]) => number;
+    readonly children: () => Promise<readonly string[]>;
+    readonly published: () => Promise<string | undefined>;
+    readonly installedHere: () => string | undefined;
+    readonly installedIn: (distro: string) => Promise<string | undefined>;
+    readonly upgradeIn: (distro: string, target: string) => Promise<boolean>;
+    readonly upgradeHere: (target: string) => Promise<UpgradeOutcome>;
+    readonly recorded: (failedTarget: string | undefined) => Promise<void>;
+}
+export interface MachineUpgradeAsk {
+    readonly force: boolean;
+    readonly level: boolean;
+}
+export declare const upgradeMachine: (io: MachineIo, ask: MachineUpgradeAsk, log: Log) => Promise<boolean>;
+export declare const realMachineIo: (ask: MachineUpgradeAsk, log: Log) => MachineIo;
+export declare const siblingVersions: () => Promise<readonly (string | undefined)[]>;
+//# sourceMappingURL=machine-upgrade.d.ts.map

package/dist/environments/machine-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-upgrade.d.ts","sourceRoot":"","sources":["../../src/environments/machine-upgrade.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,GAAG,EAAkB,MAAM,uBAAuB,CAAC;AAM/E,OAAO,EAA+B,KAAK,cAAc,EAAiC,MAAM,eAAe,CAAC;AAUhH,eAAO,MAAM,WAAW,6BAA6B,CAAC;AAGtD,eAAO,MAAM,aAAa,cAAe,MAAM,GAAG,SAAS,aAAa,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,KAAG,MAAM,GAAG,SAGe,CAAC;AAiCnI,eAAO,MAAM,WAAW,WAAkB,MAAM,SAAS,OAAO,OAAO,GAAG,KAAG,OAAO,CAAC,cAAc,CAQ7F,CAAC;AAGP,eAAO,MAAM,WAAW,WAAkB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAI5E,CAAC;AAkCF,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAGD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAkCD,eAAO,MAAM,cAAc,OAAc,SAAS,OAAO,iBAAiB,OAAO,GAAG,KAAG,OAAO,CAAC,OAAO,CAYrG,CAAC;AAcF,eAAO,MAAM,aAAa,QAAS,iBAAiB,OAAO,GAAG,KAAG,SAW/D,CAAC;AAGH,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAO/E,CAAC"}

package/dist/environments/machine-upgrade.js

@@ -0,0 +1,153 @@
+import { execFile, spawn } from "node:child_process";
+import { setTimeout as sleep } from "node:timers/promises";
+import { promisify } from "node:util";
+import { claimPidFile, releasePidFile } from "@intentic/local-agent";
+import { DEV_VERSION, isNewer } from "@intentic/sandbox-contract";
+import { binDir, upgradeLockPath } from "../config.js";
+import { installedBuild } from "../installed.js";
+import { publishedVersion } from "../release.js";
+import { readResident, restartResident } from "../supervision.js";
+import { realUpgradeExec, runUpgrade, upgradeLanded, upgradeMessage } from "../upgrade.js";
+import { MACHINE_VERSION } from "../version.js";
+import { agentInDistro, crossEnv, NO_AGENT_EXIT } from "./crossing.js";
+import { childrenOf, readMachineConfig, runOnWindows, updateMachineConfig, windowsRoot } from "./machine.js";
+const exec = promisify(execFile);
+export const UPGRADE_ENV = "INTENTIC_MACHINE_UPGRADE";
+export const machineTarget = (published, installed) => [published, ...installed]
+    .filter((version) => version !== undefined && version !== DEV_VERSION)
+    .reduce((best, version) => (best === undefined || isNewer(version, best) ? version : best), undefined);
+const LOCK_WAIT_MS = 15 * 60_000;
+const LOCK_POLL_MS = 2_000;
+const withUpgradeLock = async (log, run) => {
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    let said = false;
+    for (;;) {
+        const claim = await claimPidFile(upgradeLockPath, binDir, { pid: process.pid });
+        if (claim.claimed) {
+            break;
+        }
+        if (Date.now() > deadline) {
+            return { kind: "failed", reason: `another upgrade (pid ${claim.holder.pid}) is still running here.` };
+        }
+        if (!said) {
+            said = true;
+            log(`Waiting for the upgrade already running here (pid ${claim.holder.pid})…`);
+        }
+        await sleep(LOCK_POLL_MS);
+    }
+    try {
+        return await run();
+    }
+    finally {
+        await releasePidFile(upgradeLockPath, process.pid);
+    }
+};
+export const upgradeHere = async (target, force, log) => await withUpgradeLock(log, async () => {
+    const running = async () => (await readResident())?.build;
+    const restart = async () => {
+        await restartResident(() => undefined);
+        return await running();
+    };
+    return await runUpgrade(realUpgradeExec(restart, running, log), target, installedBuild() ?? MACHINE_VERSION, force, log);
+});
+export const installedIn = async (distro) => {
+    const { command, args } = agentInDistro(distro, ["version"]);
+    const answer = await exec(command, [...args], { timeout: 60_000, windowsHide: true }).catch(() => undefined);
+    return /^\d+\.\d+\.\d+$/.exec(answer?.stdout.trim() ?? "")?.[0];
+};
+const upgradeIn = async (distro, target, force, log) => await new Promise((resolve) => {
+    const { command, args } = agentInDistro(distro, ["upgrade", ...(force ? ["--force"] : [])]);
+    const child = spawn(command, [...args], {
+        windowsHide: true,
+        stdio: ["ignore", "pipe", "pipe"],
+        env: crossEnv({ [UPGRADE_ENV]: target }, "u"),
+    });
+    const relay = (chunk) => {
+        for (const line of chunk
+            .toString("utf8")
+            .split(/\r?\n/)
+            .filter((one) => one.trim() !== "")) {
+            log(`  [${distro}] ${line}`);
+        }
+    };
+    child.stdout.on("data", relay);
+    child.stderr.on("data", relay);
+    child.once("error", (error) => {
+        log(`  [${distro}] could not be reached through wsl.exe (${error.message}).`);
+        resolve(false);
+    });
+    child.once("close", (code) => {
+        if (code === NO_AGENT_EXIT) {
+            log(`  [${distro}] has no agent installed any more; nothing to upgrade there.`);
+        }
+        resolve(code === 0 || code === NO_AGENT_EXIT);
+    });
+});
+const askArgs = (ask) => [...(ask.force ? ["--force"] : []), ...(ask.level ? ["--level"] : [])];
+const upgradeFromRoot = async (io, ask, log) => {
+    const children = await io.children();
+    const [published, ...theirs] = await Promise.all([ask.level ? Promise.resolve(undefined) : io.published(), ...children.map(io.installedIn)]);
+    const target = machineTarget(published, [io.installedHere(), ...theirs]);
+    if (target === undefined) {
+        log(ask.level
+            ? "Nothing to level: no side of this machine runs a released agent."
+            : "Upgrade didn't happen: couldn't reach the release channel, nothing was changed.");
+        return ask.level;
+    }
+    if (children.length > 0) {
+        log(`Bringing this PC to ${target}: ${[...children, "this side"].join(", ")}.`);
+    }
+    const legs = [];
+    for (const child of children) {
+        legs.push(await io.upgradeIn(child, target));
+    }
+    const here = await io.upgradeHere(target);
+    log(upgradeMessage(here));
+    const landed = legs.every(Boolean) && upgradeLanded(here);
+    await io.recorded(landed ? undefined : target);
+    return landed;
+};
+export const upgradeMachine = async (io, ask, log) => {
+    if (io.leg !== undefined) {
+        const outcome = await io.upgradeHere(io.leg);
+        log(upgradeMessage(outcome));
+        return upgradeLanded(outcome);
+    }
+    const root = await io.windowsRoot();
+    if (root !== undefined) {
+        log("This is a WSL distro: the whole PC is upgraded from its Windows side.");
+        return io.delegate(root, ["upgrade", ...askArgs(ask)]) === 0;
+    }
+    return await upgradeFromRoot(io, ask, log);
+};
+const recordFailure = async (failedTarget) => {
+    await updateMachineConfig((config) => {
+        const { upgradeFailure: previous, ...rest } = config;
+        if (failedTarget === undefined) {
+            return rest;
+        }
+        const count = previous?.target === failedTarget ? previous.count + 1 : 1;
+        return { ...rest, upgradeFailure: { target: failedTarget, count, at: Date.now() } };
+    });
+};
+export const realMachineIo = (ask, log) => ({
+    leg: process.env[UPGRADE_ENV],
+    windowsRoot,
+    delegate: (agent, args) => runOnWindows(agent, args, { inherit: true }).status,
+    children: async () => (process.platform === "win32" ? childrenOf(await readMachineConfig()) : []),
+    published: publishedVersion,
+    installedHere: installedBuild,
+    installedIn,
+    upgradeIn: async (distro, target) => await upgradeIn(distro, target, ask.force, log),
+    upgradeHere: async (target) => await upgradeHere(target, ask.force, log),
+    recorded: recordFailure,
+});
+export const siblingVersions = async () => {
+    const root = await windowsRoot();
+    if (root !== undefined) {
+        const answer = runOnWindows(root, ["version"]);
+        return [answer.status === 0 ? /^\d+\.\d+\.\d+$/.exec(answer.output)?.[0] : undefined];
+    }
+    return process.platform === "win32" ? await Promise.all(childrenOf(await readMachineConfig()).map(installedIn)) : [];
+};
+//# sourceMappingURL=machine-upgrade.js.map

package/dist/environments/machine-upgrade.js.map

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

package/dist/environments/machine.d.ts

@@ -0,0 +1,29 @@
+export declare const SUPERVISOR_ENV = "INTENTIC_MACHINE_SUPERVISOR";
+export declare const WINDOWS_SUPERVISOR = "windows";
+export declare const supervisedByWindows: (env?: NodeJS.ProcessEnv) => boolean;
+export interface MachineConfig {
+    readonly children?: readonly string[];
+    readonly agentUpdates?: boolean;
+    readonly sandboxUpdates?: boolean;
+    readonly upgradeFailure?: {
+        readonly target: string;
+        readonly count: number;
+        readonly at: number;
+    };
+}
+export declare const readMachineConfig: () => Promise<MachineConfig>;
+export declare const updateMachineConfig: (mutate: (config: MachineConfig) => MachineConfig) => Promise<MachineConfig>;
+export declare const childrenOf: (config: MachineConfig) => readonly string[];
+export declare const withChild: (config: MachineConfig, distro: string) => MachineConfig;
+export declare const withoutChild: (config: MachineConfig, distro: string) => MachineConfig;
+export declare const windowsRoot: () => Promise<string | undefined>;
+export declare const runOnWindows: (agent: string, args: readonly string[], { vars, inherit }?: {
+    readonly vars?: Readonly<Record<string, string>>;
+    readonly inherit?: boolean;
+}) => {
+    readonly status: number;
+    readonly output: string;
+};
+export declare const attachArgs: (distro: string) => readonly string[];
+export declare const attachToWindows: (log: (message: string) => void) => Promise<boolean>;
+//# sourceMappingURL=machine.d.ts.map

package/dist/environments/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/environments/machine.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,mBAAmB,SAAS,MAAM,CAAC,UAAU,KAAiB,OAAqD,CAAC;AAGjI,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACtG;AAGD,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,aAAa,CAQ/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,WAAkB,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,KAAG,OAAO,CAAC,aAAa,CAIjH,CAAC;AAEF,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,SAAS,MAAM,EAA2B,CAAC;AAE9F,eAAO,MAAM,SAAS,WAAY,aAAa,UAAU,MAAM,KAAG,aACoD,CAAC;AAEvH,eAAO,MAAM,YAAY,WAAY,aAAa,UAAU,MAAM,KAAG,aAIpE,CAAC;AA4BF,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,MAAM,GAAG,SAAS,CAShD,CAAC;AAGV,eAAO,MAAM,YAAY,UACd,MAAM,QACP,SAAS,MAAM,EAAE,sBACS;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACjH;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CASpD,CAAC;AAEF,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,SAAS,MAAM,EAAuC,CAAC;AAGnG,eAAO,MAAM,eAAe,QAAe,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,KAAG,OAAO,CAAC,OAAO,CAWrF,CAAC"}