@atomic-chat/core 0.5.1 → 0.13.2

package/dist/decision/engine.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Finding a `llama-server` that serves `--decision`: the I/O half of the engine gate.
+ *
+ * The gate has three steps, cheapest first. The release tag orders the installed packs
+ * (`engine-candidates.ts`); `llama-server -h` must list `--decision` (the same probe the llama.cpp
+ * runtime runs for `draft-dflash`, `runHelp`); and once the process runs,
+ * `/props.decision.api_version` must be 1 (`readiness.ts`). Only the first passing pack is used; a
+ * pack that passed `-h` but failed readiness is handed back through `reject` and skipped, so the next
+ * `resolve` finds a valid lower-ranked build (a newer tag on API version 2, a dev build with an
+ * unfinished decision API). The skip lasts until the file changes or the owner calls
+ * `forgetRejected` (a build was installed, the user asked for a load, the launch settings changed):
+ * a refusal can depend on the launch (the spec, the model), and a user who asks again gets a real
+ * second try.
+ *
+ * The packs are read from the TurboQuant provider's folder directly, not through the provider's
+ * settings: which provider runs chat has nothing to do with which binary can run the decision model.
+ * Probe results are remembered per executable, modification time and flag, so a start after an idle
+ * unload does not pay for `-h` again, and a pack replaced by an update is probed afresh.
+ *
+ * Only a help screen that ran to its end is evidence. A probe that timed out, could not start the
+ * process, or ended in a crash proves nothing about the build: when no build passed and one of them
+ * could not be checked, the start fails with the probe's own code (`MODEL_LOAD_TIMED_OUT`,
+ * `MODEL_LOAD_FAILED`, so the module is `failed` and the advice is a retry), never
+ * `DECISION_ENGINE_UNSUPPORTED` and its advice to install a build the user already has
+ * (ADR 2026-10-08-a-decision-probe-that-could-not-run-is-not-unsupported).
+ *
+ * A checkpoint folder needs one more flag, `--decision-convert-cache`: a build from before the
+ * converter lists `--decision` but fails the load of a folder with `MODEL_LOAD_FAILED`, and the
+ * search would never reach a build that can run it.
+ *
+ * An upstream decision GGUF (`<arch>.decision.type`, `dialect: 'upstream'`) is run by the stock
+ * llama.cpp provider instead. Upstream has no flag to probe, so its gate is the build number in the
+ * tag (`upstream-version.ts`): only packs at or above the model's floor are tried, newest first, and
+ * readiness (`/v1/models` lists `decisions`) has the last word, with the same `reject` skip.
+ */
+import type { DecisionDialect, DecisionEngineInfo, DecisionEngineProvider } from '../contracts/index.js';
+import type { DataLayout } from '../config/index.js';
+import type { InstalledEnginePack } from './engine-candidates.js';
+/** The flag the `-h` output must contain. */
+export declare const DECISION_FLAG = "--decision";
+/** The flag a build that can convert a checkpoint folder (`-m DIR`) lists as well. */
+export declare const DECISION_CONVERT_FLAG = "--decision-convert-cache";
+/**
+ * The budget of one `-h`. The llama.cpp runtime's 5 s is too short here: a pack's first run after an
+ * install or an update can spend longer than that in the system's checks before `main`, and the
+ * answer is remembered, so a slow first probe is paid once.
+ */
+export declare const DECISION_PROBE_TIMEOUT_MS = 30000;
+export interface EngineRequirements {
+    /** The engine the model needs; default `turboquant`. */
+    dialect?: DecisionDialect;
+    /** The model is a checkpoint folder: the build must also list `DECISION_CONVERT_FLAG`. */
+    checkpointDir?: boolean;
+    /** Upstream only: the oldest build that serves the model (`upstreamMinBuild`). */
+    minBuild?: number;
+}
+/** The TurboQuant provider: the one whose builds serve `--decision` and the router. */
+export declare const DECISION_ENGINE_PROVIDER: "llamacpp";
+/** The stock llama.cpp provider: its builds from b11370 on serve upstream decision GGUFs. */
+export declare const UPSTREAM_DECISION_ENGINE_PROVIDER: "llamacpp-upstream";
+/** Every provider an install of which may let a decision model start. */
+export declare const DECISION_ENGINE_PROVIDERS: readonly DecisionEngineProvider[];
+export interface EngineResolverDeps {
+    layout: DataLayout;
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    /** Every installed pack of `provider` with its executable. Default: a scan of `<data>/<provider>/backends`. */
+    listPacks?: (provider: DecisionEngineProvider) => Promise<InstalledEnginePack[]>;
+    /**
+     * Whether `exe -h` lists `flag` (`DECISION_FLAG`, `DECISION_CONVERT_FLAG`); rejects when the probe
+     * could not run or proved nothing (timed out, crashed).
+     */
+    probe?: (exe: string, flag: string) => Promise<boolean>;
+    /** Modification time of a file, `undefined` when it does not exist. */
+    mtime?: (path: string) => Promise<number | undefined>;
+    /**
+     * The `llamacpp-upstream` build the user picked (`version_backend`, `b11463/win-vulkan-x64`): tried
+     * first when it can run the model (`orderUpstreamCandidates`).
+     */
+    preferredUpstream?: () => string;
+    log?: (level: 'info' | 'warn' | 'debug', msg: string) => void;
+}
+export declare class DecisionEngineResolver {
+    private readonly deps;
+    private readonly probed;
+    /** `exe\0mtime` → why readiness refused it. A replaced file has a new mtime and is tried again. */
+    private readonly rejected;
+    private readonly platform;
+    private readonly env;
+    constructor(deps: EngineResolverDeps);
+    /**
+     * The engine to run: `enginePath` when given (it must still pass the probe), otherwise the first
+     * installed pack that does. `DECISION_ENGINE_UNSUPPORTED` names every pack it tried and why.
+     */
+    resolve(enginePath?: string, needs?: EngineRequirements): Promise<DecisionEngineInfo>;
+    /**
+     * An upstream decision GGUF: `enginePath` when given (it only has to exist, and not be refused at
+     * readiness), otherwise the newest installed upstream pack at or above `minBuild`. Older packs are
+     * named in the error, which tells the user which build to update to.
+     */
+    private resolveUpstream;
+    /**
+     * `exe` started and passed `-h`, but readiness refused it: skip it in every later `resolve` until
+     * the file changes. A file that is gone is not remembered.
+     */
+    reject(exe: string, why: string): Promise<void>;
+    /** Every build refused at readiness is tried again by the next `resolve`. */
+    forgetRejected(): void;
+    /** `undefined` when `exe` lists every one of `flags`, otherwise why not. */
+    private check;
+    private probeHelp;
+    private packsOf;
+    private scan;
+}

