@atomic-chat/core 0.5.1 → 0.13.2

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

@@ -2,9 +2,9 @@
  * Image generation: one route per operation of the app's `DiffusionService`, in its camelCase
  * (ADR 2026-09-17-diffusion-speaks-the-apps-camelcase-and-error-codes-verbatim). File-system paths
  * travel in bodies, never in the URL. Lists and lookups that may be empty are wrapped
- * (`{backends}`, `{files}`, `{job}`, `{item}`) so a `null` never stands alone as a body.
+ * (`{files}`, `{job}`, `{item}`) so a `null` never stands alone as a body.
  */
-import { parseDiffusionConfig, parseFinalizeArgs, parseGalleryFlags, parseGalleryListOptions, parseImageGenerateRequest, parseLoadModelRequest, requireString, requireStringList, } from '../../../diffusion/index.js';
+import { parseDiffusionConfig, parseGalleryFlags, parseGalleryListOptions, parseImageGenerateRequest, parseLoadModelRequest, requireString, requireStringList, } from '../../../diffusion/index.js';
 import { queryOf, readJsonBody, sendJson } from '../../http.js';
 /** A generation request may carry a source image, a mask and references inline as base64. */
 export const MAX_GENERATE_BODY_BYTES = 64 * 1024 * 1024;
