@atomic-chat/core 0.18.4 → 0.19.0

package/dist/router/resolve.d.ts

@@ -21,22 +21,25 @@ export interface RemoteProvider {
     /** The image and video models enabled for this provider; never part of chat routing. */
     media?: CloudProviderMedia;
 }
-export type LocalProvider = 'llamacpp' | 'llamacpp-upstream' | 'mlx' | 'tensorrt-llm' | 'atomic-prism' | 'vllm' | 'sglang' | 'foundry-local';
+export type LocalProvider = 'llamacpp' | 'llamacpp-upstream' | 'mlx' | 'tensorrt-llm' | 'atomic-prism' | 'vllm' | 'sglang' | 'foundry-local' | 'litert-lm';
 /**
  * The order local providers are searched in when a request names only a model. The same model id
  * loaded under two engines resolves to the first; changing the order would silently move traffic.
  * `tensorrt-llm`, `atomic-prism`, `vllm` and `sglang` come last, in the order they were added, for
  * exactly that reason: adding a provider moves nothing that already resolved (`vllm` after
  * `atomic-prism`, which core 0.10.0 already shipped; change `add-vllm-runtime`, D11; `sglang` after
- * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5). A Prism-only file never loads
+ * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5;
+ * `litert-lm` after `foundry-local`, change `add-litert-lm-runtime`, task 6.1). A Prism-only file never loads
  * under another engine (the compatibility gate), so its sessions are found here even near the end of
  * the list; one store model is never loaded in two managed providers at once, so their order never
  * decides between two live sessions of one id.
  */
 export declare const LOCAL_SEARCH_ORDER: readonly LocalProvider[];
 /**
- * The remote provider that owns `modelId`, if any. Remote wins over local — a model id the user
- * enabled for a cloud provider is never served by a local session of the same name.
+ * The remote provider that owns `modelId`, if any. For an id the app selected no provider for
+ * (`resolveSelectedRoute`), remote wins over local — a model id the user enabled for a cloud
+ * provider is never served by a local session of the same name. An id with a selection goes to the
+ * selected provider only (ADR 2026-10-21-route-a-selected-model-id-to-its-selected-provider-only).
  *
  * Three rules, in order, exactly as the proxy applies them:
  * 1. a provider that lists the model id;
@@ -44,6 +47,24 @@ export declare const LOCAL_SEARCH_ORDER: readonly LocalProvider[];
  * 3. the whole id is a provider key.
  */
 export declare function resolveRemoteProvider(modelId: string, providers: ReadonlyMap<string, RemoteProvider>): RemoteProvider | undefined;
