@atomic-chat/core 0.5.1 → 0.13.2

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

@@ -0,0 +1,121 @@
+/**
+ * The two conf manifests the engine-builds module installs from: `backends/sdcpp-manifest.json`
+ * (stable-diffusion.cpp, which the desktop used to read itself) and `backends/mlx-manifest.json`
+ * (the mlx-vlm fork's `mlx-server`). Openspec change `move-sdcpp-mlx-install-to-core`, design D6.
+ *
+ * The source follows the house pattern of `PrismCatalogService` and `cached-document.ts`: conf main
+ * over `fetch` with an 8 s budget and the request's proxy, an `ATOMIC_*_MANIFEST_URL` override that
+ * may be `https://` or `file://` (anything else is refused, never guessed at), memory for an hour,
+ * then the last accepted document on disk. Unlike the PrismML catalog there is no bundled baseline:
+ * without a network nothing can be installed anyway, and a baked-in copy goes stale with every conf
+ * release. No document at all is an answer (`manifest: null` with the reason), not an error.
+ *
+ * Parsing checks the fields of the conf schemas and drops keys it does not know, so an additive conf
+ * change never makes a released core fall back to its cache. An asset without `sha256` or `size` is
+ * kept — the catalog shows it — but `assetInstallable` says no: nothing unverified is executed.
+ */
+import type { DataLayout } from '../config/index.js';
+import type { ProxyConfig } from '../contracts/index.js';
+export declare const SDCPP_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/sdcpp-manifest.json";
+export declare const MLX_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/mlx-manifest.json";
+export declare const ENGINE_MANIFEST_TIMEOUT_MS = 8000;
+/** A fetched manifest is reused for this long unless the caller forces a re-read. */
+export declare const ENGINE_MANIFEST_TTL_MS: number;
+export declare const SDCPP_UPSTREAM_REPO = "leejet/stable-diffusion.cpp";
+export interface SdcppAsset {
+    backend: string;
+    name: string;
+    sha256?: string;
+    size?: number;
+    /** The Windows CUDA runtime archive, unpacked beside the CUDA build. */
+    companion?: boolean;
+}
+export interface SdcppManifest {
+    updated_at?: string;
+    upstream_repo?: string;
+    /** `master-<n>-<sha>`, `-a<sha>` for a rebuild by the Atomic fork. */
+    tag_name: string;
+    /** The signed mirror; absent, archives come from the upstream release. */
+    download_base?: string;
+    assets: SdcppAsset[];
+}
+export interface MlxAsset {
+    backend: string;
+    name: string;
+    sha256?: string;
+    size?: number;
+}
+export interface MlxManifest {
+    upstream_repo: string;
+    tag_name: string;
+    /** `publishedAt` of the GitHub release: the only order MLX builds have. */
+    published_at: string;
+    assets: MlxAsset[];
+}
+/** A conf date-time this core can order by: RFC 3339 shape and a real calendar date. */
+export declare function isDateTime(value: unknown): value is string;
+/** `backends/sdcpp-manifest.json`, or throw why it is not one. */
+export declare function parseSdcppManifest(data: unknown): SdcppManifest;
+/** `backends/mlx-manifest.json`, or throw why it is not one. */
+export declare function parseMlxManifest(data: unknown): MlxManifest;
+/** An asset core may download and run: pinned by both `sha256` and `size`. */
+export declare function assetInstallable(asset: {
+    sha256?: string;
+    size?: number;
+}): boolean;
+/** The mirror when the manifest names one, else the upstream release (which never carries `-a<sha>`). */
+export declare function sdcppAssetUrl(manifest: SdcppManifest, asset: SdcppAsset): string;
+export declare function mlxAssetUrl(manifest: MlxManifest, asset: MlxAsset): string;
+/** Which manifest: everything that differs between the two engines. */
+export interface ManifestKind<T> {
+    label: string;
+    url: string;
+    urlEnv: string;
+    parse(data: unknown): T;
+    cacheFile: string;
+}
+export declare function manifestKinds(layout: DataLayout): {
+    'sd-cpp': ManifestKind<SdcppManifest>;
+    'mlx': ManifestKind<MlxManifest>;
+};
+/** What a read found. `source` is `null` exactly when `manifest` is. */
+export interface ManifestRead<T> {
+    manifest: T | null;
+    source: 'remote' | 'cache' | null;
+    /** Milliseconds since the epoch at which the document in hand was fetched. */
+    fetched_at: number | null;
+    /** Why the configured source gave nothing acceptable this time; `null` on a fresh read. */
+    error: string | null;
+}
+export interface EngineManifestSourceDeps {
+    env: Record<string, string | undefined>;
+    /** A `fetch` honouring the request's proxy policy. */
+    fetchFor: (proxy?: ProxyConfig | null) => typeof fetch;
+    /** Reads a `file://` override. */
+    readFile?: (path: string) => Promise<string>;
+    now?: () => number;
+    timeoutMs?: number;
+    log?: (level: 'info' | 'warn', message: string) => void;
+}
+export interface ManifestReadOptions {
+    /** Re-read the source even when memory holds a fresh copy. */
+    force?: boolean;
+    proxy?: ProxyConfig | null;
+}
+export declare class EngineManifestSource<T> {
+    private readonly kind;
+    private readonly deps;
+    /** Only a document the source itself gave; a cache fallback is retried on the next read. */
+    private memory;
+    private inFlight;
+    constructor(kind: ManifestKind<T>, deps: EngineManifestSourceDeps);
+    read(options?: ManifestReadOptions): Promise<ManifestRead<T>>;
+    /** The last accepted document on disk, without touching the source. */
+    cached(): Promise<T | null>;
+    private sourceUrl;
+    private resolve;
+    private fetchText;
+    private readCache;
+    /** Write-then-rename; a failure only costs the offline fallback, so it is logged, not thrown. */
+    private writeCache;
+}

