@atomic-chat/core 0.5.1 → 0.13.2

package/dist/runtime/environment/windows-host.js

@@ -0,0 +1,163 @@
+/**
+ * The Windows machine as the Windows provisioner reaches it (change `add-tensorrt-llm-windows`,
+ * task 2.3): the read-only probe's dependencies (`WindowsProbeDeps`), where the user's own
+ * distribution directory lives (`%LOCALAPPDATA%`), and the two disk facts the plan and the snapshot
+ * show — free space on that directory's volume, and how big the distribution's `ext4.vhdx` has grown.
+ * `windows-probe.ts` and `windows-plan.ts` stay pure; this is where the real machine comes in.
+ */
+import { readFileSync } from 'node:fs';
+import { stat, statfs, readFile } from 'node:fs/promises';
+import { machine as osMachine, release as osRelease } from 'node:os';
+import { dirname, join, win32 } from 'node:path';
+import { createWsl } from '../wsl/index.js';
+import { hostExec } from './host-exec.js';
+/** The fixed name Atomic Chat registers its own distribution under (design D9). */
+export const ATOMIC_CHAT_DISTRIBUTION = 'AtomicChat';
+/** Where Atomic Chat's own distribution lives: `%LOCALAPPDATA%\AtomicChat\wsl\<name>`. */
+export function distributionDirectory(localAppData, name = ATOMIC_CHAT_DISTRIBUTION) {
+    return win32.join(localAppData, 'AtomicChat', 'wsl', name);
+}
+/** The disk image WSL keeps a distribution in, inside its directory. */
+export function distributionDisk(directory) {
+    return win32.join(directory, 'ext4.vhdx');
+}
+async function readIfPresent(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+/** Free space at the nearest ancestor of `path` that exists: the distribution's directory may not yet. */
+export async function freeBytesAtNearest(path) {
+    let current = path;
+    for (;;) {
+        try {
+            const info = await statfs(current);
+            return Number(info.bavail) * Number(info.bsize);
+        }
+        catch (error) {
+            const code = error.code;
+            const parent = dirname(current);
+            if ((code !== 'ENOENT' && code !== 'ENOTDIR') || parent === current)
+                return null;
+            current = parent;
+        }
+    }
+}
+/** The real machine. `wsl` and `exec` are injectable so a test can run it without spawning anything. */
+export function realWindowsHost(env, wsl = createWsl(), exec = hostExec()) {
+    const systemRoot = env['SystemRoot'] ?? env['SYSTEMROOT'] ?? 'C:\\Windows';
+    const profile = env['USERPROFILE'] ?? '';
+    return {
+        probeDeps: {
+            wsl,
+            exec: (command, args) => exec(command, args),
+            systemRoot,
+            machine: osMachine,
+            release: osRelease,
+            readWslConfig: () => profile === '' ? Promise.resolve(null) : readIfPresent(win32.join(profile, '.wslconfig')),
+            pathExists: async (path) => {
+                try {
+                    await stat(path);
+                    return true;
+                }
+                catch (error) {
+                    const code = error.code;
+                    if (code === 'ENOENT' || code === 'ENOTDIR')
+                        return false;
+                    throw error;
+                }
+            },
+        },
+        localAppData: env['LOCALAPPDATA'] ?? win32.join(profile, 'AppData', 'Local'),
+        freeDiskBytes: freeBytesAtNearest,
+        fileSize: async (path) => {
+            try {
+                return (await stat(path)).size;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+/**
+ * Test hook only, the same kind as `ATOMIC_MANAGED_TEST_HOST`: production never sets it. It names a
+ * folder standing in for a whole Windows machine with WSL, so the compiled core's e2e suite drives the
+ * Windows managed path on any OS:
+ *
+ * - `windows.json` — the machine (`os.machine()`, `os.release()`, elevated or not, firmware
+ *   virtualization, the NVIDIA driver and cards, `.wslconfig`'s text, the volume's free space, the
+ *   distribution disk's size), read again at every call so a test can change it mid-run (a restart);
+ * - `wsl-command.json` — the argv `wsl.exe` is: a Node executable and `test/helpers/fake-wsl.mjs` with
+ *   its state folder;
+ * - `local-app-data/` — `%LOCALAPPDATA%`;
+ * - `guest-fs/` — the guests' file systems, standing in for `\\wsl.localhost`.
+ */
+export const MANAGED_TEST_WINDOWS_ENV = 'ATOMIC_MANAGED_TEST_WINDOWS';
+export function managedTestWindowsDir(env) {
+    const dir = env[MANAGED_TEST_WINDOWS_ENV];
+    return dir === undefined || dir.trim() === '' ? null : dir;
+}
+/** The machine a test describes in `dir` (see `MANAGED_TEST_WINDOWS_ENV`). */
+export function testWindowsHost(dir) {
+    const machine = async () => JSON.parse(await readFile(join(dir, 'windows.json'), 'utf8'));
+    const [executable, ...executableArgs] = JSON.parse(readFileSync(join(dir, 'wsl-command.json'), 'utf8'));
+    const wsl = createWsl({ executable: executable, executableArgs });
+    let snapshot = JSON.parse(readFileSync(join(dir, 'windows.json'), 'utf8'));
+    const fresh = async () => (snapshot = await machine());
+    return {
+        probeDeps: {
+            wsl,
+            exec: async (command, args) => {
+                const current = await fresh();
+                const base = command.split(/[\\/]/).pop()?.toLowerCase();
+                if (base === 'nvidia-smi.exe') {
+                    if (current.nvidia === null)
+                        return { code: null, stdout: '', stderr: 'not found' };
+                    if (current.nvidia.gpus.length === 0)
+                        return { code: 6, stdout: 'No devices were found\n', stderr: '' };
+                    const { driver, gpus } = current.nvidia;
+                    return {
+                        code: 0,
+                        stdout: gpus
+                            .map((g) => `${g.uuid}, ${g.name}, ${g.cc}, ${g.total_mib}, ${g.free_mib}, ${driver}\n`)
+                            .join(''),
+                        stderr: '',
+                    };
+                }
+                if (base === 'whoami.exe') {
+                    const label = current.elevated ? 'S-1-16-12288' : 'S-1-16-8192';
+                    return { code: 0, stdout: `"Mandatory Label\\Level","Label","${label}",""\r\n`, stderr: '' };
+                }
+                if (base === 'powershell.exe') {
+                    if (current.virtualization === 'unreadable')
+                        return { code: 1, stdout: '', stderr: 'CIM failed' };
+                    return {
+                        code: 0,
+                        stdout: JSON.stringify({
+                            VirtualizationFirmwareEnabled: current.virtualization.firmware,
+                            HypervisorPresent: current.virtualization.hypervisor,
+                        }),
+                        stderr: '',
+                    };
+                }
+                void args;
+                return { code: null, stdout: '', stderr: `test windows host: unexpected ${command}` };
+            },
+            systemRoot: 'C:\\Windows',
+            machine: () => snapshot.machine,
+            release: () => snapshot.release,
+            readWslConfig: async () => (await fresh()).wslconfig,
+            pathExists: async (path) => !/nvidia-smi\.exe$/i.test(path) || (await fresh()).nvidia !== null,
+        },
+        localAppData: join(dir, 'local-app-data'),
+        freeDiskBytes: async () => (await fresh()).volume_free_bytes,
+        fileSize: async () => (await fresh()).vhdx_bytes,
+    };
+}
+//# sourceMappingURL=windows-host.js.map

package/dist/runtime/environment/windows-host.js.map

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

package/dist/runtime/environment/windows-plan.d.ts

@@ -0,0 +1,78 @@
+/**
+ * What a Windows machine needs before TensorRT-LLM can run on it (change `add-tensorrt-llm-windows`,
+ * task 2.3; spec `wsl-runtime-environment`): the facts `probeWindowsHost` read, the guest's own facts
+ * when Atomic Chat's distribution exists, and the manifest, turned into a verdict — the blockers, and
+ * the changes a setup would make. Pure: no I/O, so every scenario is a table row.
+ *
+ * The order of the gates is the order a person can act on them. First what makes the provider
+ * pointless to show at all (`unsupported`): a machine that is not x64, no manifest and nothing
+ * imported yet, a Windows build below the manifest's minimum. Then what blocks a plan
+ * (`prerequisite-blocked`): this core running elevated (its `wsl.exe` would see another user's
+ * registrations, design D2), a distribution with Atomic Chat's name it never imported, the NVIDIA
+ * driver and card, virtualization off in the firmware, a WSL older than the manifest asks, our own
+ * distribution registered as WSL 1, whatever the guest itself blocks on, and the disk. Everything
+ * else is the plan: enable WSL (the one elevated step, which may need a restart), import the
+ * distribution, provision the guest with the Linux recipe.
+ *
+ * The guest is judged by `assessLinux`, exactly as a Linux host (design D1), with one substitution:
+ * the driver version it compares is the NVIDIA library version WSL hands the guest, not the number
+ * the guest's `nvidia-smi` prints (that is the Windows driver's; design D10).
+ */
+import type { ManagedAvailability, ManagedSystemChange, WindowsEnvironmentManifest } from '../../contracts/index.js';
+import type { GuestExtras } from './guest-host.js';
+import { type LinuxBlocker, type LinuxInstallPlan } from './linux-plan.js';
+import type { LinuxFacts } from './linux-probe.js';
+import type { WindowsHostFacts, WslDistribution } from './windows-probe.js';
+/** Room a fresh guest takes before any image: Ubuntu's base system, Docker Engine and the toolkit. */
+export declare const GUEST_BASE_BYTES: number;
+export type WindowsBlockerReason = LinuxBlocker['reason'] | 'windows-build-too-old' | 'elevated-process' | 'foreign-distribution' | 'virtualization-disabled' | 'wsl-version' | 'wsl1-distribution' | 'windows-restart-pending';
+export interface WindowsBlocker {
+    reason: WindowsBlockerReason;
+    message: string;
+    params?: Record<string, string>;
+    commands?: string[];
+}
+export interface WindowsAssessmentInput {
+    facts: WindowsHostFacts;
+    /** The manifest this probe judges by: the pinned one for an existing environment, else the latest. */
+    manifest: WindowsEnvironmentManifest | null;
+    /** Atomic Chat's own distribution: the recorded one, as `wsl --list` shows it. Null when not registered. */
+    owned: WslDistribution | null;
+    /** A distribution with Atomic Chat's name exists that no record says is ours. */
+    foreign: boolean;
+    /** Where ours is or would be. */
+    distribution: {
+        name: string;
+        path: string;
+    };
+    /** Free bytes on that directory's volume. */
+    volumeFreeBytes: number | null;
+    /** The guest's facts, when ours exists and could be entered. */
+    guest: {
+        facts: LinuxFacts;
+        extras: GuestExtras;
+    } | null;
+    guestRecipeId: string;
+    minimumDriverVersion: string;
+    minimumComputeCapability: string;
+    /** What the engine image still needs on disk; null when nothing is left to pull (or no image at all). */
+    requiredDiskBytes: number | null;
+}
+export interface WindowsAssessment {
+    availability: ManagedAvailability;
+    /** Ours exists and its guest already runs containers on the GPU: nothing to change. */
+    adopts_existing_engine: boolean;
+    blockers: WindowsBlocker[];
+    /** The one elevated step: `wsl --install`. */
+    enable_wsl: boolean;
+    import_distribution: boolean;
+    /** The guest recipe's own plan, when ours exists and still needs it. */
+    guest_plan: LinuxInstallPlan | null;
+    provision_guest: boolean;
+    system_changes: ManagedSystemChange[];
+    /** The smaller of the volume's and the guest's free space; null when neither could be read. */
+    free_disk_bytes: number | null;
+    /** Whether that covers what is still needed; null when it could not be told. */
+    disk_sufficient: boolean | null;
+}
+export declare function assessWindowsHost(input: WindowsAssessmentInput): WindowsAssessment;

package/dist/runtime/environment/windows-plan.js

@@ -0,0 +1,216 @@
+/**
+ * What a Windows machine needs before TensorRT-LLM can run on it (change `add-tensorrt-llm-windows`,
+ * task 2.3; spec `wsl-runtime-environment`): the facts `probeWindowsHost` read, the guest's own facts
+ * when Atomic Chat's distribution exists, and the manifest, turned into a verdict — the blockers, and
+ * the changes a setup would make. Pure: no I/O, so every scenario is a table row.
+ *
+ * The order of the gates is the order a person can act on them. First what makes the provider
+ * pointless to show at all (`unsupported`): a machine that is not x64, no manifest and nothing
+ * imported yet, a Windows build below the manifest's minimum. Then what blocks a plan
+ * (`prerequisite-blocked`): this core running elevated (its `wsl.exe` would see another user's
+ * registrations, design D2), a distribution with Atomic Chat's name it never imported, the NVIDIA
+ * driver and card, virtualization off in the firmware, a WSL older than the manifest asks, our own
+ * distribution registered as WSL 1, whatever the guest itself blocks on, and the disk. Everything
+ * else is the plan: enable WSL (the one elevated step, which may need a restart), import the
+ * distribution, provision the guest with the Linux recipe.
+ *
+ * The guest is judged by `assessLinux`, exactly as a Linux host (design D1), with one substitution:
+ * the driver version it compares is the NVIDIA library version WSL hands the guest, not the number
+ * the guest's `nvidia-smi` prints (that is the Windows driver's; design D10).
+ */
+import { assessLinux, compareDottedVersions } from './linux-plan.js';
+/** Room a fresh guest takes before any image: Ubuntu's base system, Docker Engine and the toolkit. */
+export const GUEST_BASE_BYTES = 4 * 1024 ** 3;
+const blocker = (reason, message, params, commands) => ({
+    reason,
+    message,
+    ...(params === undefined ? {} : { params }),
+    ...(commands === undefined ? {} : { commands }),
+});
+const verdict = (availability, blockers, free = null) => ({
+    availability,
+    adopts_existing_engine: false,
+    blockers,
+    enable_wsl: false,
+    import_distribution: false,
+    guest_plan: null,
+    provision_guest: false,
+    system_changes: [],
+    free_disk_bytes: free,
+    disk_sufficient: null,
+});
+/** The driver and card, read on Windows: what has to be there before WSL is worth enabling. */
+function nvidiaBlockers(facts, minimumComputeCapability) {
+    if (facts.unknown.includes('nvidia-driver'))
+        return [];
+    if (facts.driver_installed === false) {
+        return [
+            blocker('driver-missing', 'No NVIDIA driver was found. Install the NVIDIA driver for your card from nvidia.com, then check again.'),
+        ];
+    }
+    if (facts.gpus.length === 0) {
+        return [blocker('no-gpu', 'The NVIDIA driver is installed but reports no NVIDIA graphics card.')];
+    }
+    const eligible = facts.gpus.some((gpu) => compareDottedVersions(gpu.compute_capability, minimumComputeCapability) >= 0);
+    if (eligible)
+        return [];
+    const best = facts.gpus
+        .map((gpu) => gpu.compute_capability)
+        .sort((a, b) => compareDottedVersions(b, a))[0];
+    return [
+        blocker('compute-capability-too-low', `TensorRT-LLM needs an NVIDIA card of the Ampere generation (RTX 30xx) or newer; this card has compute capability ${best}.`, { required: minimumComputeCapability, actual: best }),
+    ];
+}
+/** The guest judged as a Linux host, with the library version standing in for the driver's (D10). */
+function guestVerdict(input, guest) {
+    const library = guest.extras.nvidia_library_version;
+    if (library === null) {
+        return {
+            blockers: [
+                blocker('unknown-fact', 'Could not read the version of the NVIDIA libraries Windows provides to the distribution.', { fact: 'nvidia-libraries' }),
+            ],
+            plan: null,
+            adopts: false,
+        };
+    }
+    const facts = {
+        ...guest.facts,
+        driver_version: library,
+        gpus: guest.facts.gpus.map((gpu) => ({ ...gpu, driver_version: library })),
+    };
+    const linux = assessLinux(facts, {
+        recipeId: input.guestRecipeId,
+        recipeDistributions: input.manifest === null ? null : [input.manifest.rootfs.distribution],
+        minimumDriverVersion: input.minimumDriverVersion,
+        minimumComputeCapability: input.minimumComputeCapability,
+        // The disk is judged once, for the guest and its volume together (below).
+        requiredDiskBytes: null,
+        currentUser: 'root',
+    });
+    const windowsDriver = input.facts.driver_version ?? guest.facts.driver_version ?? 'unknown';
+    const blockers = linux.blockers
+        // The card was already judged on Windows; the guest sees the same one.
+        .filter((entry) => !['no-gpu', 'compute-capability-too-low', 'driver-missing'].includes(entry.reason))
+        .map((entry) => entry.reason === 'driver-too-old'
+        ? blocker('driver-too-old', `The NVIDIA libraries Windows provides to WSL are version ${library}, older than the ${input.minimumDriverVersion} TensorRT-LLM needs. Update the NVIDIA driver for Windows (now ${windowsDriver}), restart, and check again.`, { required: input.minimumDriverVersion, actual: library, windows_driver: windowsDriver })
+        : { ...entry });
+    return { blockers, plan: linux.install_plan, adopts: linux.adopts_existing_engine };
+}
+export function assessWindowsHost(input) {
+    const { facts, manifest } = input;
+    // What makes the provider pointless to show here at all: an architecture with no rootfs, or a
+    // manifest whose rootfs is for the other one (Windows on Arm reads `windows-arm64.json`).
+    const architecture = facts.architecture;
+    if ((architecture !== 'x86_64' && architecture !== 'aarch64') ||
+        (manifest !== null && manifest.rootfs.distribution.arch !== architecture)) {
+        return verdict('unsupported', [
+            blocker('unsupported-architecture', architecture === 'aarch64'
+                ? 'TensorRT-LLM is not available for Windows on Arm on this version of Atomic Chat yet.'
+                : 'TensorRT-LLM on Windows needs a 64-bit PC (x64 or Arm).', { actual: architecture ?? 'unknown' }),
+        ]);
+    }
+    if (manifest === null && input.owned === null) {
+        return verdict('unsupported', [
+            blocker('environment-manifest-unavailable', 'TensorRT-LLM is not available for Windows yet: the description of the Windows environment could not be loaded.'),
+        ]);
+    }
+    if (manifest !== null && input.owned === null && facts.windows_build !== null) {
+        if (facts.windows_build < manifest.minimum_windows_build) {
+            return verdict('unsupported', [
+                blocker('windows-build-too-old', 'TensorRT-LLM on Windows needs Windows 11.', {
+                    required: String(manifest.minimum_windows_build),
+                    actual: String(facts.windows_build),
+                }),
+            ]);
+        }
+    }
+    const blockers = [];
+    for (const name of facts.unknown) {
+        blockers.push(blocker('unknown-fact', `Could not determine ${name} on this system.`, { fact: name }));
+    }
+    if (facts.elevated === true) {
+        blockers.push(blocker('elevated-process', 'Atomic Chat is running as administrator. Close it and start it normally: the WSL distribution has to belong to your own account.'));
+    }
+    if (input.foreign) {
+        blockers.push(blocker('foreign-distribution', `A WSL distribution named "${input.distribution.name}" already exists, and Atomic Chat did not create it. It will not be used or changed. Rename or remove it, then check again.`, { name: input.distribution.name }));
+    }
+    blockers.push(...nvidiaBlockers(facts, input.minimumComputeCapability));
+    const wslReady = facts.wsl.installed === true && facts.wsl.ready === true;
+    // WSL is in and the VM platform is on, but Windows has not restarted yet: no second elevation.
+    const restartPending = facts.wsl.installed === true && facts.wsl.reboot_pending === true && !wslReady;
+    if (restartPending) {
+        blockers.push(blocker('windows-restart-pending', 'Windows needs a restart to finish turning on the Windows Subsystem for Linux. Restart the computer, open Atomic Chat again and check again.'));
+    }
+    const enableWsl = facts.wsl.installed !== null && !wslReady && !restartPending;
+    if (enableWsl && facts.virtualization === false) {
+        blockers.push(blocker('virtualization-disabled', 'Virtualization is turned off in this computer’s firmware (BIOS/UEFI). Turn on Intel VT-x or AMD-V (SVM) there, restart, and check again; no installer can do this for you.'));
+    }
+    if (manifest !== null && facts.wsl.installed === true && facts.wsl.version !== null) {
+        if (compareDottedVersions(facts.wsl.version, manifest.minimum_wsl_version) < 0) {
+            blockers.push(blocker('wsl-version', `WSL ${facts.wsl.version} is installed; TensorRT-LLM needs ${manifest.minimum_wsl_version} or newer. Update it with the command below, then check again.`, { required: manifest.minimum_wsl_version, actual: facts.wsl.version }, ['wsl --update']));
+        }
+    }
+    if (input.owned !== null && input.owned.version !== 2) {
+        blockers.push(blocker('wsl1-distribution', `The Atomic Chat distribution "${input.owned.name}" is registered as WSL 1, which cannot run TensorRT-LLM. Atomic Chat does not convert it; remove the environment and set it up again.`, { name: input.owned.name }));
+    }
+    const importDistribution = input.owned === null && !input.foreign;
+    let guestPlan = null;
+    let guestAdopts = false;
+    if (input.guest !== null) {
+        const guest = guestVerdict(input, input.guest);
+        blockers.push(...guest.blockers);
+        guestPlan = guest.plan;
+        guestAdopts = guest.adopts;
+    }
+    const provisionGuest = importDistribution || guestPlan !== null;
+    // The disk: what is still needed against the smaller of the volume and the guest.
+    const needed = input.requiredDiskBytes === null && !importDistribution
+        ? null
+        : (input.requiredDiskBytes ?? 0) + (importDistribution ? GUEST_BASE_BYTES : 0);
+    const guestFree = input.guest?.facts.free_disk_bytes ?? null;
+    const frees = [input.volumeFreeBytes, guestFree].filter((value) => value !== null);
+    const free = frees.length === 0 ? null : Math.min(...frees);
+    const sufficient = needed === null ? true : free === null ? null : free >= needed;
+    if (sufficient === false) {
+        blockers.push(blocker('insufficient-disk', `There is not enough free space for TensorRT-LLM in ${input.distribution.path}: it needs ${needed} bytes and ${free} are free.`, { required: String(needed), free: String(free), path: input.distribution.path }));
+    }
+    const changes = [];
+    if (enableWsl && facts.virtualization !== false) {
+        changes.push({
+            code: 'enable-wsl',
+            text: 'Turn on the Windows Subsystem for Linux (wsl --install). Windows asks for administrator approval and a restart is needed. Windows also installs its default Ubuntu distribution, which may open its own setup window after the restart; Atomic Chat does not use it, and you can close that window.',
+        });
+    }
+    if (importDistribution && manifest !== null) {
+        const { id, version_id } = manifest.rootfs.distribution;
+        changes.push({
+            code: 'import-distribution',
+            text: `Download ${id} ${version_id} and import it as Atomic Chat’s own WSL distribution "${input.distribution.name}" in ${input.distribution.path}. Your other distributions and your default one are not touched.`,
+            params: { name: input.distribution.name, path: input.distribution.path, rootfs: manifest.rootfs.url },
+        });
+    }
+    if (provisionGuest) {
+        const inside = guestPlan?.system_changes ?? [];
+        changes.push({
+            code: 'provision-distribution',
+            text: inside.length === 0
+                ? 'Inside it, install Docker Engine and the NVIDIA Container Toolkit and generate the NVIDIA CDI specification.'
+                : `Inside it: ${inside.map((change) => change.text).join(' ')}`,
+            params: { components: inside.map((change) => change.code).join(',') },
+        });
+    }
+    const adopts = blockers.length === 0 && wslReady && input.owned !== null && guestAdopts && !provisionGuest;
+    return {
+        availability: blockers.length > 0 ? 'prerequisite-blocked' : 'setup-required',
+        adopts_existing_engine: adopts,
+        blockers,
+        enable_wsl: enableWsl && facts.virtualization !== false,
+        import_distribution: importDistribution,
+        guest_plan: guestPlan,
+        provision_guest: provisionGuest,
+        system_changes: blockers.length > 0 ? [] : changes,
+        free_disk_bytes: free,
+        disk_sufficient: sufficient,
+    };
+}
+//# sourceMappingURL=windows-plan.js.map

package/dist/runtime/environment/windows-plan.js.map

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

package/dist/runtime/environment/windows-probe.d.ts

@@ -0,0 +1,135 @@
+/**
+ * What a Windows machine can already do, read without changing any of it (change
+ * `add-tensorrt-llm-windows`, task 2.3; spec `wsl-runtime-environment`, "Probe Windows-хоста без
+ * изменений на машине").
+ *
+ * Windows never adopts the user's own container setup: the engine runs inside a WSL distribution
+ * Atomic Chat imports and owns, so this probe answers a narrower question than Linux's — can this
+ * machine host one, what has to be turned on first, and is ours already there. What happens inside
+ * that distribution is the Linux probe's job, run in the guest (`guest-host.ts`, design D1).
+ *
+ * Every read here works for a standard user. `Get-WindowsOptionalFeature -Online` would say whether
+ * the WSL components are on, but it needs an administrator, and the core never runs elevated (design
+ * D2); `wsl.exe` itself says it instead — `--version` answers only once the WSL package is installed,
+ * `--status` only once its components can start a VM. The rest: firmware virtualization from CIM
+ * (`Win32_Processor`, or a hypervisor already running, which proves it), the driver and cards from the
+ * Windows `nvidia-smi`, this process's integrity level from `whoami /groups`, the network and memory
+ * settings from `%UserProfile%\.wslconfig` (read, never written).
+ *
+ * A fact that could not be read lands in `unknown` — never assumed present or absent — and the plan
+ * (`windows-plan.ts`) decides what that blocks. Every command `wsl.exe` writes may arrive as UTF-16;
+ * the transport decodes it (`decodeWslBytes`), and `decodeWslOutput` still copes with a caller that
+ * read it as UTF-8 and left a NUL between every character.
+ */
+import type { GpuFacts } from '../../contracts/index.js';
+import type { Wsl, WslCommandOutput } from '../wsl/index.js';
+import { type CommandOutput } from './linux-probe.js';
+/** One row of `wsl --list --verbose`. */
+export interface WslDistribution {
+    name: string;
+    state: string;
+    /** WSL 1 and WSL 2 are different machines; only 2 can carry this runtime. */
+    version: number | null;
+    is_default: boolean;
+}
+/** `%UserProfile%\.wslconfig`'s `[wsl2]` settings this integration reads — and never writes. */
+export interface WslConfigFacts {
+    /** `networkingMode` (`nat`, `mirrored`, …), lowercase; null when not set (WSL's default is NAT). */
+    networking_mode: string | null;
+    /** `localhostForwarding`; null when not set (WSL's default is on). */
+    localhost_forwarding: boolean | null;
+    /** `memory` as written (`16GB`); null when not set (WSL's default is half of the RAM). */
+    memory: string | null;
+}
+export interface WslFacts {
+    /** The WSL package answers `--version`; false for the inbox stub of a machine without it. */
+    installed: boolean | null;
+    /** `MAJOR.MINOR.PATCH` of the package (`--version`'s first line, its fourth part dropped). */
+    version: string | null;
+    /**
+     * `--status` answers and Windows is not waiting for a restart: a WSL 2 VM can start. Null when not
+     * asked. `--status` alone is not enough: right after `wsl --install` it exits 0 while saying WSL 2
+     * cannot start until the restart (live acceptance, build 26200). `RebootPending` alone is not enough
+     * either: CBS can recreate it empty at every boot (live, build 26200, 2026-10-05), so when it is set
+     * the probe starts the WSL system distribution, and a VM that boots is ready.
+     */
+    ready: boolean | null;
+    /** Windows has a component change waiting for a restart (CBS `RebootPending`). Null when unread. */
+    reboot_pending: boolean | null;
+}
+/** The CBS key Windows keeps while a component change (such as the VM platform) waits for a restart. */
+export declare const REBOOT_PENDING_KEY = "HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Component Based Servicing\\RebootPending";
+/** `reg.exe query` of the key: 0 when it exists (a restart is pending), 1 when it does not. */
+export declare function parseRebootPending(output: CommandOutput | null): boolean | null;
+export interface WindowsHostFacts {
+    /** `x86_64`, `aarch64`, …: the machine's own architecture, not an emulated process's. */
+    architecture: string | null;
+    /** The third part of the OS version (`10.0.22631` → 22631). */
+    windows_build: number | null;
+    /** This process runs at high integrity (an administrator's elevated token). */
+    elevated: boolean | null;
+    wsl: WslFacts;
+    /** Firmware virtualization is on (or a hypervisor runs, which proves it). Null when unread or not asked. */
+    virtualization: boolean | null;
+    /** The NVIDIA driver is installed: its `nvidia-smi.exe` is in System32. Null when that could not be told. */
+    driver_installed: boolean | null;
+    /** The Windows driver's own version (`591.44`), from the Windows `nvidia-smi`; null without a card. */
+    driver_version: string | null;
+    gpus: GpuFacts[];
+    distributions: WslDistribution[];
+    wslconfig: WslConfigFacts;
+    /** Named checks whose answer could not be read. */
+    unknown: string[];
+}
+/** What `probeWindowsHost` reads the machine through. */
+export interface WindowsProbeDeps {
+    wsl: Wsl;
+    /** A read-only command on Windows (PowerShell, `whoami`, `nvidia-smi`): `hostExec` in production. */
+    exec: (command: string, args: string[]) => Promise<CommandOutput>;
+    /** `%SystemRoot%`, where the system's own `nvidia-smi.exe`, `whoami.exe` and `powershell.exe` live. */
+    systemRoot: string;
+    /** `os.machine()`. */
+    machine: () => string;
+    /** `os.release()`: `10.0.<build>`. */
+    release: () => string;
+    /** `%UserProfile%\.wslconfig`'s text; null when there is none. Rejects when it exists but cannot be read. */
+    readWslConfig: () => Promise<string | null>;
+    /** Whether a file exists: false only when it is not there, a rejection when that cannot be told. */
+    pathExists: (path: string) => Promise<boolean>;
+}
+/** `wsl.exe` speaks UTF-16; a caller that read it as UTF-8 leaves a NUL between every character. */
+export declare function decodeWslOutput(text: string): string;
+/** `os.machine()` in Linux's spelling: `x86_64` (Node may say `x86_64` or `AMD64`), `aarch64` for ARM. */
+export declare function normalizeWindowsArchitecture(machine: string): string;
+/** `os.release()` on Windows is `10.0.<build>`; the build is what minimum versions compare. */
+export declare function parseWindowsBuild(release: string): number | null;
+/**
+ * `wsl --version`: the package version is on the first line, whatever language its label is in
+ * (`WSL version: 2.4.4.0`, `Версия WSL: 2.4.4.0`). Four parts on the wire; the manifest compares three
+ * (conf ruling 1.1), so the build part is dropped here.
+ */
+export declare function parseWslVersion(output: WslCommandOutput | null): string | null;
+/**
+ * `wsl --list --verbose`: a header, then one line per distribution, the default marked with `*`.
+ * The header's own words change with the display language, so a row is recognised by shape instead:
+ * a real one ends in a version number. No distributions at all is a nonzero exit — an empty list.
+ */
+export declare function parseWslDistributions(output: WslCommandOutput | null): WslDistribution[];
+/**
+ * The CIM answer (`VirtualizationFirmwareEnabled`, `HypervisorPresent`): a running hypervisor proves
+ * virtualization is on — and then the processor reports the firmware flag as false, so it is checked
+ * first. Anything unreadable is null.
+ */
+export declare function parseVirtualization(output: CommandOutput | null): boolean | null;
+/** `whoami /groups /fo csv /nh`: the mandatory label says whether this token is elevated. */
+export declare function parseElevation(output: CommandOutput | null): boolean | null;
+/** `.wslconfig` is INI; only `[wsl2]` matters, keys case-insensitive, `#`/`;` comments. */
+export declare function parseWslConfig(text: string | null): WslConfigFacts;
+/**
+ * Read the machine. Nothing here enables a component, imports, starts or stops a distribution, or
+ * writes a file — except that with `RebootPending` set it boots WSL's own system distribution once to
+ * see whether a VM can start (it idles out on its own). `wsl --status` and the firmware check are asked only when they can change the
+ * answer: a package that is not installed has no status, and a WSL that already starts VMs proves
+ * virtualization.
+ */
+export declare function probeWindowsHost(deps: WindowsProbeDeps): Promise<WindowsHostFacts>;