@atomic-chat/core 0.5.1 → 0.13.2

package/dist/engines/versions.js

@@ -0,0 +1,259 @@
+/**
+ * `POST /engines/versions` (change `unify-engine-lifecycle`, spec `engine-lifecycle`, "Версии всех
+ * движков хоста", "Описание установленной сборки", "Предложение обновления"; design D1, D2): one entry
+ * per engine of this host, each built from the system that installs it, never by merging them.
+ *
+ *   - llama.cpp — the backend advisor's update check and catalog, and the packs on disk;
+ *   - sd.cpp, MLX — the `engine-builds` catalog and update check;
+ *   - TensorRT-LLM, vLLM — the installation record and the last accepted descriptor, ordered by
+ *     `descriptor-order.ts`.
+ *
+ * Every builder only reads: it downloads nothing but the documents that say what exists, and changes
+ * no build and no setting. The entries are built in parallel, and one engine's failure is that
+ * engine's `error`, so a broken TurboQuant index never hides an MLX update.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { backendTypeEquivalents, compareVersions } from '../backend/index.js';
+import { isNewerDescriptor } from './descriptor-order.js';
+/** Who picks the active build, and how an update applies, by the system underneath. */
+const ACTIVE_CHOICE = { 'llamacpp': 'client', 'engine-build': 'core', 'managed': 'core' };
+const APPLY = { 'llamacpp': 'swap', 'engine-build': 'swap', 'managed': 'reinstall' };
+const keyOf = (versionBackend) => {
+    const [version, variant, ...rest] = versionBackend.trim().split('/');
+    if (!version || !variant || rest.length > 0 || version === 'latest' || version === 'none')
+        return null;
+    return { version, variant };
+};
+const sameKey = (a, b) => a !== null && a.version === b.version && a.variant === b.variant;
+/** The one reason a build cannot go, in the spec's order: an active build that is busy is `active`. */
+function described(key, origin, active, inUse) {
+    const reason = active
+        ? 'active'
+        : origin === 'bundled'
+            ? 'bundled'
+            : inUse
+                ? 'in-use'
+                : undefined;
+    return {
+        ...key,
+        origin,
+        active,
+        in_use: inUse,
+        removable: reason === undefined,
+        ...(reason !== undefined ? { not_removable_reason: reason } : {}),
+    };
+}
+/** An entry for an engine whose source gave nothing at all: `error` says so, with the offer blocked. */
+const noSource = (message) => ({ code: 'UPSTREAM_ERROR', message });
+function offer(kind, active, target, blocked) {
+    const apply = APPLY[kind];
+    // Never without an active build, and never alongside a reason not to.
+    if (active === null || blocked !== undefined || target === null)
+        return {
+            needed: false,
+            target: null,
+            apply,
+            ...(active !== null && blocked ? { blocked_reason: blocked } : {}),
+        };
+    return { needed: true, target, apply };
+}
+/** The advisor's catalog sources, read as fetched now, accepted before, or nothing. */
+function llamacppSource(source) {
+    switch (source) {
+        case 'live':
+        case 'index':
+        case 'redirect':
+        case 'legacy-manifest':
+            return { source: 'remote', failed: false };
+        // Fetched earlier in this process and kept for the session: nothing failed.
+        case 'session-cache':
+            return { source: 'cache', failed: false };
+        case 'disk-cache':
+        case 'bundled-baseline':
+            return { source: 'cache', failed: true };
+        case 'none':
+            return { source: null, failed: true };
+    }
+}
+function llamacppSize(catalog, updates, key) {
+    if (updates.offer === `${key.version}/${key.variant}` && updates.download_size !== undefined)
+        return updates.download_size;
+    return catalog.releases
+        ?.find((release) => release.tag === key.version)
+        ?.variants.find((v) => v.id === key.variant)?.size;
+}
+export async function llamacppVersions(deps, request) {
+    const current = deps.current().trim();
+    const proxy = request.proxy ?? null;
+    const appVersion = request.app_version ?? null;
+    // The catalog is read first, with `force`, and its source is what this answer reports; the update
+    // check reads the catalog again and is served from that read.
+    const catalog = await deps.catalog({
+        current_backend: current,
+        force: request.force ?? false,
+        app_version: appVersion,
+        proxy,
+    });
+    const updates = await deps.checkUpdates({ current, force: false, app_version: appVersion, proxy });
+    const [packs, bundled] = await Promise.all([deps.listInstalled(current), deps.bundledPack()]);
+    const active = updates.current_kind === 'concrete' ? keyOf(current) : null;
+    const builds = [];
+    for (const pack of packs) {
+        const key = { version: pack.version, variant: pack.backend };
+        const origin = bundled && bundled.version === pack.version && bundled.backend === pack.backend
+            ? 'bundled'
+            : 'downloaded';
+        builds.push(described(key, origin, sameKey(active, key), await deps.inUse(pack.version, pack.backend)));
+    }
+    const sized = (key) => {
+        if (key === null)
+            return null;
+        const size = llamacppSize(catalog, updates, key);
+        return { ...key, ...(size !== undefined ? { download_bytes: size } : {}) };
+    };
+    const { source, failed } = llamacppSource(catalog.source);
+    const target = updates.offer ? sized(keyOf(updates.offer)) : null;
+    // The newest build of the active one's type; without an active build, what the advisor recommends.
+    const sameType = active
+        ? catalog.available.find((entry) => backendTypeEquivalents(active.variant).has(entry.backend))
+        : undefined;
+    const latest = target ??
+        sized(sameType ? { version: sameType.version, variant: sameType.backend } : keyOf(catalog.recommended ?? ''));
+    const newer = updates.update_needed && updates.target_backend !== null;
+    const blocked = source === null
+        ? 'source-unavailable'
+        : newer && !updates.same_family
+            ? 'family-change'
+            : newer && !updates.offer && deps.engine === 'llamacpp'
+                ? 'unstable'
+                : undefined;
+    const sourceError = failed
+        ? source === null
+            ? `No ${deps.engine} release source answered and nothing was accepted before.`
+            : `The ${deps.engine} release source was not reachable; the builds offered are the ones accepted before.`
+        : null;
+    return {
+        engine: deps.engine,
+        kind: 'llamacpp',
+        active_choice: ACTIVE_CHOICE.llamacpp,
+        builds,
+        active,
+        latest: source === null ? null : latest,
+        update: offer('llamacpp', active, blocked ? null : target, blocked),
+        source,
+        source_error: sourceError,
+        error: source === null ? noSource(sourceError) : null,
+    };
+}
+export async function engineBuildVersions(deps, request) {
+    const proxy = request.proxy ?? null;
+    const catalog = await deps.catalog({ force: request.force ?? false, proxy });
+    const check = await deps.checkUpdates({ proxy });
+    const active = catalog.active ? { version: catalog.active.tag, variant: catalog.active.backend_id } : null;
+    const builds = catalog.installed.map((build) => described({ version: build.tag, variant: build.backend_id }, build.origin, build.active, build.in_use));
+    const target = check.update_needed && check.target
+        ? {
+            version: check.target.tag,
+            variant: check.target.backend_id,
+            ...(check.target.published_at !== undefined ? { published_at: check.target.published_at } : {}),
+            download_bytes: check.target.download_bytes,
+        }
+        : null;
+    const manifest = catalog.manifest;
+    const latest = target ??
+        (manifest && catalog.host_backend_id
+            ? {
+                version: manifest.tag,
+                variant: catalog.host_backend_id,
+                ...(manifest.published_at !== undefined ? { published_at: manifest.published_at } : {}),
+            }
+            : null);
+    const source = manifest?.source ?? null;
+    const sourceError = manifest
+        ? manifest.error
+        : (catalog.manifest_error ?? `The ${deps.engine} manifest is unavailable.`);
+    return {
+        engine: deps.engine,
+        kind: 'engine-build',
+        active_choice: ACTIVE_CHOICE['engine-build'],
+        builds,
+        active,
+        latest,
+        update: offer('engine-build', active, target, source === null ? 'source-unavailable' : undefined),
+        source,
+        source_error: sourceError,
+        error: source === null ? noSource(sourceError ?? '') : null,
+    };
+}
+export async function managedVersions(deps, request) {
+    const [record, latestRead] = await Promise.all([deps.installation(), deps.latest()]);
+    const installedId = record?.installation.active_descriptor_id ?? null;
+    const active = record && installedId ? { version: installedId, variant: record.platform } : null;
+    // The one installation is what a removal takes: the engine as a whole, so it is always removable.
+    const builds = active
+        ? [{ ...active, origin: 'managed', active: true, in_use: deps.inUse(), removable: true }]
+        : [];
+    if (latestRead.kind === 'unavailable')
+        return {
+            engine: deps.engine,
+            kind: 'managed',
+            active_choice: ACTIVE_CHOICE.managed,
+            builds,
+            active,
+            latest: null,
+            update: offer('managed', active, null, 'source-unavailable'),
+            source: null,
+            source_error: latestRead.error.message,
+            error: latestRead.error.toJSON(),
+        };
+    const { descriptor } = latestRead;
+    const latest = {
+        version: descriptor.descriptor_id,
+        // The platform the installation pulled was the host's choice; a setup after a removal pulls the same.
+        variant: record?.platform ?? deps.platform,
+        download_bytes: descriptor.download_bytes,
+    };
+    const newer = installedId !== null && isNewerDescriptor(deps.engine, descriptor.descriptor_id, installedId);
+    const appVersion = request.app_version ?? null;
+    // Without the client's version there is nothing to compare; `atc` has no app to update.
+    const tooOld = appVersion !== null && compareVersions(appVersion, descriptor.minimum_app_version) < 0;
+    return {
+        engine: deps.engine,
+        kind: 'managed',
+        active_choice: ACTIVE_CHOICE.managed,
+        builds,
+        active,
+        latest,
+        update: offer('managed', active, newer ? latest : null, newer && tooOld ? 'requires-newer-app' : undefined),
+        source: latestRead.source,
+        source_error: null,
+        error: null,
+    };
+}
+/** All entries at once, in the order given; a reader that throws becomes its engine's `error`. */
+export async function collectEngineVersions(readers) {
+    const engines = await Promise.all(readers.map(async (reader) => {
+        try {
+            return await reader.read();
+        }
+        catch (error) {
+            const body = error instanceof AtomicCoreError
+                ? error.toJSON()
+                : { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : String(error) };
+            return {
+                engine: reader.engine,
+                kind: reader.kind,
+                active_choice: ACTIVE_CHOICE[reader.kind],
+                builds: [],
+                active: null,
+                latest: null,
+                update: { needed: false, target: null, apply: APPLY[reader.kind] },
+                source: null,
+                source_error: null,
+                error: body,
+            };
+        }
+    }));
+    return { engines };
+}
+//# sourceMappingURL=versions.js.map

