@atomic-chat/core 0.5.1 → 0.13.2

package/dist/hardware/service.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The hardware facts of this core process: one probe at start-up, re-run on request, replaced
+ * wholesale by an injected override for as long as one stands (`override.ts`).
+ *
+ * `start()` kicks the probe off and returns at once, so the control listener is up while PowerShell
+ * is still starting; the first caller that needs the facts (`facts()`, a backend load, `info()`)
+ * waits for that probe, and every later one reads the answer. Nothing is persisted, for the reasons
+ * `override.ts` gives: hardware changes between runs.
+ */
+import type { HardwareInfoResponse, HardwareOverride, HardwareOverrideInput } from '../contracts/index.js';
+import type { HardwareFacts, HardwareFactsSource } from './facts.js';
+import type { HardwareProbeResult } from './probe-common.js';
+export interface HardwareServiceOptions {
+    /** Measure the machine. Expected not to throw; when it does, the answer is cpu/os/memory only. */
+    probe: () => Promise<HardwareProbeResult>;
+    /** Node spelling (`x64`); the facts carry the Rust one. */
+    arch: string;
+    /** For the `os_type` of the answer when even the probe fails; the platform the core runs on. */
+    platform?: NodeJS.Platform | string;
+    now?: () => number;
+    log?: (level: 'info' | 'warn' | 'error', message: string) => void;
+}
+/** What `/hardware/*` needs from the service; the same shape `server/control/types.ts` names `HardwareControl`. */
+export interface HardwareControlSurface {
+    info: () => Promise<HardwareInfoResponse>;
+    refresh: () => Promise<HardwareInfoResponse>;
+    getOverride: () => HardwareOverride | undefined;
+    setOverride: (input: HardwareOverrideInput) => HardwareOverride;
+    clearOverride: () => boolean;
+}
+export declare class HardwareService implements HardwareFactsSource, HardwareControlSurface {
+    private readonly options;
+    private readonly arch;
+    private readonly osType;
+    private readonly now;
+    private readonly log;
+    private readonly override;
+    private inFlight;
+    private last;
+    constructor(options: HardwareServiceOptions);
+    /** Start the first probe without waiting for it. Idempotent. */
+    start(): void;
+    /** The current description, with the override applied when one stands. */
+    info(): Promise<HardwareInfoResponse>;
+    /**
+     * Probe again and answer with the result. A probe already running is awaited instead of doubled:
+     * two PowerShell processes measuring the same machine would only make both slower.
+     */
+    refresh(): Promise<HardwareInfoResponse>;
+    /** The slice the backend selectors read. Waits for the probe in flight. */
+    facts(): Promise<HardwareFacts>;
+    getOverride(): HardwareOverride | undefined;
+    setOverride(input: HardwareOverrideInput): HardwareOverride;
+    clearOverride(): boolean;
+    private current;
+    private run;
+    private render;
+    /** What is left when the probe itself threw: the arch and OS the service was built for. */
+    private minimalInfo;
+}

package/dist/hardware/service.js

