@framers/agentos 0.1.126 → 0.1.127

package/dist/media/ProviderPreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderPreferences.d.ts","sourceRoot":"","sources":["../../src/media/ProviderPreferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,oEAAoE;IACpE,KAAK,CAAC,EAAE;QACN,6CAA6C;QAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,oDAAoD;QACpD,GAAG,CAAC,EAAE,uBAAuB,CAAC;KAC/B,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,CAAC,EAAE,uBAAuB,GACpC,MAAM,EAAE,CAuBV;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,CAAC,EAAE,uBAAuB,GACpC,MAAM,EAAE,CAQV;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAqCR"}

package/dist/media/ProviderPreferences.js.map

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

package/dist/media/audio/FallbackAudioProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FallbackAudioProxy.d.ts","sourceRoot":"","sources":["../../../src/media/audio/FallbackAudioProxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMxF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,IAAI,EAAE,yBAAyB,CAAC;IAChC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;AAkBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IA2BtD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3B1B,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAQ;IAEvC,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;;;;;;;;;OAeG;gBAEgB,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,EAAE,YAAY;IAUxC;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO;IAQ9C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBxE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBpE;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B;;;;;;;;;;;;OAYG;YACW,eAAe;CA6C9B"}

package/dist/media/audio/FallbackAudioProxy.js.map

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

package/dist/media/audio/IAudioGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudioGenerator.d.ts","sourceRoot":"","sources":["../../../src/media/audio/IAudioGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnE;;;;;;;;;OASG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