package/dist/engines/versions.js.map

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

package/dist/hardware/cpu-flags.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CPU instruction-set flags in the spelling `tauri-plugin-hardware` emits, from the three places the
+ * probe can read them: `/proc/cpuinfo` (Linux), `sysctl machdep.cpu.*` (Intel Macs) and
+ * `IsProcessorFeaturePresent` (Windows, through PowerShell).
+ *
+ * Pure: text in, names out. The consumers (`isUnsupportedNoAvxCpu`, `getSupportedFeatures`) look for
+ * `avx`, `avx2` and `avx512*`; the rest is what the app's Hardware page lists.
+ */
+/** The 27 names the Rust plugin reports (its `cpu_extensions` table), in its order. */
+export declare const PLUGIN_CPU_EXTENSIONS: readonly string[];
+/**
+ * `IsProcessorFeaturePresent` feature numbers (winnt.h `PF_*`) → plugin spelling. Only the flags the
+ * kernel exposes this way; the AVX-512 sub-features have no PF number, so Windows reports `avx512_f` alone.
+ */
+export declare const WINDOWS_PROCESSOR_FEATURES: Readonly<Record<string, string>>;
+export interface ProcCpuinfo {
+    /** `model name` of the first processor (x86) or `Model name` / `Hardware` when present; otherwise absent. */
+    modelName?: string;
+    /**
+     * The plugin-spelled flags of the first processor; `undefined` when the file has no `flags` line,
+     * which is how arm64 kernels write it (they list `Features` instead, none of which the plugin reports).
+     */
+    flags: string[] | undefined;
+    /** Distinct (physical id, core id) pairs, or the first `cpu cores` value; absent on kernels without either. */
+    physicalCores?: number;
+}
+/** Read `/proc/cpuinfo`. Only the first processor's flags are read: cores of one socket share them. */
+export declare function parseProcCpuinfo(text: string): ProcCpuinfo;
+/**
+ * Intel Macs: `sysctl -n machdep.cpu.features machdep.cpu.leaf7_features`, two space-separated lists.
+ * Apple silicon has neither key and reports no x86 flags.
+ */
+export declare function parseDarwinCpuFeatures(features: string, leaf7: string): string[];
+/**
+ * Windows: the `IsProcessorFeaturePresent` answers keyed by feature number, as the PowerShell probe
+ * returns them, or `null` when its `Add-Type` P/Invoke failed (Constrained Language Mode, no compiler).
+ *
+ * `undefined` means unknown, never "no flags": a kernel older than build 20348 answers `false` for a
+ * feature number it does not know, so a `false` for AVX (PF 39) there says nothing about the CPU and
+ * must not block a CPU backend load.
+ */
+export declare function cpuExtensionsFromWindowsPf(pf: Record<string, boolean> | null, build: number, arch: string): string[] | undefined;
+/** Node (`x64`, `ia32`) and Rust (`x86_64`, `x86`) spellings, plus `amd64`. */
+export declare function isX86Arch(arch: string): boolean;

