namespace Hush.Providers.Interfaces;

/// <summary>
/// Interface for audio-to-text transcription functionality.
/// </summary>
public interface IAudioToTextProvider
{
    /// <summary>
    /// Transcribes audio from a stream to text.
    /// </summary>
    /// <param name="audioStream">The audio stream to transcribe</param>
    /// <param name="modelName">The model name to use for transcription (e.g., whisper-large-v3)</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>The transcribed text</returns>
    Task<string> TranscribeAsync(
        Stream audioStream,
        string modelName,
        string? language = null,
        CancellationToken cancellationToken = default);
}