@atomic-chat/core 0.5.1 → 0.13.2

package/dist/hardware/drm-sysfs.js.map

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

package/dist/hardware/facts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The slice of the hardware description the backend selectors and the CPU preflight read, and the
+ * precedence rule between the core's probe and an injected override.
+ *
+ * Pure: no `node:*` I/O. `HardwareService` produces `HardwareFacts`; `backend/` consumes them through
+ * `HardwareFactsSource` so that module never depends on how the facts were measured.
+ */
+import type { GpuInfo, GpuProbeInfo, HardwareOverride, HardwareSource, OsType, SystemInfo } from '../contracts/index.js';
+export interface HardwareFacts {
+    /** `windows` | `linux` | `macos` | `unknown`. */
+    osType: string;
+    /** Rust spelling: `x86_64`, `arm64` / `aarch64`, `x86`. */
+    arch: string;
+    /**
+     * CPU flags in the plugin's lowercase spelling, or `undefined` when the probe could not read them.
+     * The no-AVX preflight fires only on a positive signal, so unknown must never read as "none".
+     */
+    cpuExtensions: string[] | undefined;
+    gpus: GpuProbeInfo[];
+    source: HardwareSource;
+}
+/** What the backend module asks for: the current facts, whatever measured them. */
+export interface HardwareFactsSource {
+    facts(): Promise<HardwareFacts>;
+}
+/** Node's platform name in the spelling the selection policies and the app use. */
+export declare function osTypeOf(platform: NodeJS.Platform | string): OsType;
+/** Node's `process.arch` in the Rust spelling the backend and CPU policies expect (`x64` → `x86_64`). */
+export declare function rustArch(arch: string): string;
+/**
+ * Combine the probe with an override. The override replaces the probe wholesale for the GPUs and, when
+ * it carries them, the CPU flags and the OS type — never merged (a half-probed, half-injected list
+ * would be a third description of the machine matching neither side, see `override.ts`).
+ */
+export declare function factsOf(info: SystemInfo, arch: string, override: HardwareOverride | undefined): HardwareFacts;
+/**
+ * Render an injected `GpuProbeInfo` as a full `GpuInfo`, so `GET /hardware/info` has one shape whether
+ * the facts came from the probe or from an override. Missing fields get the plugin's empty values.
+ */
+export declare function gpuInfoFromProbe(gpu: GpuProbeInfo, index: number): GpuInfo;
+/** The `SystemInfo` served while an override stands: the probe's CPU/OS/memory, the override's GPUs. */
+export declare function systemInfoWithOverride(info: SystemInfo, override: HardwareOverride): SystemInfo;

package/dist/hardware/facts.js

