@namzu/sandbox 24.0.0 → 25.0.0

package/dist/local-virtual-computer/setup/host.js

@@ -0,0 +1,93 @@
+import { homedir, release } from 'node:os';
+import { join, win32 } from 'node:path';
+import { LocalCommandError, nodeCommandRunner } from '../engine.js';
+import { RESUME_AT_SIGN_IN_KEY } from './contract.js';
+import { PROBE_LIMIT_MS, ProbeTimeoutError, runLimited } from './limits.js';
+import { queryRegistryKey } from './registry.js';
+/** `10.0.19045` becomes 19045; undefined when the release string has no build. */
+function windowsBuildOf(platform) {
+    if (platform !== 'win32')
+        return undefined;
+    const build = Number(release().split('.')[2]);
+    return Number.isInteger(build) ? build : undefined;
+}
+/**
+ * The processor type of the PC. On Windows a 32-bit process sees its own
+ * type in `PROCESSOR_ARCHITECTURE`; the PC's is in `PROCESSOR_ARCHITEW6432`.
+ * Neither is `process.arch`, which names the Node build, not the machine.
+ */
+export function windowsArchitectureOf(env) {
+    const claimed = (env.PROCESSOR_ARCHITEW6432 ?? env.PROCESSOR_ARCHITECTURE ?? '').toUpperCase();
+    if (claimed === 'AMD64')
+        return 'x64';
+    if (claimed === 'ARM64')
+        return 'arm64';
+    return claimed === '' ? process.arch : claimed.toLowerCase();
+}
+function defaultStateDirectory(env, platform) {
+    if (platform === 'win32') {
+        const base = env.LOCALAPPDATA ?? win32.join(homedir(), 'AppData', 'Local');
+        return win32.join(base, 'Namzu', 'setup');
+    }
+    return join(homedir(), '.namzu', 'setup');
+}
+/** `REG_DWORD    0x1f` becomes 31; anything else is undefined. */
+export function parseRegDword(output) {
+    const match = /REG_DWORD\s+0x([0-9a-f]+)/i.exec(output);
+    return match ? Number.parseInt(match[1], 16) : undefined;
+}
+/** The real Windows host, with `overrides` applied. */
+export const createWslcSetupHost = (overrides = {}) => {
+    const platform = overrides.platform ?? process.platform;
+    const env = overrides.env ?? process.env;
+    const runner = overrides.runner ?? nodeCommandRunner;
+    const host = {
+        platform,
+        arch: platform === 'win32' ? windowsArchitectureOf(env) : process.arch,
+        windowsBuild: windowsBuildOf(platform),
+        env,
+        runner,
+        stateDirectory: defaultStateDirectory(env, platform),
+        resumeRegistryKey: RESUME_AT_SIGN_IN_KEY,
+        now: () => new Date(),
+        async readDword(key, name) {
+            try {
+                return parseRegDword(await runLimited(runner, 'reg.exe', ['query', key, '/v', name], PROBE_LIMIT_MS.command));
+            }
+            catch (error) {
+                // reg.exe exits 1 for an absent key or value; that is "not set". A
+                // check that did not answer in time is not known: it propagates, so a
+                // policy read that timed out never reads as "not set" (allowed).
+                if (error instanceof LocalCommandError)
+                    return undefined;
+                throw error;
+            }
+        },
+        async keyExists(key) {
+            try {
+                const listing = await queryRegistryKey((args) => runLimited(runner, 'reg.exe', args, PROBE_LIMIT_MS.command), key);
+                return listing !== undefined;
+            }
+            catch (error) {
+                // Denied, a failed parent or no answer in time: not known, never "absent".
+                if (error instanceof LocalCommandError || error instanceof ProbeTimeoutError)
+                    return 'unknown';
+                throw error;
+            }
+        },
+        async bootTime() {
+            const output = await runLimited(runner, 'powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                "(Get-CimInstance Win32_OperatingSystem).LastBootUpTime.ToUniversalTime().ToString('o')",
+            ], PROBE_LIMIT_MS.powershell);
+            const parsed = new Date(output.trim());
+            if (Number.isNaN(parsed.getTime()))
+                throw new Error('Windows did not report its boot time');
+            return parsed;
+        },
+    };
+    return { ...host, ...overrides };
+};
+//# sourceMappingURL=host.js.map

