@atomic-chat/core 0.20.5 → 0.20.7

package/dist/audio/session.js

@@ -0,0 +1,228 @@
+/**
+ * Session lifecycle: bringing `audiocpp_server` up from a spec, tearing it down, and describing the
+ * result as the status the client reads. Every state change here emits `audio:state`. The shape of
+ * image generation's `session.ts`, without its offload and CPU fallbacks.
+ */
+import { samePath } from '../diffusion/index.js';
+import { audioError, audioErrorBody, toAudioError } from './errors.js';
+import { listInstalledAudioBuilds } from './install.js';
+/** CUDA needs a moment after another engine's process dies before the driver reports the VRAM as free. */
+export const GPU_SETTLE_MS = 500;
+/** Owner exit: a short grace, then the kill. */
+export const SHUTDOWN_GRACE_MS = 2_000;
+export function modelNotLoadedError() {
+    return audioError('MODEL_NOT_LOADED', 'No audio model is loaded. Load one first.');
+}
+/** Which GPUs an `audiocpp_server` holds: every card on a device backend, none on the CPU backend. */
+export function audioGpuCards(spec) {
+    return spec.backend === 'cpu' ? [] : 'all';
+}
+/** The install the status reports: the resident spec's tree when there is one, otherwise the newest. */
+export async function currentAudioInstall(deps) {
+    const records = await listInstalledAudioBuilds(deps.state.paths.backendsDir, deps.platform);
+    let chosen = records[0];
+    const spec = deps.state.spec;
+    if (spec)
+        for (const record of records)
+            if (await samePath(record.dir, spec.binaryDir, deps.platform)) {
+                chosen = record;
+                break;
+            }
+    if (!chosen)
+        return { state: 'not-installed' };
+    return {
+        state: 'installed',
+        backend: chosen.backend,
+        tag: chosen.tag,
+        backendId: chosen.backendId,
+        dir: chosen.dir,
+    };
+}
+/** Snapshot for `status` and the `state` event. */
+export async function buildAudioStatus(deps) {
+    const { state } = deps;
+    const model = {
+        state: state.modelState,
+        loaded: state.modelState === 'loaded' && state.session ? { ...state.session.info } : null,
+    };
+    if (state.modelError)
+        model.error = state.modelError;
+    return {
+        install: await currentAudioInstall(deps),
+        model,
+        activeJob: state.activeJob(),
+        outputDir: state.outputDir(),
+        idleUnloadSecs: state.idleUnloadSecs,
+    };
+}
+export async function emitAudioState(deps, reason) {
+    deps.emit('audio:state', { status: await buildAudioStatus(deps), reason });
+}
+export function emitAudioError(deps, jobId, error) {
+    const payload = { code: error.code, message: error.message };
+    if (jobId !== undefined)
+        payload.jobId = jobId;
+    if (error.details !== undefined)
+        payload.details = error.details;
+    deps.emit('audio:error', payload);
+}
+/** What the loaded model takes, as its server declared it when it last came up. */
+export function audioCapabilities(state) {
+    if (!state.spec || !state.capabilities)
+        throw modelNotLoadedError();
+    return structuredClone(state.capabilities);
+}
+/**
+ * A load failure everywhere it is seen: the model state, the `state` event and the `error` event. A
+ * load that `signal` stopped (an unload, a shutdown, a cancelled job's respawn) is no failure: the
+ * model is `unloaded` and the error is `CANCELLED`, with no `error` event.
+ */
+export async function failLoad(deps, raw, reason, signal) {
+    if (signal?.aborted) {
+        deps.state.setModelState('unloaded');
+        await emitAudioState(deps, 'load-cancelled');
+        throw audioError('CANCELLED', 'The audio model load was stopped.');
+    }
+    const error = toAudioError(raw);
+    const body = audioErrorBody(error);
+    deps.state.setModelState('failed', body);
+    await emitAudioState(deps, reason);
+    emitAudioError(deps, undefined, body);
+    throw error;
+}
+/**
+ * Spawn the server for `spec` and make it the resident session. The caller holds the load lock, and
+ * any previous session is already gone — or still exiting after a cancel or a crash outside the lock,
+ * which is awaited before the claim and the spawn so two servers of this module never share the GPU.
+ */
+export async function loadFromSpec(deps, spec, reason, signal) {
+    const { state } = deps;
+    state.modelGeneration += 1;
+    state.setModelState('loading');
+    await emitAudioState(deps, reason);
+    let server;
+    try {
+        // `done` never rejects: an unconfirmed exit puts the server back as the session instead.
+        await state.stopping?.done;
+        // From the moment the claim is granted this server holds the GPU as starting.
+        const hold = () => {
+            state.starting = spec;
+        };
+        if (deps.claimGpu)
+            await deps.claimGpu(spec, signal, hold);
+        hold();
+        if (spec.backend === 'cuda')
+            await deps.sleep(GPU_SETTLE_MS);
+        server = await deps.spawn(spec, signal);
+    }
+    catch (raw) {
+        return failLoad(deps, raw, 'load-failed', signal);
+    }
+    finally {
+        state.starting = undefined;
+    }
+    const info = {
+        modelId: spec.modelId,
+        displayName: spec.displayName,
+        mode: spec.mode,
+        family: spec.family,
+        task: spec.task,
+        backend: spec.backend,
+        tag: spec.tag,
+        backendId: spec.backendId,
+        port: server.port,
+        pid: server.pid,
+        loadedAtMs: deps.now(),
+    };
+    state.session = { server, info, spec, baseUrl: `http://127.0.0.1:${server.port}` };
+    state.spec = spec;
+    state.capabilities = server.capabilities;
+    state.setModelState('loaded');
+    state.touchIdle();
+    await emitAudioState(deps, 'loaded');
+    return { ...info };
+}
+/**
+ * Take the session out of the state and terminate it. Whether one was running. Touches neither the
+ * spec nor the model state: callers decide what the teardown means.
+ */
+export async function takeDownSession(deps, graceMs) {
+    const { state } = deps;
+    // Another caller may already be stopping this server outside the load lock (a cancel or crash).
+    while (state.stopping)
+        await state.stopping.done;
+    const session = state.session;
+    if (!session)
+        return false;
+    state.session = undefined;
+    // Still on the GPU until its exit is confirmed: GPU residency sees it as stopping until then.
+    const stopping = { spec: session.spec, done: Promise.resolve() };
+    state.stopping = stopping;
+    const exit = Promise.resolve().then(async () => {
+        try {
+            await session.server.terminate(graceMs);
+            await deps.onServerGone?.(session.server.pid);
+        }
+        catch (error) {
+            // Not confirmed: a server that may still be running stays the session, never forgotten.
+            if (session.server.exitStatus() === undefined && state.session === undefined)
+                state.session = session;
+            throw error;
+        }
+        finally {
+            if (state.stopping === stopping)
+                state.stopping = undefined;
+        }
+    });
+    stopping.done = exit.catch(() => undefined);
+    await exit;
+    return true;
+}
+/** Explicit unload: stop the server, forget the spec, report `unloaded`. */
+export async function unloadSession(deps, reason) {
+    const { state } = deps;
+    state.modelGeneration += 1;
+    if (state.modelState === 'loaded') {
+        state.setModelState('unloading');
+        await emitAudioState(deps, reason);
+    }
+    await takeDownSession(deps);
+    state.spec = undefined;
+    state.capabilities = undefined;
+    state.clearIdle();
+    state.setModelState('unloaded');
+    await emitAudioState(deps, reason);
+}
+/**
+ * A new engine build is active: a resident server, or a spec kept after a cancel or a crash, that
+ * runs from another tree is unloaded, so no job respawns the old binary. The caller holds the load
+ * lock and has cancelled any running job.
+ */
+export async function activateAudioInstall(deps, record) {
+    const spec = deps.state.spec;
+    if (!spec)
+        return;
+    if (spec.tag === record.tag && (await samePath(spec.binaryDir, record.dir, deps.platform)))
+        return;
+    await unloadSession(deps, 'engine-updated');
+}
+/** The server was stopped but the spec stays: the next job respawns it. */
+export async function stopKeepingSpec(deps, reason, error) {
+    const { state } = deps;
+    const generation = state.modelGeneration;
+    await takeDownSession(deps);
+    // A new load/unload owns the state now; this teardown only stopped its original server.
+    if (state.closing || state.modelGeneration !== generation)
+        return;
+    state.clearIdle();
+    if (error)
+        state.setModelState('failed', error);
+    else
+        state.setModelState('unloaded');
+    await emitAudioState(deps, reason);
+}
+/** Owner exit: no events, no waiting beyond a short grace. */
+export async function shutdownAudioSession(deps) {
+    await takeDownSession(deps, SHUTDOWN_GRACE_MS);
+}
+//# sourceMappingURL=session.js.map

