@atomic-chat/core 0.5.1 → 0.13.2

package/dist/hardware/probe-common.d.ts

@@ -0,0 +1,72 @@
+/**
+ * What the per-platform probes share: the injected dependency surface, the result shape, the budgets,
+ * and the facts every platform reads the same way from `node:os`. Kept apart from `probe.ts` (the
+ * runner and dispatcher) so the platform files and the dispatcher do not import each other.
+ */
+import type { SystemInfo } from '../contracts/index.js';
+import type { NvidiaSmiGpu } from './merge.js';
+/** Per-tool budget: `nvidia-smi`, `vulkaninfo`, `sysctl`, `sw_vers`. */
+export declare const PROBE_TOOL_TIMEOUT_MS = 5000;
+/** PowerShell starts cold in seconds, more on a loaded machine; `Add-Type` compiles on top of that. */
+export declare const PROBE_POWERSHELL_TIMEOUT_MS = 15000;
+/** The runner's stdout cap; a `vulkaninfo --summary` is a few KiB, `/proc/cpuinfo` on a big host a few hundred. */
+export declare const PROBE_MAX_OUTPUT_BYTES: number;
+export interface ToolResult {
+    stdout: string;
+    stderr: string;
+    /** The exit code; `null` when the process ended on a signal. */
+    code: number | null;
+}
+export interface ProbeFs {
+    readFile: (path: string) => Promise<string>;
+    readdir: (path: string) => Promise<string[]>;
+    exists: (path: string) => Promise<boolean>;
+    readlink: (path: string) => Promise<string>;
+}
+export interface ProbeDeps {
+    platform: NodeJS.Platform | string;
+    /** Node spelling (`x64`, `arm64`); the probe converts. */
+    arch: string;
+    env: NodeJS.ProcessEnv;
+    /**
+     * Run a tool. Resolves with the exit code on a non-zero exit (the caller reads `stderr`); rejects
+     * only when the tool could not be started (not found, not executable) or did not finish in time.
+     */
+    run: (file: string, args: string[], timeoutMs: number) => Promise<ToolResult>;
+    fs: ProbeFs;
+    os: {
+        totalmem: () => number;
+        cpus: () => Array<{
+            model: string;
+        }>;
+    };
+}
+export interface HardwareProbeResult {
+    info: SystemInfo;
+    /** What could not be read, one line each. */
+    warnings: string[];
+}
+/** The facts every platform reads the same way, from `node:os`. */
+export interface CommonFacts {
+    /** Rust spelling. */
+    arch: string;
+    totalMemoryMiB: number;
+    /** `os.cpus()[0].model`, the fallback when the platform tool does not name the CPU. */
+    cpuName: string | undefined;
+    logicalCores: number;
+}
+export declare function commonFacts(deps: ProbeDeps): CommonFacts;
+/** The one line a failed step becomes. */
+export declare function warningOf(step: string, error: unknown): string;
+/** CPU name, core count, memory and OS type from `node:os` alone: no flags, no GPUs. */
+export declare function fallbackProbe(deps: ProbeDeps): HardwareProbeResult;
+/** A settled step's value, or `undefined` with its failure recorded as a warning. */
+export declare function settledOrWarn<T>(settled: PromiseSettledResult<T>, step: string, warnings: string[]): T | undefined;
+/**
+ * The first candidate that starts decides: a refusal of `compute_cap` is retried with the legacy fields
+ * on the same binary; any other failure is reported (the driver is not loaded, the GPU is lost). No
+ * candidate starting is the normal case on a machine without an NVIDIA driver, not a warning.
+ */
+export declare function runNvidiaSmi(deps: ProbeDeps): Promise<NvidiaSmiGpu[]>;
+/** The first non-blank line of a tool's output, for a warning. */
+export declare function firstLine(text: string): string;

package/dist/hardware/probe-common.js

