@atomic-chat/core 0.5.1

package/dist/backend/install/runtime-backend.js

@@ -0,0 +1,95 @@
+/** Resolve the installed backend a runtime may actually execute on this host. */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { isConcreteVersionBackend } from '../../runtime/llamacpp/index.js';
+import { canonicalProviderDefaults } from '../../settings/index.js';
+import { discoverBackendBinary, resolveBackendExe, scanInstalledBackends } from '../installed/index.js';
+import { determineBestBackend, determineSupportedBackends, filterBackendsBySupport, getSupportedFeatures, } from '../select/index.js';
+import { determineBestTurboquantBackend, determineTurboquantSupportedBackends, filterTurboquantBackendsBySupport, getTurboquantSupportedFeatures, probeLinuxRocmHost, } from '../turboquant.js';
+/** Provider settings plus the engine-level keys the load plan reads. */
+export async function readRuntimeSettings(settings, provider, layout, hardware) {
+    const values = { ...canonicalProviderDefaults(provider), ...settings.get(provider) };
+    const configured = String(values['version_backend'] ?? '').trim();
+    if (!isConcreteVersionBackend(configured)) {
+        const discovered = await selectInstalledBackend(layout, provider, hardware);
+        if (discovered)
+            values['version_backend'] = discovered.version_backend;
+    }
+    return {
+        config: values,
+        engine: {
+            timeout: values['timeout'] ?? 600,
+            llamacpp_env: values['llamacpp_env'] ?? '',
+            ...(values['dflash_block_size'] !== undefined
+                ? { dflash_block_size: values['dflash_block_size'] }
+                : {}),
+        },
+    };
+}
+/**
+ * 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 async function ensureBackend(layout, provider, backend, version, hardware, hostArch = process.arch, repair) {
+    const exact = await resolveBackendExe(layout, provider, version, backend);
+    if (exact) {
+        await repair?.(backend, version);
+        return { version, backend, exePath: exact };
+    }
+    const discovered = await selectInstalledBackend(layout, provider, hardware, hostArch);
+    if (discovered) {
+        await repair?.(discovered.backend, discovered.version);
+        return { version: discovered.version, backend: discovered.backend, exePath: discovered.path };
+    }
+    throw new AtomicCoreError('BINARY_NOT_FOUND', 'No llama.cpp backend is installed in this data folder.', `looked for ${version}/${backend} under ${layout.provider(provider).backendsDir}`);
+}
+/** Choose among installed packs using the app-injected hardware facts, never directory order. */
+export async function selectInstalledBackend(layout, provider, hardware, hostArch = process.arch, probeRocm = probeLinuxRocmHost) {
+    const installed = await scanInstalledBackends(layout, provider);
+    if (installed.length === 0)
+        return discoverBackendBinary(layout, provider);
+    const override = hardware.get();
+    const osType = override?.os_type ?? platformOsType(process.platform);
+    const arch = platformArch(hostArch);
+    const gpus = hardware.gpus([]);
+    let selected;
+    if (provider === 'llamacpp') {
+        // The fork's own matrix, ids and priorities: the upstream ones filter every TurboQuant pack out.
+        const rocm = osType === 'linux' ? await probeRocm() : undefined;
+        const features = getTurboquantSupportedFeatures(osType, hardware.cpuExtensions([]), gpus, rocm);
+        const supported = determineTurboquantSupportedBackends(osType, arch, features);
+        const compatible = filterTurboquantBackendsBySupport(installed, supported);
+        if (compatible.length === 0)
+            return undefined;
+        selected = determineBestTurboquantBackend(compatible, gpus);
+    }
+    else {
+        const features = getSupportedFeatures(osType, hardware.cpuExtensions([]), gpus);
+        const supported = determineSupportedBackends(osType, arch, features);
+        const compatible = filterBackendsBySupport(installed, supported, osType);
+        if (compatible.length === 0)
+            return undefined;
+        selected = determineBestBackend(compatible, gpus);
+    }
+    const [version, backend] = selected.split('/');
+    if (!version || !backend)
+        return undefined;
+    const path = await resolveBackendExe(layout, provider, version, backend);
+    return path ? { path, version_backend: selected, version, backend } : undefined;
+}
+function platformOsType(platform) {
+    if (platform === 'win32')
+        return 'windows';
+    if (platform === 'darwin')
+        return 'macos';
+    return platform;
+}
+/** Node's `process.arch` in the Rust spelling the backend and CPU policies expect (`x64` → `x86_64`). */
+export function platformArch(arch) {
+    if (arch === 'x64')
+        return 'x86_64';
+    if (arch === 'ia32')
+        return 'x86';
+    return arch;
+}
+//# sourceMappingURL=runtime-backend.js.map