package/dist/local-virtual-computer/setup/host.js.map

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

package/dist/local-virtual-computer/setup/idle.d.ts

@@ -0,0 +1,18 @@
+import type { StopIdleWslcSession } from './contract.js';
+/**
+ * Whether the default wslc session is running. `wslc system session list`
+ * reads the session manager and does not start a session (unlike `list` and
+ * `image`, which do). The default session is the one wslc names `wslc-cli-*`.
+ */
+export declare function defaultSessionRunning(listOutput: string): boolean;
+/**
+ * Stop the wslc session's virtual machine when nothing runs in it. Answers
+ * `busy` and does nothing while any container runs, Namzu's or not, and
+ * `not-running` when there is no session to stop.
+ *
+ * A container could start between the check and the terminate; the window is
+ * milliseconds and the caller owns the sessions it starts. If the check itself
+ * fails, the error is thrown and the session is left alone.
+ */
+export declare const stopIdleWslcSession: StopIdleWslcSession;
+//# sourceMappingURL=idle.d.ts.map

package/dist/local-virtual-computer/setup/idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/idle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAOxD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAWjC,CAAA"}

package/dist/local-virtual-computer/setup/idle.js

@@ -0,0 +1,38 @@
+import { createWslcSetupHost } from './host.js';
+import { wslcBinaryOf } from './wslc-shared.js';
+/** A row of `wslc system session list`: id, creator pid, display name. */
+const SESSION_ROW = /^\s*\d+\s+\d+\s+(\S+)/;
+/**
+ * Whether the default wslc session is running. `wslc system session list`
+ * reads the session manager and does not start a session (unlike `list` and
+ * `image`, which do). The default session is the one wslc names `wslc-cli-*`.
+ */
+export function defaultSessionRunning(listOutput) {
+    return listOutput
+        .split(/\r?\n/)
+        .some((line) => (SESSION_ROW.exec(line)?.[1] ?? '').startsWith('wslc-cli'));
+}
+/**
+ * Stop the wslc session's virtual machine when nothing runs in it. Answers
+ * `busy` and does nothing while any container runs, Namzu's or not, and
+ * `not-running` when there is no session to stop.
+ *
+ * A container could start between the check and the terminate; the window is
+ * milliseconds and the caller owns the sessions it starts. If the check itself
+ * fails, the error is thrown and the session is left alone.
+ */
+export const stopIdleWslcSession = async (options) => {
+    const host = createWslcSetupHost(options.host);
+    const binary = wslcBinaryOf(host);
+    const { signal } = options;
+    const sessions = await host.runner.run(binary, ['system', 'session', 'list'], { signal });
+    if (!defaultSessionRunning(sessions))
+        return { outcome: 'not-running' };
+    // Running containers only: `list` without `--all`.
+    const running = await host.runner.run(binary, ['list', '-q'], { signal });
+    if (running.trim() !== '')
+        return { outcome: 'busy' };
+    await host.runner.run(binary, ['system', 'session', 'terminate'], { signal });
+    return { outcome: 'stopped' };
+};
+//# sourceMappingURL=idle.js.map

package/dist/local-virtual-computer/setup/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/idle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,0EAA0E;AAC1E,MAAM,WAAW,GAAG,uBAAuB,CAAA;AAE3C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACvD,OAAO,UAAU;SACf,KAAK,CAAC,OAAO,CAAC;SACd,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwB,KAAK,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACzF,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;IACvE,mDAAmD;IACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACzE,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IACrD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7E,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC,CAAA"}

package/dist/local-virtual-computer/setup/image.d.ts

@@ -0,0 +1,7 @@
+import type { LoadWslcImage } from './contract.js';
+/**
+ * Check the bundled archive against its manifest, load it with `wslc load`,
+ * and check what loaded. Nothing is loaded that failed a check.
+ */
+export declare const loadWslcImage: LoadWslcImage;
+//# sourceMappingURL=image.d.ts.map

package/dist/local-virtual-computer/setup/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/image.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAA;AAyDrE;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aA4F3B,CAAA"}

