@atomic-chat/core 0.5.1

package/dist/runtime/shared/sidecar.js

@@ -0,0 +1,214 @@
+/**
+ * The session table of a sidecar runtime — MLX and Foundation Models: engines the core starts as
+ * one process per model and does not plan arguments for beyond a handful of flags.
+ *
+ * It holds what the llama.cpp runtime guarantees, in one place, so both sidecars keep it:
+ *  - one load at a time for the provider, and a second request for a model already loading joins it
+ *    (the MLX plugin's global load mutex; Foundation Models had none and could start two servers);
+ *  - every spawned process is journalled before it can be forgotten, so a crashed owner leaves a
+ *    trail the next owner can clean up and the app's reaper spares it;
+ *  - a session exists only while its process does. Neither plugin watched its process: a crashed
+ *    server stayed in the table until a chat request found the dead port. The table removes it on
+ *    exit and emits `session:died`, which the app already listens for per provider;
+ *  - a load the user cancels stops wherever it is — waiting for its turn, waiting on an unload,
+ *    joined to another load, or about to be published — and never lets the load behind it start
+ *    while the one ahead is still running.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { processStartId } from '../../lock/index.js';
+import { isLoadCancelled, raceLoadCancel, throwIfLoadCancelled } from './load-cancel.js';
+import { closeLogStream } from './log-stream.js';
+export class SidecarTable {
+    options;
+    sessions = new Map();
+    loading = new Map();
+    unloading = new Map();
+    loadTail = Promise.resolve();
+    closing = false;
+    shutdownController = new AbortController();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Aborts a process that is still starting when the owner shuts down. */
+    get signal() {
+        return this.shutdownController.signal;
+    }
+    get isClosing() {
+        return this.closing;
+    }
+    list() {
+        return [...this.sessions.values()].map((s) => ({ ...s.info }));
+    }
+    get(modelId) {
+        return this.sessions.get(modelId);
+    }
+    findSession(modelId) {
+        const session = this.sessions.get(modelId);
+        return session ? { ...session.info } : undefined;
+    }
+    getLoadedModels() {
+        return [...this.sessions.keys()];
+    }
+    isLoading(modelId) {
+        return this.loading.has(modelId);
+    }
+    /** Ports sessions already hold, so a new load never picks one of them. */
+    usedPorts() {
+        return [...this.sessions.values()].map((s) => s.info.port);
+    }
+    /** In-flight loads other than this model's, which an auto-unload must wait for. */
+    otherLoads(modelId) {
+        return [...this.loading].filter(([id]) => id !== modelId).map(([, load]) => load);
+    }
+    /**
+     * Load through the provider's single queue, or join the load already in flight for this model.
+     * An already-loaded model answers with its session without queueing. `signal` is the user's
+     * cancel: it ends the wait at once, wherever the load is waiting.
+     */
+    load(modelId, operation, signal) {
+        this.assertRunning();
+        const unloading = this.unloading.get(modelId);
+        if (unloading)
+            return raceLoadCancel(unloading, signal).then(() => this.load(modelId, operation, signal));
+        const existing = this.sessions.get(modelId);
+        if (existing)
+            return Promise.resolve({ ...existing.info });
+        const inFlight = this.loading.get(modelId);
+        if (inFlight)
+            return raceLoadCancel(inFlight, signal);
+        const turn = this.loadTail;
+        const run = raceLoadCancel(turn, signal).then(async () => {
+            this.assertRunning();
+            const loaded = this.sessions.get(modelId);
+            return loaded ? { ...loaded.info } : operation();
+        });
+        // The queue waits for the turn as well as the result: a load cancelled while queued settles
+        // early, and the one behind it must still not start before the load ahead has finished.
+        this.loadTail = Promise.all([
+            turn,
+            run.then(() => { }, () => { }),
+        ]).then(() => { });
+        const tracked = run.finally(() => this.loading.delete(modelId));
+        this.loading.set(modelId, tracked);
+        return tracked;
+    }
+    /**
+     * Record a process that reported ready, and start watching it. Terminates it if that fails — or
+     * if the user cancelled while it was coming up: a cancel that raced the ready signal still wins,
+     * so no session is published for it.
+     */
+    async adopt(session, signal) {
+        const entry = { ...session, journalled: false };
+        try {
+            throwIfLoadCancelled(signal);
+            await this.journal(entry);
+            this.assertRunning();
+            throwIfLoadCancelled(signal);
+            this.sessions.set(entry.info.model_id, entry);
+            this.watchExit(entry);
+        }
+        catch (error) {
+            await entry.process.terminate(isLoadCancelled(signal) ? 0 : this.options.unloadGraceMs).catch(() => { });
+            if (entry.journalled)
+                await this.options.journal?.remove(entry.info.pid).catch(() => { });
+            await closeLogStream(entry.logStream);
+            throw error;
+        }
+        this.options.emit('session:started', { ...entry.info, provider: this.options.provider });
+        return { ...entry.info };
+    }
+    async journal(session) {
+        const journal = this.options.journal;
+        if (!journal)
+            return;
+        const record = {
+            instance_id: this.options.instanceId,
+            pid: session.info.pid,
+            process_start_id: (await processStartId(session.info.pid)) ?? null,
+            exe: session.exe,
+            provider: this.options.provider,
+            model_id: session.info.model_id,
+            port: session.info.port,
+            started_at: new Date().toISOString(),
+        };
+        await journal.add(record);
+        session.journalled = true;
+    }
+    watchExit(session) {
+        void session.process.exited.then(async (exit) => {
+            if (this.sessions.get(session.info.model_id) !== session)
+                return; // unloaded or replaced
+            this.sessions.delete(session.info.model_id);
+            if (session.journalled)
+                await this.options.journal?.remove(session.info.pid).catch(() => { });
+            await closeLogStream(session.logStream);
+            const { stderr, stdout } = session.process.output();
+            this.options.emit('session:died', {
+                provider: this.options.provider,
+                pid: session.info.pid,
+                model_id: session.info.model_id,
+                exit_code: exit.code,
+                signal: exit.signal === null ? null : String(exit.signal),
+                message: this.options.describeExit(exit, stderr, stdout),
+            });
+        });
+    }
+    /** Stop one session. Unloading something that is not loaded is not an error. */
+    async unload(modelId, graceMs = this.options.unloadGraceMs) {
+        const existing = this.unloading.get(modelId);
+        if (existing)
+            return existing;
+        const operation = this.unloadAfterLoading(modelId, graceMs);
+        const tracked = operation.finally(() => {
+            if (this.unloading.get(modelId) === tracked)
+                this.unloading.delete(modelId);
+        });
+        this.unloading.set(modelId, tracked);
+        return tracked;
+    }
+    async unloadAfterLoading(modelId, graceMs) {
+        // A load may still be choosing a port or starting the child. Wait for its
+        // publication (or failure) before declaring the model absent.
+        await this.loading.get(modelId)?.catch(() => { });
+        const session = this.sessions.get(modelId);
+        if (!session)
+            return { success: true };
+        this.sessions.delete(modelId);
+        try {
+            await session.process.terminate(graceMs);
+            if (session.journalled)
+                await this.options.journal?.remove(session.info.pid).catch(() => { });
+            await closeLogStream(session.logStream);
+            this.options.emit('session:unloaded', {
+                provider: this.options.provider,
+                model_id: modelId,
+                pid: session.info.pid,
+            });
+            return { success: true };
+        }
+        catch (e) {
+            if (session.process.child.exitCode === null && session.process.child.signalCode === null)
+                this.sessions.set(modelId, session);
+            else if (session.journalled)
+                await this.options.journal?.remove(session.info.pid).catch(() => { });
+            return { success: false, error: e.message };
+        }
+    }
+    async shutdown() {
+        this.closing = true;
+        this.shutdownController.abort();
+        await this.loadTail;
+        // An earlier explicit unload may already have removed a session from the table while its
+        // process is still terminating. It must finish before shutdown releases the owner's claims.
+        await Promise.all([...this.unloading.values()]);
+        const results = await Promise.all([...this.sessions.keys()].map((id) => this.unload(id, this.options.shutdownGraceMs)));
+        const failure = results.find((result) => !result.success);
+        if (failure)
+            throw new AtomicCoreError('INTERNAL_ERROR', `Could not stop every ${this.options.engine} session during shutdown.`, failure.error);
+    }
+    assertRunning() {
+        if (this.closing)
+            throw new AtomicCoreError('CORE_NOT_RUNNING', `The ${this.options.engine} runtime is stopping or has stopped.`);
+    }
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/runtime/shared/sidecar.js.map

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

