@atomic-chat/core 0.5.1

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

@@ -0,0 +1,33 @@
+/**
+ * Video generation: the video half of the diffusion control surface, one route per operation, in
+ * the same camelCase as the image routes and with the same envelopes (`{job}`, `{item}`) so a
+ * `null` never stands alone. File-system paths travel in bodies, never in the URL.
+ */
+import { parseGalleryFlags, parseVideoGenerateRequest, parseVideoPoster, requireString, requireStringList, } from '../../../diffusion/index.js';
+import { readJsonBody, sendJson } from '../../http.js';
+import { galleryListOptionsFromQuery, MAX_GENERATE_BODY_BYTES } from './diffusion.js';
+/** A poster is a small PNG as base64; the JSON around it is nothing. */
+export const MAX_POSTER_BODY_BYTES = 24 * 1024 * 1024;
+export function registerDiffusionVideoRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    const { diffusion } = deps;
+    router.get(p('/diffusion/video/capabilities'), (_req, res) => sendJson(res, 200, diffusion.getVideoCapabilities()));
+    // --- jobs ------------------------------------------------------------------------------------
+    router.post(p('/diffusion/video/jobs'), async (req, res) => sendJson(res, 200, await diffusion.generateVideo(parseVideoGenerateRequest(await readJsonBody(req, MAX_GENERATE_BODY_BYTES)))));
+    router.get(p('/diffusion/video/jobs/:jobId'), (_req, res, { params }) => sendJson(res, 200, { job: diffusion.getVideoJob(params['jobId']) }));
+    router.post(p('/diffusion/video/jobs/:jobId/cancel'), async (_req, res, { params }) => sendJson(res, 200, await diffusion.cancelVideoJob(params['jobId'])));
+    // --- gallery ---------------------------------------------------------------------------------
+    router.get(p('/diffusion/video/gallery'), async (req, res) => sendJson(res, 200, await diffusion.listVideoGallery(galleryListOptionsFromQuery(req))));
+    router.get(p('/diffusion/video/gallery/:id'), async (_req, res, { params }) => sendJson(res, 200, { item: await diffusion.getVideoGalleryItem(params['id']) }));
+    router.post(p('/diffusion/video/gallery/delete'), async (req, res) => {
+        await diffusion.deleteVideoGalleryItems(requireStringList(await readJsonBody(req), 'ids'));
+        sendJson(res, 200, {});
+    });
+    router.patch(p('/diffusion/video/gallery/:id/flags'), async (req, res, { params }) => sendJson(res, 200, await diffusion.setVideoGalleryFlags(params['id'], parseGalleryFlags(await readJsonBody(req)))));
+    router.post(p('/diffusion/video/gallery/:id/export'), async (req, res, { params }) => {
+        await diffusion.exportVideoGalleryItem(params['id'], requireString(await readJsonBody(req), 'targetPath'));
+        sendJson(res, 200, {});
+    });
+    router.put(p('/diffusion/video/gallery/:id/poster'), async (req, res, { params }) => sendJson(res, 200, await diffusion.setVideoPoster(params['id'], parseVideoPoster(await readJsonBody(req, MAX_POSTER_BODY_BYTES)))));
+}
+//# sourceMappingURL=diffusion-video.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+import type { IncomingMessage } from 'node:http';
+import type { Router } from '../../http.js';
+import type { GalleryListOptions } from '../../../contracts/index.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+/** A generation request may carry a source image, a mask and references inline as base64. */
+export declare const MAX_GENERATE_BODY_BYTES: number;
+/** `?offset&limit&includeArchived` as the gallery listings (image and video) take them. */
+export declare function galleryListOptionsFromQuery(req: IncomingMessage): GalleryListOptions;
+export declare function registerDiffusionRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+import { parseDiffusionConfig, parseFinalizeArgs, 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;
+/** `?offset&limit&includeArchived` as the gallery listings (image and video) take them. */
+export function galleryListOptionsFromQuery(req) {
+    const query = queryOf(req);
+    const includeArchived = query.get('includeArchived');
+    // An absent or empty number is not zero.
+    const number = (value) => (value === null || value === '' ? Number.NaN : Number(value));
+    return parseGalleryListOptions({
+        offset: number(query.get('offset')),
+        limit: number(query.get('limit')),
+        ...(includeArchived === null ? {} : { includeArchived: includeArchived === 'true' }),
+    });
+}
+export function registerDiffusionRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    const { diffusion } = deps;
+    // --- configuration and status --------------------------------------------------------------
+    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, {});
+    });
+    // --- 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) => {
+        await diffusion.deleteModelFile(requireString(await readJsonBody(req), 'path'));
+        sendJson(res, 200, {});
+    });
+    // --- session ---------------------------------------------------------------------------------
+    router.post(p('/diffusion/model/load'), async (req, res) => sendJson(res, 200, await diffusion.loadModel(parseLoadModelRequest(await readJsonBody(req)))));
+    router.post(p('/diffusion/model/unload'), async (_req, res) => {
+        await diffusion.unloadModel();
+        sendJson(res, 200, {});
+    });
+    router.get(p('/diffusion/capabilities'), (_req, res) => sendJson(res, 200, diffusion.getCapabilities()));
+    router.post(p('/diffusion/idle/touch'), (_req, res) => {
+        diffusion.touchIdle();
+        sendJson(res, 200, {});
+    });
+    // --- jobs ------------------------------------------------------------------------------------
+    router.post(p('/diffusion/jobs'), async (req, res) => sendJson(res, 200, await diffusion.generate(parseImageGenerateRequest(await readJsonBody(req, MAX_GENERATE_BODY_BYTES)))));
+    router.get(p('/diffusion/jobs/:jobId'), (_req, res, { params }) => sendJson(res, 200, { job: diffusion.getJob(params['jobId']) }));
+    router.post(p('/diffusion/jobs/:jobId/cancel'), async (_req, res, { params }) => sendJson(res, 200, await diffusion.cancelJob(params['jobId'])));
+    // --- gallery ---------------------------------------------------------------------------------
+    router.get(p('/diffusion/gallery'), async (req, res) => sendJson(res, 200, await diffusion.listGallery(galleryListOptionsFromQuery(req))));
+    router.get(p('/diffusion/gallery/:id'), async (_req, res, { params }) => sendJson(res, 200, { item: await diffusion.getGalleryItem(params['id']) }));
+    router.post(p('/diffusion/gallery/delete'), async (req, res) => {
+        await diffusion.deleteGalleryItems(requireStringList(await readJsonBody(req), 'ids'));
+        sendJson(res, 200, {});
+    });
+    router.patch(p('/diffusion/gallery/:id/flags'), async (req, res, { params }) => sendJson(res, 200, await diffusion.setGalleryFlags(params['id'], parseGalleryFlags(await readJsonBody(req)))));
+    router.post(p('/diffusion/gallery/:id/export'), async (req, res, { params }) => {
+        await diffusion.exportGalleryItem(params['id'], requireString(await readJsonBody(req), 'targetPath'));
+        sendJson(res, 200, {});
+    });
+}
+//# sourceMappingURL=diffusion.js.map

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

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

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

