@atomic-chat/core 0.5.1 → 0.13.6

package/dist/core/tensorrt-llm.js

@@ -0,0 +1,428 @@
+/**
+ * Composition of the `tensorrt-llm` provider for `create.ts` (task 2.14): offered only on Linux, on
+ * the managed-text lifecycle built over the core's one Docker executor and journal — the startup
+ * handle the managed environment (task 2.6) wires, reconciles and hands its setup and removal too,
+ * never a second pair — the desktop deployment, this scope's managed paths,
+ * `selinuxDataRoot = <data>`, and the public server's live trusted-hosts array.
+ *
+ * What it shares with the managed environment rather than duplicating: the installation records
+ * (`InstallationStore`, the one reader of that format), the Linux machine (`LinuxHost`, which is the
+ * `ATOMIC_MANAGED_TEST_HOST` stand-in machine in the e2e suite, so that hook is read in one place),
+ * and, the other way round, `unloadEngineSessions`: a removal of the engine holds its loads off and
+ * unloads its loaded model first, through `tensorrtLlmSessionUnloader` and the facade's own unload.
+ *
+ * `wireTensorrtLlmModelCheck` (task 2.16) composes `POST /models/tensorrt-llm/check`'s deps
+ * separately from the runtime above: it shares the installation records, the descriptor provider and
+ * `LinuxHost.probeDeps`, but deliberately never touches `containers`/Docker (`check.ts`'s own file
+ * banner explains why) and is offered even when the runtime itself would refuse every load.
+ *
+ * `tensorrtLlmModelDeleter` (task 2.24) is `DELETE /models/tensorrt-llm/:id`: the same hold-and-unload
+ * through the facade as the engine removal's unloader, for one model, then its files.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { RECONCILE_BUDGET_MS, RECONCILE_CALL_TIMEOUT_MS, RECONCILE_STARTUP_STOP_TIMEOUT_SECONDS, createDockerExec, guestRealpath, reconcileExecutions, } from '../runtime/container/index.js';
+import { guestProbeDeps, localhostForwardingError, parseWslConfig, TENSORRT_LLM_ENGINE_ID, } from '../runtime/environment/index.js';
+import { ManagedTextAdapterRegistry, ManagedTextLifecycle, createDesktopManagedDeployment, createWslManagedDeployment, } from '../runtime/managed-text/index.js';
+import { TensorrtLlmModelRegistry, TensorrtLlmRuntime, checkTensorrtLlmModel, containerPlatformFor, deleteTensorrtLlmModelFiles, guestModelFiles, guestModelsRoot, linuxModelLocation, probeTensorrtLlmGpus, probeTensorrtLlmGpusAndMemory, probeTensorrtLlmHost, readTensorrtLlmModel, resolveReadyInstallation, tensorrtLlmAdapter, windowsModelLocation, } from '../runtime/tensorrt-llm/index.js';
+import { ensureGuestScope, guestScopePaths, WSL_LOCALHOST_MOUNT, } from '../runtime/wsl/index.js';
+/** The recorded distribution and its transport; null before the import. */
+async function windowsDistribution(context) {
+    const record = await context.records.read();
+    return record === null ? null : { record, transport: context.wsl.distribution(record.distribution.name) };
+}
+async function windowsGuest(context, layout) {
+    const record = await context.records.read();
+    if (record === null)
+        return null;
+    const name = record.distribution.name;
+    const key = await context.scopeKey();
+    return {
+        record,
+        transport: context.wsl.distribution(name),
+        key,
+        paths: guestScopePaths(layout.managed, name, key, context.mount),
+        modelsRoot: (context.mount ?? WSL_LOCALHOST_MOUNT).hostPath(name, guestModelsRoot(key)),
+    };
+}
+const notImported = () => new AtomicCoreError('MANAGED_ADAPTER_UNAVAILABLE', 'TensorRT-LLM runs in Atomic Chat’s WSL distribution, which is not set up on this computer yet.');
+/** Windows on x64 only: no WSL GPU path for ARM (spec `tensorrt-llm-desktop`). */
+const windowsX64 = (platform, arch, context) => platform === 'win32' && arch === 'x64' && context !== undefined;
+/** The provider, or null where it is not offered: everywhere but Linux and Windows x64. */
+export function wireTensorrtLlm(options) {
+    if (options.windows !== undefined && windowsX64(options.platform, options.arch, options.windows)) {
+        return wireWindowsTensorrtLlm(options, options.windows);
+    }
+    if (options.platform !== 'linux')
+        return null;
+    const adapters = new ManagedTextAdapterRegistry();
+    adapters.register(tensorrtLlmAdapter);
+    const deployment = createDesktopManagedDeployment();
+    /** The lifecycle and the executor it was built over: the load path's probe asks the same one. */
+    let built = null;
+    // Asked at every load, through the handle: a host with no docker CLI when core started gets one
+    // from the setup's privileged step, and the next load finds it (the handle wires it then).
+    const lifecycle = async () => {
+        if (built !== null)
+            return built.lifecycle;
+        const containers = await options.containers.resolve();
+        if (containers === null)
+            return null;
+        // Two loads that raced here built nothing twice: the first to resume assigns, the second reuses.
+        built ??= {
+            exec: containers.exec,
+            lifecycle: new ManagedTextLifecycle({
+                provider: 'tensorrt-llm',
+                adapters,
+                exec: containers.exec,
+                deployment,
+                journal: containers.journal,
+                paths: options.layout.managed,
+                instanceId: options.instanceId,
+                scope: options.scope,
+                allowedHosts: options.trustedHosts,
+                selinuxDataRoot: options.layout.root,
+                emit: options.emit,
+                log: options.log,
+                ...(options.containerUser === null ? {} : { containerUser: options.containerUser }),
+            }),
+        };
+        return built.lifecycle;
+    };
+    const platform = containerPlatformFor(options.arch);
+    return new TensorrtLlmRuntime({
+        lifecycle,
+        readyInstallation: () => resolveReadyInstallation({
+            installations: options.installations,
+            descriptors: options.descriptors,
+            platform,
+        }),
+        // Probed fresh at every load, never read off the environment snapshot: that view is only as new
+        // as the last setup or removal probe (and empty after a restart), while a card can disappear
+        // between two loads (spec "Выбранная карта исчезла"). An unanswered `docker info` refuses the load.
+        // Through the lifecycle's own executor: `TensorrtLlmRuntime` asks for host facts only once the
+        // lifecycle resolved, so it is always there (final review T-288 removed a dead fallback).
+        hostFacts: () => probeTensorrtLlmHost({
+            exec: options.host.probeDeps.exec,
+            docker: built.exec,
+            nvidiaSmi: 'nvidia-smi',
+            readFile: options.host.probeDeps.readFile,
+        }),
+        model: (modelId) => readTensorrtLlmModel(options.layout.provider('tensorrt-llm').modelsDir, modelId),
+        settings: options.settings,
+        ...(options.claimGpu ? { claimGpu: options.claimGpu } : {}),
+    });
+}
+/**
+ * The Windows provider (change `add-tensorrt-llm-windows`, tasks 2.6–2.8): the same lifecycle and
+ * runtime as Linux, over the WSL guest — the core's one executor (the guest's docker, from the handle),
+ * this scope's folder in the guest for heartbeats, caches and the watchdog, the WSL deployment (a port
+ * Docker picks, forwarding checked), `realpath` in the guest, uid 1000 for the container, the
+ * distribution held while a model loads or is loaded; the host facts of a load read in the guest
+ * (its `nvidia-smi`, the VM's memory); models under the scope's guest root.
+ */
+function wireWindowsTensorrtLlm(options, context) {
+    const adapters = new ManagedTextAdapterRegistry();
+    adapters.register(tensorrtLlmAdapter);
+    let built = null;
+    const lifecycle = async () => {
+        if (built !== null)
+            return built.lifecycle;
+        const guest = await windowsGuest(context, options.layout);
+        if (guest === null)
+            throw notImported();
+        const containers = await options.containers.resolve();
+        if (containers === null)
+            return null;
+        await ensureGuestScope(guest.transport, guest.key);
+        const deployment = windowsDeployment(context, guest, containers.exec);
+        const name = guest.record.distribution.name;
+        built ??= {
+            exec: containers.exec,
+            guest,
+            lifecycle: new ManagedTextLifecycle({
+                provider: 'tensorrt-llm',
+                adapters,
+                exec: containers.exec,
+                deployment,
+                journal: containers.journal,
+                paths: guest.paths,
+                instanceId: options.instanceId,
+                scope: options.scope,
+                allowedHosts: options.trustedHosts,
+                // SELinux is not enforcing in Atomic Chat's Ubuntu guest; never used, but must be in the guest.
+                selinuxDataRoot: guest.paths.root,
+                emit: options.emit,
+                log: options.log,
+                createContainerDeps: { realpath: guestRealpath(guest.transport) },
+                containerUser: { uid: 1000, gid: 1000 },
+                keeper: context.keeper(name),
+            }),
+        };
+        return built.lifecycle;
+    };
+    const platform = containerPlatformFor(options.arch);
+    return new TensorrtLlmRuntime({
+        lifecycle,
+        readyInstallation: () => resolveReadyInstallation({
+            installations: options.installations,
+            descriptors: options.descriptors,
+            platform,
+        }),
+        hostFacts: () => {
+            const current = built;
+            const deps = guestProbeDeps(current.guest.transport);
+            return probeTensorrtLlmHost({
+                exec: deps.exec,
+                docker: current.exec,
+                nvidiaSmi: 'nvidia-smi',
+                readFile: deps.readFile,
+            });
+        },
+        model: async (modelId) => {
+            const guest = await windowsGuest(context, options.layout);
+            if (guest === null)
+                throw notImported();
+            return readTensorrtLlmModel(guest.modelsRoot, modelId);
+        },
+        settings: options.settings,
+        ...(options.claimGpu ? { claimGpu: options.claimGpu } : {}),
+    });
+}
+/**
+ * The WSL deployment of one guest (task 2.7): its mounts through the context's mount, the engine probed
+ * inside the guest as root, and the forwarding error built from `.wslconfig` as it reads at that moment.
+ */
+export function windowsDeployment(context, guest, exec) {
+    return createWslManagedDeployment({
+        distribution: guest.record.distribution.name,
+        ...(context.mount === undefined ? {} : { mount: context.mount }),
+        exec,
+        runInGuest: (argv) => guest.transport.exec(argv, { user: 'root', timeoutMs: 10_000 }),
+        forwardingError: async () => localhostForwardingError(parseWslConfig(await context.host.probeDeps.readWslConfig().catch(() => null))),
+    });
+}
+/** The retried reconcile's executor where the wired one already is the guest's (Windows). */
+export const wiredExec = (wired) => wired.exec;
+/**
+ * `GET /models/tensorrt-llm/location` (change `add-tensorrt-llm-windows`, task 2.8): `<data>/tensorrt-llm/models`
+ * on Linux; the scope's folder in the WSL guest on Windows (`MANAGED_ADAPTER_UNAVAILABLE` before the import).
+ */
+export function tensorrtLlmModelLocation(platform, layout, windows) {
+    if (platform === 'win32' && windows !== undefined) {
+        return () => windowsModelLocation({
+            records: windows.records,
+            scopeKey: windows.scopeKey,
+            transport: (name) => windows.wsl.distribution(name),
+            volumeFreeBytes: (path) => windows.host.freeDiskBytes(path),
+            ...(windows.mount === undefined ? {} : { mount: windows.mount }),
+        });
+    }
+    return () => linuxModelLocation(layout.provider('tensorrt-llm').modelsDir);
+}
+/** The `tensorrt-llm` model registry: the data folder's root on Linux, the guest root (once it exists) on Windows. */
+export function tensorrtLlmModelRegistry(platform, layout, windows) {
+    if (platform === 'win32' && windows !== undefined) {
+        return new TensorrtLlmModelRegistry(async () => (await windowsGuest(windows, layout))?.modelsRoot ?? null);
+    }
+    return new TensorrtLlmModelRegistry(layout.provider('tensorrt-llm').modelsDir);
+}
+/** `windowsModelFiles` bound to one context and layout: the deleter's `windowsFiles` on Windows. */
+export function windowsModelFilesFor(windows, layout) {
+    return () => windowsModelFiles(windows, layout);
+}
+/** Windows: where a model's files and caches are, and how to size and remove them (in the guest). */
+export async function windowsModelFiles(windows, layout) {
+    const guest = await windowsGuest(windows, layout);
+    if (guest === null)
+        throw notImported();
+    return { paths: guest.paths, files: guestModelFiles(guest.transport, windows.mount) };
+}
+/**
+ * `POST /models/tensorrt-llm/check` (task 2.16): `null` off Linux, where the provider is not offered
+ * at all. Available even when the engine is not installed yet — the check falls back to the latest
+ * cached descriptor itself (`check.ts`) — and never asks Docker anything, unlike `wireTensorrtLlm`'s
+ * own `hostFacts` above.
+ */
+export function wireTensorrtLlmModelCheck(platform, options) {
+    const windows = options.windows;
+    if (windows !== undefined && windowsX64(platform, options.arch ?? 'x64', windows)) {
+        return (body) => checkTensorrtLlmModel(body, {
+            installations: options.installations,
+            descriptors: options.descriptors,
+            // The guest's cards and the WSL VM's memory once the distribution exists (design D11); before
+            // that, the cards Windows sees, with no memory to compare against.
+            hostFacts: async () => {
+                const guest = await windowsDistribution(windows);
+                if (guest === null) {
+                    const gpus = await probeTensorrtLlmGpus({
+                        exec: windows.host.probeDeps.exec,
+                        nvidiaSmi: `${windows.host.probeDeps.systemRoot}\\System32\\nvidia-smi.exe`,
+                    });
+                    return { gpus, memory: { availableBytes: 0, totalBytes: 0 } };
+                }
+                const deps = guestProbeDeps(guest.transport);
+                return probeTensorrtLlmGpusAndMemory({
+                    exec: deps.exec,
+                    nvidiaSmi: 'nvidia-smi',
+                    readFile: deps.readFile,
+                });
+            },
+            settings: options.settings,
+            wslVm: async () => ({
+                memory_setting: parseWslConfig(await windows.host.probeDeps.readWslConfig().catch(() => null))
+                    .memory,
+            }),
+        });
+    }
+    if (platform !== 'linux')
+        return null;
+    return (body) => checkTensorrtLlmModel(body, {
+        installations: options.installations,
+        descriptors: options.descriptors,
+        hostFacts: () => probeTensorrtLlmGpusAndMemory({
+            exec: options.host.probeDeps.exec,
+            nvidiaSmi: 'nvidia-smi',
+            readFile: options.host.probeDeps.readFile,
+        }),
+        settings: options.settings,
+    });
+}
+/**
+ * What GPU residency must see of the containers a previous core left (task 2.15; carry-forward from
+ * 2.12/2.14): startup reconcile could not confirm them stopped — the stop went unconfirmed, a docker
+ * call failed, or its time budget ran out — so they may still be running and holding a GPU. Which one
+ * is not recorded, so each holds every card, as `stop-unconfirmed`, under its engine id and container
+ * id, with the remedy a refusal names. Evicting one runs the reconcile again, bounded like the startup
+ * one (a short deadline per docker call, a short `--time`, a total budget), over this scope's journal
+ * only — this instance's own records are never touched — and it is released only once Docker confirms
+ * it gone.
+ */
+export function leftoverContainers(options) {
+    let latest = null;
+    const unresolved = (result) => [
+        ...result.unconfirmed,
+        ...result.failed,
+        ...result.skipped,
+    ];
+    const boundedExec = options.exec ??
+        ((wired) => createDockerExec({
+            dockerPath: wired.dockerPath,
+            dockerConfigDir: options.dockerConfigDir,
+            timeoutMs: RECONCILE_CALL_TIMEOUT_MS,
+        }));
+    const retry = async (wired) => {
+        const budget = new AbortController();
+        const budgetMs = options.budgetMs ?? RECONCILE_BUDGET_MS;
+        if (budgetMs <= 0)
+            budget.abort();
+        const timer = setTimeout(() => budget.abort(), Math.max(budgetMs, 0));
+        timer.unref?.();
+        try {
+            return await reconcileExecutions(wired.journal, options.instanceId, boundedExec(wired), options.log, RECONCILE_STARTUP_STOP_TIMEOUT_SECONDS, budget.signal);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+    return () => {
+        const wired = options.containers.current();
+        if (wired === null)
+            return [];
+        return unresolved(latest ?? wired.reconciled).map((record) => ({
+            provider: record.engine_id,
+            model_id: record.container_id,
+            cards: 'all',
+            auxiliary: false,
+            state: 'stop-unconfirmed',
+            remedy: `Start Docker, or remove container ${record.container_id} yourself ` +
+                `(docker rm -f ${record.container_id}); the next load retries the stop.`,
+            evict: async () => {
+                latest = await retry(wired);
+                if (unresolved(latest).some((left) => left.container_id === record.container_id)) {
+                    throw new Error(`Docker did not confirm container ${record.container_id} stopped.`);
+                }
+            },
+        }));
+    };
+}
+/**
+ * The managed environment's `unloadEngineSessions` (spec "Удаление при загруженной модели"): before
+ * a removal touches the engine's image, loads of `tensorrt-llm` are held off (`holdOffLoads`) and
+ * every model holding a card is unloaded with its container's stop confirmed — through the facade's
+ * own `unload`, as a client's unload or GPU residency would, so each model's cross-process claim is
+ * released and a load still pending is cancelled rather than queued behind (final review M-1). The
+ * hold lasts until the removal calls `release`. An unconfirmed stop rejects with
+ * `MANAGED_STOP_UNCONFIRMED`, which fails the removal with nothing removed, and lifts the hold at
+ * once. `runtime` and `sessions` are read at removal time: the provider is registered after the
+ * environment is wired, and the facade after both.
+ */
+export function tensorrtLlmSessionUnloader(runtime, sessions) {
+    return async (engineId) => {
+        if (engineId !== TENSORRT_LLM_ENGINE_ID)
+            return { unloaded: 0 };
+        const provider = runtime();
+        if (!(provider instanceof TensorrtLlmRuntime))
+            return { unloaded: 0 };
+        const release = provider.holdOffLoads();
+        try {
+            const facade = sessions();
+            const models = provider.residentModels();
+            for (const modelId of models) {
+                facade.cancelLoad(TENSORRT_LLM_ENGINE_ID, modelId);
+                const result = await facade.unload(TENSORRT_LLM_ENGINE_ID, modelId);
+                if (!result.success) {
+                    throw new AtomicCoreError('MANAGED_STOP_UNCONFIRMED', result.error ?? `The unload of ${modelId} failed.`, modelId);
+                }
+            }
+            return { unloaded: models.length, release };
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+    };
+}
+/**
+ * `DELETE /models/tensorrt-llm/:id` (task 2.24, design D12a, spec `tensorrt-llm-models` "Модель
+ * удаляется через core"). The id must be one the registry lists — exactly, never percent-decoded or
+ * resolved as a path — else `MODEL_NOT_FOUND`: a client's wrong id is an error, not a success. Loads
+ * of that model are held off for the whole deletion; a load in flight is cancelled and the model
+ * unloaded through the facade, as a client's unload would be, so its cross-process claim is released.
+ * Only once Docker confirmed the stop are the files touched; an unconfirmed stop rejects with
+ * `MANAGED_STOP_UNCONFIRMED` and removes nothing.
+ */
+export function tensorrtLlmModelDeleter(options) {
+    return async (modelId) => {
+        const provider = options.runtime();
+        if (!(provider instanceof TensorrtLlmRuntime)) {
+            throw new AtomicCoreError('PROVIDER_NOT_FOUND', 'tensorrt-llm is not available in this build.', TENSORRT_LLM_ENGINE_ID);
+        }
+        const model = (await options.registry.list()).find((entry) => entry.id === modelId);
+        if (model === undefined) {
+            throw new AtomicCoreError('MODEL_NOT_FOUND', `No tensorrt-llm model has the id '${modelId}'.`, modelId);
+        }
+        const release = provider.holdOffModel(modelId);
+        try {
+            const facade = options.sessions();
+            const cancelled = facade.cancelLoad(TENSORRT_LLM_ENGINE_ID, modelId);
+            const result = await facade.unload(TENSORRT_LLM_ENGINE_ID, modelId);
+            if (!result.success || provider.residentModels().includes(modelId)) {
+                throw new AtomicCoreError('MANAGED_STOP_UNCONFIRMED', result.error ?? `The container of ${modelId} did not confirm its stop; nothing was deleted.`, modelId);
+            }
+            const guest = options.windowsFiles === undefined ? null : await options.windowsFiles();
+            const files = guest === null
+                ? await deleteTensorrtLlmModelFiles(options.paths, model)
+                : await deleteTensorrtLlmModelFiles(guest.paths, model, guest.files);
+            return {
+                model_id: modelId,
+                was_loaded: cancelled || result.was_loaded === true,
+                freed_bytes: files.freedBytes,
+                engine_caches_removed: files.engineCachesRemoved,
+            };
+        }
+        finally {
+            release();
+        }
+    };
+}
+//# sourceMappingURL=tensorrt-llm.js.map

package/dist/core/tensorrt-llm.js.map

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

package/dist/core/types.d.ts

@@ -1,10 +1,14 @@
 import type { LocalProviderId } from '../contracts/index.js';
 import type { LoadOptions } from '../runtime/llamacpp/index.js';
-import type { LocalLoadOptions } from '../runtime/index.js';
+import type { BackendOutputSink, LocalLoadOptions } from '../runtime/index.js';
+import type { WireDecisionOptions } from '../decision/index.js';
+import type { WireEmbeddingOptions } from '../embedding/index.js';
 import type { WireDiffusionOptions } from '../diffusion/index.js';
+import type { HardwareProbeResult } from '../hardware/index.js';
 import type { Prober, TunnelSpawner, TunnelTimings } from '../remote-access/index.js';
 import type { TelemetryControl } from '../telemetry/index.js';
 export type CoreLogger = (level: 'info' | 'warn' | 'error', message: string) => void;
+export type { BackendOutputSink };
 export interface AtomicCoreOptions {
     ownerScope?: 'app' | 'cli';
     /** Explicit data folder; otherwise resolved like the app does (PLAN.md §8.2 "Data folder"). */
@@ -25,8 +29,37 @@ export interface AtomicCoreOptions {
     };
     /** Test seams of the image-generation service (a fake engine, short timings). */
     diffusion?: WireDiffusionOptions['overrides'];
+    /** Test seams of the decision module (a fake engine, installed packs, the `-h` probe). */
+    decision?: WireDecisionOptions['overrides'];
+    /** Test seams of the embedding module (a fake engine, installed packs). */
+    embedding?: WireEmbeddingOptions['overrides'];
+    /** Test seam of the hardware probe: a canned answer instead of the shell tools and sysfs. */
+    hardware?: {
+        probe?: () => Promise<HardwareProbeResult>;
+    };
     /** The platform runtimes are offered for (macOS-only engines are not registered elsewhere). Test seam. */
     platform?: NodeJS.Platform;
+    /**
+     * Test seam: the docker CLI managed text runtimes run on Linux. Omitted, it is resolved from the
+     * system directories (`/usr/bin`, `/usr/local/bin`, `/bin`), never `PATH`; `null` means none.
+     */
+    dockerPath?: string | null;
+    /**
+     * The host's keyring for the public API (a terminal that hands every client its own key), read for
+     * every request: a client must present one of these, and a revoked key is refused on the next
+     * request. An empty list refuses every client; `undefined` keeps `server.api_key`.
+     */
+    publicApiKeys?: () => readonly string[] | undefined;
+    /**
+     * Parallel byte-range streams for a hash-pinned file of at least 32 MiB (at most 4); one when
+     * unset. A server without ranges falls back to one stream.
+     */
+    downloadStreams?: number;
+    /**
+     * How long reading a remote GGUF header for a model check may take in all (a terminal that must not
+     * hang on a slow or broken mirror); past it the check goes on without the header. Unset waits.
+     */
+    remoteGgufTimeoutMs?: number;
     fetch?: typeof fetch;
     env?: NodeJS.ProcessEnv;
     /** 'owner' takes the instance lock; 'auto' is the same today — attaching is the CLI's job. */
@@ -35,6 +68,15 @@ export interface AtomicCoreOptions {
     /** 0 (the default) picks a free port and publishes it in the lock. */
     controlPort?: number;
     logger?: CoreLogger;
+    /**
+     * Every stdout/stderr line an engine prints, for the life of its session — llama.cpp (both
+     * providers), MLX, Foundation Models and `sd-server`. In addition to whatever `logPath`/`verbose`
+     * already route for one load, never instead; without it, engine output goes nowhere new and never
+     * reaches `logger`. The app's daemon wires this to its `core.log`. A sink that throws is ignored,
+     * after one `warn` through `logger` per engine session.
+     * `cloudflared` output never reaches this sink: it carries the remote-access tunnel's public URL.
+     */
+    backendOutput?: BackendOutputSink;
     /**
      * Where failures worth an issue go, and what `/atomic/v1/telemetry` drives. A host that owns its
      * process (the app's daemon, the CLI) builds one with `createCoreReporter` so start-up failures are

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAiDA,MAAM,CAAC,MAAM,cAAc,GAAoB,mBAAmB,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AA0FA,MAAM,CAAC,MAAM,cAAc,GAAoB,mBAAmB,CAAA"}

package/dist/decision/args.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The decision process's argv, environment and thread count. Pure.
+ *
+ * Built here and never through the chat `args.ts`: that builder serves chat and embedding sessions
+ * (a GGUF without a chat head gets `--embedding --pooling mean`), and none of its flags mean anything
+ * to `--decision`, which ignores most of them with a warning. The argv follows DECISION.md:
+ *
+ *   llama-server --decision -m <gguf | checkpoint dir> [--decision-spec <file>] [-a <id>]
+ *                [--decision-convert-cache <dir> --decision-convert-type <f16|f32>] --device none -t <n>
+ *                --host 127.0.0.1 --port <p> --no-webui [--decision-allow-uncalibrated]
+ *
+ * The key travels in `LLAMA_API_KEY`, never in argv, where any local user could read it with `ps`.
+ *
+ * `-t` is always passed. The engine's precedence (atomic-llama-cpp-turboquant `server-decision.cpp`,
+ * `engine-laya.cpp`): the laya engine runs with `-t`, or without it llama.cpp's own default
+ * (`common_cpu_get_num_math`: the performance cores on Apple silicon and on hybrid Linux x86, the
+ * physical cores elsewhere, uncapped). A spec's `plan.n_threads` is never applied: the engine only
+ * warns when it differs from the thread count it runs with, because logits are bitwise stable only
+ * for a fixed count. So leaving `-t` out would not hand the choice to the spec, only to llama.cpp,
+ * and would lose the cap below.
+ */
+import type { DecisionConvertType } from '../contracts/index.js';
+/** The environment variable the server's auth middleware reads (as `--api-key`), the fork's and upstream's. */
+export declare const DECISION_API_KEY_ENV = "LLAMA_API_KEY";
+/**
+ * Where checkpoint folders are converted to, relative to the data folder. Ours rather than the
+ * engine's default (the OS user cache): it goes away with the app's data and does not depend on
+ * `LLAMA_CACHE`. The engine never deletes old entries; the decision service does.
+ */
+export declare const DECISION_CONVERT_CACHE_DIR: string;
+/**
+ * A configured file as an absolute path: absolute as given, relative against the data folder, empty
+ * as `undefined`. The core invents no folder for decision models; the app decides where they live.
+ */
+export declare function resolveDataPath(dataFolder: string, configured: string): string | undefined;
+/** Loopback only: the public server forwards to it, nothing else should reach it. */
+export declare const DECISION_HOST = "127.0.0.1";
+/**
+ * Ceiling of the automatic thread count. The laya encoder is one CPU graph per request, and the chat
+ * model runs beside it; past eight threads the decision model mostly competes with the chat model
+ * (plan KPI K8) instead of getting faster. An explicit `threads` setting is not capped.
+ */
+export declare const MAX_AUTO_THREADS = 8;
+export interface DecisionLaunchSpec {
+    modelPath: string;
+    /** `--decision-spec`; omitted when empty. */
+    specPath?: string;
+    /** `-a`; omitted when empty (the engine then answers with the file name). */
+    modelId?: string;
+    /**
+     * `modelPath` is a checkpoint folder: where the engine caches its conversion and in which type.
+     * Passed in argv, never through `LLAMA_ARG_DECISION_*`, which `withoutDecisionEnv` strips.
+     */
+    convert?: {
+        cacheDir: string;
+        type: DecisionConvertType;
+    };
+    threads: number;
+    port: number;
+    allowUncalibrated?: boolean;
+}
+export declare function buildDecisionArgs(spec: DecisionLaunchSpec): string[];
+/** What an upstream decision GGUF is started with, beyond the model and the port. */
+export interface UpstreamDecisionLaunch {
+    /** `--mmproj`, for a model that reads images. */
+    mmprojPath?: string;
+    /** `-c`, and `-b`: the decision outputs are read from one batch, so it holds the whole prompt. */
+    ctxSize: number;
+    /** `-ub` too (laya, kev, clef): their scores come out of the embeddings, one ubatch for the prompt. */
+    wholePromptUbatch: boolean;
+}
+/**
+ * The argv of stock llama.cpp (b11370 on) for a GGUF with `<arch>.decision.type`: no decision flag,
+ * the server reads the type from the file and serves `/v1/systemone` (and turns on embedding mode
+ * itself where the type needs it). No `--device none`: upstream decision models run up to 27B
+ * parameters, and the server's own fitting puts them on the GPU when there is room.
+ *
+ *   llama-server -m <gguf> [--mmproj <file>] [-a <id>] -c <n> -b <n> [-ub <n>] -t <n>
+ *                --host 127.0.0.1 --port <p> --no-webui
+ */
+export declare function buildUpstreamDecisionArgs(spec: Pick<DecisionLaunchSpec, 'modelPath' | 'modelId' | 'threads' | 'port'>, upstream: UpstreamDecisionLaunch): string[];
+/** The variables the core adds to the inherited environment. */
+export declare function decisionEnv(apiKey: string): Record<string, string>;
+/** The engine reads its `--decision-*` flags from these variables too (DECISION.md, Flags). */
+export declare const DECISION_ENV_PREFIX = "LLAMA_ARG_DECISION_";
+/**
+ * The inherited environment without `LLAMA_ARG_DECISION_*`: a stray `LLAMA_ARG_DECISION_DEBUG` in the
+ * owner's environment would turn on request logging and raw logits, and `…_QUEUE` or `…_PLAN` would
+ * change what the core asked for. The core states every decision flag it wants in argv. Matched
+ * without case, as Windows names are.
+ */
+export declare function withoutDecisionEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export interface ThreadFacts {
+    /** `settings.decision.threads`; 0 = automatic. */
+    setting: number;
+    /** Physical cores (`SystemInfo.cpu.core_count`). */
+    physicalCores: number;
+    /** Performance cores, when the hardware facts know them. */
+    performanceCores?: number;
+    /**
+     * A hybrid CPU whose performance-core count is unknown. Apple silicon counts its efficiency cores
+     * as physical cores; ggml threads that land there hold every other thread up, so half the physical
+     * count (the P-cores on the base M1–M3 parts) is the safe guess.
+     */
+    hybrid?: boolean;
+}
+/** `-t`: the setting when given, else the performance cores (or a guess at them), 1 … `MAX_AUTO_THREADS`. */
+export declare function decisionThreads(facts: ThreadFacts): number;
+/** The argv as the log shows it: the model path kept (it is not a secret), nothing else to hide. */
+export declare function commandSummary(exe: string, argv: readonly string[]): string;