@@ -0,0 +1,114 @@
+/**
+ * The hardware facts of this core process: one probe at start-up, re-run on request, replaced
+ * wholesale by an injected override for as long as one stands (`override.ts`).
+ *
+ * `start()` kicks the probe off and returns at once, so the control listener is up while PowerShell
+ * is still starting; the first caller that needs the facts (`facts()`, a backend load, `info()`)
+ * waits for that probe, and every later one reads the answer. Nothing is persisted, for the reasons
+ * `override.ts` gives: hardware changes between runs.
+ */
+import { factsOf, osTypeOf, rustArch, systemInfoWithOverride } from './facts.js';
+import { HardwareOverrideStore } from './override.js';
+export class HardwareService {
+    options;
+    arch;
+    osType;
+    now;
+    log;
+    override;
+    inFlight;
+    last;
+    constructor(options) {
+        this.options = options;
+        this.arch = rustArch(options.arch);
+        this.osType = osTypeOf(options.platform ?? 'unknown');
+        this.now = options.now ?? Date.now;
+        this.log = options.log ?? (() => { });
+        this.override = new HardwareOverrideStore(this.now);
+    }
+    /** Start the first probe without waiting for it. Idempotent. */
+    start() {
+        if (!this.inFlight && !this.last)
+            void this.run();
+    }
+    /** The current description, with the override applied when one stands. */
+    async info() {
+        return this.render(await this.current());
+    }
+    /**
+     * Probe again and answer with the result. A probe already running is awaited instead of doubled:
+     * two PowerShell processes measuring the same machine would only make both slower.
+     */
+    async refresh() {
+        return this.render(await (this.inFlight ?? this.run()));
+    }
+    /** The slice the backend selectors read. Waits for the probe in flight. */
+    async facts() {
+        const probed = await this.current();
+        // The probe's own reading of the architecture, so a canned probe describes a whole host; the
+        // constructor's `arch` only fills the last-resort answer when the probe itself failed.
+        return factsOf(probed.info, probed.info.cpu.arch || this.arch, this.override.get());
+    }
+    getOverride() {
+        return this.override.get();
+    }
+    setOverride(input) {
+        const applied = this.override.set(input);
+        this.log('info', `hardware override accepted from ${applied.source ?? 'unknown'}: ${applied.gpus.length} GPU(s)`);
+        return applied;
+    }
+    clearOverride() {
+        return this.override.clear();
+    }
+    current() {
+        if (this.last)
+            return Promise.resolve(this.last);
+        return this.inFlight ?? this.run();
+    }
+    run() {
+        const started = this.now();
+        const attempt = this.options
+            .probe()
+            .then((result) => ({ info: result.info, warnings: [...result.warnings], probedAt: started }), (error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            this.log('warn', `hardware probe failed: ${message}`);
+            return {
+                info: this.minimalInfo(),
+                warnings: [`hardware probe failed: ${message}`],
+                probedAt: started,
+            };
+        })
+            .then((probed) => {
+            this.last = probed;
+            for (const warning of probed.warnings)
+                this.log('info', `hardware probe: ${warning}`);
+            return probed;
+        })
+            .finally(() => {
+            if (this.inFlight === attempt)
+                this.inFlight = undefined;
+        });
+        this.inFlight = attempt;
+        return attempt;
+    }
+    render(probed) {
+        const override = this.override.get();
+        return {
+            info: override ? systemInfoWithOverride(probed.info, override) : structuredClone(probed.info),
+            source: override ? 'override' : 'probe',
+            probed_at: probed.probedAt,
+            warnings: [...probed.warnings],
+        };
+    }
+    /** What is left when the probe itself threw: the arch and OS the service was built for. */
+    minimalInfo() {
+        return {
+            cpu: { name: 'Unknown CPU', core_count: 0, arch: this.arch, extensions: [], extensions_known: false },
+            os_type: this.osType,
+            os_name: '',
+            total_memory: 0,
+            gpus: [],
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/hardware/service.js.map

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

package/dist/hardware/vulkan.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Vulkan without linking a loader: the ICD registrations the loader would read (`icd.d/*.json` on
+ * Linux, `HKLM\SOFTWARE\Khronos\Vulkan\Drivers` on Windows) say which vendors have a Vulkan driver
+ * installed; `vulkaninfo --summary`, when the tools package is installed, says exactly which devices
+ * enumerate and whether they are discrete or integrated.
+ *
+ * Pure. When only the ICD is known, `guessDeviceType` gives the best answer it can and says `Unknown`
+ * otherwise, which the selectors treat as "not proven integrated".
+ */
+/** The loader's search order on Linux (`loader_and_layer_interface.md`), user directories included. */
+export declare function linuxIcdDirs(env: NodeJS.ProcessEnv): string[];
+/**
+ * The vendor an ICD manifest belongs to, from its file name (`nvidia_icd.json`, `radeon_icd.x86_64.json`,
+ * `intel_icd.x86_64.json`, Windows `nv-vk64.json` / `amd-vulkan64.json` / `igvk64.json`). Software and
+ * pass-through drivers (`lvp_icd`, `virtio_icd`, `dzn_icd`) are nobody's GPU.
+ */
+export declare function icdVendorOf(fileName: string): string | undefined;
+export interface VulkanDevice {
+    /** `GPUn` in `vulkaninfo --summary`. */
+    index: number;
+    apiVersion: string;
+    driverVersion: string;
+    vendorId: number;
+    deviceId: number;
+    /** Plugin spelling: `DiscreteGpu`, `IntegratedGpu`, `VirtualGpu`, `Other`, `Unknown`. */
+    deviceType: string;
+    deviceName: string;
+}
+/** `PHYSICAL_DEVICE_TYPE_DISCRETE_GPU` → `DiscreteGpu`, as vulkano serialises `PhysicalDeviceType`. */
+export declare function mapVulkanDeviceType(raw: string): string;
+/**
+ * The `GPUn:` blocks of `vulkaninfo --summary`. Software rasterisers (`PHYSICAL_DEVICE_TYPE_CPU`,
+ * llvmpipe) are dropped: they are not a GPU the Vulkan backend should be chosen for.
+ */
+export declare function parseVulkaninfoSummary(text: string): VulkanDevice[];
+/**
+ * Discrete or integrated, without a Vulkan enumeration to ask. A heuristic, by design: NVIDIA sells
+ * no integrated PCI GPUs; Intel's discrete Arc parts (Alchemist `0x56xx`, Battlemage `0xe2xx`) are
+ * the only Intel GPUs that are not an iGPU; an AMD GPU whose driver reports under 1 GiB of VRAM is
+ * an APU; Qualcomm Adreno is always part of the SoC. Everything else is `Unknown`, which
+ * `integratedGpuOnly` does not count as integrated.
+ */
+export declare function guessDeviceType(gpu: {
+    vendor: string;
+    deviceId: number;
+    vramTotalMiB?: number;
+}): string;

package/dist/hardware/vulkan.js

@@ -0,0 +1,148 @@
+/**
+ * Vulkan without linking a loader: the ICD registrations the loader would read (`icd.d/*.json` on
+ * Linux, `HKLM\SOFTWARE\Khronos\Vulkan\Drivers` on Windows) say which vendors have a Vulkan driver
+ * installed; `vulkaninfo --summary`, when the tools package is installed, says exactly which devices
+ * enumerate and whether they are discrete or integrated.
+ *
+ * Pure. When only the ICD is known, `guessDeviceType` gives the best answer it can and says `Unknown`
+ * otherwise, which the selectors treat as "not proven integrated".
+ */
+/** The loader's search order on Linux (`loader_and_layer_interface.md`), user directories included. */
+export function linuxIcdDirs(env) {
+    const dirs = [
+        '/usr/share/vulkan/icd.d',
+        '/etc/vulkan/icd.d',
+        '/usr/local/share/vulkan/icd.d',
+        '/usr/local/etc/vulkan/icd.d',
+    ];
+    const home = env['HOME'];
+    const dataHome = env['XDG_DATA_HOME'] || (home ? `${home}/.local/share` : undefined);
+    if (dataHome)
+        dirs.push(`${dataHome}/vulkan/icd.d`);
+    const configHome = env['XDG_CONFIG_HOME'] || (home ? `${home}/.config` : undefined);
+    if (configHome)
+        dirs.push(`${configHome}/vulkan/icd.d`);
+    for (const dir of (env['XDG_DATA_DIRS'] ?? '').split(':'))
+        if (dir)
+            dirs.push(`${dir}/vulkan/icd.d`);
+    return [...new Set(dirs)];
+}
+/**
+ * The vendor an ICD manifest belongs to, from its file name (`nvidia_icd.json`, `radeon_icd.x86_64.json`,
+ * `intel_icd.x86_64.json`, Windows `nv-vk64.json` / `amd-vulkan64.json` / `igvk64.json`). Software and
+ * pass-through drivers (`lvp_icd`, `virtio_icd`, `dzn_icd`) are nobody's GPU.
+ */
+export function icdVendorOf(fileName) {
+    const name = fileName.split(/[\\/]/).pop()?.toLowerCase() ?? '';
+    if (/^(nvidia_icd|nv-vk)/.test(name))
+        return 'NVIDIA';
+    if (/^(radeon_icd|amd_icd|amd-vulkan|amd_pro_icd)/.test(name))
+        return 'AMD';
+    if (/^(intel_icd|intel_hasvk|igvk)/.test(name))
+        return 'Intel';
+    if (/^(qcvk|qc_vk|qualcomm|adreno|freedreno_icd)/.test(name))
+        return 'Qualcomm';
+    return undefined;
+}
+/** `PHYSICAL_DEVICE_TYPE_DISCRETE_GPU` → `DiscreteGpu`, as vulkano serialises `PhysicalDeviceType`. */
+export function mapVulkanDeviceType(raw) {
+    switch (raw.trim().toUpperCase()) {
+        case 'PHYSICAL_DEVICE_TYPE_DISCRETE_GPU':
+            return 'DiscreteGpu';
+        case 'PHYSICAL_DEVICE_TYPE_INTEGRATED_GPU':
+            return 'IntegratedGpu';
+        case 'PHYSICAL_DEVICE_TYPE_VIRTUAL_GPU':
+            return 'VirtualGpu';
+        case 'PHYSICAL_DEVICE_TYPE_CPU':
+            return 'Cpu';
+        case 'PHYSICAL_DEVICE_TYPE_OTHER':
+            return 'Other';
+        default:
+            return 'Unknown';
+    }
+}
+/**
+ * The `GPUn:` blocks of `vulkaninfo --summary`. Software rasterisers (`PHYSICAL_DEVICE_TYPE_CPU`,
+ * llvmpipe) are dropped: they are not a GPU the Vulkan backend should be chosen for.
+ */
+export function parseVulkaninfoSummary(text) {
+    const devices = [];
+    let current;
+    const flush = () => {
+        if (!current)
+            return;
+        if (current.vendorId !== undefined && current.deviceId !== undefined && current.deviceType !== 'Cpu') {
+            devices.push({
+                index: current.index,
+                apiVersion: current.apiVersion ?? '',
+                driverVersion: current.driverVersion ?? '',
+                vendorId: current.vendorId,
+                deviceId: current.deviceId,
+                deviceType: current.deviceType ?? 'Unknown',
+                deviceName: current.deviceName ?? '',
+            });
+        }
+        current = undefined;
+    };
+    for (const line of text.split(/\r?\n/)) {
+        const header = /^GPU(\d+):\s*$/.exec(line.trim());
+        if (header) {
+            flush();
+            current = { index: Number(header[1]) };
+            continue;
+        }
+        if (!current)
+            continue;
+        const kv = /^\s*(\w+)\s*=\s*(.*)$/.exec(line);
+        if (!kv) {
+            // A non-indented line that is not a header ends the device list.
+            if (line.trim() !== '' && !/^\s/.test(line))
+                flush();
+            continue;
+        }
+        const value = (kv[2] ?? '').trim();
+        switch (kv[1]) {
+            case 'apiVersion':
+                current.apiVersion = value.split(/\s+/)[0] ?? '';
+                break;
+            case 'driverVersion':
+                current.driverVersion = value;
+                break;
+            case 'vendorID':
+                current.vendorId = Number.parseInt(value.replace(/^0x/i, ''), 16);
+                break;
+            case 'deviceID':
+                current.deviceId = Number.parseInt(value.replace(/^0x/i, ''), 16);
+                break;
+            case 'deviceType':
+                current.deviceType = mapVulkanDeviceType(value);
+                break;
+            case 'deviceName':
+                current.deviceName = value;
+                break;
+        }
+    }
+    flush();
+    return devices.filter((d) => Number.isFinite(d.vendorId) && Number.isFinite(d.deviceId));
+}
+/**
+ * Discrete or integrated, without a Vulkan enumeration to ask. A heuristic, by design: NVIDIA sells
+ * no integrated PCI GPUs; Intel's discrete Arc parts (Alchemist `0x56xx`, Battlemage `0xe2xx`) are
+ * the only Intel GPUs that are not an iGPU; an AMD GPU whose driver reports under 1 GiB of VRAM is
+ * an APU; Qualcomm Adreno is always part of the SoC. Everything else is `Unknown`, which
+ * `integratedGpuOnly` does not count as integrated.
+ */
+export function guessDeviceType(gpu) {
+    if (gpu.vendor === 'NVIDIA')
+        return 'DiscreteGpu';
+    if (gpu.vendor === 'Qualcomm')
+        return 'IntegratedGpu';
+    if (gpu.vendor === 'Intel') {
+        const family = (gpu.deviceId >> 8) & 0xff;
+        return family === 0x56 || family === 0xe2 ? 'DiscreteGpu' : 'IntegratedGpu';
+    }
+    if (gpu.vendor === 'AMD' && gpu.vramTotalMiB !== undefined && gpu.vramTotalMiB < 1024)
+        return 'IntegratedGpu';
+    return 'Unknown';
+}
+//# sourceMappingURL=vulkan.js.map

package/dist/hardware/vulkan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vulkan.js","sourceRoot":"","sources":["../../src/hardware/vulkan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uGAAuG;AACvG,MAAM,UAAU,YAAY,CAAC,GAAsB;IACjD,MAAM,IAAI,GAAG;QACX,yBAAyB;QACzB,mBAAmB;QACnB,+BAA+B;QAC/B,6BAA6B;KAC9B,CAAA;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACpF,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,eAAe,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACnF,IAAI,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,eAAe,CAAC,CAAA;IACvD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,eAAe,CAAC,CAAA;IACpG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC/D,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAA;IACrD,IAAI,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3E,IAAI,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IAC9D,IAAI,6CAA6C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IAC/E,OAAO,SAAS,CAAA;AAClB,CAAC;AAcD,uGAAuG;AACvG,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,KAAK,mCAAmC;YACtC,OAAO,aAAa,CAAA;QACtB,KAAK,qCAAqC;YACxC,OAAO,eAAe,CAAA;QACxB,KAAK,kCAAkC;YACrC,OAAO,YAAY,CAAA;QACrB,KAAK,0BAA0B;YAC7B,OAAO,KAAK,CAAA;QACd,KAAK,4BAA4B;YAC/B,OAAO,OAAO,CAAA;QAChB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,IAAI,OAAgE,CAAA;IACpE,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YACrG,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;gBACpC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;gBAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;gBAC3C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;aACrC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC,CAAA;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,EAAE,CAAA;YACP,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YACtC,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,MAAM,EAAE,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,iEAAiE;YACjE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,KAAK,EAAE,CAAA;YACpD,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAClC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;gBAChD,MAAK;YACP,KAAK,eAAe;gBAClB,OAAO,CAAC,aAAa,GAAG,KAAK,CAAA;gBAC7B,MAAK;YACP,KAAK,UAAU;gBACb,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;gBACjE,MAAK;YACP,KAAK,UAAU;gBACb,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;gBACjE,MAAK;YACP,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;gBAC/C,MAAK;YACP,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,GAAG,KAAK,CAAA;gBAC1B,MAAK;QACT,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAA;IACP,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgE;IAC9F,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAA;IACjD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,eAAe,CAAA;IACrD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;QACzC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAA;IAC7E,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,GAAG,IAAI;QACnF,OAAO,eAAe,CAAA;IACxB,OAAO,SAAS,CAAA;AAClB,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * Windows GPUs, CPU and OS from one PowerShell run: `Win32_VideoController` for the adapters, the
+ * display class registry for the driver's own VRAM figure (`HardwareInformation.qwMemorySize`, which
+ * `AdapterRAM` cannot hold above 4 GiB) and its Vulkan ICD, `Win32_Processor` / `Win32_OperatingSystem`
+ * for names and cores, `vulkan-1.dll` + the Khronos driver registrations for the loader, and
+ * `IsProcessorFeaturePresent` for the CPU flags. One process, one JSON document, because PowerShell
+ * takes seconds to start and five runs would take five times as long.
+ *
+ * Pure: the script text, its arguments, and the parse of what comes back. `probe-windows.ts` runs it.
+ */
+/**
+ * One line, `;`-separated, no double quotes (the C# attribute builds its quotes from `[char]34`): what
+ * `-Command` receives has been through Node's Windows argument quoting and PowerShell's own parser,
+ * and a script that never needs escaping cannot be mangled by either. Every list is wrapped in `@()`
+ * and the parser still accepts a bare object, because PowerShell 5.1 collapses single-element
+ * collections on the way to JSON. `Add-Type` fails in Constrained Language Mode; `pf` is then `null`.
+ */
+export declare const WINDOWS_PROBE_SCRIPT: string;
+export declare function windowsProbeArgs(): string[];
+export interface WindowsVideoController {
+    Name?: string;
+    /** Bytes, a 32-bit field: 4 GiB minus one at most. */
+    AdapterRAM?: number;
+    /** `PCI\VEN_10DE&DEV_2684&SUBSYS_…&REV_A1\4&…`, or `ROOT\…` / `SWD\…` for software adapters. */
+    PNPDeviceID?: string;
+    DriverVersion?: string;
+}
+export interface WindowsDisplayClassKey {
+    /** `0000`, `0001`, … */
+    key: string;
+    /** `pci\ven_10de&dev_2684` (lower case, no subsystem) — how the key is matched to an adapter. */
+    MatchingDeviceId?: string;
+    DriverDesc?: string;
+    /** `HardwareInformation.qwMemorySize`, bytes, 64-bit. */
+    qwMemorySize?: number;
+    /** The ICD manifests this driver registered, absolute paths. */
+    VulkanDriverName: string[];
+}
+export interface WindowsProbe {
+    video: WindowsVideoController[];
+    classKeys: WindowsDisplayClassKey[];
+    cpu: Array<{
+        Name?: string;
+        NumberOfCores?: number;
+    }>;
+    os: {
+        Caption?: string;
+        Version?: string;
+        BuildNumber?: string;
+    } | undefined;
+    vulkan: {
+        dll: boolean;
+        drivers: string[];
+    };
+    /** `IsProcessorFeaturePresent` by feature number, or `null` when the P/Invoke could not be compiled. */
+    pf: Record<string, boolean> | null;
+    build: number;
+}
+/** Parse the script's JSON. Tolerates a UTF-8 BOM and single-element collapse; throws on anything that is not the document. */
+export declare function parseWindowsProbe(json: string): WindowsProbe;
+/**
+ * `PCI\VEN_10DE&DEV_2684&…` → the two ids. Snapdragon's Adreno is not on PCI: its instance id is
+ * `ACPI\QCOM0C36\…` (or `ACPI\VEN_QCOM&DEV_0C36…`), read as Qualcomm's Vulkan vendor id and the
+ * ACPI device number. `undefined` for anything else.
+ */
+export declare function parsePnpDeviceId(id: string): {
+    vendorId: number;
+    deviceId: number;
+} | undefined;
+/** A PCI display adapter as the probe saw it, before merging with nvidia-smi. */
+export interface WindowsAdapter {
+    name: string;
+    vendorId: number;
+    deviceId: number;
+    /** The PNP instance id, the stable opaque `uuid` of a non-NVIDIA GPU. */
+    pnpDeviceId: string;
+    /** The OS driver string (`32.0.15.8142` for an NVIDIA WDDM driver). */
+    driverVersion: string;
+    /** MiB; absent when neither the class key nor `AdapterRAM` had a figure. */
+    vramTotalMiB?: number;
+    /** The display class key registered a Vulkan ICD for this adapter. */
+    vulkanDriver: boolean;
+}
+/**
+ * The PCI GPUs of the machine, plus Snapdragon's ACPI-enumerated Adreno. Software adapters (`ROOT\BasicDisplay`, the `SWD\` RDP mirror) are not
+ * GPUs and are skipped. VRAM comes from the class key matched by vendor and device id — `AdapterRAM`
+ * is a 32-bit field that reports 4 GiB for every larger card, so falling back to it is warned about.
+ */
+export declare function windowsGpus(probe: WindowsProbe): {
+    adapters: WindowsAdapter[];
+    icdVendors: Set<string>;
+    warnings: string[];
+};
+/** Physical cores across sockets; `undefined` when CIM did not answer. */
+export declare function coreCount(probe: WindowsProbe): number | undefined;
+/** `Microsoft Windows 11 Pro`, as CIM spells it; `undefined` when it did not answer. */
+export declare function osName(probe: WindowsProbe): string | undefined;