@@ -0,0 +1,106 @@
+/**
+ * What the per-platform probes share: the injected dependency surface, the result shape, the budgets,
+ * and the facts every platform reads the same way from `node:os`. Kept apart from `probe.ts` (the
+ * runner and dispatcher) so the platform files and the dispatcher do not import each other.
+ */
+import { osTypeOf, rustArch } from './facts.js';
+import { NVIDIA_SMI_FIELDS, NVIDIA_SMI_FIELDS_LEGACY, isUnknownFieldError, nvidiaBusIdOf, nvidiaGpuFromRow, nvidiaSmiArgs, nvidiaSmiCandidates, parseNvidiaSmiCsv, } from './nvidia-smi.js';
+/** Per-tool budget: `nvidia-smi`, `vulkaninfo`, `sysctl`, `sw_vers`. */
+export const PROBE_TOOL_TIMEOUT_MS = 5_000;
+/** PowerShell starts cold in seconds, more on a loaded machine; `Add-Type` compiles on top of that. */
+export const PROBE_POWERSHELL_TIMEOUT_MS = 15_000;
+/** The runner's stdout cap; a `vulkaninfo --summary` is a few KiB, `/proc/cpuinfo` on a big host a few hundred. */
+export const PROBE_MAX_OUTPUT_BYTES = 4 * 1024 * 1024;
+export function commonFacts(deps) {
+    let cpuList = [];
+    try {
+        cpuList = deps.os.cpus();
+    }
+    catch {
+        // A restricted container can refuse it; the platform probe still names the CPU.
+    }
+    let totalmem = 0;
+    try {
+        totalmem = deps.os.totalmem();
+    }
+    catch {
+        // Same: answer 0 rather than fail the whole probe over one number.
+    }
+    const model = cpuList[0]?.model.trim();
+    return {
+        arch: rustArch(deps.arch),
+        totalMemoryMiB: Math.floor(Math.max(0, Number.isFinite(totalmem) ? totalmem : 0) / 2 ** 20),
+        cpuName: model ? model : undefined,
+        logicalCores: cpuList.length,
+    };
+}
+/** The one line a failed step becomes. */
+export function warningOf(step, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `${step}: ${message}`;
+}
+/** CPU name, core count, memory and OS type from `node:os` alone: no flags, no GPUs. */
+export function fallbackProbe(deps) {
+    const common = commonFacts(deps);
+    return {
+        info: {
+            cpu: {
+                name: common.cpuName ?? 'Unknown CPU',
+                core_count: common.logicalCores,
+                arch: common.arch,
+                extensions: [],
+                extensions_known: false,
+            },
+            os_type: osTypeOf(deps.platform),
+            os_name: String(deps.platform),
+            total_memory: common.totalMemoryMiB,
+            gpus: [],
+        },
+        warnings: [],
+    };
+}
+/** A settled step's value, or `undefined` with its failure recorded as a warning. */
+export function settledOrWarn(settled, step, warnings) {
+    if (settled.status === 'fulfilled')
+        return settled.value;
+    warnings.push(warningOf(step, settled.reason));
+    return undefined;
+}
+/**
+ * The first candidate that starts decides: a refusal of `compute_cap` is retried with the legacy fields
+ * on the same binary; any other failure is reported (the driver is not loaded, the GPU is lost). No
+ * candidate starting is the normal case on a machine without an NVIDIA driver, not a warning.
+ */
+export async function runNvidiaSmi(deps) {
+    for (const candidate of nvidiaSmiCandidates(deps.platform, deps.env)) {
+        let result;
+        try {
+            result = await deps.run(candidate, nvidiaSmiArgs(NVIDIA_SMI_FIELDS), PROBE_TOOL_TIMEOUT_MS);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                continue; // not here; try the next location
+            throw error; // it is here and hung or could not start: worth a warning
+        }
+        let fields = NVIDIA_SMI_FIELDS;
+        if (result.code !== 0 && isUnknownFieldError(result.stderr)) {
+            fields = NVIDIA_SMI_FIELDS_LEGACY;
+            result = await deps.run(candidate, nvidiaSmiArgs(fields), PROBE_TOOL_TIMEOUT_MS);
+        }
+        if (result.code !== 0)
+            throw new Error(`${candidate} exited with ${result.code ?? 'signal'}: ${firstLine(result.stderr) || firstLine(result.stdout)}`);
+        return parseNvidiaSmiCsv(result.stdout, fields).map((row) => {
+            const busId = nvidiaBusIdOf(row);
+            return { gpu: nvidiaGpuFromRow(row), ...(busId ? { busId } : {}) };
+        });
+    }
+    return [];
+}
+/** The first non-blank line of a tool's output, for a warning. */
+export function firstLine(text) {
+    return (text
+        .split(/\r?\n/)
+        .find((line) => line.trim() !== '')
+        ?.trim() ?? '');
+}
+//# sourceMappingURL=probe-common.js.map