+/** Where a model id the app selected a provider for is served. */
+export type SelectedRoute = {
+    kind: 'remote';
+    provider: RemoteProvider;
+} | {
+    kind: 'local';
+    provider: LocalProvider;
+};
+/**
+ * The provider the app selected to serve `modelId` (`PUT /atomic/v1/server/selection`), when this
+ * core can route to it: a registered remote provider, or a local engine. The id is matched with the
+ * proxy's `.`/`_` rule. `undefined` — no selection, or one naming a provider this core does not know
+ * (an unregistered cloud provider, Apple Foundation Models) — leaves the id to the rules without one.
+ * A selected remote provider is strict. A selected local engine means "local": the caller asks that
+ * engine first, then any other local session of the id (the app and the core may name the engine
+ * differently), and refuses the request rather than send it to a remote provider that lists it.
+ */
+export declare function resolveSelectedRoute(modelId: string, selection: ReadonlyMap<string, string>, providers: ReadonlyMap<string, RemoteProvider>): SelectedRoute | undefined;
 /**
  * The proxy's model-id comparison: `.` and `_` are the same character, because clients and
  * filesystems substitute one for the other (`Qwen3_5-9B` is `Qwen3.5-9B`). Nothing else is folded.

package/dist/router/resolve.js

@@ -11,7 +11,8 @@
  * `tensorrt-llm`, `atomic-prism`, `vllm` and `sglang` come last, in the order they were added, for
  * exactly that reason: adding a provider moves nothing that already resolved (`vllm` after
  * `atomic-prism`, which core 0.10.0 already shipped; change `add-vllm-runtime`, D11; `sglang` after
- * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5). A Prism-only file never loads
+ * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5;
+ * `litert-lm` after `foundry-local`, change `add-litert-lm-runtime`, task 6.1). A Prism-only file never loads
  * under another engine (the compatibility gate), so its sessions are found here even near the end of
  * the list; one store model is never loaded in two managed providers at once, so their order never
  * decides between two live sessions of one id.
@@ -25,10 +26,13 @@ export const LOCAL_SEARCH_ORDER = [
     'vllm',
     'sglang',
     'foundry-local',
+    'litert-lm',
 ];
 /**
- * The remote provider that owns `modelId`, if any. Remote wins over local — a model id the user
- * enabled for a cloud provider is never served by a local session of the same name.
+ * The remote provider that owns `modelId`, if any. For an id the app selected no provider for
+ * (`resolveSelectedRoute`), remote wins over local — a model id the user enabled for a cloud
+ * provider is never served by a local session of the same name. An id with a selection goes to the
+ * selected provider only (ADR 2026-10-21-route-a-selected-model-id-to-its-selected-provider-only).
  *
  * Three rules, in order, exactly as the proxy applies them:
  * 1. a provider that lists the model id;
@@ -48,6 +52,33 @@ export function resolveRemoteProvider(modelId, providers) {
     }
     return providers.get(modelId);
 }
+/**
+ * The provider the app selected to serve `modelId` (`PUT /atomic/v1/server/selection`), when this
+ * core can route to it: a registered remote provider, or a local engine. The id is matched with the
+ * proxy's `.`/`_` rule. `undefined` — no selection, or one naming a provider this core does not know
+ * (an unregistered cloud provider, Apple Foundation Models) — leaves the id to the rules without one.
+ * A selected remote provider is strict. A selected local engine means "local": the caller asks that
+ * engine first, then any other local session of the id (the app and the core may name the engine
+ * differently), and refuses the request rather than send it to a remote provider that lists it.
+ */
+export function resolveSelectedRoute(modelId, selection, providers) {
+    let selected = selection.get(modelId);
+    if (selected === undefined) {
+        for (const [id, provider] of selection) {
+            if (modelIdsMatch(id, modelId)) {
+                selected = provider;
+                break;
+            }
+        }
+    }
+    if (selected === undefined)
+        return undefined;
+    const remote = providers.get(selected);
+    if (remote)
+        return { kind: 'remote', provider: remote };
+    const local = LOCAL_SEARCH_ORDER.find((provider) => provider === selected);
+    return local === undefined ? undefined : { kind: 'local', provider: local };
+}
 /**
  * The proxy's model-id comparison: `.` and `_` are the same character, because clients and
  * filesystems substitute one for the other (`Qwen3_5-9B` is `Qwen3.5-9B`). Nothing else is folded.

package/dist/router/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/router/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,UAAU;IACV,mBAAmB;IACnB,KAAK;IACL,cAAc;IACd,cAAc;IACd,MAAM;IACN,QAAQ;IACR,eAAe;CAChB,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAA8C;IAE9C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAA;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACvD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACrB,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,SAAQ;QAClE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,IAAe,EACf,SAA8C;IAE9C,MAAM,KAAK,GAAG,CAAC,MAAsB,EAAE,EAAU,EAAW,EAAE,CAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,KAAK,CAAA;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACnF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE;QACrC,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAClF,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/router/resolve.ts"],"names":[],"mappings":"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"}

package/dist/runtime/environment/host-exec.d.ts

@@ -33,6 +33,8 @@ export interface HostExecOptions {
     terminateGraceMs?: number;
     /** Tests only: stands in for `child_process.spawn`. */
     spawnProcess?: typeof spawn;
+    /** Tests only: whose rules for environment names apply (case-insensitive on `win32`). */
+    platform?: NodeJS.Platform;
 }
 export type HostExec = (command: string, args: string[], env?: Record<string, string | undefined>) => Promise<CommandOutput>;
 export declare function hostExec(options?: HostExecOptions): HostExec;

package/dist/runtime/environment/host-exec.js