package/dist/local-virtual-computer/setup/image.js

@@ -0,0 +1,124 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { LocalComputerSetupError } from '../engine.js';
+import { mapWslcFailure } from '../wslc-engine.js';
+import { createWslcSetupHost } from './host.js';
+import { ManifestError, archivePathOf, parseImageInspect, readManifest, writeImageRecord, wslcBinaryOf, } from './wslc-shared.js';
+const HASH_CHUNK_BYTES = 4 * 1024 * 1024;
+async function sha256Of(path, total, onProgress, signal) {
+    const hash = createHash('sha256');
+    let done = 0;
+    const stream = createReadStream(path, { highWaterMark: HASH_CHUNK_BYTES, signal });
+    for await (const chunk of stream) {
+        hash.update(chunk);
+        done += chunk.byteLength;
+        onProgress?.(Math.min(done, total));
+    }
+    return hash.digest('hex');
+}
+/** The image the engine reports under `ref`, or undefined when it has none. */
+async function inspectImage(host, ref, signal) {
+    try {
+        const output = await host.runner.run(wslcBinaryOf(host), ['image', 'inspect', '-f', 'json', ref], { signal });
+        const parsed = parseImageInspect(output);
+        return parsed ? { kind: 'found', id: parsed.id, protocol: parsed.protocol } : { kind: 'absent' };
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        const mapped = mapWslcFailure(error);
+        if (mapped === undefined)
+            return { kind: 'absent' };
+        if (mapped.code === 'image-missing')
+            return { kind: 'absent' };
+        return { kind: 'engine', detail: mapped.message };
+    }
+}
+/**
+ * Check the bundled archive against its manifest, load it with `wslc load`,
+ * and check what loaded. Nothing is loaded that failed a check.
+ */
+export const loadWslcImage = async (options) => {
+    const host = createWslcSetupHost(options.host);
+    const { signal } = options;
+    let manifest;
+    try {
+        manifest = await readManifest(options.manifestPath);
+    }
+    catch (error) {
+        if (error instanceof ManifestError)
+            return { outcome: 'failed', code: 'image-corrupt', detail: error.message };
+        throw error;
+    }
+    const record = async () => {
+        await writeImageRecord(host, {
+            imageRef: manifest.imageRef,
+            imageId: manifest.imageId,
+            loadedAt: host.now().toISOString(),
+        });
+    };
+    const existing = await inspectImage(host, manifest.imageRef, signal);
+    if (existing.kind === 'engine')
+        return { outcome: 'failed', code: 'image-load-failed', detail: existing.detail };
+    if (existing.kind === 'found' && existing.id === manifest.imageId) {
+        await record();
+        return { outcome: 'already-loaded' };
+    }
+    const archive = archivePathOf(options.manifestPath, manifest);
+    let size;
+    try {
+        size = (await stat(archive)).size;
+    }
+    catch {
+        return {
+            outcome: 'failed',
+            code: 'image-corrupt',
+            detail: 'The Pal computer image file is missing from this installation.',
+        };
+    }
+    if (size !== manifest.compressedBytes)
+        return {
+            outcome: 'failed',
+            code: 'image-corrupt',
+            detail: 'The Pal computer image file is incomplete or damaged.',
+        };
+    const digest = await sha256Of(archive, manifest.compressedBytes, (done) => options.onProgress?.({
+        step: 'load-image',
+        phase: 'progress',
+        done,
+        total: manifest.compressedBytes,
+        unit: 'bytes',
+    }), signal);
+    if (digest !== manifest.sha256)
+        return {
+            outcome: 'failed',
+            code: 'image-corrupt',
+            detail: 'The Pal computer image file is incomplete or damaged.',
+        };
+    try {
+        await host.runner.run(wslcBinaryOf(host), ['load', '-q', '-i', archive], { signal });
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        const mapped = mapWslcFailure(error);
+        return {
+            outcome: 'failed',
+            code: 'image-load-failed',
+            detail: mapped instanceof LocalComputerSetupError
+                ? mapped.message
+                : 'Windows could not load the Pal computer image.',
+        };
+    }
+    const loaded = await inspectImage(host, manifest.imageRef, signal);
+    if (loaded.kind !== 'found' ||
+        loaded.id !== manifest.imageId ||
+        loaded.protocol !== manifest.protocol)
+        return {
+            outcome: 'failed',
+            code: 'image-mismatch',
+            detail: 'The image that loaded is not the one this version of Namzu expects.',
+        };
+    await record();
+    return { outcome: 'loaded' };
+};
+//# sourceMappingURL=image.js.map