package/dist/audio/session.js.map

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

package/dist/audio/state.d.ts

@@ -0,0 +1,70 @@
+/**
+ * What the audio module remembers between calls: one resident server at most, the spec that can bring
+ * it back, the model's state as the client sees it, a bounded job history and the idle deadline.
+ * Plain data behind small methods; the locks live with the code that holds them.
+ */
+import type { AudioPaths } from '../config/index.js';
+import type { AudioCapabilities, AudioErrorBody, AudioJob, AudioJobState, AudioModelState, LoadedAudioModel } from '../contracts/index.js';
+import type { AudioServerHandle, AudioServerSpec } from './types.js';
+export interface AudioSession {
+    server: AudioServerHandle;
+    info: LoadedAudioModel;
+    spec: AudioServerSpec;
+    baseUrl: string;
+}
+export interface AudioJobRecord {
+    job: AudioJob;
+    cancel: {
+        requested: boolean;
+        /** Aborts the job's request to the engine, or its wait for the server to come back. */
+        abort: AbortController;
+    };
+    /** Settles when the runner is done with the job. */
+    done?: Promise<unknown>;
+}
+/** Jobs kept in memory for `getJob`; the gallery is the durable record. */
+export declare const JOB_HISTORY = 50;
+export declare const isTerminalAudioJobState: (state: AudioJobState) => boolean;
+export declare class AudioState {
+    readonly paths: AudioPaths;
+    private readonly now;
+    /** `null` restores the default folder. */
+    outputDirOverride: string | null;
+    idleUnloadSecs: number;
+    session: AudioSession | undefined;
+    /** The last spec that loaded; the respawn source after a cancel or a crash. Cleared only by an unload. */
+    spec: AudioServerSpec | undefined;
+    /** What the server declared for `spec` when it last came up; cleared with it. */
+    capabilities: AudioCapabilities | undefined;
+    /** A server whose GPU claim succeeded and that is starting: it holds the GPU before it is a session. */
+    starting: AudioServerSpec | undefined;
+    /** A teardown in flight, through child exit and journal removal; the next load waits for it. */
+    stopping: {
+        spec: AudioServerSpec;
+        done: Promise<void>;
+    } | undefined;
+    modelState: AudioModelState;
+    modelError: AudioErrorBody | undefined;
+    /** A load or unload supersedes the state changes of an older asynchronous teardown. */
+    modelGeneration: number;
+    activeJobId: string | undefined;
+    /** Set while the owner shuts down: nothing starts any more. */
+    closing: boolean;
+    private readonly jobs;
+    private readonly jobOrder;
+    private idleDeadline;
+    constructor(paths: AudioPaths, now?: () => number);
+    outputDir(): string;
+    setModelState(state: AudioModelState, error?: AudioErrorBody): void;
+    /** Reset the idle-unload deadline; 0 seconds means never. */
+    touchIdle(): void;
+    clearIdle(): void;
+    idleExpired(): boolean;
+    /** A job's copy. */
+    job(id: string): AudioJob | undefined;
+    record(id: string): AudioJobRecord | undefined;
+    /** The active job while it is not over, for the status. */
+    activeJob(): AudioJob | null;
+    insertJob(record: AudioJobRecord): void;
+    updateJob(id: string, update: (job: AudioJob) => void): AudioJob | undefined;
+}

