@atomic-chat/core 0.5.1 → 0.13.2

package/dist/runtime/wsl/keeper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Keeping Atomic Chat's distribution running while something needs it (change
+ * `add-tensorrt-llm-windows`, task 2.7, design D8; spec "Дистрибутив удерживается, пока он нужен").
+ * WSL stops an idle distribution on its own (`instanceIdleTimeout`, 15 s by default), and systemd
+ * services do not reliably keep it up (microsoft/WSL#13416); an attached `wsl.exe -d <name> --exec sleep
+ * infinity` does. So every user of the distribution — an environment operation, a loading or loaded
+ * model, a file operation on models — takes a lease, and one such process runs while any lease is held
+ * and none when there is none, so WSL may stop the VM and give its memory back to Windows.
+ *
+ * When the holding process ends without being released — `wsl --shutdown`, the VM crashed, a
+ * distribution not there (yet) — every subscriber hears of it (a session then ends with
+ * `wsl-stopped`), and nothing is started again on its own: a new hold would boot the VM the user just
+ * stopped, and against a distribution that does not exist it would end at once and be restarted in a
+ * loop. The next `acquire` holds again.
+ */
+import type { WslDistributionTransport } from './transport.js';
+export interface DistributionLease {
+    /** Idempotent. */
+    release(): void;
+}
+export interface DistributionKeeper {
+    /** Hold the distribution until the lease is released. `reason` only names it for diagnostics. */
+    acquire(reason: string): DistributionLease;
+    /** Whether a holding process is running now. */
+    held(): boolean;
+    /** Called when the distribution stopped under a hold. Returns the unsubscribe. */
+    onStopped(listener: () => void): () => void;
+}
+export declare function createDistributionKeeper(transport: WslDistributionTransport): DistributionKeeper;

package/dist/runtime/wsl/keeper.js

@@ -0,0 +1,48 @@
+export function createDistributionKeeper(transport) {
+    const leases = new Set();
+    const listeners = new Set();
+    let hold = null;
+    const start = () => {
+        const current = transport.hold();
+        hold = current;
+        void current.exited.then((end) => {
+            if (hold === current)
+                hold = null;
+            if (end.released)
+                return;
+            for (const listener of [...listeners]) {
+                try {
+                    listener();
+                }
+                catch {
+                    // One subscriber failing must not keep the others from hearing it.
+                }
+            }
+        });
+    };
+    return {
+        acquire: () => {
+            const lease = Symbol('lease');
+            leases.add(lease);
+            if (hold === null)
+                start();
+            return {
+                release: () => {
+                    if (!leases.delete(lease))
+                        return;
+                    if (leases.size === 0 && hold !== null) {
+                        const current = hold;
+                        hold = null;
+                        current.release();
+                    }
+                },
+            };
+        },
+        held: () => hold !== null,
+        onStopped: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+//# sourceMappingURL=keeper.js.map

package/dist/runtime/wsl/keeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.js","sourceRoot":"","sources":["../../../src/runtime/wsl/keeper.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,wBAAwB,CAAC,SAAmC;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAChC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IACvC,IAAI,IAAI,GAAmB,IAAI,CAAA;IAE/B,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;QAChC,IAAI,GAAG,OAAO,CAAA;QACd,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,IAAI,IAAI,KAAK,OAAO;gBAAE,IAAI,GAAG,IAAI,CAAA;YACjC,IAAI,GAAG,CAAC,QAAQ;gBAAE,OAAM;YACxB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,QAAQ,EAAE,CAAA;gBACZ,CAAC;gBAAC,MAAM,CAAC;oBACP,mEAAmE;gBACrE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;YAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACjB,IAAI,IAAI,KAAK,IAAI;gBAAE,KAAK,EAAE,CAAA;YAC1B,OAAO;gBACL,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;wBAAE,OAAM;oBACjC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBACvC,MAAM,OAAO,GAAG,IAAI,CAAA;wBACpB,IAAI,GAAG,IAAI,CAAA;wBACX,OAAO,CAAC,OAAO,EAAE,CAAA;oBACnB,CAAC;gBACH,CAAC;aACF,CAAA;QACH,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,IAAI;QACzB,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACzC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/runtime/wsl/transport.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Running things inside WSL from Windows (change `add-tensorrt-llm-windows`, task 2.2, design D1):
+ * the one place `wsl.exe` is spawned. Everything the core does in Atomic Chat's own distribution —
+ * probing the guest, running the install recipe, every docker call, the Engine API pull — goes
+ * through `exec`; `wsl.exe`'s own commands (`--list`, `--import`, `--unregister`, …) through
+ * `command`; keeping the distribution running through `hold`.
+ *
+ * Four things are deliberate.
+ *
+ * There is no shell, on either side. The command and every argument reach `spawn` as array elements,
+ * and `wsl.exe --exec` hands them to the guest's `execvp` as they are — never to `/bin/sh` — so
+ * nothing in a model path, a container name or a descriptor field is ever interpreted.
+ *
+ * Text is decoded, not assumed. `wsl.exe`'s own messages are UTF-16LE (`WSL_UTF8=1`, set on every
+ * call, asks for UTF-8, which an older WSL ignores), while a guest command's output is its own bytes,
+ * UTF-8; `decodeWslBytes` tells them apart.
+ *
+ * A command that could not answer — no `wsl.exe`, a spawn failure, past its deadline, aborted — is
+ * `code: null`, never a rejection: the same contract as `hostExec` and the docker executor, so a
+ * caller always gets one shape and reads "unknown" rather than "absent".
+ *
+ * The executable is injected. Production resolves the system `wsl.exe` from `%SystemRoot%`, never
+ * `PATH`; tests pass `process.execPath` with a fake script as `executableArgs`, which runs the same on
+ * a Windows CI runner as anywhere else (design D16).
+ */
+import { spawn } from 'node:child_process';
+/**
+ * Every command in a distribution runs through `env` with the system `PATH`. `wsl --exec` starts the
+ * program without a shell and with a `PATH` that has no `sbin`: `useradd`, `usermod` and the like
+ * were not found there (live acceptance, `execvpe(useradd) failed: No such file or directory`).
+ * Still one argv and no shell; `env` only sets `PATH` and resolves the program against it.
+ * `/usr/lib/wsl/lib` stays on it: WSL puts `nvidia-smi` and the NVIDIA user-mode libraries there and
+ * adds that directory to the `PATH` it gives a command itself (live acceptance: without it the probe
+ * could not read the library version).
+ */
+export declare const GUEST_PATH = "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/wsl/lib";
+/** What one `wsl.exe` call answered. `code: null`: it never got as far as an exit code. */
+export interface WslCommandOutput {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface WslCallOptions {
+    /** Overrides the default deadline for this call only. */
+    timeoutMs?: number;
+    /** Stops the call: it answers `code: null` and its process is killed. */
+    signal?: AbortSignal;
+    /** Written to the command's stdin, which is then closed. Without it stdin is not connected. */
+    input?: string | Buffer;
+    /** Each piece of stdout as it arrives, decoded as UTF-8 (a guest command's own bytes). */
+    onStdout?: (text: string) => void;
+}
+export interface WslExecOptions extends WslCallOptions {
+    /** `-u <user>`: the guest account to run as. The guest's default user when omitted. */
+    user?: string;
+}
+/** How a hold ended: `released` when the core let go itself, otherwise the process or the VM stopped. */
+export interface WslHoldEnd {
+    code: number | null;
+    signal: string | null;
+    released: boolean;
+}
+/** An attached `wsl.exe -d <name> --exec sleep infinity`: the distribution stays up while it lives. */
+export interface WslHold {
+    /** Resolves once, when the holding process is gone — whoever ended it. */
+    readonly exited: Promise<WslHoldEnd>;
+    /** Stop holding. Idempotent; `exited` then resolves with `released: true`. */
+    release(): void;
+}
+/** One distribution, as the core reaches it. */
+export interface WslDistributionTransport {
+    readonly name: string;
+    /** `wsl.exe -d <name> [-u <user>] --exec ...argv`. */
+    exec(argv: string[], options?: WslExecOptions): Promise<WslCommandOutput>;
+    hold(): WslHold;
+}
+export interface Wsl {
+    /** `wsl.exe ...args`: its own commands, output decoded from UTF-16 when it comes that way. */
+    command(args: string[], options?: WslCallOptions): Promise<WslCommandOutput>;
+    distribution(name: string): WslDistributionTransport;
+}
+export interface WslOptions {
+    /** The `wsl.exe` to run; `defaultWslExecutable(process.env)` when omitted. */
+    executable?: string;
+    /** Arguments placed before every call's own (a test's fake script and its state folder). */
+    executableArgs?: string[];
+    /** The environment the process starts with; `process.env` when omitted. */
+    env?: NodeJS.ProcessEnv;
+    /** Ask `wsl.exe` for UTF-8 (`WSL_UTF8=1`). On by default; a test turns it off to exercise UTF-16. */
+    utf8?: boolean;
+    /** Default deadline per call. */
+    timeoutMs?: number;
+    /** Per stream; past it the start and the end are kept (`HeadAndTail`). */
+    maxOutputBytes?: number;
+    /** Tests only: stands in for `child_process.spawn`. */
+    spawnProcess?: typeof spawn;
+}
+/** The system `wsl.exe`, from `%SystemRoot%` — never whatever `PATH` finds first. */
+export declare function defaultWslExecutable(env: Record<string, string | undefined>): string;
+/**
+ * `wsl.exe`'s own text is UTF-16LE; a guest command's is UTF-8. UTF-16 is recognised by its BOM or by
+ * NUL bytes — every ASCII character, `\r\n` included, carries one, and a guest's text output has
+ * none — so a localized message (Cyrillic, CJK) decodes as well as an English one.
+ */
+export declare function decodeWslBytes(bytes: Buffer): string;
+export declare function createWsl(options?: WslOptions): Wsl;

package/dist/runtime/wsl/transport.js

@@ -0,0 +1,181 @@
+/**
+ * Running things inside WSL from Windows (change `add-tensorrt-llm-windows`, task 2.2, design D1):
+ * the one place `wsl.exe` is spawned. Everything the core does in Atomic Chat's own distribution —
+ * probing the guest, running the install recipe, every docker call, the Engine API pull — goes
+ * through `exec`; `wsl.exe`'s own commands (`--list`, `--import`, `--unregister`, …) through
+ * `command`; keeping the distribution running through `hold`.
+ *
+ * Four things are deliberate.
+ *
+ * There is no shell, on either side. The command and every argument reach `spawn` as array elements,
+ * and `wsl.exe --exec` hands them to the guest's `execvp` as they are — never to `/bin/sh` — so
+ * nothing in a model path, a container name or a descriptor field is ever interpreted.
+ *
+ * Text is decoded, not assumed. `wsl.exe`'s own messages are UTF-16LE (`WSL_UTF8=1`, set on every
+ * call, asks for UTF-8, which an older WSL ignores), while a guest command's output is its own bytes,
+ * UTF-8; `decodeWslBytes` tells them apart.
+ *
+ * A command that could not answer — no `wsl.exe`, a spawn failure, past its deadline, aborted — is
+ * `code: null`, never a rejection: the same contract as `hostExec` and the docker executor, so a
+ * caller always gets one shape and reads "unknown" rather than "absent".
+ *
+ * The executable is injected. Production resolves the system `wsl.exe` from `%SystemRoot%`, never
+ * `PATH`; tests pass `process.execPath` with a fake script as `executableArgs`, which runs the same on
+ * a Windows CI runner as anywhere else (design D16).
+ */
+import { spawn } from 'node:child_process';
+import { StringDecoder } from 'node:string_decoder';
+import { HeadAndTail } from '../shared/index.js';
+/**
+ * Every command in a distribution runs through `env` with the system `PATH`. `wsl --exec` starts the
+ * program without a shell and with a `PATH` that has no `sbin`: `useradd`, `usermod` and the like
+ * were not found there (live acceptance, `execvpe(useradd) failed: No such file or directory`).
+ * Still one argv and no shell; `env` only sets `PATH` and resolves the program against it.
+ * `/usr/lib/wsl/lib` stays on it: WSL puts `nvidia-smi` and the NVIDIA user-mode libraries there and
+ * adds that directory to the `PATH` it gives a command itself (live acceptance: without it the probe
+ * could not read the library version).
+ */
+export const GUEST_PATH = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/wsl/lib';
+const GUEST_ENV_PREFIX = ['/usr/bin/env', `PATH=${GUEST_PATH}`];
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_MAX_OUTPUT_BYTES = 4 * 1024 * 1024;
+const NUL = 0x00;
+const BOM = '\ufeff';
+/** The system `wsl.exe`, from `%SystemRoot%` — never whatever `PATH` finds first. */
+export function defaultWslExecutable(env) {
+    const root = env['SystemRoot'] ?? env['SYSTEMROOT'] ?? 'C:\\Windows';
+    return `${root.replace(/[\\/]+$/, '')}\\System32\\wsl.exe`;
+}
+/**
+ * `wsl.exe`'s own text is UTF-16LE; a guest command's is UTF-8. UTF-16 is recognised by its BOM or by
+ * NUL bytes — every ASCII character, `\r\n` included, carries one, and a guest's text output has
+ * none — so a localized message (Cyrillic, CJK) decodes as well as an English one.
+ */
+export function decodeWslBytes(bytes) {
+    if (bytes.length === 0)
+        return '';
+    const bom = bytes.length >= 2 && bytes[0] === 0xff && bytes[1] === 0xfe;
+    const text = bom || bytes.includes(NUL) ? bytes.toString('utf16le') : bytes.toString('utf8');
+    return text.startsWith(BOM) ? text.slice(1) : text;
+}
+export function createWsl(options = {}) {
+    const executable = options.executable ?? defaultWslExecutable(process.env);
+    const prefix = options.executableArgs ?? [];
+    const limit = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const doSpawn = options.spawnProcess ?? spawn;
+    const env = {
+        ...(options.env ?? process.env),
+        ...(options.utf8 === false ? {} : { WSL_UTF8: '1' }),
+    };
+    const run = (args, call = {}) => new Promise((resolve) => {
+        const timeoutMs = call.timeoutMs ?? options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (call.signal?.aborted === true) {
+            resolve({ code: null, stdout: '', stderr: 'aborted before it started' });
+            return;
+        }
+        let settled = false;
+        let child;
+        const stdout = new HeadAndTail(limit);
+        const stderr = new HeadAndTail(limit);
+        const streaming = call.onStdout === undefined ? null : new StringDecoder('utf8');
+        const finish = (output) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            call.signal?.removeEventListener('abort', onAbort);
+            resolve(output);
+        };
+        const stop = (why) => {
+            child?.kill('SIGKILL');
+            finish({ code: null, stdout: '', stderr: why });
+        };
+        const onAbort = () => stop('aborted');
+        // Armed before the spawn, so a spawn that throws on the spot still has a real timer to clear.
+        const timer = setTimeout(() => stop(`wsl.exe did not answer within ${timeoutMs} ms`), timeoutMs);
+        timer.unref();
+        call.signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            child = doSpawn(executable, [...prefix, ...args], {
+                shell: false,
+                windowsHide: true,
+                stdio: [call.input === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'],
+                env,
+            });
+        }
+        catch (error) {
+            finish({ code: null, stdout: '', stderr: error.message });
+            return;
+        }
+        child.stdout?.on('data', (chunk) => {
+            stdout.push(chunk);
+            if (streaming !== null)
+                call.onStdout?.(streaming.write(chunk));
+        });
+        child.stderr?.on('data', (chunk) => stderr.push(chunk));
+        if (call.input !== undefined) {
+            // A command that exits without reading its stdin closes the pipe under us; that is its answer.
+            child.stdin?.on('error', () => undefined);
+            child.stdin?.end(call.input);
+        }
+        // A missing executable arrives here as ENOENT, not as an exit code.
+        child.on('error', (error) => finish({ code: null, stdout: '', stderr: error.message }));
+        child.on('close', (code) => {
+            if (streaming !== null) {
+                const rest = streaming.end();
+                if (rest !== '')
+                    call.onStdout?.(rest);
+            }
+            finish({ code, stdout: decodeWslBytes(stdout.bytes()), stderr: decodeWslBytes(stderr.bytes()) });
+        });
+    });
+    const distribution = (name) => ({
+        name,
+        exec: (argv, call = {}) => run([
+            '-d',
+            name,
+            ...(call.user === undefined ? [] : ['-u', call.user]),
+            '--exec',
+            ...GUEST_ENV_PREFIX,
+            ...argv,
+        ], call),
+        hold: () => {
+            let released = false;
+            let child;
+            const exited = new Promise((resolve) => {
+                let settled = false;
+                const end = (code, signal) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    resolve({ code, signal, released });
+                };
+                try {
+                    child = doSpawn(executable, [...prefix, '-d', name, '--exec', 'sleep', 'infinity'], {
+                        shell: false,
+                        windowsHide: true,
+                        stdio: 'ignore',
+                        env,
+                    });
+                }
+                catch {
+                    end(null, null);
+                    return;
+                }
+                child.on('error', () => end(null, null));
+                child.on('exit', (code, signal) => end(code, signal));
+            });
+            return {
+                exited,
+                release: () => {
+                    if (released)
+                        return;
+                    released = true;
+                    child?.kill('SIGKILL');
+                },
+            };
+        },
+    });
+    return { command: run, distribution };
+}
+//# sourceMappingURL=transport.js.map

package/dist/runtime/wsl/transport.js.map

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

package/dist/server/control/index.d.ts

@@ -9,4 +9,4 @@
  */
 export { ControlServer } from './server.js';
 export { SSE_HEARTBEAT_MS } from './types.js';
-export type { BackendControl, ChatGptControl, CloudControl, ControlServerDeps, ControlSnapshot, DiffusionControl, DiskControl, ExternalSessionControl, ModelControl, PublicServerControl, RemoteAccessControl, SessionSummary, SettingsControl, } from './types.js';
+export type { BackendControl, ChatGptControl, CloudControl, ControlServerDeps, ControlSnapshot, DecisionControl, DiffusionControl, DiskControl, ExternalSessionControl, ModelControl, PublicServerControl, RemoteAccessControl, SessionSummary, SettingsControl, } from './types.js';

package/dist/server/control/router.js

@@ -8,13 +8,19 @@ import { Router } from '../http.js';
 import { registerBackendRoutes } from './routes/backends.js';
 import { registerClientRoutes } from './routes/clients.js';
 import { registerCloudRoutes } from './routes/cloud.js';
+import { registerDecisionRoutes } from './routes/decision.js';
+import { registerEmbeddingRoutes } from './routes/embedding.js';
 import { registerDiffusionRoutes } from './routes/diffusion.js';
 import { registerDiffusionVideoRoutes } from './routes/diffusion-video.js';
 import { registerDiskRoutes } from './routes/disk.js';
+import { registerEngineBuildRoutes } from './routes/engine-builds.js';
+import { registerEngineRoutes } from './routes/engines.js';
+import { registerEnvironmentRoutes } from './routes/environments.js';
 import { registerExternalSessionRoutes } from './routes/external-sessions.js';
 import { registerHardwareRoutes } from './routes/hardware.js';
 import { registerLifecycleRoutes, registerShutdownRoute } from './routes/lifecycle.js';
 import { registerModelRoutes } from './routes/models.js';
+import { registerModelSetupRoutes } from './routes/model-setups.js';
 import { registerPublicServerRoutes } from './routes/public-server.js';
 import { registerRemoteAccessRoutes } from './routes/remote-access.js';
 import { registerSettingsRoutes } from './routes/settings.js';
@@ -38,15 +44,22 @@ export function buildRouter(deps, self) {
         clients: deps.clients.list(),
         downloads: [],
         optimal_backends: deps.backends.optimalSnapshot(),
+        environments: deps.environmentsSnapshot?.() ?? [],
+        environment_operations: deps.environmentOperations?.() ?? [],
+        model_setups: deps.modelSetups?.snapshot() ?? [],
     });
     const ctx = { p, now, startedAt, snapshot, self };
     const router = new Router();
     registerLifecycleRoutes(router, deps, ctx);
     registerClientRoutes(router, deps, ctx);
     registerModelRoutes(router, deps, ctx);
+    registerModelSetupRoutes(router, deps, ctx);
     registerBackendRoutes(router, deps, ctx);
+    registerEngineBuildRoutes(router, deps, ctx);
+    registerEngineRoutes(router, deps, ctx);
     registerHardwareRoutes(router, deps, ctx);
     registerDiskRoutes(router, deps, ctx);
+    registerEnvironmentRoutes(router, deps, ctx);
     registerSettingsRoutes(router, deps, ctx);
     registerExternalSessionRoutes(router, deps, ctx);
     registerCloudRoutes(router, deps, ctx);
@@ -54,6 +67,8 @@ export function buildRouter(deps, self) {
     registerRemoteAccessRoutes(router, deps, ctx);
     registerDiffusionRoutes(router, deps, ctx);
     registerDiffusionVideoRoutes(router, deps, ctx);
+    registerDecisionRoutes(router, deps, ctx);
+    registerEmbeddingRoutes(router, deps, ctx);
     registerTelemetryRoutes(router, deps, ctx);
     registerShutdownRoute(router, deps, ctx);
     return router;

package/dist/server/control/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/server/control/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/server/control/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAI/D,MAAM,UAAU,WAAW,CAAC,IAAuB,EAAE,IAAqC;IACxF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,CAAA;IACzC,MAAM,CAAC,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,GAAG,kBAAkB,GAAG,MAAM,EAAE,CAAA;IAC9D,MAAM,QAAQ,GAAG,GAAoB,EAAE,CAAC,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,QAAQ,EAAE,wBAAwB;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,GAAG,EAAE,GAAG,SAAS;QAC5B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5B,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE;QACjD,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE;QACjD,sBAAsB,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE;QAC5D,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;KACjD,CAAC,CAAA;IACF,MAAM,GAAG,GAAwB,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAEtE,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;IAE3B,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACvC,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACtC,wBAAwB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC3C,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACxC,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC5C,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACvC,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACzC,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACrC,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC5C,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACzC,6BAA6B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAChD,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACtC,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC7C,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC7C,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,4BAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/C,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACzC,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAExC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/server/control/routes/backends.js

@@ -1,5 +1,6 @@
 /** llama.cpp backend packs and the download tasks that install them. */
 import { AtomicCoreError } from '../../../contracts/index.js';
+import { isLlamacppProviderId } from '../../../backend/index.js';
 import { queryOf, readJsonBody, sendError, sendJson } from '../../http.js';
 export function registerBackendRoutes(router, deps, ctx) {
     const { p } = ctx;
@@ -35,6 +36,31 @@ export function registerBackendRoutes(router, deps, ctx) {
         const result = await deps.backends.setOptimal(params['provider'], body.optimal ?? null, body.expected_revision);
         sendJson(res, result.status === 'conflict' ? 409 : 200, result);
     });
+    // The advisor answers; the app decides when to act (ADR 2026-09-27). All three are POST because the
+    // proxy policy may carry credentials, and those never travel in a query string.
+    const llamacppProvider = (raw) => {
+        if (!isLlamacppProviderId(raw))
+            throw new AtomicCoreError('INVALID_ARGUMENT', `The backend advisor knows llamacpp-upstream, llamacpp and atomic-prism, not ${raw}`);
+        return raw;
+    };
+    router.post(p('/backends/:provider/catalog'), async (req, res, { params }) => {
+        const provider = llamacppProvider(params['provider']);
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await deps.backends.catalog(provider, body));
+    });
+    router.post(p('/backends/:provider/recommendation'), async (req, res, { params }) => {
+        const provider = llamacppProvider(params['provider']);
+        const body = await readJsonBody(req);
+        if (body.mode !== 'refresh' && body.mode !== 'recheck')
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'recommendation needs mode: refresh or recheck'));
+        // `detection_failed` is an outcome the caller reads, not an error: the current backend stays.
+        sendJson(res, 200, await deps.backends.recommend(provider, body));
+    });
+    router.post(p('/backends/:provider/updates'), async (req, res, { params }) => {
+        const provider = llamacppProvider(params['provider']);
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await deps.backends.checkUpdates(provider, body));
+    });
     router.post(p('/downloads/*taskId/cancel'), (_req, res, { params }) => {
         sendJson(res, 200, { cancelled: deps.backends.cancel(params['taskId']) });
     });

package/dist/server/control/routes/backends.js.map

@@ -1 +1 @@
-{"version":3,"file":"backends.js","sourceRoot":"","sources":["../../../../src/server/control/routes/backends.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backends.js","sourceRoot":"","sources":["../../../../src/server/control/routes/backends.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAQ7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAI1E,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,IAAuB,EACvB,GAAwB;IAExB,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAA;IAEjB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QACjD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAW,EAAE,OAAO,CAAC;SAC1E,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,8FAA8F;IAC9F,8DAA8D;IAC9D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3E,MAAM,IAAI,GAAG,MAAM,YAAY,CAQ5B,GAAG,CAAC,CAAA;QACP,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO;YACjD,OAAO,SAAS,CACd,GAAG,EACH,IAAI,eAAe,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CACtF,CAAA;QACH,QAAQ,CACN,GAAG,EACH,GAAG,EACH,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAW,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACpF,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClG,CAAC,CACH,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,4FAA4F;IAC5F,iGAAiG;IACjG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3E,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAW,CAAC,CAAC,CAAA;IAClF,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1E,MAAM,IAAI,GAAG,MAAM,YAAY,CAG5B,GAAG,CAAC,CAAA;QACP,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC5E,OAAO,SAAS,CACd,GAAG,EACH,IAAI,eAAe,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CACtF,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAC3C,MAAM,CAAC,UAAU,CAAW,EAC5B,IAAI,CAAC,OAAO,IAAI,IAAI,EACpB,IAAI,CAAC,iBAAiB,CACvB,CAAA;QACD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,oGAAoG;IACpG,gFAAgF;IAChF,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAsB,EAAE;QAC3D,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;YAC5B,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,+EAA+E,GAAG,EAAE,CACrF,CAAA;QACH,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAW,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAwB,GAAG,CAAC,CAAA;QAC3D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,oCAAoC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAW,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,MAAM,YAAY,CAA+B,GAAG,CAAC,CAAA;QAClE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YACpD,OAAO,SAAS,CACd,GAAG,EACH,IAAI,eAAe,CAAC,kBAAkB,EAAE,+CAA+C,CAAC,CACzF,CAAA;QACH,8FAA8F;QAC9F,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,6BAA6B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAW,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,MAAM,YAAY,CAA4B,GAAG,CAAC,CAAA;QAC/D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACpE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAW,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,uCAAuC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACxF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,OAAO,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CACjC,MAAM,CAAC,UAAU,CAAW,EAC5B,MAAM,CAAC,SAAS,CAAW,EAC3B,MAAM,CAAC,SAAS,CAAW,CAC5B;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/server/control/routes/decision.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The decision model: status, configuration, load and unload, and the two fail-open calls
+ * (ADR 2026-09-30-the-decision-model-is-its-own-core-module). Bodies are snake_case like the engine
+ * and `settings.json`. `score` and `decide` answer 200 with an outcome once the body parses:
+ * `{unavailable: false, result}` or `{unavailable: true, reason, message}`, the same value an in-core
+ * caller gets. A body that is not JSON or not a valid request is 400 `INVALID_ARGUMENT`.
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerDecisionRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

package/dist/server/control/routes/decision.js

@@ -0,0 +1,43 @@
+/**
+ * The decision model: status, configuration, load and unload, and the two fail-open calls
+ * (ADR 2026-09-30-the-decision-model-is-its-own-core-module). Bodies are snake_case like the engine
+ * and `settings.json`. `score` and `decide` answer 200 with an outcome once the body parses:
+ * `{unavailable: false, result}` or `{unavailable: true, reason, message}`, the same value an in-core
+ * caller gets. A body that is not JSON or not a valid request is 400 `INVALID_ARGUMENT`.
+ */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { parseDecideRequest, parseScoreRequest } from '../../../decision/index.js';
+import { readJsonBody, sendJson } from '../../http.js';
+function control(deps) {
+    if (!deps.decision)
+        throw new AtomicCoreError('DECISION_UNAVAILABLE', 'The decision model is not available in this core.');
+    return deps.decision;
+}
+export function registerDecisionRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    const configAnswer = (decision) => ({
+        config: decision.config(),
+        status: decision.status(),
+    });
+    router.get(p('/decision/status'), async (_req, res) => sendJson(res, 200, control(deps).status()));
+    router.get(p('/decision/config'), async (_req, res) => sendJson(res, 200, configAnswer(control(deps))));
+    router.put(p('/decision/config'), async (req, res) => {
+        const decision = control(deps);
+        const patch = await readJsonBody(req);
+        if (typeof patch !== 'object' || patch === null || Array.isArray(patch))
+            throw new AtomicCoreError('INVALID_ARGUMENT', 'The decision settings must be a JSON object.');
+        await decision.configure(patch);
+        sendJson(res, 200, configAnswer(decision));
+    });
+    router.post(p('/decision/load'), async (_req, res) => sendJson(res, 200, await control(deps).load()));
+    router.post(p('/decision/unload'), async (_req, res) => sendJson(res, 200, await control(deps).unload()));
+    router.post(p('/decision/score'), async (req, res) => {
+        const decision = control(deps);
+        sendJson(res, 200, await decision.score(parseScoreRequest(await readJsonBody(req))));
+    });
+    router.post(p('/decision/decide'), async (req, res) => {
+        const decision = control(deps);
+        sendJson(res, 200, await decision.decide(parseDecideRequest(await readJsonBody(req))));
+    });
+}
+//# sourceMappingURL=decision.js.map

package/dist/server/control/routes/decision.js.map

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

package/dist/server/control/routes/diffusion-video.js

@@ -14,6 +14,10 @@ export function registerDiffusionVideoRoutes(router, deps, ctx) {
     router.get(p('/diffusion/video/capabilities'), (_req, res) => sendJson(res, 200, diffusion.getVideoCapabilities()));
     // --- jobs ------------------------------------------------------------------------------------
     router.post(p('/diffusion/video/jobs'), async (req, res) => sendJson(res, 200, await diffusion.generateVideo(parseVideoGenerateRequest(await readJsonBody(req, MAX_GENERATE_BODY_BYTES)))));
+    // The same body as a job; nothing starts, and it answers while another job runs.
+    router.post(p('/diffusion/video/estimate'), async (req, res) => sendJson(res, 200, {
+        estimate: await diffusion.estimateVideo(parseVideoGenerateRequest(await readJsonBody(req, MAX_GENERATE_BODY_BYTES))),
+    }));
     router.get(p('/diffusion/video/jobs/:jobId'), (_req, res, { params }) => sendJson(res, 200, { job: diffusion.getVideoJob(params['jobId']) }));
     router.post(p('/diffusion/video/jobs/:jobId/cancel'), async (_req, res, { params }) => sendJson(res, 200, await diffusion.cancelVideoJob(params['jobId'])));
     // --- gallery ---------------------------------------------------------------------------------

package/dist/server/control/routes/diffusion-video.js.map

@@ -1 +1 @@
-{"version":3,"file":"diffusion-video.js","sourceRoot":"","sources":["../../../../src/server/control/routes/diffusion-video.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diffusion-video.js","sourceRoot":"","sources":["../../../../src/server/control/routes/diffusion-video.ts"],"names":[],"mappings":"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"}

package/dist/server/control/routes/diffusion.d.ts

@@ -2,7 +2,7 @@
  * Image generation: one route per operation of the app's `DiffusionService`, in its camelCase
  * (ADR 2026-09-17-diffusion-speaks-the-apps-camelcase-and-error-codes-verbatim). File-system paths
  * travel in bodies, never in the URL. Lists and lookups that may be empty are wrapped
- * (`{backends}`, `{files}`, `{job}`, `{item}`) so a `null` never stands alone as a body.
+ * (`{files}`, `{job}`, `{item}`) so a `null` never stands alone as a body.
  */
 import type { IncomingMessage } from 'node:http';
 import type { Router } from '../../http.js';