package/dist/server/clients.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Who is attached to this core. The app and the CLI register, heartbeat while they are up, and
+ * unregister on exit; the core keeps running either way (PLAN.md §3.6, "Client exit": "detach and heartbeat stop").
+ *
+ * The registry exists for one decision: `shutdown` must tell "nobody is using this core" from
+ * "somebody else is using it", and a client that vanished without unregistering must age out rather
+ * than block shutdown forever.
+ */
+export declare const CLIENT_HEARTBEAT_INTERVAL_MS = 15000;
+/** Three missed heartbeats: a client that stops reporting is gone, not merely busy. */
+export declare const CLIENT_EXPIRY_MS: number;
+export interface ClientRecord {
+    id: string;
+    name: string;
+    pid: number | null;
+    registered_at: number;
+    last_seen: number;
+}
+export interface RegisterClientInput {
+    name?: string;
+    pid?: number | null;
+}
+export declare class ClientRegistry {
+    private readonly now;
+    private readonly expiryMs;
+    private readonly clients;
+    private stopping;
+    constructor(now?: () => number, expiryMs?: number);
+    register(input?: RegisterClientInput): ClientRecord;
+    /** `false` when the id is unknown or already expired: the client must register again. */
+    heartbeat(id: string): boolean;
+    unregister(id: string): boolean;
+    list(): ClientRecord[];
+    count(): number;
+    /** Everyone but the caller — what `shutdown` checks before stopping a core someone else is using. */
+    others(exceptId: string | undefined): ClientRecord[];
+    /** Check leases and close admission in one synchronous step. */
+    acceptShutdown(exceptId: string | undefined, force: boolean): ClientRecord[];
+    private sweep;
+}