package/dist/local-virtual-computer/setup/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EACN,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACZ,MAAM,kBAAkB,CAAA;AAEzB,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,KAAK,UAAU,QAAQ,CACtB,IAAY,EACZ,KAAa,EACb,UAAgD,EAChD,MAA+B;IAE/B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAA;IAClF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,KAAe,CAAC,CAAA;QAC5B,IAAI,IAAK,KAAgB,CAAC,UAAU,CAAA;QACpC,UAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,+EAA+E;AAC/E,KAAK,UAAU,YAAY,CAC1B,IAA4C,EAC5C,GAAW,EACX,MAA+B;IAM/B,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACnC,YAAY,CAAC,IAAI,CAAC,EAClB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EACvC,EAAE,MAAM,EAAE,CACV,CAAA;QACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACjG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QACnD,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IAClD,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,KAAK,EAAE,OAAO,EAAE,EAAE;IAC7D,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAC1B,IAAI,QAA2B,CAAA;IAC/B,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,aAAa;YACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;QAC3E,MAAM,KAAK,CAAA;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACxC,MAAM,gBAAgB,CAAC,IAAI,EAAE;YAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SAClC,CAAC,CAAA;IACH,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACpE,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ;QAC7B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IACjF,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnE,MAAM,MAAM,EAAE,CAAA;QACd,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;IACrC,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAC7D,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACJ,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,gEAAgE;SACxE,CAAA;IACF,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,CAAC,eAAe;QACpC,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,uDAAuD;SAC/D,CAAA;IACF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC5B,OAAO,EACP,QAAQ,CAAC,eAAe,EACxB,CAAC,IAAI,EAAE,EAAE,CACR,OAAO,CAAC,UAAU,EAAE,CAAC;QACpB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,IAAI;QACJ,KAAK,EAAE,QAAQ,CAAC,eAAe;QAC/B,IAAI,EAAE,OAAO;KACb,CAAC,EACH,MAAM,CACN,CAAA;IACD,IAAI,MAAM,KAAK,QAAQ,CAAC,MAAM;QAC7B,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,uDAAuD;SAC/D,CAAA;IAEF,IAAI,CAAC;QACJ,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,mBAAmB;YACzB,MAAM,EACL,MAAM,YAAY,uBAAuB;gBACxC,CAAC,CAAC,MAAM,CAAC,OAAO;gBAChB,CAAC,CAAC,gDAAgD;SACpD,CAAA;IACF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAClE,IACC,MAAM,CAAC,IAAI,KAAK,OAAO;QACvB,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO;QAC9B,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QAErC,OAAO;YACN,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,qEAAqE;SAC7E,CAAA;IACF,MAAM,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC,CAAA"}

package/dist/local-virtual-computer/setup/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Windows Pal computer setup: inspect the machine, plan, and run the plan
+ * after the person agrees. Separate from the provider, which never installs,
+ * loads or starts anything.
+ */
+export * from './contract.js';
+export { createWslcSetupHost } from './host.js';
+export { stopIdleWslcSession } from './idle.js';
+export { loadWslcImage } from './image.js';
+export { planWslcSetup } from './plan.js';
+export { inspectWslcReadiness } from './readiness.js';
+export { clearRestartMarker, readRestartMarker, writeRestartMarker } from './restart.js';
+export { clearResumeAtSignIn, registerResumeAtSignIn } from './resume.js';
+export { runWslcSetup } from './run.js';
+export { runElevatedWslcSteps } from './elevated.js';
+export { downloadWslPackage, PINNED_WSL_PACKAGE } from './wsl-package.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/local-virtual-computer/setup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACxF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/local-virtual-computer/setup/index.js