@@ -0,0 +1,92 @@
+/**
+ * The slice of the hardware description the backend selectors and the CPU preflight read, and the
+ * precedence rule between the core's probe and an injected override.
+ *
+ * Pure: no `node:*` I/O. `HardwareService` produces `HardwareFacts`; `backend/` consumes them through
+ * `HardwareFactsSource` so that module never depends on how the facts were measured.
+ */
+/** Node's platform name in the spelling the selection policies and the app use. */
+export function osTypeOf(platform) {
+    if (platform === 'win32')
+        return 'windows';
+    if (platform === 'darwin')
+        return 'macos';
+    if (platform === 'linux')
+        return 'linux';
+    return 'unknown';
+}
+/** Node's `process.arch` in the Rust spelling the backend and CPU policies expect (`x64` → `x86_64`). */
+export function rustArch(arch) {
+    if (arch === 'x64')
+        return 'x86_64';
+    if (arch === 'ia32')
+        return 'x86';
+    return arch;
+}
+/**
+ * Combine the probe with an override. The override replaces the probe wholesale for the GPUs and, when
+ * it carries them, the CPU flags and the OS type — never merged (a half-probed, half-injected list
+ * would be a third description of the machine matching neither side, see `override.ts`).
+ */
+export function factsOf(info, arch, override) {
+    if (!override) {
+        return {
+            osType: info.os_type,
+            arch,
+            cpuExtensions: info.cpu.extensions_known ? [...info.cpu.extensions] : undefined,
+            gpus: info.gpus.map((gpu) => ({ ...gpu })),
+            source: 'probe',
+        };
+    }
+    return {
+        osType: override.os_type ?? info.os_type,
+        arch,
+        cpuExtensions: override.cpu_extensions
+            ? [...override.cpu_extensions]
+            : info.cpu.extensions_known
+                ? [...info.cpu.extensions]
+                : undefined,
+        gpus: override.gpus.map((gpu) => ({ ...gpu })),
+        source: 'override',
+    };
+}
+/**
+ * Render an injected `GpuProbeInfo` as a full `GpuInfo`, so `GET /hardware/info` has one shape whether
+ * the facts came from the probe or from an override. Missing fields get the plugin's empty values.
+ */
+export function gpuInfoFromProbe(gpu, index) {
+    const extra = gpu;
+    return {
+        name: typeof extra.name === 'string' ? extra.name : `GPU ${index}`,
+        total_memory: typeof gpu.total_memory === 'number' ? gpu.total_memory : 0,
+        vendor: typeof gpu.vendor === 'string' ? gpu.vendor : 'Unknown (vendor_id: 0)',
+        uuid: typeof extra.uuid === 'string' ? extra.uuid : `override-${index}`,
+        driver_version: gpu.driver_version ?? '',
+        nvidia_info: gpu.nvidia_info
+            ? {
+                index: gpu.nvidia_info.index ?? index,
+                compute_capability: gpu.nvidia_info.compute_capability ?? '',
+            }
+            : null,
+        vulkan_info: gpu.vulkan_info
+            ? {
+                index: gpu.vulkan_info.index ?? index,
+                device_type: gpu.vulkan_info.device_type ?? 'Unknown',
+                api_version: gpu.vulkan_info.api_version ?? '',
+                device_id: typeof gpu.vulkan_info.device_id === 'number' ? gpu.vulkan_info.device_id : 0,
+            }
+            : null,
+    };
+}
+/** The `SystemInfo` served while an override stands: the probe's CPU/OS/memory, the override's GPUs. */
+export function systemInfoWithOverride(info, override) {
+    return {
+        ...info,
+        ...(override.os_type ? { os_type: override.os_type } : {}),
+        cpu: override.cpu_extensions
+            ? { ...info.cpu, extensions: [...override.cpu_extensions], extensions_known: true }
+            : { ...info.cpu },
+        gpus: override.gpus.map((gpu, index) => gpuInfoFromProbe(gpu, index)),
+    };
+}
+//# sourceMappingURL=facts.js.map

package/dist/hardware/facts.js.map

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

package/dist/hardware/index.d.ts

@@ -1,7 +1,23 @@
 /**
- * SystemInfo / SystemUsage via system tools, supported-feature tiers, app-injected override.
+ * Hardware facts: the core's own probe (shell tools and files, no NVML, no native addon), the
+ * app-injectable override that replaces it, and the `HardwareService` that serves both to the
+ * control API and to the backend selectors.
  *
- * Ported from: src-tauri/plugins/tauri-plugin-hardware, backend.rs get_supported_features
- * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ * Ported from: src-tauri/plugins/tauri-plugin-hardware (SystemInfo shape, vendor and CPU-flag
+ * spelling); the measurement itself is the core's (ADR 2026-09-27, "the core probes hardware with
+ * shell tools"). See PLAN.md §3.2. Public API of this module is exported from this file only.
  */
+export * from './facts.js';
 export * from './override.js';
+export * from './cpu-flags.js';
+export * from './nvidia-smi.js';
+export * from './drm-sysfs.js';
+export * from './windows-video.js';
+export * from './vulkan.js';
+export * from './merge.js';
+export * from './probe-common.js';
+export * from './probe.js';
+export * from './probe-linux.js';
+export * from './probe-windows.js';
+export * from './probe-darwin.js';
+export * from './service.js';

package/dist/hardware/index.js