package/dist/server/clients.js

@@ -0,0 +1,74 @@
+/**
+ * Who is attached to this core. The app and the CLI register, heartbeat while they are up, and
+ * unregister on exit; the core keeps running either way (PLAN.md §3.6, "Client exit": "detach and heartbeat stop").
+ *
+ * The registry exists for one decision: `shutdown` must tell "nobody is using this core" from
+ * "somebody else is using it", and a client that vanished without unregistering must age out rather
+ * than block shutdown forever.
+ */
+import { randomUUID } from 'node:crypto';
+import { AtomicCoreError } from '../contracts/index.js';
+export const CLIENT_HEARTBEAT_INTERVAL_MS = 15_000;
+/** Three missed heartbeats: a client that stops reporting is gone, not merely busy. */
+export const CLIENT_EXPIRY_MS = 3 * CLIENT_HEARTBEAT_INTERVAL_MS;
+export class ClientRegistry {
+    now;
+    expiryMs;
+    clients = new Map();
+    stopping = false;
+    constructor(now = Date.now, expiryMs = CLIENT_EXPIRY_MS) {
+        this.now = now;
+        this.expiryMs = expiryMs;
+    }
+    register(input = {}) {
+        if (this.stopping)
+            throw new AtomicCoreError('CORE_NOT_RUNNING', 'This core is stopping; new clients cannot attach.');
+        const ts = this.now();
+        const record = {
+            id: randomUUID(),
+            name: (input.name ?? 'unnamed').slice(0, 200),
+            pid: typeof input.pid === 'number' ? input.pid : null,
+            registered_at: ts,
+            last_seen: ts,
+        };
+        this.clients.set(record.id, record);
+        return { ...record };
+    }
+    /** `false` when the id is unknown or already expired: the client must register again. */
+    heartbeat(id) {
+        this.sweep();
+        const record = this.clients.get(id);
+        if (!record)
+            return false;
+        record.last_seen = this.now();
+        return true;
+    }
+    unregister(id) {
+        return this.clients.delete(id);
+    }
+    list() {
+        this.sweep();
+        return [...this.clients.values()].map((c) => ({ ...c }));
+    }
+    count() {
+        return this.list().length;
+    }
+    /** Everyone but the caller — what `shutdown` checks before stopping a core someone else is using. */
+    others(exceptId) {
+        return this.list().filter((c) => c.id !== exceptId);
+    }
+    /** Check leases and close admission in one synchronous step. */
+    acceptShutdown(exceptId, force) {
+        const others = this.others(exceptId);
+        if (others.length === 0 || force)
+            this.stopping = true;
+        return others;
+    }
+    sweep() {
+        const cutoff = this.now() - this.expiryMs;
+        for (const [id, record] of this.clients)
+            if (record.last_seen < cutoff)
+                this.clients.delete(id);
+    }
+}
+//# sourceMappingURL=clients.js.map

package/dist/server/clients.js.map

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