package/dist/decision/engine.js

@@ -0,0 +1,253 @@
+/**
+ * Finding a `llama-server` that serves `--decision`: the I/O half of the engine gate.
+ *
+ * The gate has three steps, cheapest first. The release tag orders the installed packs
+ * (`engine-candidates.ts`); `llama-server -h` must list `--decision` (the same probe the llama.cpp
+ * runtime runs for `draft-dflash`, `runHelp`); and once the process runs,
+ * `/props.decision.api_version` must be 1 (`readiness.ts`). Only the first passing pack is used; a
+ * pack that passed `-h` but failed readiness is handed back through `reject` and skipped, so the next
+ * `resolve` finds a valid lower-ranked build (a newer tag on API version 2, a dev build with an
+ * unfinished decision API). The skip lasts until the file changes or the owner calls
+ * `forgetRejected` (a build was installed, the user asked for a load, the launch settings changed):
+ * a refusal can depend on the launch (the spec, the model), and a user who asks again gets a real
+ * second try.
+ *
+ * The packs are read from the TurboQuant provider's folder directly, not through the provider's
+ * settings: which provider runs chat has nothing to do with which binary can run the decision model.
+ * Probe results are remembered per executable, modification time and flag, so a start after an idle
+ * unload does not pay for `-h` again, and a pack replaced by an update is probed afresh.
+ *
+ * Only a help screen that ran to its end is evidence. A probe that timed out, could not start the
+ * process, or ended in a crash proves nothing about the build: when no build passed and one of them
+ * could not be checked, the start fails with the probe's own code (`MODEL_LOAD_TIMED_OUT`,
+ * `MODEL_LOAD_FAILED`, so the module is `failed` and the advice is a retry), never
+ * `DECISION_ENGINE_UNSUPPORTED` and its advice to install a build the user already has
+ * (ADR 2026-10-08-a-decision-probe-that-could-not-run-is-not-unsupported).
+ *
+ * A checkpoint folder needs one more flag, `--decision-convert-cache`: a build from before the
+ * converter lists `--decision` but fails the load of a folder with `MODEL_LOAD_FAILED`, and the
+ * search would never reach a build that can run it.
+ *
+ * An upstream decision GGUF (`<arch>.decision.type`, `dialect: 'upstream'`) is run by the stock
+ * llama.cpp provider instead. Upstream has no flag to probe, so its gate is the build number in the
+ * tag (`upstream-version.ts`): only packs at or above the model's floor are tried, newest first, and
+ * readiness (`/v1/models` lists `decisions`) has the last word, with the same `reject` skip.
+ */
+import { stat } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { AtomicCoreError } from '../contracts/index.js';
+import { resolveBackendExe, scanInstalledBackends } from '../backend/index.js';
+import { probeOutputTail, runHelp } from '../runtime/llamacpp/index.js';
+import { buildProcessEnv, discoverCudaPaths, nodeCudaProbeEnv } from '../runtime/shared/index.js';
+import { orderEngineCandidates, orderUpstreamCandidates } from './engine-candidates.js';
+import { UPSTREAM_DECISION_MIN_BUILD } from './upstream-version.js';
+/** The flag the `-h` output must contain. */
+export const DECISION_FLAG = '--decision';
+/** The flag a build that can convert a checkpoint folder (`-m DIR`) lists as well. */
+export const DECISION_CONVERT_FLAG = '--decision-convert-cache';
+/**
+ * The budget of one `-h`. The llama.cpp runtime's 5 s is too short here: a pack's first run after an
+ * install or an update can spend longer than that in the system's checks before `main`, and the
+ * answer is remembered, so a slow first probe is paid once.
+ */
+export const DECISION_PROBE_TIMEOUT_MS = 30_000;
+const REFUSED_AT_READINESS = 'refused at readiness';
+/** The TurboQuant provider: the one whose builds serve `--decision` and the router. */
+export const DECISION_ENGINE_PROVIDER = 'llamacpp';
+/** The stock llama.cpp provider: its builds from b11370 on serve upstream decision GGUFs. */
+export const UPSTREAM_DECISION_ENGINE_PROVIDER = 'llamacpp-upstream';
+/** Every provider an install of which may let a decision model start. */
+export const DECISION_ENGINE_PROVIDERS = [
+    DECISION_ENGINE_PROVIDER,
+    UPSTREAM_DECISION_ENGINE_PROVIDER,
+];
+const defaultMtime = (path) => stat(path).then((s) => (s.isFile() ? s.mtimeMs : undefined), () => undefined);
+export class DecisionEngineResolver {
+    deps;
+    probed = new Map();
+    /** `exe\0mtime` → why readiness refused it. A replaced file has a new mtime and is tried again. */
+    rejected = new Map();
+    platform;
+    env;
+    constructor(deps) {
+        this.deps = deps;
+        this.platform = deps.platform ?? process.platform;
+        this.env = deps.env ?? process.env;
+    }
+    /**
+     * The engine to run: `enginePath` when given (it must still pass the probe), otherwise the first
+     * installed pack that does. `DECISION_ENGINE_UNSUPPORTED` names every pack it tried and why.
+     */
+    async resolve(enginePath = '', needs = {}) {
+        if (needs.dialect === 'upstream')
+            return this.resolveUpstream(enginePath, needs.minBuild ?? UPSTREAM_DECISION_MIN_BUILD);
+        const flags = needs.checkpointDir ? [DECISION_FLAG, DECISION_CONVERT_FLAG] : [DECISION_FLAG];
+        if (enginePath !== '') {
+            const refusal = await this.check(enginePath, flags);
+            if (refusal === undefined)
+                return explicitEngine(enginePath, 'turboquant');
+            const tried = [`${enginePath}: ${refusal.reason}`];
+            if (refusal.probeError)
+                throw notChecked(refusal.probeError, tried);
+            throw new AtomicCoreError('DECISION_ENGINE_UNSUPPORTED', 'The configured engine does not serve the decision model.', tried[0]);
+        }
+        const packs = await this.packsOf(DECISION_ENGINE_PROVIDER);
+        const tried = [];
+        let refusedAtReadiness = 0;
+        let unchecked;
+        for (const candidate of orderEngineCandidates(packs)) {
+            const refusal = await this.check(candidate.path, flags);
+            if (refusal === undefined)
+                return candidate.info;
+            if (refusal.reason.startsWith(REFUSED_AT_READINESS))
+                refusedAtReadiness++;
+            unchecked ??= refusal.probeError;
+            tried.push(`${candidate.info.version_backend}: ${refusal.reason}`);
+        }
+        // A build that could not be checked may be the one that serves the model.
+        if (unchecked)
+            throw notChecked(unchecked, tried);
+        // A build that lists `--decision` and was refused at readiness is already 1.7.0-like: telling the
+        // user to install 1.7.0 would send them after what they have.
+        throw new AtomicCoreError('DECISION_ENGINE_UNSUPPORTED', refusedAtReadiness > 0
+            ? `No installed engine build can run the decision model: ${refusedAtReadiness} that list${refusedAtReadiness === 1 ? 's' : ''} ${DECISION_FLAG} ${refusedAtReadiness === 1 ? 'was' : 'were'} ${REFUSED_AT_READINESS}, not serving decision API version 1.`
+            : 'No installed engine build can run the decision model. Install TurboQuant 1.7.0 or newer.', tried.length > 0
+            ? tried.join('\n')
+            : `no TurboQuant build in ${this.deps.layout.provider(DECISION_ENGINE_PROVIDER).backendsDir}`);
+    }
+    /**
+     * An upstream decision GGUF: `enginePath` when given (it only has to exist, and not be refused at
+     * readiness), otherwise the newest installed upstream pack at or above `minBuild`. Older packs are
+     * named in the error, which tells the user which build to update to.
+     */
+    async resolveUpstream(enginePath, minBuild) {
+        if (enginePath !== '') {
+            const refusal = await this.check(enginePath, []);
+            if (refusal === undefined)
+                return explicitEngine(enginePath, 'upstream');
+            throw new AtomicCoreError('DECISION_ENGINE_UNSUPPORTED', 'The configured engine does not serve the decision model.', `${enginePath}: ${refusal.reason}`);
+        }
+        const { eligible, tooOld } = orderUpstreamCandidates(await this.packsOf(UPSTREAM_DECISION_ENGINE_PROVIDER), minBuild, this.deps.preferredUpstream?.() ?? '');
+        const tried = [];
+        for (const candidate of eligible) {
+            const refusal = await this.check(candidate.path, []);
+            if (refusal === undefined)
+                return candidate.info;
+            tried.push(`${candidate.info.version_backend}: ${refusal.reason}`);
+        }
+        for (const pack of tooOld)
+            tried.push(`${pack.version}/${pack.backend}: older than b${minBuild}`);
+        throw new AtomicCoreError('DECISION_ENGINE_UNSUPPORTED', eligible.length > 0
+            ? `No installed llama.cpp build can run the decision model: every build at b${minBuild} or newer was ${REFUSED_AT_READINESS}.`
+            : `No installed llama.cpp build can run the decision model. Update llama.cpp to b${minBuild} or newer.`, tried.length > 0
+            ? tried.join('\n')
+            : `no llama.cpp build in ${this.deps.layout.provider(UPSTREAM_DECISION_ENGINE_PROVIDER).backendsDir}`);
+    }
+    /**
+     * `exe` started and passed `-h`, but readiness refused it: skip it in every later `resolve` until
+     * the file changes. A file that is gone is not remembered.
+     */
+    async reject(exe, why) {
+        const mtime = await (this.deps.mtime ?? defaultMtime)(exe);
+        if (mtime === undefined)
+            return;
+        this.rejected.set(`${exe}\u0000${mtime}`, why);
+        this.deps.log?.('debug', `decision engine ${exe} rejected at readiness: ${why}`);
+    }
+    /** Every build refused at readiness is tried again by the next `resolve`. */
+    forgetRejected() {
+        if (this.rejected.size === 0)
+            return;
+        this.rejected.clear();
+        this.deps.log?.('debug', 'decision engines refused at readiness will be tried again');
+    }
+    /** `undefined` when `exe` lists every one of `flags`, otherwise why not. */
+    async check(exe, flags) {
+        const mtime = await (this.deps.mtime ?? defaultMtime)(exe);
+        if (mtime === undefined)
+            return { reason: 'no such file' };
+        const key = `${exe}\u0000${mtime}`;
+        const refused = this.rejected.get(key);
+        if (refused !== undefined)
+            return { reason: `${REFUSED_AT_READINESS}: ${refused}` };
+        const probe = this.deps.probe ?? ((path, flag) => this.probeHelp(path, flag));
+        for (const flag of flags) {
+            const flagKey = `${key}\u0000${flag}`;
+            let supported = this.probed.get(flagKey);
+            if (supported === undefined) {
+                try {
+                    supported = await probe(exe, flag);
+                }
+                catch (error) {
+                    // A probe that could not run is not remembered: the next start tries again.
+                    const probeError = asProbeError(error);
+                    const details = probeError.details ? ` (${probeError.details})` : '';
+                    return { reason: `probe failed: ${probeError.message}${details}`, probeError };
+                }
+                this.probed.set(flagKey, supported);
+                this.deps.log?.('debug', `decision probe ${exe}: ${supported ? 'lists' : 'no'} ${flag}`);
+            }
+            if (!supported)
+                return { reason: `${flag} is not in its -h output` };
+        }
+        return undefined;
+    }
+    async probeHelp(exe, flag) {
+        const { env, cwd } = buildProcessEnv({
+            platform: this.platform,
+            baseEnv: this.env,
+            exeDir: dirname(exe),
+            cuda: discoverCudaPaths(nodeCudaProbeEnv(this.platform, this.env)),
+            userEnv: {},
+        });
+        const help = await runHelp(exe, env, cwd, { timeoutMs: DECISION_PROBE_TIMEOUT_MS });
+        const seconds = (help.elapsedMs / 1000).toFixed(1);
+        this.deps.log?.('debug', `decision probe ${exe}: -h finished in ${seconds}s`);
+        if (help.output.includes(flag))
+            return true;
+        // `-h` prints the help and exits 0. Anything else (a crash, a library that would not load) printed
+        // no help at all, and the flag missing from it proves nothing.
+        if (help.exit.code !== 0)
+            throw new AtomicCoreError('MODEL_LOAD_FAILED', 'llama-server -h did not finish normally.', `${exe} exited with ${describeExit(help.exit)} after ${seconds}s` +
+                `: ${probeOutputTail(help.output) || 'no output'}`);
+        return false;
+    }
+    packsOf(provider) {
+        return this.deps.listPacks ? this.deps.listPacks(provider) : this.scan(provider);
+    }
+    async scan(provider) {
+        const { layout } = this.deps;
+        const packs = [];
+        for (const pack of await scanInstalledBackends(layout, provider, this.platform)) {
+            const path = await resolveBackendExe(layout, provider, pack.version, pack.backend, this.platform);
+            if (path)
+                packs.push({ version: pack.version, backend: pack.backend, path });
+        }
+        return packs;
+    }
+}
+/** A probe failure as the core error it is; anything else thrown means the probe could not run. */
+function asProbeError(error) {
+    if (error instanceof AtomicCoreError)
+        return error;
+    return new AtomicCoreError('MODEL_LOAD_FAILED', error instanceof Error ? error.message : String(error));
+}
+/**
+ * No build was shown to serve the model, and `cause` kept one from being checked: the start failed,
+ * with the probe's code, and every build tried is in the details.
+ */
+function notChecked(cause, tried) {
+    return new AtomicCoreError(cause.code, `Could not check whether the installed engine serves the decision model: ${cause.message}`, tried.join('\n'));
+}
+function describeExit(exit) {
+    if (exit.code !== null)
+        return `code ${exit.code}`;
+    if (exit.signal !== null)
+        return `signal ${exit.signal}`;
+    return 'an unknown status';
+}
+/** An explicit `engine_path`: nothing is known about it but the file and the dialect it is started for. */
+function explicitEngine(path, dialect) {
+    return { path, version_backend: null, fork_version: null, version_gate: null, dialect, provider: null };
+}
+//# sourceMappingURL=engine.js.map

