@atomic-chat/core 0.5.1

package/dist/backend/catalog/manifest.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The backend index: `atomic-chat-conf/backends/manifest.json`. Port of the manifest half of
+ * `extensions/llamacpp-upstream-extension/src/backend.ts` (`parseManifestForPlatform`,
+ * `fetchManifestWithFallbacks`, `fetchLiveManifest`, `fetchRemoteBackends`).
+ *
+ * Why a static manifest and not the GitHub API: the unauthenticated API limit (60 req/hr/IP)
+ * dead-ended fresh installs on shared/NAT/VPN networks (ATO-199). raw.githubusercontent.com has no
+ * per-IP limit and the manifest mirrors the release shape, so the parser is unchanged. Archives come
+ * from the manifest's `download_base` (our signed mirror) or, for an unmirrored tag, the ggml-org CDN.
+ *
+ * Seams replaced by injection:
+ *   - the app's four transports (Rust HTTP/1.1 reqwest, WebView `globalThis.fetch`, proxy-aware and
+ *     direct `@tauri-apps/plugin-http`) become a `ManifestTransport[]`; the core passes one built
+ *     from its own `fetch` via `manifestTransportFromFetch`. Order is preserved as documentation —
+ *     the app raced all four with `Promise.any`, and so does `fetchManifestWithFallbacks`.
+ *   - the module-level `_cachedManifest` becomes a `ManifestSessionCache` the caller owns.
+ *   - `getSystemInfo()` becomes `osType` / `arch` parameters.
+ *   - `console.*` becomes optional `onInfo` / `onWarn` callbacks.
+ */
+import type { ArchSuffix, BackendOsType, BackendVersion, UpstreamManifest } from '../types.js';
+export declare const LLAMACPP_BACKEND_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/manifest.json";
+export declare const MANIFEST_FETCH_TIMEOUT_MS = 8000;
+/**
+ * Tag of the bundled offline baseline. NOT a pin: a live manifest carrying a newer tag is followed
+ * as-is, which is what lets an engine update reach users without an app release.
+ */
+export declare const BUNDLED_BASELINE_TAG: string;
+/** One way of fetching the manifest; `timeoutMs` is the hard budget the transport should honour. */
+export type ManifestFetch = (url: string, timeoutMs: number) => Promise<Response>;
+export interface ManifestTransport {
+    label: string;
+    fetch: ManifestFetch;
+}
+/** `x86_64` / `x64` → `x64`; `aarch64` / `arm64` → `arm64`. */
+export declare function archSuffixFor(arch: string): ArchSuffix;
+export declare function isSupportedBackendOs(osType: string): osType is BackendOsType;
+/**
+ * Backends a manifest offers this OS + arch. Windows: the whitelisted `win-*` zips matching the arch.
+ * Linux: x64 only, `ubuntu-*` tarballs translated to `linux-*` ids. macOS: only `macos-<arch>`, so an
+ * Intel host is never offered the arm64 build the manifest lists (macOS is passed through
+ * `listSupportedBackends` unfiltered, so the arch filter has to happen here). Every entry has
+ * `order: 0` — a manifest entry never outranks an installed one by install time.
+ */
+export declare function parseManifestForPlatform(release: UpstreamManifest, osType: string, archSuffix: ArchSuffix): BackendVersion[];
+/**
+ * Hard `Promise` timeout around a transport. The app needed this because some `plugin-http` paths
+ * ignored `AbortSignal`, letting the outer 20 s detection guard fire first; a core transport built on
+ * `fetch` may honour the signal but the belt-and-braces guard costs nothing.
+ */
+export declare function withHardTimeout<T>(promise: Promise<T>, timeoutMs: number, message: string): Promise<T>;
+/** A transport over a `fetch`-compatible function with an abort-on-timeout and the app's headers. */
+export declare function manifestTransportFromFetch(label: string, fetchImpl: typeof fetch, headers?: Record<string, string>): ManifestTransport;
+/**
+ * Race every transport (`Promise.any`) and return the first response, labelled. All failing raises
+ * `IO_ERROR` whose message carries each transport's reason, labelled, so a log line explains which
+ * path stalled (ATO-243: the Linux h2 stall against Fastly).
+ */
+export declare function fetchManifestWithFallbacks(transports: readonly ManifestTransport[], url?: string, timeoutMs?: number): Promise<{
+    label: string;
+    response: Response;
+}>;
+/**
+ * In-memory manifest for one session. Populated ONLY by a genuinely successful live fetch, so a
+ * later transient stall can reuse the last good manifest. The bundled baseline is never stored:
+ * caching it would pin the session to a stale snapshot even after the network recovers (the
+ * ATO-243 cache-poisoning regression).
+ */
+export declare class ManifestSessionCache {
+    private manifest;
+    get(): UpstreamManifest | null;
+    set(manifest: UpstreamManifest): void;
+    clear(): void;
+}
+export interface FetchLiveManifestOptions {
+    transports: readonly ManifestTransport[];
+    cache: ManifestSessionCache;
+    url?: string;
+    timeoutMs?: number;
+    onInfo?: (message: string) => void;
+    onWarn?: (message: string) => void;
+}
+/**
+ * Fetch the live manifest and cache it for the session, or `null` when it could not be obtained
+ * (transport failure, non-2xx, unparseable body, missing `tag_name`). Callers fall back to
+ * `BUNDLED_MANIFEST_BASELINE` themselves, keeping the "baseline is never cached" invariant visible.
+ * A tag differing from the bundled baseline is followed: the manifest is authoritative.
+ */
+export declare function fetchLiveManifest(options: FetchLiveManifestOptions): Promise<UpstreamManifest | null>;
+export interface FetchRemoteBackendsOptions extends FetchLiveManifestOptions {
+    osType: string;
+    arch: string;
+    /** "Check for engine updates": drop the session cache so a tag published meanwhile is seen. */
+    force?: boolean;
+    /** Offline fallback; defaults to the compiled-in baseline. */
+    baseline?: UpstreamManifest;
+}
+/**
+ * Backend builds available to this host: the session-cached manifest, else a live fetch, else the
+ * bundled baseline. Never throws and never returns the baseline through the cache. `[]` for an OS
+ * outside windows/linux/macos, for Linux on arm64 and for an Intel Mac.
+ */
+export declare function fetchRemoteBackends(options: FetchRemoteBackendsOptions): Promise<BackendVersion[]>;

