namespace Deal.Ai.Llm;

/// <summary>
/// JSON-ключи wire-формата запросов и ответов ИИ-провайдеров
/// </summary>
public static class LlmWireKeys
{
    /// <summary>
    /// Ключ имени модели.
    /// </summary>
    public const string Model = "model";

    /// <summary>
    /// Ключ списка сообщений чата.
    /// </summary>
    public const string Messages = "messages";

    /// <summary>
    /// Ключ системного промпта (Anthropic — отдельным полем).
    /// </summary>
    public const string System = "system";

    /// <summary>
    /// Ключ температуры генерации (OpenAI-совместимый формат).
    /// </summary>
    public const string Temperature = "temperature";

    /// <summary>
    /// Ключ лимита токенов ответа.
    /// </summary>
    public const string MaxTokens = "max_tokens";

    /// <summary>
    /// Ключ списка вариантов ответа (OpenAI-совместимый формат).
    /// </summary>
    public const string Choices = "choices";

    /// <summary>
    /// Ключ выбранного варианта ответа (OpenAI-совместимый формат).
    /// </summary>
    public const string Message = "message";

    /// <summary>
    /// Ключ текстового содержимого.
    /// </summary>
    public const string Content = "content";

    /// <summary>
    /// Ключ текста рассуждений модели (reasoning).
    /// </summary>
    public const string ReasoningContent = "reasoning_content";

    /// <summary>
    /// Ключ оценки токенов вызова.
    /// </summary>
    public const string Usage = "usage";

    /// <summary>
    /// Ключ текста блока контента (Anthropic).
    /// </summary>
    public const string Text = "text";

    /// <summary>
    /// Ключ числа токенов запроса (OpenAI-совместимый формат).
    /// </summary>
    public const string PromptTokens = "prompt_tokens";

    /// <summary>
    /// Ключ числа токенов ответа (OpenAI-совместимый формат).
    /// </summary>
    public const string CompletionTokens = "completion_tokens";

    /// <summary>
    /// Ключ суммарного числа токенов (OpenAI-совместимый формат).
    /// </summary>
    public const string TotalTokens = "total_tokens";

    /// <summary>
    /// Ключ числа входных токенов (Anthropic).
    /// </summary>
    public const string InputTokens = "input_tokens";

    /// <summary>
    /// Ключ числа выходных токенов (Anthropic).
    /// </summary>
    public const string OutputTokens = "output_tokens";

    /// <summary>
    /// Ключ роли сообщения чата.
    /// </summary>
    public const string Role = "role";
}