package/dist/decision/engine.js.map

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

package/dist/decision/http.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The HTTP the decision module needs against its own process: a GET or a POST of ready bytes, with a
+ * deadline over the whole exchange, an optional caller signal and the process's bearer key. Over the
+ * raw-socket client rather than the global `fetch`, which in the Bun-compiled binary honours
+ * `HTTP_PROXY` even for loopback (ADR 2026-09-15-proxied-downloads-use-a-raw-socket-client).
+ *
+ * The body is sent as given: callers that pass bytes through (the public route) never have them
+ * re-serialized, and callers that build a request serialize it once themselves.
+ */
+export interface DecisionHttpResponse {
+    status: number;
+    text: string;
+}
+export interface DecisionRequest {
+    method: 'GET' | 'POST';
+    /** Bearer key of the process; omitted for the public routes before it is known. */
+    apiKey?: string;
+    body?: string | Buffer;
+    contentType?: string;
+    timeoutMs: number;
+    /** The caller gave up (a client that left, a shutdown). */
+    signal?: AbortSignal;
+}
+export interface DecisionHttp {
+    request(url: string, init: DecisionRequest): Promise<DecisionHttpResponse>;
+}
+/** The deadline passed before the answer was complete. */
+export declare class DecisionTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/** The caller's signal fired first. */
+export declare class DecisionAbortedError extends Error {
+    constructor();
+}
+export declare function createDecisionHttp(fetchImpl?: typeof fetch): DecisionHttp;

