/**
 * How background audio is combined with agent speech.
 * - `'playback'`: play the file on its own.
 * - `'mixing'`: mix the file underneath the agent's audio.
 */
export type BackgroundAudioMode = 'playback' | 'mixing';
/** Options for {@link BackgroundAudioHandlerConfig}. */
export type BackgroundAudioHandlerConfigOptions = {
    /** Path to the audio file to play. Default: `''`. */
    file?: string;
    /** Playback volume multiplier, where 1.0 is the original level. Default: `1.0`. */
    volume?: number;
    /** Whether to loop the file continuously. Default: `false`. */
    looping?: boolean;
    /** Whether background audio is active. Default: `true`. */
    enabled?: boolean;
    /** Playback vs. mixing behavior. Default: `'mixing'`. */
    mode?: BackgroundAudioMode;
    /** Number of audio samples per processing chunk. Default: `320`. */
    chunkSize?: number;
};
declare class BackgroundAudioHandlerConfigImpl {
    file: string;
    volume: number;
    looping: boolean;
    enabled: boolean;
    mode: BackgroundAudioMode;
    chunkSize: number;
    constructor(opts?: BackgroundAudioHandlerConfigOptions);
}
/** Configuration for background audio played during a session. */
export type BackgroundAudioHandlerConfig = BackgroundAudioHandlerConfigImpl;
/**
 * Create a {@link BackgroundAudioHandlerConfig}.
 * @throws Error if `mode` is not `'playback'` or `'mixing'`.
 */
export declare const BackgroundAudioHandlerConfig: (opts?: BackgroundAudioHandlerConfigOptions) => BackgroundAudioHandlerConfig;
export {};