@atomic-chat/core 0.20.5 → 0.20.6

package/dist/audio/args.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `audiocpp_server`'s command line and environment. Pure.
+ *
+ * `--backend` is always passed (audio.cpp defaults to `cuda`, which a Metal or Vulkan build does not
+ * carry) and so is `--no-ui` (the embedded WebUI is on by default once a config is given). `--log` and
+ * `--load-progress 1` make the server print the model facts and the load phases the core reads.
+ */
+import type { AudioBackend } from '../contracts/index.js';
+/** `ATOMIC_AUDIO_BACKEND=cpu` runs every build on its CPU backend (a device backend that misbehaves). */
+export declare const AUDIO_BACKEND_ENV = "ATOMIC_AUDIO_BACKEND";
+/** The backend a build runs on: its own, unless the environment forces the CPU. */
+export declare function resolveAudioBackend(buildBackend: AudioBackend, env: NodeJS.ProcessEnv): AudioBackend;
+export declare function buildAudioServerArgs(configFile: string, port: number, backend: AudioBackend, threads?: number): string[];
+/**
+ * What the child gets on top of the core's environment: audio.cpp unpacks each GGUF package's configs
+ * and tokenizer under `$TMPDIR/audiocpp-gguf/` (~37 MB a model), so its temporary folder is the
+ * core's own `<data>/audio/tmp` rather than the system's.
+ */
+export declare function audioChildEnv(platform: NodeJS.Platform, tmpDir: string): Record<string, string>;

package/dist/audio/args.js

@@ -0,0 +1,39 @@
+/**
+ * `audiocpp_server`'s command line and environment. Pure.
+ *
+ * `--backend` is always passed (audio.cpp defaults to `cuda`, which a Metal or Vulkan build does not
+ * carry) and so is `--no-ui` (the embedded WebUI is on by default once a config is given). `--log` and
+ * `--load-progress 1` make the server print the model facts and the load phases the core reads.
+ */
+/** `ATOMIC_AUDIO_BACKEND=cpu` runs every build on its CPU backend (a device backend that misbehaves). */
+export const AUDIO_BACKEND_ENV = 'ATOMIC_AUDIO_BACKEND';
+/** The backend a build runs on: its own, unless the environment forces the CPU. */
+export function resolveAudioBackend(buildBackend, env) {
+    return env[AUDIO_BACKEND_ENV]?.trim().toLowerCase() === 'cpu' ? 'cpu' : buildBackend;
+}
+export function buildAudioServerArgs(configFile, port, backend, threads) {
+    return [
+        '--config',
+        configFile,
+        '--no-ui',
+        '--host',
+        '127.0.0.1',
+        '--port',
+        String(port),
+        '--backend',
+        backend,
+        '--log',
+        '--load-progress',
+        '1',
+        ...(threads !== undefined && threads > 0 ? ['--threads', String(threads)] : []),
+    ];
+}
+/**
+ * What the child gets on top of the core's environment: audio.cpp unpacks each GGUF package's configs
+ * and tokenizer under `$TMPDIR/audiocpp-gguf/` (~37 MB a model), so its temporary folder is the
+ * core's own `<data>/audio/tmp` rather than the system's.
+ */
+export function audioChildEnv(platform, tmpDir) {
+    return platform === 'win32' ? { TMPDIR: tmpDir, TEMP: tmpDir, TMP: tmpDir } : { TMPDIR: tmpDir };
+}
+//# sourceMappingURL=args.js.map

package/dist/audio/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/audio/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,yGAAyG;AACzG,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAAsB,CAAA;AAEvD,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,YAA0B,EAAE,GAAsB;IACpF,OAAO,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,IAAY,EACZ,OAAqB,EACrB,OAAgB;IAEhB,OAAO;QACL,UAAU;QACV,UAAU;QACV,SAAS;QACT,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,MAAM,CAAC,IAAI,CAAC;QACZ,WAAW;QACX,OAAO;QACP,OAAO;QACP,iBAAiB;QACjB,GAAG;QACH,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAyB,EAAE,MAAc;IACrE,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAClG,CAAC"}