@@ -0,0 +1,17 @@
+/**
+ * Windows Pal computer setup: inspect the machine, plan, and run the plan
+ * after the person agrees. Separate from the provider, which never installs,
+ * loads or starts anything.
+ */
+export * from './contract.js';
+export { createWslcSetupHost } from './host.js';
+export { stopIdleWslcSession } from './idle.js';
+export { loadWslcImage } from './image.js';
+export { planWslcSetup } from './plan.js';
+export { inspectWslcReadiness } from './readiness.js';
+export { clearRestartMarker, readRestartMarker, writeRestartMarker } from './restart.js';
+export { clearResumeAtSignIn, registerResumeAtSignIn } from './resume.js';
+export { runWslcSetup } from './run.js';
+export { runElevatedWslcSteps } from './elevated.js';
+export { downloadWslPackage, PINNED_WSL_PACKAGE } from './wsl-package.js';
+//# sourceMappingURL=index.js.map

package/dist/local-virtual-computer/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACxF,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/local-virtual-computer/setup/limits.d.ts

@@ -0,0 +1,30 @@
+import type { LocalComputerCommandRunner } from '../engine.js';
+/**
+ * Every probe command has its own time limit, so a stuck Windows tool degrades
+ * one fact to `unknown` instead of hanging the whole inspection.
+ */
+export declare const PROBE_LIMIT_MS: {
+    /** reg.exe, sc.exe, wsl.exe, wslc version: local and quick. */
+    readonly command: 10000;
+    /** PowerShell starts slowly on a cold PC. */
+    readonly powershell: 15000;
+    /** The command that starts the wslc session (a virtual machine). */
+    readonly session: 60000;
+};
+/** A probe command did not answer within its limit. */
+export declare class ProbeTimeoutError extends Error {
+    readonly name = "ProbeTimeoutError";
+    constructor();
+}
+/**
+ * Run one command with its own limit. The limit aborts the runner's signal and
+ * also stops waiting, so a runner that ignores the signal cannot hold the
+ * caller. The caller's own signal still wins: its abort rejects with its
+ * reason, not with a timeout.
+ */
+export declare function runLimited(runner: LocalComputerCommandRunner, binary: string, args: readonly string[], limitMs: number, options?: {
+    readonly signal?: AbortSignal;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly cwd?: string;
+}): Promise<string>;
+//# sourceMappingURL=limits.d.ts.map

package/dist/local-virtual-computer/setup/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,cAAc;IAC1B,+DAA+D;;IAE/D,6CAA6C;;IAE7C,oEAAoE;;CAE3D,CAAA;AAEV,uDAAuD;AACvD,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,uBAAsB;;CAI5C;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAChB,GACJ,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/local-virtual-computer/setup/limits.js

@@ -0,0 +1,58 @@
+/**
+ * Every probe command has its own time limit, so a stuck Windows tool degrades
+ * one fact to `unknown` instead of hanging the whole inspection.
+ */
+export const PROBE_LIMIT_MS = {
+    /** reg.exe, sc.exe, wsl.exe, wslc version: local and quick. */
+    command: 10_000,
+    /** PowerShell starts slowly on a cold PC. */
+    powershell: 15_000,
+    /** The command that starts the wslc session (a virtual machine). */
+    session: 60_000,
+};
+/** A probe command did not answer within its limit. */
+export class ProbeTimeoutError extends Error {
+    name = 'ProbeTimeoutError';
+    constructor() {
+        super('A Windows check did not answer in time.');
+    }
+}
+/**
+ * Run one command with its own limit. The limit aborts the runner's signal and
+ * also stops waiting, so a runner that ignores the signal cannot hold the
+ * caller. The caller's own signal still wins: its abort rejects with its
+ * reason, not with a timeout.
+ */
+export async function runLimited(runner, binary, args, limitMs, options = {}) {
+    options.signal?.throwIfAborted();
+    const controller = new AbortController();
+    let timer;
+    let onOuterAbort;
+    const stop = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            // Reject first: aborting makes a well-behaved runner reject at once, and
+            // the caller must see the timeout, not that rejection.
+            reject(new ProbeTimeoutError());
+            controller.abort();
+        }, limitMs);
+        onOuterAbort = () => {
+            reject(options.signal?.reason);
+            controller.abort();
+        };
+        options.signal?.addEventListener('abort', onOuterAbort, { once: true });
+    });
+    // Whichever side loses the race must not become an unhandled rejection.
+    stop.catch(() => undefined);
+    try {
+        const running = runner.run(binary, args, { ...options, signal: controller.signal });
+        running.catch(() => undefined);
+        return await Promise.race([running, stop]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (onOuterAbort)
+            options.signal?.removeEventListener('abort', onOuterAbort);
+    }
+}
+//# sourceMappingURL=limits.js.map

