@atomic-chat/core 0.20.5 → 0.20.7

package/dist/audio/http.js

@@ -0,0 +1,56 @@
+/**
+ * The HTTP the audio module needs against `audiocpp_server`: a GET or a JSON POST with a deadline and
+ * an abort signal, status, content type and the body as bytes back (a speech answer is a WAV, a task
+ * answer a JSON document that can run past 100 MB for a long song). Over the raw-socket client rather
+ * than the global `fetch`, which in the Bun-compiled binary honours `HTTP_PROXY` even for loopback
+ * (ADR 2026-09-15-proxied-downloads-use-a-raw-socket-client), as image generation does.
+ */
+import { createPolicyFetch } from '../downloads/index.js';
+/** Thrown when the deadline, not the caller, ended the exchange. */
+export class AudioTimeoutError extends Error {
+    constructor(timeoutMs) {
+        super(`audiocpp_server did not answer within ${timeoutMs} ms`);
+        this.name = 'AudioTimeoutError';
+    }
+}
+/** One request with a deadline that covers the whole exchange, body included. */
+async function exchange(fetchImpl, url, init, options) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, options.timeoutMs);
+    const forward = () => controller.abort();
+    if (options.signal?.aborted)
+        controller.abort();
+    options.signal?.addEventListener('abort', forward, { once: true });
+    try {
+        const response = await fetchImpl(url, { ...init, signal: controller.signal });
+        const body = Buffer.from(await response.arrayBuffer());
+        return { status: response.status, contentType: response.headers.get('content-type') ?? '', body };
+    }
+    catch (error) {
+        if (timedOut)
+            throw new AudioTimeoutError(options.timeoutMs);
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+        options.signal?.removeEventListener('abort', forward);
+    }
+}
+export function createAudioHttpClient(fetchImpl = createPolicyFetch({})) {
+    return {
+        get: (url, options) => exchange(fetchImpl, url, { method: 'GET' }, options),
+        post: (url, json, options) => {
+            const body = JSON.stringify(json);
+            const headers = {
+                'content-type': 'application/json',
+                'content-length': String(Buffer.byteLength(body)),
+            };
+            return exchange(fetchImpl, url, { method: 'POST', headers, body }, options);
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/audio/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/audio/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAmBzD,oEAAoE;AACpE,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,SAAiB;QAC3B,KAAK,CAAC,yCAAyC,SAAS,KAAK,CAAC,CAAA;QAC9D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED,iFAAiF;AACjF,KAAK,UAAU,QAAQ,CACrB,SAAuB,EACvB,GAAW,EACX,IAAiB,EACjB,OAA4B;IAE5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,QAAQ,GAAG,IAAI,CAAA;QACf,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IACrB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACxC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,UAAU,CAAC,KAAK,EAAE,CAAA;IAC/C,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QACtD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAA;IACnG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ;YAAE,MAAM,IAAI,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC5D,MAAM,KAAK,CAAA;IACb,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAA0B,iBAAiB,CAAC,EAAE,CAAC;IACnF,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC;QAC3E,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YACjC,MAAM,OAAO,GAAG;gBACd,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;aAClD,CAAA;YACD,OAAO,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7E,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/audio/idle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Unload the audio model after `idleUnloadSecs` without a job. The deadline is re-armed by every job
+ * that ends and by `touchIdle`. A tick, never a wait behind a load (image generation's `idle.ts`).
+ */
+import type { AsyncMutex } from '../diffusion/index.js';
+import type { AudioState } from './state.js';
+/** How often the idle task checks the deadline. */
+export declare const IDLE_TICK_MS = 30000;
+export interface AudioIdleDeps {
+    state: AudioState;
+    loadLock: AsyncMutex;
+    /** Unload the resident model; called with the load lock held. */
+    unload: (reason: string) => Promise<void>;
+    log: (level: 'info' | 'warn', msg: string) => void;
+    tickMs?: number;
+}
+/** One look at the deadline: whether an unload was started. */
+export declare function audioIdleTick(deps: AudioIdleDeps): Promise<boolean>;
+/** Start the ticking; the timer never keeps the process alive. */
+export declare function startAudioIdleTask(deps: AudioIdleDeps): {
+    stop(): void;
+};

package/dist/audio/idle.js

@@ -0,0 +1,44 @@
+/**
+ * Unload the audio model after `idleUnloadSecs` without a job. The deadline is re-armed by every job
+ * that ends and by `touchIdle`. A tick, never a wait behind a load (image generation's `idle.ts`).
+ */
+/** How often the idle task checks the deadline. */
+export const IDLE_TICK_MS = 30_000;
+/** One look at the deadline: whether an unload was started. */
+export async function audioIdleTick(deps) {
+    const { state } = deps;
+    if (!state.idleExpired() || state.activeJobId !== undefined)
+        return false;
+    const release = deps.loadLock.tryAcquire();
+    if (!release)
+        return false;
+    try {
+        if (!state.spec) {
+            state.clearIdle();
+            return false;
+        }
+        deps.log('info', 'unloading the audio model after idling');
+        await deps.unload('idle');
+        return true;
+    }
+    catch (error) {
+        deps.log('warn', `idle unload failed: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+    finally {
+        release();
+    }
+}
+/** Start the ticking; the timer never keeps the process alive. */
+export function startAudioIdleTask(deps) {
+    let running = false;
+    const timer = setInterval(() => {
+        if (running)
+            return;
+        running = true;
+        void audioIdleTick(deps).finally(() => (running = false));
+    }, deps.tickMs ?? IDLE_TICK_MS);
+    timer.unref();
+    return { stop: () => clearInterval(timer) };
+}
+//# sourceMappingURL=idle.js.map

package/dist/audio/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../src/audio/idle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA;AAWlC,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmB;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IACtB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAC1B,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,SAAS,EAAE,CAAA;YACjB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wCAAwC,CAAC,CAAA;QAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACjG,OAAO,KAAK,CAAA;IACd,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,IAAI,CAAA;QACd,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAA;IAC3D,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,CAAA;IAC/B,KAAK,CAAC,KAAK,EAAE,CAAA;IACb,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAA;AAC7C,CAAC"}

package/dist/audio/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Audio generation on audio.cpp: speech, music and sound effects from text. One resident
+ * `audiocpp_server` per loaded model, the builds it runs from, and the clips on disk. A module of its
+ * own beside image generation (`src/diffusion/`), not a local runtime.
+ */
+export * from './args.js';
+export * from './capabilities.js';
+export * from './config.js';
+export * from './errors.js';
+export * from './gallery.js';
+export * from './http.js';
+export * from './idle.js';
+export * from './install.js';
+export * from './jobs.js';
+export * from './model-files.js';
+export * from './output.js';
+export * from './parse.js';
+export * from './recipe.js';
+export * from './request.js';
+export * from './server-process.js';
+export * from './service.js';
+export * from './session.js';
+export * from './state.js';
+export * from './types.js';
+export * from './wav.js';
+export * from './wiring.js';

package/dist/audio/index.js

@@ -0,0 +1,27 @@
+/**
+ * Audio generation on audio.cpp: speech, music and sound effects from text. One resident
+ * `audiocpp_server` per loaded model, the builds it runs from, and the clips on disk. A module of its
+ * own beside image generation (`src/diffusion/`), not a local runtime.
+ */
+export * from './args.js';
+export * from './capabilities.js';
+export * from './config.js';
+export * from './errors.js';
+export * from './gallery.js';
+export * from './http.js';
+export * from './idle.js';
+export * from './install.js';
+export * from './jobs.js';
+export * from './model-files.js';
+export * from './output.js';
+export * from './parse.js';
+export * from './recipe.js';
+export * from './request.js';
+export * from './server-process.js';
+export * from './service.js';
+export * from './session.js';
+export * from './state.js';
+export * from './types.js';
+export * from './wav.js';
+export * from './wiring.js';
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/audio/install.d.ts

@@ -0,0 +1,57 @@
+/**
+ * audio.cpp builds under `<data>/audio/backends/<tag>/<backendId>/`: the install record and its
+ * marker, the probe that a tree is audio.cpp and can reach its backend's device, and the listing a
+ * load picks its build from. The download, the extraction and the removal of a build are the
+ * engine-builds module's, as for sd.cpp (`src/diffusion/install.ts`).
+ */
+import type { AtomicCoreError, AudioBackend, AudioBackendInstallRecord } from '../contracts/index.js';
+import type { ExitInfo } from '../runtime/llamacpp/index.js';
+export declare function audioServerBinaryName(platform: NodeJS.Platform): string;
+export interface AudioInstallDeps {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    probeTimeoutMs?: number;
+    spawnRetryDelayMs?: number;
+    log?: (level: 'info' | 'warn', msg: string) => void;
+}
+/** `install.json` holds the record minus `dir`, which is where the file lives. */
+export declare function writeAudioInstallRecord(dir: string, record: AudioBackendInstallRecord): Promise<void>;
+export declare function readAudioInstallRecord(dir: string): Promise<AudioBackendInstallRecord | undefined>;
+/** Every `<root>/<tag>/<backendId>/install.json` with its marker and its server binary, newest install first. */
+export declare function listInstalledAudioBuilds(backendsRoot: string, platform?: NodeJS.Platform): Promise<AudioBackendInstallRecord[]>;
+/** What `audiocpp_server --version` says about itself; `null` when the output is not audio.cpp's. */
+export interface AudioVersionInfo {
+    version: string;
+    backends: string[];
+}
+export declare function parseAudioVersion(text: string): AudioVersionInfo | null;
+export interface AudioDevice {
+    /** `MTL`, `Vulkan`, `CUDA`, `BLAS`, `CPU`, …: ggml's backend registry name. */
+    registry: string;
+    index: number;
+    name: string;
+    /** `GPU`, `CPU`, `ACCEL`, `IGPU`. */
+    type: string;
+}
+/** The device lines of `audiocpp_server --list-devices` (text; v0.9.3 ignores `--json`). */
+export declare function parseAudioDevices(text: string): AudioDevice[];
+/**
+ * The verdict on a finished `--version` run: nothing when the binary is audio.cpp, otherwise the error
+ * to raise. A binary the OS loader could not start is a missing runtime, not the wrong program, so the
+ * loader's words are read before the output is. The `backends:` line is not checked: a build that
+ * loads its GPU backend at run time (the fork's Windows arm64 CUDA build) lists only `cpu` there, so
+ * whether a GPU build reaches its device is `--list-devices`' question.
+ */
+export declare function audioVersionVerdict(binary: string, text: string, exit: ExitInfo, platform: NodeJS.Platform): AtomicCoreError | undefined;
+/**
+ * The verdict on `--list-devices` for a GPU build: nothing when the engine sees a GPU, otherwise the
+ * error that sends the install to the next build of the ladder (a Vulkan build on a machine without
+ * a Vulkan driver lists only the CPU). A CPU build always passes.
+ */
+export declare function audioDevicesVerdict(binary: string, text: string, exit: ExitInfo, platform: NodeJS.Platform, backend: AudioBackend): AtomicCoreError | undefined;
+/**
+ * An unpacked tree made runnable and checked: `audiocpp_server` present and executable, answering
+ * `--version` as audio.cpp, and — for a GPU build — listing a GPU.
+ * Throws `ENGINE_INSTALL_FAILED` otherwise, which moves the install to the next build of the ladder.
+ */
+export declare function prepareAudiocppTree(dir: string, backend: AudioBackend, deps?: AudioInstallDeps): Promise<void>;

package/dist/audio/install.js

@@ -0,0 +1,196 @@
+/**
+ * audio.cpp builds under `<data>/audio/backends/<tag>/<backendId>/`: the install record and its
+ * marker, the probe that a tree is audio.cpp and can reach its backend's device, and the listing a
+ * load picks its build from. The download, the extraction and the removal of a build are the
+ * engine-builds module's, as for sd.cpp (`src/diffusion/install.ts`).
+ */
+import { chmod, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { AUDIO_BACKENDS } from '../contracts/index.js';
+import { INSTALL_RECORD, OWNER_MARKER, PROBE_TIMEOUT_MS, runHelpProbe } from '../diffusion/index.js';
+import { audioError, audioIoError } from './errors.js';
+/** What audio.cpp's `--version` prints first, and the line naming the backends the build carries. */
+const VERSION_MARKER = 'audio.cpp ';
+const BACKENDS_LINE = /^backends:\s*(.+)$/m;
+/** A `--list-devices` line: `MTL:0 "Apple M4 Pro" [GPU]`. */
+const DEVICE_LINE = /^\s*([A-Za-z0-9_]+):(\d+)\s+"([^"]*)"\s+\[([A-Z]+)\]\s*$/gm;
+/** What glibc's `ld.so` and macOS `dyld` print when a library is missing, lowercase. */
+const LOADER_MARKERS = ['error while loading shared libraries', 'library not loaded'];
+/** NTSTATUS codes of a Windows process the loader gave up on before `main`. */
+const WINDOWS_LOADER_FAILURES = new Set([0xc000_0135, 0xc000_0138, 0xc000_0139, 0xc000_007b, 0xc000_0142]);
+export function audioServerBinaryName(platform) {
+    return platform === 'win32' ? 'audiocpp_server.exe' : 'audiocpp_server';
+}
+const isFile = (path) => stat(path).then((s) => s.isFile(), () => false);
+const isDirectory = (path) => stat(path).then((s) => s.isDirectory(), () => false);
+/** `install.json` holds the record minus `dir`, which is where the file lives. */
+export async function writeAudioInstallRecord(dir, record) {
+    const file = {
+        tag: record.tag,
+        backendId: record.backendId,
+        backend: record.backend,
+        engine: record.engine,
+        sha256: record.sha256,
+        installedAtMs: record.installedAtMs,
+    };
+    await writeFile(join(dir, OWNER_MARKER), 'atomic-chat\n').catch((error) => {
+        throw audioIoError('Could not write the ownership marker.', error);
+    });
+    await writeFile(join(dir, INSTALL_RECORD), JSON.stringify(file, null, 2)).catch((error) => {
+        throw audioIoError('Could not write the install record.', error);
+    });
+}
+export async function readAudioInstallRecord(dir) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(join(dir, INSTALL_RECORD), 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const file = raw;
+    const sha256 = file['sha256'] ?? null;
+    const { tag, backendId, backend, engine, installedAtMs } = file;
+    if (typeof tag !== 'string' ||
+        typeof backendId !== 'string' ||
+        typeof backend !== 'string' ||
+        !AUDIO_BACKENDS.includes(backend) ||
+        engine !== 'audio-cpp' ||
+        (sha256 !== null && typeof sha256 !== 'string') ||
+        typeof installedAtMs !== 'number' ||
+        !Number.isInteger(installedAtMs) ||
+        installedAtMs < 0)
+        return undefined;
+    return { tag, backendId, backend: backend, engine, sha256, installedAtMs, dir };
+}
+/** Every `<root>/<tag>/<backendId>/install.json` with its marker and its server binary, newest install first. */
+export async function listInstalledAudioBuilds(backendsRoot, platform = process.platform) {
+    const out = [];
+    for (const tag of await readdir(backendsRoot).catch(() => [])) {
+        const tagPath = join(backendsRoot, tag);
+        if (!(await isDirectory(tagPath)))
+            continue;
+        for (const backend of await readdir(tagPath).catch(() => [])) {
+            const dir = join(tagPath, backend);
+            if (!(await isDirectory(dir)) || !(await isFile(join(dir, OWNER_MARKER))))
+                continue;
+            const record = await readAudioInstallRecord(dir);
+            if (record && (await isFile(join(dir, audioServerBinaryName(platform)))))
+                out.push(record);
+        }
+    }
+    return out.sort((a, b) => b.installedAtMs - a.installedAtMs);
+}
+export function parseAudioVersion(text) {
+    const first = text.split(/\r?\n/).find((line) => line.startsWith(VERSION_MARKER));
+    if (!first)
+        return null;
+    const backends = BACKENDS_LINE.exec(text)?.[1];
+    return {
+        version: first.slice(VERSION_MARKER.length).trim(),
+        backends: backends
+            ? backends
+                .split(',')
+                .map((name) => name.trim().toLowerCase())
+                .filter(Boolean)
+            : [],
+    };
+}
+/** The device lines of `audiocpp_server --list-devices` (text; v0.9.3 ignores `--json`). */
+export function parseAudioDevices(text) {
+    return [...text.matchAll(DEVICE_LINE)].map((match) => ({
+        registry: match[1] ?? '',
+        index: Number(match[2]),
+        name: match[3] ?? '',
+        type: match[4] ?? '',
+    }));
+}
+function loaderFailed(text, exit, platform) {
+    const lower = text.toLowerCase();
+    return ((platform === 'win32' && exit.code !== null && WINDOWS_LOADER_FAILURES.has(exit.code >>> 0)) ||
+        LOADER_MARKERS.some((marker) => lower.includes(marker)));
+}
+const statusOf = (binary, exit) => exit.code === null
+    ? `${binary}: ${exit.signal === null ? 'unknown status' : `signal ${String(exit.signal)}`}`
+    : `${binary}: exit code ${exit.code}`;
+/**
+ * The verdict on a finished `--version` run: nothing when the binary is audio.cpp, otherwise the error
+ * to raise. A binary the OS loader could not start is a missing runtime, not the wrong program, so the
+ * loader's words are read before the output is. The `backends:` line is not checked: a build that
+ * loads its GPU backend at run time (the fork's Windows arm64 CUDA build) lists only `cpu` there, so
+ * whether a GPU build reaches its device is `--list-devices`' question.
+ */
+export function audioVersionVerdict(binary, text, exit, platform) {
+    const output = [...text].slice(0, 800).join('');
+    const status = statusOf(binary, exit);
+    if (loaderFailed(text, exit, platform))
+        return audioError('ENGINE_INSTALL_FAILED', 'The audio engine could not load a library it needs.', output.trim() === '' ? status : `${status}\n${output}`);
+    if (parseAudioVersion(text))
+        return undefined;
+    if (text.trim() === '')
+        return audioError('ENGINE_INSTALL_FAILED', 'The audio engine exited without printing anything.', status);
+    return audioError('ENGINE_INSTALL_FAILED', 'The downloaded binary is not audio.cpp.', output);
+}
+/**
+ * The verdict on `--list-devices` for a GPU build: nothing when the engine sees a GPU, otherwise the
+ * error that sends the install to the next build of the ladder (a Vulkan build on a machine without
+ * a Vulkan driver lists only the CPU). A CPU build always passes.
+ */
+export function audioDevicesVerdict(binary, text, exit, platform, backend) {
+    if (backend === 'cpu')
+        return undefined;
+    if (loaderFailed(text, exit, platform))
+        return audioError('ENGINE_INSTALL_FAILED', 'The audio engine could not load a library it needs.', statusOf(binary, exit));
+    const gpus = parseAudioDevices(text).filter((device) => device.type === 'GPU' || device.type === 'IGPU');
+    if (gpus.length > 0)
+        return undefined;
+    return audioError('ENGINE_INSTALL_FAILED', `The audio engine found no ${backend} device on this computer.`, [...text].slice(-800).join(''));
+}
+async function setExecutable(path, deps) {
+    if ((deps.platform ?? process.platform) === 'win32' || !(await isFile(path)))
+        return;
+    await chmod(path, 0o755).catch((error) => {
+        deps.log?.('warn', `chmod ${path} failed: ${error instanceof Error ? error.message : String(error)}`);
+    });
+}
+/**
+ * An unpacked tree made runnable and checked: `audiocpp_server` present and executable, answering
+ * `--version` as audio.cpp, and — for a GPU build — listing a GPU.
+ * Throws `ENGINE_INSTALL_FAILED` otherwise, which moves the install to the next build of the ladder.
+ */
+export async function prepareAudiocppTree(dir, backend, deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const server = join(dir, audioServerBinaryName(platform));
+    if (!(await isFile(server)))
+        throw audioError('ENGINE_INSTALL_FAILED', 'The archive did not contain audiocpp_server.', server);
+    await setExecutable(server, deps);
+    await setExecutable(join(dir, platform === 'win32' ? 'audiocpp_cli.exe' : 'audiocpp_cli'), deps);
+    const started = Date.now();
+    const probe = (args) => runHelpProbe(server, {
+        platform,
+        timeoutMs: deps.probeTimeoutMs ?? PROBE_TIMEOUT_MS,
+        args,
+        deps,
+        noResponse: `The audio engine did not respond to ${args.join(' ')}.`,
+        couldNotStart: 'The audio engine could not be started.',
+    });
+    try {
+        const version = await probe(['--version']);
+        const versionFailure = audioVersionVerdict(server, version.text, version.exit, platform);
+        if (versionFailure)
+            throw versionFailure;
+        const devices = backend === 'cpu' ? null : await probe(['--list-devices']);
+        const devicesFailure = devices && audioDevicesVerdict(server, devices.text, devices.exit, platform, backend);
+        if (devicesFailure)
+            throw devicesFailure;
+        deps.log?.('info', `audio engine probe passed in ${((Date.now() - started) / 1000).toFixed(1)}s`);
+    }
+    catch (error) {
+        const { message, details } = error;
+        deps.log?.('warn', `audio engine probe failed: ${message} (${details ?? 'no details'})`);
+        throw error;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/audio/install.js.map

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

package/dist/audio/jobs.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Jobs: validate, send to `audiocpp_server`, save, and the cancel path. One job at a time; the
+ * request is synchronous (audio.cpp has no job API), so a job moves through phases only —
+ * `queued`, `loading` while a server stopped by a cancel or a crash comes back, `generating` while
+ * the engine runs, `saving` while the clip is written — each one an `audio:job` event.
+ *
+ * Cancel: audio.cpp cannot interrupt a running request and goes on generating after a JSON client
+ * hangs up, so a cancel aborts the request and stops the process, keeping the spec; the next job
+ * respawns the server from it. A job not generating yet just ends.
+ */
+import type { AudioCancelResult, AudioErrorBody, AudioGalleryItem, AudioGenerateRequest, AudioJob, AudioJobPhase, AudioMode, AudioSource } from '../contracts/index.js';
+import type { AsyncMutex } from '../diffusion/index.js';
+import type { AudioGallery } from './gallery.js';
+import type { AudioHttpClient } from './http.js';
+import type { AudioSessionDeps } from './session.js';
+export interface AudioJobTimings {
+    /** Only stops a wedged engine from holding the slot forever; a long song on a CPU takes many minutes. */
+    generationCeilingMs: number;
+    /** How long a dropped connection waits for the server's exit to show before it is called a crash. */
+    exitWaitMs: number;
+}
+export declare const DEFAULT_AUDIO_JOB_TIMINGS: AudioJobTimings;
+export interface AudioJobDeps extends AudioSessionDeps {
+    http: AudioHttpClient;
+    gallery: AudioGallery;
+    loadLock: AsyncMutex;
+    timings: AudioJobTimings;
+    drawSeed: () => number;
+    /** A reference voice from disk, refused when it is larger than `maxBytes`. */
+    readSource: (path: string, maxBytes: number) => Promise<Buffer>;
+}
+export interface AudioJobOutcome {
+    job: AudioJob;
+    item: AudioGalleryItem;
+    /** The clip's bytes, as saved. */
+    wav: Buffer;
+}
+export type AudioJobResult = {
+    ok: true;
+    outcome: AudioJobOutcome;
+} | {
+    ok: false;
+    error: AudioErrorBody;
+};
+export interface StartedAudioJob {
+    job: AudioJob;
+    /** Settles when the job is over; never rejects. */
+    done: Promise<AudioJobResult>;
+}
+export declare function drawAudioSeed(): number;
+/** A reference voice file, read whole once it is known to be small enough. */
+export declare function readVoiceRefFile(path: string, maxBytes: number): Promise<Buffer>;
+/** The reference voice as the engine takes it: a WAV of at most 5 MiB, base64. */
+export declare function resolveVoiceRef(source: AudioSource, readSource: AudioJobDeps['readSource']): Promise<string>;
+/** The request as the job record keeps it: inline audio bytes blanked, file paths kept. */
+export declare function withoutInlineAudio(request: AudioGenerateRequest): AudioGenerateRequest;
+/** Move a job to `phase` (and to `generating` with it), never out of a terminal state. */
+export declare function setJobPhase(deps: AudioJobDeps, id: string, phase: AudioJobPhase): void;
+/** Move a job to a terminal state exactly once. Whether this call made the transition. */
+export declare function finishAudioJob(deps: AudioJobDeps, id: string, result: {
+    ok: true;
+    item: AudioGalleryItem;
+} | {
+    ok: false;
+    error: AudioErrorBody;
+}): boolean;
+/** Validate, register and start a job in `mode` on the loaded model. */
+export declare function startAudioJob(deps: AudioJobDeps, mode: AudioMode, request: AudioGenerateRequest): Promise<StartedAudioJob>;
+/** Run one job to completion; the path a caller that awaits the clip takes. */
+export declare function runAudioJob(deps: AudioJobDeps, mode: AudioMode, request: AudioGenerateRequest): Promise<AudioJobOutcome>;
+/**
+ * Cancel a job. While the engine generates, the request is aborted and the server stopped (the spec
+ * stays, so the next job respawns it); a clip already being saved is kept. Before that the job ends
+ * here and now: its runner may be waiting for the load lock to respawn the server, and the caller may
+ * hold that lock (a load, an unload, an engine update), so nothing here waits for the runner then.
+ */
+export declare function cancelAudioJob(deps: AudioJobDeps, id: string): Promise<AudioCancelResult>;