package/dist/audio/state.js

@@ -0,0 +1,90 @@
+/**
+ * What the audio module remembers between calls: one resident server at most, the spec that can bring
+ * it back, the model's state as the client sees it, a bounded job history and the idle deadline.
+ * Plain data behind small methods; the locks live with the code that holds them.
+ */
+import { DEFAULT_IDLE_UNLOAD_SECS } from './types.js';
+/** Jobs kept in memory for `getJob`; the gallery is the durable record. */
+export const JOB_HISTORY = 50;
+const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
+export const isTerminalAudioJobState = (state) => TERMINAL.has(state);
+export class AudioState {
+    paths;
+    now;
+    /** `null` restores the default folder. */
+    outputDirOverride = null;
+    idleUnloadSecs = DEFAULT_IDLE_UNLOAD_SECS;
+    session;
+    /** The last spec that loaded; the respawn source after a cancel or a crash. Cleared only by an unload. */
+    spec;
+    /** What the server declared for `spec` when it last came up; cleared with it. */
+    capabilities;
+    /** A server whose GPU claim succeeded and that is starting: it holds the GPU before it is a session. */
+    starting;
+    /** A teardown in flight, through child exit and journal removal; the next load waits for it. */
+    stopping;
+    modelState = 'unloaded';
+    modelError;
+    /** A load or unload supersedes the state changes of an older asynchronous teardown. */
+    modelGeneration = 0;
+    activeJobId;
+    /** Set while the owner shuts down: nothing starts any more. */
+    closing = false;
+    jobs = new Map();
+    jobOrder = [];
+    idleDeadline;
+    constructor(paths, now = Date.now) {
+        this.paths = paths;
+        this.now = now;
+    }
+    outputDir() {
+        const chosen = this.outputDirOverride?.trim();
+        return chosen ? chosen : this.paths.defaultOutputDir;
+    }
+    setModelState(state, error) {
+        this.modelState = state;
+        this.modelError = error;
+    }
+    /** Reset the idle-unload deadline; 0 seconds means never. */
+    touchIdle() {
+        this.idleDeadline = this.idleUnloadSecs === 0 ? undefined : this.now() + this.idleUnloadSecs * 1000;
+    }
+    clearIdle() {
+        this.idleDeadline = undefined;
+    }
+    idleExpired() {
+        return this.idleDeadline !== undefined && this.now() >= this.idleDeadline;
+    }
+    /** A job's copy. */
+    job(id) {
+        const record = this.jobs.get(id);
+        return record ? structuredClone(record.job) : undefined;
+    }
+    record(id) {
+        return this.jobs.get(id);
+    }
+    /** The active job while it is not over, for the status. */
+    activeJob() {
+        if (this.activeJobId === undefined)
+            return null;
+        const job = this.job(this.activeJobId);
+        return job && !isTerminalAudioJobState(job.state) ? job : null;
+    }
+    insertJob(record) {
+        this.jobOrder.push(record.job.id);
+        while (this.jobOrder.length > JOB_HISTORY) {
+            const old = this.jobOrder.shift();
+            if (old !== undefined)
+                this.jobs.delete(old);
+        }
+        this.jobs.set(record.job.id, record);
+    }
+    updateJob(id, update) {
+        const record = this.jobs.get(id);
+        if (!record)
+            return undefined;
+        update(record.job);
+        return structuredClone(record.job);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/audio/state.js.map

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

package/dist/audio/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * What the audio module keeps for itself; nothing here crosses the wire as such.
+ */
+import type { AudioBackend, AudioCapabilities, AudioMode, AudioOptions, AudioTask } from '../contracts/index.js';
+import type { ExitInfo } from '../runtime/llamacpp/index.js';
+/**
+ * Everything needed to (re)spawn `audiocpp_server` for one model. Kept after a cancel or a crash took
+ * the process down, so the next job brings it back without the client repeating the load; cleared
+ * only by an unload.
+ */
+export interface AudioServerSpec {
+    /** Directory holding `audiocpp_server`; also the child's working directory. */
+    binaryDir: string;
+    /** What `--backend` says: the build's backend, or `cpu` when `ATOMIC_AUDIO_BACKEND=cpu` forces it. */
+    backend: AudioBackend;
+    /** The backend the build was made for. */
+    buildBackend: AudioBackend;
+    backendId: string;
+    tag: string;
+    modelId: string;
+    displayName: string;
+    mode: AudioMode;
+    family: string;
+    task: AudioTask;
+    /** The model file or package directory, absolute. */
+    modelPath: string;
+    loadOptions?: AudioOptions;
+    sessionOptions?: AudioOptions;
+    defaultRequestOptions?: AudioOptions;
+    defaultVoice?: string;
+    threads?: number;
+    startupTimeoutMs: number;
+}
+/** A running `audiocpp_server`, as the session and the job runner see it; the real one wraps a child process. */
+export interface AudioServerHandle {
+    pid: number;
+    port: number;
+    exe: string;
+    /** What the server declared about the model once it was ready. */
+    capabilities: AudioCapabilities;
+    /** The last lines the server printed, oldest first. */
+    tail(): string[];
+    /** Non-blocking liveness: the exit, once it has happened. */
+    exitStatus(): ExitInfo | undefined;
+    exited: Promise<ExitInfo>;
+    /** SIGTERM, a grace period, then SIGKILL; resolves once the exit is confirmed. */
+    terminate(graceMs?: number): Promise<ExitInfo>;
+}
+export declare const DEFAULT_STARTUP_TIMEOUT_SECS = 600;
+export declare const DEFAULT_IDLE_UNLOAD_SECS = 600;
+/** A reference voice larger than this is refused before it reaches the engine. */
+export declare const MAX_VOICE_REF_BYTES: number;

package/dist/audio/types.js

@@ -0,0 +1,8 @@
+/**
+ * What the audio module keeps for itself; nothing here crosses the wire as such.
+ */
+export const DEFAULT_STARTUP_TIMEOUT_SECS = 600;
+export const DEFAULT_IDLE_UNLOAD_SECS = 600;
+/** A reference voice larger than this is refused before it reaches the engine. */
+export const MAX_VOICE_REF_BYTES = 5 * 1024 * 1024;
+//# sourceMappingURL=types.js.map

package/dist/audio/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audio/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwDH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAA;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAC3C,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA"}

package/dist/audio/wav.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The only structural check the core makes on a clip: a RIFF/WAVE header with a `fmt ` chunk and a
+ * `data` chunk, read for the sample rate, the channels and the length. Pure.
+ */
+export interface WavInfo {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    /** Bytes of sample data. */
+    dataBytes: number;
+    /** Length of the clip, rounded to the millisecond. */
+    audioMs: number;
+}
+/** The payload of a base64 string that may carry a data-URL prefix. */
+export declare function stripAudioDataUrl(value: string): string;
+/**
+ * The header of a WAV, from the whole file or from its first bytes. `fileSize` is the size on disk
+ * when only the start was read: a `data` chunk that runs to the end of the file (a streamed WAV says
+ * `0xFFFFFFFF`, or the read stopped short) is measured from it. `undefined` when the bytes are not a
+ * PCM-style WAV.
+ */
+export declare function parseWav(bytes: Buffer, fileSize?: number): WavInfo | undefined;

package/dist/audio/wav.js

@@ -0,0 +1,56 @@
+/**
+ * The only structural check the core makes on a clip: a RIFF/WAVE header with a `fmt ` chunk and a
+ * `data` chunk, read for the sample rate, the channels and the length. Pure.
+ */
+/** `data:audio/wav;base64,` and friends, ahead of a base64 payload. */
+const DATA_URL_PREFIX = /^data:[^,]*;base64,/i;
+/** The payload of a base64 string that may carry a data-URL prefix. */
+export function stripAudioDataUrl(value) {
+    return value.trim().replace(DATA_URL_PREFIX, '');
+}
+/**
+ * The header of a WAV, from the whole file or from its first bytes. `fileSize` is the size on disk
+ * when only the start was read: a `data` chunk that runs to the end of the file (a streamed WAV says
+ * `0xFFFFFFFF`, or the read stopped short) is measured from it. `undefined` when the bytes are not a
+ * PCM-style WAV.
+ */
+export function parseWav(bytes, fileSize = bytes.length) {
+    if (bytes.length < 12)
+        return undefined;
+    if (bytes.toString('latin1', 0, 4) !== 'RIFF' || bytes.toString('latin1', 8, 12) !== 'WAVE')
+        return undefined;
+    let at = 12;
+    let format;
+    while (at + 8 <= bytes.length) {
+        const id = bytes.toString('latin1', at, at + 4);
+        const size = bytes.readUInt32LE(at + 4);
+        const body = at + 8;
+        if (id === 'fmt ') {
+            if (size < 16 || body + 16 > bytes.length)
+                return undefined;
+            format = {
+                channels: bytes.readUInt16LE(body + 2),
+                sampleRate: bytes.readUInt32LE(body + 4),
+                byteRate: bytes.readUInt32LE(body + 8),
+                bitsPerSample: bytes.readUInt16LE(body + 14),
+            };
+        }
+        else if (id === 'data') {
+            if (!format || format.channels === 0 || format.sampleRate === 0 || format.byteRate === 0)
+                return undefined;
+            const available = Math.max(fileSize - body, 0);
+            const dataBytes = size === 0xffff_ffff || size > available ? available : size;
+            return {
+                sampleRate: format.sampleRate,
+                channels: format.channels,
+                bitsPerSample: format.bitsPerSample,
+                dataBytes,
+                audioMs: Math.round((dataBytes / format.byteRate) * 1000),
+            };
+        }
+        // Chunks are word-aligned: an odd size is followed by a pad byte.
+        at = body + size + (size % 2);
+    }
+    return undefined;
+}
+//# sourceMappingURL=wav.js.map

package/dist/audio/wav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.js","sourceRoot":"","sources":["../../src/audio/wav.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,uEAAuE;AACvE,MAAM,eAAe,GAAG,sBAAsB,CAAA;AAE9C,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM;IAC7D,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,SAAS,CAAA;IACvC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM;QACzF,OAAO,SAAS,CAAA;IAClB,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,IAAI,MAAqG,CAAA;IACzG,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACvC,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAA;QACnB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YAClB,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YAC3D,MAAM,GAAG;gBACP,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;gBACtC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;gBACxC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;gBACtC,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC;aAC7C,CAAA;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;gBACtF,OAAO,SAAS,CAAA;YAClB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;YAC9C,MAAM,SAAS,GAAG,IAAI,KAAK,WAAW,IAAI,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;YAC7E,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,SAAS;gBACT,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;aAC1D,CAAA;QACH,CAAC;QACD,kEAAkE;QAClE,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/audio/wiring.d.ts

@@ -0,0 +1,31 @@
+/**
+ * How the owner builds the audio service: the child journal adapter (an `audiocpp_server` is
+ * journalled like any backend, under `provider: 'audio'`, right after it spawns) and the event bus.
+ * Kept out of `create.ts`, which stays a list of `await`s.
+ */
+import type { DataLayout } from '../config/index.js';
+import type { CoreEvents } from '../contracts/index.js';
+import type { ProcessJournal } from '../lock/index.js';
+import type { BackendOutputSink, GpuClaimHook } from '../runtime/shared/index.js';
+import { AudioService } from './service.js';
+import type { AudioServiceDeps } from './service.js';
+/** The provider id audio generation journals its server and claims the GPU under. */
+export declare const AUDIO_PROVIDER = "audio";
+export interface WireAudioOptions {
+    layout: DataLayout;
+    journal: Pick<ProcessJournal, 'add' | 'remove'>;
+    instanceId: string;
+    emit: <K extends keyof CoreEvents>(name: K, payload: CoreEvents[K]) => void;
+    log: (level: 'info' | 'warn' | 'debug', msg: string) => void;
+    /** Every stdout/stderr line `audiocpp_server` prints, for the life of the session. */
+    backendOutput?: BackendOutputSink;
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    /** Core's GPU residency, asked before every `audiocpp_server` spawn. */
+    claimGpu?: GpuClaimHook;
+    /** Test seams, straight through to the service. */
+    overrides?: Pick<AudioServiceDeps, 'http' | 'spawn' | 'timings' | 'idleTickMs' | 'now' | 'sleep' | 'drawSeed'>;
+}
+/** The journal entry an `audiocpp_server` gets the moment it starts, so a crashed owner's successor can reap it. */
+export declare function audioJournal(journal: Pick<ProcessJournal, 'add' | 'remove'>, instanceId: string, now?: () => number): NonNullable<AudioServiceDeps['journal']>;
+export declare function wireAudio(options: WireAudioOptions): AudioService;

package/dist/audio/wiring.js

@@ -0,0 +1,41 @@
+/**
+ * How the owner builds the audio service: the child journal adapter (an `audiocpp_server` is
+ * journalled like any backend, under `provider: 'audio'`, right after it spawns) and the event bus.
+ * Kept out of `create.ts`, which stays a list of `await`s.
+ */
+import { processStartId } from '../lock/index.js';
+import { AudioService } from './service.js';
+/** The provider id audio generation journals its server and claims the GPU under. */
+export const AUDIO_PROVIDER = 'audio';
+/** The journal entry an `audiocpp_server` gets the moment it starts, so a crashed owner's successor can reap it. */
+export function audioJournal(journal, instanceId, now = Date.now) {
+    return {
+        add: async (pid, port, exe, modelId) => journal.add({
+            instance_id: instanceId,
+            pid,
+            process_start_id: (await processStartId(pid)) ?? null,
+            exe,
+            provider: AUDIO_PROVIDER,
+            model_id: modelId,
+            port,
+            started_at: new Date(now()).toISOString(),
+        }),
+        remove: (pid) => journal.remove(pid),
+    };
+}
+export function wireAudio(options) {
+    const service = new AudioService({
+        paths: options.layout.audio,
+        emit: options.emit,
+        log: options.log,
+        journal: audioJournal(options.journal, options.instanceId),
+        ...(options.platform ? { platform: options.platform } : {}),
+        ...(options.env ? { env: options.env } : {}),
+        ...(options.claimGpu ? { claimGpu: options.claimGpu } : {}),
+        ...(options.backendOutput ? { backendOutput: options.backendOutput } : {}),
+        ...options.overrides,
+    });
+    service.start();
+    return service;
+}
+//# sourceMappingURL=wiring.js.map

package/dist/audio/wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiring.js","sourceRoot":"","sources":["../../src/audio/wiring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAA;AAqBrC,oHAAoH;AACpH,MAAM,UAAU,YAAY,CAC1B,OAA+C,EAC/C,UAAkB,EAClB,MAAoB,IAAI,CAAC,GAAG;IAE5B,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CACrC,OAAO,CAAC,GAAG,CAAC;YACV,WAAW,EAAE,UAAU;YACvB,GAAG;YACH,gBAAgB,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI;YACrD,GAAG;YACH,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE,OAAO;YACjB,IAAI;YACJ,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;SAC1C,CAAC;QACJ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;KACrC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC,CAAA;IACF,OAAO,CAAC,KAAK,EAAE,CAAA;IACf,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/backend/install/service.js

@@ -267,12 +267,14 @@ export class BackendService {
                 await extractArchive(archive, staging);
                 await rm(archive, { force: true });
             }
-            await normalizeBackendLayout(staging, llamaServerExeName(platform));
-            await mergeCudartIntoBin(staging);
+            // Companions go first: a flat pack (PrismML's Windows CUDA zip) is normalised by moving every
+            // entry at the staging root into `build/bin`, the companion archive still waiting there with them.
             for (const companion of plan.companions ?? []) {
                 await mergeCompanionIntoBin(staging, companion);
                 await rm(companion, { force: true });
             }
+            await normalizeBackendLayout(staging, llamaServerExeName(platform));
+            await mergeCudartIntoBin(staging);
             const verify = this.deps.provider === 'atomic-prism'
                 ? (this.deps.verifyPrismBackend ?? ((dir, tag) => verifyPrismBackendBinary(dir, tag, platform)))
                 : this.deps.provider === 'llamacpp-upstream' && platform === 'darwin'