package/dist/local-virtual-computer/setup/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/limits.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,MAAM;IACf,6CAA6C;IAC7C,UAAU,EAAE,MAAM;IAClB,oEAAoE;IACpE,OAAO,EAAE,MAAM;CACN,CAAA;AAEV,uDAAuD;AACvD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACzB,IAAI,GAAG,mBAAmB,CAAA;IAC5C;QACC,KAAK,CAAC,yCAAyC,CAAC,CAAA;IACjD,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,MAAkC,EAClC,MAAc,EACd,IAAuB,EACvB,OAAe,EACf,UAII,EAAE;IAEN,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAA;IAChC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,IAAI,KAAgD,CAAA;IACpD,IAAI,YAAsC,CAAA;IAC1C,MAAM,IAAI,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC7C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACvB,yEAAyE;YACzE,uDAAuD;YACvD,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAA;YAC/B,UAAU,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC,EAAE,OAAO,CAAC,CAAA;QACX,YAAY,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC9B,UAAU,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC,CAAA;QACD,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IACF,wEAAwE;IACxE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3B,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QACnF,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC9B,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IAC3C,CAAC;YAAS,CAAC;QACV,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,YAAY;YAAE,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IAC7E,CAAC;AACF,CAAC"}

package/dist/local-virtual-computer/setup/plan.d.ts

@@ -0,0 +1,8 @@
+import type { PlanWslcSetup } from './contract.js';
+/**
+ * Turn what a readiness inspection found into the steps that fix it. Pure: the
+ * same facts give the same plan and the same id. Steps come from the facts, not
+ * only from the headline state.
+ */
+export declare const planWslcSetup: PlanWslcSetup;
+//# sourceMappingURL=plan.d.ts.map

package/dist/local-virtual-computer/setup/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAKb,MAAM,eAAe,CAAA;AAiCtB;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAkG3B,CAAA"}

package/dist/local-virtual-computer/setup/plan.js