package/dist/hardware/probe-common.js.map

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

package/dist/hardware/probe-darwin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * macOS: `sysctl` for the physical core count, the CPU name and (Intel only) the x86 feature lists,
+ * `sw_vers` for the OS name. No GPUs, on purpose: the plugin reported none on macOS either, and the
+ * backend there is a single Metal build that no hardware fact selects between.
+ */
+import type { HardwareProbeResult, ProbeDeps } from './probe-common.js';
+export declare function probeDarwin(deps: ProbeDeps): Promise<HardwareProbeResult>;
+/** RAM the GPU shares with the system: half of it is what the llama.cpp fit margin leaves to the rest. */
+export interface UnifiedMemoryProbe {
+    totalMemoryBytes: number;
+}
+/**
+ * Apple silicon only, where the GPU works out of system RAM; `undefined` on an Intel Mac and on
+ * every other platform. How much of that RAM Metal lets the GPU use is llama.cpp's to report
+ * (`--list-devices`): Apple's rule has changed across macOS releases, and `iogpu.wired_limit_mb`
+ * overrides it.
+ */
+export declare function probeUnifiedMemory(deps: ProbeDeps): UnifiedMemoryProbe | undefined;
+/** `ProductName:\t\tmacOS\nProductVersion:\t\t15.5\n…` → `macOS 15.5`. */
+export declare function parseSwVers(text: string): string;

package/dist/hardware/probe-darwin.js

@@ -0,0 +1,76 @@
+/**
+ * macOS: `sysctl` for the physical core count, the CPU name and (Intel only) the x86 feature lists,
+ * `sw_vers` for the OS name. No GPUs, on purpose: the plugin reported none on macOS either, and the
+ * backend there is a single Metal build that no hardware fact selects between.
+ */
+import { isX86Arch, parseDarwinCpuFeatures } from './cpu-flags.js';
+import { assembleSystemInfo } from './merge.js';
+import { PROBE_TOOL_TIMEOUT_MS, commonFacts, firstLine, settledOrWarn } from './probe-common.js';
+const SYSCTL = '/usr/sbin/sysctl';
+const SW_VERS = '/usr/bin/sw_vers';
+export async function probeDarwin(deps) {
+    const warnings = [];
+    const common = commonFacts(deps);
+    const x86 = isX86Arch(common.arch);
+    const keys = [
+        'hw.physicalcpu',
+        'machdep.cpu.brand_string',
+        ...(x86 ? ['machdep.cpu.features', 'machdep.cpu.leaf7_features'] : []),
+    ];
+    const [sysctl, swVers] = await Promise.allSettled([
+        runOrThrow(deps, SYSCTL, ['-n', ...keys]),
+        runOrThrow(deps, SW_VERS, []),
+    ]);
+    // `sysctl -n a b c` prints one value per line, in the order asked.
+    const values = settledOrWarn(sysctl, 'sysctl', warnings)?.split('\n') ?? [];
+    const physicalCpu = Number(values[0]?.trim());
+    const brand = values[1]?.trim();
+    let extensions;
+    if (!x86)
+        extensions = [];
+    else if (values.length >= 4)
+        extensions = parseDarwinCpuFeatures(values[2] ?? '', values[3] ?? '');
+    const versText = settledOrWarn(swVers, 'sw_vers', warnings);
+    const osName = versText ? parseSwVers(versText) : 'macOS';
+    return {
+        info: assembleSystemInfo({
+            cpu: {
+                name: brand || common.cpuName || 'Unknown CPU',
+                coreCount: Number.isInteger(physicalCpu) && physicalCpu > 0 ? physicalCpu : common.logicalCores,
+                arch: common.arch,
+                extensions,
+            },
+            osType: 'macos',
+            osName,
+            totalMemoryMiB: common.totalMemoryMiB,
+            gpus: [],
+        }),
+        warnings,
+    };
+}
+/**
+ * Apple silicon only, where the GPU works out of system RAM; `undefined` on an Intel Mac and on
+ * every other platform. How much of that RAM Metal lets the GPU use is llama.cpp's to report
+ * (`--list-devices`): Apple's rule has changed across macOS releases, and `iogpu.wired_limit_mb`
+ * overrides it.
+ */
+export function probeUnifiedMemory(deps) {
+    const common = commonFacts(deps);
+    if (deps.platform !== 'darwin' || common.arch !== 'arm64' || common.totalMemoryMiB <= 0)
+        return undefined;
+    return { totalMemoryBytes: common.totalMemoryMiB * 2 ** 20 };
+}
+/** `ProductName:\t\tmacOS\nProductVersion:\t\t15.5\n…` → `macOS 15.5`. */
+export function parseSwVers(text) {
+    const pick = (key) => new RegExp(`^${key}:\\s*(.+)$`, 'm').exec(text)?.[1]?.trim();
+    const name = pick('ProductName') || 'macOS';
+    const version = pick('ProductVersion');
+    return version ? `${name} ${version}` : name;
+}
+async function runOrThrow(deps, file, args) {
+    const result = await deps.run(file, args, PROBE_TOOL_TIMEOUT_MS);
+    if (result.code !== 0)
+        throw new Error(`${file} exited with ${result.code ?? 'signal'}: ${firstLine(result.stderr) || firstLine(result.stdout)}`);
+    return result.stdout;
+}
+//# sourceMappingURL=probe-darwin.js.map