package/dist/decision/http.js

@@ -0,0 +1,73 @@
+/**
+ * The HTTP the decision module needs against its own process: a GET or a POST of ready bytes, with a
+ * deadline over the whole exchange, an optional caller signal and the process's bearer key. Over the
+ * raw-socket client rather than the global `fetch`, which in the Bun-compiled binary honours
+ * `HTTP_PROXY` even for loopback (ADR 2026-09-15-proxied-downloads-use-a-raw-socket-client).
+ *
+ * The body is sent as given: callers that pass bytes through (the public route) never have them
+ * re-serialized, and callers that build a request serialize it once themselves.
+ */
+import { createPolicyFetch } from '../downloads/index.js';
+/** The deadline passed before the answer was complete. */
+export class DecisionTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`the decision model did not answer within ${timeoutMs} ms`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'DecisionTimeoutError';
+    }
+}
+/** The caller's signal fired first. */
+export class DecisionAbortedError extends Error {
+    constructor() {
+        super('the decision request was abandoned by its caller');
+        this.name = 'DecisionAbortedError';
+    }
+}
+export function createDecisionHttp(fetchImpl = createPolicyFetch({})) {
+    return {
+        async request(url, init) {
+            const controller = new AbortController();
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, init.timeoutMs);
+            const onAbort = () => controller.abort();
+            if (init.signal?.aborted)
+                controller.abort();
+            else
+                init.signal?.addEventListener('abort', onAbort, { once: true });
+            const headers = { accept: 'application/json' };
+            if (init.apiKey)
+                headers['authorization'] = `Bearer ${init.apiKey}`;
+            let body;
+            if (init.body !== undefined) {
+                body = Buffer.isBuffer(init.body) ? init.body : Buffer.from(init.body, 'utf8');
+                headers['content-type'] = init.contentType ?? 'application/json';
+                headers['content-length'] = String(body.length);
+            }
+            try {
+                const response = await fetchImpl(url, {
+                    method: init.method,
+                    headers,
+                    ...(body !== undefined ? { body: new Uint8Array(body) } : {}),
+                    signal: controller.signal,
+                });
+                return { status: response.status, text: await response.text() };
+            }
+            catch (error) {
+                if (timedOut)
+                    throw new DecisionTimeoutError(init.timeoutMs);
+                if (init.signal?.aborted)
+                    throw new DecisionAbortedError();
+                throw error;
+            }
+            finally {
+                clearTimeout(timer);
+                init.signal?.removeEventListener('abort', onAbort);
+            }
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/decision/http.js.map

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

package/dist/decision/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The decision model: one `llama-server --decision` process (TurboQuant fork ≥ 1.7.0) that answers
+ * calibrated probabilities in one forward pass, for the model router and TypeSafe-style questions.
+ * A module of its own, outside the sessions registry, like image generation
+ * (ADR 2026-09-30-the-decision-model-is-its-own-core-module). Wire types in `src/contracts/decision.ts`;
+ * the engine contract is `DECISION.md` in atomic-llama-cpp-turboquant.
+ */
+export * from './args.js';
+export * from './backoff.js';
+export * from './engine.js';
+export * from './engine-candidates.js';
+export * from './engine-fallback.js';
+export * from './engine-version.js';
+export * from './http.js';
+export * from './outcome.js';
+export * from './process.js';
+export * from './readiness.js';
+export * from './request.js';
+export * from './service.js';
+export * from './wiring.js';

package/dist/decision/index.js

@@ -0,0 +1,21 @@
+/**
+ * The decision model: one `llama-server --decision` process (TurboQuant fork ≥ 1.7.0) that answers
+ * calibrated probabilities in one forward pass, for the model router and TypeSafe-style questions.
+ * A module of its own, outside the sessions registry, like image generation
+ * (ADR 2026-09-30-the-decision-model-is-its-own-core-module). Wire types in `src/contracts/decision.ts`;
+ * the engine contract is `DECISION.md` in atomic-llama-cpp-turboquant.
+ */
+export * from './args.js';
+export * from './backoff.js';
+export * from './engine.js';
+export * from './engine-candidates.js';
+export * from './engine-fallback.js';
+export * from './engine-version.js';
+export * from './http.js';
+export * from './outcome.js';
+export * from './process.js';
+export * from './readiness.js';
+export * from './request.js';
+export * from './service.js';
+export * from './wiring.js';
+//# sourceMappingURL=index.js.map

package/dist/decision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decision/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/dist/decision/model-facts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * What a decision model file says about how to run it: which engine (the `DecisionDialect`), and for an
+ * upstream GGUF its decision type and trained context. Read from the GGUF header only, before a start.
+ *
+ * A file the core cannot read stays with the fork, as every GGUF did before upstream served decision
+ * models: the fork's own load error is then what the user sees.
+ */
+/** `-c` for an upstream decision model when the settings leave it to the core. */
+export declare const UPSTREAM_DECISION_DEFAULT_CTX = 8192;
+/**
+ * Upstream decision types read from the embeddings output: the whole prompt must fit one ubatch
+ * (llama.cpp `common_init_from_params` turns on embedding mode for them and caps the batch at the
+ * ubatch), so the core starts them with `-ub` equal to the context.
+ */
+export declare const WHOLE_PROMPT_DECISION_TYPES: ReadonlySet<string>;
+export type DecisionModelFacts = {
+    dialect: 'turboquant';
+} | {
+    dialect: 'upstream';
+    /** `<arch>.decision.type`. */
+    decisionType: string;
+    /** `<arch>.context_length`, when the file has one. */
+    contextTrain?: number;
+};
+/** The facts from parsed metadata (string values, as the GGUF reader returns them). Pure. */
+export declare function decisionFactsOf(metadata: Record<string, unknown> | undefined): DecisionModelFacts;
+/** The facts of a GGUF file; one that cannot be read is the fork's (see the module comment). */
+export declare function readDecisionModelFacts(path: string, read?: (path: string) => Promise<{
+    metadata: Record<string, unknown>;
+}>): Promise<DecisionModelFacts>;
+/** `-c` for an upstream model: the setting when given, else the default, never past the trained context. */
+export declare function upstreamCtxSize(setting: number, contextTrain: number | undefined): number;

package/dist/decision/model-facts.js

@@ -0,0 +1,40 @@
+/**
+ * What a decision model file says about how to run it: which engine (the `DecisionDialect`), and for an
+ * upstream GGUF its decision type and trained context. Read from the GGUF header only, before a start.
+ *
+ * A file the core cannot read stays with the fork, as every GGUF did before upstream served decision
+ * models: the fork's own load error is then what the user sees.
+ */
+import { readGgufMetadataFromFile, upstreamDecisionTypeOf } from '../models/index.js';
+/** `-c` for an upstream decision model when the settings leave it to the core. */
+export const UPSTREAM_DECISION_DEFAULT_CTX = 8192;
+/**
+ * Upstream decision types read from the embeddings output: the whole prompt must fit one ubatch
+ * (llama.cpp `common_init_from_params` turns on embedding mode for them and caps the batch at the
+ * ubatch), so the core starts them with `-ub` equal to the context.
+ */
+export const WHOLE_PROMPT_DECISION_TYPES = new Set(['laya', 'kev', 'clef']);
+/** The facts from parsed metadata (string values, as the GGUF reader returns them). Pure. */
+export function decisionFactsOf(metadata) {
+    const decisionType = upstreamDecisionTypeOf(metadata);
+    if (decisionType === undefined)
+        return { dialect: 'turboquant' };
+    const arch = String(metadata?.['general.architecture'] ?? '').trim();
+    const context = Number(metadata?.[`${arch}.context_length`]);
+    return {
+        dialect: 'upstream',
+        decisionType,
+        ...(Number.isInteger(context) && context > 0 ? { contextTrain: context } : {}),
+    };
+}
+/** The facts of a GGUF file; one that cannot be read is the fork's (see the module comment). */
+export async function readDecisionModelFacts(path, read = readGgufMetadataFromFile) {
+    const parsed = await read(path).catch(() => undefined);
+    return decisionFactsOf(parsed?.metadata);
+}
+/** `-c` for an upstream model: the setting when given, else the default, never past the trained context. */
+export function upstreamCtxSize(setting, contextTrain) {
+    const wanted = Number.isInteger(setting) && setting > 0 ? setting : UPSTREAM_DECISION_DEFAULT_CTX;
+    return contextTrain !== undefined && contextTrain > 0 ? Math.min(wanted, contextTrain) : wanted;
+}
+//# sourceMappingURL=model-facts.js.map

package/dist/decision/model-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-facts.js","sourceRoot":"","sources":["../../src/decision/model-facts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAErF,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAA;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAYhG,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAAC,QAA6C;IAC3E,MAAM,YAAY,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACrD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAA;IAC5D,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,YAAY;QACZ,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAA;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAY,EACZ,OAAyE,wBAAwB;IAEjG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACtD,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC1C,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAgC;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAA;IACjG,OAAO,YAAY,KAAK,SAAS,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACjG,CAAC"}