@@ -0,0 +1,4 @@
+/** Free disk space inside the data folder, asked before a download that might not fit. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerDiskRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,11 @@
+/** Free disk space inside the data folder, asked before a download that might not fit. */
+import { readJsonBody, sendJson } from '../../http.js';
+export function registerDiskRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    // POST with the path in the body, not a query string: an absolute path carries a user name.
+    router.post(p('/disk/available'), async (req, res) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, { bytes: await deps.disk.available(body.path) });
+    });
+}
+//# sourceMappingURL=disk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../../../src/server/control/routes/disk.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAItD,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAuB,EAAE,GAAwB;IAClG,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAA;IAEjB,4FAA4F;IAC5F,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAqB,GAAG,CAAC,CAAA;QACxD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/server/control/routes/external-sessions.d.ts

@@ -0,0 +1,4 @@
+/** Engines another process owns: publish, heartbeat, unregister, list, and context-increase answers. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerExternalSessionRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

package/dist/server/control/routes/external-sessions.js

@@ -0,0 +1,27 @@
+/** Engines another process owns: publish, heartbeat, unregister, list, and context-increase answers. */
+import { readJsonBody, sendJson } from '../../http.js';
+export function registerExternalSessionRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/external-sessions'), (_req, res) => sendJson(res, 200, { sessions: deps.externalSessions.list() }));
+    router.put(p('/external-sessions/:owner'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, deps.externalSessions.publish(params['owner'], body.generation, body.sessions));
+    });
+    router.post(p('/external-sessions/:owner/heartbeat'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, deps.externalSessions.heartbeat(params['owner'], Number(body.generation)));
+    });
+    router.delete(p('/external-sessions/:owner'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, {
+            unregistered: deps.externalSessions.unregister(params['owner'], body.generation),
+        });
+    });
+    router.post(p('/external-sessions/:owner/ctx/:requestId'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, {
+            accepted: deps.externalSessions.answerCtx(params['owner'], params['requestId'], body),
+        });
+    });
+}
+//# sourceMappingURL=external-sessions.js.map

