@atomic-chat/core 0.5.1

package/dist/backend/installed/installed.js

@@ -0,0 +1,209 @@
+/**
+ * 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 { join } from 'node:path';
+import { llamaServerExeName } from '../../config/index.js';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { parseRustU32, stripBom } from '../version.js';
+/**
+ * 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 function installedBackendsFromEntries(entries) {
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.hasExe)
+            continue;
+        const mtime = entry.mtimeSeconds;
+        const order = mtime !== undefined && mtime > 0 ? (parseRustU32(String(Math.floor(mtime))) ?? 0) : 0;
+        out.push({ version: stripBom(entry.version), backend: stripBom(entry.backend), order });
+    }
+    return out;
+}
+/** `<backendsDir>/<version>/<backend>`, both ids BOM-stripped. */
+export function getBackendDir(paths, backend, version) {
+    return join(paths.backendsDir, stripBom(version), stripBom(backend));
+}
+/** `[build/bin/<exe>, <exe>]` under the pack directory, per platform. */
+export function backendExePathCandidates(paths, backend, version, platform) {
+    const dir = getBackendDir(paths, backend, version);
+    const exe = llamaServerExeName(platform);
+    return [join(dir, 'build', 'bin', exe), join(dir, exe)];
+}
+/**
+ * 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 async function getBackendExePath(paths, backend, version, platform, exists) {
+    const [buildExe, flatExe] = backendExePathCandidates(paths, backend, version, platform);
+    return (await exists(join(getBackendDir(paths, backend, version), 'build'))) ? buildExe : flatExe;
+}
+/** Rust `is_backend_installed`: either candidate executable exists. */
+export async function isBackendInstalled(paths, backend, version, platform, exists) {
+    for (const candidate of backendExePathCandidates(paths, backend, version, platform)) {
+        if (await exists(candidate))
+            return true;
+    }
+    return false;
+}
+/**
+ * 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 function listInstalledBackendPacks(paths, installed, currentVersionBackend) {
+    const current = stripBom(currentVersionBackend);
+    return installed.map((entry) => {
+        const version = stripBom(entry.version);
+        const backend = stripBom(entry.backend);
+        return {
+            version,
+            backend,
+            path: join(paths.backendsDir, version, backend),
+            active: `${version}/${backend}` === current,
+        };
+    });
+}
+/**
+ * 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 function deletableBackendPack(currentVersionBackend, version, backend) {
+    const cleanVersion = stripBom(version);
+    const cleanBackend = stripBom(backend);
+    if (!cleanVersion ||
+        !cleanBackend ||
+        /[/\\]/.test(cleanVersion) ||
+        /[/\\]/.test(cleanBackend) ||
+        /^\.+$/.test(cleanVersion) ||
+        /^\.+$/.test(cleanBackend)) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', `Invalid backend pack: '${version}/${backend}'`);
+    }
+    if (`${cleanVersion}/${cleanBackend}` === stripBom(currentVersionBackend)) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'Cannot remove the backend that is currently selected');
+    }
+    return { version: cleanVersion, backend: cleanBackend };
+}
+/**
+ * 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 function backendTypeEquivalents(backendType) {
+    const bt = stripBom(backendType);
+    const ids = new Set([bt]);
+    const pairs = [
+        ['linux-vulkan-x64', 'ubuntu-vulkan-x64'],
+        ['linux-vulkan-arm64', 'ubuntu-vulkan-arm64'],
+        ['linux-cpu-x64', 'ubuntu-x64'],
+        ['linux-cpu-arm64', 'ubuntu-arm64'],
+    ];
+    for (const [linux, ubuntu] of pairs) {
+        if (bt === linux)
+            ids.add(ubuntu);
+        if (bt === ubuntu)
+            ids.add(linux);
+    }
+    return ids;
+}
+/**
+ * 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 function findCompatibleInstalledBackend(backendType, installed) {
+    const equivalents = backendTypeEquivalents(backendType);
+    const sameType = installed.filter((b) => equivalents.has(stripBom(b.backend)));
+    if (sameType.length === 0)
+        return null;
+    return sameType.sort((a, b) => (b.order ?? 0) - (a.order ?? 0))[0] ?? 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 function mergeBackendOptions(tiers, recommended) {
+    const merged = [];
+    const seen = new Set();
+    for (const tier of tiers) {
+        for (const option of tier) {
+            const value = stripBom(option.value);
+            if (!value || seen.has(value))
+                continue;
+            seen.add(value);
+            merged.push({ value, name: option.name });
+        }
+    }
+    const recommendedValue = recommended ? stripBom(recommended.value) : '';
+    if (recommended && recommendedValue && !seen.has(recommendedValue)) {
+        merged.unshift({ value: recommendedValue, name: recommended.name });
+    }
+    return merged;
+}
+/**
+ * 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 function cudaRuntimeLibName(osType, version) {
+    const major = parseRustU32(version.split('.')[0] ?? '') ?? 0;
+    const key = `${osType}:${major}`;
+    switch (key) {
+        case 'windows:11':
+            return 'cudart64_110.dll';
+        case 'windows:12':
+            return 'cudart64_12.dll';
+        case 'windows:13':
+            return 'cudart64_13.dll';
+        case 'linux:11':
+            return 'libcudart.so.11.0';
+        case 'linux:12':
+            return 'libcudart.so.12';
+        case 'linux:13':
+            return 'libcudart.so.13';
+        default:
+            return null;
+    }
+}
+/**
+ * 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 async function isCudaInstalled(input) {
+    const libName = cudaRuntimeLibName(input.osType, input.version);
+    if (!libName)
+        return false;
+    const targetDir = join(input.backendDir, 'build', 'bin');
+    const newPath = join(targetDir, libName);
+    if (await input.fs.exists(newPath))
+        return true;
+    const oldPath = join(input.legacyLibDir, libName);
+    if (!(await input.fs.exists(oldPath)))
+        return false;
+    if (!(await input.fs.exists(targetDir))) {
+        try {
+            await input.fs.mkdir(targetDir);
+        }
+        catch (err) {
+            throw new AtomicCoreError('IO_ERROR', `Failed to create target directory: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    try {
+        await input.fs.rename(oldPath, newPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=installed.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * The filesystem half of `backend/`: what is actually installed under
+ * `<data>/<provider>/backends/<version>/<backend>/`.
+ *
+ * `discoverBackendBinary` reproduces `discover_llamacpp_binary_in` (cli/mod.rs:198) exactly, because
+ * `serve` without `--bin` must pick the same executable the Rust CLI picks: version directories are
+ * ordered by parsed build number (so `b10018-1.3.0` outranks `b9000`, which plain string sort gets
+ * wrong), ties broken by name descending, backends inside a version by name ascending, and each pack
+ * is probed at `build/bin/<exe>` before the flat `<exe>`.
+ */
+import type { LocalProviderId } from '../../contracts/index.js';
+import type { DataLayout } from '../../config/index.js';
+import type { BackendVersion } from '../types.js';
+export interface DiscoveredBackendBinary {
+    path: string;
+    /** `<version>/<backend>`, the form the argument builder parses for feature gates. */
+    version_backend: string;
+    version: string;
+    backend: string;
+}
+/** Version directories newest first: build number descending, then raw name descending. */
+export declare function orderVersionDirs(names: readonly string[]): string[];
+/**
+ * Every installed pack, in directory order with `order` = install mtime, exactly as Rust
+ * `get_local_installed_backends` reports it. Callers that need a ranking sort it themselves.
+ */
+export declare function scanInstalledBackends(layout: DataLayout, provider: LocalProviderId, platform?: NodeJS.Platform): Promise<BackendVersion[]>;
+/** The newest usable `llama-server` in the data folder, or `undefined` when none is installed. */
+export declare function discoverBackendBinary(layout: DataLayout, provider?: LocalProviderId, platform?: NodeJS.Platform): Promise<DiscoveredBackendBinary | undefined>;
+/**
+ * Recover `<version>/<backend>` from a hand-supplied `--bin` path that still sits in the standard
+ * layout (`version_backend_from_bin_path`, cli/mod.rs). A binary from anywhere else has no tag, and
+ * the caller must fall back to a neutral placeholder rather than guess a feature set.
+ */
+export declare function versionBackendFromBinPath(binPath: string): string | undefined;
+/** Path of a specific pack's executable, or `undefined` when that pack is not installed. */
+export declare function resolveBackendExe(layout: DataLayout, provider: LocalProviderId, version: string, backend: string, platform?: NodeJS.Platform): Promise<string | undefined>;
+/** Directory a pack lives in, for deletion and disk accounting. */
+export declare function backendPackDir(layout: DataLayout, provider: LocalProviderId, version: string, backend: string): string;