@@ -1,8 +1,24 @@
 /**
- * SystemInfo / SystemUsage via system tools, supported-feature tiers, app-injected override.
+ * Hardware facts: the core's own probe (shell tools and files, no NVML, no native addon), the
+ * app-injectable override that replaces it, and the `HardwareService` that serves both to the
+ * control API and to the backend selectors.
  *
- * Ported from: src-tauri/plugins/tauri-plugin-hardware, backend.rs get_supported_features
- * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ * Ported from: src-tauri/plugins/tauri-plugin-hardware (SystemInfo shape, vendor and CPU-flag
+ * spelling); the measurement itself is the core's (ADR 2026-09-27, "the core probes hardware with
+ * shell tools"). See PLAN.md §3.2. Public API of this module is exported from this file only.
  */
+export * from './facts.js';
 export * from './override.js';
+export * from './cpu-flags.js';
+export * from './nvidia-smi.js';
+export * from './drm-sysfs.js';
+export * from './windows-video.js';
+export * from './vulkan.js';
+export * from './merge.js';
+export * from './probe-common.js';
+export * from './probe.js';
+export * from './probe-linux.js';
+export * from './probe-windows.js';
+export * from './probe-darwin.js';
+export * from './service.js';
 //# sourceMappingURL=index.js.map

package/dist/hardware/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hardware/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hardware/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}

package/dist/hardware/merge.d.ts

@@ -0,0 +1,55 @@
+/**
+ * One GPU list from several partial views: nvidia-smi (driver version, compute capability, VRAM —
+ * authoritative for NVIDIA), the PCI enumeration (sysfs on Linux, CIM + registry on Windows — every
+ * vendor's device id and, for the others, VRAM) and Vulkan (vulkaninfo's exact device type, or only
+ * the ICD registrations). Each GPU appears once; the selectors then read `nvidia_info`, `vendor`,
+ * `driver_version`, `total_memory` and `vulkan_info.device_id` / `device_type` from it.
+ *
+ * Pure. `hardware/` never imports from `backend/`; the selectors' expectations are asserted in the test.
+ */
+import type { GpuInfo, OsType, SystemInfo } from '../contracts/index.js';
+import type { SysfsGpu } from './drm-sysfs.js';
+import type { VulkanDevice } from './vulkan.js';
+import type { WindowsAdapter } from './windows-video.js';
+/** An nvidia-smi row as a `GpuInfo`, with the bus id it is matched to the PCI enumeration by. */
+export interface NvidiaSmiGpu {
+    gpu: GpuInfo;
+    /** sysfs spelling (`0000:01:00.0`); absent when the tool did not report it. */
+    busId?: string;
+}
+export interface MergeInput {
+    nvidia: NvidiaSmiGpu[];
+    /** Linux `SysfsGpu` rows or Windows `WindowsAdapter` rows, never mixed. */
+    pci: Array<SysfsGpu | WindowsAdapter>;
+    /** `vulkaninfo --summary` devices, empty when the tool is not installed. */
+    vulkan: VulkanDevice[];
+    /** Vendors with a registered ICD (`NVIDIA`, `AMD`, `Intel`). */
+    icdVendors: Set<string>;
+    /** `false` when the loader is known to be missing (no `vulkan-1.dll`); a registered ICD is then useless. */
+    loaderPresent: boolean;
+}
+/**
+ * nvidia-smi rows first, in their order, then the PCI-only GPUs in enumeration order, then any Vulkan
+ * device neither list knew. A PCI NVIDIA device nvidia-smi did not report (nouveau, a driver that is not
+ * loaded) is listed with `nvidia_info: null`: the CUDA tiers need the driver version, and there is none.
+ */
+export declare function mergeGpus(input: MergeInput): {
+    gpus: GpuInfo[];
+    warnings: string[];
+};
+export interface AssembleInput {
+    cpu: {
+        name: string;
+        coreCount: number;
+        /** Rust spelling, `x86_64` / `arm64`. */
+        arch: string;
+        /** Plugin-spelled flags, or `undefined` when the probe could not read them. */
+        extensions: string[] | undefined;
+    };
+    osType: OsType;
+    osName: string;
+    totalMemoryMiB: number;
+    gpus: GpuInfo[];
+}
+/** The `SystemInfo` the core serves; `extensions_known` is the one field the plugin never had. */
+export declare function assembleSystemInfo(input: AssembleInput): SystemInfo;