package/dist/hardware/probe-darwin.js.map

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

package/dist/hardware/probe-linux.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Linux: `/proc/cpuinfo`, `/etc/os-release`, the `/sys/class/drm` walk, the Vulkan ICD directories,
+ * `nvidia-smi` (first candidate that starts; legacy field set when the driver refuses `compute_cap`)
+ * and `vulkaninfo --summary` from PATH. Everything runs at once; every failure is one warning.
+ */
+import type { HardwareProbeResult, ProbeDeps } from './probe-common.js';
+export declare function probeLinux(deps: ProbeDeps): Promise<HardwareProbeResult>;
+/** `PRETTY_NAME="Ubuntu 24.04.1 LTS"` → `Ubuntu 24.04.1 LTS`; falls back to `NAME`. */
+export declare function prettyName(osRelease: string): string | undefined;

package/dist/hardware/probe-linux.js

@@ -0,0 +1,133 @@
+/**
+ * Linux: `/proc/cpuinfo`, `/etc/os-release`, the `/sys/class/drm` walk, the Vulkan ICD directories,
+ * `nvidia-smi` (first candidate that starts; legacy field set when the driver refuses `compute_cap`)
+ * and `vulkaninfo --summary` from PATH. Everything runs at once; every failure is one warning.
+ */
+import { parseProcCpuinfo, isX86Arch } from './cpu-flags.js';
+import { isCardNode, sysfsGpuFromFiles } from './drm-sysfs.js';
+import { assembleSystemInfo, mergeGpus } from './merge.js';
+import { PROBE_TOOL_TIMEOUT_MS, commonFacts, firstLine, runNvidiaSmi, settledOrWarn } from './probe-common.js';
+import { icdVendorOf, linuxIcdDirs, parseVulkaninfoSummary } from './vulkan.js';
+const DRM_DIR = '/sys/class/drm';
+export async function probeLinux(deps) {
+    const warnings = [];
+    const common = commonFacts(deps);
+    const [cpuinfo, osRelease, drm, icd, nvidia, vulkan] = await Promise.allSettled([
+        deps.fs.readFile('/proc/cpuinfo'),
+        deps.fs.readFile('/etc/os-release'),
+        scanDrm(deps),
+        scanIcdDirs(deps),
+        runNvidiaSmi(deps),
+        runVulkaninfo(deps),
+    ]);
+    const parsedCpu = settledOrWarn(cpuinfo, '/proc/cpuinfo', warnings);
+    const cpu = parsedCpu ? parseProcCpuinfo(parsedCpu) : undefined;
+    // No `flags` line on a non-x86 kernel is the normal case (arm64 has no x86 extensions); on x86 it is unknown.
+    const extensions = cpu?.flags ?? (parsedCpu !== undefined && !isX86Arch(common.arch) ? [] : undefined);
+    const osReleaseText = settledOrWarn(osRelease, '/etc/os-release', warnings);
+    const osName = (osReleaseText && prettyName(osReleaseText)) || 'Linux';
+    const pci = settledOrWarn(drm, DRM_DIR, warnings) ?? [];
+    const icdVendors = settledOrWarn(icd, 'vulkan icd.d', warnings) ?? new Set();
+    const nvidiaRows = settledOrWarn(nvidia, 'nvidia-smi', warnings) ?? [];
+    const vulkanDevices = settledOrWarn(vulkan, 'vulkaninfo', warnings) ?? [];
+    const merged = mergeGpus({
+        nvidia: nvidiaRows,
+        pci,
+        vulkan: vulkanDevices,
+        icdVendors,
+        loaderPresent: true,
+    });
+    warnings.push(...merged.warnings);
+    return {
+        info: assembleSystemInfo({
+            cpu: {
+                name: cpu?.modelName ?? common.cpuName ?? 'Unknown CPU',
+                coreCount: cpu?.physicalCores ?? common.logicalCores,
+                arch: common.arch,
+                extensions,
+            },
+            osType: 'linux',
+            osName,
+            totalMemoryMiB: common.totalMemoryMiB,
+            gpus: merged.gpus,
+        }),
+        warnings,
+    };
+}
+/** `PRETTY_NAME="Ubuntu 24.04.1 LTS"` → `Ubuntu 24.04.1 LTS`; falls back to `NAME`. */
+export function prettyName(osRelease) {
+    const pick = (key) => {
+        const m = new RegExp(`^${key}=(.*)$`, 'm').exec(osRelease);
+        const value = m?.[1]
+            ?.trim()
+            .replace(/^"(.*)"$/, '$1')
+            .replace(/^'(.*)'$/, '$1');
+        return value ? value : undefined;
+    };
+    return pick('PRETTY_NAME') ?? pick('NAME');
+}
+/** Every `card<N>` under `/sys/class/drm` that has a readable PCI vendor and device id. */
+async function scanDrm(deps) {
+    const nodes = (await deps.fs.readdir(DRM_DIR)).filter(isCardNode).sort(byCardNumber);
+    const gpus = [];
+    for (const card of nodes) {
+        const device = `${DRM_DIR}/${card}/device`;
+        const [vendor, deviceId, vramTotal, bootVga, deviceLink, driverLink] = await Promise.all([
+            deps.fs.readFile(`${device}/vendor`).catch(() => undefined),
+            deps.fs.readFile(`${device}/device`).catch(() => undefined),
+            deps.fs.readFile(`${device}/mem_info_vram_total`).catch(() => undefined),
+            deps.fs.readFile(`${device}/boot_vga`).catch(() => undefined),
+            deps.fs.readlink(device).catch(() => undefined),
+            deps.fs.readlink(`${device}/driver`).catch(() => undefined),
+        ]);
+        if (vendor === undefined || deviceId === undefined)
+            continue; // a virtual or platform device
+        const gpu = sysfsGpuFromFiles({
+            card,
+            vendor,
+            device: deviceId,
+            ...(vramTotal !== undefined ? { vramTotal } : {}),
+            ...(bootVga !== undefined ? { bootVga } : {}),
+            ...(deviceLink !== undefined ? { deviceLink } : {}),
+            ...(driverLink !== undefined ? { driverLink } : {}),
+        });
+        if (gpu)
+            gpus.push(gpu);
+    }
+    return gpus;
+}
+function byCardNumber(a, b) {
+    return Number(a.slice(4)) - Number(b.slice(4));
+}
+/** Vendors with an ICD manifest in any of the loader's directories; a missing directory is not an error. */
+async function scanIcdDirs(deps) {
+    const vendors = new Set();
+    for (const dir of linuxIcdDirs(deps.env)) {
+        const entries = await deps.fs.readdir(dir).catch(() => []);
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            const vendor = icdVendorOf(entry);
+            if (vendor)
+                vendors.add(vendor);
+        }
+    }
+    return vendors;
+}
+/** `vulkaninfo` is optional tooling; absent is silent, a failed run is a warning. */
+async function runVulkaninfo(deps) {
+    let result;
+    try {
+        result = await deps.run('vulkaninfo', ['--summary'], PROBE_TOOL_TIMEOUT_MS);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    if (result.code !== 0)
+        throw new Error(`vulkaninfo exited with ${result.code ?? 'signal'}: ${firstLine(result.stderr) || firstLine(result.stdout)}`);
+    return parseVulkaninfoSummary(result.stdout);
+}
+//# sourceMappingURL=probe-linux.js.map

package/dist/hardware/probe-linux.js.map

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

package/dist/hardware/probe-windows.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Windows: one `powershell.exe` run (`WINDOWS_PROBE_SCRIPT`: adapters, class registry, CPU, OS, Vulkan
+ * loader, CPU flags) and `nvidia-smi`, in parallel. PowerShell failing leaves the CPU flags unknown and
+ * the GPU list to nvidia-smi alone; nvidia-smi missing is the normal case without an NVIDIA driver.
+ */
+import type { HardwareProbeResult, ProbeDeps } from './probe-common.js';
+export declare function probeWindows(deps: ProbeDeps): Promise<HardwareProbeResult>;

package/dist/hardware/probe-windows.js

@@ -0,0 +1,50 @@
+/**
+ * Windows: one `powershell.exe` run (`WINDOWS_PROBE_SCRIPT`: adapters, class registry, CPU, OS, Vulkan
+ * loader, CPU flags) and `nvidia-smi`, in parallel. PowerShell failing leaves the CPU flags unknown and
+ * the GPU list to nvidia-smi alone; nvidia-smi missing is the normal case without an NVIDIA driver.
+ */
+import { cpuExtensionsFromWindowsPf } from './cpu-flags.js';
+import { assembleSystemInfo, mergeGpus } from './merge.js';
+import { PROBE_POWERSHELL_TIMEOUT_MS, commonFacts, firstLine, runNvidiaSmi, settledOrWarn, } from './probe-common.js';
+import { coreCount, osName, parseWindowsProbe, windowsGpus, windowsProbeArgs } from './windows-video.js';
+export async function probeWindows(deps) {
+    const warnings = [];
+    const common = commonFacts(deps);
+    const [powershell, nvidia] = await Promise.allSettled([runPowerShellProbe(deps), runNvidiaSmi(deps)]);
+    const probe = settledOrWarn(powershell, 'powershell', warnings);
+    const nvidiaRows = settledOrWarn(nvidia, 'nvidia-smi', warnings) ?? [];
+    const adapters = probe ? windowsGpus(probe) : undefined;
+    if (adapters)
+        warnings.push(...adapters.warnings);
+    const merged = mergeGpus({
+        nvidia: nvidiaRows,
+        pci: adapters?.adapters ?? [],
+        vulkan: [],
+        icdVendors: adapters?.icdVendors ?? new Set(),
+        // Without the PowerShell answer the loader's presence is unknown; an nvidia-smi GPU is still a GPU.
+        loaderPresent: probe ? probe.vulkan.dll : true,
+    });
+    warnings.push(...merged.warnings);
+    return {
+        info: assembleSystemInfo({
+            cpu: {
+                name: probe?.cpu[0]?.Name?.trim() || common.cpuName || 'Unknown CPU',
+                coreCount: (probe && coreCount(probe)) ?? common.logicalCores,
+                arch: common.arch,
+                extensions: probe ? cpuExtensionsFromWindowsPf(probe.pf, probe.build, common.arch) : undefined,
+            },
+            osType: 'windows',
+            osName: (probe && osName(probe)) ?? 'Windows',
+            totalMemoryMiB: common.totalMemoryMiB,
+            gpus: merged.gpus,
+        }),
+        warnings,
+    };
+}
+async function runPowerShellProbe(deps) {
+    const result = await deps.run('powershell.exe', windowsProbeArgs(), PROBE_POWERSHELL_TIMEOUT_MS);
+    if (result.code !== 0)
+        throw new Error(`powershell.exe exited with ${result.code ?? 'signal'}: ${firstLine(result.stderr) || firstLine(result.stdout)}`);
+    return parseWindowsProbe(result.stdout);
+}
+//# sourceMappingURL=probe-windows.js.map

package/dist/hardware/probe-windows.js.map

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

package/dist/hardware/probe.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The hardware probe's runner and dispatcher: the real `node:*` dependencies, and `probeSystemInfo`,
+ * which picks the branch for `deps.platform`.
+ *
+ * A probe never throws for a missing tool, a refused file or a timeout: each becomes one line in
+ * `warnings`, and the answer carries what could be read. The only way a platform probe rejects is a
+ * bug; `probeSystemInfo` turns even that into the `node:os` fallback plus a warning.
+ */
+import type { HardwareProbeResult, ProbeDeps, ProbeFs, ToolResult } from './probe-common.js';
+/** `execFile` with the probe's rules: hidden window, a deadline, a bounded buffer, exit code as data. */
+export declare function runTool(file: string, args: string[], timeoutMs: number): Promise<ToolResult>;
+export declare const nodeProbeFs: ProbeFs;
+/** The real dependencies, with any of them replaced. */
+export declare function nodeProbeDeps(over?: Partial<ProbeDeps>): ProbeDeps;
+/** Measure the machine `deps` describes. A platform without a probe answers what `node:os` knows. */
+export declare function probeSystemInfo(deps: ProbeDeps): Promise<HardwareProbeResult>;

package/dist/hardware/probe.js

@@ -0,0 +1,65 @@
+/**
+ * The hardware probe's runner and dispatcher: the real `node:*` dependencies, and `probeSystemInfo`,
+ * which picks the branch for `deps.platform`.
+ *
+ * A probe never throws for a missing tool, a refused file or a timeout: each becomes one line in
+ * `warnings`, and the answer carries what could be read. The only way a platform probe rejects is a
+ * bug; `probeSystemInfo` turns even that into the `node:os` fallback plus a warning.
+ */
+import { execFile } from 'node:child_process';
+import { readFile, readdir, readlink, stat } from 'node:fs/promises';
+import { cpus, totalmem } from 'node:os';
+import { PROBE_MAX_OUTPUT_BYTES, fallbackProbe, warningOf } from './probe-common.js';
+import { probeDarwin } from './probe-darwin.js';
+import { probeLinux } from './probe-linux.js';
+import { probeWindows } from './probe-windows.js';
+/** `execFile` with the probe's rules: hidden window, a deadline, a bounded buffer, exit code as data. */
+export function runTool(file, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile(file, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: PROBE_MAX_OUTPUT_BYTES, encoding: 'utf8' }, (error, stdout, stderr) => {
+            if (!error)
+                return resolve({ stdout, stderr, code: 0 });
+            const failure = error;
+            if (failure.killed || failure.signal)
+                return reject(new Error(`${file} did not finish in ${timeoutMs} ms (${failure.signal ?? 'killed'})`));
+            // A non-zero exit arrives as an error whose `code` is the number; a spawn failure has a string code.
+            if (typeof failure.code === 'number')
+                return resolve({ stdout, stderr, code: failure.code });
+            reject(error);
+        });
+    });
+}
+export const nodeProbeFs = {
+    readFile: (path) => readFile(path, 'utf8'),
+    readdir: (path) => readdir(path),
+    exists: (path) => stat(path).then(() => true, () => false),
+    readlink: (path) => readlink(path),
+};
+/** The real dependencies, with any of them replaced. */
+export function nodeProbeDeps(over = {}) {
+    return {
+        platform: process.platform,
+        arch: process.arch,
+        env: process.env,
+        run: runTool,
+        fs: nodeProbeFs,
+        os: { totalmem, cpus },
+        ...over,
+    };
+}
+/** Measure the machine `deps` describes. A platform without a probe answers what `node:os` knows. */
+export async function probeSystemInfo(deps) {
+    try {
+        if (deps.platform === 'linux')
+            return await probeLinux(deps);
+        if (deps.platform === 'win32')
+            return await probeWindows(deps);
+        if (deps.platform === 'darwin')
+            return await probeDarwin(deps);
+        return { ...fallbackProbe(deps), warnings: [`no hardware probe for platform ${String(deps.platform)}`] };
+    }
+    catch (error) {
+        return { ...fallbackProbe(deps), warnings: [warningOf('hardware probe failed', error)] };
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/hardware/probe.js.map

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