package/dist/hardware/cpu-flags.js

@@ -0,0 +1,206 @@
+/**
+ * CPU instruction-set flags in the spelling `tauri-plugin-hardware` emits, from the three places the
+ * probe can read them: `/proc/cpuinfo` (Linux), `sysctl machdep.cpu.*` (Intel Macs) and
+ * `IsProcessorFeaturePresent` (Windows, through PowerShell).
+ *
+ * Pure: text in, names out. The consumers (`isUnsupportedNoAvxCpu`, `getSupportedFeatures`) look for
+ * `avx`, `avx2` and `avx512*`; the rest is what the app's Hardware page lists.
+ */
+/** The 27 names the Rust plugin reports (its `cpu_extensions` table), in its order. */
+export const PLUGIN_CPU_EXTENSIONS = [
+    'fpu',
+    'mmx',
+    'sse',
+    'sse2',
+    'sse3',
+    'ssse3',
+    'sse4_1',
+    'sse4_2',
+    'pclmulqdq',
+    'avx',
+    'avx2',
+    'avx512_f',
+    'avx512_dq',
+    'avx512_ifma',
+    'avx512_pf',
+    'avx512_er',
+    'avx512_cd',
+    'avx512_bw',
+    'avx512_vl',
+    'avx512_vbmi',
+    'avx512_vbmi2',
+    'avx512_vnni',
+    'avx512_bitalg',
+    'avx512_vpopcntdq',
+    'avx512_vp2intersect',
+    'aes',
+    'f16c',
+];
+/** Linux `flags:` spelling → plugin spelling. Names not listed here are not something the plugin reports. */
+const LINUX_FLAGS = {
+    fpu: 'fpu',
+    mmx: 'mmx',
+    sse: 'sse',
+    sse2: 'sse2',
+    pni: 'sse3',
+    ssse3: 'ssse3',
+    sse4_1: 'sse4_1',
+    sse4_2: 'sse4_2',
+    pclmulqdq: 'pclmulqdq',
+    avx: 'avx',
+    avx2: 'avx2',
+    avx512f: 'avx512_f',
+    avx512dq: 'avx512_dq',
+    avx512ifma: 'avx512_ifma',
+    avx512pf: 'avx512_pf',
+    avx512er: 'avx512_er',
+    avx512cd: 'avx512_cd',
+    avx512bw: 'avx512_bw',
+    avx512vl: 'avx512_vl',
+    avx512vbmi: 'avx512_vbmi',
+    avx512_vbmi2: 'avx512_vbmi2',
+    avx512_vnni: 'avx512_vnni',
+    avx512_bitalg: 'avx512_bitalg',
+    avx512_vpopcntdq: 'avx512_vpopcntdq',
+    avx512_vp2intersect: 'avx512_vp2intersect',
+    aes: 'aes',
+    f16c: 'f16c',
+};
+/** `machdep.cpu.features` / `machdep.cpu.leaf7_features` spelling (upper case) → plugin spelling. */
+const DARWIN_FEATURES = {
+    'FPU': 'fpu',
+    'MMX': 'mmx',
+    'SSE': 'sse',
+    'SSE2': 'sse2',
+    'SSE3': 'sse3',
+    'SSSE3': 'ssse3',
+    'SSE4.1': 'sse4_1',
+    'SSE4.2': 'sse4_2',
+    'PCLMULQDQ': 'pclmulqdq',
+    'AVX1.0': 'avx',
+    'AVX2': 'avx2',
+    'AVX512F': 'avx512_f',
+    'AVX512DQ': 'avx512_dq',
+    'AVX512IFMA': 'avx512_ifma',
+    'AVX512PF': 'avx512_pf',
+    'AVX512ER': 'avx512_er',
+    'AVX512CD': 'avx512_cd',
+    'AVX512BW': 'avx512_bw',
+    'AVX512VL': 'avx512_vl',
+    'AVX512VBMI': 'avx512_vbmi',
+    'AVX512VBMI2': 'avx512_vbmi2',
+    'AVX512VNNI': 'avx512_vnni',
+    'AVX512BITALG': 'avx512_bitalg',
+    'AVX512VPOPCNTDQ': 'avx512_vpopcntdq',
+    'AVX512VP2INTERSECT': 'avx512_vp2intersect',
+    'AES': 'aes',
+    'F16C': 'f16c',
+};
+/**
+ * `IsProcessorFeaturePresent` feature numbers (winnt.h `PF_*`) → plugin spelling. Only the flags the
+ * kernel exposes this way; the AVX-512 sub-features have no PF number, so Windows reports `avx512_f` alone.
+ */
+export const WINDOWS_PROCESSOR_FEATURES = {
+    '3': 'mmx',
+    '6': 'sse',
+    '10': 'sse2',
+    '13': 'sse3',
+    '36': 'ssse3',
+    '37': 'sse4_1',
+    '38': 'sse4_2',
+    '39': 'avx',
+    '40': 'avx2',
+    '41': 'avx512_f',
+};
+/** The first Windows build whose `IsProcessorFeaturePresent` knows PF 39–41 (Server 2022 / Windows 11). */
+const WINDOWS_BUILD_KNOWING_AVX_PF = 20348;
+/** In `PLUGIN_CPU_EXTENSIONS` order, each name once. */
+function inPluginOrder(names) {
+    const present = new Set(names);
+    return PLUGIN_CPU_EXTENSIONS.filter((name) => present.has(name));
+}
+/** Read `/proc/cpuinfo`. Only the first processor's flags are read: cores of one socket share them. */
+export function parseProcCpuinfo(text) {
+    let modelName;
+    let flags;
+    let firstCpuCores;
+    const cores = new Set();
+    let physicalId = '0';
+    for (const rawLine of text.split('\n')) {
+        const colon = rawLine.indexOf(':');
+        if (colon < 0)
+            continue;
+        const key = rawLine.slice(0, colon).trim().toLowerCase();
+        const value = rawLine.slice(colon + 1).trim();
+        if (key === 'model name' && modelName === undefined && value !== '')
+            modelName = value;
+        else if (key === 'hardware' && modelName === undefined && value !== '')
+            modelName = value;
+        else if (key === 'flags' && flags === undefined) {
+            const mapped = new Set();
+            for (const flag of value.split(/\s+/)) {
+                const name = LINUX_FLAGS[flag];
+                if (name)
+                    mapped.add(name);
+            }
+            // The plugin always lists `fpu` on x86: every x86-64 CPU has one, whatever the kernel prints.
+            mapped.add('fpu');
+            flags = inPluginOrder(mapped);
+        }
+        else if (key === 'physical id')
+            physicalId = value;
+        else if (key === 'core id')
+            cores.add(`${physicalId}:${value}`);
+        else if (key === 'cpu cores' && firstCpuCores === undefined) {
+            const n = Number(value);
+            if (Number.isInteger(n) && n > 0)
+                firstCpuCores = n;
+        }
+    }
+    const physicalCores = cores.size > 0 ? cores.size : firstCpuCores;
+    return {
+        ...(modelName !== undefined ? { modelName } : {}),
+        flags,
+        ...(physicalCores !== undefined ? { physicalCores } : {}),
+    };
+}
+/**
+ * Intel Macs: `sysctl -n machdep.cpu.features machdep.cpu.leaf7_features`, two space-separated lists.
+ * Apple silicon has neither key and reports no x86 flags.
+ */
+export function parseDarwinCpuFeatures(features, leaf7) {
+    const mapped = new Set();
+    for (const token of `${features} ${leaf7}`.split(/\s+/)) {
+        const name = DARWIN_FEATURES[token.toUpperCase()];
+        if (name)
+            mapped.add(name);
+    }
+    return inPluginOrder(mapped);
+}
+/**
+ * Windows: the `IsProcessorFeaturePresent` answers keyed by feature number, as the PowerShell probe
+ * returns them, or `null` when its `Add-Type` P/Invoke failed (Constrained Language Mode, no compiler).
+ *
+ * `undefined` means unknown, never "no flags": a kernel older than build 20348 answers `false` for a
+ * feature number it does not know, so a `false` for AVX (PF 39) there says nothing about the CPU and
+ * must not block a CPU backend load.
+ */
+export function cpuExtensionsFromWindowsPf(pf, build, arch) {
+    if (!isX86Arch(arch))
+        return [];
+    if (pf === null)
+        return undefined;
+    if (pf['39'] === false && build < WINDOWS_BUILD_KNOWING_AVX_PF)
+        return undefined;
+    const present = new Set(['fpu']);
+    for (const [number, name] of Object.entries(WINDOWS_PROCESSOR_FEATURES))
+        if (pf[number] === true)
+            present.add(name);
+    return inPluginOrder(present);
+}
+/** Node (`x64`, `ia32`) and Rust (`x86_64`, `x86`) spellings, plus `amd64`. */
+export function isX86Arch(arch) {
+    const a = arch.trim().toLowerCase();
+    return a === 'x86_64' || a === 'x64' || a === 'amd64' || a === 'x86' || a === 'ia32';
+}
+//# sourceMappingURL=cpu-flags.js.map

