/// Interface abstraite pour la reconnaissance vocale (Speech-to-Text).
/// Implémentations disponibles :
///   - SpeechToTextSttEngine (speech_to_text — Google on-device, gratuit)
///   - DeepgramSttEngine (Deepgram API — upgrade futur)
///   - WhisperSttEngine (whisper.cpp ou API OpenAI — upgrade futur)
abstract class SttEngine {
  /// Transcrit une commande vocale unique après le wake word.
  /// Retourne la transcription ou chaîne vide si timeout.
  Future<String> transcribeOnce({
    required String languageCode,
    Duration timeout = const Duration(seconds: 6),
  });

  Future<void> cancel();
}