@atomic-chat/core 0.5.1

package/dist/backend/select/categories.js.map

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

package/dist/backend/select/features.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Hardware feature gates and the supported-backend matrix. Port of the pure policy in
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/backend.rs` (`get_supported_features` with its
+ * compute-capability and Windows-ROCm gates, `determine_supported_backends`, `list_supported_backends`)
+ * and of the Windows family-aware filter in the extension's `listSupportedBackends` (`backend.ts`).
+ *
+ * Nothing here reads hardware, disk or network: the probe result (`GpuProbeInfo[]`, cpu extensions),
+ * the installed list and the remote catalog are parameters.
+ */
+import type { BackendFeatures, BackendVersion, GpuProbeInfo, SupportedFeatures } from '../types.js';
+/**
+ * Minimum NVIDIA driver per CUDA tier (https://docs.nvidia.com/deploy/cuda-compatibility/).
+ * Windows floors follow the ggml-org native releases (CUDA 12.4 / 13.1; 13.1's documented minimum is
+ * 581.15 — `"581"` alone let 581.00–581.14 pre-release drivers through). Linux floors stay aligned
+ * with the TurboQuant plugin. Other OSes have no CUDA.
+ */
+export declare const CUDA_DRIVER_FLOORS: {
+    readonly linux: {
+        readonly cuda11: "450.80.02";
+        readonly cuda12: "525.60.13";
+        readonly cuda13: "580";
+    };
+    readonly windows: {
+        readonly cuda11: "452.39";
+        readonly cuda12: "551.61";
+        readonly cuda13: "581.15";
+    };
+};
+/**
+ * Lowest compute capability a CUDA-13 build still carries kernels for: CUDA Toolkit 13.0 removed
+ * Maxwell (5.x), Pascal (6.x) and Volta (7.0), so Turing (7.5) is the floor. The driver gate cannot
+ * catch this on its own — R580 is the last branch still supporting those cards, so they report a
+ * driver above the 581.15 floor and previously sailed through to "no kernel image is available".
+ */
+export declare const MIN_CUDA13_COMPUTE_CAPABILITY: readonly [number, number];
+/**
+ * NVML `"major.minor"` → `[major, minor]`; a missing minor is 0; unreadable input is `undefined`,
+ * which callers treat as "unknown — do not gate" (guessing "too old" would strand a Blackwell host).
+ */
+export declare function parseComputeCapability(raw: string): [number, number] | undefined;
+/** Tuple comparison against the floor, so `10.0 ≥ 7.5` holds (a string compare gets Blackwell wrong). */
+export declare function gpuMeetsCuda13ArchFloor(computeCapability: string | undefined): boolean;
+export declare function isAmdGpu(gpu: GpuProbeInfo): boolean;
+/**
+ * The Windows ROCm decision. The upstream archive statically carries HIP inside `ggml-hip.dll`, so
+ * an AMD driver is enough; what must be checked is the gfx architecture, and the PCI device id is the
+ * only pre-launch signal. Conservative: a card missing from the table falls back to Vulkan — 34.6 MB
+ * that works beats ~1 GB that may not — and the manual picker still offers ROCm.
+ */
+export declare function rocmSupportedWindows(hasAmdGpu: boolean, deviceIds: readonly number[]): boolean;
+/**
+ * Which CPU/GPU tiers this host can run. The driver is system-wide, so *any* NVIDIA GPU over a floor
+ * enables that CUDA tier; architecture is per-card and must hold for *every* card (llama.cpp
+ * offloads across all visible devices), so one sub-7.5 GPU vetoes CUDA 13 for the whole host.
+ * Vulkan is on when any GPU carries `vulkan_info`; ROCm only on Windows via the PCI table. On any OS
+ * other than linux/windows only the CPU flags are set (no CUDA, no Vulkan — macOS has Metal).
+ */
+export declare function getSupportedFeatures(osType: string, cpuExtensions: readonly string[], gpus: readonly GpuProbeInfo[]): SupportedFeatures;
+/** guest-js `normalizeFeatures`: missing flags read as `false`. */
+export declare function normalizeFeatures(features: Partial<BackendFeatures> | null | undefined): BackendFeatures;
+/**
+ * Backend ids installable on `<osType>-<arch>` given the detected features. Windows x64 always has
+ * CPU, then CUDA 12.4, the *family* ids `win-cuda-13-x64` / `win-rocm-x64` (concrete minors come
+ * from the manifest, ATO-105) and Vulkan. Linux x64: CPU, plus Vulkan — the CUDA and ROCm flags are
+ * ignored because ggml-org publishes no Linux CUDA/HIP archive (2026-05-28 ADR). arm64 Linux and
+ * Windows get a CPU placeholder; macOS its single arch build. Anything else is `INVALID_ARGUMENT`.
+ */
+export declare function determineSupportedBackends(osType: string, arch: string, features: BackendFeatures): string[];
+/**
+ * Merge the remote catalog with the installed builds, keyed `"<version>|<backend>"`. A local entry
+ * replaces the remote one only when its `order` is greater (an installed build carries its mtime,
+ * a manifest entry 0). Sorted newest first by `compareBackendVersionsForSort`.
+ */
+export declare function listSupportedBackends(remote: readonly BackendVersion[], local: readonly BackendVersion[]): BackendVersion[];
+/**
+ * The hardware gate on the merged catalog. Windows keeps only backends whose (normalised) id is in
+ * `supportedBackends`, matching concrete CUDA-13 and ROCm assets against their family ids so
+ * `win-cuda-13.4-x64` is accepted when `win-cuda-13-x64` is supported and flows downstream unchanged.
+ * Every other OS returns the list unfiltered (the manifest parser already applied the arch filter).
+ */
+export declare function filterBackendsBySupport(merged: readonly BackendVersion[], supportedBackends: readonly string[], osType: string): BackendVersion[];

package/dist/backend/select/features.js

@@ -0,0 +1,221 @@
+/**
+ * Hardware feature gates and the supported-backend matrix. Port of the pure policy in
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/backend.rs` (`get_supported_features` with its
+ * compute-capability and Windows-ROCm gates, `determine_supported_backends`, `list_supported_backends`)
+ * and of the Windows family-aware filter in the extension's `listSupportedBackends` (`backend.ts`).
+ *
+ * Nothing here reads hardware, disk or network: the probe result (`GpuProbeInfo[]`, cpu extensions),
+ * the installed list and the remote catalog are parameters.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { isConcreteOfGpuFamily, mapOldBackendToNew, WIN_ROCM_FAMILY_ID } from '../catalog/index.js';
+import { compareBackendVersionsForSort, compareVersions, parseRustU32, stripBom } from '../version.js';
+import { isRocmSupportedPciId } from './amd-rocm-pci-ids.js';
+// ---------------------------------------------------------------------------------------------
+// Feature detection (get_supported_features)
+// ---------------------------------------------------------------------------------------------
+/**
+ * Minimum NVIDIA driver per CUDA tier (https://docs.nvidia.com/deploy/cuda-compatibility/).
+ * Windows floors follow the ggml-org native releases (CUDA 12.4 / 13.1; 13.1's documented minimum is
+ * 581.15 — `"581"` alone let 581.00–581.14 pre-release drivers through). Linux floors stay aligned
+ * with the TurboQuant plugin. Other OSes have no CUDA.
+ */
+export const CUDA_DRIVER_FLOORS = {
+    linux: { cuda11: '450.80.02', cuda12: '525.60.13', cuda13: '580' },
+    windows: { cuda11: '452.39', cuda12: '551.61', cuda13: '581.15' },
+};
+/**
+ * Lowest compute capability a CUDA-13 build still carries kernels for: CUDA Toolkit 13.0 removed
+ * Maxwell (5.x), Pascal (6.x) and Volta (7.0), so Turing (7.5) is the floor. The driver gate cannot
+ * catch this on its own — R580 is the last branch still supporting those cards, so they report a
+ * driver above the 581.15 floor and previously sailed through to "no kernel image is available".
+ */
+export const MIN_CUDA13_COMPUTE_CAPABILITY = [7, 5];
+/**
+ * NVML `"major.minor"` → `[major, minor]`; a missing minor is 0; unreadable input is `undefined`,
+ * which callers treat as "unknown — do not gate" (guessing "too old" would strand a Blackwell host).
+ */
+export function parseComputeCapability(raw) {
+    const parts = raw.trim().split('.');
+    const major = parseRustU32((parts[0] ?? '').trim());
+    if (major === undefined)
+        return undefined;
+    const minor = parseRustU32((parts[1] ?? '0').trim()) ?? 0;
+    return [major, minor];
+}
+/** Tuple comparison against the floor, so `10.0 ≥ 7.5` holds (a string compare gets Blackwell wrong). */
+export function gpuMeetsCuda13ArchFloor(computeCapability) {
+    const cc = parseComputeCapability(computeCapability ?? '');
+    if (!cc)
+        return true;
+    const [floorMajor, floorMinor] = MIN_CUDA13_COMPUTE_CAPABILITY;
+    return cc[0] > floorMajor || (cc[0] === floorMajor && cc[1] >= floorMinor);
+}
+export function isAmdGpu(gpu) {
+    return typeof gpu.vendor === 'string' && gpu.vendor.toLowerCase() === 'amd';
+}
+/**
+ * The Windows ROCm decision. The upstream archive statically carries HIP inside `ggml-hip.dll`, so
+ * an AMD driver is enough; what must be checked is the gfx architecture, and the PCI device id is the
+ * only pre-launch signal. Conservative: a card missing from the table falls back to Vulkan — 34.6 MB
+ * that works beats ~1 GB that may not — and the manual picker still offers ROCm.
+ */
+export function rocmSupportedWindows(hasAmdGpu, deviceIds) {
+    return hasAmdGpu && deviceIds.some((id) => isRocmSupportedPciId(id));
+}
+/**
+ * Which CPU/GPU tiers this host can run. The driver is system-wide, so *any* NVIDIA GPU over a floor
+ * enables that CUDA tier; architecture is per-card and must hold for *every* card (llama.cpp
+ * offloads across all visible devices), so one sub-7.5 GPU vetoes CUDA 13 for the whole host.
+ * Vulkan is on when any GPU carries `vulkan_info`; ROCm only on Windows via the PCI table. On any OS
+ * other than linux/windows only the CPU flags are set (no CUDA, no Vulkan — macOS has Metal).
+ */
+export function getSupportedFeatures(osType, cpuExtensions, gpus) {
+    const features = {
+        avx: cpuExtensions.includes('avx'),
+        avx2: cpuExtensions.includes('avx2'),
+        avx512: cpuExtensions.includes('avx512'),
+        cuda11: false,
+        cuda12: false,
+        cuda13: false,
+        vulkan: false,
+        rocm: false,
+    };
+    const floors = osType === 'linux' || osType === 'windows' ? CUDA_DRIVER_FLOORS[osType] : undefined;
+    if (!floors)
+        return features;
+    const amdDeviceIds = [];
+    let hasAmdGpu = false;
+    let allNvidiaMeetCuda13Arch = true;
+    for (const gpu of gpus) {
+        const driver = gpu.driver_version ?? '';
+        if (isAmdGpu(gpu)) {
+            hasAmdGpu = true;
+            const deviceId = gpu.vulkan_info?.device_id;
+            if (typeof deviceId === 'number')
+                amdDeviceIds.push(deviceId);
+        }
+        const nvidia = gpu.nvidia_info;
+        if (nvidia) {
+            if (compareVersions(driver, floors.cuda11) >= 0)
+                features.cuda11 = true;
+            if (compareVersions(driver, floors.cuda12) >= 0)
+                features.cuda12 = true;
+            if (compareVersions(driver, floors.cuda13) >= 0)
+                features.cuda13 = true;
+            if (!gpuMeetsCuda13ArchFloor(nvidia.compute_capability))
+                allNvidiaMeetCuda13Arch = false;
+        }
+        if (gpu.vulkan_info)
+            features.vulkan = true;
+    }
+    features.cuda13 = features.cuda13 && allNvidiaMeetCuda13Arch;
+    if (osType === 'windows')
+        features.rocm = rocmSupportedWindows(hasAmdGpu, amdDeviceIds);
+    return features;
+}
+/** guest-js `normalizeFeatures`: missing flags read as `false`. */
+export function normalizeFeatures(features) {
+    return {
+        cuda11: features?.cuda11 || false,
+        cuda12: features?.cuda12 || false,
+        cuda13: features?.cuda13 || false,
+        vulkan: features?.vulkan || false,
+        rocm: features?.rocm || false,
+    };
+}
+// ---------------------------------------------------------------------------------------------
+// Supported matrix (determine_supported_backends) and catalog merge (list_supported_backends)
+// ---------------------------------------------------------------------------------------------
+/**
+ * Backend ids installable on `<osType>-<arch>` given the detected features. Windows x64 always has
+ * CPU, then CUDA 12.4, the *family* ids `win-cuda-13-x64` / `win-rocm-x64` (concrete minors come
+ * from the manifest, ATO-105) and Vulkan. Linux x64: CPU, plus Vulkan — the CUDA and ROCm flags are
+ * ignored because ggml-org publishes no Linux CUDA/HIP archive (2026-05-28 ADR). arm64 Linux and
+ * Windows get a CPU placeholder; macOS its single arch build. Anything else is `INVALID_ARGUMENT`.
+ */
+export function determineSupportedBackends(osType, arch, features) {
+    const sysType = `${osType}-${arch}`;
+    const supported = [];
+    switch (sysType) {
+        case 'windows-x86_64':
+            supported.push('win-cpu-x64');
+            if (features.cuda12)
+                supported.push('win-cuda-12.4-x64');
+            if (features.cuda13)
+                supported.push('win-cuda-13-x64');
+            if (features.rocm)
+                supported.push(WIN_ROCM_FAMILY_ID);
+            if (features.vulkan)
+                supported.push('win-vulkan-x64');
+            break;
+        case 'windows-aarch64':
+        case 'windows-arm64':
+            supported.push('win-cpu-arm64');
+            break;
+        case 'linux-x86_64':
+        case 'linux-x86':
+            supported.push('linux-cpu-x64');
+            if (features.vulkan)
+                supported.push('linux-vulkan-x64');
+            break;
+        case 'linux-aarch64':
+        case 'linux-arm64':
+            supported.push('linux-cpu-arm64');
+            break;
+        case 'macos-x86_64':
+        case 'macos-x86':
+            supported.push('macos-x64');
+            break;
+        case 'macos-aarch64':
+        case 'macos-arm64':
+            supported.push('macos-arm64');
+            break;
+        default:
+            throw new AtomicCoreError('INVALID_ARGUMENT', `Unsupported system type: ${sysType}`);
+    }
+    return supported;
+}
+/**
+ * Merge the remote catalog with the installed builds, keyed `"<version>|<backend>"`. A local entry
+ * replaces the remote one only when its `order` is greater (an installed build carries its mtime,
+ * a manifest entry 0). Sorted newest first by `compareBackendVersionsForSort`.
+ */
+export function listSupportedBackends(remote, local) {
+    const merged = new Map();
+    for (const entry of remote)
+        merged.set(`${entry.version}|${entry.backend}`, { ...entry });
+    for (const entry of local) {
+        const key = `${entry.version}|${entry.backend}`;
+        const existing = merged.get(key);
+        if (!existing)
+            merged.set(key, { ...entry });
+        else if ((entry.order ?? 0) > (existing.order ?? 0))
+            merged.set(key, { ...entry });
+    }
+    return [...merged.values()].sort(compareBackendVersionsForSort);
+}
+/**
+ * The hardware gate on the merged catalog. Windows keeps only backends whose (normalised) id is in
+ * `supportedBackends`, matching concrete CUDA-13 and ROCm assets against their family ids so
+ * `win-cuda-13.4-x64` is accepted when `win-cuda-13-x64` is supported and flows downstream unchanged.
+ * Every other OS returns the list unfiltered (the manifest parser already applied the arch filter).
+ */
+export function filterBackendsBySupport(merged, supportedBackends, osType) {
+    if (osType !== 'windows')
+        return [...merged];
+    const supportedSet = new Set(supportedBackends);
+    const cuda13Concrete = /^win-cuda-13\.\d+-(x64|arm64)$/;
+    const isSupported = (rawBackend, normalized) => {
+        if (supportedSet.has(normalized))
+            return true;
+        const m = cuda13Concrete.exec(rawBackend);
+        if (m)
+            return supportedSet.has(`win-cuda-13-${m[1]}`);
+        if (isConcreteOfGpuFamily(WIN_ROCM_FAMILY_ID, rawBackend))
+            return supportedSet.has(WIN_ROCM_FAMILY_ID);
+        return false;
+    };
+    return merged.filter((b) => isSupported(stripBom(b.backend), mapOldBackendToNew(b.backend)));
+}
+//# sourceMappingURL=features.js.map

