@framers/agentos 0.1.120 → 0.1.122

package/dist/core/audio/providers/MusicGenLocalProvider.js

@@ -0,0 +1,235 @@
+/**
+ * @module core/audio/providers/MusicGenLocalProvider
+ *
+ * Local music generation provider using Meta's MusicGen model via
+ * the `@huggingface/transformers` library.
+ *
+ * MusicGen runs entirely on the local machine without any API keys or
+ * network requests. The model is loaded lazily on first use through the
+ * `pipeline('text-to-audio', ...)` API from HuggingFace Transformers.js.
+ *
+ * ## Requirements
+ *
+ * - `@huggingface/transformers` must be installed as a peer dependency.
+ *   If not installed, the provider throws a helpful error message.
+ * - Sufficient RAM/VRAM for model inference (Xenova/musicgen-small ~1GB).
+ *
+ * ## Supported models
+ *
+ * | Model ID                   | Description                       |
+ * |----------------------------|-----------------------------------|
+ * | `Xenova/musicgen-small`    | MusicGen Small — default, ~1GB    |
+ *
+ * ## API flow (local inference)
+ *
+ * 1. **Load** — `pipeline('text-to-audio', modelId)` (lazy, cached).
+ * 2. **Generate** — `pipeline(prompt, { max_new_tokens })` returns audio tensor.
+ * 3. **Encode** — Convert raw audio data to WAV format.
+ *
+ * @see {@link IAudioGenerator} for the provider interface contract.
+ * @see {@link AudioGenLocalProvider} for the SFX counterpart.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Encode raw PCM float32 audio samples into a WAV file buffer.
+ *
+ * Creates a minimal WAV header (44 bytes) followed by 16-bit PCM samples
+ * at the specified sample rate.
+ *
+ * @param samples - Float32 audio samples (range -1 to 1).
+ * @param sampleRate - Sample rate in Hz (e.g. 32000).
+ * @returns A Buffer containing valid WAV file data.
+ * @internal
+ */
+function encodeWav(samples, sampleRate) {
+    const numChannels = 1;
+    const bitsPerSample = 16;
+    const byteRate = sampleRate * numChannels * (bitsPerSample / 8);
+    const blockAlign = numChannels * (bitsPerSample / 8);
+    const dataSize = samples.length * (bitsPerSample / 8);
+    const headerSize = 44;
+    const buffer = Buffer.alloc(headerSize + dataSize);
+    // RIFF header
+    buffer.write('RIFF', 0);
+    buffer.writeUInt32LE(36 + dataSize, 4);
+    buffer.write('WAVE', 8);
+    // fmt sub-chunk
+    buffer.write('fmt ', 12);
+    buffer.writeUInt32LE(16, 16);
+    buffer.writeUInt16LE(1, 20); // PCM format
+    buffer.writeUInt16LE(numChannels, 22);
+    buffer.writeUInt32LE(sampleRate, 24);
+    buffer.writeUInt32LE(byteRate, 28);
+    buffer.writeUInt16LE(blockAlign, 32);
+    buffer.writeUInt16LE(bitsPerSample, 34);
+    // data sub-chunk
+    buffer.write('data', 36);
+    buffer.writeUInt32LE(dataSize, 40);
+    // Write 16-bit PCM samples
+    for (let i = 0; i < samples.length; i++) {
+        const clamped = Math.max(-1, Math.min(1, samples[i]));
+        const int16 = clamped < 0 ? clamped * 0x8000 : clamped * 0x7FFF;
+        buffer.writeInt16LE(Math.round(int16), headerSize + i * 2);
+    }
+    return buffer;
+}
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Local music generation provider using Meta's MusicGen model.
+ *
+ * Runs inference entirely on the local machine via `@huggingface/transformers`.
+ * The model is loaded lazily on first call to `generateMusic()` or
+ * explicitly via `initialize()`.
+ *
+ * @implements {IAudioGenerator}
+ *
+ * @example
+ * ```typescript
+ * const provider = new MusicGenLocalProvider();
+ * await provider.initialize({ modelId: 'Xenova/musicgen-small' });
+ *
+ * const result = await provider.generateMusic({
+ *   prompt: 'A calm ambient soundscape with synth pads',
+ *   durationSec: 10,
+ * });
+ * console.log(result.audio[0].base64?.substring(0, 50) + '...');
+ * ```
+ */
+export class MusicGenLocalProvider {
+    constructor() {
+        /** @inheritdoc */
+        this.providerId = 'musicgen-local';
+        /** @inheritdoc */
+        this.isInitialized = false;
+        /** The loaded text-to-audio pipeline instance. */
+        this._pipeline = null;
+        /** The resolved model ID. */
+        this._modelId = 'Xenova/musicgen-small';
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    /**
+     * Initialize the provider and optionally pre-load the model.
+     *
+     * The model is loaded lazily on first generation call. Calling initialize
+     * sets the configuration but does not load the model unless the pipeline
+     * was already created.
+     *
+     * @param config - Configuration object with optional `modelId`.
+     */
+    async initialize(config) {
+        if (typeof config.modelId === 'string' && config.modelId.trim()) {
+            this._modelId = config.modelId.trim();
+        }
+        this.defaultModelId = this._modelId;
+        this.isInitialized = true;
+    }
+    // -------------------------------------------------------------------------
+    // Generation
+    // -------------------------------------------------------------------------
+    /**
+     * Generate music from a text prompt using the local MusicGen model.
+     *
+     * On first call, loads the model pipeline (may take several seconds).
+     * Subsequent calls reuse the cached pipeline instance.
+     *
+     * @param request - Music generation request with prompt and optional params.
+     * @returns The generated audio result envelope with base64-encoded WAV data.
+     *
+     * @throws {Error} If the provider is not initialized.
+     * @throws {Error} If `@huggingface/transformers` is not installed.
+     */
+    async generateMusic(request) {
+        if (!this.isInitialized) {
+            throw new Error('MusicGen local provider is not initialized. Call initialize() first.');
+        }
+        const pipe = await this._ensurePipeline();
+        const modelId = request.modelId || this._modelId;
+        // Estimate max_new_tokens from duration. MusicGen generates at ~50 tokens/second.
+        const durationSec = request.durationSec ?? 10;
+        const maxNewTokens = Math.ceil(durationSec * 50);
+        const output = await pipe(request.prompt, { max_new_tokens: maxNewTokens });
+        // The pipeline returns { audio: Float32Array, sampling_rate: number }
+        const audioData = output;
+        const wavBuffer = encodeWav(audioData.audio, audioData.sampling_rate);
+        const base64 = wavBuffer.toString('base64');
+        return {
+            created: Math.floor(Date.now() / 1000),
+            modelId,
+            providerId: this.providerId,
+            audio: [{
+                    base64,
+                    mimeType: 'audio/wav',
+                    durationSec,
+                    providerMetadata: {
+                        sampleRate: audioData.sampling_rate,
+                        totalSamples: audioData.audio.length,
+                    },
+                }],
+            usage: {
+                totalAudioClips: 1,
+            },
+        };
+    }
+    /**
+     * SFX generation is not supported by MusicGen.
+     *
+     * @throws {Error} Always throws — use {@link AudioGenLocalProvider} instead.
+     */
+    async generateSFX(_request) {
+        throw new Error('MusicGen local provider does not support SFX generation. Use AudioGenLocalProvider instead.');
+    }
+    // -------------------------------------------------------------------------
+    // Capability query
+    // -------------------------------------------------------------------------
+    /**
+     * MusicGen supports music generation only.
+     *
+     * @param capability - The capability to check.
+     * @returns `true` only for `'music'`; `false` for `'sfx'`.
+     */
+    supports(capability) {
+        return capability === 'music';
+    }
+    /**
+     * Release model resources and reset initialization state.
+     */
+    async shutdown() {
+        this._pipeline = null;
+        this.isInitialized = false;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Ensure the text-to-audio pipeline is loaded, creating it lazily if needed.
+     *
+     * Uses dynamic `import()` to load `@huggingface/transformers` as an optional
+     * peer dependency. Throws a helpful error if the package is not installed.
+     *
+     * @returns The loaded pipeline callable.
+     *
+     * @throws {Error} If `@huggingface/transformers` is not installed.
+     * @internal
+     */
+    async _ensurePipeline() {
+        if (this._pipeline)
+            return this._pipeline;
+        let transformers;
+        try {
+            transformers = await import('@huggingface/transformers');
+        }
+        catch {
+            throw new Error('MusicGen local provider requires @huggingface/transformers. '
+                + 'Install it with: npm install @huggingface/transformers');
+        }
+        this._pipeline = await transformers.pipeline('text-to-audio', this._modelId);
+        return this._pipeline;
+    }
+}
+//# sourceMappingURL=MusicGenLocalProvider.js.map

package/dist/core/audio/providers/MusicGenLocalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicGenLocalProvider.js","sourceRoot":"","sources":["../../../../src/core/audio/providers/MusicGenLocalProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA2BH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAS,SAAS,CAAC,OAAqB,EAAE,UAAkB;IAC1D,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,MAAM,aAAa,GAAG,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,EAAE,CAAC;IAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IAEnD,cAAc;IACd,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAExB,gBAAgB;IAChB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7B,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IAC1C,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAExC,iBAAiB;IACjB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC;QAChE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,qBAAqB;IAAlC;QACE,kBAAkB;QACF,eAAU,GAAG,gBAAgB,CAAC;QAE9C,kBAAkB;QACX,kBAAa,GAAG,KAAK,CAAC;QAK7B,kDAAkD;QAC1C,cAAS,GAAY,IAAI,CAAC;QAElC,6BAA6B;QACrB,aAAQ,GAAG,uBAAuB,CAAC;IA8I7C,CAAC;IA5IC,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,MAA+B;QAC9C,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,OAA6B;QAC/C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QAEjD,kFAAkF;QAClF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAO,IAAyB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;QAElG,sEAAsE;QACtE,MAAM,SAAS,GAAG,MAAwD,CAAC;QAC3E,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YACtC,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,CAAC;oBACN,MAAM;oBACN,QAAQ,EAAE,WAAW;oBACrB,WAAW;oBACX,gBAAgB,EAAE;wBAChB,UAAU,EAAE,SAAS,CAAC,aAAa;wBACnC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;qBACrC;iBACF,CAAC;YACF,KAAK,EAAE;gBACL,eAAe,EAAE,CAAC;aACnB;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,QAA4B;QAC5C,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,mBAAmB;IACnB,4EAA4E;IAE5E;;;;;OAKG;IACH,QAAQ,CAAC,UAA2B;QAClC,OAAO,UAAU,KAAK,OAAO,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;;;;;;;OAUG;IACK,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAE1C,IAAI,YAAoE,CAAC;QACzE,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,8DAA8D;kBAC5D,wDAAwD,CAC3D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/core/audio/providers/ReplicateAudioProvider.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @module core/audio/providers/ReplicateAudioProvider
+ *
+ * Audio generation provider for the Replicate API, supporting both music
+ * and sound effects through different default models.
+ *
+ * Replicate hosts open-source audio models (MusicGen, AudioGen, etc.) behind
+ * a uniform predictions API. This provider mirrors the pattern established
+ * by {@link ReplicateVideoProvider}: create a prediction with `Prefer: wait`,
+ * then poll if it hasn't completed inline.
+ *
+ * ## Supported models
+ *
+ * | Model ID              | Type  | Description                    |
+ * |-----------------------|-------|--------------------------------|
+ * | `meta/musicgen`       | Music | Meta's MusicGen on Replicate   |
+ * | `meta/audiogen`       | SFX   | Meta's AudioGen on Replicate   |
+ *
+ * ## API flow (submit + sync wait + optional poll)
+ *
+ * 1. **Create prediction** — `POST ${baseURL}/predictions` with
+ *    `Prefer: wait=60`. If the model finishes within 60 seconds the
+ *    response already contains the output.
+ * 2. **Poll** (if needed) — `GET prediction.urls.get` until `status` is
+ *    `succeeded`, `failed`, or `canceled`.
+ * 3. **Result** — `output` is the audio URL (string or first array element).
+ *
+ * ## Authentication
+ *
+ * Requires a `REPLICATE_API_TOKEN`. Sent as `Authorization: Token ${apiKey}`.
+ *
+ * @see {@link IAudioGenerator} for the provider interface contract.
+ * @see {@link ReplicateVideoProvider} for the video counterpart.
+ */
+import type { IAudioGenerator } from '../IAudioGenerator.js';
+import type { MusicGenerateRequest, SFXGenerateRequest, AudioResult } from '../types.js';
+/**
+ * Configuration for the Replicate audio generation provider.
+ *
+ * @example
+ * ```typescript
+ * const config: ReplicateAudioProviderConfig = {
+ *   apiKey: process.env.REPLICATE_API_TOKEN!,
+ *   defaultMusicModel: 'meta/musicgen',
+ *   defaultSfxModel: 'meta/audiogen',
+ * };
+ * ```
+ */
+export interface ReplicateAudioProviderConfig {
+    /** Replicate API token. Sent as `Authorization: Token ${apiKey}`. */
+    apiKey: string;
+    /**
+     * Base URL for the Replicate API. Override for testing or proxy setups.
+     * @default 'https://api.replicate.com/v1'
+     */
+    baseURL?: string;
+    /**
+     * Default model to use for music generation.
+     * @default 'meta/musicgen'
+     */
+    defaultMusicModel?: string;
+    /**
+     * Default model to use for SFX generation.
+     * @default 'meta/audiogen'
+     */
+    defaultSfxModel?: string;
+    /**
+     * Milliseconds between prediction status polls.
+     * @default 5000
+     */
+    pollIntervalMs?: number;
+    /**
+     * Maximum milliseconds to wait for generation before timing out.
+     * @default 300000
+     */
+    timeoutMs?: number;
+}
+/**
+ * Audio generation provider connecting to the Replicate predictions API.
+ *
+ * Follows the same submit-then-poll pattern as {@link ReplicateVideoProvider}:
+ * create a prediction with `Prefer: wait=60`, then poll if the model takes
+ * longer than the wait window.
+ *
+ * Routes to different default models based on whether music or SFX is requested.
+ *
+ * @implements {IAudioGenerator}
+ *
+ * @example
+ * ```typescript
+ * const provider = new ReplicateAudioProvider();
+ * await provider.initialize({ apiKey: process.env.REPLICATE_API_TOKEN! });
+ *
+ * const music = await provider.generateMusic({
+ *   prompt: 'Upbeat indie rock with driving guitars',
+ * });
+ *
+ * const sfx = await provider.generateSFX({
+ *   prompt: 'Glass shattering on a hard floor',
+ * });
+ * ```
+ */
+export declare class ReplicateAudioProvider implements IAudioGenerator {
+    /** @inheritdoc */
+    readonly providerId = "replicate-audio";
+    /** @inheritdoc */
+    isInitialized: boolean;
+    /** @inheritdoc */
+    defaultModelId?: string;
+    /** Internal resolved configuration. */
+    private _config;
+    /**
+     * Initialize the provider with API credentials and optional configuration.
+     *
+     * @param config - Configuration object. Must include `apiKey`.
+     * @throws {Error} If `apiKey` is missing or empty.
+     */
+    initialize(config: Record<string, unknown>): Promise<void>;
+    /**
+     * Generate music from a text prompt using a music model on Replicate.
+     *
+     * @param request - Music generation request with prompt and optional params.
+     * @returns The generated audio result envelope.
+     *
+     * @throws {Error} If the provider is not initialized.
+     * @throws {Error} If the API returns an error or times out.
+     */
+    generateMusic(request: MusicGenerateRequest): Promise<AudioResult>;
+    /**
+     * Generate a sound effect from a text prompt using an SFX model on Replicate.
+     *
+     * @param request - SFX generation request with prompt and optional params.
+     * @returns The generated audio result envelope.
+     *
+     * @throws {Error} If the provider is not initialized.
+     * @throws {Error} If the API returns an error or times out.
+     */
+    generateSFX(request: SFXGenerateRequest): Promise<AudioResult>;
+    /**
+     * Replicate audio supports both music and SFX generation through
+     * different model routing.
+     *
+     * @param capability - The capability to check.
+     * @returns `true` for both `'music'` and `'sfx'`.
+     */
+    supports(capability: 'music' | 'sfx'): boolean;
+    /**
+     * Release any resources held by the provider. No-op for HTTP-only providers.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Create a prediction and wait for it to complete.
+     *
+     * Uses `Prefer: wait=60` to get synchronous completion for fast models.
+     * Falls back to polling if the prediction hasn't completed within the
+     * wait window.
+     *
+     * @param model - Model identifier (e.g. 'meta/musicgen').
+     * @param input - Model input parameters.
+     * @returns The completed prediction object.
+     *
+     * @throws {Error} If prediction creation fails, the prediction fails,
+     *   is canceled, or times out.
+     * @internal
+     */
+    private _runPrediction;
+    /**
+     * Create a new prediction via `POST /predictions`.
+     *
+     * @param model - Model identifier.
+     * @param input - Model input parameters.
+     * @returns The prediction response (may or may not be completed).
+     *
+     * @throws {Error} If the HTTP request fails.
+     * @internal
+     */
+    private _createPrediction;
+    /**
+     * Poll a prediction URL until it reaches a terminal state.
+     *
+     * @param url - The `prediction.urls.get` URL to poll.
+     * @returns The completed prediction object.
+     *
+     * @throws {Error} If polling fails or times out.
+     * @internal
+     */
+    private _pollPrediction;
+    /**
+     * Build an {@link AudioResult} from a completed Replicate prediction.
+     *
+     * @param prediction - The succeeded prediction object.
+     * @param model - Model ID used for the generation.
+     * @returns Normalized audio result envelope.
+     *
+     * @throws {Error} If no audio URL could be extracted from the output.
+     * @internal
+     */
+    private _buildResult;
+}
+//# sourceMappingURL=ReplicateAudioProvider.d.ts.map

package/dist/core/audio/providers/ReplicateAudioProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplicateAudioProvider.d.ts","sourceRoot":"","sources":["../../../../src/core/audio/providers/ReplicateAudioProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAMzF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmFD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,kBAAkB;IAClB,SAAgB,UAAU,qBAAqB;IAE/C,kBAAkB;IACX,aAAa,UAAS;IAE7B,kBAAkB;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IAE/B,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAiJ;IAMhK;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsChE;;;;;;;;OAQG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiBxE;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBpE;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO;IAI9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;;;;;;;;;;;;;OAcG;YACW,cAAc;IAyB5B;;;;;;;;;OASG;YACW,iBAAiB;IA2B/B;;;;;;;;OAQG;YACW,eAAe;IAgC7B;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;CAuBrB"}