@atomic-chat/core 0.5.1 → 0.13.2

package/dist/engine-builds/select.js

@@ -0,0 +1,223 @@
+/**
+ * Which build of an engine this host should install. Openspec change `move-sdcpp-mlx-install-to-core`,
+ * design D7.
+ *
+ * The sd.cpp ladder below, from `LINUX_VULKAN_MIN_VRAM_MIB` to `backendKindOf`, is
+ * `web-app/src/services/diffusion/backendMatrix.ts` of the app's `change/add-vllm-runtime` branch,
+ * verbatim but for one cast core's `noUncheckedIndexedAccess` needs (rulings/core.md 2.4: that branch, not app main, because it carries the arm64 builds and
+ * the walk down the ladder). The app fed it the deprecated Rust `get_supported_features`; the core
+ * feeds it `getSupportedFeatures`, which that function was ported from, through `sdcppHostOf`.
+ *
+ * What the app kept in `localStorage` — the `<tag>/<backend_id>` builds that unpacked but failed their
+ * probe here — lives in `<data>/diffusion/failed-backends.json`, so the desktop and `atc` skip the
+ * same ones.
+ *
+ * Original header:
+ *
+ * Which stable-diffusion.cpp prebuilt this host should run.
+ *
+ * Pure: the caller gathers the OS, arch, the feature probe from
+ * `plugin:llamacpp-upstream|get_supported_features` and the GPU list, and
+ * hands over the backend ids the manifest actually lists. The ladder mirrors
+ * the llama.cpp providers' policy in AGENTS.md §3 — a backend is a property of
+ * the pinned release, so an id the manifest does not carry is skipped rather
+ * than guessed at.
+ *
+ * Linux x64 has no CUDA prebuilt from leejet (nor from ggml-org), so NVIDIA
+ * hosts there run Vulkan until the diffusers sidecar (phase 1b) lands. Windows
+ * ROCm is not in every tag; when absent the host falls through to Vulkan.
+ *
+ * arm64 Linux and Windows on Arm get no upstream archive at all; their CUDA 13
+ * and CPU builds come from AtomicBot-ai/stable-diffusion.cpp, mirrored under
+ * the same tag (ADR 2026-10-06). CUDA 13 is the only accelerated tier there:
+ * those builds target sm_121 (GB10 / N1X) with a Hopper PTX floor.
+ */
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { getSupportedFeatures } from '../backend/index.js';
+/**
+ * Smallest Vulkan device worth moving a Linux host off the CPU build for.
+ * Mirrors `LINUX_VULKAN_MIN_VRAM_MIB` in
+ * `extensions/llamacpp-upstream-extension/src/index.ts` (the web app cannot
+ * import extension source); keep the two in step.
+ */
+export const LINUX_VULKAN_MIN_VRAM_MIB = 2 * 1024;
+/** Windows CUDA 12 build; a CUDA 13-only driver still runs it. */
+const WIN_CUDA12 = 'win-cuda12-x64';
+const WIN_ROCM_RE = /^win-rocm-(\d+(?:\.\d+)*)-x64$/;
+const WIN_VULKAN = 'win-vulkan-x64';
+const WIN_CPU = 'win-cpu-x64';
+const LINUX_VULKAN = 'linux-vulkan-x64';
+const LINUX_CPU = 'linux-cpu-x64';
+const MACOS_ARM64 = 'macos-arm64';
+const WIN_CUDART_CU12 = 'win-cudart-cu12';
+/** Atomic-built arm64 archives; they carry their CUDA runtime, so no companion. */
+const WIN_CUDA13_ARM64 = 'win-cuda13-arm64';
+const WIN_CPU_ARM64 = 'win-cpu-arm64';
+const LINUX_CUDA13_ARM64 = 'linux-cuda13-arm64';
+const LINUX_CPU_ARM64 = 'linux-cpu-arm64';
+const versionKey = (version) => version.split('.').map((part) => Number(part));
+const compareVersions = (a, b) => {
+    const length = Math.max(a.length, b.length);
+    for (let i = 0; i < length; i += 1) {
+        const diff = (a[i] ?? 0) - (b[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+};
+/** The highest-versioned id matching `pattern`, or null when the tag ships none. */
+const pickVersioned = (available, pattern) => {
+    let best = null;
+    for (const id of available) {
+        const match = pattern.exec(id);
+        if (!match)
+            continue;
+        const key = versionKey(match[1]);
+        if (!best || compareVersions(key, best.key) > 0)
+            best = { id, key };
+    }
+    return best?.id ?? null;
+};
+const allAvailable = (available, candidates) => candidates.filter((id, index) => id !== null && available.includes(id) && candidates.indexOf(id) === index);
+/**
+ * Every build this host can run that the manifest ships, best first; empty
+ * when there is none (Intel Macs, an arm64 host on a manifest without arm64
+ * builds, an empty manifest). The installer walks down it when a build
+ * unpacks but fails the core's probe — upstream's Windows ROCm archive on a
+ * host without the HIP SDK it links against — instead of stopping there.
+ */
+export function diffusionBackendLadder(input) {
+    const { os, arch, features, gpus, available } = input;
+    if (os === 'macos') {
+        return arch === 'arm64' ? allAvailable(available, [MACOS_ARM64]) : [];
+    }
+    if (arch === 'arm64') {
+        // The CUDA 13 runtime inside these archives needs the r580+ driver the
+        // cuda13 probe checks for; anything less runs the CPU build.
+        const cuda = features.cuda13 ? (os === 'windows' ? WIN_CUDA13_ARM64 : LINUX_CUDA13_ARM64) : null;
+        return allAvailable(available, [cuda, os === 'windows' ? WIN_CPU_ARM64 : LINUX_CPU_ARM64]);
+    }
+    if (os === 'windows') {
+        const cuda = features.cuda12 || features.cuda13 ? WIN_CUDA12 : null;
+        const rocm = features.rocm ? pickVersioned(available, WIN_ROCM_RE) : null;
+        const vulkan = features.vulkan ? WIN_VULKAN : null;
+        return allAvailable(available, [cuda, rocm, vulkan, WIN_CPU]);
+    }
+    // Linux: Vulkan is the only accelerated prebuilt, and only when the loader
+    // enumerated a device big enough to hold a checkpoint beside its activations.
+    const anyVulkanDevice = gpus.some((gpu) => (gpu.totalMemoryMib ?? 0) >= LINUX_VULKAN_MIN_VRAM_MIB);
+    const vulkan = features.vulkan && anyVulkanDevice ? LINUX_VULKAN : null;
+    return allAvailable(available, [vulkan, LINUX_CPU]);
+}
+/**
+ * The backend id to install, or `null` when this host cannot run any build
+ * the manifest ships: the top of `diffusionBackendLadder`.
+ */
+export function selectDiffusionBackend(input) {
+    return diffusionBackendLadder(input)[0] ?? null;
+}
+/** The companion archive a backend needs unpacked beside it, if any. */
+export function companionFor(backendId) {
+    return backendId === WIN_CUDA12 ? WIN_CUDART_CU12 : null;
+}
+/** The compute backend a manifest id was built for, for the install record. */
+export function backendKindOf(backendId) {
+    if (backendId.startsWith('macos-'))
+        return 'metal';
+    if (backendId.includes('-cuda'))
+        return 'cuda';
+    if (backendId.includes('-rocm'))
+        return 'rocm';
+    if (backendId.includes('-vulkan'))
+        return 'vulkan';
+    return 'cpu';
+}
+// --- core: the host from the core's hardware facts, failed rungs, MLX ------------------------------
+/** What the ladder reads, from the core's own facts (the override applied). */
+export function sdcppHostOf(facts) {
+    const arch = /arm64|aarch64/.test(facts.arch) ? 'arm64' : 'x64';
+    const os = facts.osType;
+    const gpus = facts.gpus.map((gpu) => ({
+        ...(typeof gpu.vendor === 'string' ? { vendor: gpu.vendor } : {}),
+        ...(typeof gpu.total_memory === 'number' ? { totalMemoryMib: gpu.total_memory } : {}),
+    }));
+    // macOS has Metal and nothing for the feature probe to find, as the app had it.
+    if (os === 'macos')
+        return { os, arch, features: {}, gpus };
+    const probed = getSupportedFeatures(os, facts.cpuExtensions ?? [], facts.gpus);
+    return {
+        os,
+        arch,
+        features: { cuda12: probed.cuda12, cuda13: probed.cuda13, vulkan: probed.vulkan, rocm: probed.rocm },
+        gpus,
+    };
+}
+/** The key a failed probe is remembered under: a new tag gets a fresh try. */
+export const failedBackendKey = (tag, backendId) => `${tag}/${backendId}`;
+/** Why no build applies, in words a settings card can show (the app's `unsupportedReason`). */
+function unsupportedReason(host) {
+    if (host.os === 'macos')
+        return 'Image generation needs an Apple Silicon Mac; Intel Macs are not supported.';
+    if (host.os !== 'windows' && host.os !== 'linux')
+        return `Image generation is not supported on ${host.os}.`;
+    if (host.arch !== 'x64')
+        return `The release manifest lists no stable-diffusion.cpp build for ${host.arch} ${host.os} yet.`;
+    return 'The release manifest lists no build for this computer.';
+}
+/**
+ * The ladder for `manifest`, leaving out the builds that failed here on this tag; when that leaves
+ * nothing, the last build is offered again, so a retry ends on its own error rather than on "no build
+ * for this computer" (the app's `backendLadderForHost`).
+ */
+export function sdcppHostChoice(host, manifest, failed) {
+    const supported = host.os === 'macos' || host.os === 'windows' || host.os === 'linux';
+    const ladder = supported
+        ? diffusionBackendLadder({
+            ...host,
+            os: host.os,
+            available: manifest.assets.filter((asset) => !asset.companion).map((asset) => asset.backend),
+        })
+        : [];
+    if (ladder.length === 0)
+        return { ladder: [], backend_id: null, reason: unsupportedReason(host) };
+    const usable = ladder.filter((id) => !failed.has(failedBackendKey(manifest.tag_name, id)));
+    const offered = usable.length > 0 ? usable : ladder.slice(-1);
+    return { ladder: offered, backend_id: offered[0] ?? null, reason: null };
+}
+/** The app kept "a few tags' worth of rungs"; older entries name tags no manifest serves. */
+export const FAILED_BACKENDS_LIMIT = 16;
+/** `<tag>/<backend_id>` pairs that failed their probe on this machine; empty when unreadable. */
+export async function readFailedBackends(file) {
+    try {
+        const parsed = JSON.parse(await readFile(file, 'utf8'));
+        return new Set(Array.isArray(parsed) ? parsed.filter((e) => typeof e === 'string') : []);
+    }
+    catch {
+        return new Set();
+    }
+}
+/** Remember one more failed pair, newest last; a failed write only costs a repeated download. */
+export async function rememberFailedBackend(file, tag, backendId) {
+    const key = failedBackendKey(tag, backendId);
+    const entries = [...(await readFailedBackends(file))].filter((entry) => entry !== key);
+    entries.push(key);
+    const temporary = `${file}.tmp-${process.pid}`;
+    try {
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(temporary, JSON.stringify(entries.slice(-FAILED_BACKENDS_LIMIT)), 'utf8');
+        await rename(temporary, file);
+    }
+    catch {
+        await rm(temporary, { force: true }).catch(() => { });
+    }
+}
+/** MLX ships one build, for Apple Silicon; the manifest only has to list it. */
+export function mlxHostChoice(host, manifest) {
+    if (host.os !== 'macos' || host.arch !== 'arm64')
+        return { backend_id: null, reason: 'MLX runs on Apple Silicon Macs only.' };
+    if (manifest && !manifest.assets.some((asset) => asset.backend === MACOS_ARM64))
+        return { backend_id: null, reason: 'The MLX manifest lists no build for Apple Silicon.' };
+    return { backend_id: MACOS_ARM64, reason: null };
+}
+//# sourceMappingURL=select.js.map

package/dist/engine-builds/select.js.map

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

package/dist/engine-builds/service.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Engine builds of sd.cpp and MLX: the catalog, the update check, the install, the removal and the
+ * cleanup at start (openspec change `move-sdcpp-mlx-install-to-core`, spec `engine-builds`).
+ *
+ * The core advises and the client decides (ADR 2026-09-27): the catalog and the update check only
+ * read; an install happens when a client calls it, and that call is also the client's consent to
+ * unload whatever runs from another build of the engine.
+ *
+ * What a build is to each engine's runtime — which lock keeps loads off it, which directories its
+ * sessions run from, what "activating" a build means — is an `EngineHost` the runtime provides;
+ * this module only orders the steps:
+ *
+ *   install = (per-engine lock) → manifest → host build → refuse a downgrade → staged install →
+ *             [under the engine's load lock] activate
+ *
+ * No install deletes another build, and neither does the start (change `unify-engine-lifecycle`, a
+ * decision during its acceptance): the old ones stay listed, inactive, for the user to remove. The
+ * `retired` and `kept_in_use` of an install answer are therefore always empty.
+ *
+ * sd.cpp walks down the host's ladder when a build unpacks but fails its probe (design D7): the pair
+ * is remembered in `<data>/diffusion/failed-backends.json` and the next build is installed under the
+ * same task id; only the last build's failure reaches the client.
+ */
+import type { CoreEvents, EngineBuildCatalog, EngineBuildCatalogRequest, EngineBuildId, EngineBuildInstallRequest, EngineBuildInstallResult, EngineBuildRemoveResult, EngineBuildUpdateCheck, ProxyConfig } from '../contracts/index.js';
+import type { Downloader } from '../downloads/index.js';
+import type { HardwareFacts } from '../hardware/index.js';
+import type { ManifestRead, MlxManifest, SdcppManifest } from './manifest.js';
+/** What an engine's runtime lends this module. */
+export interface EngineHost {
+    /** Run `fn` with this engine's model loads held off (sd.cpp's `loadLock`, MLX's load queue). */
+    exclusive<T>(fn: () => Promise<T>): Promise<T>;
+    /** The build directories sessions of this engine run from right now. */
+    inUse(): Promise<string[]>;
+    /**
+     * The build at `dir` is now the one the next load uses: unload what runs from any other build.
+     * `replaced` — the same directory was swapped for a fresh tree (a forced reinstall). Called inside
+     * `exclusive`.
+     */
+    activate(dir: string, replaced: boolean): Promise<void>;
+    /** A build went without an install: `uninstall` or `startup-cleanup`. sd.cpp re-reports its state. */
+    changed?(reason: 'uninstall' | 'startup-cleanup'): Promise<void>;
+}
+/** The host of an engine with no runtime in this core (MLX off macOS): nothing runs, so nothing to hold. */
+export declare const IDLE_ENGINE_HOST: EngineHost;
+export interface EngineBuildsDeps {
+    dataFolder: string;
+    /** `<data>/diffusion/backends` and `<data>/mlx/backends`. */
+    roots: Record<EngineBuildId, string>;
+    /** `<data>/diffusion/failed-backends.json`. */
+    failedBackendsFile: string;
+    /** The desktop app's `resources/bin`; absent on `atc`. */
+    resourcesDir?: string | undefined;
+    platform: NodeJS.Platform;
+    downloader: Pick<Downloader, 'download'>;
+    manifests: {
+        'sd-cpp': {
+            read(options?: {
+                force?: boolean;
+                proxy?: ProxyConfig | null;
+            }): Promise<ManifestRead<SdcppManifest>>;
+        };
+        'mlx': {
+            read(options?: {
+                force?: boolean;
+                proxy?: ProxyConfig | null;
+            }): Promise<ManifestRead<MlxManifest>>;
+        };
+    };
+    hardware: () => Promise<Pick<HardwareFacts, 'osType' | 'arch' | 'cpuExtensions' | 'gpus'>>;
+    hosts: Record<EngineBuildId, EngineHost>;
+    availableSpace: (path: string) => Promise<number | undefined>;
+    /**
+     * `engine-build:changed`, and the same change as `engine:changed` (change `unify-engine-lifecycle`,
+     * design D8): the desktop releases out there listen to the first, this change's to the second.
+     */
+    emit: <K extends 'engine-build:changed' | 'engine:changed'>(name: K, payload: CoreEvents[K]) => void;
+    now?: () => number;
+    log?: (level: 'info' | 'warn', message: string) => void;
+    /** Test seams for the two probes. */
+    probe?: Partial<Record<EngineBuildId, (dir: string) => Promise<void>>>;
+}
+export declare function parseEngineBuildId(raw: string): EngineBuildId;
+export declare class EngineBuildsService {
+    private readonly deps;
+    private readonly installing;
+    private readonly now;
+    constructor(deps: EngineBuildsDeps);
+    catalog(engine: EngineBuildId, request?: EngineBuildCatalogRequest): Promise<EngineBuildCatalog>;
+    checkUpdates(engine: EngineBuildId, request?: EngineBuildCatalogRequest): Promise<EngineBuildUpdateCheck>;
+    install(engine: EngineBuildId, request: EngineBuildInstallRequest): Promise<EngineBuildInstallResult>;
+    private installLocked;
+    private installOne;
+    private changed;
+    /**
+     * Only a downloaded, marked build; under the engine's load lock, so it never races a load.
+     * `refuseActive` (`DELETE /engines/…`, change `unify-engine-lifecycle`) also refuses the build the
+     * next load would use, judged inside that lock; `DELETE /engine-builds/…` keeps allowing it.
+     */
+    remove(engine: EngineBuildId, tag: string, backendId: string, options?: {
+        refuseActive?: boolean;
+    }): Promise<EngineBuildRemoveResult>;
+    /**
+     * Before the first load: the leftovers of an install the process did not live to finish
+     * (`*.incoming-*`, `*.retired-*`). They were never a build, so no client hears of it; a build on
+     * disk, active or not, always stays. Under each engine's load lock.
+     */
+    startupCleanup(): Promise<void>;
+    /** `<root>/<tag>/<backend>.incoming-<n>[.download]` and `.retired-<n>`: only ever this module's. */
+    private removeLeftovers;
+    /** The build the next MLX load starts: the newest of bundled and downloaded, bundled on a tie. */
+    resolveMlxBinary(): Promise<string | undefined>;
+    private builds;
+    /**
+     * sd.cpp: the newest install, which `selectModelInstall` hands the next load. MLX: the newest
+     * build by `published_at`, the bundled one on a tie (spec "Две точки происхождения mlx-server").
+     */
+    private activeOf;
+    private isUsed;
+    private describe;
+    private readManifest;
+    private hostChoice;
+    private archivesFor;
+}