package/dist/backend/install/runtime-backend.js.map

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

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

@@ -0,0 +1,119 @@
+/**
+ * Installing and updating llama.cpp backends (PLAN.md §4, stage 3c).
+ *
+ * The pieces this composes already existed — the manifest reader, the archive URL builder, the
+ * downloader, the extractor, the installed-pack scanner. What was missing is the thing that puts
+ * them in order and gives the result the names the app's "Backend updater" screen already calls.
+ *
+ * Two properties it owes the UI.
+ *
+ * *One task id per install, and it is the download's.* The app's progress bar listens on an event
+ * named after the task, and a backend install that invented a second id mid-flight would leave the
+ * bar stuck at whatever it last saw. So the caller names the task and everything — the archive, the
+ * CUDA runtime that some Windows backends need alongside it — reports under that one name.
+ *
+ * *A failed install leaves nothing installed.* An extracted-but-incomplete pack is worse than no
+ * pack: `selectInstalledBackend` would find it, the runtime would spawn from it, and the failure
+ * would surface as a model that will not load rather than as a download that did not finish. The
+ * install therefore extracts into a temporary directory and moves it into place only once every
+ * part has arrived.
+ */
+import type { LocalProviderId } from '../../contracts/index.js';
+import type { DataLayout } from '../../config/index.js';
+import type { Downloader, ProxyConfig } from '../../downloads/index.js';
+import type { InstalledBackendPack, UpstreamManifest } from '../types.js';
+import type { OptimalBackendStore, OptimalState, OptimalUpdate } from '../optimal/index.js';
+/** Same launch gate as the former macOS extension, run on staging before replacing a working pack. */
+export declare function verifyMacBackendBinary(staging: string, version: string): Promise<void>;
+/** The server executable inside a pack; the only name `normalizeBackendLayout` looks for. */
+export declare function backendExeName(osType: string): string;
+export interface BackendServiceDeps {
+    layout: DataLayout;
+    provider: LocalProviderId;
+    downloader: Downloader;
+    /** The live manifest for this platform, or `null` when it could not be fetched. */
+    readManifest: (proxy?: ProxyConfig | null) => Promise<UpstreamManifest | null>;
+    optimalStore?: OptimalBackendStore;
+    /** Decides the executable name inside a pack (`llama-server` vs `llama-server.exe`). */
+    platform?: NodeJS.Platform;
+    /** Test seam for the staging directory's name. */
+    now?: () => number;
+    /** Test seam for the macOS launch gate. */
+    verifyMacBackend?: (staging: string, version: string) => Promise<void>;
+    log?: (message: string) => void;
+}
+export interface InstallBackendOptions {
+    /** Event/task name the progress is reported under. The caller owns it; see the module note. */
+    taskId: string;
+    /** Reinstall even when the pack is already on disk. */
+    force?: boolean;
+    /** Current app proxy policy; never persisted. */
+    proxy?: ProxyConfig | null;
+    /**
+     * TurboQuant only: the asset the release index names for this pair. Without it the index cache on
+     * disk is read, then the fork's naming convention is used.
+     */
+    assetName?: string;
+}
+export interface InstallBackendResult {
+    version: string;
+    backend: string;
+    /** `false` when the pack was already installed and `force` was not set. */
+    installed: boolean;
+    path: string;
+}
+export declare class BackendService {
+    private readonly deps;
+    constructor(deps: BackendServiceDeps);
+    /**
+     * Every backend pack on disk — what the updater screen lists.
+     *
+     * `currentVersionBackend` decides which row is marked as the one in use; the caller passes what
+     * the provider's settings say, because the service has no opinion about which backend is selected.
+     */
+    listInstalled(currentVersionBackend?: string): Promise<InstalledBackendPack[]>;
+    isInstalled(version: string, backend: string): Promise<boolean>;
+    /**
+     * Download and unpack a backend.
+     *
+     * Idempotent by default: a pack already on disk is reported as `installed: false` rather than
+     * downloaded again, because the updater screen calls this for every row it offers and a user
+     * clicking twice should not re-fetch half a gigabyte.
+     */
+    install(version: string, backend: string, options: InstallBackendOptions): Promise<InstallBackendResult>;
+    /**
+     * An upstream pack: from the signed mirror when the manifest lists this exact asset, otherwise the
+     * ggml-org CDN without a checksum — the app's behaviour, and the reason a build the mirror has not
+     * caught up with still installs; a wrong tag then fails as a 404 during the download. Some Windows
+     * CUDA backends ship without the CUDA runtime, which is fetched beside them under the same task,
+     * because to the user this is one install with one progress bar.
+     */
+    private upstreamDownloads;
+    /**
+     * A TurboQuant pack from the fork's release CDN, under the asset name its release index gives.
+     * The index carries sizes and hashes, but the extension never checked them; neither does this, so
+     * a republished asset installs the same way it did.
+     */
+    private turboquantDownloads;
+    /**
+     * The optimal-backend record for a provider, or `null` when nothing has been detected yet.
+     *
+     * The app used to keep this in `localStorage`, where the CLI could not see it. It now lives beside
+     * the data it describes (`<data>/atomic-core/optimal-backend.json`, PLAN.md §3.4) and is keyed by
+     * provider, because the two llama.cpp providers can be on different builds. Moving the data folder
+     * to new hardware is not detected by this format; that requires a separate invalidation rule.
+     */
+    getOptimalCache(): Promise<OptimalState>;
+    /**
+     * Store a detection result. Writing `null` forgets it, which is what a "Find optimal backend"
+     * that finds nothing must do — leaving the previous answer would keep recommending a backend for
+     * hardware that is no longer there.
+     */
+    setOptimalCache(record: OptimalState['optimal'], expectedRevision: number): Promise<OptimalUpdate>;
+    /** Remove an installed pack. Silent when it is not there — the end state is what was asked for. */
+    /**
+     * Delete a pack. Refuses ids that would leave the backends directory and the pack the provider's
+     * settings select: the app's extensions checked this themselves, and the CLI never did.
+     */
+    remove(version: string, backend: string, currentVersionBackend?: string): Promise<boolean>;
+}