package/dist/hardware/cpu-flags.js.map

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

package/dist/hardware/drm-sysfs.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Linux GPUs from sysfs: `/sys/class/drm/card<N>/device/{vendor,device,mem_info_vram_total,boot_vga}`
+ * plus the `device` and `driver` symlinks for the PCI bus id and the kernel driver. This sees every
+ * PCI GPU the kernel bound a DRM driver to — AMD, Intel and NVIDIA alike — without any vendor tool.
+ *
+ * Pure: file contents in, `SysfsGpu` out. The walk itself is in `probe-linux.ts`.
+ */
+/** PCI vendor ids as sysfs prints them (`0x10de`). Qualcomm's is the one Vulkan reports for Adreno. */
+export declare const PCI_VENDOR: {
+    readonly NVIDIA: 4318;
+    readonly AMD: 4098;
+    readonly INTEL: 32902;
+    readonly QUALCOMM: 20803;
+};
+/** The plugin's vendor spelling, `Unknown (vendor_id: N)` for anyone else. */
+export declare function vendorName(vendorId: number): string;
+/** `0x10de\n` → 4318; `undefined` for anything that is not a hex number. */
+export declare function parseHexId(text: string): number | undefined;
+/** `card0`, `card1`, … — not `card0-DP-1` (a connector) and not `renderD128`. */
+export declare function isCardNode(name: string): boolean;
+export interface SysfsGpu {
+    /** The DRM node name, `card0`. */
+    card: string;
+    /** `0000:01:00.0`, from the `device` symlink; absent for a non-PCI device (a virtual GPU). */
+    busId?: string;
+    vendorId: number;
+    deviceId: number;
+    /** The kernel driver bound to the device (`amdgpu`, `i915`, `nvidia`, `nouveau`); absent when unbound. */
+    driver?: string;
+    /** `mem_info_vram_total` in MiB; only `amdgpu` exposes it. */
+    vramTotalMiB?: number;
+    /** The GPU the firmware booted with, when the kernel says. */
+    bootVga?: boolean;
+}
+export interface SysfsGpuFiles {
+    card: string;
+    /** Contents of `device/vendor`. */
+    vendor: string;
+    /** Contents of `device/device`. */
+    device: string;
+    /** Contents of `device/mem_info_vram_total`, bytes. */
+    vramTotal?: string;
+    /** Contents of `device/boot_vga`, `0` or `1`. */
+    bootVga?: string;
+    /** Target of the `device` symlink (`../../../0000:01:00.0`). */
+    deviceLink?: string;
+    /** Target of the `device/driver` symlink (`../../../../bus/pci/drivers/amdgpu`). */
+    driverLink?: string;
+}
+/** One card's files → `SysfsGpu`; `undefined` when the vendor or device id is unreadable. */
+export declare function sysfsGpuFromFiles(files: SysfsGpuFiles): SysfsGpu | undefined;