package/dist/audio/capabilities.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What a running `audiocpp_server` says about its model: the entry `GET /v1/models?include_params=true`
+ * lists for it, and the client-facing `AudioCapabilities` built from that entry and the facts the
+ * loader traced. Pure.
+ */
+import type { AudioCapabilities, AudioModelParam } from '../contracts/index.js';
+import type { AudioModelFacts } from './output.js';
+import type { AudioServerSpec } from './types.js';
+/** One model of `/v1/models`, as far as the core reads it. */
+export interface ServedAudioModel {
+    id: string;
+    family: string;
+    task: string;
+    loaded: boolean;
+    params: AudioModelParam[];
+}
+/** One declared parameter, or `undefined` when it has no name. Unknown keys are dropped. */
+export declare function parseModelParam(raw: unknown): AudioModelParam | undefined;
+/** Every model of a `/v1/models` body; an entry without an id is skipped, a body that is not a list gives none. */
+export declare function parseServedModels(body: unknown): ServedAudioModel[];
+/** The voice ids of `GET /v1/audio/voices`: strings, or objects naming an `id`, `voice_id` or `name`. */
+export declare function parseVoiceList(body: unknown): string[];
+/** The capabilities of `spec`'s model, as the server that serves it declared them. */
+export declare function buildCapabilities(spec: Pick<AudioServerSpec, 'modelId' | 'mode' | 'family' | 'task'>, served: ServedAudioModel, facts: AudioModelFacts, listedVoices?: readonly string[]): AudioCapabilities;

package/dist/audio/capabilities.js