package/dist/backend/install/service.js

@@ -0,0 +1,218 @@
+/**
+ * Installing and updating llama.cpp backends (PLAN.md §4, stage 3c).
+ *
+ * The pieces this composes already existed — the manifest reader, the archive URL builder, the
+ * downloader, the extractor, the installed-pack scanner. What was missing is the thing that puts
+ * them in order and gives the result the names the app's "Backend updater" screen already calls.
+ *
+ * Two properties it owes the UI.
+ *
+ * *One task id per install, and it is the download's.* The app's progress bar listens on an event
+ * named after the task, and a backend install that invented a second id mid-flight would leave the
+ * bar stuck at whatever it last saw. So the caller names the task and everything — the archive, the
+ * CUDA runtime that some Windows backends need alongside it — reports under that one name.
+ *
+ * *A failed install leaves nothing installed.* An extracted-but-incomplete pack is worse than no
+ * pack: `selectInstalledBackend` would find it, the runtime would spawn from it, and the failure
+ * would surface as a model that will not load rather than as a download that did not finish. The
+ * install therefore extracts into a temporary directory and moves it into place only once every
+ * part has arrived.
+ */
+import { chmod, mkdir, readdir, rename, rm } from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { join } from 'node:path';
+import { validateProxyConfig } from '../../downloads/index.js';
+import { extractArchive, normalizeBackendLayout } from '../../downloads/index.js';
+import { getBackendArchiveName, getCudartArchiveName, getCudartDownloadUrl, resolveBackendArchiveSource, } from '../catalog/index.js';
+import { deletableBackendPack, getBackendDir, listInstalledBackendPacks } from '../installed/index.js';
+import { scanInstalledBackends } from '../installed/index.js';
+import { llamaServerExeName } from '../../config/index.js';
+import { ensureTurboquantCudart, readTurboquantIndexedAsset, turboquantArchiveUrl } from '../turboquant.js';
+import { parseBackendVersion, parseBinaryVersion } from '../version.js';
+const execFileAsync = promisify(execFile);
+/** Same launch gate as the former macOS extension, run on staging before replacing a working pack. */
+export async function verifyMacBackendBinary(staging, version) {
+    const bin = join(staging, 'build', 'bin');
+    // The former Rust gate made every build/bin file executable, not just the main server.
+    for (const entry of await readdir(bin, { withFileTypes: true })) {
+        if (entry.isFile())
+            await chmod(join(bin, entry.name), 0o755);
+    }
+    const executable = join(bin, 'llama-server');
+    const { stdout, stderr } = await execFileAsync(executable, ['--version'], { timeout: 15_000 });
+    const expected = parseBackendVersion(version);
+    if (expected !== 0 && parseBinaryVersion(`${stdout}\n${stderr}`) !== expected) {
+        throw new Error(`backend did not report build ${version}`);
+    }
+}
+/** The server executable inside a pack; the only name `normalizeBackendLayout` looks for. */
+export function backendExeName(osType) {
+    return osType === 'windows' ? 'llama-server.exe' : 'llama-server';
+}
+export class BackendService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Every backend pack on disk — what the updater screen lists.
+     *
+     * `currentVersionBackend` decides which row is marked as the one in use; the caller passes what
+     * the provider's settings say, because the service has no opinion about which backend is selected.
+     */
+    async listInstalled(currentVersionBackend = '') {
+        const entries = await scanInstalledBackends(this.deps.layout, this.deps.provider);
+        return listInstalledBackendPacks(this.deps.layout.provider(this.deps.provider), entries, currentVersionBackend);
+    }
+    async isInstalled(version, backend) {
+        const packs = await this.listInstalled();
+        return packs.some((pack) => pack.version === version && pack.backend === backend);
+    }
+    /**
+     * Download and unpack a backend.
+     *
+     * Idempotent by default: a pack already on disk is reported as `installed: false` rather than
+     * downloaded again, because the updater screen calls this for every row it offers and a user
+     * clicking twice should not re-fetch half a gigabyte.
+     */
+    async install(version, backend, options) {
+        if (options.proxy) {
+            const problem = validateProxyConfig(options.proxy);
+            if (problem)
+                throw new Error(problem);
+        }
+        const target = getBackendDir(this.deps.layout.provider(this.deps.provider), backend, version);
+        if (!options.force && (await this.isInstalled(version, backend))) {
+            return { version, backend, installed: false, path: target };
+        }
+        // Staging directory beside the target, so the move at the end is a rename on the same volume
+        // rather than a copy across one.
+        const staging = `${target}.incoming-${this.deps.now?.() ?? Date.now()}`;
+        const plan = this.deps.provider === 'llamacpp'
+            ? await this.turboquantDownloads(version, backend, staging, options)
+            : await this.upstreamDownloads(version, backend, staging, options);
+        await rm(staging, { recursive: true, force: true });
+        await mkdir(staging, { recursive: true });
+        try {
+            await this.deps.downloader.download(options.taskId, plan.items);
+            for (const archive of plan.archives) {
+                await extractArchive(archive, staging);
+                await rm(archive, { force: true });
+            }
+            await normalizeBackendLayout(staging, llamaServerExeName(this.deps.platform ?? process.platform));
+            if (this.deps.provider === 'llamacpp-upstream' &&
+                (this.deps.platform ?? process.platform) === 'darwin') {
+                try {
+                    await (this.deps.verifyMacBackend ?? verifyMacBackendBinary)(staging, version);
+                }
+                catch (error) {
+                    throw new Error(`The downloaded ${version}/${backend} backend failed its launch check (${String(error)}). Keeping the current backend.`);
+                }
+            }
+            await rm(target, { recursive: true, force: true });
+            await mkdir(join(target, '..'), { recursive: true });
+            await rename(staging, target);
+        }
+        catch (e) {
+            // Nothing half-installed survives: a partial pack would be picked up by backend selection and
+            // would fail later as a model that will not load.
+            await rm(staging, { recursive: true, force: true });
+            throw e;
+        }
+        if (this.deps.provider === 'llamacpp') {
+            // Some fork zips ship without the CUDA runtime. The extension repaired it after installing and
+            // only warned on failure: the pack may still run on a host with a CUDA toolkit.
+            await ensureTurboquantCudart(backend, target, options.taskId, {
+                layout: this.deps.layout,
+                downloader: this.deps.downloader,
+                ...(this.deps.platform ? { platform: this.deps.platform } : {}),
+                ...(options.proxy ? { proxy: options.proxy } : {}),
+                ...(this.deps.log ? { log: this.deps.log } : {}),
+            }).catch((e) => this.deps.log?.(`cudart repair for ${version}/${backend} failed: ${String(e)}`));
+        }
+        return { version, backend, installed: true, path: target };
+    }
+    /**
+     * An upstream pack: from the signed mirror when the manifest lists this exact asset, otherwise the
+     * ggml-org CDN without a checksum — the app's behaviour, and the reason a build the mirror has not
+     * caught up with still installs; a wrong tag then fails as a 404 during the download. Some Windows
+     * CUDA backends ship without the CUDA runtime, which is fetched beside them under the same task,
+     * because to the user this is one install with one progress bar.
+     */
+    async upstreamDownloads(version, backend, staging, options) {
+        const manifest = await this.deps.readManifest(options.proxy);
+        const source = resolveBackendArchiveSource(version, backend, manifest ?? undefined);
+        const archivePath = join(staging, getBackendArchiveName(version, backend));
+        const cudartName = getCudartArchiveName(backend);
+        const cudartUrl = getCudartDownloadUrl(version, backend);
+        const proxy = options.proxy ? { proxy: options.proxy } : {};
+        const items = [
+            {
+                url: source.url,
+                save_path: archivePath,
+                ...(source.sha256 ? { sha256: source.sha256 } : {}),
+                ...(source.size ? { size: source.size } : {}),
+                ...proxy,
+            },
+        ];
+        const archives = [archivePath];
+        if (cudartName && cudartUrl) {
+            items.push({ url: cudartUrl, save_path: join(staging, cudartName), ...proxy });
+            archives.push(join(staging, cudartName));
+        }
+        return { items, archives };
+    }
+    /**
+     * A TurboQuant pack from the fork's release CDN, under the asset name its release index gives.
+     * The index carries sizes and hashes, but the extension never checked them; neither does this, so
+     * a republished asset installs the same way it did.
+     */
+    async turboquantDownloads(version, backend, staging, options) {
+        const asset = options.assetName ?? (await readTurboquantIndexedAsset(this.deps.layout, version, backend));
+        const url = turboquantArchiveUrl(version, backend, asset, this.deps.platform);
+        const archivePath = join(staging, url.slice(url.lastIndexOf('/') + 1));
+        return {
+            items: [{ url, save_path: archivePath, ...(options.proxy ? { proxy: options.proxy } : {}) }],
+            archives: [archivePath],
+        };
+    }
+    /**
+     * The optimal-backend record for a provider, or `null` when nothing has been detected yet.
+     *
+     * The app used to keep this in `localStorage`, where the CLI could not see it. It now lives beside
+     * the data it describes (`<data>/atomic-core/optimal-backend.json`, PLAN.md §3.4) and is keyed by
+     * provider, because the two llama.cpp providers can be on different builds. Moving the data folder
+     * to new hardware is not detected by this format; that requires a separate invalidation rule.
+     */
+    async getOptimalCache() {
+        if (!this.deps.optimalStore)
+            throw new Error('Optimal-backend store is not configured');
+        return this.deps.optimalStore.get(this.deps.provider);
+    }
+    /**
+     * Store a detection result. Writing `null` forgets it, which is what a "Find optimal backend"
+     * that finds nothing must do — leaving the previous answer would keep recommending a backend for
+     * hardware that is no longer there.
+     */
+    async setOptimalCache(record, expectedRevision) {
+        if (!this.deps.optimalStore)
+            throw new Error('Optimal-backend store is not configured');
+        return this.deps.optimalStore.set(this.deps.provider, record, expectedRevision);
+    }
+    /** Remove an installed pack. Silent when it is not there — the end state is what was asked for. */
+    /**
+     * Delete a pack. Refuses ids that would leave the backends directory and the pack the provider's
+     * settings select: the app's extensions checked this themselves, and the CLI never did.
+     */
+    async remove(version, backend, currentVersionBackend = '') {
+        const pack = deletableBackendPack(currentVersionBackend, version, backend);
+        version = pack.version;
+        backend = pack.backend;
+        const target = getBackendDir(this.deps.layout.provider(this.deps.provider), backend, version);
+        const existed = await this.isInstalled(version, backend);
+        await rm(target, { recursive: true, force: true });
+        return existed;
+    }
+}
+//# sourceMappingURL=service.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** Installed backend packs on disk: path and pack decisions, and the directory scan. */
+export * from './installed.js';
+export * from './scan.js';