package/dist/backend/select/features.js.map

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

package/dist/backend/select/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hardware-gated backend selection: feature gates and the supported matrix, categories and
+ * priority, GPU tier probing, and the persisted `version_backend` startup recovery.
+ */
+export * from './amd-rocm-pci-ids.js';
+export * from './features.js';
+export * from './categories.js';
+export * from './tiers.js';
+export * from './recovery.js';

package/dist/backend/select/index.js

@@ -0,0 +1,10 @@
+/**
+ * Hardware-gated backend selection: feature gates and the supported matrix, categories and
+ * priority, GPU tier probing, and the persisted `version_backend` startup recovery.
+ */
+export * from './amd-rocm-pci-ids.js';
+export * from './features.js';
+export * from './categories.js';
+export * from './tiers.js';
+export * from './recovery.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/select/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/select/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA"}

package/dist/backend/select/recovery.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The `configureBackends` startup recovery in `extensions/llamacpp-upstream-extension/src/index.ts`:
+ * persisted `version_backend` recovery and the bundled-build / same-type upgrade decisions,
+ * extracted from the settings/UI plumbing.
+ *
+ * Nothing here reads hardware, disk or network: the persisted values, the installed list, the
+ * probe result and the catalog are parameters.
+ */
+import type { BackendOption, BackendVersion, GpuProbeInfo } from '../types.js';
+/** Persisted `version_backend` is unusable: empty, `none`, or not `<version>/<backend>`. */
+export declare function isPersistedVersionBackendMissing(versionBackend: string | undefined | null): boolean;
+/**
+ * When the persisted `version_backend` was lost (wiped WebView storage, factory reset) but builds
+ * are still on disk, pick the best installed one so the user's GPU backend survives the restart
+ * instead of silently re-pinning the bundled CPU build. `null` when nothing usable is installed.
+ */
+export declare function recoverVersionBackendFromDisk(installed: readonly BackendVersion[], gpus: readonly GpuProbeInfo[]): string | null;
+/**
+ * Apply the bundled build over the persisted value when that value is still not a concrete
+ * `<tag>/<backend>` after recovery — including the unresolved `latest/<backend>` sentinel, which
+ * an `includes('/')` check let through and left pinned in a retry loop (ATO-124).
+ */
+export declare function shouldApplyBundledBackend(versionBackendAfterRecovery: string | undefined | null): boolean;
+/**
+ * Backend ids behind the static "Latest <variant>" dropdown entries, unfiltered by hardware on
+ * purpose (a manual override). Windows offers the minor-less CUDA / ROCm family ids; Linux CPU and
+ * Vulkan; macOS only `macos-arm64`, and only when the bundled (or current) build is that arch — an
+ * Intel host gets no sentinel because `latest/macos-x64` resolves to nothing.
+ */
+export declare function staticLatestVariants(osType: string, macHostVersionBackend?: string | null): string[];
+/** `latest/<backend>` sentinels with their "Latest <label>" names. */
+export declare function latestBackendOptions(variants: readonly string[]): BackendOption[];
+/**
+ * Force-switch to the bundled build only when it is a *newer* release tag of the *same* type
+ * (app update bumped the engine). Comparing, not assuming: the bundled build is reported on every
+ * launch, so "the strings differ" would drag a runtime-updated user back to the installer's tag.
+ */
+export declare function isBundledNewerSameType(bundled: string | undefined | null, effective: string | undefined | null): boolean;
+/**
+ * The auto-upgrade candidate: `best` when it differs from `effective` and is of the same backend
+ * type, else `null`. The caller must still check the candidate is installed on disk before
+ * switching — pointing config at a build that is not downloaded yet is exactly the CUDA→CPU
+ * regression this guards against.
+ */
+export declare function sameTypeUpgradeCandidate(effective: string | undefined | null, best: string | undefined | null): string | null;
+/**
+ * Fresh install or a saved backend that is genuinely gone: empty / `none` / malformed, or absent
+ * from the catalog *and* not installed. Absent-but-installed is kept (the catalog comes partly from
+ * a remote fetch that can fail or truncate; resetting on that alone regressed CUDA→CPU on restart).
+ */
+export declare function savedBackendVanished(effective: string | undefined | null, versionBackends: readonly BackendVersion[], savedVbIsInstalled: boolean): boolean;