package/dist/backend/catalog/manifest.js

@@ -0,0 +1,233 @@
+/**
+ * The backend index: `atomic-chat-conf/backends/manifest.json`. Port of the manifest half of
+ * `extensions/llamacpp-upstream-extension/src/backend.ts` (`parseManifestForPlatform`,
+ * `fetchManifestWithFallbacks`, `fetchLiveManifest`, `fetchRemoteBackends`).
+ *
+ * Why a static manifest and not the GitHub API: the unauthenticated API limit (60 req/hr/IP)
+ * dead-ended fresh installs on shared/NAT/VPN networks (ATO-199). raw.githubusercontent.com has no
+ * per-IP limit and the manifest mirrors the release shape, so the parser is unchanged. Archives come
+ * from the manifest's `download_base` (our signed mirror) or, for an unmirrored tag, the ggml-org CDN.
+ *
+ * Seams replaced by injection:
+ *   - the app's four transports (Rust HTTP/1.1 reqwest, WebView `globalThis.fetch`, proxy-aware and
+ *     direct `@tauri-apps/plugin-http`) become a `ManifestTransport[]`; the core passes one built
+ *     from its own `fetch` via `manifestTransportFromFetch`. Order is preserved as documentation —
+ *     the app raced all four with `Promise.any`, and so does `fetchManifestWithFallbacks`.
+ *   - the module-level `_cachedManifest` becomes a `ManifestSessionCache` the caller owns.
+ *   - `getSystemInfo()` becomes `osType` / `arch` parameters.
+ *   - `console.*` becomes optional `onInfo` / `onWarn` callbacks.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { LINUX_BACKEND_BY_UPSTREAM_ASSET } from './archive.js';
+import { BUNDLED_MANIFEST_BASELINE } from './bundled-manifest-baseline.js';
+export const LLAMACPP_BACKEND_MANIFEST_URL = 'https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/manifest.json';
+export const MANIFEST_FETCH_TIMEOUT_MS = 8_000;
+/**
+ * Tag of the bundled offline baseline. NOT a pin: a live manifest carrying a newer tag is followed
+ * as-is, which is what lets an engine update reach users without an app release.
+ */
+export const BUNDLED_BASELINE_TAG = BUNDLED_MANIFEST_BASELINE.tag_name;
+/** `x86_64` / `x64` → `x64`; `aarch64` / `arm64` → `arm64`. */
+export function archSuffixFor(arch) {
+    return arch.includes('aarch64') || arch.includes('arm64') ? 'arm64' : 'x64';
+}
+export function isSupportedBackendOs(osType) {
+    return osType === 'windows' || osType === 'linux' || osType === 'macos';
+}
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Backends a manifest offers this OS + arch. Windows: the whitelisted `win-*` zips matching the arch.
+ * Linux: x64 only, `ubuntu-*` tarballs translated to `linux-*` ids. macOS: only `macos-<arch>`, so an
+ * Intel host is never offered the arm64 build the manifest lists (macOS is passed through
+ * `listSupportedBackends` unfiltered, so the arch filter has to happen here). Every entry has
+ * `order: 0` — a manifest entry never outranks an installed one by install time.
+ */
+export function parseManifestForPlatform(release, osType, archSuffix) {
+    const tag = release.tag_name;
+    if (!tag)
+        return [];
+    const assets = release.assets ?? [];
+    const escapedTag = escapeRegExp(tag);
+    const backends = [];
+    if (osType === 'windows') {
+        const re = new RegExp(`^llama-${escapedTag}-bin-(win-.+)\\.zip$`);
+        const isAllowed = (name) => name === 'win-cpu-x64' ||
+            /^win-cuda-12\.\d+-x64$/.test(name) ||
+            /^win-cuda-13\.\d+-x64$/.test(name) ||
+            /^win-rocm-\d+\.\d+-x64$/.test(name) ||
+            name === 'win-vulkan-x64';
+        for (const asset of assets) {
+            const backendName = re.exec(asset.name)?.[1];
+            if (!backendName || !isAllowed(backendName))
+                continue;
+            if (!backendName.endsWith(`-${archSuffix}`))
+                continue;
+            backends.push({ version: tag, backend: backendName, order: 0 });
+        }
+        return backends;
+    }
+    if (osType === 'linux') {
+        if (archSuffix !== 'x64')
+            return [];
+        const re = new RegExp(`^llama-${escapedTag}-bin-(ubuntu-.+)\\.tar\\.gz$`);
+        for (const asset of assets) {
+            const infix = re.exec(asset.name)?.[1];
+            const backendName = infix ? LINUX_BACKEND_BY_UPSTREAM_ASSET[infix] : undefined;
+            if (!backendName)
+                continue;
+            backends.push({ version: tag, backend: backendName, order: 0 });
+        }
+        return backends;
+    }
+    if (osType === 'macos') {
+        const re = new RegExp(`^llama-${escapedTag}-bin-(macos-.+)\\.tar\\.gz$`);
+        for (const asset of assets) {
+            const backendName = re.exec(asset.name)?.[1];
+            if (backendName !== `macos-${archSuffix}`)
+                continue;
+            backends.push({ version: tag, backend: backendName, order: 0 });
+        }
+        return backends;
+    }
+    return [];
+}
+/**
+ * Hard `Promise` timeout around a transport. The app needed this because some `plugin-http` paths
+ * ignored `AbortSignal`, letting the outer 20 s detection guard fire first; a core transport built on
+ * `fetch` may honour the signal but the belt-and-braces guard costs nothing.
+ */
+export function withHardTimeout(promise, timeoutMs, message) {
+    let handle;
+    const timeout = new Promise((_, reject) => {
+        handle = setTimeout(() => reject(new Error(message)), timeoutMs);
+    });
+    return Promise.race([promise, timeout]).finally(() => {
+        if (handle !== undefined)
+            clearTimeout(handle);
+    });
+}
+/** A transport over a `fetch`-compatible function with an abort-on-timeout and the app's headers. */
+export function manifestTransportFromFetch(label, fetchImpl, headers = { 'Accept': 'application/json', 'User-Agent': 'atomic-chat' }) {
+    return {
+        label,
+        fetch: (url, timeoutMs) => {
+            const controller = new AbortController();
+            const request = fetchImpl(url, { headers, signal: controller.signal });
+            return withHardTimeout(request, timeoutMs, `${label} timed out after ${timeoutMs}ms`).catch((err) => {
+                controller.abort();
+                throw err;
+            });
+        },
+    };
+}
+/**
+ * Race every transport (`Promise.any`) and return the first response, labelled. All failing raises
+ * `IO_ERROR` whose message carries each transport's reason, labelled, so a log line explains which
+ * path stalled (ATO-243: the Linux h2 stall against Fastly).
+ */
+export async function fetchManifestWithFallbacks(transports, url = LLAMACPP_BACKEND_MANIFEST_URL, timeoutMs = MANIFEST_FETCH_TIMEOUT_MS) {
+    if (transports.length === 0) {
+        throw new AtomicCoreError('IO_ERROR', 'All manifest fetch attempts failed: no transports configured');
+    }
+    const wrapped = transports.map(({ label, fetch }) => Promise.resolve()
+        .then(() => fetch(url, timeoutMs))
+        .then((response) => ({ label, response }))
+        .catch((err) => {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`${label}: ${reason}`);
+    }));
+    try {
+        return await Promise.any(wrapped);
+    }
+    catch (aggregate) {
+        const reasons = aggregate instanceof AggregateError
+            ? aggregate.errors.map((e) => (e instanceof Error ? e.message : String(e))).join(' | ')
+            : aggregate instanceof Error
+                ? aggregate.message
+                : String(aggregate);
+        throw new AtomicCoreError('IO_ERROR', `All manifest fetch attempts failed: ${reasons}`);
+    }
+}
+/**
+ * In-memory manifest for one session. Populated ONLY by a genuinely successful live fetch, so a
+ * later transient stall can reuse the last good manifest. The bundled baseline is never stored:
+ * caching it would pin the session to a stale snapshot even after the network recovers (the
+ * ATO-243 cache-poisoning regression).
+ */
+export class ManifestSessionCache {
+    manifest = null;
+    get() {
+        return this.manifest;
+    }
+    set(manifest) {
+        this.manifest = manifest;
+    }
+    clear() {
+        this.manifest = null;
+    }
+}
+/**
+ * Fetch the live manifest and cache it for the session, or `null` when it could not be obtained
+ * (transport failure, non-2xx, unparseable body, missing `tag_name`). Callers fall back to
+ * `BUNDLED_MANIFEST_BASELINE` themselves, keeping the "baseline is never cached" invariant visible.
+ * A tag differing from the bundled baseline is followed: the manifest is authoritative.
+ */
+export async function fetchLiveManifest(options) {
+    const url = options.url ?? LLAMACPP_BACKEND_MANIFEST_URL;
+    const info = options.onInfo ?? (() => { });
+    const warn = options.onWarn ?? (() => { });
+    try {
+        info(`[fetchRemoteBackends] Fetching ${url}...`);
+        const { label, response } = await fetchManifestWithFallbacks(options.transports, url, options.timeoutMs);
+        info(`[fetchRemoteBackends] Manifest fetch succeeded via ${label}`);
+        if (!response.ok) {
+            warn(`[fetchRemoteBackends] Backend manifest returned ${response.status}; using bundled baseline (not cached, will retry next call)`);
+            return null;
+        }
+        const release = (await response.json());
+        if (!release || typeof release.tag_name !== 'string' || !release.tag_name) {
+            warn('[fetchRemoteBackends] Manifest missing tag_name; using bundled baseline (not cached, will retry next call)');
+            return null;
+        }
+        if (release.tag_name !== BUNDLED_BASELINE_TAG) {
+            info(`[fetchRemoteBackends] Manifest tag ${release.tag_name} differs from the bundled baseline ${BUNDLED_BASELINE_TAG}; following the manifest`);
+        }
+        options.cache.set(release);
+        return release;
+    }
+    catch (err) {
+        warn(`[fetchRemoteBackends] All manifest fetch transports failed; falling back to bundled baseline (not cached, will retry next call). ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/**
+ * Backend builds available to this host: the session-cached manifest, else a live fetch, else the
+ * bundled baseline. Never throws and never returns the baseline through the cache. `[]` for an OS
+ * outside windows/linux/macos, for Linux on arm64 and for an Intel Mac.
+ */
+export async function fetchRemoteBackends(options) {
+    const { osType, arch, cache } = options;
+    if (!isSupportedBackendOs(osType))
+        return [];
+    const archSuffix = archSuffixFor(arch);
+    const info = options.onInfo ?? (() => { });
+    if (options.force) {
+        cache.clear();
+    }
+    else {
+        const cached = cache.get();
+        if (cached) {
+            info('[fetchRemoteBackends] Using in-memory manifest cache');
+            return parseManifestForPlatform(cached, osType, archSuffix);
+        }
+    }
+    const live = await fetchLiveManifest(options);
+    if (!live)
+        return parseManifestForPlatform(options.baseline ?? BUNDLED_MANIFEST_BASELINE, osType, archSuffix);
+    const backends = parseManifestForPlatform(live, osType, archSuffix);
+    info(`[fetchRemoteBackends] Found ${backends.length} remote backends for ${osType}-${archSuffix}: ${backends
+        .map((b) => b.backend)
+        .join(', ')}`);
+    return backends;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/backend/catalog/manifest.js.map

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

package/dist/backend/catalog/migrate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Backend-id migration and the `version_backend` setting update. Port of `map_old_backend_to_new`,
+ * `should_migrate_backend` and `handle_setting_update` in
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/backend.rs`.
+ *
+ * Two naming generations exist in persisted settings: legacy janhq-mirror ids
+ * (`win-cuda-12-common_cpus-x64`, `win-noavx-cuda-cu11.7-x64`, `linux-avx2-x64`, …) and the
+ * ggml-org native ids the upstream provider uses now (`win-cuda-12.4-x64`, `linux-vulkan-x64`,
+ * `macos-arm64`). `mapOldBackendToNew` folds the former onto the closest of the latter so an old
+ * setting still resolves to something downloadable.
+ */
+import type { BackendVersion, SettingUpdateResult } from '../types.js';
+/**
+ * Closest current id for a legacy backend id; current ids round-trip unchanged.
+ *
+ *   - `ubuntu-*` (a tarball installed by file name, ATO-233) → `linux-{cpu,vulkan}-<arch>`.
+ *   - Windows: `win-cpu-x64`, the family ids `win-cuda-13-x64` / `win-rocm-*`, concrete
+ *     `cuda-12.4` / `cuda-13.3` and `win-vulkan-x64` pass through; legacy CUDA 13 / `cu13` →
+ *     `win-cuda-13.3`, CUDA 12 / `cu12` → `win-cuda-12.4`, CUDA 11 / `cu11` → `win-cuda-12.4`
+ *     (ggml-org dropped CUDA 11; the driver gate refuses it on too-old hosts), vulkan →
+ *     `win-vulkan`, AVX tiers / `common_cpus` → `win-cpu`.
+ *   - Linux (2026-05-28 ADR "Linux ships only `llamacpp-upstream`"): `linux-cpu-x64` and
+ *     `linux-vulkan-x64` pass through; on x64 anything with `vulkan` → `linux-vulkan-x64`, everything
+ *     else (CUDA tiers included — upstream publishes no `ubuntu-cuda-*`) → `linux-cpu-x64`; arm64 →
+ *     the phase-2 placeholder `linux-cpu-arm64`.
+ *   - Any other OS: legacy AVX tiers → `<os>common_cpus-<arch>`, else unchanged.
+ */
+export declare function mapOldBackendToNew(oldBackend: string): string;
+/**
+ * The id a stored backend-type preference should migrate to, or `null` when it is already current
+ * or the mapped type is not available in `versionBackends` (then the preference is left alone).
+ */
+export declare function shouldMigrateBackend(storedBackendType: string, versionBackends: BackendVersion[]): string | null;
+/**
+ * Interpret a settings write. Only `version_backend` matters: its value is BOM-stripped, split into
+ * `<version>/<backend>` (`INVALID_ARGUMENT` otherwise), the backend id normalised, and
+ * `backend_type_updated` says whether the effective type differs from `currentStoredBackend`
+ * (`null` stored → updated). A `version_backend` write always needs an installation check.
+ */
+export declare function handleSettingUpdate(key: string, value: string, currentStoredBackend: string | null): SettingUpdateResult;

package/dist/backend/catalog/migrate.js

@@ -0,0 +1,135 @@
+/**
+ * Backend-id migration and the `version_backend` setting update. Port of `map_old_backend_to_new`,
+ * `should_migrate_backend` and `handle_setting_update` in
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/backend.rs`.
+ *
+ * Two naming generations exist in persisted settings: legacy janhq-mirror ids
+ * (`win-cuda-12-common_cpus-x64`, `win-noavx-cuda-cu11.7-x64`, `linux-avx2-x64`, …) and the
+ * ggml-org native ids the upstream provider uses now (`win-cuda-12.4-x64`, `linux-vulkan-x64`,
+ * `macos-arm64`). `mapOldBackendToNew` folds the former onto the closest of the latter so an old
+ * setting still resolves to something downloadable.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+/**
+ * Closest current id for a legacy backend id; current ids round-trip unchanged.
+ *
+ *   - `ubuntu-*` (a tarball installed by file name, ATO-233) → `linux-{cpu,vulkan}-<arch>`.
+ *   - Windows: `win-cpu-x64`, the family ids `win-cuda-13-x64` / `win-rocm-*`, concrete
+ *     `cuda-12.4` / `cuda-13.3` and `win-vulkan-x64` pass through; legacy CUDA 13 / `cu13` →
+ *     `win-cuda-13.3`, CUDA 12 / `cu12` → `win-cuda-12.4`, CUDA 11 / `cu11` → `win-cuda-12.4`
+ *     (ggml-org dropped CUDA 11; the driver gate refuses it on too-old hosts), vulkan →
+ *     `win-vulkan`, AVX tiers / `common_cpus` → `win-cpu`.
+ *   - Linux (2026-05-28 ADR "Linux ships only `llamacpp-upstream`"): `linux-cpu-x64` and
+ *     `linux-vulkan-x64` pass through; on x64 anything with `vulkan` → `linux-vulkan-x64`, everything
+ *     else (CUDA tiers included — upstream publishes no `ubuntu-cuda-*`) → `linux-cpu-x64`; arm64 →
+ *     the phase-2 placeholder `linux-cpu-arm64`.
+ *   - Any other OS: legacy AVX tiers → `<os>common_cpus-<arch>`, else unchanged.
+ */
+export function mapOldBackendToNew(oldBackend) {
+    if (oldBackend.startsWith('ubuntu-')) {
+        const archSuffix = oldBackend.includes('-arm64') ? 'arm64' : 'x64';
+        if (oldBackend.includes('vulkan'))
+            return `linux-vulkan-${archSuffix}`;
+        return `linux-cpu-${archSuffix}`;
+    }
+    const isWindows = oldBackend.startsWith('win-');
+    const isLinux = oldBackend.startsWith('linux-');
+    const osPrefix = isWindows ? 'win-' : isLinux ? 'linux-' : '';
+    const archSuffix = oldBackend.includes('-arm64') ? 'arm64' : 'x64';
+    const isX64 = archSuffix === 'x64';
+    const arch = archSuffix;
+    if (isWindows &&
+        (oldBackend === 'win-cpu-x64' ||
+            oldBackend === 'win-cuda-13-x64' ||
+            oldBackend.includes('cuda-12.4') ||
+            oldBackend.includes('cuda-13.3') ||
+            oldBackend.includes('rocm') ||
+            oldBackend === 'win-vulkan-x64')) {
+        return oldBackend;
+    }
+    if (isWindows && (oldBackend.includes('cuda-13') || oldBackend.includes('cu13'))) {
+        return `win-cuda-13.3-${arch}`;
+    }
+    if (isWindows && (oldBackend.includes('cuda-12') || oldBackend.includes('cu12'))) {
+        return `win-cuda-12.4-${arch}`;
+    }
+    if (isWindows && (oldBackend.includes('cuda-11') || oldBackend.includes('cu11'))) {
+        return `win-cuda-12.4-${arch}`;
+    }
+    if (isWindows && oldBackend.includes('vulkan')) {
+        return `win-vulkan-${arch}`;
+    }
+    if (isWindows &&
+        (oldBackend.includes('common_cpus') ||
+            oldBackend.includes('avx512') ||
+            oldBackend.includes('avx2') ||
+            oldBackend.includes('avx-x64') ||
+            oldBackend.includes('noavx-x64'))) {
+        return `win-cpu-${arch}`;
+    }
+    if (isLinux) {
+        if (oldBackend === 'linux-cpu-x64' || oldBackend === 'linux-vulkan-x64')
+            return oldBackend;
+        if (isX64) {
+            if (oldBackend.includes('vulkan'))
+                return 'linux-vulkan-x64';
+            return 'linux-cpu-x64';
+        }
+        return 'linux-cpu-arm64';
+    }
+    const isOldCpuBackend = oldBackend.includes('avx512') ||
+        oldBackend.includes('avx2') ||
+        oldBackend.includes('avx-x64') ||
+        oldBackend.includes('noavx-x64');
+    if (isOldCpuBackend)
+        return `${osPrefix}common_cpus-${arch}`;
+    return oldBackend;
+}
+/**
+ * The id a stored backend-type preference should migrate to, or `null` when it is already current
+ * or the mapped type is not available in `versionBackends` (then the preference is left alone).
+ */
+export function shouldMigrateBackend(storedBackendType, versionBackends) {
+    const mapped = mapOldBackendToNew(storedBackendType);
+    if (mapped === storedBackendType)
+        return null;
+    const available = versionBackends.some((vb) => mapOldBackendToNew(vb.backend) === mapped);
+    return available ? mapped : null;
+}
+/**
+ * Interpret a settings write. Only `version_backend` matters: its value is BOM-stripped, split into
+ * `<version>/<backend>` (`INVALID_ARGUMENT` otherwise), the backend id normalised, and
+ * `backend_type_updated` says whether the effective type differs from `currentStoredBackend`
+ * (`null` stored → updated). A `version_backend` write always needs an installation check.
+ */
+export function handleSettingUpdate(key, value, currentStoredBackend) {
+    if (key !== 'version_backend') {
+        return {
+            backend_type_updated: false,
+            effective_backend_type: null,
+            needs_backend_installation: false,
+            version: null,
+            backend: null,
+        };
+    }
+    const cleanValue = value.replace(/\uFEFF/g, '');
+    const parts = cleanValue.split('/');
+    if (parts.length !== 2) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', `Invalid backend format: ${cleanValue}`);
+    }
+    const version = (parts[0] ?? '').trim();
+    const backend = (parts[1] ?? '').trim();
+    if (!version || !backend) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', `Invalid backend format: ${value}`);
+    }
+    const effectiveBackendType = mapOldBackendToNew(backend);
+    const backendTypeUpdated = currentStoredBackend === null ? true : currentStoredBackend !== effectiveBackendType;
+    return {
+        backend_type_updated: backendTypeUpdated,
+        effective_backend_type: effectiveBackendType,
+        needs_backend_installation: true,
+        version,
+        backend,
+    };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/backend/catalog/migrate.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Backend packs: manifest + URL resolution, hardware tier selection, id migration, installed-pack
+ * helpers and the optimal-backend cache. Pure policy only — downloads, extraction, directory scans
+ * and `--list-devices` spawning are phase 1 and live in `downloads/` and `runtime/`.
+ *
+ * Ported from: extensions/llamacpp-upstream-extension/src/backend.ts, bundledManifestBaseline.ts,
+ * index.ts (optimal cache, configureBackends decisions, tier probing), scripts/resolve-upstream-backend.mjs,
+ * tauri-plugin-llamacpp-upstream/src/{backend,amd_rocm_pci_ids}.rs.
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './types.js';
+export * from './version.js';
+export * from './catalog/index.js';
+export * from './select/index.js';
+export * from './optimal/index.js';
+export * from './installed/index.js';
+export * from './turboquant.js';
+export * from './install/index.js';

package/dist/backend/index.js

@@ -0,0 +1,19 @@
+/**
+ * Backend packs: manifest + URL resolution, hardware tier selection, id migration, installed-pack
+ * helpers and the optimal-backend cache. Pure policy only — downloads, extraction, directory scans
+ * and `--list-devices` spawning are phase 1 and live in `downloads/` and `runtime/`.
+ *
+ * Ported from: extensions/llamacpp-upstream-extension/src/backend.ts, bundledManifestBaseline.ts,
+ * index.ts (optimal cache, configureBackends decisions, tier probing), scripts/resolve-upstream-backend.mjs,
+ * tauri-plugin-llamacpp-upstream/src/{backend,amd_rocm_pci_ids}.rs.
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './types.js';
+export * from './version.js';
+export * from './catalog/index.js';
+export * from './select/index.js';
+export * from './optimal/index.js';
+export * from './installed/index.js';
+export * from './turboquant.js';
+export * from './install/index.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}

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

@@ -0,0 +1,3 @@
+/** Installing and updating backends, and resolving the installed backend a runtime runs on. */
+export * from './runtime-backend.js';
+export * from './service.js';

package/dist/backend/install/index.js

@@ -0,0 +1,4 @@
+/** Installing and updating backends, and resolving the installed backend a runtime runs on. */
+export * from './runtime-backend.js';
+export * from './service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/install/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}

package/dist/backend/install/runtime-backend.d.ts

@@ -0,0 +1,22 @@
+import type { LocalProviderId } from '../../contracts/index.js';
+import type { DataLayout } from '../../config/index.js';
+import type { RuntimeSettings } from '../../runtime/llamacpp/index.js';
+import type { SettingsStore } from '../../settings/index.js';
+import type { HardwareOverrideStore } from '../../hardware/index.js';
+import type { RocmHostProbe } from '../turboquant.js';
+/** Provider settings plus the engine-level keys the load plan reads. */
+export declare function readRuntimeSettings(settings: SettingsStore, provider: LocalProviderId, layout: DataLayout, hardware: HardwareOverrideStore): Promise<RuntimeSettings>;
+/**
+ * The installed backend a load runs on: the configured pack when it is on disk, otherwise the best
+ * compatible installed one. `repair` runs on the pack that will be used before it is returned — the
+ * TurboQuant provider puts a missing CUDA runtime back there, as its extension did before every load.
+ */
+export declare function ensureBackend(layout: DataLayout, provider: LocalProviderId, backend: string, version: string, hardware: HardwareOverrideStore, hostArch?: NodeJS.Architecture, repair?: (backend: string, version: string) => Promise<void>): Promise<{
+    version: string;
+    backend: string;
+    exePath: string;
+}>;
+/** Choose among installed packs using the app-injected hardware facts, never directory order. */
+export declare function selectInstalledBackend(layout: DataLayout, provider: LocalProviderId, hardware: HardwareOverrideStore, hostArch?: NodeJS.Architecture, probeRocm?: () => Promise<RocmHostProbe>): Promise<import("../installed/scan.js").DiscoveredBackendBinary | undefined>;
+/** Node's `process.arch` in the Rust spelling the backend and CPU policies expect (`x64` → `x86_64`). */
+export declare function platformArch(arch: string): string;