package/dist/backend/installed/index.js

@@ -0,0 +1,4 @@
+/** Installed backend packs on disk: path and pack decisions, and the directory scan. */
+export * from './installed.js';
+export * from './scan.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/installed/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA"}

package/dist/backend/installed/installed.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Installed backend packs on disk — the pure half. Port of `getBackendDir`, `getBackendExePath`,
+ * `isBackendInstalled`, `listInstalledBackendPacks`, `deleteBackendPack` (validation only),
+ * `backendTypeEquivalents`, `findCompatibleInstalledBackend` and `mergeBackendOptions` from
+ * `extensions/llamacpp-upstream-extension/src/backend.ts`, plus the `order` semantics of
+ * `get_local_installed_backends` and the library-name half of `is_cuda_installed` from `backend.rs`.
+ *
+ * Layout (PLAN.md §8.1): `<data>/<provider>/backends/<version>/<backend>/build/bin/llama-server`,
+ * legacy flat `<backend>/llama-server`. Directory scanning, `rm` and `stat` are phase 1
+ * (`store.ts`); this file only turns scan results into decisions and joins paths.
+ */
+import type { ProviderPaths } from '../../config/index.js';
+import type { BackendOption, BackendVersion, InstalledBackendPack } from '../types.js';
+/** One `<version>/<backend>` directory as a scanner reports it. */
+export interface InstalledBackendEntry {
+    version: string;
+    backend: string;
+    /** `build/bin/<exe>` or flat `<exe>` exists. */
+    hasExe: boolean;
+    /** Directory mtime, seconds since the epoch. */
+    mtimeSeconds?: number;
+}
+/**
+ * Rust `get_local_installed_backends` on scan results: only directories carrying the executable,
+ * names BOM-stripped and trimmed, `order` = mtime seconds as u32 (0 when unknown).
+ */
+export declare function installedBackendsFromEntries(entries: readonly InstalledBackendEntry[]): BackendVersion[];
+/** `<backendsDir>/<version>/<backend>`, both ids BOM-stripped. */
+export declare function getBackendDir(paths: ProviderPaths, backend: string, version: string): string;
+/** `[build/bin/<exe>, <exe>]` under the pack directory, per platform. */
+export declare function backendExePathCandidates(paths: ProviderPaths, backend: string, version: string, platform: NodeJS.Platform): [string, string];
+/**
+ * The executable path the app would launch: `build/bin/<exe>` when the pack has a `build/` directory,
+ * else the legacy flat `<exe>`. (The app checks for the directory, not the file.)
+ */
+export declare function getBackendExePath(paths: ProviderPaths, backend: string, version: string, platform: NodeJS.Platform, exists: (path: string) => Promise<boolean>): Promise<string>;
+/** Rust `is_backend_installed`: either candidate executable exists. */
+export declare function isBackendInstalled(paths: ProviderPaths, backend: string, version: string, platform: NodeJS.Platform, exists: (path: string) => Promise<boolean>): Promise<boolean>;
+/**
+ * Every installed build with its absolute path (for "reveal in file manager") and whether it is the
+ * selected one (which must not be deletable).
+ */
+export declare function listInstalledBackendPacks(paths: ProviderPaths, installed: readonly BackendVersion[], currentVersionBackend: string): InstalledBackendPack[];
+/**
+ * Validate a pack for deletion: both ids non-empty, free of path separators and not `.`/`..` (no
+ * escape from the backends directory),
+ * and not the selected build — deleting that would leave `version_backend` pointing at nothing and
+ * the next load would fail with `BINARY_NOT_FOUND` instead of anything actionable.
+ */
+export declare function deletableBackendPack(currentVersionBackend: string, version: string, backend: string): {
+    version: string;
+    backend: string;
+};
+/**
+ * Ids treated as the same backend type (ATO-233): a tarball installed by its upstream file name sits
+ * on disk as `ubuntu-vulkan-x64` while the app stores `linux-vulkan-x64`.
+ */
+export declare function backendTypeEquivalents(backendType: string): Set<string>;
+/**
+ * Newest installed build of exactly this type (any release tag), by install `order`, or `null`.
+ * Never crosses types (cuda → cpu is a user choice). Fallback for a pinned tag that cannot be
+ * downloaded (ATO-179).
+ */
+export declare function findCompatibleInstalledBackend(backendType: string, installed: readonly BackendVersion[]): BackendVersion | null;
+/**
+ * Flatten the dropdown tiers (most-preferred first) into one list: first spelling of a value wins
+ * (keeps the richest label), blanks and BOM-only values drop, and `recommended` is forced to the
+ * front when absent — a recommendation the dropdown cannot offer is a dead end.
+ */
+export declare function mergeBackendOptions(tiers: readonly (readonly BackendOption[])[], recommended?: BackendOption): BackendOption[];
+/**
+ * CUDA runtime library a backend needs, by CUDA *major* (so a 13.x minor bump does not break the
+ * probe): `cudart64_{110,12,13}.dll` on Windows, `libcudart.so.{11.0,12,13}` on Linux; `null` for
+ * any other OS or major.
+ */
+export declare function cudaRuntimeLibName(osType: string, version: string): string | null;
+export interface CudaLibFs {
+    exists: (path: string) => Promise<boolean>;
+    mkdir: (path: string) => Promise<void>;
+    rename: (from: string, to: string) => Promise<void>;
+}
+/**
+ * Rust `is_cuda_installed`: the runtime library is present at `<backendDir>/build/bin/<lib>`, or it
+ * sits at the legacy `<data>/llamacpp/lib/<lib>` and is moved into place (creating `build/bin`;
+ * a failed `mkdir` is `IO_ERROR`, a failed `rename` is `false`). `false` for an unknown OS/major.
+ */
+export declare function isCudaInstalled(input: {
+    backendDir: string;
+    version: string;
+    osType: string;
+    legacyLibDir: string;
+    fs: CudaLibFs;
+}): Promise<boolean>;