package/dist/hardware/merge.js

@@ -0,0 +1,141 @@
+/**
+ * One GPU list from several partial views: nvidia-smi (driver version, compute capability, VRAM —
+ * authoritative for NVIDIA), the PCI enumeration (sysfs on Linux, CIM + registry on Windows — every
+ * vendor's device id and, for the others, VRAM) and Vulkan (vulkaninfo's exact device type, or only
+ * the ICD registrations). Each GPU appears once; the selectors then read `nvidia_info`, `vendor`,
+ * `driver_version`, `total_memory` and `vulkan_info.device_id` / `device_type` from it.
+ *
+ * Pure. `hardware/` never imports from `backend/`; the selectors' expectations are asserted in the test.
+ */
+import { vendorName } from './drm-sysfs.js';
+import { guessDeviceType } from './vulkan.js';
+function isWindowsAdapter(row) {
+    return 'pnpDeviceId' in row;
+}
+const sameName = (a, b) => a.trim().toLowerCase() === b.trim().toLowerCase();
+/**
+ * nvidia-smi rows first, in their order, then the PCI-only GPUs in enumeration order, then any Vulkan
+ * device neither list knew. A PCI NVIDIA device nvidia-smi did not report (nouveau, a driver that is not
+ * loaded) is listed with `nvidia_info: null`: the CUDA tiers need the driver version, and there is none.
+ */
+export function mergeGpus(input) {
+    const warnings = [];
+    const gpus = [];
+    const pci = input.pci.map((row) => ({ row, taken: false }));
+    const vulkan = input.vulkan.map((device) => ({ device, taken: false }));
+    const takeVulkan = (pick) => {
+        const entry = vulkan.find((e) => !e.taken && pick(e.device));
+        if (entry)
+            entry.taken = true;
+        return entry?.device;
+    };
+    const takePci = (pick) => {
+        const entry = pci.find((e) => !e.taken && pick(e.row));
+        if (entry)
+            entry.taken = true;
+        return entry?.row;
+    };
+    const vulkanFromDevice = (device) => ({
+        index: device.index,
+        device_type: device.deviceType,
+        api_version: device.apiVersion,
+        device_id: device.deviceId,
+    });
+    const vulkanFromIcd = (position, vendor, deviceId, vramTotalMiB, adapterHasIcd) => {
+        if (!input.loaderPresent)
+            return null;
+        if (!adapterHasIcd && !input.icdVendors.has(vendor))
+            return null;
+        return {
+            index: position,
+            device_type: guessDeviceType({
+                vendor,
+                deviceId,
+                ...(vramTotalMiB !== undefined ? { vramTotalMiB } : {}),
+            }),
+            api_version: '',
+            device_id: deviceId,
+        };
+    };
+    for (const { gpu, busId } of input.nvidia) {
+        const matched = (busId ? takePci((row) => !isWindowsAdapter(row) && row.busId === busId) : undefined) ??
+            takePci((row) => isWindowsAdapter(row) && row.vendorId === 0x10de && sameName(row.name, gpu.name));
+        const deviceId = matched?.deviceId;
+        const device = deviceId !== undefined
+            ? takeVulkan((d) => d.vendorId === 0x10de && d.deviceId === deviceId)
+            : takeVulkan((d) => d.vendorId === 0x10de && sameName(d.deviceName, gpu.name));
+        const vramTotalMiB = matched?.vramTotalMiB;
+        const merged = {
+            ...gpu,
+            total_memory: gpu.total_memory > 0 ? gpu.total_memory : (vramTotalMiB ?? 0),
+            uuid: gpu.uuid !== '' ? gpu.uuid : matched ? opaqueId(matched) : `nvidia-${gpus.length}`,
+            vulkan_info: device
+                ? vulkanFromDevice(device)
+                : vulkanFromIcd(gpus.length, 'NVIDIA', deviceId ?? 0, vramTotalMiB, matched !== undefined && isWindowsAdapter(matched) && matched.vulkanDriver),
+        };
+        gpus.push(merged);
+    }
+    for (const entry of pci) {
+        if (entry.taken)
+            continue;
+        entry.taken = true;
+        const row = entry.row;
+        const vendor = vendorName(row.vendorId);
+        const device = takeVulkan((d) => d.vendorId === row.vendorId && d.deviceId === row.deviceId);
+        const windows = isWindowsAdapter(row) ? row : undefined;
+        const name = windows?.name ?? device?.deviceName ?? `${vendor} GPU 0x${row.deviceId.toString(16).padStart(4, '0')}`;
+        if (row.vendorId === 0x10de)
+            warnings.push(`${name}: NVIDIA GPU without an nvidia-smi answer; driver version and compute capability unknown`);
+        gpus.push({
+            name,
+            total_memory: row.vramTotalMiB ?? 0,
+            vendor,
+            uuid: opaqueId(row),
+            driver_version: windows?.driverVersion ?? device?.driverVersion ?? '',
+            nvidia_info: null,
+            vulkan_info: device
+                ? vulkanFromDevice(device)
+                : vulkanFromIcd(gpus.length, vendor, row.deviceId, row.vramTotalMiB, windows?.vulkanDriver ?? false),
+        });
+    }
+    for (const entry of vulkan) {
+        if (entry.taken)
+            continue;
+        entry.taken = true;
+        const device = entry.device;
+        const vendor = vendorName(device.vendorId);
+        warnings.push(`${device.deviceName || vendor}: enumerated by Vulkan only; no PCI record for it`);
+        gpus.push({
+            name: device.deviceName || `${vendor} GPU 0x${device.deviceId.toString(16).padStart(4, '0')}`,
+            total_memory: 0,
+            vendor,
+            uuid: `vulkan-${device.index}`,
+            driver_version: device.driverVersion,
+            nvidia_info: null,
+            vulkan_info: vulkanFromDevice(device),
+        });
+    }
+    return { gpus, warnings };
+}
+/** The stable id of a non-NVIDIA GPU: the PNP instance on Windows, the PCI bus id (or DRM node) on Linux. */
+function opaqueId(row) {
+    return isWindowsAdapter(row) ? row.pnpDeviceId : (row.busId ?? row.card);
+}
+/** The `SystemInfo` the core serves; `extensions_known` is the one field the plugin never had. */
+export function assembleSystemInfo(input) {
+    const cpu = {
+        name: input.cpu.name,
+        core_count: input.cpu.coreCount,
+        arch: input.cpu.arch,
+        extensions: input.cpu.extensions ? [...input.cpu.extensions] : [],
+        extensions_known: input.cpu.extensions !== undefined,
+    };
+    return {
+        cpu,
+        os_type: input.osType,
+        os_name: input.osName,
+        total_memory: input.totalMemoryMiB,
+        gpus: input.gpus,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/hardware/merge.js.map

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

package/dist/hardware/nvidia-smi.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `nvidia-smi --query-gpu=… --format=csv,noheader,nounits`: the one tool that knows an NVIDIA driver's
+ * exact version and a GPU's compute capability without NVML being linked, both of which decide the
+ * CUDA tier a backend is chosen from.
+ *
+ * Pure: the arguments to run, the CSV that comes back, the `GpuInfo` it becomes. The I/O runner picks
+ * the first candidate path that exists and retries with `NVIDIA_SMI_FIELDS_LEGACY` when the driver is
+ * too old to know `compute_cap` (added in 470).
+ */
+import type { GpuInfo } from '../contracts/index.js';
+export declare const NVIDIA_SMI_FIELDS: readonly string[];
+/** Drivers before 470 refuse `compute_cap`; the compute capability is then `''` (unknown). */
+export declare const NVIDIA_SMI_FIELDS_LEGACY: readonly string[];
+export declare function nvidiaSmiArgs(fields: readonly string[]): string[];
+/** `Field "compute_cap" is not a valid field to query.` — the driver is older than the field. */
+export declare function isUnknownFieldError(stderr: string): boolean;
+/** One CSV row keyed by field name; a value the tool could not report is absent. */
+export type NvidiaSmiRow = Record<string, string | undefined>;
+/**
+ * Rows in `fields` order. Lines whose column count does not match (a warning the tool printed to
+ * stdout, an empty trailing line) are dropped rather than mis-keyed, and so is a header line (a
+ * query without `noheader`), which would otherwise read as a card named `name`.
+ */
+export declare function parseNvidiaSmiCsv(stdout: string, fields: readonly string[]): NvidiaSmiRow[];
+/**
+ * The plugin's `GpuInfo` for one nvidia-smi row: NVML's uuid without `GPU-`, MiB (with or without the
+ * ` MiB` a query without `nounits` appends), `''` for an unknown compute capability. An unreported
+ * size — `[N/A]` on a unified-memory card such as the GB10 — is `total_memory: 0`, the app's own
+ * "unknown" in this contract, never `NaN`.
+ */
+export declare function nvidiaGpuFromRow(row: NvidiaSmiRow): GpuInfo;
+/** The row's PCI bus id in sysfs spelling, for matching against `/sys/class/drm`; absent when unreported. */
+export declare function nvidiaBusIdOf(row: NvidiaSmiRow): string | undefined;
+/**
+ * nvidia-smi prints a 32-bit domain (`00000000:01:00.0`); sysfs and vulkaninfo a 16-bit one
+ * (`0000:01:00.0`). Lower case, four-digit domain; anything else is returned trimmed and lower-cased.
+ */
+export declare function normalizePciBusId(busId: string): string;
+/**
+ * Where `nvidia-smi` lives, in the order to try: PATH first, then the driver's own install
+ * locations, which are not on PATH for a service or a fresh shell. WSL ships it under `/usr/lib/wsl/lib`.
+ */
+export declare function nvidiaSmiCandidates(platform: NodeJS.Platform | string, env: NodeJS.ProcessEnv): string[];

package/dist/hardware/nvidia-smi.js

@@ -0,0 +1,118 @@
+/**
+ * `nvidia-smi --query-gpu=… --format=csv,noheader,nounits`: the one tool that knows an NVIDIA driver's
+ * exact version and a GPU's compute capability without NVML being linked, both of which decide the
+ * CUDA tier a backend is chosen from.
+ *
+ * Pure: the arguments to run, the CSV that comes back, the `GpuInfo` it becomes. The I/O runner picks
+ * the first candidate path that exists and retries with `NVIDIA_SMI_FIELDS_LEGACY` when the driver is
+ * too old to know `compute_cap` (added in 470).
+ */
+export const NVIDIA_SMI_FIELDS = [
+    'index',
+    'name',
+    'uuid',
+    'memory.total',
+    'driver_version',
+    'compute_cap',
+    'pci.bus_id',
+];
+/** Drivers before 470 refuse `compute_cap`; the compute capability is then `''` (unknown). */
+export const NVIDIA_SMI_FIELDS_LEGACY = NVIDIA_SMI_FIELDS.filter((f) => f !== 'compute_cap');
+export function nvidiaSmiArgs(fields) {
+    return [`--query-gpu=${fields.join(',')}`, '--format=csv,noheader,nounits'];
+}
+/** `Field "compute_cap" is not a valid field to query.` — the driver is older than the field. */
+export function isUnknownFieldError(stderr) {
+    return /not a valid field to query/i.test(stderr);
+}
+const UNREPORTED = new Set([
+    '[N/A]',
+    '[Not Supported]',
+    'N/A',
+    '[Unknown Error]',
+    '[Insufficient Permissions]',
+]);
+/** A header cell is the field name, with ` [MiB]`-style units when the query asked for them. */
+function isHeaderLine(cells, fields) {
+    return cells.every((cell, i) => cell.replace(/\s*\[[^\]]*\]$/, '') === fields[i]);
+}
+/**
+ * Rows in `fields` order. Lines whose column count does not match (a warning the tool printed to
+ * stdout, an empty trailing line) are dropped rather than mis-keyed, and so is a header line (a
+ * query without `noheader`), which would otherwise read as a card named `name`.
+ */
+export function parseNvidiaSmiCsv(stdout, fields) {
+    const rows = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        if (line.trim() === '')
+            continue;
+        const cells = line.split(',').map((cell) => cell.trim());
+        if (cells.length !== fields.length || isHeaderLine(cells, fields))
+            continue;
+        const row = {};
+        fields.forEach((field, i) => {
+            const cell = cells[i] ?? '';
+            if (cell !== '' && !UNREPORTED.has(cell))
+                row[field] = cell;
+        });
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * The plugin's `GpuInfo` for one nvidia-smi row: NVML's uuid without `GPU-`, MiB (with or without the
+ * ` MiB` a query without `nounits` appends), `''` for an unknown compute capability. An unreported
+ * size — `[N/A]` on a unified-memory card such as the GB10 — is `total_memory: 0`, the app's own
+ * "unknown" in this contract, never `NaN`.
+ */
+export function nvidiaGpuFromRow(row) {
+    const index = Number(row['index']);
+    const memory = Number((row['memory.total'] ?? '').replace(/\s*MiB$/, ''));
+    return {
+        name: row['name'] ?? 'NVIDIA GPU',
+        total_memory: Number.isFinite(memory) && memory > 0 ? Math.floor(memory) : 0,
+        vendor: 'NVIDIA',
+        uuid: (row['uuid'] ?? '').replace(/^GPU-/i, ''),
+        driver_version: row['driver_version'] ?? '',
+        nvidia_info: {
+            index: Number.isInteger(index) && index >= 0 ? index : 0,
+            compute_capability: row['compute_cap'] ?? '',
+        },
+        vulkan_info: null,
+    };
+}
+/** The row's PCI bus id in sysfs spelling, for matching against `/sys/class/drm`; absent when unreported. */
+export function nvidiaBusIdOf(row) {
+    const raw = row['pci.bus_id'];
+    return raw === undefined ? undefined : normalizePciBusId(raw);
+}
+/**
+ * nvidia-smi prints a 32-bit domain (`00000000:01:00.0`); sysfs and vulkaninfo a 16-bit one
+ * (`0000:01:00.0`). Lower case, four-digit domain; anything else is returned trimmed and lower-cased.
+ */
+export function normalizePciBusId(busId) {
+    const m = /^([0-9a-f]+):([0-9a-f]{2}):([0-9a-f]{2})\.([0-9a-f])$/i.exec(busId.trim());
+    if (!m)
+        return busId.trim().toLowerCase();
+    const domain = (m[1] ?? '').toLowerCase().slice(-4).padStart(4, '0');
+    return `${domain}:${m[2]}:${m[3]}.${m[4]}`.toLowerCase();
+}
+/**
+ * Where `nvidia-smi` lives, in the order to try: PATH first, then the driver's own install
+ * locations, which are not on PATH for a service or a fresh shell. WSL ships it under `/usr/lib/wsl/lib`.
+ */
+export function nvidiaSmiCandidates(platform, env) {
+    if (platform === 'win32') {
+        const systemRoot = env['SystemRoot'] ?? env['SYSTEMROOT'] ?? 'C:\\Windows';
+        const programFiles = env['ProgramFiles'] ?? env['PROGRAMFILES'] ?? 'C:\\Program Files';
+        return [
+            'nvidia-smi',
+            `${systemRoot}\\System32\\nvidia-smi.exe`,
+            `${programFiles}\\NVIDIA Corporation\\NVSMI\\nvidia-smi.exe`,
+        ];
+    }
+    if (platform === 'linux')
+        return ['nvidia-smi', '/usr/bin/nvidia-smi', '/usr/lib/wsl/lib/nvidia-smi'];
+    return [];
+}
+//# sourceMappingURL=nvidia-smi.js.map

package/dist/hardware/nvidia-smi.js.map

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