package/dist/backend/select/recovery.js

@@ -0,0 +1,108 @@
+/**
+ * The `configureBackends` startup recovery in `extensions/llamacpp-upstream-extension/src/index.ts`:
+ * persisted `version_backend` recovery and the bundled-build / same-type upgrade decisions,
+ * extracted from the settings/UI plumbing.
+ *
+ * Nothing here reads hardware, disk or network: the persisted values, the installed list, the
+ * probe result and the catalog are parameters.
+ */
+import { friendlyBackendLabel, WIN_ROCM_FAMILY_ID } from '../catalog/index.js';
+import { isConcreteVersionBackend, parseBuildNumber, stripBom } from '../version.js';
+import { determineBestBackend } from './categories.js';
+// ---------------------------------------------------------------------------------------------
+// configureBackends startup decisions (index.ts:1070-1660), extracted from the settings/UI plumbing
+// ---------------------------------------------------------------------------------------------
+/** Persisted `version_backend` is unusable: empty, `none`, or not `<version>/<backend>`. */
+export function isPersistedVersionBackendMissing(versionBackend) {
+    const vb = versionBackend || '';
+    return !vb || vb === 'none' || !vb.includes('/');
+}
+/**
+ * When the persisted `version_backend` was lost (wiped WebView storage, factory reset) but builds
+ * are still on disk, pick the best installed one so the user's GPU backend survives the restart
+ * instead of silently re-pinning the bundled CPU build. `null` when nothing usable is installed.
+ */
+export function recoverVersionBackendFromDisk(installed, gpus) {
+    if (installed.length === 0)
+        return null;
+    const recovered = determineBestBackend(installed, gpus);
+    return recovered.includes('/') ? recovered : null;
+}
+/**
+ * Apply the bundled build over the persisted value when that value is still not a concrete
+ * `<tag>/<backend>` after recovery — including the unresolved `latest/<backend>` sentinel, which
+ * an `includes('/')` check let through and left pinned in a retry loop (ATO-124).
+ */
+export function shouldApplyBundledBackend(versionBackendAfterRecovery) {
+    return !isConcreteVersionBackend(versionBackendAfterRecovery ?? '');
+}
+/**
+ * Backend ids behind the static "Latest <variant>" dropdown entries, unfiltered by hardware on
+ * purpose (a manual override). Windows offers the minor-less CUDA / ROCm family ids; Linux CPU and
+ * Vulkan; macOS only `macos-arm64`, and only when the bundled (or current) build is that arch — an
+ * Intel host gets no sentinel because `latest/macos-x64` resolves to nothing.
+ */
+export function staticLatestVariants(osType, macHostVersionBackend) {
+    if (osType === 'windows')
+        return ['win-cpu-x64', 'win-cuda-12-x64', 'win-cuda-13-x64', WIN_ROCM_FAMILY_ID, 'win-vulkan-x64'];
+    if (osType === 'linux')
+        return ['linux-cpu-x64', 'linux-vulkan-x64'];
+    if (osType === 'macos') {
+        const variant = stripBom(macHostVersionBackend ?? '')
+            .split('/')[1]
+            ?.trim();
+        return variant === 'macos-arm64' ? [variant] : [];
+    }
+    return [];
+}
+/** `latest/<backend>` sentinels with their "Latest <label>" names. */
+export function latestBackendOptions(variants) {
+    return variants.map((backend) => ({
+        value: `latest/${backend}`,
+        name: `Latest ${friendlyBackendLabel(backend)}`,
+    }));
+}
+/**
+ * Force-switch to the bundled build only when it is a *newer* release tag of the *same* type
+ * (app update bumped the engine). Comparing, not assuming: the bundled build is reported on every
+ * launch, so "the strings differ" would drag a runtime-updated user back to the installer's tag.
+ */
+export function isBundledNewerSameType(bundled, effective) {
+    if (!bundled || !effective || !effective.includes('/'))
+        return false;
+    const [bundledVersion, bundledType] = bundled.split('/');
+    const [currentVersion, currentType] = effective.split('/');
+    const bundledBuild = parseBuildNumber(stripBom(bundledVersion ?? ''));
+    const currentBuild = parseBuildNumber(stripBom(currentVersion ?? ''));
+    return (effective !== bundled &&
+        bundledType === currentType &&
+        bundledBuild !== null &&
+        currentBuild !== null &&
+        bundledBuild > currentBuild);
+}
+/**
+ * The auto-upgrade candidate: `best` when it differs from `effective` and is of the same backend
+ * type, else `null`. The caller must still check the candidate is installed on disk before
+ * switching — pointing config at a build that is not downloaded yet is exactly the CUDA→CPU
+ * regression this guards against.
+ */
+export function sameTypeUpgradeCandidate(effective, best) {
+    if (!effective || !best || effective === best || !effective.includes('/'))
+        return null;
+    const currentType = effective.split('/')[1]?.trim();
+    const bestType = best.split('/')[1]?.trim();
+    if (!currentType || !bestType || currentType !== bestType)
+        return null;
+    return best;
+}
+/**
+ * Fresh install or a saved backend that is genuinely gone: empty / `none` / malformed, or absent
+ * from the catalog *and* not installed. Absent-but-installed is kept (the catalog comes partly from
+ * a remote fetch that can fail or truncate; resetting on that alone regressed CUDA→CPU on restart).
+ */
+export function savedBackendVanished(effective, versionBackends, savedVbIsInstalled) {
+    const vb = effective || '';
+    const savedNotInList = !!vb && vb.includes('/') && !versionBackends.some((e) => `${e.version}/${e.backend}` === vb);
+    return !vb || vb === 'none' || !vb.includes('/') || (savedNotInList && !savedVbIsInstalled);
+}
+//# sourceMappingURL=recovery.js.map