@@ -27,13 +27,8 @@ export function registerDiffusionRoutes(router, deps, ctx) {
     router.put(p('/diffusion/config'), async (req, res) => sendJson(res, 200, await diffusion.configure(parseDiffusionConfig(await readJsonBody(req)))));
     router.get(p('/diffusion/status'), async (_req, res) => sendJson(res, 200, await diffusion.getStatus()));
     router.put(p('/diffusion/output-dir'), async (req, res) => sendJson(res, 200, await diffusion.setOutputDir(requireString(await readJsonBody(req), 'path'))));
-    // --- engine binary ---------------------------------------------------------------------------
-    router.post(p('/diffusion/backends/finalize'), async (req, res) => sendJson(res, 200, await diffusion.finalizeBackendInstall(parseFinalizeArgs(await readJsonBody(req)))));
-    router.get(p('/diffusion/backends'), async (_req, res) => sendJson(res, 200, { backends: await diffusion.listInstalledBackends() }));
-    router.post(p('/diffusion/backends/remove'), async (req, res) => {
-        await diffusion.removeBackend(requireString(await readJsonBody(req), 'dir'));
-        sendJson(res, 200, {});
-    });
+    // The engine binary is installed, listed and removed through `/engine-builds/sd-cpp/…`
+    // (change `move-sdcpp-mlx-install-to-core`); `finalize` is gone with the app's own installer.
     // --- model files -----------------------------------------------------------------------------
     router.get(p('/diffusion/model-files'), async (_req, res) => sendJson(res, 200, { files: await diffusion.listModelFiles() }));
     router.post(p('/diffusion/model-files/delete'), async (req, res) => {

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * The embedding model: status, configuration, load and unload, and one request to the running model
+ * (ADR 2026-10-07-embedding-models-are-their-own-core-module). Bodies are snake_case like
+ * `settings.json`. `embed` takes a `/v1/embeddings` body (its `model` is replaced by the running
+ * model's) and answers `{status, body}`: the engine's own answer, an error envelope included.
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerEmbeddingRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,43 @@
+/**
+ * The embedding model: status, configuration, load and unload, and one request to the running model
+ * (ADR 2026-10-07-embedding-models-are-their-own-core-module). Bodies are snake_case like
+ * `settings.json`. `embed` takes a `/v1/embeddings` body (its `model` is replaced by the running
+ * model's) and answers `{status, body}`: the engine's own answer, an error envelope included.
+ */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { readJsonBody, sendJson } from '../../http.js';
+function control(deps) {
+    if (!deps.embedding)
+        throw new AtomicCoreError('EMBEDDING_UNAVAILABLE', 'The embedding model is not available in this core.');
+    return deps.embedding;
+}
+async function objectBody(req, what) {
+    const body = await readJsonBody(req);
+    if (typeof body !== 'object' || body === null || Array.isArray(body))
+        throw new AtomicCoreError('INVALID_ARGUMENT', `The ${what} must be a JSON object.`);
+    return body;
+}
+export function registerEmbeddingRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    const configAnswer = (embedding) => ({
+        config: embedding.config(),
+        status: embedding.status(),
+    });
+    router.get(p('/embedding/status'), async (_req, res) => sendJson(res, 200, control(deps).status()));
+    router.get(p('/embedding/config'), async (_req, res) => sendJson(res, 200, configAnswer(control(deps))));
+    router.put(p('/embedding/config'), async (req, res) => {
+        const embedding = control(deps);
+        await embedding.configure(await objectBody(req, 'embedding settings'));
+        sendJson(res, 200, configAnswer(embedding));
+    });
+    router.post(p('/embedding/load'), async (_req, res) => sendJson(res, 200, await control(deps).load()));
+    router.post(p('/embedding/unload'), async (_req, res) => sendJson(res, 200, await control(deps).unload()));
+    router.post(p('/embedding/embed'), async (req, res) => {
+        const embedding = control(deps);
+        const body = await objectBody(req, 'embedding request');
+        if (body['input'] === undefined)
+            throw new AtomicCoreError('INVALID_ARGUMENT', "The embedding request needs an 'input'.");
+        sendJson(res, 200, await embedding.embed(body));
+    });
+}
+//# sourceMappingURL=embedding.js.map

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

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

package/dist/server/control/routes/engine-builds.d.ts

@@ -0,0 +1,14 @@
+/**
+ * sd.cpp and MLX builds the core installs itself (openspec change `move-sdcpp-mlx-install-to-core`,
+ * spec `engine-builds`, design D1, D2). All of them POST or DELETE: the proxy policy may carry
+ * credentials, which never travel in a query string.
+ *
+ * Bodies are checked here, unknown fields included, as on `/environments`: a field this build would
+ * silently ignore means something to the caller and nothing to the core.
+ */
+import type { EngineBuildCatalogRequest, EngineBuildInstallRequest } from '../../../contracts/index.js';
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function parseEngineBuildReadBody(raw: unknown): EngineBuildCatalogRequest;
+export declare function parseEngineBuildInstallBody(raw: unknown): EngineBuildInstallRequest;
+export declare function registerEngineBuildRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

package/dist/server/control/routes/engine-builds.js

@@ -0,0 +1,82 @@
+/**
+ * sd.cpp and MLX builds the core installs itself (openspec change `move-sdcpp-mlx-install-to-core`,
+ * spec `engine-builds`, design D1, D2). All of them POST or DELETE: the proxy policy may carry
+ * credentials, which never travel in a query string.
+ *
+ * Bodies are checked here, unknown fields included, as on `/environments`: a field this build would
+ * silently ignore means something to the caller and nothing to the core.
+ */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { parseEngineBuildId } from '../../../engine-builds/index.js';
+import { readJsonBody, sendJson } from '../../http.js';
+const invalid = (why, details) => {
+    throw new AtomicCoreError('INVALID_ARGUMENT', why, details);
+};
+/** A task id is an event name and a key in the downloader; a path segment is a folder name. */
+const ID_SHAPE = /^[^/\\]{1,200}$/;
+const SEGMENT_SHAPE = /^[A-Za-z0-9._-]{1,200}$/;
+function object(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return invalid('The request body must be a JSON object.');
+    return value;
+}
+function known(body, keys) {
+    const extra = Object.keys(body).filter((key) => !keys.includes(key));
+    if (extra.length > 0)
+        invalid('The request has fields this core does not know.', extra.sort().join(', '));
+}
+function common(body) {
+    const { force, proxy } = body;
+    if (force !== undefined && typeof force !== 'boolean')
+        invalid('force must be a boolean.');
+    if (proxy !== undefined && proxy !== null && (typeof proxy !== 'object' || Array.isArray(proxy)))
+        invalid('proxy must be an object or null.');
+    return {
+        ...(force !== undefined ? { force: force } : {}),
+        ...(proxy !== undefined ? { proxy: proxy } : {}),
+    };
+}
+export function parseEngineBuildReadBody(raw) {
+    const body = object(raw);
+    known(body, ['force', 'proxy']);
+    return common(body);
+}
+export function parseEngineBuildInstallBody(raw) {
+    const body = object(raw);
+    known(body, ['task_id', 'force', 'proxy']);
+    const taskId = body['task_id'];
+    if (typeof taskId !== 'string' ||
+        !ID_SHAPE.test(taskId) ||
+        [...taskId].some((ch) => ch.charCodeAt(0) < 0x20))
+        invalid('install needs task_id: the download task its progress and cancel run under.');
+    return { task_id: taskId, ...common(body) };
+}
+function segment(value, name) {
+    if (value === undefined || !SEGMENT_SHAPE.test(value) || value === '.' || value === '..')
+        return invalid(`${name} is not a build identifier.`, value);
+    return value;
+}
+export function registerEngineBuildRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.post(p('/engine-builds/:engine/catalog'), async (req, res, { params }) => {
+        const engine = parseEngineBuildId(params['engine']);
+        sendJson(res, 200, await deps.engineBuilds.catalog(engine, parseEngineBuildReadBody(await readJsonBody(req))));
+    });
+    router.post(p('/engine-builds/:engine/updates'), async (req, res, { params }) => {
+        const engine = parseEngineBuildId(params['engine']);
+        sendJson(res, 200, await deps.engineBuilds.checkUpdates(engine, parseEngineBuildReadBody(await readJsonBody(req))));
+    });
+    // Synchronous like `POST /backends/:p/install` (design D2): progress and cancel go through
+    // `download:*` events and `POST /downloads/:task_id/cancel` under the caller's task id.
+    router.post(p('/engine-builds/:engine/install'), async (req, res, { params }) => {
+        const engine = parseEngineBuildId(params['engine']);
+        sendJson(res, 200, await deps.engineBuilds.install(engine, parseEngineBuildInstallBody(await readJsonBody(req))));
+    });
+    router.delete(p('/engine-builds/:engine/:tag/:backend_id'), async (_req, res, { params }) => {
+        const engine = parseEngineBuildId(params['engine']);
+        const tag = segment(params['tag'], 'tag');
+        const backendId = segment(params['backend_id'], 'backend_id');
+        sendJson(res, 200, await deps.engineBuilds.remove(engine, tag, backendId));
+    });
+}
+//# sourceMappingURL=engine-builds.js.map

package/dist/server/control/routes/engine-builds.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * The `/engines` layer's routes (change `unify-engine-lifecycle`, spec `engine-lifecycle`, design D2,
+ * D10): the versions of every engine of this host, an update, an activation and the removal of one
+ * build. The versions and the update are POST: the proxy policy may carry credentials, which never
+ * travel in a query string.
+ *
+ * Bodies are checked here, unknown fields included, as on `/engine-builds`: a field this build would
+ * silently ignore means something to the caller and nothing to the core. Which body an update takes
+ * depends on the engine: `{task_id, target?, …}` for the engines that swap a build, `{request_id,
+ * app_version?}` for the managed ones, which answer `202` with the operation they began.
+ */
+import type { EngineId, EngineUpdateRequest, EngineVersionsRequest } from '../../../contracts/index.js';
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function parseEngineVersionsBody(raw: unknown): EngineVersionsRequest;
+export declare function parseEngineUpdateBody(engine: EngineId, raw: unknown): EngineUpdateRequest;
+export declare function registerEngineRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,152 @@
+/**
+ * The `/engines` layer's routes (change `unify-engine-lifecycle`, spec `engine-lifecycle`, design D2,
+ * D10): the versions of every engine of this host, an update, an activation and the removal of one
+ * build. The versions and the update are POST: the proxy policy may carry credentials, which never
+ * travel in a query string.
+ *
+ * Bodies are checked here, unknown fields included, as on `/engine-builds`: a field this build would
+ * silently ignore means something to the caller and nothing to the core. Which body an update takes
+ * depends on the engine: `{task_id, target?, …}` for the engines that swap a build, `{request_id,
+ * app_version?}` for the managed ones, which answer `202` with the operation they began.
+ */
+import { AtomicCoreError, ENGINE_IDS, ENGINE_KINDS } from '../../../contracts/index.js';
+import { queryOf, readJsonBody, sendJson } from '../../http.js';
+const invalid = (why, details) => {
+    throw new AtomicCoreError('INVALID_ARGUMENT', why, details);
+};
+/** A task or request id is an event name and a key on disk; a path segment is a folder name. */
+const ID_SHAPE = /^[^/\\]{1,200}$/;
+const SEGMENT_SHAPE = /^[A-Za-z0-9._-]{1,200}$/;
+/** A managed engine's build variant is its image platform (`linux%2Famd64` in the path). */
+const PLATFORM_SHAPE = /^linux\/(amd64|arm64)$/;
+function engineOf(raw) {
+    if (raw === undefined || !ENGINE_IDS.includes(raw))
+        return invalid(`There is no engine named ${raw ?? ''}.`, raw);
+    return raw;
+}
+function object(value, what = 'The request body') {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return invalid(`${what} must be a JSON object.`);
+    return value;
+}
+function known(body, keys) {
+    const extra = Object.keys(body).filter((key) => !keys.includes(key));
+    if (extra.length > 0)
+        invalid('The request has fields this core does not know.', extra.sort().join(', '));
+}
+function id(value, name) {
+    if (typeof value !== 'string' || !ID_SHAPE.test(value) || [...value].some((ch) => ch.charCodeAt(0) < 0x20))
+        return invalid(`${name} must be a non-empty id without slashes.`);
+    return value;
+}
+function segment(value, name) {
+    if (typeof value !== 'string' || !SEGMENT_SHAPE.test(value) || value === '.' || value === '..')
+        return invalid(`${name} is not a build identifier.`, typeof value === 'string' ? value : undefined);
+    return value;
+}
+function variantOf(engine, value) {
+    if (ENGINE_KINDS[engine] === 'managed') {
+        if (value === undefined || !PLATFORM_SHAPE.test(value))
+            return invalid('A managed engine build is named by its image platform: linux/amd64 or linux/arm64.', value);
+        return value;
+    }
+    return segment(value, 'variant');
+}
+function appVersion(body) {
+    const value = body['app_version'];
+    if (value === undefined)
+        return {};
+    if (value !== null && typeof value !== 'string')
+        invalid('app_version must be a string or null.');
+    return { app_version: value };
+}
+function forceAndProxy(body) {
+    const { force, proxy } = body;
+    if (force !== undefined && typeof force !== 'boolean')
+        invalid('force must be a boolean.');
+    if (proxy !== undefined && proxy !== null && (typeof proxy !== 'object' || Array.isArray(proxy)))
+        invalid('proxy must be an object or null.');
+    return {
+        ...(force !== undefined ? { force: force } : {}),
+        ...(proxy !== undefined ? { proxy: proxy } : {}),
+    };
+}
+export function parseEngineVersionsBody(raw) {
+    const body = object(raw);
+    known(body, ['force', 'proxy', 'app_version']);
+    return { ...forceAndProxy(body), ...appVersion(body) };
+}
+export function parseEngineUpdateBody(engine, raw) {
+    const body = object(raw);
+    if (ENGINE_KINDS[engine] === 'managed') {
+        known(body, ['request_id', 'app_version']);
+        const request = {
+            request_id: id(body['request_id'], 'request_id'),
+            ...appVersion(body),
+        };
+        return request;
+    }
+    known(body, ['task_id', 'target', 'force', 'proxy', 'app_version']);
+    const request = {
+        task_id: id(body['task_id'], 'task_id'),
+        ...forceAndProxy(body),
+        ...appVersion(body),
+    };
+    if (body['target'] !== undefined) {
+        if (ENGINE_KINDS[engine] !== 'llamacpp')
+            invalid(`The core picks the ${engine} build for this computer; an update takes no target.`);
+        const target = object(body['target'], 'target');
+        known(target, ['version', 'variant']);
+        request.target = {
+            ...(target['version'] !== undefined ? { version: segment(target['version'], 'target.version') } : {}),
+            variant: segment(target['variant'], 'target.variant'),
+        };
+    }
+    return request;
+}
+function retainModels(req) {
+    const raw = queryOf(req).get('retain_models');
+    if (raw === null)
+        return {};
+    if (raw !== 'true' && raw !== 'false')
+        return invalid('retain_models must be true or false.', raw);
+    return { retainModels: raw === 'true' };
+}
+/** Without the layer wired (a core built without it), every route says so rather than 404. */
+function enginesOf(deps) {
+    if (deps.engines === undefined)
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'This core does not manage engines through /engines.');
+    return deps.engines;
+}
+/** A managed engine's update and removal answer with the operation they began. */
+const statusOf = (result) => ('operation_id' in result ? 202 : 200);
+export function registerEngineRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.post(p('/engines/versions'), async (req, res) => {
+        const request = parseEngineVersionsBody(await readJsonBody(req));
+        sendJson(res, 200, await enginesOf(deps).versions(request));
+    });
+    // Synchronous for the engines that swap a build, like `POST /engine-builds/:engine/install`:
+    // progress and cancel go through `download:*` and `POST /downloads/:task_id/cancel`.
+    router.post(p('/engines/:engine/update'), async (req, res, { params }) => {
+        const engine = engineOf(params['engine']);
+        const request = parseEngineUpdateBody(engine, await readJsonBody(req));
+        const result = await enginesOf(deps).update(engine, request);
+        sendJson(res, statusOf(result), result);
+    });
+    router.delete(p('/engines/:engine/builds/:version/:variant'), async (req, res, { params }) => {
+        const engine = engineOf(params['engine']);
+        const version = segment(params['version'], 'version');
+        const variant = variantOf(engine, params['variant']);
+        const result = await enginesOf(deps).remove(engine, version, variant, retainModels(req));
+        sendJson(res, statusOf(result), result);
+    });
+    router.post(p('/engines/:engine/builds/:version/:variant/activate'), async (req, res, { params }) => {
+        const engine = engineOf(params['engine']);
+        const version = segment(params['version'], 'version');
+        const variant = variantOf(engine, params['variant']);
+        known(object(await readJsonBody(req)), []);
+        sendJson(res, 200, await enginesOf(deps).activate(engine, version, variant));
+    });
+}
+//# sourceMappingURL=engines.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * The managed container runtime over the control API: what the machine would need, starting the
+ * change, watching it, and coming back to it after the app was closed or the machine restarted.
+ *
+ * Bodies are validated here rather than trusted, including their unknown fields. A field this build
+ * would silently ignore is a request that means something to the caller and nothing to us, and on a
+ * surface where one of the calls ends in a password prompt that is worth refusing outright.
+ *
+ * The privileged step is the reason the shapes look the way they do. The core never runs it: it
+ * hands out a step bound to one operation, one revision and a single-use nonce, and the app comes
+ * back with a receipt naming all three. A replayed receipt is refused with
+ * `MANAGED_RECEIPT_CONFLICT` instead of authorizing anything a second time (task 2.6).
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerEnvironmentRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,207 @@
+/**
+ * The managed container runtime over the control API: what the machine would need, starting the
+ * change, watching it, and coming back to it after the app was closed or the machine restarted.
+ *
+ * Bodies are validated here rather than trusted, including their unknown fields. A field this build
+ * would silently ignore is a request that means something to the caller and nothing to us, and on a
+ * surface where one of the calls ends in a password prompt that is worth refusing outright.
+ *
+ * The privileged step is the reason the shapes look the way they do. The core never runs it: it
+ * hands out a step bound to one operation, one revision and a single-use nonce, and the app comes
+ * back with a receipt naming all three. A replayed receipt is refused with
+ * `MANAGED_RECEIPT_CONFLICT` instead of authorizing anything a second time (task 2.6).
+ */
+import { AtomicCoreError, MANAGED_OPERATION_KINDS } from '../../../contracts/index.js';
+import { readJsonBody, sendError, sendJson } from '../../http.js';
+const invalid = (why, details) => {
+    throw new AtomicCoreError('INVALID_ARGUMENT', why, details);
+};
+const unavailable = () => {
+    throw new AtomicCoreError('MANAGED_ADAPTER_UNAVAILABLE', 'Managed runtimes are not available in this build.');
+};
+const DIGEST = /^sha256:[0-9a-f]{64}$/;
+/** Ids travel in a path segment and become a directory name; anything else is a caller's mistake. */
+const ID_SHAPE = /^[^/\\]{1,200}$/;
+const isId = (value) => ID_SHAPE.test(value) && ![...value].some((ch) => ch.charCodeAt(0) < 0x20);
+const object = (value, at) => typeof value === 'object' && value !== null && !Array.isArray(value)
+    ? value
+    : invalid(`${at} must be an object.`);
+const known = (source, at, keys) => {
+    const extra = Object.keys(source).filter((key) => !keys.includes(key));
+    if (extra.length > 0)
+        invalid(`${at} has fields this core does not know.`, extra.sort().join(', '));
+};
+const id = (value, at) => typeof value === 'string' && isId(value) ? value : invalid(`${at} is not a valid id.`);
+const digest = (value, at) => typeof value === 'string' && DIGEST.test(value)
+    ? value
+    : invalid(`${at} is not a sha256 digest.`);
+const revision = (value, at) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0
+    ? value
+    : invalid(`${at} is not a revision.`);
+const oneOf = (value, at, allowed) => typeof value === 'string' && allowed.includes(value)
+    ? value
+    : invalid(`${at} must be one of: ${allowed.join(', ')}.`);
+const target = (value, at) => {
+    const raw = object(value, at);
+    const kind = oneOf(raw['kind'], `${at}.kind`, ['environment', 'runtime']);
+    if (kind === 'environment') {
+        known(raw, at, ['kind']);
+        return { kind };
+    }
+    known(raw, at, ['kind', 'installation_id', 'engine_id']);
+    return {
+        kind,
+        installation_id: id(raw['installation_id'], `${at}.installation_id`),
+        engine_id: id(raw['engine_id'], `${at}.engine_id`),
+    };
+};
+const beginBody = (value) => {
+    const raw = object(value, 'the request');
+    known(raw, 'the request', [
+        'request_id',
+        'target',
+        'kind',
+        'descriptor_id',
+        'retain_models',
+        'approved_plan_digest',
+    ]);
+    const kind = oneOf(raw['kind'], 'kind', MANAGED_OPERATION_KINDS);
+    // Setting something up or replacing it needs to say what with; a removal already knows.
+    if (kind !== 'remove' && raw['descriptor_id'] === undefined) {
+        invalid('A setup or an update has to name the runtime it installs.', 'descriptor_id');
+    }
+    if (raw['retain_models'] !== undefined && typeof raw['retain_models'] !== 'boolean') {
+        invalid('retain_models must be true or false.');
+    }
+    return {
+        request_id: id(raw['request_id'], 'request_id'),
+        target: target(raw['target'], 'target'),
+        kind,
+        ...(raw['descriptor_id'] === undefined
+            ? {}
+            : { descriptor_id: id(raw['descriptor_id'], 'descriptor_id') }),
+        ...(raw['retain_models'] === undefined ? {} : { retain_models: raw['retain_models'] }),
+        ...(raw['approved_plan_digest'] === undefined
+            ? {}
+            : { approved_plan_digest: digest(raw['approved_plan_digest'], 'approved_plan_digest') }),
+    };
+};
+const resumeBody = (value) => {
+    const raw = object(value, 'the request');
+    known(raw, 'the request', ['expected_revision', 'approved_plan_digest']);
+    return {
+        expected_revision: revision(raw['expected_revision'], 'expected_revision'),
+        ...(raw['approved_plan_digest'] === undefined
+            ? {}
+            : { approved_plan_digest: digest(raw['approved_plan_digest'], 'approved_plan_digest') }),
+    };
+};
+const probeBody = (value) => {
+    const raw = object(value, 'the request');
+    known(raw, 'the request', ['descriptor_id', 'environment_id', 'target']);
+    return {
+        descriptor_id: id(raw['descriptor_id'], 'descriptor_id'),
+        ...(raw['environment_id'] === undefined
+            ? {}
+            : { environment_id: id(raw['environment_id'], 'environment_id') }),
+        target: target(raw['target'], 'target'),
+    };
+};
+/** How much of a receipt's `log_tail` the core keeps (the executor's own is 2 000 characters). */
+const RECEIPT_LOG_TAIL_LIMIT = 16 * 1024;
+const receiptBody = (value) => {
+    const raw = object(value, 'the request');
+    known(raw, 'the request', [
+        'step_id',
+        'nonce',
+        'expected_operation_revision',
+        'recipe_digest',
+        'parameters_digest',
+        'outcome',
+        'receipt_id',
+        'log_tail',
+    ]);
+    const logTail = raw['log_tail'];
+    if (logTail !== undefined && typeof logTail !== 'string')
+        invalid('log_tail must be a string.');
+    return {
+        step_id: id(raw['step_id'], 'step_id'),
+        nonce: id(raw['nonce'], 'nonce'),
+        expected_operation_revision: revision(raw['expected_operation_revision'], 'expected_operation_revision'),
+        recipe_digest: digest(raw['recipe_digest'], 'recipe_digest'),
+        parameters_digest: digest(raw['parameters_digest'], 'parameters_digest'),
+        outcome: oneOf(raw['outcome'], 'outcome', [
+            'completed',
+            'declined',
+            'relogin-required',
+            'reboot-required',
+            'failed',
+        ]),
+        receipt_id: id(raw['receipt_id'], 'receipt_id'),
+        // The step's own log tail (task 2.23, F-4), kept to its last 16 KiB: a diagnostic, never refused
+        // for its length — the receipt it rides on is what the operation is waiting for.
+        ...(logTail === undefined ? {} : { log_tail: logTail.slice(-RECEIPT_LOG_TAIL_LIMIT) }),
+    };
+};
+export function registerEnvironmentRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    const service = () => deps.environments ?? unavailable();
+    router.get(p('/environments'), async (_req, res) => {
+        sendJson(res, 200, { environments: await service().list() });
+    });
+    // A POST, not a query: the target and the descriptor are structured, and probing changes nothing.
+    router.post(p('/environments/probe'), async (req, res) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await service().probe(probeBody(body)));
+    });
+    // One cached runtime descriptor, from the cache only (task 2.22): the id an installation pins or a
+    // plan names. An id the cache does not hold is 404 here, although `MANAGED_METADATA_INVALID` is 400
+    // everywhere else (`statusForCode`): the caller asked for something that is not there, rather than
+    // sending a malformed descriptor. Registered with the other fixed segments, ahead of any
+    // `/environments/:environmentId/...` pattern.
+    router.get(p('/environments/descriptors/:descriptorId'), async (_req, res, { params }) => {
+        const environments = service();
+        const descriptorId = id(params['descriptorId'], 'descriptorId');
+        try {
+            sendJson(res, 200, await environments.descriptor(descriptorId));
+        }
+        catch (error) {
+            if (error instanceof AtomicCoreError && error.code === 'MANAGED_METADATA_INVALID') {
+                sendError(res, error, 404);
+                return;
+            }
+            throw error;
+        }
+    });
+    // Registered before the `:operationId` family so neither pattern can swallow the other.
+    router.get(p('/environments/operations/:operationId'), async (_req, res, { params }) => {
+        sendJson(res, 200, await service().get(id(params['operationId'], 'operationId')));
+    });
+    router.post(p('/environments/operations/:operationId/cancel'), async (_req, res, { params }) => {
+        sendJson(res, 200, await service().cancel(id(params['operationId'], 'operationId')));
+    });
+    router.post(p('/environments/operations/:operationId/resume'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await service().resume(id(params['operationId'], 'operationId'), resumeBody(body)));
+    });
+    router.post(p('/environments/operations/:operationId/host-step-result'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await service().acceptHostReceipt(id(params['operationId'], 'operationId'), receiptBody(body)));
+    });
+    // 202: the operation is recorded and running, and the work it starts outlives this request.
+    router.post(p('/environments/:environmentId/operations'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        const operation = await service().begin(id(params['environmentId'], 'environmentId'), beginBody(body));
+        sendJson(res, 202, operation);
+    });
+    // Archive the finished operations so the next setup starts from a fresh plan; installs nothing,
+    // removes nothing installed. 409 (`MANAGED_OPERATION_CONFLICT`) while an operation still runs.
+    router.post(p('/environments/:environmentId/reset'), async (_req, res, { params }) => {
+        sendJson(res, 200, await service().reset(id(params['environmentId'], 'environmentId')));
+    });
+    // Read-only: what a person pastes into a support message (`EnvironmentDiagnostics`).
+    router.get(p('/environments/:environmentId/diagnostics'), async (_req, res, { params }) => {
+        sendJson(res, 200, await service().diagnostics(id(params['environmentId'], 'environmentId')));
+    });
+}
+//# sourceMappingURL=environments.js.map