@@ -0,0 +1,96 @@
+/**
+ * What a running `audiocpp_server` says about its model: the entry `GET /v1/models?include_params=true`
+ * lists for it, and the client-facing `AudioCapabilities` built from that entry and the facts the
+ * loader traced. Pure.
+ */
+const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const isOptionValue = (value) => typeof value === 'string' ||
+    typeof value === 'boolean' ||
+    (typeof value === 'number' && Number.isFinite(value));
+/** One declared parameter, or `undefined` when it has no name. Unknown keys are dropped. */
+export function parseModelParam(raw) {
+    if (!isRecord(raw) || typeof raw['name'] !== 'string' || raw['name'] === '')
+        return undefined;
+    const param = {
+        name: raw['name'],
+        type: typeof raw['type'] === 'string' ? raw['type'] : 'string',
+        required: raw['required'] === true,
+    };
+    if (typeof raw['description'] === 'string')
+        param.description = raw['description'];
+    if (isOptionValue(raw['default']))
+        param.default = raw['default'];
+    if (typeof raw['min'] === 'number' && Number.isFinite(raw['min']))
+        param.min = raw['min'];
+    if (typeof raw['max'] === 'number' && Number.isFinite(raw['max']))
+        param.max = raw['max'];
+    if (Array.isArray(raw['values']))
+        param.values = raw['values'].filter((value) => typeof value === 'string');
+    return param;
+}
+/** Every model of a `/v1/models` body; an entry without an id is skipped, a body that is not a list gives none. */
+export function parseServedModels(body) {
+    const data = isRecord(body) ? body['data'] : undefined;
+    if (!Array.isArray(data))
+        return [];
+    const out = [];
+    for (const entry of data) {
+        if (!isRecord(entry) || typeof entry['id'] !== 'string')
+            continue;
+        const params = Array.isArray(entry['params']) ? entry['params'] : [];
+        out.push({
+            id: entry['id'],
+            family: typeof entry['family'] === 'string' ? entry['family'] : '',
+            task: typeof entry['task'] === 'string' ? entry['task'] : '',
+            loaded: entry['loaded'] === true,
+            params: params.map(parseModelParam).filter((param) => param !== undefined),
+        });
+    }
+    return out;
+}
+/** The voice ids of `GET /v1/audio/voices`: strings, or objects naming an `id`, `voice_id` or `name`. */
+export function parseVoiceList(body) {
+    const voices = isRecord(body) ? body['voices'] : undefined;
+    if (!Array.isArray(voices))
+        return [];
+    const out = [];
+    for (const voice of voices) {
+        if (typeof voice === 'string')
+            out.push(voice);
+        else if (isRecord(voice))
+            for (const key of ['id', 'voice_id', 'name'])
+                if (typeof voice[key] === 'string') {
+                    out.push(voice[key]);
+                    break;
+                }
+    }
+    return out;
+}
+/**
+ * Families whose variant speaks only in a cloned voice. Qwen3-TTS Base refuses a request without a
+ * reference ("Qwen3 base TTS requires voice clone reference audio") although its `voice_id` still
+ * lists the CustomVoice speakers.
+ */
+const CLONE_ONLY_VARIANTS = { qwen3_tts: /(^|[-_ ])base$/i };
+/** The capabilities of `spec`'s model, as the server that serves it declared them. */
+export function buildCapabilities(spec, served, facts, listedVoices = []) {
+    const speech = spec.mode === 'speech';
+    const voiceParam = served.params.find((param) => param.name === 'voice_id');
+    const cloneOnly = speech && facts.variant !== undefined && (CLONE_ONLY_VARIANTS[spec.family]?.test(facts.variant) ?? false);
+    const declared = voiceParam?.values && voiceParam.values.length > 0 ? voiceParam.values : listedVoices;
+    const supportsVoiceRef = speech &&
+        (cloneOnly ||
+            facts.supportsSpeakerReference === true ||
+            served.params.some((param) => param.name === 'reference_text'));
+    return {
+        modelId: spec.modelId,
+        mode: spec.mode,
+        family: spec.family,
+        task: spec.task,
+        params: served.params.map((param) => structuredClone(param)),
+        voices: speech && !cloneOnly ? [...declared] : [],
+        supportsVoiceRef,
+        requiresVoiceRef: cloneOnly,
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/audio/capabilities.js.map

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

package/dist/audio/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The `server.json` the core writes for each `audiocpp_server` it starts: one model, loaded before
+ * the server listens (`lazy_load: false`), never unloaded by the engine (`idle_unload_ms: 0` — the
+ * core owns the idle unload) and never joined by another (`max_loaded_models: 1`). audio.cpp declares
+ * models only in its config: `/v1/models/load` needs `--ui-management`, which the core never passes.
+ * Pure.
+ */
+import type { AudioMode, AudioOptions, AudioTask } from '../contracts/index.js';
+import type { AudioServerSpec } from './types.js';
+/** The audio.cpp task a mode is served by: speech is `tts`, music and effects are `gen`. */
+export declare function taskForMode(mode: AudioMode): AudioTask;
+/**
+ * The model a load names, absolute. An absolute path is taken as it is; a relative one is resolved
+ * against the models folder and refused when it climbs out of it.
+ */
+export declare function resolveModelPath(file: string, modelsDir: string, platform: NodeJS.Platform): string;
+export interface AudioServerModelEntry {
+    id: string;
+    family: string;
+    path: string;
+    task: AudioTask;
+    mode: 'offline';
+    load_options?: AudioOptions;
+    session_options?: AudioOptions;
+    default_request_options?: AudioOptions;
+    default_voice_preset?: {
+        voice_id: string;
+    };
+}
+export interface AudioServerConfig {
+    host: '127.0.0.1';
+    port: number;
+    backend: string;
+    lazy_load: false;
+    max_loaded_models: 1;
+    idle_unload_ms: 0;
+    models: AudioServerModelEntry[];
+}
+/** The config for `spec` served on `port`. */
+export declare function buildServerConfig(spec: AudioServerSpec, port: number): AudioServerConfig;

package/dist/audio/config.js

@@ -0,0 +1,57 @@
+/**
+ * The `server.json` the core writes for each `audiocpp_server` it starts: one model, loaded before
+ * the server listens (`lazy_load: false`), never unloaded by the engine (`idle_unload_ms: 0` — the
+ * core owns the idle unload) and never joined by another (`max_loaded_models: 1`). audio.cpp declares
+ * models only in its config: `/v1/models/load` needs `--ui-management`, which the core never passes.
+ * Pure.
+ */
+import { posix, win32 } from 'node:path';
+import { audioError } from './errors.js';
+/** The audio.cpp task a mode is served by: speech is `tts`, music and effects are `gen`. */
+export function taskForMode(mode) {
+    return mode === 'speech' ? 'tts' : 'gen';
+}
+/**
+ * The model a load names, absolute. An absolute path is taken as it is; a relative one is resolved
+ * against the models folder and refused when it climbs out of it.
+ */
+export function resolveModelPath(file, modelsDir, platform) {
+    const path = platform === 'win32' ? win32 : posix;
+    if (file.trim() === '')
+        throw audioError('INVALID_REQUEST', 'The load names no model file.');
+    if (path.isAbsolute(file))
+        return path.normalize(file);
+    const resolved = path.resolve(modelsDir, file);
+    const rel = path.relative(modelsDir, resolved);
+    if (rel === '' || rel === '..' || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel))
+        throw audioError('INVALID_REQUEST', 'The model file is outside the audio models folder.', file);
+    return resolved;
+}
+/** The config for `spec` served on `port`. */
+export function buildServerConfig(spec, port) {
+    const model = {
+        id: spec.modelId,
+        family: spec.family,
+        path: spec.modelPath,
+        task: spec.task,
+        mode: 'offline',
+    };
+    if (spec.loadOptions && Object.keys(spec.loadOptions).length > 0)
+        model.load_options = { ...spec.loadOptions };
+    if (spec.sessionOptions && Object.keys(spec.sessionOptions).length > 0)
+        model.session_options = { ...spec.sessionOptions };
+    if (spec.defaultRequestOptions && Object.keys(spec.defaultRequestOptions).length > 0)
+        model.default_request_options = { ...spec.defaultRequestOptions };
+    if (spec.defaultVoice !== undefined && spec.defaultVoice !== '')
+        model.default_voice_preset = { voice_id: spec.defaultVoice };
+    return {
+        host: '127.0.0.1',
+        port,
+        backend: spec.backend,
+        lazy_load: false,
+        max_loaded_models: 1,
+        idle_unload_ms: 0,
+        models: [model],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/audio/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/audio/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAyB;IACzF,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IACjD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,UAAU,CAAC,iBAAiB,EAAE,+BAA+B,CAAC,CAAA;IAC5F,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACvF,MAAM,UAAU,CAAC,iBAAiB,EAAE,oDAAoD,EAAE,IAAI,CAAC,CAAA;IACjG,OAAO,QAAQ,CAAA;AACjB,CAAC;AAwBD,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAAC,IAAqB,EAAE,IAAY;IACnE,MAAM,KAAK,GAA0B;QACnC,EAAE,EAAE,IAAI,CAAC,OAAO;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,SAAS;QACpB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,SAAS;KAChB,CAAA;IACD,IAAI,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9D,KAAK,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAC9C,IAAI,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC;QACpE,KAAK,CAAC,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;IACpD,IAAI,IAAI,CAAC,qBAAqB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,MAAM,GAAG,CAAC;QAClF,KAAK,CAAC,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAA;IACnE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,EAAE;QAC7D,KAAK,CAAC,oBAAoB,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,CAAA;IAC9D,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,KAAK;QAChB,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,CAAC;QACjB,MAAM,EAAE,CAAC,KAAK,CAAC;KAChB,CAAA;AACH,CAAC"}

package/dist/audio/errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Audio-generation failures, carried by `AtomicCoreError` so the control server's envelope and the
+ * job records show one shape, as image generation's do (`src/diffusion/errors.ts`).
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import type { AudioErrorBody, AudioErrorCode } from '../contracts/index.js';
+export declare function audioError(code: AudioErrorCode, message: string, details?: string): AtomicCoreError;
+export declare function audioInternalError(message: string, details?: string): AtomicCoreError;
+/** libuv reports a full disk as `ENOSPC` everywhere, Windows' two "disk full" codes included. */
+export declare function isAudioDiskFull(error: unknown): boolean;
+/**
+ * An I/O failure on the closest code: a full disk is something the user can act on, everything else
+ * is internal, with `context` as the message.
+ */
+export declare function audioIoError(context: string, error: unknown): AtomicCoreError;
+export declare function isAudioErrorCode(code: unknown): code is AudioErrorCode;
+/**
+ * Any failure as a job record or an event carries it. A code from outside this surface becomes
+ * `INTERNAL`, its original code kept in the details.
+ */
+export declare function audioErrorBody(error: unknown): AudioErrorBody;
+/** The thrown form of `audioErrorBody`: what a caller awaiting the operation receives. */
+export declare function toAudioError(error: unknown): AtomicCoreError;

package/dist/audio/errors.js

@@ -0,0 +1,52 @@
+/**
+ * Audio-generation failures, carried by `AtomicCoreError` so the control server's envelope and the
+ * job records show one shape, as image generation's do (`src/diffusion/errors.ts`).
+ */
+import { AtomicCoreError, AUDIO_ERROR_CODES } from '../contracts/index.js';
+export function audioError(code, message, details) {
+    return new AtomicCoreError(code, message, details);
+}
+export function audioInternalError(message, details) {
+    return audioError('INTERNAL', message, details);
+}
+/** libuv reports a full disk as `ENOSPC` everywhere, Windows' two "disk full" codes included. */
+export function isAudioDiskFull(error) {
+    return error?.code === 'ENOSPC';
+}
+/**
+ * An I/O failure on the closest code: a full disk is something the user can act on, everything else
+ * is internal, with `context` as the message.
+ */
+export function audioIoError(context, error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    if (isAudioDiskFull(error))
+        return audioError('DISK_FULL', 'The disk is full.', `${context}: ${reason}`);
+    return audioInternalError(context, reason);
+}
+export function isAudioErrorCode(code) {
+    return typeof code === 'string' && AUDIO_ERROR_CODES.includes(code);
+}
+/**
+ * Any failure as a job record or an event carries it. A code from outside this surface becomes
+ * `INTERNAL`, its original code kept in the details.
+ */
+export function audioErrorBody(error) {
+    if (error instanceof AtomicCoreError) {
+        if (isAudioErrorCode(error.code)) {
+            return error.details === undefined
+                ? { code: error.code, message: error.message }
+                : { code: error.code, message: error.message, details: error.details };
+        }
+        const details = error.details === undefined ? error.code : `${error.code}: ${error.details}`;
+        return { code: 'INTERNAL', message: error.message, details };
+    }
+    return { code: 'INTERNAL', message: error instanceof Error ? error.message : String(error) };
+}
+/** The thrown form of `audioErrorBody`: what a caller awaiting the operation receives. */
+export function toAudioError(error) {
+    if (error instanceof AtomicCoreError && isAudioErrorCode(error.code))
+        return error;
+    const body = audioErrorBody(error);
+    return audioError(body.code, body.message, body.details);
+}
+//# sourceMappingURL=errors.js.map

package/dist/audio/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/audio/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAG1E,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,OAAe,EAAE,OAAgB;IAChF,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,OAAgB;IAClE,OAAO,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACjD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAQ,KAA2C,EAAE,IAAI,KAAK,QAAQ,CAAA;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,KAAc;IAC1D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACrE,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC,CAAA;IACxG,OAAO,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;gBAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;QAC1E,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;QAC5F,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAC9F,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,eAAe,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IAClF,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;AAC1D,CAAC"}

package/dist/audio/gallery.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The audio gallery on disk: `<outputDir>/<jobId>.wav` with its recipe as `<jobId>.json` beside it.
+ * The core checks the WAV header, writes the bytes as they came, and reads the clip's length from the
+ * header again when it lists it.
+ *
+ * A `.wav` without a parseable recipe is somebody else's: it is never listed and never deleted, even
+ * when it sits in the folder under a name that looks like ours.
+ */
+import type { AudioGalleryItem, AudioGalleryListOptions, AudioGalleryPage, AudioRecipe } from '../contracts/index.js';
+export declare const AUDIO_SUFFIX = ".wav";
+export declare const RECIPE_SUFFIX = ".json";
+/** `^[a-f0-9]{32}$`: the job id, which is also the file stem. */
+export declare function isValidAudioId(id: string): boolean;
+export declare function audioPath(dir: string, id: string): string;
+export declare function audioRecipePath(dir: string, id: string): string;
+/** The clips of one folder. Every clip has a unique name, so no lock is needed. */
+export declare class AudioGallery {
+    private readonly log;
+    constructor(log?: (level: 'info' | 'warn', msg: string) => void);
+    /** Write the recipe, then the clip, and answer the item. The WAV must be one. */
+    save(dir: string, recipe: AudioRecipe, wav: Buffer): Promise<AudioGalleryItem>;
+    get(dir: string, id: string): Promise<AudioGalleryItem | null>;
+    /** Our clips, newest first, `limit` of them from `offset`. */
+    list(dir: string, options: AudioGalleryListOptions): Promise<AudioGalleryPage>;
+    /**
+     * Remove a clip and its recipe. A clip that is already gone is not an error; a WAV without our
+     * recipe is foreign and refused.
+     */
+    delete(dir: string, id: string): Promise<void>;
+}

package/dist/audio/gallery.js

@@ -0,0 +1,152 @@
+/**
+ * The audio gallery on disk: `<outputDir>/<jobId>.wav` with its recipe as `<jobId>.json` beside it.
+ * The core checks the WAV header, writes the bytes as they came, and reads the clip's length from the
+ * header again when it lists it.
+ *
+ * A `.wav` without a parseable recipe is somebody else's: it is never listed and never deleted, even
+ * when it sits in the folder under a name that looks like ours.
+ */
+import { mkdir, open, readdir, readFile, rm, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isWithin, writeAtomic } from '../diffusion/index.js';
+import { audioError, audioIoError } from './errors.js';
+import { parseAudioRecipe, serializeAudioRecipe } from './recipe.js';
+import { parseWav } from './wav.js';
+export const AUDIO_SUFFIX = '.wav';
+export const RECIPE_SUFFIX = '.json';
+/** How much of a WAV a listing reads for its header. */
+const HEADER_BYTES = 64 * 1024;
+/** How many clips a listing reads at once. */
+const SCAN_CONCURRENCY = 16;
+const WRITE_MESSAGES = {
+    write: 'Could not write to the audio folder.',
+    finish: 'Could not finish writing the clip.',
+};
+/** `^[a-f0-9]{32}$`: the job id, which is also the file stem. */
+export function isValidAudioId(id) {
+    return /^[a-f0-9]{32}$/.test(id);
+}
+export function audioPath(dir, id) {
+    return join(dir, `${id}${AUDIO_SUFFIX}`);
+}
+export function audioRecipePath(dir, id) {
+    return join(dir, `${id}${RECIPE_SUFFIX}`);
+}
+function checkedId(dir, id) {
+    if (!isValidAudioId(id))
+        throw audioError('INVALID_REQUEST', 'That is not a gallery clip id.', id);
+    if (!isWithin(audioPath(dir, id), dir))
+        throw audioError('INVALID_REQUEST', 'That clip is outside the audio folder.', id);
+}
+async function readRecipe(dir, id) {
+    const text = await readFile(audioRecipePath(dir, id), 'utf8').catch(() => undefined);
+    const recipe = text === undefined ? undefined : parseAudioRecipe(text);
+    // A recipe that names another job is not this clip's.
+    return recipe?.jobId === id ? recipe : undefined;
+}
+/** The header of the WAV at `path`, from its first bytes; `undefined` when it is missing or not a WAV. */
+async function readWavHeader(path) {
+    const handle = await open(path, 'r').catch(() => undefined);
+    if (!handle)
+        return undefined;
+    try {
+        const { size } = await handle.stat();
+        const buffer = Buffer.alloc(Math.min(size, HEADER_BYTES));
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        const info = parseWav(buffer.subarray(0, bytesRead), size);
+        return info ? { info, size } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        await handle.close().catch(() => { });
+    }
+}
+function itemOf(id, path, info, size, recipe) {
+    return {
+        id,
+        path,
+        sampleRate: info.sampleRate,
+        channels: info.channels,
+        audioMs: info.audioMs,
+        sizeBytes: size,
+        createdAtMs: recipe.createdAtMs,
+        recipe,
+    };
+}
+async function itemFromDisk(dir, id) {
+    const recipe = await readRecipe(dir, id);
+    if (!recipe)
+        return undefined;
+    const path = audioPath(dir, id);
+    const header = await readWavHeader(path);
+    return header ? itemOf(id, path, header.info, header.size, recipe) : undefined;
+}
+/** The clips of one folder. Every clip has a unique name, so no lock is needed. */
+export class AudioGallery {
+    log;
+    constructor(log = () => { }) {
+        this.log = log;
+    }
+    /** Write the recipe, then the clip, and answer the item. The WAV must be one. */
+    async save(dir, recipe, wav) {
+        const id = recipe.jobId;
+        checkedId(dir, id);
+        const info = parseWav(wav);
+        if (!info)
+            throw audioError('INVALID_OUTPUT', 'The audio engine returned something that is not a WAV.');
+        await mkdir(dir, { recursive: true }).catch((error) => {
+            throw audioIoError('Could not create the audio folder.', error);
+        });
+        // The recipe first: a clip without one is foreign, so a crash between the two leaves nothing listed.
+        await writeAtomic(audioRecipePath(dir, id), serializeAudioRecipe(recipe), WRITE_MESSAGES);
+        await writeAtomic(audioPath(dir, id), wav, WRITE_MESSAGES);
+        return itemOf(id, audioPath(dir, id), info, wav.length, recipe);
+    }
+    async get(dir, id) {
+        checkedId(dir, id);
+        return (await itemFromDisk(dir, id)) ?? null;
+    }
+    /** Our clips, newest first, `limit` of them from `offset`. */
+    async list(dir, options) {
+        const names = await readdir(dir).catch(() => []);
+        const ids = names
+            .filter((name) => name.endsWith(AUDIO_SUFFIX))
+            .map((name) => name.slice(0, -AUDIO_SUFFIX.length))
+            .filter(isValidAudioId);
+        const all = [];
+        for (let at = 0; at < ids.length; at += SCAN_CONCURRENCY) {
+            const found = await Promise.all(ids.slice(at, at + SCAN_CONCURRENCY).map((id) => itemFromDisk(dir, id)));
+            for (const item of found)
+                if (item)
+                    all.push(item);
+        }
+        all.sort((a, b) => b.createdAtMs - a.createdAtMs || (a.id < b.id ? 1 : a.id > b.id ? -1 : 0));
+        const items = all.slice(options.offset, options.offset + Math.max(options.limit, 1));
+        return { items, hasMore: options.offset + items.length < all.length, total: all.length };
+    }
+    /**
+     * Remove a clip and its recipe. A clip that is already gone is not an error; a WAV without our
+     * recipe is foreign and refused.
+     */
+    async delete(dir, id) {
+        checkedId(dir, id);
+        const path = audioPath(dir, id);
+        const exists = await stat(path).then((s) => s.isFile(), () => false);
+        const ours = (await readRecipe(dir, id)) !== undefined;
+        if (exists) {
+            if (!ours) {
+                this.log('warn', `refusing to delete foreign clip ${id}`);
+                throw audioError('INVALID_REQUEST', 'That file is not an Atomic Chat clip.', id);
+            }
+            await rm(path).catch((error) => {
+                throw audioIoError('Could not delete the clip.', error);
+            });
+        }
+        // A recipe left behind by a clip already gone goes too; a JSON that is not our recipe stays.
+        if (ours)
+            await rm(audioRecipePath(dir, id), { force: true }).catch(() => { });
+    }
+}
+//# sourceMappingURL=gallery.js.map

package/dist/audio/gallery.js.map

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

package/dist/audio/http.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+export interface AudioResponse {
+    status: number;
+    contentType: string;
+    body: Buffer;
+}
+export interface AudioRequestOptions {
+    timeoutMs: number;
+    /** Stops the exchange (a cancel); the promise rejects with the abort. */
+    signal?: AbortSignal;
+}
+export interface AudioHttpClient {
+    get(url: string, options: AudioRequestOptions): Promise<AudioResponse>;
+    post(url: string, json: unknown, options: AudioRequestOptions): Promise<AudioResponse>;
+}
+/** Thrown when the deadline, not the caller, ended the exchange. */
+export declare class AudioTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare function createAudioHttpClient(fetchImpl?: typeof fetch): AudioHttpClient;