package/dist/server/control/routes/external-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-sessions.js","sourceRoot":"","sources":["../../../../src/server/control/routes/external-sessions.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAItD,MAAM,UAAU,6BAA6B,CAC3C,MAAc,EACd,IAAuB,EACvB,GAAwB;IAExB,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAA;IAEjB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAChD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAC/D,CAAA;IAED,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACxE,MAAM,IAAI,GAAG,MAAM,YAAY,CAA8C,GAAG,CAAC,CAAA;QACjF,QAAQ,CACN,GAAG,EACH,GAAG,EACH,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAW,EAAE,IAAI,CAAC,UAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,CACnG,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,qCAAqC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnF,MAAM,IAAI,GAAG,MAAM,YAAY,CAA0B,GAAG,CAAC,CAAA;QAC7D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAW,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACzG,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3E,MAAM,IAAI,GAAG,MAAM,YAAY,CAA0B,GAAG,CAAC,CAAA;QAC7D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAW,EAAE,IAAI,CAAC,UAAU,CAAC;SAC3F,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA0C,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACxF,MAAM,IAAI,GAAG,MAAM,YAAY,CAAU,GAAG,CAAC,CAAA;QAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,CACvC,MAAM,CAAC,OAAO,CAAW,EACzB,MAAM,CAAC,WAAW,CAAW,EAC7B,IAAI,CACL;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+/** The hardware facts the app injects. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerHardwareRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,14 @@
+/** The hardware facts the app injects. */
+import { readJsonBody, sendJson } from '../../http.js';
+export function registerHardwareRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    // The app measures the machine with NVML and Vulkan; the core cannot. Injection has to land
+    // before a backend is chosen, which is why the app sends it as soon as it attaches.
+    router.get(p('/hardware/override'), (_req, res) => sendJson(res, 200, { override: deps.hardware.get() ?? null }));
+    router.put(p('/hardware/override'), async (req, res) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, { override: deps.hardware.set(body) });
+    });
+    router.delete(p('/hardware/override'), (_req, res) => sendJson(res, 200, { cleared: deps.hardware.clear() }));
+}
+//# sourceMappingURL=hardware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../../src/server/control/routes/hardware.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAG1C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAItD,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,IAAuB,EACvB,GAAwB;IAExB,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAA;IAEjB,4FAA4F;IAC5F,oFAAoF;IACpF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAChD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAC9D,CAAA;IAED,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAwB,GAAG,CAAC,CAAA;QAC3D,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACnD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CACvD,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * The routes that describe and end the core itself: health, snapshot, the event stream and shutdown.
+ * Shutdown registers last, after every other family, so it lives in its own function.
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+/** `/health`, `/snapshot` and `/events`. */
+export declare function registerLifecycleRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;
+/** `/shutdown`. */
+export declare function registerShutdownRoute(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;
+/** One SSE frame; shared by the events route (replay, resync) and the server (live broadcast). */
+export declare function sseFrame(id: string, event: string, data: unknown): string;

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

@@ -0,0 +1,67 @@
+/**
+ * The routes that describe and end the core itself: health, snapshot, the event stream and shutdown.
+ * Shutdown registers last, after every other family, so it lives in its own function.
+ */
+import { AtomicCoreError, CONTROL_PROTOCOL_VERSION } from '../../../contracts/index.js';
+import { queryOf, readJsonBody, sendError, sendJson } from '../../http.js';
+/** `/health`, `/snapshot` and `/events`. */
+export function registerLifecycleRoutes(router, deps, ctx) {
+    const { p, now, startedAt, snapshot, self } = ctx;
+    router.get(p('/health'), (_req, res) => {
+        sendJson(res, 200, {
+            ok: true,
+            pid: process.pid,
+            version: deps.version,
+            owner_scope: deps.ownerScope,
+            instance_id: deps.instanceId,
+            protocol: CONTROL_PROTOCOL_VERSION,
+            dataFolder: deps.dataFolder,
+            uptime_ms: now() - startedAt,
+        });
+    });
+    router.get(p('/snapshot'), (_req, res) => sendJson(res, 200, snapshot()));
+    router.get(p('/events'), (req, res) => {
+        const cursor = queryOf(req).get('cursor') ?? req.headers['last-event-id'] ?? '';
+        res.writeHead(200, {
+            'content-type': 'text/event-stream; charset=utf-8',
+            'cache-control': 'no-store',
+            'connection': 'keep-alive',
+            'x-accel-buffering': 'no',
+        });
+        // Headers must reach the client before any event does: a reader that is waiting for the response
+        // would otherwise block until the first event, which may be minutes away.
+        res.flushHeaders();
+        const afterSeq = cursor ? deps.emitter.parseCursor(cursor) : deps.emitter.lastSeq;
+        const replay = afterSeq === undefined ? undefined : deps.emitter.replayAfter(afterSeq);
+        if (replay === undefined) {
+            // Cursor from another instance, or older than the ring: the client must take a fresh snapshot.
+            res.write(sseFrame(deps.emitter.cursor(), 'resync', { reason: cursor ? 'cursor-expired' : 'no-cursor' }));
+        }
+        else {
+            for (const record of replay)
+                res.write(sseFrame(deps.emitter.cursor(record.seq), record.name, record.payload));
+        }
+        self()?.attachSse(res);
+        req.on('close', () => res.end());
+    });
+}
+/** `/shutdown`. */
+export function registerShutdownRoute(router, deps, ctx) {
+    const { p } = ctx;
+    router.post(p('/shutdown'), async (req, res) => {
+        const body = await readJsonBody(req);
+        const others = deps.clients.acceptShutdown(body.client_id, body.force === true);
+        if (others.length > 0 && body.force !== true) {
+            return sendError(res, new AtomicCoreError('CORE_ALREADY_RUNNING', 'Other clients are still attached to this core.', others.map((c) => `${c.name}${c.pid ? ` (pid ${c.pid})` : ''}`).join(', ')));
+        }
+        sendJson(res, 200, { ok: true, stopping: true });
+        setTimeout(() => {
+            void deps.shutdown({ force: body.force === true, requestedBy: body.client_id });
+        }, 10).unref?.();
+    });
+}
+/** One SSE frame; shared by the events route (replay, resync) and the server (live broadcast). */
+export function sseFrame(id, event, data) {
+    return `id: ${id}\nevent: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Sessions and models: load, unload, recreate, context increase, capabilities, embeddings, GGUF
+ * validation, Foundation Models availability, and the devices a backend reports.
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerModelRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,59 @@
+/**
+ * Sessions and models: load, unload, recreate, context increase, capabilities, embeddings, GGUF
+ * validation, Foundation Models availability, and the devices a backend reports.
+ */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { queryOf, readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerModelRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/sessions'), (_req, res) => sendJson(res, 200, { sessions: deps.sessions() }));
+    // Registered ahead of `load`: a cancel is never queued behind the load it stops.
+    router.post(p('/models/:provider/*modelId/load/cancel'), (_req, res, { params }) => {
+        const cancelled = deps.cancelModelLoad(params['provider'], params['modelId']);
+        sendJson(res, 200, { cancelled });
+    });
+    router.post(p('/models/:provider/*modelId/load'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        const result = await deps.loadModel(params['provider'], params['modelId'], body);
+        sendJson(res, 200, 'session' in result ? result : { session: result, created: true });
+    });
+    router.post(p('/models/:provider/*modelId/unload'), async (_req, res, { params }) => {
+        const result = await deps.unloadModel(params['provider'], params['modelId']);
+        sendJson(res, 200, result);
+    });
+    router.post(p('/models/:provider/*modelId/recreate'), async (_req, res, { params }) => {
+        sendJson(res, 200, await deps.recreateSession(params['provider'], params['modelId']));
+    });
+    router.post(p('/models/:provider/*modelId/ctx/increase'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        const result = await deps.increaseCtx(params['provider'], params['modelId'], body.reason);
+        sendJson(res, 200, result);
+    });
+    router.get(p('/models/:provider/*modelId/capabilities'), async (_req, res, { params }) => {
+        sendJson(res, 200, await deps.models.capabilities(params['provider'], params['modelId']));
+    });
+    router.post(p('/models/:provider/*modelId/embed'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await deps.models.embed(params['provider'], params['modelId'], body.input, body.ubatch_size ?? 512));
+    });
+    // Answers `{isValid:false, error}` for a file that is not a model: the user pointed at it, and
+    // "that is not a model" is the answer to their question, not a failure of the core.
+    router.post(p('/gguf/validate'), async (req, res) => {
+        const body = await readJsonBody(req);
+        if (!body.path)
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'validate needs a path'));
+        sendJson(res, 200, await deps.models.validateGguf(body.path));
+    });
+    router.get(p('/runtimes/foundation-models/availability'), async (req, res) => {
+        const force = queryOf(req).get('force') === '1';
+        const status = deps.foundationModelsAvailability
+            ? await deps.foundationModelsAvailability(force)
+            : 'unavailable';
+        sendJson(res, 200, { status });
+    });
+    router.get(p('/hardware/devices'), async (req, res) => {
+        const provider = queryOf(req).get('provider') ?? 'llamacpp-upstream';
+        sendJson(res, 200, { devices: await deps.models.devices(provider) });
+    });
+}
+//# sourceMappingURL=models.js.map

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

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

package/dist/server/control/routes/public-server.d.ts

@@ -0,0 +1,4 @@
+/** The public `/v1` listener: status, start, stop, and the inspector toggle. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerPublicServerRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

package/dist/server/control/routes/public-server.js

@@ -0,0 +1,30 @@
+/** The public `/v1` listener: status, start, stop, and the inspector toggle. */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerPublicServerRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/server'), (_req, res) => sendJson(res, 200, deps.publicServer.status()));
+    router.post(p('/server/start'), async (req, res) => {
+        const body = await readJsonBody(req);
+        const state = await deps.publicServer.start({
+            ...(body.host !== undefined ? { host: body.host } : {}),
+            ...(body.port !== undefined ? { port: body.port } : {}),
+            ...(body.prefix !== undefined ? { prefix: body.prefix } : {}),
+            ...(body.api_key !== undefined ? { apiKey: body.api_key } : {}),
+            ...(body.trusted_hosts !== undefined ? { trustedHosts: body.trusted_hosts } : {}),
+            ...(body.proxy_timeout_secs !== undefined ? { proxyTimeoutSecs: body.proxy_timeout_secs } : {}),
+            ...(body.state_file !== undefined ? { writeStateFile: body.state_file === true } : {}),
+            ...(body.fallback_port !== undefined ? { fallbackPort: body.fallback_port === true } : {}),
+        });
+        sendJson(res, 200, state);
+    });
+    router.post(p('/server/stop'), async (_req, res) => sendJson(res, 200, await deps.publicServer.stop()));
+    router.put(p('/server/inspector'), async (req, res) => {
+        const body = await readJsonBody(req);
+        if (typeof body.enabled !== 'boolean')
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'inspector needs {"enabled": true|false}'));
+        deps.publicServer.setInspecting(body.enabled);
+        sendJson(res, 200, { enabled: body.enabled });
+    });
+}
+//# sourceMappingURL=public-server.js.map

package/dist/server/control/routes/public-server.js.map

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

package/dist/server/control/routes/remote-access.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Reaching the Local API Server from outside this machine: the Cloudflare quick tunnel, and what a
+ * LAN device can dial. The status is the app's camelCase payload, as the settings page renders it.
+ */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerRemoteAccessRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

package/dist/server/control/routes/remote-access.js

@@ -0,0 +1,16 @@
+/**
+ * Reaching the Local API Server from outside this machine: the Cloudflare quick tunnel, and what a
+ * LAN device can dial. The status is the app's camelCase payload, as the settings page renders it.
+ */
+import { sendJson } from '../../http.js';
+export function registerRemoteAccessRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/remote-access'), (_req, res) => sendJson(res, 200, deps.remoteAccess.status()));
+    // Answers `starting` at once; the URL arrives later as a `remote-access:status` event.
+    router.post(p('/remote-access/start'), (_req, res) => sendJson(res, 200, deps.remoteAccess.start()));
+    // Answers once the process is gone, which can take both grace periods when it ignores signals.
+    router.post(p('/remote-access/stop'), async (_req, res) => sendJson(res, 200, await deps.remoteAccess.stop()));
+    // Display only: the listener trusts the address each socket arrived on, not this list.
+    router.get(p('/lan-addresses'), async (_req, res) => sendJson(res, 200, { addresses: await deps.remoteAccess.lanAddresses() }));
+}
+//# sourceMappingURL=remote-access.js.map

package/dist/server/control/routes/remote-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-access.js","sourceRoot":"","sources":["../../../../src/server/control/routes/remote-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAIxC,MAAM,UAAU,0BAA0B,CACxC,MAAc,EACd,IAAuB,EACvB,GAAwB;IAExB,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAA;IAEjB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAE9F,uFAAuF;IACvF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAEpG,+FAA+F;IAC/F,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CACxD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CACnD,CAAA;IAED,uFAAuF;IACvF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAClD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC,CAC1E,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+/** Provider settings: status, read, patch, import from the app, acknowledge. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerSettingsRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,58 @@
+/** Provider settings: status, read, patch, import from the app, acknowledge. */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { LOCAL_PROVIDER_IDS } from '../../../settings/index.js';
+import { readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerSettingsRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    // Whether a provider's settings have been handed over, and whether the app has confirmed it saw
+    // the result. The migration flag must not be turned on for a scope that has not reached
+    // `migrated` — the core would load with its own defaults instead of the user's (PLAN.md §3.4).
+    router.get(p('/settings/status'), (_req, res) => {
+        const scopes = {};
+        for (const provider of LOCAL_PROVIDER_IDS) {
+            const migration = deps.settings.migration(provider);
+            scopes[provider] = {
+                migrated: migration?.legacy_hash != null,
+                acknowledged_revision: migration?.acknowledged_revision ?? null,
+                // True once the app has confirmed it mirrored everything the core currently holds; a
+                // planned rollback needs this before handing ownership back.
+                in_sync: migration?.acknowledged_revision != null &&
+                    migration.acknowledged_revision === deps.settings.revision(),
+            };
+        }
+        sendJson(res, 200, { revision: deps.settings.revision(), scopes });
+    });
+    router.get(p('/settings/:provider'), (_req, res, { params }) => {
+        const provider = params['provider'];
+        sendJson(res, 200, {
+            provider,
+            revision: deps.settings.revision(),
+            values: deps.settings.get(provider),
+            migration: deps.settings.migration(provider),
+        });
+    });
+    router.patch(p('/settings/:provider'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        const result = await deps.settings.update(params['provider'], body.values ?? {}, {
+            ...(typeof body.expected_revision === 'number' ? { expectedRevision: body.expected_revision } : {}),
+        });
+        sendJson(res, 200, result);
+    });
+    // Hand the app's own settings over (PLAN.md §3.4). Answers 409 on a conflict, because the caller
+    // has to put the choice to the user before this scope can be migrated at all.
+    router.post(p('/settings/:provider/import'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        const result = await deps.settings.importProvider(params['provider'], body.values ?? {}, {
+            ...(body.resolutions ? { resolutions: body.resolutions } : {}),
+            ...(typeof body.expected_revision === 'number' ? { expectedRevision: body.expected_revision } : {}),
+        });
+        sendJson(res, result.status === 'conflict' ? 409 : 200, result);
+    });
+    router.post(p('/settings/:scope/acknowledge'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        if (typeof body.revision !== 'number')
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'acknowledge needs the revision being confirmed'));
+        sendJson(res, 200, await deps.settings.acknowledge(params['scope'], body.revision));
+    });
+}
+//# sourceMappingURL=settings.js.map

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

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

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

@@ -0,0 +1,7 @@
+/** The app's error-reporting consent, anonymous user and hardware tags (`set_telemetry_*` in the app). */
+import type { TelemetryUpdateRequest } from '../../../contracts/index.js';
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+/** The body of `PUT /telemetry`, or a message saying what is wrong with it. */
+export declare function parseTelemetryUpdate(body: unknown): TelemetryUpdateRequest | string;
+export declare function registerTelemetryRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;