package/dist/backend/installed/scan.js

@@ -0,0 +1,105 @@
+/**
+ * The filesystem half of `backend/`: what is actually installed under
+ * `<data>/<provider>/backends/<version>/<backend>/`.
+ *
+ * `discoverBackendBinary` reproduces `discover_llamacpp_binary_in` (cli/mod.rs:198) exactly, because
+ * `serve` without `--bin` must pick the same executable the Rust CLI picks: version directories are
+ * ordered by parsed build number (so `b10018-1.3.0` outranks `b9000`, which plain string sort gets
+ * wrong), ties broken by name descending, backends inside a version by name ascending, and each pack
+ * is probed at `build/bin/<exe>` before the flat `<exe>`.
+ */
+import { readdir, stat } from 'node:fs/promises';
+import { join, sep } from 'node:path';
+import { backendExeCandidates, llamaServerExeName } from '../../config/index.js';
+import { installedBackendsFromEntries } from './installed.js';
+// Two build-number parsers exist on purpose: `version.ts` has the app's strict `^b(\d+)$` one, and
+// this is the Rust `ArgumentBuilder::parse_build_number`, which also reads the unified fork tag
+// `b10018-1.3.0`. Discovery must use the lenient one, or the fork's builds sort last.
+import { parseBuildNumber as parseLenientBuildNumber } from '../../runtime/llamacpp/args.js';
+import { stripBom } from '../version.js';
+const dirNames = async (dir) => {
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+};
+const exists = (path) => stat(path)
+    .then(() => true)
+    .catch(() => false);
+/** Version directories newest first: build number descending, then raw name descending. */
+export function orderVersionDirs(names) {
+    return [...names].sort((a, b) => {
+        const ba = parseLenientBuildNumber(a);
+        const bb = parseLenientBuildNumber(b);
+        if (ba !== bb)
+            return (bb ?? -1) - (ba ?? -1);
+        return a < b ? 1 : a > b ? -1 : 0;
+    });
+}
+/**
+ * Every installed pack, in directory order with `order` = install mtime, exactly as Rust
+ * `get_local_installed_backends` reports it. Callers that need a ranking sort it themselves.
+ */
+export async function scanInstalledBackends(layout, provider, platform = process.platform) {
+    const paths = layout.provider(provider);
+    const exe = llamaServerExeName(platform);
+    const entries = [];
+    for (const version of await dirNames(paths.backendsDir)) {
+        for (const backend of await dirNames(join(paths.backendsDir, version))) {
+            const candidates = backendExeCandidates(paths, version, backend, exe);
+            let hasExe = false;
+            let mtimeSeconds = 0;
+            for (const candidate of candidates) {
+                const s = await stat(candidate).catch(() => undefined);
+                if (s) {
+                    hasExe = true;
+                    mtimeSeconds = Math.floor(s.mtimeMs / 1000);
+                    break;
+                }
+            }
+            entries.push({ version: stripBom(version), backend: stripBom(backend), hasExe, mtimeSeconds });
+        }
+    }
+    return installedBackendsFromEntries(entries);
+}
+/** The newest usable `llama-server` in the data folder, or `undefined` when none is installed. */
+export async function discoverBackendBinary(layout, provider = 'llamacpp-upstream', platform = process.platform) {
+    const paths = layout.provider(provider);
+    const exe = llamaServerExeName(platform);
+    for (const version of orderVersionDirs(await dirNames(paths.backendsDir))) {
+        for (const backend of (await dirNames(join(paths.backendsDir, version))).sort()) {
+            for (const candidate of backendExeCandidates(paths, version, backend, exe)) {
+                if (await exists(candidate))
+                    return { path: candidate, version_backend: `${version}/${backend}`, version, backend };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Recover `<version>/<backend>` from a hand-supplied `--bin` path that still sits in the standard
+ * layout (`version_backend_from_bin_path`, cli/mod.rs). A binary from anywhere else has no tag, and
+ * the caller must fall back to a neutral placeholder rather than guess a feature set.
+ */
+export function versionBackendFromBinPath(binPath) {
+    const parts = binPath.split(/[\\/]/).filter(Boolean);
+    const backendsAt = parts.lastIndexOf('backends');
+    if (backendsAt < 0 || parts.length < backendsAt + 3)
+        return undefined;
+    const version = parts[backendsAt + 1];
+    const backend = parts[backendsAt + 2];
+    if (!version || !backend)
+        return undefined;
+    return `${version}/${backend}`;
+}
+/** Path of a specific pack's executable, or `undefined` when that pack is not installed. */
+export async function resolveBackendExe(layout, provider, version, backend, platform = process.platform) {
+    const candidates = backendExeCandidates(layout.provider(provider), stripBom(version), stripBom(backend), llamaServerExeName(platform));
+    for (const candidate of candidates)
+        if (await exists(candidate))
+            return candidate;
+    return undefined;
+}
+/** Directory a pack lives in, for deletion and disk accounting. */
+export function backendPackDir(layout, provider, version, backend) {
+    return [layout.provider(provider).backendsDir, stripBom(version), stripBom(backend)].join(sep);
+}
+//# sourceMappingURL=scan.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** The optimal-backend cache: pure record policy and its on-disk store. */
+export * from './optimal-cache.js';
+export * from './optimal-store.js';

package/dist/backend/optimal/index.js

@@ -0,0 +1,4 @@
+/** The optimal-backend cache: pure record policy and its on-disk store. */
+export * from './optimal-cache.js';
+export * from './optimal-store.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/optimal/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/dist/backend/optimal/optimal-cache.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The optimal-backend cache record and the recheck / refresh decisions around it. Port of
+ * `getCachedOptimalBackend`, `persistOptimalBackendCache`, `resolveConcreteOptimalBackend`,
+ * `refreshOptimalBackendCache` and `recheckOptimalBackend` from
+ * `extensions/llamacpp-upstream-extension/src/index.ts`, without the storage, events and timeouts.
+ *
+ * The app keeps the record in `localStorage[OPTIMAL_BACKEND_CACHE_KEY]`; the core keeps it in
+ * `<data>/atomic-core/optimal-backend.json` (`DataLayout.core.optimalBackend`). Same JSON either way.
+ *
+ * What the caller does around these functions (the entangled halves left in the app):
+ *   - skips both flows entirely on macOS (there are no GPU tiers to recommend);
+ *   - runs `detectIdealBackendType` under a 20 s timeout, mapping a timeout to `detection-failed`;
+ *   - on `detection_failed` throws the `BACKEND_DETECTION_FAILED` sentinel (the UI matches its
+ *     message) and leaves the record and any prior recommendation untouched;
+ *   - persists `record`, and for `recheckOptimalBackend` writes / removes
+ *     `BETTER_BACKEND_RECOMMENDATION_KEY` and emits `onBetterBackendDetected` with `payload`.
+ */
+import type { BackendRecommendation, BackendVersion, IdealBackendResult, OptimalBackendCacheRecord } from '../types.js';
+export declare const OPTIMAL_BACKEND_CACHE_KEY = "atomic_llamacpp_upstream_optimal_backend_v1";
+export declare const OPTIMAL_BACKEND_PROVIDER = "llamacpp-upstream";
+/** Legacy recommendation key the `useBackendUpdater` mount path still reads. */
+export declare const BETTER_BACKEND_RECOMMENDATION_KEY = "llama_cpp_better_backend_recommendation";
+/**
+ * Sentinel `Error.message` for "detection could not complete — keep the current backend"
+ * (ATO-161). The web-app handler matches the literal value; keep the two in sync.
+ */
+export declare const BACKEND_DETECTION_FAILED = "BACKEND_DETECTION_FAILED";
+export type CompletedDetection = Exclude<IdealBackendResult, {
+    kind: 'detection-failed';
+}>;
+/**
+ * Validate a stored record. Anything with the wrong schema, provider, a non-finite or negative
+ * `detectedAt`, missing strings, a `gpu` record whose `recommendedBackend` is not a concrete
+ * `<tag>/<idealBackendId>`, or a `cpu-optimal` record carrying GPU fields is `null` (ignored).
+ */
+export declare function parseOptimalBackendCache(raw: string | null | undefined, provider?: 'llamacpp-upstream' | 'llamacpp'): OptimalBackendCacheRecord | null;
+/** The record to persist for a completed detection (`persistOptimalBackendCache` minus the write). */
+export declare function buildOptimalBackendCacheRecord(detection: CompletedDetection, currentBackend: string, recommendedBackend: string | null | undefined, now: number): OptimalBackendCacheRecord;
+export interface ConcreteBackendResolver {
+    /** The hardware-gated catalog (remote + local). The caller bounds it (the app: 20 s → `[]`). */
+    listSupportedBackends: () => Promise<BackendVersion[]>;
+    /** The remote catalog alone, for `resolveLatestVersionBackend`. Bounded likewise (20 s → `[]`). */
+    fetchRemoteBackends: () => Promise<BackendVersion[]>;
+    onWarn?: (message: string) => void;
+}
+/**
+ * Concrete `<tag>/<backend>` for the detected ideal type: newest catalog entry of that type, else the
+ * newest remote asset (exact or family match), else the current backend's tag with the ideal type
+ * (so an in-family migration such as CUDA 13.1 → 13.3 still gets a target), else `null` when there is
+ * no current tag to borrow.
+ */
+export declare function resolveConcreteOptimalBackend(idealType: string, currentBackend: string, deps: ConcreteBackendResolver, operation?: string): Promise<string | null>;
+export type RefreshOutcome = {
+    outcome: 'detection_failed';
+} | {
+    outcome: 'cached';
+    record: OptimalBackendCacheRecord;
+};
+/**
+ * Silent cache refresh (startup coordinator, once per launch). Never emits a recommendation. A
+ * failed concrete resolution still caches the `gpu` verdict, just without `recommendedBackend`.
+ */
+export declare function refreshOptimalBackendCache(detection: IdealBackendResult, currentBackend: string, resolveConcrete: (idealType: string, currentBackend: string) => Promise<string | null>, now: number): Promise<RefreshOutcome>;
+/**
+ * Why `recheckOptimalBackend` did or did not produce a recommendation. The app collapsed four of
+ * these into `null` and telemetry could not tell `already_optimal` (healthy) from the rest.
+ */
+export type RecheckOutcome = {
+    outcome: 'detection_failed';
+} | {
+    outcome: 'cpu_optimal';
+    record: OptimalBackendCacheRecord;
+} | {
+    outcome: 'already_optimal';
+    record: OptimalBackendCacheRecord;
+} | {
+    outcome: 'no_catalog_entry';
+    record: OptimalBackendCacheRecord;
+} | {
+    outcome: 'recommend';
+    record: OptimalBackendCacheRecord;
+    payload: BackendRecommendation;
+};
+/**
+ * Manual "Find optimal backend" / onboarding recheck. Same category *and* same backend type as the
+ * current build is `already_optimal` without resolving anything; otherwise the concrete target is
+ * resolved and compared — equal to current is `already_optimal`, nothing resolvable is
+ * `no_catalog_entry`, else `recommend` with the event payload.
+ */
+export declare function recheckOptimalBackend(detection: IdealBackendResult, currentBackend: string, resolveConcrete: (idealType: string, currentBackend: string) => Promise<string | null>, now: number): Promise<RecheckOutcome>;