package/dist/engine-builds/manifest.js

@@ -0,0 +1,254 @@
+/**
+ * The two conf manifests the engine-builds module installs from: `backends/sdcpp-manifest.json`
+ * (stable-diffusion.cpp, which the desktop used to read itself) and `backends/mlx-manifest.json`
+ * (the mlx-vlm fork's `mlx-server`). Openspec change `move-sdcpp-mlx-install-to-core`, design D6.
+ *
+ * The source follows the house pattern of `PrismCatalogService` and `cached-document.ts`: conf main
+ * over `fetch` with an 8 s budget and the request's proxy, an `ATOMIC_*_MANIFEST_URL` override that
+ * may be `https://` or `file://` (anything else is refused, never guessed at), memory for an hour,
+ * then the last accepted document on disk. Unlike the PrismML catalog there is no bundled baseline:
+ * without a network nothing can be installed anyway, and a baked-in copy goes stale with every conf
+ * release. No document at all is an answer (`manifest: null` with the reason), not an error.
+ *
+ * Parsing checks the fields of the conf schemas and drops keys it does not know, so an additive conf
+ * change never makes a released core fall back to its cache. An asset without `sha256` or `size` is
+ * kept — the catalog shows it — but `assetInstallable` says no: nothing unverified is executed.
+ */
+import { mkdir, readFile as nodeReadFile, rename, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { withHardTimeout } from '../backend/index.js';
+export const SDCPP_MANIFEST_URL = 'https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/sdcpp-manifest.json';
+export const MLX_MANIFEST_URL = 'https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/mlx-manifest.json';
+export const ENGINE_MANIFEST_TIMEOUT_MS = 8_000;
+/** A fetched manifest is reused for this long unless the caller forces a re-read. */
+export const ENGINE_MANIFEST_TTL_MS = 60 * 60 * 1000;
+export const SDCPP_UPSTREAM_REPO = 'leejet/stable-diffusion.cpp';
+const SDCPP_TAG_RE = /^master-[0-9]+-[0-9a-f]{7}(-a[0-9a-f]{7})?$/;
+const MLX_TAG_RE = /^mlxvlm-macos-arm64-[0-9a-f]{7,40}$/;
+const BACKEND_ID_RE = /^[a-z0-9.-]+$/;
+/** A bare file name: it lands in a download path and a URL. */
+const ASSET_NAME_RE = /^[A-Za-z0-9._-]+\.(zip|tar\.gz)$/;
+const REPO_RE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+const SHA256_RE = /^[0-9a-f]{64}$/;
+/** RFC 3339 with a zone; `Date.parse` alone accepts far more. */
+const DATE_TIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+const ATOMIC_TAG_SUFFIX_RE = /-a[0-9a-f]{7}$/;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** A conf date-time this core can order by: RFC 3339 shape and a real calendar date. */
+export function isDateTime(value) {
+    if (typeof value !== 'string' || !DATE_TIME_RE.test(value))
+        return false;
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms))
+        return false;
+    // `Date.parse('2026-02-30T00:00:00Z')` rolls over to March instead of failing.
+    const [y, m, d] = value.slice(0, 10).split('-').map(Number);
+    const day = new Date(Date.UTC(y, m - 1, d));
+    return day.getUTCFullYear() === y && day.getUTCMonth() === m - 1 && day.getUTCDate() === d;
+}
+function sanitizeAsset(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (typeof raw['backend'] !== 'string' || !BACKEND_ID_RE.test(raw['backend']))
+        return null;
+    if (typeof raw['name'] !== 'string' || !ASSET_NAME_RE.test(raw['name']))
+        return null;
+    const sha256 = raw['sha256'];
+    const size = raw['size'];
+    return {
+        backend: raw['backend'],
+        name: raw['name'],
+        ...(typeof sha256 === 'string' && SHA256_RE.test(sha256) ? { sha256 } : {}),
+        ...(typeof size === 'number' && Number.isSafeInteger(size) && size > 0 ? { size } : {}),
+        ...(raw['companion'] === true ? { companion: true } : {}),
+    };
+}
+/** Assets that parse, one per backend id; `null` when none is usable. */
+function sanitizeAssets(raw) {
+    if (!Array.isArray(raw))
+        throw new Error('the manifest has no assets array');
+    const out = [];
+    const seen = new Set();
+    for (const item of raw) {
+        const asset = sanitizeAsset(item);
+        if (!asset || seen.has(asset.backend))
+            continue;
+        seen.add(asset.backend);
+        out.push(asset);
+    }
+    if (out.length === 0)
+        throw new Error('the manifest lists no usable asset');
+    return out;
+}
+/** `backends/sdcpp-manifest.json`, or throw why it is not one. */
+export function parseSdcppManifest(data) {
+    if (!isRecord(data))
+        throw new Error('the sd.cpp manifest is not an object');
+    const tag = data['tag_name'];
+    if (typeof tag !== 'string' || !SDCPP_TAG_RE.test(tag))
+        throw new Error(`the sd.cpp manifest has no valid tag_name (${JSON.stringify(tag)})`);
+    const assets = sanitizeAssets(data['assets']);
+    const repo = data['upstream_repo'];
+    const base = data['download_base'];
+    const updated = data['updated_at'];
+    return {
+        ...(typeof updated === 'string' ? { updated_at: updated } : {}),
+        ...(typeof repo === 'string' && REPO_RE.test(repo) ? { upstream_repo: repo } : {}),
+        tag_name: tag,
+        ...(typeof base === 'string' && /^https:\/\/\S+$/.test(base)
+            ? { download_base: base.replace(/\/+$/, '') }
+            : {}),
+        assets,
+    };
+}
+/** `backends/mlx-manifest.json`, or throw why it is not one. */
+export function parseMlxManifest(data) {
+    if (!isRecord(data))
+        throw new Error('the MLX manifest is not an object');
+    const tag = data['tag_name'];
+    if (typeof tag !== 'string' || !MLX_TAG_RE.test(tag))
+        throw new Error(`the MLX manifest has no valid tag_name (${JSON.stringify(tag)})`);
+    const repo = data['upstream_repo'];
+    if (typeof repo !== 'string' || !REPO_RE.test(repo))
+        throw new Error(`the MLX manifest has no valid upstream_repo (${JSON.stringify(repo)})`);
+    const published = data['published_at'];
+    // conf's ajv runs without formats (conf ruling 1.2): the date is checked here.
+    if (!isDateTime(published))
+        throw new Error(`the MLX manifest has no valid published_at (${JSON.stringify(published)})`);
+    const assets = sanitizeAssets(data['assets']).map(({ companion: _companion, ...asset }) => asset);
+    return { upstream_repo: repo, tag_name: tag, published_at: published, assets };
+}
+/** An asset core may download and run: pinned by both `sha256` and `size`. */
+export function assetInstallable(asset) {
+    return typeof asset.sha256 === 'string' && typeof asset.size === 'number';
+}
+/** The mirror when the manifest names one, else the upstream release (which never carries `-a<sha>`). */
+export function sdcppAssetUrl(manifest, asset) {
+    if (manifest.download_base)
+        return `${manifest.download_base}/${manifest.tag_name}/${asset.name}`;
+    const repo = manifest.upstream_repo ?? SDCPP_UPSTREAM_REPO;
+    return `https://github.com/${repo}/releases/download/${manifest.tag_name.replace(ATOMIC_TAG_SUFFIX_RE, '')}/${asset.name}`;
+}
+export function mlxAssetUrl(manifest, asset) {
+    return `https://github.com/${manifest.upstream_repo}/releases/download/${manifest.tag_name}/${asset.name}`;
+}
+export function manifestKinds(layout) {
+    return {
+        'sd-cpp': {
+            label: 'sd.cpp manifest',
+            url: SDCPP_MANIFEST_URL,
+            urlEnv: 'ATOMIC_SDCPP_MANIFEST_URL',
+            parse: parseSdcppManifest,
+            cacheFile: join(layout.diffusion.root, 'sdcpp-manifest.cache.json'),
+        },
+        'mlx': {
+            label: 'MLX manifest',
+            url: MLX_MANIFEST_URL,
+            urlEnv: 'ATOMIC_MLX_MANIFEST_URL',
+            parse: parseMlxManifest,
+            cacheFile: join(layout.provider('mlx').root, 'mlx-manifest.cache.json'),
+        },
+    };
+}
+export class EngineManifestSource {
+    kind;
+    deps;
+    /** Only a document the source itself gave; a cache fallback is retried on the next read. */
+    memory = null;
+    inFlight = null;
+    constructor(kind, deps) {
+        this.kind = kind;
+        this.deps = deps;
+    }
+    async read(options = {}) {
+        const now = this.deps.now ?? Date.now;
+        if (!options.force && this.memory && now() - this.memory.fetchedAt < ENGINE_MANIFEST_TTL_MS)
+            return {
+                manifest: this.memory.manifest,
+                source: 'remote',
+                fetched_at: this.memory.fetchedAt,
+                error: null,
+            };
+        if (this.inFlight)
+            return this.inFlight;
+        this.inFlight = this.resolve(options.proxy ?? null).finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    /** The last accepted document on disk, without touching the source. */
+    async cached() {
+        return (await this.readCache())?.manifest ?? null;
+    }
+    sourceUrl() {
+        const override = this.deps.env[this.kind.urlEnv]?.trim();
+        return override ? override : this.kind.url;
+    }
+    async resolve(proxy) {
+        const now = this.deps.now ?? Date.now;
+        const url = this.sourceUrl();
+        let error;
+        try {
+            const manifest = this.kind.parse(JSON.parse(await this.fetchText(url, proxy)));
+            const fetchedAt = now();
+            this.memory = { fetchedAt, manifest };
+            await this.writeCache(manifest, fetchedAt);
+            return { manifest, source: 'remote', fetched_at: fetchedAt, error: null };
+        }
+        catch (e) {
+            error = `${this.kind.label} from ${url}: ${e instanceof Error ? e.message : String(e)}`;
+        }
+        const cached = await this.readCache();
+        this.deps.log?.('warn', `${error}; ${cached ? `using the copy fetched at ${new Date(cached.fetchedAt).toISOString()}` : 'none is cached'}`);
+        if (!cached)
+            return { manifest: null, source: null, fetched_at: null, error };
+        return { manifest: cached.manifest, source: 'cache', fetched_at: cached.fetchedAt, error };
+    }
+    async fetchText(url, proxy) {
+        if (url.startsWith('file://'))
+            return (this.deps.readFile ?? defaultReadFile)(fileURLToPath(url));
+        if (!url.startsWith('https://'))
+            throw new Error('the source is neither file:// nor https://');
+        const timeoutMs = this.deps.timeoutMs ?? ENGINE_MANIFEST_TIMEOUT_MS;
+        const controller = new AbortController();
+        const request = this.deps.fetchFor(proxy)(url, {
+            headers: { 'Accept': 'application/json', 'User-Agent': 'atomic-chat' },
+            signal: controller.signal,
+        });
+        const response = await withHardTimeout(request, timeoutMs, `timed out after ${timeoutMs}ms`).catch((e) => {
+            controller.abort();
+            throw e;
+        });
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status}`);
+        return response.text();
+    }
+    async readCache() {
+        try {
+            const raw = JSON.parse(await (this.deps.readFile ?? defaultReadFile)(this.kind.cacheFile));
+            if (!isRecord(raw) || typeof raw['fetched_at'] !== 'number')
+                return null;
+            return { fetchedAt: raw['fetched_at'], manifest: this.kind.parse(raw['manifest']) };
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Write-then-rename; a failure only costs the offline fallback, so it is logged, not thrown. */
+    async writeCache(manifest, fetchedAt) {
+        const path = this.kind.cacheFile;
+        const temporary = `${path}.tmp-${process.pid}-${fetchedAt}`;
+        try {
+            await mkdir(join(path, '..'), { recursive: true });
+            await writeFile(temporary, JSON.stringify({ fetched_at: fetchedAt, manifest }), 'utf8');
+            await rename(temporary, path);
+        }
+        catch (e) {
+            await rm(temporary, { force: true }).catch(() => { });
+            this.deps.log?.('warn', `Could not cache the ${this.kind.label}: ${String(e)}`);
+        }
+    }
+}
+const defaultReadFile = (path) => nodeReadFile(path, 'utf8');
+//# sourceMappingURL=manifest.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Which of two builds of one engine is newer (design D4). An "update" is only ever a strictly newer
+ * build, so a conf manifest rolled back to an older tag is never offered and never installed over a
+ * newer one.
+ *
+ *   - sd.cpp: the build number `<n>` of `master-<n>-<sha>[-a<sha>]` (what `buildOf` in
+ *     `diffusion/compat.ts` reads); at an equal number the Atomic rebuild (`-a<sha>`) is newer. Two
+ *     rebuilds of one tag are equal: their shas carry no order.
+ *   - MLX: `published_at` of the GitHub release. The tags are commit hashes.
+ *
+ * A build whose order cannot be read (a dev stub, an installer without `mlx-server.json`) is older
+ * than every build whose order can, so any verified build replaces it.
+ */
+import type { EngineBuildId } from '../contracts/index.js';
+export interface OrderedBuild {
+    tag: string;
+    /** MLX only. */
+    published_at?: string | null;
+}
+/** `[build number, 1 for an Atomic rebuild]`, or `null` for a tag without a build number. */
+export declare function sdcppBuildKey(tag: string): [number, number] | null;
+/** Negative when `a` is older, positive when newer, zero when neither is. */
+export declare function compareBuilds(engine: EngineBuildId, a: OrderedBuild, b: OrderedBuild): number;
+export declare function isNewerBuild(engine: EngineBuildId, candidate: OrderedBuild, than: OrderedBuild): boolean;

package/dist/engine-builds/order.js

@@ -0,0 +1,44 @@
+/**
+ * Which of two builds of one engine is newer (design D4). An "update" is only ever a strictly newer
+ * build, so a conf manifest rolled back to an older tag is never offered and never installed over a
+ * newer one.
+ *
+ *   - sd.cpp: the build number `<n>` of `master-<n>-<sha>[-a<sha>]` (what `buildOf` in
+ *     `diffusion/compat.ts` reads); at an equal number the Atomic rebuild (`-a<sha>`) is newer. Two
+ *     rebuilds of one tag are equal: their shas carry no order.
+ *   - MLX: `published_at` of the GitHub release. The tags are commit hashes.
+ *
+ * A build whose order cannot be read (a dev stub, an installer without `mlx-server.json`) is older
+ * than every build whose order can, so any verified build replaces it.
+ */
+import { isDateTime } from './manifest.js';
+/** `[build number, 1 for an Atomic rebuild]`, or `null` for a tag without a build number. */
+export function sdcppBuildKey(tag) {
+    const match = /^master-(\d+)-[0-9a-z]+(-a[0-9a-f]+)?$/.exec(tag);
+    if (!match)
+        return null;
+    return [Number(match[1]), match[2] ? 1 : 0];
+}
+function mlxKey(build) {
+    return isDateTime(build.published_at) ? [Date.parse(build.published_at)] : null;
+}
+function compareKeys(a, b) {
+    if (a === null || b === null)
+        return (a === null ? 0 : 1) - (b === null ? 0 : 1);
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const diff = (a[i] ?? 0) - (b[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+/** Negative when `a` is older, positive when newer, zero when neither is. */
+export function compareBuilds(engine, a, b) {
+    return engine === 'sd-cpp'
+        ? compareKeys(sdcppBuildKey(a.tag), sdcppBuildKey(b.tag))
+        : compareKeys(mlxKey(a), mlxKey(b));
+}
+export function isNewerBuild(engine, candidate, than) {
+    return compareBuilds(engine, candidate, than) > 0;
+}
+//# sourceMappingURL=order.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/engine-builds/order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAQ1C,6FAA6F;AAC7F,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,wCAAwC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,SAAS,MAAM,CAAC,KAAmB;IACjC,OAAO,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACjF,CAAC;AAED,SAAS,WAAW,CAAC,CAA2B,EAAE,CAA2B;IAC3E,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QACtC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;IAC7B,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,CAAe,EAAE,CAAe;IACnF,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,SAAuB,EAAE,IAAkB;IAC7F,OAAO,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;AACnD,CAAC"}

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

@@ -0,0 +1,123 @@
+/**
+ * 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 type { DiffusionBackend } from '../contracts/index.js';
+import type { HardwareFacts } from '../hardware/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 declare const LINUX_VULKAN_MIN_VRAM_MIB: number;
+export type DiffusionHostOs = 'macos' | 'windows' | 'linux';
+export type DiffusionHostArch = 'arm64' | 'x64';
+export type DiffusionBackendSelectionInput = {
+    os: DiffusionHostOs;
+    arch: DiffusionHostArch;
+    features: {
+        cuda12?: boolean;
+        cuda13?: boolean;
+        vulkan?: boolean;
+        rocm?: boolean;
+    };
+    gpus: {
+        vendor?: string;
+        totalMemoryMib?: number;
+    }[];
+    /** Backend ids the manifest lists (companions included or not; they never match). */
+    available: string[];
+};
+/**
+ * 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 declare function diffusionBackendLadder(input: DiffusionBackendSelectionInput): string[];
+/**
+ * The backend id to install, or `null` when this host cannot run any build
+ * the manifest ships: the top of `diffusionBackendLadder`.
+ */
+export declare function selectDiffusionBackend(input: DiffusionBackendSelectionInput): string | null;
+/** The companion archive a backend needs unpacked beside it, if any. */
+export declare function companionFor(backendId: string): 'win-cudart-cu12' | null;
+/** The compute backend a manifest id was built for, for the install record. */
+export declare function backendKindOf(backendId: string): DiffusionBackend;
+/** What the ladder reads, from the core's own facts (the override applied). */
+export declare function sdcppHostOf(facts: Pick<HardwareFacts, 'osType' | 'arch' | 'cpuExtensions' | 'gpus'>): Omit<DiffusionBackendSelectionInput, 'available' | 'os'> & {
+    os: string;
+};
+/** The key a failed probe is remembered under: a new tag gets a fresh try. */
+export declare const failedBackendKey: (tag: string, backendId: string) => string;
+export interface SdcppHostChoice {
+    /** What this host would install, best first, without the builds that already failed on this tag. */
+    ladder: string[];
+    backend_id: string | null;
+    /** Why `backend_id` is `null`. */
+    reason: string | null;
+}
+/**
+ * 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 declare function sdcppHostChoice(host: Omit<DiffusionBackendSelectionInput, 'available' | 'os'> & {
+    os: string;
+}, manifest: {
+    tag_name: string;
+    assets: readonly {
+        backend: string;
+        companion?: boolean;
+    }[];
+}, failed: ReadonlySet<string>): SdcppHostChoice;
+/** The app kept "a few tags' worth of rungs"; older entries name tags no manifest serves. */
+export declare const FAILED_BACKENDS_LIMIT = 16;
+/** `<tag>/<backend_id>` pairs that failed their probe on this machine; empty when unreadable. */
+export declare function readFailedBackends(file: string): Promise<Set<string>>;
+/** Remember one more failed pair, newest last; a failed write only costs a repeated download. */
+export declare function rememberFailedBackend(file: string, tag: string, backendId: string): Promise<void>;
+/** MLX ships one build, for Apple Silicon; the manifest only has to list it. */
+export declare function mlxHostChoice(host: {
+    os: string;
+    arch: string;
+}, manifest: {
+    assets: readonly {
+        backend: string;
+    }[];
+} | null): {
+    backend_id: string | null;
+    reason: string | null;
+};