@atomic-chat/core 0.5.1 → 0.13.2

package/dist/engines/llamacpp.d.ts

@@ -0,0 +1,71 @@
+/**
+ * One llama.cpp provider as an engine of the `/engines` layer (change `unify-engine-lifecycle`, spec
+ * `engine-lifecycle`, "Обновление llama.cpp применяет core"; design D3, D5). The desktop's three
+ * extensions used to apply an update themselves; the core does it now, in this order:
+ *
+ *   1. install the target pack, under the caller's task id — before the lock: the download is long
+ *      and the models keep running meanwhile;
+ *   2. in the load queue's turn, write `version_backend` (clients get `settings:changed`), so the
+ *      next load, the desktop's automatic reload included, starts from the new pack;
+ *   3. unload the provider's sessions, as an ordinary unload would;
+ *   4. `engine:changed {reason: update}`.
+ *
+ * Nothing is deleted: the old build stays installed, to switch back to or to remove from the list of
+ * builds (a decision during the acceptance of the change, which replaced the retirement of design
+ * D5). `retired` and `kept_in_use` are therefore always empty.
+ *
+ * A failure or a cancel before step 2 changes nothing: the pack moves into place only once complete,
+ * and the setting still names the old one. The whole update holds the provider's operation slot, so
+ * a second update, an activation or a removal of the same provider is `ENGINE_INSTALL_IN_PROGRESS`.
+ */
+import type { CoreEvents, EngineActivateResult, EngineBuildDeleteResult, EngineUpdateRequest, EngineUpdateResult, EngineVersions, EngineVersionsRequest, LlamacppProviderId } from '../contracts/index.js';
+import type { BackendAdvisor, BackendService } from '../backend/index.js';
+import type { EngineHandle } from './service.js';
+export interface LlamacppEngineDeps {
+    engine: LlamacppProviderId;
+    backends: Pick<BackendService, 'operate' | 'install' | 'exclusive' | 'listInstalled' | 'bundledPack' | 'busyChecker' | 'remove'>;
+    advisor: Pick<BackendAdvisor, 'catalog' | 'checkUpdates'>;
+    /** The provider's `version_backend` in the core's settings. */
+    currentVersionBackend: () => string;
+    /** Write `version_backend`; the settings store publishes `settings:changed`. */
+    selectVersionBackend: (versionBackend: string) => Promise<void>;
+    /** Unload every session of this provider through the facade, the way a client's unload goes. */
+    unloadSessions: () => Promise<void>;
+    emit: (name: 'engine:changed', payload: CoreEvents['engine:changed']) => void;
+    /** A pack was downloaded: the decision and embedding models may now find a build to run on. */
+    onInstalled?: (installed: boolean) => void;
+    log?: (level: 'info' | 'warn', message: string) => void;
+}
+export declare class LlamacppEngine implements EngineHandle {
+    private readonly deps;
+    readonly engine: LlamacppProviderId;
+    readonly kind: "llamacpp";
+    constructor(deps: LlamacppEngineDeps);
+    versions(request: EngineVersionsRequest): Promise<EngineVersions>;
+    /** `POST /engines/:engine/update`. Answers once applied, which can take as long as the download. */
+    update(request: EngineUpdateRequest): Promise<EngineUpdateResult>;
+    private updateHeld;
+    /**
+     * `POST /engines/:engine/builds/:version/:variant/activate` (design D11): steps 2, 3 and 4 of an
+     * update — write `version_backend` and unload the provider's sessions in the load queue's turn, then
+     * `engine:changed {reason: activate}` — with nothing downloaded and nothing removed. Under the same
+     * operation slot as an update, so the two never race on the setting.
+     */
+    activate(version: string, variant: string): Promise<EngineActivateResult>;
+    /**
+     * `DELETE /engines/:engine/builds/:version/:variant`: in the load queue's turn, so it waits for a load
+     * in flight; never the active pack (`INVALID_REQUEST`, `active`), the installer's (`bundled`) or one
+     * something runs from (`BACKEND_IN_USE`).
+     */
+    remove(version: string, variant: string): Promise<EngineBuildDeleteResult>;
+    /**
+     * The build to move to: the offer of the update check; an explicit `<version>/<variant>` (no family
+     * check: the client chose); or only a variant — the newest of it in the provider's catalog.
+     */
+    private target;
+    /**
+     * The switch is already written when this runs: a session that does not stop keeps running from its
+     * old pack, which stays on disk, and the answer still says the update applied.
+     */
+    private unload;
+}