package/dist/hardware/drm-sysfs.js

@@ -0,0 +1,67 @@
+/**
+ * Linux GPUs from sysfs: `/sys/class/drm/card<N>/device/{vendor,device,mem_info_vram_total,boot_vga}`
+ * plus the `device` and `driver` symlinks for the PCI bus id and the kernel driver. This sees every
+ * PCI GPU the kernel bound a DRM driver to — AMD, Intel and NVIDIA alike — without any vendor tool.
+ *
+ * Pure: file contents in, `SysfsGpu` out. The walk itself is in `probe-linux.ts`.
+ */
+/** PCI vendor ids as sysfs prints them (`0x10de`). Qualcomm's is the one Vulkan reports for Adreno. */
+export const PCI_VENDOR = { NVIDIA: 0x10de, AMD: 0x1002, INTEL: 0x8086, QUALCOMM: 0x5143 };
+/** The plugin's vendor spelling, `Unknown (vendor_id: N)` for anyone else. */
+export function vendorName(vendorId) {
+    if (vendorId === PCI_VENDOR.NVIDIA)
+        return 'NVIDIA';
+    if (vendorId === PCI_VENDOR.AMD)
+        return 'AMD';
+    if (vendorId === PCI_VENDOR.INTEL)
+        return 'Intel';
+    if (vendorId === PCI_VENDOR.QUALCOMM)
+        return 'Qualcomm';
+    return `Unknown (vendor_id: ${vendorId})`;
+}
+/** `0x10de\n` → 4318; `undefined` for anything that is not a hex number. */
+export function parseHexId(text) {
+    const trimmed = text.trim().replace(/^0x/i, '');
+    if (!/^[0-9a-f]{1,8}$/i.test(trimmed))
+        return undefined;
+    return Number.parseInt(trimmed, 16);
+}
+/** `card0`, `card1`, … — not `card0-DP-1` (a connector) and not `renderD128`. */
+export function isCardNode(name) {
+    return /^card\d+$/.test(name);
+}
+const PCI_BUS_ID = /^[0-9a-f]{4}:[0-9a-f]{2}:[0-9a-f]{2}\.[0-9a-f]$/i;
+/** One card's files → `SysfsGpu`; `undefined` when the vendor or device id is unreadable. */
+export function sysfsGpuFromFiles(files) {
+    const vendorId = parseHexId(files.vendor);
+    const deviceId = parseHexId(files.device);
+    if (vendorId === undefined || deviceId === undefined)
+        return undefined;
+    const gpu = { card: files.card, vendorId, deviceId };
+    const busId = lastSegment(files.deviceLink);
+    if (busId && PCI_BUS_ID.test(busId))
+        gpu.busId = busId.toLowerCase();
+    const driver = lastSegment(files.driverLink);
+    if (driver)
+        gpu.driver = driver;
+    if (files.vramTotal !== undefined) {
+        const bytes = Number(files.vramTotal.trim());
+        if (Number.isFinite(bytes) && bytes > 0)
+            gpu.vramTotalMiB = Math.floor(bytes / 2 ** 20);
+    }
+    if (files.bootVga !== undefined) {
+        const value = files.bootVga.trim();
+        if (value === '1')
+            gpu.bootVga = true;
+        else if (value === '0')
+            gpu.bootVga = false;
+    }
+    return gpu;
+}
+function lastSegment(link) {
+    if (link === undefined)
+        return undefined;
+    const segment = link.trim().split('/').filter(Boolean).pop();
+    return segment === undefined || segment === '' ? undefined : segment;
+}
+//# sourceMappingURL=drm-sysfs.js.map