@atomic-chat/core 0.5.1 → 0.13.2

package/dist/server/http.js

@@ -87,7 +87,15 @@ export function sendJson(res, status, body) {
     });
     res.end(payload);
 }
-/** HTTP status for a core error code. Anything unmapped is a 500: an unknown failure is not the caller's fault. */
+/**
+ * HTTP status for a core error code. Anything unmapped is a 500: an unknown failure is not the
+ * caller's fault.
+ *
+ * The managed runtime's conflicts are all 409: somebody else is changing it, the caller computed
+ * their request from a state it has left, consent is missing or no longer covers the plan, or the
+ * machine is not in a position to continue yet. An engine this build has no adapter for is 422 — the
+ * request was understood and well formed, and the answer is still no.
+ */
 export function statusForCode(code) {
     switch (code) {
         case 'UNAUTHORIZED':
@@ -104,18 +112,43 @@ export function statusForCode(code) {
         case 'ENGINE_MISSING':
         case 'MODEL_MISSING':
         case 'SIDE_FILE_MISSING':
+        case 'MANAGED_OPERATION_NOT_FOUND':
+        case 'MODEL_SETUP_NOT_FOUND':
             return 404;
         case 'CORE_ALREADY_RUNNING':
         case 'AUTH_CANCELLED':
         case 'MODEL_LOAD_CANCELLED':
         case 'REMOTE_ACCESS_SERVER_STOPPED':
         case 'REMOTE_ACCESS_OPERATION_IN_PROGRESS':
+        case 'ENGINE_INSTALL_IN_PROGRESS':
         case 'REMOTE_ACCESS_STOP_FAILED':
         case 'JOB_BUSY':
         case 'BACKEND_IN_USE':
         case 'NOT_CONFIGURED':
         case 'CANCELLED':
         case 'ENGINE_UPDATE_REQUIRED':
+        case 'MANAGED_OPERATION_CONFLICT':
+        case 'MANAGED_REVISION_CONFLICT':
+        case 'MANAGED_CONSENT_REQUIRED':
+        case 'MANAGED_PLAN_CHANGED':
+        case 'MANAGED_RECEIPT_CONFLICT':
+        case 'MANAGED_RESOURCE_IN_USE':
+        case 'MANAGED_IDENTITY_MISMATCH':
+        case 'MANAGED_STOP_UNCONFIRMED':
+        case 'MANAGED_ELEVATION_DECLINED':
+        case 'MANAGED_PREREQUISITE_BLOCKED':
+        case 'MANAGED_RELOGIN_REQUIRED':
+        case 'MANAGED_REBOOT_REQUIRED':
+        case 'GPU_BUSY':
+        case 'SESSION_GENERATION_STALE':
+        case 'DECISION_NOT_CONFIGURED':
+        case 'DECISION_ENGINE_UNSUPPORTED':
+        case 'DECISION_CHECKPOINT_INCOMPLETE':
+        case 'DECISION_MODEL_NOT_CHAT':
+        case 'EMBEDDING_NOT_CONFIGURED':
+        case 'EMBEDDING_ENGINE_UNSUPPORTED':
+        case 'EMBEDDING_MODEL_NOT_EMBEDDING':
+        case 'MODEL_SETUP_PLAN_STALE':
             return 409;
         case 'QUEUE_FULL':
             return 429;
@@ -124,15 +157,32 @@ export function statusForCode(code) {
         case 'AUTH_FAILED':
         case 'UPSTREAM_ERROR':
             return 502;
+        // `MANAGED_HOST_STEP_INVALID`/`MANAGED_METADATA_INVALID` are a descriptor or plan this core
+        // refused because a *caller* sent it something malformed
+        // (`src/runtime/environment/descriptor.ts`'s parser). Deliberately not shared with an on-disk
+        // operation record this core itself cannot read: that is never the caller's fault, so
+        // `OperationStore`'s own corruption case (`store.ts`'s `corrupt()`) raises `IO_ERROR` instead
+        // and falls through to the 500 below, rather than answering a client mistake and this store's
+        // own corruption with the same 400.
         case 'INVALID_ARGUMENT':
         case 'INVALID_REQUEST':
         case 'INVALID_DIMENSIONS':
         case 'UNSUPPORTED_WORKFLOW':
         case 'UNSUPPORTED_BACKEND':
         case 'MODEL_INCOMPATIBLE':
+        case 'MANAGED_HOST_STEP_INVALID':
+        case 'MANAGED_METADATA_INVALID':
             return 400;
+        // Understood, well-formed, and asking for an engine this build has no adapter for, or asking a
+        // provider to run a file it cannot (or a file nothing runs any more).
+        case 'MANAGED_ADAPTER_UNAVAILABLE':
+        case 'MODEL_ENGINE_INCOMPATIBLE':
+        case 'MODEL_FORMAT_LEGACY':
+            return 422;
         case 'CORE_NOT_RUNNING':
         case 'FOUNDATION_MODELS_UNAVAILABLE':
+        case 'DECISION_UNAVAILABLE':
+        case 'EMBEDDING_UNAVAILABLE':
             return 503;
         case 'MODEL_LOAD_TIMED_OUT':
         case 'SERVER_START_TIMED_OUT':

package/dist/server/http.js.map

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

package/dist/server/public/decision-preview.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The request inspector's view of a decision exchange. A decision body has no messages and its
+ * answer no generated text, so the chat readers in `telemetry.ts` find nothing in either: the
+ * prompt preview is the `state` with the question names, the reply preview one line per answer.
+ *
+ * Built from a parse of a copy; the bytes the client and the engine see are never touched. Same
+ * privacy rule as `telemetry.ts`: only while the API screen is open, never logged.
+ */
+import type { PromptPreview, TelemetryFields } from './telemetry.js';
+/** `state` as text (a string as is, anything else as compact JSON), then the question names. */
+export declare function decisionPromptPreview(body: Buffer): PromptPreview;
+/**
+ * The finish fields of a decision answer: `answers` (systemone) or `scores` (router) as the reply
+ * preview, `usage.input_tokens` as the prompt tokens. An error envelope or a body that is not JSON
+ * gives no preview; the status already tells the story.
+ */
+export declare function decisionReplyFields(body: Buffer): TelemetryFields;

package/dist/server/public/decision-preview.js

@@ -0,0 +1,119 @@
+/**
+ * The request inspector's view of a decision exchange. A decision body has no messages and its
+ * answer no generated text, so the chat readers in `telemetry.ts` find nothing in either: the
+ * prompt preview is the `state` with the question names, the reply preview one line per answer.
+ *
+ * Built from a parse of a copy; the bytes the client and the engine see are never touched. Same
+ * privacy rule as `telemetry.ts`: only while the API screen is open, never logged.
+ */
+import { isJsonObject } from '../shims/index.js';
+import { PREVIEW_MAX_CHARS } from './telemetry.js';
+function parse(bytes) {
+    try {
+        return JSON.parse(bytes.toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function capped(text) {
+    const chars = [...text];
+    return { text: chars.slice(0, PREVIEW_MAX_CHARS).join(''), chars: chars.length };
+}
+const num = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const fixed = (value) => value.toFixed(2);
+/** `state` as text (a string as is, anything else as compact JSON), then the question names. */
+export function decisionPromptPreview(body) {
+    const out = { text: null, chars: null, message_count: null, has_non_text_parts: false };
+    const json = parse(body);
+    if (!isJsonObject(json))
+        return out;
+    const lines = [];
+    if (typeof json.task === 'string')
+        lines.push(json.task);
+    if (json.state !== undefined)
+        lines.push(typeof json.state === 'string' ? json.state : JSON.stringify(json.state));
+    if (isJsonObject(json.questions)) {
+        const names = Object.keys(json.questions);
+        if (names.length > 0)
+            lines.push(`Questions: ${names.join(', ')}`);
+    }
+    if (Array.isArray(json.candidates)) {
+        const ids = json.candidates.map((c) => (isJsonObject(c) && typeof c.id === 'string' ? c.id : '?'));
+        if (ids.length > 0)
+            lines.push(`Candidates: ${ids.join(', ')}`);
+    }
+    if (lines.length === 0)
+        return out;
+    const preview = capped(lines.join('\n\n'));
+    out.text = preview.text;
+    out.chars = preview.chars;
+    return out;
+}
+/** One answer as `name: value`, with the winning choice's probability. */
+function answerLine(name, answer) {
+    if (!isJsonObject(answer))
+        return undefined;
+    if (typeof answer.choice === 'string') {
+        const p = isJsonObject(answer.probabilities) ? num(answer.probabilities[answer.choice]) : undefined;
+        return `${name}: ${answer.choice}${p === undefined ? '' : ` (${fixed(p)})`}`;
+    }
+    const noul = num(answer.noul);
+    if (noul !== undefined)
+        return `${name}: ${fixed(noul)}`;
+    const score = num(answer.score);
+    if (score !== undefined)
+        return `${name}: ${fixed(score)}`;
+    return undefined;
+}
+/**
+ * The finish fields of a decision answer: `answers` (systemone) or `scores` (router) as the reply
+ * preview, `usage.input_tokens` as the prompt tokens. An error envelope or a body that is not JSON
+ * gives no preview; the status already tells the story.
+ */
+export function decisionReplyFields(body) {
+    const fields = {
+        ttft_ms: null,
+        prompt_tokens: null,
+        completion_tokens: null,
+        total_tokens: null,
+        tokens_estimated: false,
+        prompt_per_second: null,
+        predicted_per_second: null,
+        finish_reason: null,
+        reply_preview: null,
+        reply_chars: null,
+    };
+    const json = parse(body);
+    if (!isJsonObject(json))
+        return fields;
+    const lines = [];
+    if (isJsonObject(json.answers)) {
+        for (const [name, answer] of Object.entries(json.answers)) {
+            const line = answerLine(name, answer);
+            if (line)
+                lines.push(line);
+        }
+    }
+    if (Array.isArray(json.scores)) {
+        for (const score of json.scores) {
+            if (!isJsonObject(score) || typeof score.id !== 'string')
+                continue;
+            const p = num(score.p_success);
+            lines.push(`${score.id}: ${p === undefined ? '?' : fixed(p)}`);
+        }
+    }
+    if (lines.length > 0) {
+        const preview = capped(lines.join('\n'));
+        fields.reply_preview = preview.text;
+        fields.reply_chars = preview.chars;
+    }
+    const tokens = isJsonObject(json.usage) ? num(json.usage.input_tokens) : undefined;
+    if (tokens !== undefined) {
+        fields.prompt_tokens = tokens;
+        fields.completion_tokens = 0;
+        fields.total_tokens = tokens;
+    }
+    return fields;
+}
+//# sourceMappingURL=decision-preview.js.map

package/dist/server/public/decision-preview.js.map

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

package/dist/server/public/decision.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `POST /v1/systemone` and `POST /v1/router/score`: the decision model's own API, passed through to
+ * the decision process byte for byte.
+ *
+ * Not through `serveForward`: that route needs a string `model` to pick a chat session, and the
+ * decision API makes `model` optional. Not parsed and re-serialized either: JSON through JavaScript
+ * loses `1.0` vs `1` (the engine renders them differently in the prompt), integers past 2^53, and the
+ * order of number-like keys, and the engine's answer is only as calibrated as its input is exact. So
+ * the request body goes out as the client sent it, with the process's own key instead of the client's,
+ * and the engine's answer (its error envelope included) comes back unchanged.
+ *
+ * When the module cannot answer, the route says why in the engine's own envelope, with 503, so a
+ * client handles one shape: `{"error": {"code", "type", "reason": "UNAVAILABLE", "message"}}`. A
+ * route the running engine does not serve (the router on upstream llama.cpp) gets 501 with
+ * `"reason": "UNSUPPORTED_ENDPOINT"` in the same envelope.
+ */
+import type { Exchange } from './exchange.js';
+/** Public path (after the prefix) → the decision process's path. */
+export declare const DECISION_ROUTES: Readonly<Record<string, string>>;
+/**
+ * The public cap on a decision body. The engine refuses more than 1 MiB itself, with its own
+ * `BODY_TOO_LARGE` envelope; up to this size the body is passed on so the client gets that answer.
+ */
+export declare const MAX_DECISION_BODY_BYTES: number;
+/** How long a request waits for a module that is enabled but not running to start. */
+export declare const DECISION_START_WAIT_MS = 30000;
+export declare const DECISION_BACKEND_LABEL = "atomic-decision";
+/** The engine's error envelope, for the answers the core writes itself. */
+export declare function decisionErrorBody(status: number, reason: string, message: string, type: string): string;
+/** Read the body up to `limit`; past it, drain (so Bun delivers the refusal) and answer `undefined`. */
+export declare function readCapped(ex: Exchange, limit: number): Promise<Buffer | undefined>;
+export declare function serveDecision(ex: Exchange, waitMs?: number): Promise<void>;

package/dist/server/public/decision.js

@@ -0,0 +1,135 @@
+/**
+ * `POST /v1/systemone` and `POST /v1/router/score`: the decision model's own API, passed through to
+ * the decision process byte for byte.
+ *
+ * Not through `serveForward`: that route needs a string `model` to pick a chat session, and the
+ * decision API makes `model` optional. Not parsed and re-serialized either: JSON through JavaScript
+ * loses `1.0` vs `1` (the engine renders them differently in the prompt), integers past 2^53, and the
+ * order of number-like keys, and the engine's answer is only as calibrated as its input is exact. So
+ * the request body goes out as the client sent it, with the process's own key instead of the client's,
+ * and the engine's answer (its error envelope included) comes back unchanged.
+ *
+ * When the module cannot answer, the route says why in the engine's own envelope, with 503, so a
+ * client handles one shape: `{"error": {"code", "type", "reason": "UNAVAILABLE", "message"}}`. A
+ * route the running engine does not serve (the router on upstream llama.cpp) gets 501 with
+ * `"reason": "UNSUPPORTED_ENDPOINT"` in the same envelope.
+ */
+import { decisionPromptPreview, decisionReplyFields } from './decision-preview.js';
+import { answer, clientGone, connectTimeoutMs, header } from './exchange.js';
+import { pipeBody, relay, relayedHeaders, sendUpstream, UpstreamUnreachable } from './wire.js';
+/** Public path (after the prefix) → the decision process's path. */
+export const DECISION_ROUTES = {
+    '/systemone': '/v1/systemone',
+    '/router/score': '/v1/router/score',
+};
+/**
+ * The public cap on a decision body. The engine refuses more than 1 MiB itself, with its own
+ * `BODY_TOO_LARGE` envelope; up to this size the body is passed on so the client gets that answer.
+ */
+export const MAX_DECISION_BODY_BYTES = 8 * 1024 * 1024;
+/** How long a request waits for a module that is enabled but not running to start. */
+export const DECISION_START_WAIT_MS = 30_000;
+export const DECISION_BACKEND_LABEL = 'atomic-decision';
+const JSON_HEADERS = [['Content-Type', 'application/json']];
+/** The engine's error envelope, for the answers the core writes itself. */
+export function decisionErrorBody(status, reason, message, type) {
+    return JSON.stringify({ error: { code: status, type, reason, message } });
+}
+/** Read the body up to `limit`; past it, drain (so Bun delivers the refusal) and answer `undefined`. */
+export async function readCapped(ex, limit) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of ex.req) {
+        const buf = chunk;
+        size += buf.length;
+        if (size > limit) {
+            chunks.length = 0;
+            if (size > limit * 8) {
+                ex.req.destroy();
+                break;
+            }
+            continue;
+        }
+        chunks.push(buf);
+    }
+    return size > limit ? undefined : Buffer.concat(chunks);
+}
+/**
+ * `relay` with a copy of the bytes kept on the side for the inspector's reply preview. The fields
+ * are stashed when the body ends, before the response closes and the trace reads them.
+ */
+async function relayInspected(ex, upstream) {
+    const chunks = [];
+    async function* tap() {
+        for await (const chunk of upstream.body) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            yield chunk;
+        }
+        ex.trace.stash(decisionReplyFields(Buffer.concat(chunks)));
+    }
+    ex.res.writeHead(upstream.status, relayedHeaders(upstream, ex.cors).flat());
+    await pipeBody(ex.res, tap(), () => upstream.body.destroy());
+}
+function unavailableAnswer(ex, message) {
+    ex.trace.errorKind = 'local_model_unreachable';
+    answer(ex, 503, decisionErrorBody(503, 'UNAVAILABLE', message, 'unavailable_error'), JSON_HEADERS);
+}
+export async function serveDecision(ex, waitMs = DECISION_START_WAIT_MS) {
+    const upstreamPath = DECISION_ROUTES[ex.path];
+    ex.trace.backend = DECISION_BACKEND_LABEL;
+    const body = ex.body ?? (await readCapped(ex, MAX_DECISION_BODY_BYTES));
+    if (body === undefined) {
+        ex.trace.errorKind = 'bad_request';
+        return answer(ex, 413, decisionErrorBody(413, 'BODY_TOO_LARGE', `The request body is over ${MAX_DECISION_BODY_BYTES} bytes.`, 'invalid_request_error'), JSON_HEADERS);
+    }
+    const backend = ex.deps.decision;
+    if (!backend)
+        return unavailableAnswer(ex, 'The decision model is not available in this core.');
+    ex.trace.modelId = backend.modelId?.() ?? null;
+    if (ex.trace.inspecting)
+        ex.trace.announce(undefined, undefined, decisionPromptPreview(body));
+    // One signal for the whole exchange: a client that leaves while the module starts frees the handler.
+    const gone = clientGone(ex);
+    const target = await backend.acquire(waitMs, gone);
+    if (!target.ok)
+        return unavailableAnswer(ex, `The decision model is not available (${target.reason}). ${target.message}`);
+    // Upstream llama.cpp serves `/v1/systemone` only: the router is the fork's, so say that instead of
+    // relaying the engine's bare 404.
+    if (target.endpoints !== undefined && !target.endpoints.includes(upstreamPath)) {
+        target.release();
+        ex.trace.errorKind = 'local_model_error';
+        return answer(ex, 501, decisionErrorBody(501, 'UNSUPPORTED_ENDPOINT', `The running decision model does not serve ${upstreamPath}.`, 'not_supported_error'), JSON_HEADERS);
+    }
+    try {
+        let upstream;
+        try {
+            upstream = await sendUpstream(`http://127.0.0.1:${target.port}${upstreamPath}`, {
+                method: 'POST',
+                headers: [
+                    ['Content-Type', header(ex.req, 'content-type') ?? 'application/json'],
+                    ['Accept', 'application/json'],
+                    ['Authorization', `Bearer ${target.apiKey}`],
+                ],
+                body,
+                connectTimeoutMs: connectTimeoutMs(ex),
+                signal: gone,
+            });
+        }
+        catch (error) {
+            if (!(error instanceof UpstreamUnreachable))
+                throw error;
+            return unavailableAnswer(ex, `The decision model did not answer: ${error.message}`);
+        }
+        ex.trace.upstreamStatus = upstream.status;
+        if (upstream.status >= 400)
+            ex.trace.errorKind = 'local_model_error';
+        if (ex.trace.inspecting)
+            await relayInspected(ex, upstream);
+        else
+            await relay(ex.res, upstream, ex.cors);
+    }
+    finally {
+        target.release();
+    }
+}
+//# sourceMappingURL=decision.js.map

package/dist/server/public/decision.js.map

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

package/dist/server/public/embedding.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `POST /v1/embeddings` for the embedding module's model
+ * (ADR 2026-10-07-embedding-models-are-their-own-core-module).
+ *
+ * The route is shared: a request whose `model` names the module's model is served here, by the
+ * module's own process; any other goes on to `serveForward` (cloud providers, then the loaded
+ * sessions) exactly as before, with the body already read handed over in `ex.body`.
+ *
+ * A request served here is started for (an enabled module that is idle starts and is waited on), then
+ * checked (`checkEmbeddingRequest`: no media links, no inline media the engine would fail to parse, no
+ * media the model cannot read, no `dimensions` it does not produce) and passed through byte for byte
+ * with the process's own key. The engine's answer, its error envelope included, comes back unchanged,
+ * except its 500 for media it could not decode: that is the client's input, so it becomes a 400 naming
+ * the field (`undecodableMediaVerdict`). The answers the core writes itself use the OpenAI error shape,
+ * with `param` when a field is at fault, like the rest of `/v1`.
+ */
+import type { EmbeddingBackend } from './types.js';
+import type { Exchange } from './exchange.js';
+/** Inline images and audio are base64: a few of them make a body far larger than a text one. */
+export declare const MAX_EMBEDDING_BODY_BYTES: number;
+/** How long a request waits for a module that is enabled but not running to start. */
+export declare const EMBEDDING_START_WAIT_MS = 60000;
+export declare const EMBEDDING_BACKEND_LABEL = "atomic-embedding";
+/** `owned_by` of the module's model in `/v1/models`. */
+export declare const EMBEDDING_OWNED_BY = "atomic-embedding";
+/**
+ * Serve `ex` when its `model` is the embedding module's and answer `true`; otherwise answer `false`
+ * with the body kept in `ex.body` for the next route. A body over the cap is refused here, whoever it
+ * was for.
+ */
+export declare function serveEmbeddingIfOwned(ex: Exchange, backend: EmbeddingBackend, waitMs?: number): Promise<boolean>;

package/dist/server/public/embedding.js

@@ -0,0 +1,126 @@
+/**
+ * `POST /v1/embeddings` for the embedding module's model
+ * (ADR 2026-10-07-embedding-models-are-their-own-core-module).
+ *
+ * The route is shared: a request whose `model` names the module's model is served here, by the
+ * module's own process; any other goes on to `serveForward` (cloud providers, then the loaded
+ * sessions) exactly as before, with the body already read handed over in `ex.body`.
+ *
+ * A request served here is started for (an enabled module that is idle starts and is waited on), then
+ * checked (`checkEmbeddingRequest`: no media links, no inline media the engine would fail to parse, no
+ * media the model cannot read, no `dimensions` it does not produce) and passed through byte for byte
+ * with the process's own key. The engine's answer, its error envelope included, comes back unchanged,
+ * except its 500 for media it could not decode: that is the client's input, so it becomes a 400 naming
+ * the field (`undecodableMediaVerdict`). The answers the core writes itself use the OpenAI error shape,
+ * with `param` when a field is at fault, like the rest of `/v1`.
+ */
+import { checkEmbeddingRequest, undecodableMediaVerdict } from '../../embedding/index.js';
+import { readCapped } from './decision.js';
+import { structuredErrorJson } from './errors.js';
+import { answer, clientGone, connectTimeoutMs, header } from './exchange.js';
+import { endpointFromPath } from './trace.js';
+import { readUpstreamText, relay, relayedHeaders, sendUpstream, sendWhole, UpstreamUnreachable, } from './wire.js';
+/** Inline images and audio are base64: a few of them make a body far larger than a text one. */
+export const MAX_EMBEDDING_BODY_BYTES = 64 * 1024 * 1024;
+/** How long a request waits for a module that is enabled but not running to start. */
+export const EMBEDDING_START_WAIT_MS = 60_000;
+export const EMBEDDING_BACKEND_LABEL = 'atomic-embedding';
+/** `owned_by` of the module's model in `/v1/models`. */
+export const EMBEDDING_OWNED_BY = 'atomic-embedding';
+const JSON_HEADERS = [['Content-Type', 'application/json']];
+/** The `model` a body names, without failing on anything: a body this cannot read is not the module's. */
+function modelOf(body) {
+    try {
+        const json = JSON.parse(body.toString('utf8'));
+        const model = typeof json === 'object' && json !== null && !Array.isArray(json)
+            ? json['model']
+            : undefined;
+        return { json, model: typeof model === 'string' ? model : undefined };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Serve `ex` when its `model` is the embedding module's and answer `true`; otherwise answer `false`
+ * with the body kept in `ex.body` for the next route. A body over the cap is refused here, whoever it
+ * was for.
+ */
+export async function serveEmbeddingIfOwned(ex, backend, waitMs = EMBEDDING_START_WAIT_MS) {
+    const modelId = backend.modelId();
+    if (modelId === null)
+        return false;
+    const body = ex.body ?? (await readCapped(ex, MAX_EMBEDDING_BODY_BYTES));
+    if (body === undefined) {
+        ex.trace.endpoint = endpointFromPath(ex.path);
+        ex.trace.errorKind = 'bad_request';
+        answer(ex, 413, structuredErrorJson(`The request body is over ${MAX_EMBEDDING_BODY_BYTES} bytes.`, 'invalid_request_error', 'request_too_large'), JSON_HEADERS);
+        return true;
+    }
+    ex.body = body;
+    const parsed = modelOf(body);
+    if (parsed?.model !== modelId)
+        return false;
+    const trace = ex.trace;
+    trace.endpoint = endpointFromPath(ex.path);
+    trace.backend = EMBEDDING_BACKEND_LABEL;
+    trace.modelId = modelId;
+    const gone = clientGone(ex);
+    const target = await backend.acquire(waitMs, gone);
+    if (!target.ok) {
+        trace.errorKind = 'local_model_unreachable';
+        answer(ex, 503, structuredErrorJson(target.message, 'server_error', 'model_not_available'), JSON_HEADERS);
+        return true;
+    }
+    try {
+        const verdict = checkEmbeddingRequest(parsed.json, target.modalities, target.dims);
+        if (!verdict.ok) {
+            trace.errorKind = 'bad_request';
+            answer(ex, 400, structuredErrorJson(verdict.message, 'invalid_request_error', 'invalid_value', verdict.param), JSON_HEADERS);
+            return true;
+        }
+        let upstream;
+        try {
+            upstream = await sendUpstream(`http://127.0.0.1:${target.port}/v1/embeddings`, {
+                method: 'POST',
+                headers: [
+                    ['Content-Type', header(ex.req, 'content-type') ?? 'application/json'],
+                    ['Accept', 'application/json'],
+                    ['Authorization', `Bearer ${target.apiKey}`],
+                ],
+                body,
+                connectTimeoutMs: connectTimeoutMs(ex),
+                signal: gone,
+            });
+        }
+        catch (error) {
+            if (!(error instanceof UpstreamUnreachable))
+                throw error;
+            trace.errorKind = 'local_model_unreachable';
+            answer(ex, 503, structuredErrorJson(`The embedding model did not answer: ${error.message}`, 'server_error', 'model_not_available'), JSON_HEADERS);
+            return true;
+        }
+        trace.upstreamStatus = upstream.status;
+        if (upstream.status === 500) {
+            // A 500 is read whole: the engine's word for media it could not decode makes it the client's error.
+            const text = await readUpstreamText(upstream);
+            const undecodable = undecodableMediaVerdict(upstream.status, text, parsed.json, target.modalities);
+            if (undecodable !== undefined) {
+                trace.errorKind = 'bad_request';
+                answer(ex, 400, structuredErrorJson(undecodable.message, 'invalid_request_error', 'invalid_value', undecodable.param), JSON_HEADERS);
+                return true;
+            }
+            trace.errorKind = 'local_model_error';
+            sendWhole(ex.res, upstream.status, relayedHeaders(upstream, ex.cors), text);
+            return true;
+        }
+        if (upstream.status >= 400)
+            trace.errorKind = 'local_model_error';
+        await relay(ex.res, upstream, ex.cors);
+        return true;
+    }
+    finally {
+        target.release();
+    }
+}
+//# sourceMappingURL=embedding.js.map

package/dist/server/public/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../../src/server/public/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EACL,gBAAgB,EAChB,KAAK,EACL,cAAc,EACd,YAAY,EACZ,SAAS,EACT,mBAAmB,GACpB,MAAM,WAAW,CAAA;AAElB,gGAAgG;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AACxD,sFAAsF;AACtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AACzD,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAA;AAEpD,MAAM,YAAY,GAA4B,CAAC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAEpF,0GAA0G;AAC1G,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QACvD,MAAM,KAAK,GACT,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC/D,CAAC,CAAE,IAAgC,CAAC,OAAO,CAAC;YAC5C,CAAC,CAAC,SAAS,CAAA;QACf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAY,EACZ,OAAyB,EACzB,MAAM,GAAG,uBAAuB;IAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;IACjC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,UAAU,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAA;IACxE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;QAC7C,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,aAAa,CAAA;QAClC,MAAM,CACJ,EAAE,EACF,GAAG,EACH,mBAAmB,CACjB,4BAA4B,wBAAwB,SAAS,EAC7D,uBAAuB,EACvB,mBAAmB,CACpB,EACD,YAAY,CACb,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,EAAE,CAAC,IAAI,GAAG,IAAI,CAAA;IACd,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,MAAM,EAAE,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAA;IAE3C,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAA;IACtB,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IAC1C,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAA;IACvC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,CAAC,SAAS,GAAG,yBAAyB,CAAA;QAC3C,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,qBAAqB,CAAC,EAAE,YAAY,CAAC,CAAA;QACzG,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAClF,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,KAAK,CAAC,SAAS,GAAG,aAAa,CAAA;YAC/B,MAAM,CACJ,EAAE,EACF,GAAG,EACH,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,EAC7F,YAAY,CACb,CAAA;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,QAAQ,CAAA;QACZ,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,YAAY,CAAC,oBAAoB,MAAM,CAAC,IAAI,gBAAgB,EAAE;gBAC7E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,kBAAkB,CAAC;oBACtE,CAAC,QAAQ,EAAE,kBAAkB,CAAC;oBAC9B,CAAC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;iBAC7C;gBACD,IAAI;gBACJ,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,CAAC;gBACtC,MAAM,EAAE,IAAI;aACb,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,mBAAmB,CAAC;gBAAE,MAAM,KAAK,CAAA;YACxD,KAAK,CAAC,SAAS,GAAG,yBAAyB,CAAA;YAC3C,MAAM,CACJ,EAAE,EACF,GAAG,EACH,mBAAmB,CACjB,uCAAuC,KAAK,CAAC,OAAO,EAAE,EACtD,cAAc,EACd,qBAAqB,CACtB,EACD,YAAY,CACb,CAAA;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,KAAK,CAAC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAA;QACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,oGAAoG;YACpG,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAA;YAC7C,MAAM,WAAW,GAAG,uBAAuB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;YAClG,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,KAAK,CAAC,SAAS,GAAG,aAAa,CAAA;gBAC/B,MAAM,CACJ,EAAE,EACF,GAAG,EACH,mBAAmB,CACjB,WAAW,CAAC,OAAO,EACnB,uBAAuB,EACvB,eAAe,EACf,WAAW,CAAC,KAAK,CAClB,EACD,YAAY,CACb,CAAA;gBACD,OAAO,IAAI,CAAA;YACb,CAAC;YACD,KAAK,CAAC,SAAS,GAAG,mBAAmB,CAAA;YACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;YAC3E,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;YAAE,KAAK,CAAC,SAAS,GAAG,mBAAmB,CAAA;QACjE,MAAM,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;QACtC,OAAO,IAAI,CAAA;IACb,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/server/public/errors.d.ts

@@ -18,7 +18,8 @@ export declare function bodyIndicatesOom(body: string): boolean;
  * during prompt processing answers 500 "Compute error" and every later request fails the same way).
  */
 export declare function isComputeBackendError(status: number, body: string): boolean;
-export declare function structuredErrorJson(message: string, type: string, code: string): string;
+/** The OpenAI error envelope; `param` names the request field at fault, when there is one. */
+export declare function structuredErrorJson(message: string, type: string, code: string, param?: string): string;
 export declare function computeErrorEnvelope(oom: boolean): string;
 /**
  * A local engine's error as the client receives it: an existing `{"error": {...}}` envelope passes