package/dist/engines/llamacpp.js

@@ -0,0 +1,176 @@
+/**
+ * One llama.cpp provider as an engine of the `/engines` layer (change `unify-engine-lifecycle`, spec
+ * `engine-lifecycle`, "Обновление llama.cpp применяет core"; design D3, D5). The desktop's three
+ * extensions used to apply an update themselves; the core does it now, in this order:
+ *
+ *   1. install the target pack, under the caller's task id — before the lock: the download is long
+ *      and the models keep running meanwhile;
+ *   2. in the load queue's turn, write `version_backend` (clients get `settings:changed`), so the
+ *      next load, the desktop's automatic reload included, starts from the new pack;
+ *   3. unload the provider's sessions, as an ordinary unload would;
+ *   4. `engine:changed {reason: update}`.
+ *
+ * Nothing is deleted: the old build stays installed, to switch back to or to remove from the list of
+ * builds (a decision during the acceptance of the change, which replaced the retirement of design
+ * D5). `retired` and `kept_in_use` are therefore always empty.
+ *
+ * A failure or a cancel before step 2 changes nothing: the pack moves into place only once complete,
+ * and the setting still names the old one. The whole update holds the provider's operation slot, so
+ * a second update, an activation or a removal of the same provider is `ENGINE_INSTALL_IN_PROGRESS`.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { DOWNLOAD_CANCELLED } from '../downloads/index.js';
+import { llamacppVersions } from './versions.js';
+function parseKey(versionBackend) {
+    const [version, variant, ...rest] = versionBackend.trim().split('/');
+    if (!version || !variant || rest.length > 0 || version === 'latest' || version === 'none')
+        return null;
+    return { version, variant };
+}
+/**
+ * The downloader speaks in message strings; this surface speaks in codes, like `engine-builds`. The
+ * message stays as it was: the app reads the disk tags (`[disk_full]` …) out of it.
+ */
+function installError(error) {
+    if (error instanceof AtomicCoreError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    if (message === DOWNLOAD_CANCELLED)
+        return new AtomicCoreError('CANCELLED', 'The engine update was cancelled.');
+    return new AtomicCoreError('ENGINE_INSTALL_FAILED', message);
+}
+export class LlamacppEngine {
+    deps;
+    engine;
+    kind = 'llamacpp';
+    constructor(deps) {
+        this.deps = deps;
+        this.engine = deps.engine;
+    }
+    versions(request) {
+        const { deps } = this;
+        // One look at what runs, for every pack of this answer.
+        let busy;
+        return llamacppVersions({
+            engine: deps.engine,
+            current: deps.currentVersionBackend,
+            checkUpdates: (r) => deps.advisor.checkUpdates(r),
+            catalog: (r) => deps.advisor.catalog(r),
+            listInstalled: (current) => deps.backends.listInstalled(current),
+            bundledPack: () => deps.backends.bundledPack(),
+            inUse: async (version, backend) => (await (busy ??= deps.backends.busyChecker()))(version, backend),
+        }, request);
+    }
+    /** `POST /engines/:engine/update`. Answers once applied, which can take as long as the download. */
+    async update(request) {
+        if (!('task_id' in request))
+            throw new AtomicCoreError('INVALID_ARGUMENT', `An update of ${this.engine} needs task_id.`);
+        return this.deps.backends.operate('update', (operation) => this.updateHeld(request, operation));
+    }
+    async updateHeld(request, operation) {
+        const active = parseKey(this.deps.currentVersionBackend());
+        const unchanged = (reason) => ({
+            updated: false,
+            reason,
+            active,
+            retired: [],
+            kept_in_use: [],
+        });
+        const target = await this.target(request);
+        if (target === null)
+            return unchanged('no-update');
+        if (active !== null && active.version === target.version && active.variant === target.variant)
+            return unchanged('already-active');
+        let installed;
+        try {
+            installed = (await this.deps.backends.install(target.version, target.variant, {
+                taskId: request.task_id,
+                ...(request.force !== undefined ? { force: request.force } : {}),
+                ...(request.proxy !== undefined ? { proxy: request.proxy } : {}),
+                operation,
+            })).installed;
+        }
+        catch (error) {
+            throw installError(error);
+        }
+        this.deps.onInstalled?.(installed);
+        await this.deps.backends.exclusive(async () => {
+            await this.deps.selectVersionBackend(`${target.version}/${target.variant}`);
+            await this.unload();
+        });
+        this.deps.emit('engine:changed', { engine: this.engine, reason: 'update' });
+        return { updated: true, active: target, retired: [], kept_in_use: [] };
+    }
+    /**
+     * `POST /engines/:engine/builds/:version/:variant/activate` (design D11): steps 2, 3 and 4 of an
+     * update — write `version_backend` and unload the provider's sessions in the load queue's turn, then
+     * `engine:changed {reason: activate}` — with nothing downloaded and nothing removed. Under the same
+     * operation slot as an update, so the two never race on the setting.
+     */
+    activate(version, variant) {
+        const target = { version, variant };
+        return this.deps.backends.operate('activate', async () => {
+            const active = parseKey(this.deps.currentVersionBackend());
+            if (active !== null && active.version === version && active.variant === variant)
+                return { activated: false, reason: 'already-active', active: target };
+            const packs = await this.deps.backends.listInstalled();
+            if (!packs.some((pack) => pack.version === version && pack.backend === variant))
+                throw new AtomicCoreError('INVALID_REQUEST', `${version}/${variant} is not installed.`, 'not-installed');
+            await this.deps.backends.exclusive(async () => {
+                await this.deps.selectVersionBackend(`${version}/${variant}`);
+                await this.unload();
+            });
+            this.deps.emit('engine:changed', { engine: this.engine, reason: 'activate' });
+            return { activated: true, active: target };
+        });
+    }
+    /**
+     * `DELETE /engines/:engine/builds/:version/:variant`: in the load queue's turn, so it waits for a load
+     * in flight; never the active pack (`INVALID_REQUEST`, `active`), the installer's (`bundled`) or one
+     * something runs from (`BACKEND_IN_USE`).
+     */
+    async remove(version, variant) {
+        // `engine:changed {reason: uninstall}` comes from the backend service, for this route and `/backends`.
+        const removed = await this.deps.backends.remove(version, variant, this.deps.currentVersionBackend, {
+            refuseActiveAs: 'INVALID_REQUEST',
+        });
+        return { removed };
+    }
+    /**
+     * The build to move to: the offer of the update check; an explicit `<version>/<variant>` (no family
+     * check: the client chose); or only a variant — the newest of it in the provider's catalog.
+     */
+    async target(request) {
+        const current = this.deps.currentVersionBackend().trim();
+        const common = {
+            force: request.force ?? false,
+            app_version: request.app_version ?? null,
+            proxy: request.proxy ?? null,
+        };
+        if (request.target === undefined) {
+            const check = await this.deps.advisor.checkUpdates({ current, ...common });
+            return check.offer ? parseKey(check.offer) : null;
+        }
+        const { version, variant } = request.target;
+        if (version !== undefined)
+            return { version, variant };
+        const catalog = await this.deps.advisor.catalog({ current_backend: current, ...common });
+        const newest = catalog.available.find((entry) => entry.backend === variant);
+        if (newest === undefined)
+            throw new AtomicCoreError('BACKEND_TAG_UNRESOLVED', `The ${this.engine} catalog has no ${variant} build for this computer.`, variant);
+        return { version: newest.version, variant };
+    }
+    /**
+     * The switch is already written when this runs: a session that does not stop keeps running from its
+     * old pack, which stays on disk, and the answer still says the update applied.
+     */
+    async unload() {
+        try {
+            await this.deps.unloadSessions();
+        }
+        catch (error) {
+            this.deps.log?.('warn', `${this.engine}: a session did not unload after the switch: ${String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=llamacpp.js.map

package/dist/engines/llamacpp.js.map

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

package/dist/engines/managed.d.ts

@@ -0,0 +1,49 @@
+/**
+ * TensorRT-LLM and vLLM as engines of the `/engines` layer (change `unify-engine-lifecycle`, spec
+ * `engine-lifecycle`, "Обновление managed-движка переустановкой"; design D6, D7). A managed engine has
+ * one installation, pinned to the descriptor it was set up with; a newer descriptor in conf is offered
+ * as a reinstall, which the environment runs as a durable removal (models kept) followed by a setup
+ * that asks for consent. There is no update in place: the provisioners do not implement `kind: update`.
+ */
+import type { EngineBuildDeleteResult, EngineId, EngineOperationStarted, EngineUpdateRequest, EngineUpdateResult, EngineVersions, EngineVersionsRequest } from '../contracts/index.js';
+import type { EnvironmentService, InstallationRecord, RuntimeDescriptorProvider } from '../runtime/environment/index.js';
+import type { EngineHandle, EngineRemoveOptions } from './service.js';
+export interface ManagedEngineDeps {
+    engine: EngineId;
+    environmentId: string;
+    /** The image platform a setup on this host pulls. */
+    platform: 'linux/amd64' | 'linux/arm64';
+    /** Every installation of this user's environment (shared by both scopes). */
+    installations: () => Promise<InstallationRecord[]>;
+    /** What a fresh setup of the engine would use now (`RuntimeDescriptorProvider.forNewSetup`). */
+    newSetup: RuntimeDescriptorProvider['forNewSetup'];
+    /** The engine's models loaded right now. */
+    residentModels: () => readonly string[];
+    environment: Pick<EnvironmentService, 'beginReinstall' | 'planRemoval' | 'begin'>;
+    /** The request id of a removal asked for through `DELETE`, which has no body to carry one. */
+    newId?: () => string;
+}
+export declare class ManagedEngine implements EngineHandle {
+    private readonly deps;
+    readonly engine: EngineId;
+    readonly kind: "managed";
+    constructor(deps: ManagedEngineDeps);
+    /**
+     * The installation `installation_id` = `engine_id` (the clients' convention), ready and pinned to a
+     * descriptor; one being removed (`removing`, possibly by the other scope's core) is not offered.
+     */
+    private installation;
+    private latest;
+    versions(request: EngineVersionsRequest): Promise<EngineVersions>;
+    /**
+     * `POST /engines/:engine/update`: with an offer, the reinstall's removal (`202`); without one,
+     * `no-update` and no operation. The call itself is the consent to remove, the setup asks its own.
+     */
+    update(request: EngineUpdateRequest): Promise<EngineUpdateResult | EngineOperationStarted>;
+    /**
+     * `DELETE /engines/:engine/builds/:version/:variant`: the durable removal of the installation, the
+     * request itself being the consent (the plan it approves is the one the removal's probe computes).
+     * `202` with the operation; a release that is not the one installed is `removed: false`.
+     */
+    remove(version: string, variant: string, options: EngineRemoveOptions): Promise<EngineBuildDeleteResult | EngineOperationStarted>;
+}

package/dist/engines/managed.js

@@ -0,0 +1,88 @@
+/**
+ * TensorRT-LLM and vLLM as engines of the `/engines` layer (change `unify-engine-lifecycle`, spec
+ * `engine-lifecycle`, "Обновление managed-движка переустановкой"; design D6, D7). A managed engine has
+ * one installation, pinned to the descriptor it was set up with; a newer descriptor in conf is offered
+ * as a reinstall, which the environment runs as a durable removal (models kept) followed by a setup
+ * that asks for consent. There is no update in place: the provisioners do not implement `kind: update`.
+ */
+import { randomUUID } from 'node:crypto';
+import { AtomicCoreError } from '../contracts/index.js';
+import { managedVersions } from './versions.js';
+export class ManagedEngine {
+    deps;
+    engine;
+    kind = 'managed';
+    constructor(deps) {
+        this.deps = deps;
+        this.engine = deps.engine;
+    }
+    /**
+     * The installation `installation_id` = `engine_id` (the clients' convention), ready and pinned to a
+     * descriptor; one being removed (`removing`, possibly by the other scope's core) is not offered.
+     */
+    async installation() {
+        const records = await this.deps.installations();
+        return (records.find((record) => record.installation.engine_id === this.engine &&
+            record.installation.status === 'ready' &&
+            record.installation.active_descriptor_id !== null) ?? null);
+    }
+    async latest() {
+        const result = await this.deps.newSetup(this.engine);
+        return result.kind === 'available'
+            ? { kind: 'available', descriptor: result.descriptor, source: result.source ?? 'cache' }
+            : { kind: 'unavailable', error: result.error };
+    }
+    versions(request) {
+        return managedVersions({
+            engine: this.engine,
+            installation: () => this.installation(),
+            latest: () => this.latest(),
+            inUse: () => this.deps.residentModels().length > 0,
+            platform: this.deps.platform,
+        }, request);
+    }
+    /**
+     * `POST /engines/:engine/update`: with an offer, the reinstall's removal (`202`); without one,
+     * `no-update` and no operation. The call itself is the consent to remove, the setup asks its own.
+     */
+    async update(request) {
+        if (!('request_id' in request))
+            throw new AtomicCoreError('INVALID_ARGUMENT', `An update of ${this.engine} needs request_id.`);
+        if ('target' in request)
+            throw new AtomicCoreError('INVALID_ARGUMENT', `The core picks the ${this.engine} release; an update takes no target.`);
+        const entry = await this.versions({ app_version: request.app_version ?? null });
+        const target = entry.update.needed ? entry.update.target : null;
+        if (target === null)
+            return { updated: false, reason: 'no-update', active: entry.active, retired: [], kept_in_use: [] };
+        const removal = await this.deps.environment.beginReinstall(this.deps.environmentId, {
+            request_id: request.request_id,
+            target: { kind: 'runtime', installation_id: this.engine, engine_id: this.engine },
+            descriptor_id: target.version,
+        });
+        return { operation_id: removal.operation_id };
+    }
+    /**
+     * `DELETE /engines/:engine/builds/:version/:variant`: the durable removal of the installation, the
+     * request itself being the consent (the plan it approves is the one the removal's probe computes).
+     * `202` with the operation; a release that is not the one installed is `removed: false`.
+     */
+    async remove(version, variant, options) {
+        const record = await this.installation();
+        if (record === null ||
+            record.installation.active_descriptor_id !== version ||
+            record.platform !== variant)
+            return { removed: false };
+        const target = { kind: 'runtime', installation_id: this.engine, engine_id: this.engine };
+        const retainModels = options.retainModels ?? true;
+        const plan = await this.deps.environment.planRemoval(this.deps.environmentId, target, retainModels);
+        const removal = await this.deps.environment.begin(this.deps.environmentId, {
+            request_id: (this.deps.newId ?? randomUUID)(),
+            target,
+            kind: 'remove',
+            retain_models: retainModels,
+            approved_plan_digest: plan.plan_digest,
+        });
+        return { operation_id: removal.operation_id };
+    }
+}
+//# sourceMappingURL=managed.js.map

package/dist/engines/managed.js.map

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

package/dist/engines/service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The `/engines` layer (change `unify-engine-lifecycle`, design D1): it only gathers and directs.
+ * Each engine of this host is an `EngineHandle` over the system that installs it — the llama.cpp
+ * backend service, `engine-builds`, the managed environments — and this class answers the versions
+ * of all of them and sends each command to the one it names.
+ */
+import type { EngineActivateResult, EngineBuildDeleteResult, EngineId, EngineKind, EngineOperationStarted, EngineUpdateRequest, EngineUpdateResult, EngineVersions, EngineVersionsRequest, EngineVersionsResponse } from '../contracts/index.js';
+/** One engine of this host, over the system underneath. */
+export interface EngineHandle {
+    engine: EngineId;
+    kind: EngineKind;
+    versions(request: EngineVersionsRequest): Promise<EngineVersions>;
+    /** `swap` engines answer once applied; a managed engine answers with the operation it began. */
+    update(request: EngineUpdateRequest): Promise<EngineUpdateResult | EngineOperationStarted>;
+    /** One build; a managed engine answers with the removal it began. */
+    remove(version: string, variant: string, options: EngineRemoveOptions): Promise<EngineBuildDeleteResult | EngineOperationStarted>;
+    /** Only where the client picks the active build (`active_choice: client`, llama.cpp). */
+    activate?(version: string, variant: string): Promise<EngineActivateResult>;
+}
+export interface EngineRemoveOptions {
+    /** A managed engine only: keep its models (the default). */
+    retainModels?: boolean;
+}
+/**
+ * The engines registered on this host, in catalog order: the three llama.cpp providers and sd.cpp
+ * everywhere, MLX on macOS, a managed engine where this core offers it (Linux, Windows with Atomic
+ * Chat's WSL distribution).
+ */
+export declare function hostEngines(platform: NodeJS.Platform, managed: readonly string[]): EngineId[];
+export interface EnginesServiceDeps {
+    engines: readonly EngineHandle[];
+}
+export declare class EnginesService {
+    private readonly engines;
+    constructor(deps: EnginesServiceDeps);
+    /** The handle of an engine this host has; `INVALID_ARGUMENT` for any other name. */
+    private handle;
+    /** `POST /engines/:engine/update`. */
+    update(engine: string, request: EngineUpdateRequest): Promise<EngineUpdateResult | EngineOperationStarted>;
+    /** `DELETE /engines/:engine/builds/:version/:variant`. */
+    remove(engine: string, version: string, variant: string, options?: EngineRemoveOptions): Promise<EngineBuildDeleteResult | EngineOperationStarted>;
+    /** `POST /engines/:engine/builds/:version/:variant/activate`. */
+    activate(engine: string, version: string, variant: string): Promise<EngineActivateResult>;
+    /** `POST /engines/versions`: every engine at once; one engine's failure is its own `error`. */
+    versions(request?: EngineVersionsRequest): Promise<EngineVersionsResponse>;
+}

package/dist/engines/service.js

@@ -0,0 +1,61 @@
+/**
+ * The `/engines` layer (change `unify-engine-lifecycle`, design D1): it only gathers and directs.
+ * Each engine of this host is an `EngineHandle` over the system that installs it — the llama.cpp
+ * backend service, `engine-builds`, the managed environments — and this class answers the versions
+ * of all of them and sends each command to the one it names.
+ */
+import { AtomicCoreError, ENGINE_IDS, ENGINE_KINDS } from '../contracts/index.js';
+import { collectEngineVersions } from './versions.js';
+/**
+ * The engines registered on this host, in catalog order: the three llama.cpp providers and sd.cpp
+ * everywhere, MLX on macOS, a managed engine where this core offers it (Linux, Windows with Atomic
+ * Chat's WSL distribution).
+ */
+export function hostEngines(platform, managed) {
+    return ENGINE_IDS.filter((engine) => {
+        if (engine === 'mlx')
+            return platform === 'darwin';
+        if (ENGINE_KINDS[engine] === 'managed')
+            return managed.includes(engine);
+        return true;
+    });
+}
+export class EnginesService {
+    engines;
+    constructor(deps) {
+        this.engines = [...deps.engines].sort((a, b) => ENGINE_IDS.indexOf(a.engine) - ENGINE_IDS.indexOf(b.engine));
+    }
+    /** The handle of an engine this host has; `INVALID_ARGUMENT` for any other name. */
+    handle(engine) {
+        const handle = this.engines.find((candidate) => candidate.engine === engine);
+        if (handle !== undefined)
+            return handle;
+        throw new AtomicCoreError('INVALID_ARGUMENT', ENGINE_IDS.includes(engine)
+            ? `The ${engine} engine is not available on this computer.`
+            : `There is no engine named ${engine}.`, engine);
+    }
+    /** `POST /engines/:engine/update`. */
+    async update(engine, request) {
+        return this.handle(engine).update(request);
+    }
+    /** `DELETE /engines/:engine/builds/:version/:variant`. */
+    async remove(engine, version, variant, options = {}) {
+        return this.handle(engine).remove(version, variant, options);
+    }
+    /** `POST /engines/:engine/builds/:version/:variant/activate`. */
+    async activate(engine, version, variant) {
+        const handle = this.handle(engine);
+        if (handle.activate === undefined)
+            throw new AtomicCoreError('INVALID_ARGUMENT', `The core picks the active ${engine} build; it cannot be chosen.`, engine);
+        return handle.activate(version, variant);
+    }
+    /** `POST /engines/versions`: every engine at once; one engine's failure is its own `error`. */
+    versions(request = {}) {
+        return collectEngineVersions(this.engines.map((handle) => ({
+            engine: handle.engine,
+            kind: handle.kind,
+            read: () => handle.versions(request),
+        })));
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/engines/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/engines/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAajF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAwBrD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB,EAAE,OAA0B;IAC/E,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,QAAQ,KAAK,QAAQ,CAAA;QAClD,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACvE,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAMD,MAAM,OAAO,cAAc;IACR,OAAO,CAAgB;IAExC,YAAY,IAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CACtE,CAAA;IACH,CAAC;IAED,oFAAoF;IAC5E,MAAM,CAAC,MAAc;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;QAC5E,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QACvC,MAAM,IAAI,eAAe,CACvB,kBAAkB,EACjB,UAAgC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAChD,CAAC,CAAC,OAAO,MAAM,4CAA4C;YAC3D,CAAC,CAAC,4BAA4B,MAAM,GAAG,EACzC,MAAM,CACP,CAAA;IACH,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,MAAM,CACV,MAAc,EACd,OAA4B;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,MAAM,CACV,MAAc,EACd,OAAe,EACf,OAAe,EACf,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAe,EAAE,OAAe;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAC/B,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,6BAA6B,MAAM,8BAA8B,EACjE,MAAM,CACP,CAAA;QACH,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,+FAA+F;IAC/F,QAAQ,CAAC,UAAiC,EAAE;QAC1C,OAAO,qBAAqB,CAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;SACrC,CAAC,CAAC,CACJ,CAAA;IACH,CAAC;CACF"}

package/dist/engines/versions.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `POST /engines/versions` (change `unify-engine-lifecycle`, spec `engine-lifecycle`, "Версии всех
+ * движков хоста", "Описание установленной сборки", "Предложение обновления"; design D1, D2): one entry
+ * per engine of this host, each built from the system that installs it, never by merging them.
+ *
+ *   - llama.cpp — the backend advisor's update check and catalog, and the packs on disk;
+ *   - sd.cpp, MLX — the `engine-builds` catalog and update check;
+ *   - TensorRT-LLM, vLLM — the installation record and the last accepted descriptor, ordered by
+ *     `descriptor-order.ts`.
+ *
+ * Every builder only reads: it downloads nothing but the documents that say what exists, and changes
+ * no build and no setting. The entries are built in parallel, and one engine's failure is that
+ * engine's `error`, so a broken TurboQuant index never hides an MLX update.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import type { BackendCatalogRequest, BackendCatalogResponse, BackendUpdateCheckRequest, BackendUpdateCheckResponse, EngineBuildCatalog, EngineBuildCatalogRequest, EngineBuildId, EngineBuildUpdateCheck, EngineId, EngineKind, EngineVersions, EngineVersionsRequest, EngineVersionsResponse, LlamacppProviderId, RuntimeDescriptor } from '../contracts/index.js';
+import type { InstalledBackendPack } from '../backend/index.js';
+import type { InstallationRecord } from '../runtime/environment/index.js';
+export interface LlamacppVersionsDeps {
+    engine: LlamacppProviderId;
+    /** The provider's `version_backend` in the core's settings. */
+    current: () => string;
+    checkUpdates: (request: BackendUpdateCheckRequest) => Promise<BackendUpdateCheckResponse>;
+    catalog: (request: BackendCatalogRequest) => Promise<BackendCatalogResponse>;
+    listInstalled: (current: string) => Promise<InstalledBackendPack[]>;
+    bundledPack: () => Promise<{
+        version: string;
+        backend: string;
+    } | null>;
+    inUse: (version: string, backend: string) => Promise<boolean>;
+}
+export declare function llamacppVersions(deps: LlamacppVersionsDeps, request: EngineVersionsRequest): Promise<EngineVersions>;
+export interface EngineBuildVersionsDeps {
+    engine: EngineBuildId;
+    catalog: (request: EngineBuildCatalogRequest) => Promise<EngineBuildCatalog>;
+    checkUpdates: (request: EngineBuildCatalogRequest) => Promise<EngineBuildUpdateCheck>;
+}
+export declare function engineBuildVersions(deps: EngineBuildVersionsDeps, request: EngineVersionsRequest): Promise<EngineVersions>;
+/** What a fresh setup would use now: the descriptor just fetched, the last one accepted, or neither. */
+export type LatestDescriptor = {
+    kind: 'available';
+    descriptor: RuntimeDescriptor;
+    source: 'remote' | 'cache';
+} | {
+    kind: 'unavailable';
+    error: AtomicCoreError;
+};
+export interface ManagedVersionsDeps {
+    engine: EngineId;
+    /** The engine's installation in this user's environment, or `null` when it is not installed. */
+    installation: () => Promise<InstallationRecord | null>;
+    latest: () => Promise<LatestDescriptor>;
+    /** A model of this engine is resident. */
+    inUse: () => boolean;
+    /** The image platform a setup on this host pulls. */
+    platform: 'linux/amd64' | 'linux/arm64';
+}
+export declare function managedVersions(deps: ManagedVersionsDeps, request: EngineVersionsRequest): Promise<EngineVersions>;
+export interface EngineVersionsReader {
+    engine: EngineId;
+    kind: EngineKind;
+    read: () => Promise<EngineVersions>;
+}
+/** All entries at once, in the order given; a reader that throws becomes its engine's `error`. */
+export declare function collectEngineVersions(readers: readonly EngineVersionsReader[]): Promise<EngineVersionsResponse>;