package/dist/media/audio/IAudioGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudioGenerator.js","sourceRoot":"","sources":["../../../src/media/audio/IAudioGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/media/audio/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file index.ts
+ * Barrel export for the audio generation subsystem.
+ *
+ * Re-exports all public types, interfaces, and the fallback proxy so
+ * consumers can import from `@agentos/media/audio` (or the relative path)
+ * without reaching into individual files.
+ *
+ * Audio processing utilities (AdaptiveVAD, SilenceDetector, etc.) have
+ * moved to the `hearing/` module.
+ *
+ * Also provides a provider factory registry (modelled on the video
+ * subsystem's pattern) so that built-in and third-party audio providers
+ * can be registered and instantiated by provider ID.
+ */
+import type { IAudioGenerator } from './IAudioGenerator.js';
+export * from './types.js';
+export * from './IAudioGenerator.js';
+export * from './FallbackAudioProxy.js';
+/** A factory function that creates an uninitialised audio provider instance. */
+export type AudioProviderFactory = () => IAudioGenerator;
+/**
+ * Register an audio provider factory for a given provider ID.
+ *
+ * Use this to add third-party or custom audio providers at runtime.
+ * Built-in providers (suno, udio, stable-audio, elevenlabs-sfx,
+ * musicgen-local, audiogen-local, replicate-audio, fal-audio) are
+ * pre-registered.
+ *
+ * @param providerId - Unique identifier for the provider (lowercased for matching).
+ * @param factory - Factory function that creates a new uninitialised provider instance.
+ */
+export declare function registerAudioProviderFactory(providerId: string, factory: AudioProviderFactory): void;
+/**
+ * Create an audio provider instance by provider ID.
+ *
+ * Looks up the factory in the registry and returns a new uninitialised
+ * provider. The caller must call `provider.initialize(config)` before use.
+ *
+ * @param providerId - Provider identifier (e.g. `"suno"`, `"stable-audio"`, `"elevenlabs-sfx"`).
+ * @returns A new uninitialised {@link IAudioGenerator} instance.
+ * @throws {Error} When no factory is registered for the given provider ID.
+ */
+export declare function createAudioProvider(providerId: string): IAudioGenerator;
+/**
+ * Check whether an audio provider factory is registered for the given ID.
+ *
+ * @param providerId - Provider identifier to check.
+ * @returns `true` if a factory exists for this provider.
+ */
+export declare function hasAudioProviderFactory(providerId: string): boolean;
+/**
+ * List all registered audio provider factory IDs, sorted alphabetically.
+ *
+ * @returns Sorted array of registered provider identifiers.
+ */
+export declare function listAudioProviderFactories(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/media/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAa5D,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAMxC,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,MAAM,eAAe,CAAC;AAmBzD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD"}

package/dist/media/audio/index.js

@@ -0,0 +1,94 @@
+/**
+ * @file index.ts
+ * Barrel export for the audio generation subsystem.
+ *
+ * Re-exports all public types, interfaces, and the fallback proxy so
+ * consumers can import from `@agentos/media/audio` (or the relative path)
+ * without reaching into individual files.
+ *
+ * Audio processing utilities (AdaptiveVAD, SilenceDetector, etc.) have
+ * moved to the `hearing/` module.
+ *
+ * Also provides a provider factory registry (modelled on the video
+ * subsystem's pattern) so that built-in and third-party audio providers
+ * can be registered and instantiated by provider ID.
+ */
+import { AudioGenLocalProvider } from './providers/AudioGenLocalProvider.js';
+import { ElevenLabsSFXProvider } from './providers/ElevenLabsSFXProvider.js';
+import { FalAudioProvider } from './providers/FalAudioProvider.js';
+import { MusicGenLocalProvider } from './providers/MusicGenLocalProvider.js';
+import { ReplicateAudioProvider } from './providers/ReplicateAudioProvider.js';
+import { StableAudioProvider } from './providers/StableAudioProvider.js';
+import { SunoProvider } from './providers/SunoProvider.js';
+import { UdioProvider } from './providers/UdioProvider.js';
+// ---------------------------------------------------------------------------
+// Audio generation (types, interface, fallback proxy)
+// ---------------------------------------------------------------------------
+export * from './types.js';
+export * from './IAudioGenerator.js';
+export * from './FallbackAudioProxy.js';
+/**
+ * Internal registry mapping provider IDs to provider constructors.
+ *
+ * Built-in providers are pre-registered here so the public
+ * `createAudioProvider()` API remains synchronous and ESM-safe.
+ */
+const audioProviderFactories = new Map([
+    ['suno', () => new SunoProvider()],
+    ['udio', () => new UdioProvider()],
+    ['stable-audio', () => new StableAudioProvider()],
+    ['elevenlabs-sfx', () => new ElevenLabsSFXProvider()],
+    ['musicgen-local', () => new MusicGenLocalProvider()],
+    ['audiogen-local', () => new AudioGenLocalProvider()],
+    ['replicate-audio', () => new ReplicateAudioProvider()],
+    ['fal-audio', () => new FalAudioProvider()],
+]);
+/**
+ * Register an audio provider factory for a given provider ID.
+ *
+ * Use this to add third-party or custom audio providers at runtime.
+ * Built-in providers (suno, udio, stable-audio, elevenlabs-sfx,
+ * musicgen-local, audiogen-local, replicate-audio, fal-audio) are
+ * pre-registered.
+ *
+ * @param providerId - Unique identifier for the provider (lowercased for matching).
+ * @param factory - Factory function that creates a new uninitialised provider instance.
+ */
+export function registerAudioProviderFactory(providerId, factory) {
+    audioProviderFactories.set(providerId.toLowerCase(), factory);
+}
+/**
+ * Create an audio provider instance by provider ID.
+ *
+ * Looks up the factory in the registry and returns a new uninitialised
+ * provider. The caller must call `provider.initialize(config)` before use.
+ *
+ * @param providerId - Provider identifier (e.g. `"suno"`, `"stable-audio"`, `"elevenlabs-sfx"`).
+ * @returns A new uninitialised {@link IAudioGenerator} instance.
+ * @throws {Error} When no factory is registered for the given provider ID.
+ */
+export function createAudioProvider(providerId) {
+    const factory = audioProviderFactories.get(providerId.toLowerCase());
+    if (!factory) {
+        throw new Error(`Audio generation is not supported for provider "${providerId}".`);
+    }
+    return factory();
+}
+/**
+ * Check whether an audio provider factory is registered for the given ID.
+ *
+ * @param providerId - Provider identifier to check.
+ * @returns `true` if a factory exists for this provider.
+ */
+export function hasAudioProviderFactory(providerId) {
+    return audioProviderFactories.has(providerId.toLowerCase());
+}
+/**
+ * List all registered audio provider factory IDs, sorted alphabetically.
+ *
+ * @returns Sorted array of registered provider identifiers.
+ */
+export function listAudioProviderFactories() {
+    return Array.from(audioProviderFactories.keys()).sort();
+}
+//# sourceMappingURL=index.js.map

package/dist/media/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAC9E,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AASxC;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAA+B;IACnE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;IAClC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;IAClC,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;IACjD,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC;IACrD,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC;IACrD,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE,CAAC;IACrD,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,sBAAsB,EAAE,CAAC;IACvD,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;CAC5C,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAkB,EAClB,OAA6B;IAE7B,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,UAAU,IAAI,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,OAAO,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC"}

package/dist/media/audio/providers/AudioGenLocalProvider.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @module media/audio/providers/AudioGenLocalProvider
+ *
+ * Local sound effect generation provider using Meta's AudioGen model via
+ * the `@huggingface/transformers` library.
+ *
+ * AudioGen 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/audiogen-medium ~2GB).
+ *
+ * ## Supported models
+ *
+ * | Model ID                    | Description                        |
+ * |-----------------------------|------------------------------------|
+ * | `Xenova/audiogen-medium`    | AudioGen Medium — default, ~2GB    |
+ *
+ * ## 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 MusicGenLocalProvider} for the music counterpart.
+ */
+import type { IAudioGenerator } from '../IAudioGenerator.js';
+import type { MusicGenerateRequest, SFXGenerateRequest, AudioResult } from '../types.js';
+/**
+ * Configuration for the AudioGen local provider.
+ *
+ * @example
+ * ```typescript
+ * const config: AudioGenLocalProviderConfig = {
+ *   modelId: 'Xenova/audiogen-medium',
+ * };
+ * ```
+ */
+export interface AudioGenLocalProviderConfig {
+    /**
+     * HuggingFace model ID for the AudioGen model.
+     * @default 'Xenova/audiogen-medium'
+     */
+    modelId?: string;
+}
+/**
+ * Local sound effect generation provider using Meta's AudioGen model.
+ *
+ * Runs inference entirely on the local machine via `@huggingface/transformers`.
+ * The model is loaded lazily on first call to `generateSFX()` or
+ * explicitly via `initialize()`.
+ *
+ * @implements {IAudioGenerator}
+ *
+ * @example
+ * ```typescript
+ * const provider = new AudioGenLocalProvider();
+ * await provider.initialize({ modelId: 'Xenova/audiogen-medium' });
+ *
+ * const result = await provider.generateSFX({
+ *   prompt: 'Dog barking loudly in a park',
+ *   durationSec: 5,
+ * });
+ * console.log(result.audio[0].base64?.substring(0, 50) + '...');
+ * ```
+ */
+export declare class AudioGenLocalProvider implements IAudioGenerator {
+    /** @inheritdoc */
+    readonly providerId = "audiogen-local";
+    /** @inheritdoc */
+    isInitialized: boolean;
+    /** @inheritdoc */
+    defaultModelId?: string;
+    /** The loaded text-to-audio pipeline instance. */
+    private _pipeline;
+    /** The resolved model ID. */
+    private _modelId;
+    /**
+     * 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`.
+     */
+    initialize(config: Record<string, unknown>): Promise<void>;
+    /**
+     * Music generation is not supported by AudioGen.
+     *
+     * @throws {Error} Always throws — use {@link MusicGenLocalProvider} instead.
+     */
+    generateMusic(_request: MusicGenerateRequest): Promise<AudioResult>;
+    /**
+     * Generate a sound effect from a text prompt using the local AudioGen model.
+     *
+     * On first call, loads the model pipeline (may take several seconds).
+     * Subsequent calls reuse the cached pipeline instance.
+     *
+     * @param request - SFX 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.
+     */
+    generateSFX(request: SFXGenerateRequest): Promise<AudioResult>;
+    /**
+     * AudioGen supports SFX generation only.
+     *
+     * @param capability - The capability to check.
+     * @returns `true` only for `'sfx'`; `false` for `'music'`.
+     */
+    supports(capability: 'music' | 'sfx'): boolean;
+    /**
+     * Release model resources and reset initialization state.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * 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
+     */
+    private _ensurePipeline;
+}
+//# sourceMappingURL=AudioGenLocalProvider.d.ts.map

package/dist/media/audio/providers/AudioGenLocalProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioGenLocalProvider.d.ts","sourceRoot":"","sources":["../../../../src/media/audio/providers/AudioGenLocalProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAMzF;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4DD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,kBAAkB;IAClB,SAAgB,UAAU,oBAAoB;IAE9C,kBAAkB;IACX,aAAa,UAAS;IAE7B,kBAAkB;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IAE/B,kDAAkD;IAClD,OAAO,CAAC,SAAS,CAAiB;IAElC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAA4B;IAM5C;;;;;;;;OAQG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAMzE;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IA0CpE;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO;IAI9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;;;;;;;;;OAUG;YACW,eAAe;CAgB9B"}

package/dist/media/audio/providers/AudioGenLocalProvider.js

@@ -0,0 +1,235 @@
+/**
+ * @module media/audio/providers/AudioGenLocalProvider
+ *
+ * Local sound effect generation provider using Meta's AudioGen model via
+ * the `@huggingface/transformers` library.
+ *
+ * AudioGen 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/audiogen-medium ~2GB).
+ *
+ * ## Supported models
+ *
+ * | Model ID                    | Description                        |
+ * |-----------------------------|------------------------------------|
+ * | `Xenova/audiogen-medium`    | AudioGen Medium — default, ~2GB    |
+ *
+ * ## 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 MusicGenLocalProvider} for the music 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. 16000).
+ * @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 sound effect generation provider using Meta's AudioGen model.
+ *
+ * Runs inference entirely on the local machine via `@huggingface/transformers`.
+ * The model is loaded lazily on first call to `generateSFX()` or
+ * explicitly via `initialize()`.
+ *
+ * @implements {IAudioGenerator}
+ *
+ * @example
+ * ```typescript
+ * const provider = new AudioGenLocalProvider();
+ * await provider.initialize({ modelId: 'Xenova/audiogen-medium' });
+ *
+ * const result = await provider.generateSFX({
+ *   prompt: 'Dog barking loudly in a park',
+ *   durationSec: 5,
+ * });
+ * console.log(result.audio[0].base64?.substring(0, 50) + '...');
+ * ```
+ */
+export class AudioGenLocalProvider {
+    constructor() {
+        /** @inheritdoc */
+        this.providerId = 'audiogen-local';
+        /** @inheritdoc */
+        this.isInitialized = false;
+        /** The loaded text-to-audio pipeline instance. */
+        this._pipeline = null;
+        /** The resolved model ID. */
+        this._modelId = 'Xenova/audiogen-medium';
+    }
+    // -------------------------------------------------------------------------
+    // 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
+    // -------------------------------------------------------------------------
+    /**
+     * Music generation is not supported by AudioGen.
+     *
+     * @throws {Error} Always throws — use {@link MusicGenLocalProvider} instead.
+     */
+    async generateMusic(_request) {
+        throw new Error('AudioGen local provider does not support music generation. Use MusicGenLocalProvider instead.');
+    }
+    /**
+     * Generate a sound effect from a text prompt using the local AudioGen model.
+     *
+     * On first call, loads the model pipeline (may take several seconds).
+     * Subsequent calls reuse the cached pipeline instance.
+     *
+     * @param request - SFX 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 generateSFX(request) {
+        if (!this.isInitialized) {
+            throw new Error('AudioGen 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. AudioGen generates at ~50 tokens/second.
+        const durationSec = request.durationSec ?? 5;
+        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,
+            },
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Capability query
+    // -------------------------------------------------------------------------
+    /**
+     * AudioGen supports SFX generation only.
+     *
+     * @param capability - The capability to check.
+     * @returns `true` only for `'sfx'`; `false` for `'music'`.
+     */
+    supports(capability) {
+        return capability === 'sfx';
+    }
+    /**
+     * 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('AudioGen 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=AudioGenLocalProvider.js.map

package/dist/media/audio/providers/AudioGenLocalProvider.js.map

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