@@ -0,0 +1,131 @@
+import { createHash } from 'node:crypto';
+import { wslcAtLeastMinimum } from './readiness.js';
+import { PINNED_WSL_PACKAGE } from './wsl-package.js';
+/** Rough durations for the sentence the person reads; not promises. */
+const ENABLE_FEATURES_SECONDS = 90;
+const INSTALL_WSL_SECONDS = 60;
+const RESTART_SECONDS = 90;
+/** Bytes per second assumed for a download and for loading the image. */
+const DOWNLOAD_BYTES_PER_SECOND = 8_000_000;
+/** Measured on a real PC: 3.2 s for the 323 MB archive, so about 5 s plus 150 MB/s. */
+const LOAD_BYTES_PER_SECOND = 150_000_000;
+const LOAD_FIXED_SECONDS = 5;
+const BLOCKED = {
+    unsupported: 'unsupported',
+    'blocked-by-policy': 'blocked-by-policy',
+    'virtualization-off': 'virtualization-off',
+    'sdk-mismatch': 'sdk-mismatch',
+};
+/** JSON with sorted keys, so equal plans digest equally. */
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (typeof value === 'object' && value !== null) {
+        const entries = Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Turn what a readiness inspection found into the steps that fix it. Pure: the
+ * same facts give the same plan and the same id. Steps come from the facts, not
+ * only from the headline state.
+ */
+export const planWslcSetup = (readiness, options) => {
+    const pinned = options.wslPackage ?? PINNED_WSL_PACKAGE;
+    const manifest = options.manifest;
+    const finish = (steps, blocked) => {
+        const id = createHash('sha256')
+            .update(canonical({
+            state: readiness.state,
+            steps,
+            blocked,
+            wslVersion: pinned.version,
+            manifest: manifest?.sha256 ?? null,
+        }))
+            .digest('hex');
+        return {
+            id,
+            state: readiness.state,
+            steps,
+            elevationPrompts: steps.some((step) => step.elevated) ? 1 : 0,
+            mayRequireRestart: steps.some((step) => step.mayRequireRestart),
+            ...(blocked ? { blocked } : {}),
+        };
+    };
+    const blocked = BLOCKED[readiness.state];
+    if (blocked)
+        return finish([], blocked);
+    if (readiness.state === 'ready')
+        return finish([]);
+    const hasImage = readiness.image.bundled !== undefined || manifest !== undefined;
+    const loadImage = () => ({
+        kind: 'load-image',
+        elevated: false,
+        ...(manifest ? { diskBytes: manifest.sizeBytes } : {}),
+        estimatedSeconds: manifest
+            ? LOAD_FIXED_SECONDS + Math.ceil(manifest.compressedBytes / LOAD_BYTES_PER_SECOND)
+            : 60,
+        mayRequireRestart: false,
+    });
+    const needImage = !readiness.image.loaded;
+    if (readiness.state === 'restart-pending') {
+        const steps = [
+            {
+                kind: 'restart',
+                elevated: false,
+                estimatedSeconds: RESTART_SECONDS,
+                mayRequireRestart: true,
+            },
+        ];
+        if (needImage) {
+            if (!hasImage)
+                return finish([], 'image-unavailable');
+            steps.push(loadImage());
+        }
+        return finish(steps);
+    }
+    const wslcVersion = readiness.wsl.wslcVersion;
+    const needWsl = wslcVersion === undefined || !wslcAtLeastMinimum(wslcVersion);
+    const needFeatures = readiness.components.virtualMachinePlatform === false ||
+        readiness.components.wslOptionalComponent === false;
+    if (needImage && !hasImage)
+        return finish([], 'image-unavailable');
+    const steps = [];
+    if (needWsl)
+        steps.push({
+            kind: 'download-wsl',
+            elevated: false,
+            downloadBytes: pinned.sizeBytes,
+            diskBytes: pinned.sizeBytes,
+            estimatedSeconds: Math.ceil(pinned.sizeBytes / DOWNLOAD_BYTES_PER_SECOND),
+            mayRequireRestart: false,
+        });
+    if (needFeatures)
+        steps.push({
+            kind: 'enable-windows-features',
+            elevated: true,
+            estimatedSeconds: ENABLE_FEATURES_SECONDS,
+            mayRequireRestart: true,
+        });
+    if (needWsl)
+        steps.push({
+            kind: 'install-wsl',
+            elevated: true,
+            estimatedSeconds: INSTALL_WSL_SECONDS,
+            mayRequireRestart: true,
+        });
+    if (needFeatures)
+        steps.push({
+            kind: 'restart',
+            elevated: false,
+            estimatedSeconds: RESTART_SECONDS,
+            mayRequireRestart: true,
+        });
+    if (needImage)
+        steps.push(loadImage());
+    return finish(steps);
+};
+//# sourceMappingURL=plan.js.map

package/dist/local-virtual-computer/setup/plan.js.map

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

package/dist/local-virtual-computer/setup/readiness.d.ts

@@ -0,0 +1,11 @@
+import type { InspectWslcReadiness } from './contract.js';
+/** `wsl.exe --version` is UTF-16LE and localised: strip NULs, never read a label. */
+export declare function parseWslVersion(output: string): string | undefined;
+export declare function wslcAtLeastMinimum(version: string): boolean;
+/**
+ * Inspect the PC without changing anything. Without `probeSession` no command
+ * runs that starts the wslc session (`wslc version` does not; `ps` and `image`
+ * do), so opening a panel never starts a virtual machine.
+ */
+export declare const inspectWslcReadiness: InspectWslcReadiness;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/local-virtual-computer/setup/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/local-virtual-computer/setup/readiness.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,oBAAoB,EAKpB,MAAM,eAAe,CAAA;AAqBtB,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ3D;AA4KD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBA+JlC,CAAA"}