@atomic-chat/core 0.20.5 → 0.20.6

package/dist/audio/service.js

@@ -0,0 +1,402 @@
+/**
+ * The audio-generation service: one resident `audiocpp_server` for the loaded model, jobs against it,
+ * the gallery and the model files, and what the engine-builds module and GPU residency need of it.
+ * The shape of image generation's `DiffusionService`, much smaller.
+ */
+import { mkdir, stat } from 'node:fs/promises';
+import { AsyncMutex, samePath } from '../diffusion/index.js';
+import { resolveAudioBackend } from './args.js';
+import { resolveModelPath, taskForMode } from './config.js';
+import { audioError, audioIoError } from './errors.js';
+import { AudioGallery } from './gallery.js';
+import { createAudioHttpClient } from './http.js';
+import { startAudioIdleTask } from './idle.js';
+import { listInstalledAudioBuilds, readAudioInstallRecord } from './install.js';
+import { cancelAudioJob, DEFAULT_AUDIO_JOB_TIMINGS, drawAudioSeed, readVoiceRefFile, runAudioJob, startAudioJob, } from './jobs.js';
+import { audioModelFilePath, deleteAudioModelFile, listAudioModelFiles } from './model-files.js';
+import { spawnAudioServer } from './server-process.js';
+import { activateAudioInstall, audioCapabilities, audioGpuCards, buildAudioStatus, emitAudioState, failLoad, loadFromSpec, shutdownAudioSession, takeDownSession, unloadSession, } from './session.js';
+import { AudioState, isTerminalAudioJobState } from './state.js';
+import { DEFAULT_STARTUP_TIMEOUT_SECS } from './types.js';
+const WHAT = {
+    speech: 'speech',
+    music: 'music',
+    effects: 'a sound effect',
+};
+const exists = (path) => stat(path).then((s) => s.isFile() || s.isDirectory(), () => false);
+async function ensureDir(dir, message) {
+    await mkdir(dir, { recursive: true }).catch((error) => {
+        throw audioIoError(message, error);
+    });
+}
+export class AudioService {
+    state;
+    deps;
+    platform;
+    env;
+    idleTickMs;
+    idle;
+    /** Stops a load still waiting for its model when the model is unloaded or the core shuts down. */
+    loading;
+    /** GPU claims in flight, a load's or a respawn's; an unload aborts them rather than wait behind them. */
+    claims = new Set();
+    /** Unloads asked for and not finished: a GPU claim that starts meanwhile gives up at once. */
+    unloadRequests = 0;
+    constructor(options) {
+        const now = options.now ?? Date.now;
+        const platform = options.platform ?? process.platform;
+        const http = options.http ?? createAudioHttpClient();
+        const log = options.log;
+        this.platform = platform;
+        this.env = options.env ?? process.env;
+        this.idleTickMs = options.idleTickMs;
+        this.state = new AudioState(options.paths, now);
+        const journal = options.journal;
+        const spawn = options.spawn ??
+            ((spec, signal) => spawnAudioServer(spec, {
+                http,
+                runDir: options.paths.runDir,
+                tmpDir: options.paths.tmpDir,
+                platform,
+                env: this.env,
+                log,
+                ...(options.backendOutput ? { backendOutput: options.backendOutput } : {}),
+                ...(signal ? { signal } : {}),
+                ...(journal
+                    ? {
+                        onSpawned: (pid, port, exe) => journal.add(pid, port, exe, spec.modelId),
+                        onGone: (pid) => journal.remove(pid),
+                    }
+                    : {}),
+            }));
+        this.deps = {
+            state: this.state,
+            emit: options.emit,
+            log,
+            platform,
+            now,
+            sleep: options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
+            spawn,
+            ...(journal ? { onServerGone: (pid) => journal.remove(pid) } : {}),
+            ...(options.claimGpu ? { claimGpu: this.claimGpu(options.claimGpu) } : {}),
+            http,
+            gallery: new AudioGallery((level, msg) => log(level, msg)),
+            loadLock: new AsyncMutex(),
+            timings: { ...DEFAULT_AUDIO_JOB_TIMINGS, ...options.timings },
+            drawSeed: options.drawSeed ?? drawAudioSeed,
+            readSource: readVoiceRefFile,
+        };
+    }
+    /** Arm the idle timer. */
+    start() {
+        if (this.idle)
+            return;
+        this.idle = startAudioIdleTask({
+            state: this.state,
+            loadLock: this.deps.loadLock,
+            unload: (reason) => unloadSession(this.deps, reason),
+            log: this.deps.log,
+            ...(this.idleTickMs !== undefined ? { tickMs: this.idleTickMs } : {}),
+        });
+    }
+    // --- configuration and status ------------------------------------------------------------------
+    /** Optional settings: the output folder (`null` restores `<data>/audios`) and the idle unload. */
+    async config(config) {
+        if (config.outputDir !== undefined) {
+            const chosen = config.outputDir?.trim() ?? '';
+            if (chosen !== '')
+                await ensureDir(chosen, 'Could not create the output folder.');
+            this.state.outputDirOverride = chosen === '' ? null : chosen;
+        }
+        if (config.idleUnloadSecs !== undefined) {
+            this.state.idleUnloadSecs = config.idleUnloadSecs;
+            // Re-arm the idle timer with the new interval.
+            if (this.state.spec && this.state.activeJobId === undefined)
+                this.state.touchIdle();
+        }
+        await emitAudioState(this.deps, 'config');
+        return buildAudioStatus(this.deps);
+    }
+    status() {
+        return buildAudioStatus(this.deps);
+    }
+    /** The gallery folder; an empty path restores `<data>/audios`. */
+    async setOutputDir(path) {
+        const trimmed = path.trim();
+        if (trimmed !== '')
+            await ensureDir(trimmed, 'Could not create the output folder.');
+        this.state.outputDirOverride = trimmed === '' ? null : trimmed;
+        await emitAudioState(this.deps, 'output-dir');
+        return buildAudioStatus(this.deps);
+    }
+    // --- engine builds and GPU residency -----------------------------------------------------------
+    /**
+     * What the engine-builds module needs of audio generation: the load lock, the build directories in
+     * use, and the activation of a new build — cancel the running job, unload a model whose build the
+     * new one replaces (`engine-updated`), report the install.
+     */
+    engineHost() {
+        return {
+            exclusive: (fn) => this.deps.loadLock.run(fn),
+            inUse: async () => {
+                const dirs = [];
+                // A resident server, a spec kept after an idle unload or a crash, a server still exiting.
+                for (const dir of [
+                    this.state.session?.spec.binaryDir,
+                    this.state.spec?.binaryDir,
+                    this.state.stopping?.spec.binaryDir,
+                ])
+                    if (dir !== undefined && !dirs.includes(dir))
+                        dirs.push(dir);
+                return dirs;
+            },
+            activate: async (dir, replaced) => {
+                const record = await readAudioInstallRecord(dir);
+                if (!record)
+                    throw audioError('INTERNAL', 'The new audio engine build has no install record.', dir);
+                if (this.state.activeJobId !== undefined)
+                    await cancelAudioJob(this.deps, this.state.activeJobId).catch(() => undefined);
+                const spec = this.state.spec;
+                // The same directory with a fresh tree: what runs from it is the old binary.
+                if (replaced && spec && (await samePath(spec.binaryDir, dir, this.platform)))
+                    await unloadSession(this.deps, 'engine-updated');
+                else
+                    await activateAudioInstall(this.deps, record);
+                await emitAudioState(this.deps, 'install');
+            },
+            // The `install` part of the status changed.
+            changed: (reason) => emitAudioState(this.deps, reason),
+        };
+    }
+    /**
+     * The GPU the resident, stopping or starting `audiocpp_server` holds, for core's residency rule. The
+     * resident or starting one is `busy` while a job runs on it that nobody asked to cancel: residency
+     * then refuses a chat load (`GPU_BUSY`) instead of stopping the clip.
+     */
+    gpuOccupancy() {
+        const held = (spec, state, working) => ({
+            model_id: spec.modelId,
+            cards: audioGpuCards(spec),
+            auxiliary: false,
+            state,
+            ...(working ?? {}),
+        });
+        const out = [];
+        const { session, stopping, starting } = this.state;
+        if (session && session.server.exitStatus() === undefined)
+            out.push(held(session.spec, 'ready', this.working(session.spec)));
+        if (stopping)
+            out.push(held(stopping.spec, 'stopping'));
+        if (starting)
+            out.push(held(starting, 'loading', this.working(starting)));
+        return out;
+    }
+    /** What the active job is making on `spec`; none when no job is live. */
+    working(spec) {
+        const id = this.state.activeJobId;
+        const record = id === undefined ? undefined : this.state.record(id);
+        if (!record || record.cancel.requested || isTerminalAudioJobState(record.job.state))
+            return undefined;
+        return {
+            busy: `${spec.displayName} is generating ${WHAT[spec.mode]}`,
+            remedy: 'Wait for the clip to finish, or stop it, then try again.',
+        };
+    }
+    /** The session's claim hook over core's: abortable by an unload, whatever signal the caller had. */
+    claimGpu(hook) {
+        return async (spec, signal, granted) => {
+            const controller = new AbortController();
+            const forward = () => controller.abort();
+            if (signal?.aborted || this.unloadRequests > 0)
+                controller.abort();
+            signal?.addEventListener('abort', forward, { once: true });
+            this.claims.add(controller);
+            try {
+                await hook({ model_id: spec.modelId, cards: audioGpuCards(spec), auxiliary: false }, controller.signal, granted);
+            }
+            finally {
+                this.claims.delete(controller);
+                signal?.removeEventListener('abort', forward);
+            }
+        };
+    }
+    // --- model files ---------------------------------------------------------------------------------
+    listModelFiles() {
+        return listAudioModelFiles(this.state.paths.modelsDir);
+    }
+    /** Delete a file named relative to `<data>/audio/models`; the loaded model's own file is refused. */
+    async deleteModelFile(relativePath) {
+        const root = this.state.paths.modelsDir;
+        const path = await audioModelFilePath(root, relativePath, this.platform);
+        const spec = this.state.spec;
+        if (spec && (await samePath(spec.modelPath, path, this.platform)))
+            throw audioError('BACKEND_IN_USE', 'That file belongs to the loaded audio model. Unload it first.');
+        await deleteAudioModelFile(root, path, this.platform);
+    }
+    // --- session -------------------------------------------------------------------------------------
+    /** Answers once the server serves the model. One load at a time; a load replaces the resident model. */
+    async loadModel(request) {
+        const { state } = this;
+        return this.deps.loadLock.run(async () => {
+            // First, before any await: an unload from here on reaches this load, wherever it is waiting.
+            const loading = new AbortController();
+            this.loading = loading;
+            try {
+                if (state.closing)
+                    throw audioError('ENGINE_CRASHED', 'The audio engine is shutting down.');
+                if (state.activeJobId !== undefined)
+                    await cancelAudioJob(this.deps, state.activeJobId).catch(() => undefined);
+                await takeDownSession(this.deps);
+                state.spec = undefined;
+                state.capabilities = undefined;
+                let spec;
+                try {
+                    spec = await this.specFor(request);
+                }
+                catch (error) {
+                    return await failLoad(this.deps, error, 'load-blocked');
+                }
+                return await loadFromSpec(this.deps, spec, 'load', loading.signal);
+            }
+            finally {
+                if (this.loading === loading)
+                    this.loading = undefined;
+            }
+        });
+    }
+    /** What a load runs: the newest installed build, the model file checked. */
+    async specFor(request) {
+        if (request.task !== taskForMode(request.mode))
+            throw audioError('INVALID_REQUEST', `A ${request.mode} model is served as audio.cpp's ${taskForMode(request.mode)} task.`, `task: ${request.task}`);
+        const modelPath = resolveModelPath(request.file, this.state.paths.modelsDir, this.platform);
+        if (!(await exists(modelPath))) {
+            const name = modelPath.split(/[\\/]/).pop() || modelPath;
+            throw audioError('MODEL_MISSING', `${name} is missing. Download the model again.`, modelPath);
+        }
+        const record = (await listInstalledAudioBuilds(this.state.paths.backendsDir, this.platform))[0];
+        if (!record)
+            throw audioError('ENGINE_MISSING', 'The audio engine is not installed.');
+        return {
+            binaryDir: record.dir,
+            backend: resolveAudioBackend(record.backend, this.env),
+            buildBackend: record.backend,
+            backendId: record.backendId,
+            tag: record.tag,
+            modelId: request.modelId,
+            displayName: request.displayName,
+            mode: request.mode,
+            family: request.family,
+            task: request.task,
+            modelPath,
+            ...(request.loadOptions ? { loadOptions: { ...request.loadOptions } } : {}),
+            ...(request.sessionOptions ? { sessionOptions: { ...request.sessionOptions } } : {}),
+            ...(request.defaultRequestOptions
+                ? { defaultRequestOptions: { ...request.defaultRequestOptions } }
+                : {}),
+            ...(request.defaultVoice !== undefined ? { defaultVoice: request.defaultVoice } : {}),
+            ...(request.threads !== undefined ? { threads: request.threads } : {}),
+            startupTimeoutMs: (request.startupTimeoutSecs !== undefined && request.startupTimeoutSecs > 0
+                ? request.startupTimeoutSecs
+                : DEFAULT_STARTUP_TIMEOUT_SECS) * 1000,
+        };
+    }
+    async unloadModel() {
+        this.unloadRequests += 1;
+        let counted = true;
+        const done = () => {
+            if (!counted)
+                return;
+            counted = false;
+            this.unloadRequests -= 1;
+        };
+        this.loading?.abort();
+        for (const claim of this.claims)
+            claim.abort();
+        try {
+            await this.deps.loadLock.run(async () => {
+                try {
+                    if (this.state.activeJobId !== undefined)
+                        await cancelAudioJob(this.deps, this.state.activeJobId).catch(() => undefined);
+                    await unloadSession(this.deps, 'unload');
+                    // A server taken down outside the lock (a job's crash or cancel) is waited for as well.
+                    await this.state.stopping?.done;
+                }
+                finally {
+                    // Still inside the lock: a load queued behind this unload is never taken for superseded.
+                    done();
+                }
+            });
+        }
+        finally {
+            done();
+        }
+    }
+    /** Reset the idle-unload deadline without generating. */
+    touchIdle() {
+        if (this.state.activeJobId === undefined && this.state.spec)
+            this.state.touchIdle();
+    }
+    capabilities() {
+        return audioCapabilities(this.state);
+    }
+    // --- jobs ----------------------------------------------------------------------------------------
+    /** Start a job; answers it at once, its phases and outcome arrive as `audio:job` events. */
+    async generate(mode, request) {
+        return (await startAudioJob(this.deps, mode, request)).job;
+    }
+    /** Run one job to completion and answer the clip. */
+    runJob(mode, request) {
+        return runAudioJob(this.deps, mode, request);
+    }
+    /**
+     * What `POST /v1/audio/speech` needs: the loaded model and what it makes, and a speech job started
+     * the way `runJob` starts one — same validation, events, gallery and idle timer — but answered with
+     * its id at once, so a client that hangs up can have it cancelled.
+     */
+    speechBackend() {
+        return {
+            loaded: () => {
+                const spec = this.state.spec;
+                return spec ? { modelId: spec.modelId, displayName: spec.displayName, mode: spec.mode } : undefined;
+            },
+            start: async (request) => {
+                const { job, done } = await startAudioJob(this.deps, 'speech', request);
+                return { id: job.id, done };
+            },
+            cancel: (jobId) => cancelAudioJob(this.deps, jobId),
+        };
+    }
+    getJob(id) {
+        return this.state.job(id) ?? null;
+    }
+    cancelJob(id) {
+        return cancelAudioJob(this.deps, id);
+    }
+    // --- gallery -------------------------------------------------------------------------------------
+    gallery(options) {
+        return this.deps.gallery.list(this.state.outputDir(), options);
+    }
+    deleteGalleryItem(id) {
+        return this.deps.gallery.delete(this.state.outputDir(), id);
+    }
+    // --- lifecycle -----------------------------------------------------------------------------------
+    /** Owner exit: an `audiocpp_server` must not outlive the core. No events, a short grace. */
+    async shutdown() {
+        this.state.closing = true;
+        this.idle?.stop();
+        this.idle = undefined;
+        this.loading?.abort();
+        for (const claim of this.claims)
+            claim.abort();
+        const id = this.state.activeJobId;
+        if (id !== undefined) {
+            const record = this.state.record(id);
+            if (record) {
+                record.cancel.requested = true;
+                record.cancel.abort.abort();
+            }
+        }
+        await shutdownAudioSession(this.deps);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/audio/service.js.map

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

package/dist/audio/session.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 type { AudioBackendInstallRecord, AudioCapabilities, AudioEngineInstall, AudioErrorBody, AudioStatus, CoreEvents, LoadedAudioModel } from '../contracts/index.js';
+import type { GpuCards } from '../runtime/shared/index.js';
+import type { AudioState } from './state.js';
+import type { AudioServerHandle, AudioServerSpec } from './types.js';
+/** CUDA needs a moment after another engine's process dies before the driver reports the VRAM as free. */
+export declare const GPU_SETTLE_MS = 500;
+/** Owner exit: a short grace, then the kill. */
+export declare const SHUTDOWN_GRACE_MS = 2000;
+export type AudioEventName = 'audio:state' | 'audio:job' | 'audio:error';
+export type AudioEmitter = <K extends AudioEventName>(name: K, payload: CoreEvents[K]) => void;
+export type AudioLogger = (level: 'info' | 'warn' | 'debug', msg: string) => void;
+export interface AudioSessionDeps {
+    state: AudioState;
+    emit: AudioEmitter;
+    log: AudioLogger;
+    platform: NodeJS.Platform;
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+    /** Bring a server up for `spec`; rejects with the server dead. */
+    spawn: (spec: AudioServerSpec, signal?: AbortSignal) => Promise<AudioServerHandle>;
+    /** The child is gone (or was never journalled); forget it. */
+    onServerGone?: (pid: number) => Promise<void>;
+    /**
+     * Core's GPU residency: asked before every spawn — a load and a respawn alike — to free the GPU of
+     * the other engines. Rejects (`GPU_BUSY`, a cancel) fail the load.
+     */
+    claimGpu?: (spec: AudioServerSpec, signal?: AbortSignal, granted?: () => void) => Promise<void>;
+}
+export declare function modelNotLoadedError(): import("../contracts/errors.js").AtomicCoreError;
+/** Which GPUs an `audiocpp_server` holds: every card on a device backend, none on the CPU backend. */
+export declare function audioGpuCards(spec: Pick<AudioServerSpec, 'backend'>): GpuCards;
+/** The install the status reports: the resident spec's tree when there is one, otherwise the newest. */
+export declare function currentAudioInstall(deps: Pick<AudioSessionDeps, 'state' | 'platform'>): Promise<AudioEngineInstall>;
+/** Snapshot for `status` and the `state` event. */
+export declare function buildAudioStatus(deps: Pick<AudioSessionDeps, 'state' | 'platform'>): Promise<AudioStatus>;
+export declare function emitAudioState(deps: AudioSessionDeps, reason: string): Promise<void>;
+export declare function emitAudioError(deps: Pick<AudioSessionDeps, 'emit'>, jobId: string | undefined, error: AudioErrorBody): void;
+/** What the loaded model takes, as its server declared it when it last came up. */
+export declare function audioCapabilities(state: AudioState): AudioCapabilities;
+/**
+ * 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 declare function failLoad(deps: AudioSessionDeps, raw: unknown, reason: string, signal?: AbortSignal): Promise<never>;
+/**
+ * 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 declare function loadFromSpec(deps: AudioSessionDeps, spec: AudioServerSpec, reason: string, signal?: AbortSignal): Promise<LoadedAudioModel>;
+/**
+ * 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 declare function takeDownSession(deps: AudioSessionDeps, graceMs?: number): Promise<boolean>;
+/** Explicit unload: stop the server, forget the spec, report `unloaded`. */
+export declare function unloadSession(deps: AudioSessionDeps, reason: string): Promise<void>;
+/**
+ * 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 declare function activateAudioInstall(deps: AudioSessionDeps, record: AudioBackendInstallRecord): Promise<void>;
+/** The server was stopped but the spec stays: the next job respawns it. */
+export declare function stopKeepingSpec(deps: AudioSessionDeps, reason: string, error?: AudioErrorBody): Promise<void>;
+/** Owner exit: no events, no waiting beyond a short grace. */
+export declare function shutdownAudioSession(deps: AudioSessionDeps): Promise<void>;