namespace Deal.Ai.Llm;

/// <summary>
/// Абстракция одного HTTP-вызова LLM-провайдера.
/// </summary>
public interface IProviderClient
{
    /// <summary>
    /// Выполняет один вызов модели по системному и пользовательскому сообщениям.
    /// </summary>
    /// <param name="config">Конфиг активного провайдера (стиль API выбирается по <c>ApiStyle</c>).</param>
    /// <param name="systemPrompt">Системный промпт (заполненный ядром либо фиксированный сервиса).</param>
    /// <param name="userText">Пользовательское сообщение/контекст.</param>
    /// <returns>Текст ответа модели и usage API-ответа (null — провайдер usage не вернул).</returns>
    public Task<ProviderChatResult> ChatAsync(
        LlmConfig config,
        string systemPrompt,
        string userText,
        CancellationToken cancellationToken);
}