@@ -31,13 +31,22 @@ const KILL_SETTLE_MS = 5_000;
  * strips it, and every other key of `base` passes through untouched. This is the "merge, not
  * replace" semantics `LinuxProbeDeps.exec`'s own `env` parameter documents (round 2, item 10): a
  * caller stripping `DOCKER_HOST` for one call must not also lose `PATH` for it.
+ *
+ * On Windows a name means the same in any case, so an overlaid key replaces or strips the base's
+ * key in every case. Otherwise `spawn` would get both, and Node passes on only the first of them in
+ * sorted order — `PSMODULEPATH` before `PSModulePath`, the inherited one over the caller's.
  */
-function overlayEnv(base, overlay) {
+function overlayEnv(base, overlay, windows) {
     const merged = { ...base };
     for (const [key, value] of Object.entries(overlay)) {
-        if (value === undefined)
-            delete merged[key];
+        if (windows) {
+            for (const name of Object.keys(merged))
+                if (name.toUpperCase() === key.toUpperCase())
+                    delete merged[name];
+        }
         else
+            delete merged[key];
+        if (value !== undefined)
             merged[key] = value;
     }
     return merged;
@@ -95,7 +104,9 @@ export function hostExec(options = {}) {
         };
         // No overlay for this call and no configured base: `spawn` gets no `env` key at all, which is
         // how Node inherits `process.env` on its own — the same as before this parameter existed.
-        const spawnEnv = envOverlay === undefined ? options.env : overlayEnv(options.env ?? process.env, envOverlay);
+        const spawnEnv = envOverlay === undefined
+            ? options.env
+            : overlayEnv(options.env ?? process.env, envOverlay, (options.platform ?? process.platform) === 'win32');
         try {
             child = (options.spawnProcess ?? spawn)(command, args, {
                 shell: false,

package/dist/runtime/environment/host-exec.js.map

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

package/dist/runtime/litert-lm/accelerators.d.ts

@@ -0,0 +1,54 @@
+/**
+ * LiteRT-LM's one accelerator, `openvino` (openspec change `add-litert-lm-runtime`, task 6.4, design
+ * D3): the Intel libraries an NPU variant needs on Windows, from the `openvino` wheel the active
+ * release pins in conf's manifest. Offered only on a machine whose Intel NPU generation LiteRT-LM has
+ * files for; prepared only when a client orders it — one prepare at a time, each step published as
+ * `litert-lm:accelerators`.
+ *
+ * A prepare downloads the wheel with its sha256 and size checked, keeps only `openvino/libs/**` and
+ * puts it at `<data>/litert-lm/accelerators/openvino/<version>/`, marked last: a folder without the
+ * marker is not prepared. A second prepare of the same version downloads nothing.
+ */
+import type { CoreEvents, LiteRtLmAccelerators, LiteRtLmNpu, LiteRtLmPrepareRequest, LiteRtLmPrepareResult, ProxyConfig } from '../../contracts/index.js';
+import type { LiteRtLmRelease } from '../../engine-builds/manifest.js';
+export declare const OPENVINO = "openvino";
+export interface LiteRtLmAcceleratorDeps {
+    /** `<data>/litert-lm/accelerators`. */
+    acceleratorsDir: string;
+    /** `<data>/litert-lm/tmp`: the download and the unpacked wheel, gone after. */
+    tmpDir: string;
+    resolveBuild: () => Promise<{
+        dir: string;
+        version: string;
+    } | undefined>;
+    /** The manifest's release of a LiteRT-LM version (a cached manifest is fine); `null` when unknown. */
+    release: (version: string) => Promise<LiteRtLmRelease | null>;
+    /** This machine's Intel NPU generation LiteRT-LM files target, or `null`. */
+    npuGeneration: () => Promise<LiteRtLmNpu | null>;
+    /** Download one file with its sha256 and size checked; `onFraction` 0…1 as it goes. */
+    download: (taskId: string, item: {
+        url: string;
+        save_path: string;
+        sha256: string;
+        size: number;
+        proxy?: ProxyConfig | null;
+    }, onFraction: (fraction: number) => void) => Promise<void>;
+    emit: (name: 'litert-lm:accelerators', payload: CoreEvents['litert-lm:accelerators']) => void;
+    now?: () => number;
+}
+export declare class LiteRtLmAcceleratorService {
+    private readonly deps;
+    private preparing;
+    /** The reason the last failed prepare of each version gave. */
+    private readonly failures;
+    private readonly now;
+    constructor(deps: LiteRtLmAcceleratorDeps);
+    private dirOf;
+    /** What this machine is offered: OpenVINO of the active release, on an Intel NPU it targets. */
+    private offered;
+    list(): Promise<LiteRtLmAccelerators>;
+    /** The prepared OpenVINO libraries of the active release: what an NPU load passes the host. */
+    libsDir(): Promise<string | undefined>;
+    prepare(request: LiteRtLmPrepareRequest): Promise<LiteRtLmPrepareResult>;
+    private prepareOpenVino;
+}

package/dist/runtime/litert-lm/accelerators.js

@@ -0,0 +1,176 @@
+/**
+ * LiteRT-LM's one accelerator, `openvino` (openspec change `add-litert-lm-runtime`, task 6.4, design
+ * D3): the Intel libraries an NPU variant needs on Windows, from the `openvino` wheel the active
+ * release pins in conf's manifest. Offered only on a machine whose Intel NPU generation LiteRT-LM has
+ * files for; prepared only when a client orders it — one prepare at a time, each step published as
+ * `litert-lm:accelerators`.
+ *
+ * A prepare downloads the wheel with its sha256 and size checked, keeps only `openvino/libs/**` and
+ * puts it at `<data>/litert-lm/accelerators/openvino/<version>/`, marked last: a folder without the
+ * marker is not prepared. A second prepare of the same version downloads nothing.
+ */
+import { mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { OWNER_MARKER } from '../../diffusion/install.js';
+import { extractArchive } from '../../downloads/index.js';
+export const OPENVINO = 'openvino';
+const exists = (path) => stat(path).then(() => true, () => false);
+export class LiteRtLmAcceleratorService {
+    deps;
+    preparing = false;
+    /** The reason the last failed prepare of each version gave. */
+    failures = new Map();
+    now;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+    }
+    dirOf(version) {
+        return join(this.deps.acceleratorsDir, OPENVINO, version);
+    }
+    /** What this machine is offered: OpenVINO of the active release, on an Intel NPU it targets. */
+    async offered() {
+        const build = await this.deps.resolveBuild();
+        if (!build)
+            return {
+                answer: { installed: false, build: null, npu: null, accelerators: [], error: null },
+                accelerator: null,
+            };
+        const name = `${build.version}/${build.dir.split(/[\\/]/).at(-1) ?? ''}`;
+        const npu = await this.deps.npuGeneration();
+        if (!npu)
+            return {
+                answer: { installed: true, build: name, npu: null, accelerators: [], error: null },
+                accelerator: null,
+            };
+        const release = await this.deps.release(build.version);
+        const accelerator = release?.accelerators.find((candidate) => candidate.id === OPENVINO) ?? null;
+        if (!accelerator)
+            return {
+                answer: {
+                    installed: true,
+                    build: name,
+                    npu,
+                    accelerators: [],
+                    error: release
+                        ? `LiteRT-LM ${build.version} pins no OpenVINO.`
+                        : `The LiteRT-LM manifest has no release ${build.version}; it lists the accelerator.`,
+                },
+                accelerator: null,
+            };
+        const failure = this.failures.get(accelerator.version);
+        return {
+            answer: {
+                installed: true,
+                build: name,
+                npu,
+                accelerators: [
+                    {
+                        name: OPENVINO,
+                        device: 'npu',
+                        version: accelerator.version,
+                        size_bytes: accelerator.size,
+                        prepared: await exists(join(this.dirOf(accelerator.version), OWNER_MARKER)),
+                        ...(failure ? { reason: failure } : {}),
+                    },
+                ],
+                error: null,
+            },
+            accelerator,
+        };
+    }
+    async list() {
+        return (await this.offered()).answer;
+    }
+    /** The prepared OpenVINO libraries of the active release: what an NPU load passes the host. */
+    async libsDir() {
+        const { accelerator } = await this.offered();
+        if (!accelerator)
+            return undefined;
+        const dir = this.dirOf(accelerator.version);
+        return (await exists(join(dir, OWNER_MARKER))) ? dir : undefined;
+    }
+    async prepare(request) {
+        if (this.preparing)
+            throw new AtomicCoreError('ENGINE_INSTALL_IN_PROGRESS', 'The LiteRT-LM accelerator is already being prepared; wait for that to finish.');
+        this.preparing = true;
+        try {
+            const { answer, accelerator } = await this.offered();
+            const wanted = request.accelerators && request.accelerators.length > 0 ? request.accelerators : [OPENVINO];
+            const summary = [];
+            for (const name of wanted) {
+                if (name !== OPENVINO) {
+                    summary.push({ name, prepared: false, reason: `LiteRT-LM has no ${name} accelerator.` });
+                    continue;
+                }
+                if (!accelerator) {
+                    summary.push({
+                        name,
+                        prepared: false,
+                        reason: answer.error ?? 'This computer has no Intel NPU LiteRT-LM has models for.',
+                    });
+                    continue;
+                }
+                summary.push(await this.prepareOpenVino(accelerator, request.proxy ?? null));
+            }
+            return { accelerators: summary };
+        }
+        finally {
+            this.preparing = false;
+        }
+    }
+    async prepareOpenVino(accelerator, proxy) {
+        const emit = (stage, fraction, reason) => this.deps.emit('litert-lm:accelerators', {
+            accelerator: OPENVINO,
+            stage,
+            fraction,
+            ...(reason !== undefined ? { reason } : {}),
+        });
+        const target = this.dirOf(accelerator.version);
+        if (await exists(join(target, OWNER_MARKER))) {
+            emit('done', 1);
+            return { name: OPENVINO, prepared: true };
+        }
+        const stamp = this.now();
+        const work = join(this.deps.tmpDir, `openvino-${accelerator.version}-${stamp}`);
+        const staging = `${target}.incoming-${stamp}`;
+        try {
+            emit('started', 0);
+            await mkdir(work, { recursive: true });
+            const wheel = join(work, accelerator.name);
+            await this.deps.download(`litert-lm-${OPENVINO}-${accelerator.version}`, {
+                url: accelerator.url,
+                save_path: wheel,
+                sha256: accelerator.sha256,
+                size: accelerator.size,
+                ...(proxy ? { proxy } : {}),
+            }, (fraction) => emit('downloading', fraction));
+            const unpacked = join(work, 'unpacked');
+            await extractArchive(wheel, unpacked);
+            const libs = join(unpacked, 'openvino', 'libs');
+            if (!(await exists(libs)))
+                throw new Error('the OpenVINO wheel has no openvino/libs');
+            await rm(staging, { recursive: true, force: true });
+            await mkdir(join(staging, '..'), { recursive: true });
+            await rename(libs, staging);
+            await writeFile(join(staging, OWNER_MARKER), 'atomic-chat\n');
+            await rm(target, { recursive: true, force: true });
+            await rename(staging, target);
+            this.failures.delete(accelerator.version);
+            emit('done', 1);
+            return { name: OPENVINO, prepared: true };
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            this.failures.set(accelerator.version, reason);
+            await rm(staging, { recursive: true, force: true }).catch(() => { });
+            emit('failed', null, reason);
+            return { name: OPENVINO, prepared: false, reason };
+        }
+        finally {
+            await rm(work, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=accelerators.js.map

package/dist/runtime/litert-lm/accelerators.js.map

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

package/dist/runtime/litert-lm/check.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `POST /models/litert-lm/check` (openspec change `add-litert-lm-runtime`, task 6.5): whether a
+ * variant would run here. Before a download, from what core already knows — the platform, this
+ * machine's Intel NPU generation, the active build, whether OpenVINO is prepared — never the network.
+ * For a file on disk, also from the file itself (`litert-host inspect`), whose facts come back in the
+ * answer for the client to write into `model.yml`.
+ */
+import type { LiteRtLmCheckRequest, LiteRtLmCheckResult, LiteRtLmFileMetadata, LiteRtLmNpu } from '../../contracts/index.js';
+import type { LiteRtLmPlatform } from '../../engine-builds/manifest.js';
+import type { ModelRegistry } from '../../models/index.js';
+export interface LiteRtLmCheckFacts {
+    platform: LiteRtLmPlatform;
+    build: {
+        dir: string;
+        version: string;
+    } | null;
+    npu: LiteRtLmNpu | null;
+    openVinoPrepared: boolean;
+}
+/** The verdict for a variant (`backend`, `npu`, `min_runtime_version`), and for a file its facts. */
+export declare function liteRtLmVerdict(facts: LiteRtLmCheckFacts, request: Pick<LiteRtLmCheckRequest, 'backend' | 'npu' | 'min_runtime_version'>, file: LiteRtLmFileMetadata | null): LiteRtLmCheckResult;
+/** The request body, strictly: a variant, a path with its backend, or a model id. */
+export declare function parseLiteRtLmCheckRequest(body: unknown): LiteRtLmCheckRequest;
+export interface LiteRtLmCheckDeps {
+    platform: LiteRtLmPlatform;
+    /** `<data>/litert-lm/models`: the only place a checked path may be. */
+    modelsDir: string;
+    registry: ModelRegistry;
+    resolveBuild: () => Promise<{
+        dir: string;
+        version: string;
+    } | undefined>;
+    npuGeneration: () => Promise<LiteRtLmNpu | null>;
+    openVinoLibs: () => Promise<string | undefined>;
+    /** The runtime's cached `inspect` (by path, mtime and build). */
+    inspect: (buildDir: string, file: string) => Promise<LiteRtLmFileMetadata>;
+}
+export declare class LiteRtLmCheckService {
+    private readonly deps;
+    constructor(deps: LiteRtLmCheckDeps);
+    /** A path inside the models root, links resolved, or `INVALID_ARGUMENT`. */
+    private inRoot;
+    check(request: LiteRtLmCheckRequest): Promise<LiteRtLmCheckResult>;
+}

package/dist/runtime/litert-lm/check.js

@@ -0,0 +1,113 @@
+/**
+ * `POST /models/litert-lm/check` (openspec change `add-litert-lm-runtime`, task 6.5): whether a
+ * variant would run here. Before a download, from what core already knows — the platform, this
+ * machine's Intel NPU generation, the active build, whether OpenVINO is prepared — never the network.
+ * For a file on disk, also from the file itself (`litert-host inspect`), whose facts come back in the
+ * answer for the client to write into `model.yml`.
+ */
+import { realpath } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { AtomicCoreError, LITERT_LM_BACKENDS, LITERT_LM_NPUS } from '../../contracts/index.js';
+import { compareVersions } from '../../backend/index.js';
+import { readLiteRtLmBlock } from './model-yml.js';
+import { backendRunsOn } from './runtime.js';
+const verdict = (v, reason, metadata) => ({ verdict: v, reason, ...(metadata ? { metadata } : {}) });
+/** The verdict for a variant (`backend`, `npu`, `min_runtime_version`), and for a file its facts. */
+export function liteRtLmVerdict(facts, request, file) {
+    const backend = request.backend ?? '';
+    if (!LITERT_LM_BACKENDS.some((known) => known === backend))
+        return verdict('platform-unsupported', `This core runs no LiteRT-LM variant on the "${backend}" backend.`, file);
+    if (!backendRunsOn(facts.platform, backend))
+        return verdict('platform-unsupported', `LiteRT-LM runs ${backend.toUpperCase()} variants on Windows x64 only.`, file);
+    if (backend === 'npu') {
+        if (!LITERT_LM_NPUS.some((known) => known === request.npu))
+            return verdict('platform-unsupported', `This core runs no LiteRT-LM variant for the "${request.npu ?? ''}" NPU.`, file);
+        if (facts.npu === null)
+            return verdict('accelerator-unavailable', 'This computer has no Intel NPU LiteRT-LM has models for.', file);
+        if (facts.npu !== request.npu)
+            return verdict('accelerator-unavailable', `This variant is built for the ${request.npu} NPU; this computer has ${facts.npu}.`, file);
+    }
+    if (!facts.build)
+        return verdict('engine-not-installed', 'LiteRT-LM is not installed on this computer.', file);
+    if (file && !file.backends.includes(backend))
+        return verdict('platform-unsupported', `This file runs on ${file.backends.join(', ') || 'no backend'}, not ${backend}.`, file);
+    const needs = file?.min_runtime_version ?? request.min_runtime_version ?? null;
+    if (needs && compareVersions(needs, facts.build.version) > 0)
+        return verdict('requires-newer-engine', `This model needs LiteRT-LM ${needs}; the installed one is ${facts.build.version}.`, file);
+    if (backend === 'npu' && !facts.openVinoPrepared)
+        return verdict('accelerator-not-prepared', 'OpenVINO is not prepared yet; prepare it on the LiteRT-LM page.', file);
+    return verdict('ok', null, file);
+}
+const VERSION_RE = /^\d+\.\d+(\.\d+)?$/;
+const FIELDS = ['backend', 'npu', 'min_runtime_version', 'path', 'model_id'];
+/** The request body, strictly: a variant, a path with its backend, or a model id. */
+export function parseLiteRtLmCheckRequest(body) {
+    const invalid = (why) => {
+        throw new AtomicCoreError('INVALID_ARGUMENT', why);
+    };
+    if (typeof body !== 'object' || body === null || Array.isArray(body))
+        return invalid('The request body must be a JSON object.');
+    const record = body;
+    const extra = Object.keys(record).filter((key) => !FIELDS.some((field) => field === key));
+    if (extra.length > 0)
+        invalid(`The request has fields this core does not know: ${extra.sort().join(', ')}.`);
+    const out = {};
+    for (const key of FIELDS) {
+        const value = record[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' || value === '')
+            invalid(`${key} must be text.`);
+        out[key] = value;
+    }
+    if (out.min_runtime_version !== undefined && !VERSION_RE.test(out.min_runtime_version))
+        invalid('min_runtime_version must be X.Y or X.Y.Z.');
+    if (out.model_id !== undefined) {
+        if (Object.keys(out).length > 1)
+            invalid('model_id is checked alone: its variant comes from model.yml.');
+        return out;
+    }
+    if (out.backend === undefined)
+        invalid('backend is required for a variant or a file.');
+    return out;
+}
+export class LiteRtLmCheckService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** A path inside the models root, links resolved, or `INVALID_ARGUMENT`. */
+    async inRoot(path) {
+        const refuse = () => new AtomicCoreError('INVALID_ARGUMENT', 'path must be a file inside the LiteRT-LM models folder.');
+        if (!isAbsolute(path))
+            throw new AtomicCoreError('INVALID_ARGUMENT', 'path must be absolute.');
+        const root = await realpath(this.deps.modelsDir).catch(() => resolve(this.deps.modelsDir));
+        // A file that is not there yet is judged by its spelling; one that is, by where its links lead.
+        const full = await realpath(path).catch(() => resolve(path));
+        const rel = relative(root, full);
+        if (rel === '' || rel.startsWith('..') || isAbsolute(rel))
+            throw refuse();
+        return resolve(path);
+    }
+    async check(request) {
+        let variant = request;
+        let file = request.path !== undefined ? await this.inRoot(request.path) : null;
+        if (request.model_id !== undefined) {
+            const yml = await this.deps.registry.read(request.model_id);
+            const block = readLiteRtLmBlock(yml);
+            variant = { backend: block.backend, ...(block.npu ? { npu: block.npu } : {}) };
+            // The registry's own path: an installed model may be a link, which the runtime loads as it is.
+            file = this.deps.registry.resolvePaths(yml).modelPath;
+        }
+        const build = (await this.deps.resolveBuild()) ?? null;
+        const facts = {
+            platform: this.deps.platform,
+            build,
+            npu: await this.deps.npuGeneration(),
+            openVinoPrepared: (await this.deps.openVinoLibs()) !== undefined,
+        };
+        const metadata = file && build ? await this.deps.inspect(build.dir, file) : null;
+        return liteRtLmVerdict(facts, variant, metadata);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/runtime/litert-lm/check.js.map

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