package/dist/server/control/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The control API (`/atomic/v1/*`, PLAN.md §3.6): how the app and the CLI drive a core they did not
+ * start. It is deliberately not the inference API — it binds loopback only, always requires the
+ * control token, refuses non-loopback `Host` headers (the DNS-rebinding guard that lets a browser
+ * page talk to a local port), and sends no CORS headers at all.
+ *
+ * Stopping the public listener never touches this one: that separation is what keeps a core
+ * manageable while its `/v1` surface is down.
+ */
+export { ControlServer } from './server.js';
+export { SSE_HEARTBEAT_MS } from './types.js';
+export type { BackendControl, ChatGptControl, CloudControl, ControlServerDeps, ControlSnapshot, DiffusionControl, DiskControl, ExternalSessionControl, ModelControl, PublicServerControl, RemoteAccessControl, SessionSummary, SettingsControl, } from './types.js';

package/dist/server/control/index.js

@@ -0,0 +1,12 @@
+/**
+ * The control API (`/atomic/v1/*`, PLAN.md §3.6): how the app and the CLI drive a core they did not
+ * start. It is deliberately not the inference API — it binds loopback only, always requires the
+ * control token, refuses non-loopback `Host` headers (the DNS-rebinding guard that lets a browser
+ * page talk to a local port), and sends no CORS headers at all.
+ *
+ * Stopping the public listener never touches this one: that separation is what keeps a core
+ * manageable while its `/v1` surface is down.
+ */
+export { ControlServer } from './server.js';
+export { SSE_HEARTBEAT_MS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/server/control/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/control/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/server/control/router.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Composes the control route table from its families. Registration order is the matching order
+ * (`Router.find` takes the first pattern that fits, e.g. `/settings/status` before
+ * `/settings/:provider`), so the calls below must stay in this sequence.
+ */
+import { Router } from '../http.js';
+import type { ControlServer } from './server.js';
+import type { ControlServerDeps } from './types.js';
+export declare function buildRouter(deps: ControlServerDeps, self: () => ControlServer | undefined): Router;

package/dist/server/control/router.js

@@ -0,0 +1,61 @@
+/**
+ * Composes the control route table from its families. Registration order is the matching order
+ * (`Router.find` takes the first pattern that fits, e.g. `/settings/status` before
+ * `/settings/:provider`), so the calls below must stay in this sequence.
+ */
+import { CONTROL_API_PREFIX, CONTROL_PROTOCOL_VERSION } from '../../contracts/index.js';
+import { Router } from '../http.js';
+import { registerBackendRoutes } from './routes/backends.js';
+import { registerClientRoutes } from './routes/clients.js';
+import { registerCloudRoutes } from './routes/cloud.js';
+import { registerDiffusionRoutes } from './routes/diffusion.js';
+import { registerDiffusionVideoRoutes } from './routes/diffusion-video.js';
+import { registerDiskRoutes } from './routes/disk.js';
+import { registerExternalSessionRoutes } from './routes/external-sessions.js';
+import { registerHardwareRoutes } from './routes/hardware.js';
+import { registerLifecycleRoutes, registerShutdownRoute } from './routes/lifecycle.js';
+import { registerModelRoutes } from './routes/models.js';
+import { registerPublicServerRoutes } from './routes/public-server.js';
+import { registerRemoteAccessRoutes } from './routes/remote-access.js';
+import { registerSettingsRoutes } from './routes/settings.js';
+import { registerTelemetryRoutes } from './routes/telemetry.js';
+export function buildRouter(deps, self) {
+    const now = deps.now ?? Date.now;
+    const startedAt = deps.startedAt ?? now();
+    const p = (suffix) => `${CONTROL_API_PREFIX}${suffix}`;
+    const snapshot = () => ({
+        instance_id: deps.instanceId,
+        owner_scope: deps.ownerScope,
+        protocol: CONTROL_PROTOCOL_VERSION,
+        version: deps.version,
+        pid: process.pid,
+        data_folder: deps.dataFolder,
+        started_at: startedAt,
+        uptime_ms: now() - startedAt,
+        cursor: deps.emitter.cursor(),
+        sessions: deps.sessions(),
+        server: deps.publicServer.status(),
+        clients: deps.clients.list(),
+        downloads: [],
+        optimal_backends: deps.backends.optimalSnapshot(),
+    });
+    const ctx = { p, now, startedAt, snapshot, self };
+    const router = new Router();
+    registerLifecycleRoutes(router, deps, ctx);
+    registerClientRoutes(router, deps, ctx);
+    registerModelRoutes(router, deps, ctx);
+    registerBackendRoutes(router, deps, ctx);
+    registerHardwareRoutes(router, deps, ctx);
+    registerDiskRoutes(router, deps, ctx);
+    registerSettingsRoutes(router, deps, ctx);
+    registerExternalSessionRoutes(router, deps, ctx);
+    registerCloudRoutes(router, deps, ctx);
+    registerPublicServerRoutes(router, deps, ctx);
+    registerRemoteAccessRoutes(router, deps, ctx);
+    registerDiffusionRoutes(router, deps, ctx);
+    registerDiffusionVideoRoutes(router, deps, ctx);
+    registerTelemetryRoutes(router, deps, ctx);
+    registerShutdownRoute(router, deps, ctx);
+    return router;
+}
+//# sourceMappingURL=router.js.map

package/dist/server/control/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/server/control/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAI/D,MAAM,UAAU,WAAW,CAAC,IAAuB,EAAE,IAAqC;IACxF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,CAAA;IACzC,MAAM,CAAC,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,GAAG,kBAAkB,GAAG,MAAM,EAAE,CAAA;IAC9D,MAAM,QAAQ,GAAG,GAAoB,EAAE,CAAC,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,QAAQ,EAAE,wBAAwB;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,GAAG,EAAE,GAAG,SAAS;QAC5B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5B,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE;KAClD,CAAC,CAAA;IACF,MAAM,GAAG,GAAwB,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAEtE,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;IAE3B,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACvC,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACtC,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACxC,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACzC,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACrC,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACzC,6BAA6B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAChD,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IACtC,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC7C,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC7C,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,4BAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/C,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1C,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAExC,OAAO,MAAM,CAAA;AACf,CAAC"}

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

@@ -0,0 +1,4 @@
+/** llama.cpp backend packs and the download tasks that install them. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerBackendRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,47 @@
+/** llama.cpp backend packs and the download tasks that install them. */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { queryOf, readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerBackendRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/backends/:provider'), async (req, res, { params }) => {
+        const current = queryOf(req).get('current') ?? '';
+        sendJson(res, 200, {
+            backends: await deps.backends.list(params['provider'], current),
+        });
+    });
+    // The task id comes from the caller, because the app's progress bar listens on an event named
+    // after it. A core-invented id would leave that bar stranded.
+    router.post(p('/backends/:provider/install'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        if (!body.version || !body.backend || !body.task_id)
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'install needs version, backend and task_id'));
+        sendJson(res, 200, await deps.backends.install(params['provider'], body.version, body.backend, {
+            taskId: body.task_id,
+            ...(body.force !== undefined ? { force: body.force } : {}),
+            ...(body.proxy !== undefined ? { proxy: body.proxy } : {}),
+            ...(typeof body.asset_name === 'string' && body.asset_name ? { assetName: body.asset_name } : {}),
+        }));
+    });
+    // Where the detection result lives now. The CLI could not see the webview's `localStorage`;
+    // this route gives both clients one revisioned answer. Hardware-change invalidation is separate.
+    router.get(p('/backends/:provider/optimal'), async (_req, res, { params }) => {
+        sendJson(res, 200, await deps.backends.getOptimal(params['provider']));
+    });
+    router.put(p('/backends/:provider/optimal'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        if (!Object.hasOwn(body, 'optimal') || body.expected_revision === undefined) {
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'optimal and expected_revision are required'));
+        }
+        const result = await deps.backends.setOptimal(params['provider'], body.optimal ?? null, body.expected_revision);
+        sendJson(res, result.status === 'conflict' ? 409 : 200, result);
+    });
+    router.post(p('/downloads/*taskId/cancel'), (_req, res, { params }) => {
+        sendJson(res, 200, { cancelled: deps.backends.cancel(params['taskId']) });
+    });
+    router.delete(p('/backends/:provider/:version/:backend'), async (_req, res, { params }) => {
+        sendJson(res, 200, {
+            removed: await deps.backends.remove(params['provider'], params['version'], params['backend']),
+        });
+    });
+}
+//# sourceMappingURL=backends.js.map

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

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

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