package/dist/backend/select/recovery.js.map

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

package/dist/backend/select/tiers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * GPU tier probing and ideal-backend detection. Port of the decision halves of
+ * `detectIdealBackendType`, `tierEnumeratesDevices` and `hasCorroboratingGpu` in
+ * `extensions/llamacpp-upstream-extension/src/index.ts`.
+ *
+ * Nothing here reads hardware, disk or network: the probe result (`GpuProbeInfo[]`, cpu extensions)
+ * and the catalog are parameters; `--list-devices` is an injected function.
+ */
+import type { DeviceInfo } from '../../contracts/index.js';
+import type { ArchSuffix, BackendFeatures, BackendVersion, GpuProbeInfo, IdealBackendResult, TierHealth, TierProbeDeps } from '../types.js';
+export declare function hasDiscreteGpu(gpus: readonly GpuProbeInfo[]): boolean;
+/**
+ * Integrated-only hosts (Intel UHD / AMD Vega iGPU on shared RAM) report plenty of "VRAM" yet run
+ * Vulkan far slower than the CPU build, so Vulkan is never the *optimal* pick for them.
+ */
+export declare function integratedGpuOnly(gpus: readonly GpuProbeInfo[]): boolean;
+/**
+ * Whether the hardware probe corroborates that `backendType` could use a GPU here: CUDA needs an
+ * NVIDIA GPU, Vulkan any GPU, anything else (CPU) is trivially corroborated so the picker can fall
+ * through. Vendor strings as `tauri-plugin-hardware/src/types.rs` serialises them.
+ */
+export declare function hasCorroboratingGpu(backendType: string, gpus: readonly GpuProbeInfo[]): boolean;
+/**
+ * The decision inside `tierEnumeratesDevices`: not installed → `unverified` (nothing to probe);
+ * devices listed → `works`; nothing listed but the probe corroborates a matching GPU → `unverified`
+ * (`--list-devices` is known to come back empty on hosts whose inference path uses CUDA fine, ADR
+ * 2026-05-26); nothing listed and no corroboration → `broken`, degrade to the next tier.
+ */
+export declare function classifyTierProbe(input: {
+    installed: boolean;
+    devices: readonly DeviceInfo[] | null;
+    corroborated: boolean;
+}): TierHealth;
+/**
+ * Non-destructive runtime probe of one GPU tier: find the installed build of that type, run
+ * `--list-devices` through `deps.listDevices`, and classify. A throwing `listInstalled` is
+ * `unverified`; a throwing probe counts as "no devices". `onLog` receives the app's log lines.
+ */
+export declare function tierEnumeratesDevices(backendType: string, gpus: readonly GpuProbeInfo[], deps: TierProbeDeps, onLog?: (message: string) => void): Promise<TierHealth>;
+/** First tier (top-down) whose probe is not `broken`, or `null`. */
+export declare function pickFirstWorkingTier(tiers: readonly string[], probe: (tier: string) => Promise<TierHealth>): Promise<string | null>;
+/**
+ * App regex for "any GPU backend in the catalog", kept verbatim. Note the `-` required right after
+ * the first digit: `win-cuda-13.3-x64` and `win-rocm-10.0-x64` do NOT match, only Vulkan ids do.
+ * It still works because ggml-org always publishes a Vulkan Windows asset next to CUDA.
+ */
+export declare function isGpuBackendId(backend: string): boolean;
+/**
+ * Windows GPU tiers in preference order: CUDA 13, CUDA 12, ROCm (VRAM-gated; `features.rocm` is
+ * already PCI-gated), Vulkan (VRAM-gated, never on integrated-only hosts). Each tier is the first
+ * catalog entry matching its pattern — the catalog is sorted newest first, so that is the newest tag.
+ */
+export declare function windowsGpuTiers(features: BackendFeatures, available: readonly BackendVersion[], archSuffix: ArchSuffix, gpus: readonly GpuProbeInfo[]): string[];
+export interface DetectIdealBackendInput {
+    osType: string;
+    arch: string;
+    cpuExtensions: readonly string[];
+    gpus: readonly GpuProbeInfo[];
+    /** Windows only: the hardware-gated catalog (`listSupportedBackends` + `filterBackendsBySupport`). */
+    listAvailableBackends: () => Promise<BackendVersion[]>;
+    /** Windows only: `tierEnumeratesDevices` bound to this host. */
+    probeTier: (tier: string) => Promise<TierHealth>;
+    onWarn?: (message: string) => void;
+}
+/**
+ * Which backend this host should ideally run. Windows: the first GPU tier that survives the probe;
+ * a GPU-capable host with no GPU backend in the catalog is `detection-failed` (the manifest was
+ * unreachable — ggml-org always publishes CUDA + Vulkan Windows assets), otherwise `cpu-optimal`.
+ * Linux x64: Vulkan when the loader enumerates a device with ≥ 2 GiB; a GPU the loader cannot see
+ * is `detection-failed` (ask again next launch, ATO-464); no accelerator is `cpu-optimal`. macOS and
+ * everything else: `cpu-optimal`. Any thrown error is `detection-failed`.
+ *
+ * The caller wraps this in its 20 s `withTimeout` (timeout → `detection-failed`) and, on Windows,
+ * supplies `listAvailableBackends` / `probeTier`.
+ */
+export declare function detectIdealBackendType(input: DetectIdealBackendInput): Promise<IdealBackendResult>;