@@ -0,0 +1,4 @@
+/** Client registration: attach with a snapshot, heartbeat, detach. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerClientRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,30 @@
+/** Client registration: attach with a snapshot, heartbeat, detach. */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { CLIENT_HEARTBEAT_INTERVAL_MS } from '../../clients.js';
+import { readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerClientRoutes(router, deps, ctx) {
+    const { p, snapshot } = ctx;
+    router.post(p('/clients'), async (req, res) => {
+        const body = await readJsonBody(req);
+        const client = deps.clients.register({
+            ...(body.name !== undefined ? { name: body.name } : {}),
+            ...(body.pid !== undefined ? { pid: body.pid } : {}),
+        });
+        sendJson(res, 201, {
+            client,
+            heartbeat_interval_ms: CLIENT_HEARTBEAT_INTERVAL_MS,
+            snapshot: snapshot(),
+        });
+    });
+    router.post(p('/clients/:id/heartbeat'), (_req, res, { params }) => {
+        const ok = deps.clients.heartbeat(params['id']);
+        if (!ok)
+            return sendError(res, new AtomicCoreError('CORE_NOT_RUNNING', 'This client registration has expired; register again.'), 410);
+        sendJson(res, 200, { ok: true });
+    });
+    router.delete(p('/clients/:id'), (_req, res, { params }) => {
+        deps.clients.unregister(params['id']);
+        sendJson(res, 200, { ok: true });
+    });
+}
+//# sourceMappingURL=clients.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../../src/server/control/routes/clients.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAIjE,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,IAAuB,EACvB,GAAwB;IAExB,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAA;IAE3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAkC,GAAG,CAAC,CAAA;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAA;QACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,MAAM;YACN,qBAAqB,EAAE,4BAA4B;YACnD,QAAQ,EAAE,QAAQ,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACjE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC,CAAA;QACzD,IAAI,CAAC,EAAE;YACL,OAAO,SAAS,CACd,GAAG,EACH,IAAI,eAAe,CAAC,kBAAkB,EAAE,uDAAuD,CAAC,EAChG,GAAG,CACJ,CAAA;QACH,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC,CAAA;QAC/C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+/** Cloud providers and the ChatGPT subscription sign-in. */
+import type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+export declare function registerCloudRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;

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

@@ -0,0 +1,32 @@
+/** Cloud providers and the ChatGPT subscription sign-in. */
+import { AtomicCoreError } from '../../../contracts/index.js';
+import { readJsonBody, sendError, sendJson } from '../../http.js';
+export function registerCloudRoutes(router, deps, ctx) {
+    const { p } = ctx;
+    router.get(p('/cloud/providers'), (_req, res) => sendJson(res, 200, { providers: deps.cloud.list() }));
+    router.put(p('/cloud/providers/:provider'), async (req, res, { params }) => {
+        const body = await readJsonBody(req);
+        sendJson(res, 200, await deps.cloud.upsert({ ...body, provider: params['provider'] }));
+    });
+    router.delete(p('/cloud/providers/:provider'), async (_req, res, { params }) => {
+        await deps.cloud.remove(params['provider']);
+        sendJson(res, 200, { removed: true });
+    });
+    router.get(p('/auth/chatgpt'), async (_req, res) => sendJson(res, 200, await deps.chatgpt.status()));
+    router.post(p('/auth/chatgpt/reload'), async (_req, res) => {
+        if (!deps.chatgpt.reload)
+            return sendError(res, new AtomicCoreError('INVALID_ARGUMENT', 'reload is unavailable'));
+        sendJson(res, 200, await deps.chatgpt.reload());
+    });
+    // Sign-in is two calls because the core cannot open a browser: this one binds the callback
+    // listener on :1455 and says where to send the user, `/login/wait` resolves when they are back.
+    router.post(p('/auth/chatgpt/login'), async (_req, res) => sendJson(res, 200, await deps.chatgpt.startLogin()));
+    router.post(p('/auth/chatgpt/login/wait'), async (_req, res) => sendJson(res, 200, await deps.chatgpt.waitLogin()));
+    router.post(p('/auth/chatgpt/login/cancel'), (_req, res) => {
+        deps.chatgpt.cancelLogin();
+        sendJson(res, 200, { cancelled: true });
+    });
+    router.post(p('/auth/chatgpt/logout'), async (_req, res) => sendJson(res, 200, await deps.chatgpt.logout()));
+    router.get(p('/auth/chatgpt/models'), async (_req, res) => sendJson(res, 200, { models: await deps.chatgpt.models() }));
+}
+//# sourceMappingURL=cloud.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * 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 type { Router } from '../../http.js';
+import type { ControlRouteContext, ControlServerDeps } from '../types.js';
+/** A poster is a small PNG as base64; the JSON around it is nothing. */
+export declare const MAX_POSTER_BODY_BYTES: number;
+export declare function registerDiffusionVideoRoutes(router: Router, deps: ControlServerDeps, ctx: ControlRouteContext): void;