qwencli

type Candidate struct {
	Index        int                    `json:"index"`                   // Индекс варианта ответа
	Message      QwenAPIResponseMessage `json:"message"`                 // Сообщение с ответом
	FinishReason string                 `json:"finish_reason,omitempty"` // Причина завершения генерации (stop, length, etc.)
}

type ClientOption func(*Config)

type Config struct {
	// ClientID - OAuth client ID для авторизации
	ClientID string

	// OAuthBaseURL - базовый URL для OAuth авторизации
	OAuthBaseURL string

	// TokenRefreshBuffer - буфер времени (в миллисекундах) для обновления токена до истечения
	TokenRefreshBuffer int64

	// CredentialsPath - путь к файлу с OAuth credentials
	CredentialsPath string

	// BaseURL - базовый URL для API запросов
	BaseURL string

	// DefaultModel - модель по умолчанию для генерации
	DefaultModel string

	// Timeout - таймаут для HTTP запросов
	Timeout time.Duration

	// Logger - интерфейс логгера для вывода сообщений
	Logger Logger

	// EnableBackgroundRefresh - включить фоновое обновление токенов
	EnableBackgroundRefresh bool

	// RefreshCheckInterval - интервал проверки токенов для фонового обновления
	RefreshCheckInterval time.Duration
}

type Content struct {
	Role  string `json:"role"`  // Роль отправителя сообщения (user, assistant, system)
	Parts []Part `json:"parts"` // Части сообщения (текст или медиа контент)
}

type DefaultLogger struct {
	// EnableDebug - включить отладочные сообщения
	EnableDebug bool
	// contains filtered or unexported fields
}

type DeviceAuthorizationResponse struct {
	DeviceCode              string `json:"device_code"`
	UserCode                string `json:"user_code"`
	VerificationURI         string `json:"verification_uri"`
	VerificationURIComplete string `json:"verification_uri_complete"`
	ExpiresIn               int    `json:"expires_in"`
	Interval                int    `json:"interval"`
}

type DeviceTokenResponse struct {
	AccessToken  string `json:"access_token"`
	RefreshToken string `json:"refresh_token"`
	TokenType    string `json:"token_type"`
	ExpiresIn    int64  `json:"expires_in"`
	ResourceURL  string `json:"resource_url"`
}

type GenerationConfig struct {
	Temperature     float64 `json:"temperature,omitempty"`     // Температура генерации (0.0-1.0), контролирует случайность
	MaxOutputTokens int     `json:"maxOutputTokens,omitempty"` // Максимальное количество токенов в ответе
	TopP            float64 `json:"topP,omitempty"`            // Nucleus sampling параметр
	TopK            int     `json:"topK,omitempty"`            // Top-K sampling параметр
}

type ImageData struct {
	MimeType string // MIME тип изображения
	Data     string // Данные изображения в base64
}

type InlineData struct {
	MimeType string `json:"mimeType"` // MIME тип данных (например, "image/png")
	Data     string `json:"data"`     // Данные в base64 кодировке
}

type Logger interface {
	// Debug выводит отладочное сообщение
	Debug(msg string, args ...interface{})

	// Info выводит информационное сообщение
	Info(msg string, args ...interface{})

	// Warn выводит предупреждающее сообщение
	Warn(msg string, args ...interface{})

	// Error выводит сообщение об ошибке
	Error(msg string, args ...interface{})
}

type Message struct {
	Role    string           `json:"role"`    // Роль отправителя: "user", "assistant" или "system"
	Content []MessageContent `json:"content"` // Массив содержимого сообщения, может содержать текст и/или изображения
}

type MessageContent struct {
	Type     string `json:"type"`           // Тип содержимого: "text" или "image_url"
	Text     string `json:"text,omitempty"` // Текстовое содержимое (используется при Type="text")
	ImageURL struct {
		URL string `json:"url"` // URL изображения в формате data:image/... (используется при Type="image_url")
	} `json:"image_url,omitempty"`
}

type NoOpLogger struct{}

type OAuthCredentials struct {
	AccessToken  string `json:"access_token"`           // Токен доступа для API запросов
	RefreshToken string `json:"refresh_token"`          // Токен для обновления access token
	TokenType    string `json:"token_type"`             // Тип токена (обычно "Bearer")
	ExpiryDate   int64  `json:"expiry_date"`            // Время истечения токена в миллисекундах (Unix timestamp * 1000)
	ResourceURL  string `json:"resource_url,omitempty"` // Базовый URL для API запросов
}

type OauthConfig struct {
	OauthClientId     string `json:"oauthClientId"`     // Идентификатор OAuth клиента
	OauthClientSecret string `json:"oauthClientSecret"` // Секрет OAuth клиента
}

type OnboardUserRequest struct {
	TierId   string `json:"tierId"`  // Идентификатор уровня доступа
	Project  string `json:"project"` // Идентификатор проекта
	Metadata struct {
		IdeType     string `json:"ideType"`     // Тип IDE
		Platform    string `json:"platform"`    // Платформа
		PluginType  string `json:"pluginType"`  // Тип плагина
		DuetProject string `json:"duetProject"` // Проект Duet
	} `json:"metadata"`
}

type OnboardUserResponse struct {
	Done     bool `json:"done"` // Флаг завершения операции
	Response struct {
		Project struct {
			Id string `json:"id"` // Идентификатор созданного проекта
		} `json:"project"`
	} `json:"response"`
}

type Part struct {
	Text       string      `json:"text,omitempty"`       // Текстовое содержимое
	InlineData *InlineData `json:"inlineData,omitempty"` // Встроенные данные (изображения, файлы)
}

type ProjectDiscoveryRequest struct {
	Project  string `json:"project"` // Идентификатор проекта
	Metadata struct {
		IdeType     string `json:"ideType"`     // Тип IDE
		Platform    string `json:"platform"`    // Платформа
		PluginType  string `json:"pluginType"`  // Тип плагина
		DuetProject string `json:"duetProject"` // Проект Duet
	} `json:"metadata"`
}

type ProjectDiscoveryResponse struct {
	Project      interface{} `json:"project"` // Информация о проекте
	AllowedTiers []struct {
		Id        string `json:"id"`        // Идентификатор уровня
		IsDefault bool   `json:"isDefault"` // Является ли уровень по умолчанию
	} `json:"allowedTiers"` // Доступные уровни доступа
}

type QwenAPIResponseMessage struct {
	Role    string `json:"role"`    // Роль отправителя (обычно "assistant")
	Content string `json:"content"` // Сгенерированный текст
}

type QwenAuthenticator struct {
	// contains filtered or unexported fields
}

type QwenChatCompletionRequest struct {
	Model          string             `json:"model"`                     // Название модели (ModelQwen3CoderPlus или ModelQwen3CoderFlash)
	Messages       []Message          `json:"messages"`                  // Массив сообщений в диалоге
	Temperature    float64            `json:"temperature,omitempty"`     // Температура генерации (0.0-2.0)
	MaxTokens      int                `json:"max_tokens,omitempty"`      // Максимальное количество токенов в ответе
	Stream         bool               `json:"stream,omitempty"`          // Включить потоковую передачу ответа
	StreamOptions  *QwenStreamOptions `json:"stream_options,omitempty"`  // Опции для потоковой передачи
	TopP           float64            `json:"top_p,omitempty"`           // Nucleus sampling параметр
	TopK           int                `json:"top_k,omitempty"`           // Top-K sampling параметр
	SafetySettings []SafetySetting    `json:"safety_settings,omitempty"` // Настройки безопасности контента
	Tools          interface{}        `json:"tools,omitempty"`           // Определения инструментов для function calling
	ToolChoice     interface{}        `json:"tool_choice,omitempty"`     // Выбор использования инструментов
}

type QwenChatCompletionResponse struct {
	Id                string        `json:"id"`                           // Уникальный идентификатор запроса
	Object            string        `json:"object"`                       // Тип объекта (обычно "chat.completion")
	Created           int64         `json:"created"`                      // Время создания в Unix timestamp
	Model             string        `json:"model"`                        // Использованная модель
	Choices           []QwenChoice  `json:"choices"`                      // Массив вариантов ответов
	Usage             UsageMetadata `json:"usage,omitempty"`              // Статистика использования токенов
	SystemFingerprint string        `json:"system_fingerprint,omitempty"` // Fingerprint системы
}

type QwenChatCompletionStreamChoice struct {
	Index        int                    `json:"index"`         // Индекс варианта
	Delta        QwenAPIResponseMessage `json:"delta"`         // Дельта (частичное содержимое)
	FinishReason *string                `json:"finish_reason"` // Причина завершения (null до последнего чанка)
}

type QwenChatCompletionStreamResponse struct {
	Id                string                           `json:"id"`                           // Уникальный идентификатор запроса
	Object            string                           `json:"object"`                       // Тип объекта ("chat.completion.chunk")
	Created           int64                            `json:"created"`                      // Время создания в Unix timestamp
	Model             string                           `json:"model"`                        // Использованная модель
	Choices           []QwenChatCompletionStreamChoice `json:"choices"`                      // Массив вариантов с частичными ответами
	Usage             *UsageMetadata                   `json:"usage,omitempty"`              // Статистика использования (в финальном чанке)
	SystemFingerprint string                           `json:"system_fingerprint,omitempty"` // Fingerprint системы
}

type QwenChoice struct {
	Index        int                    `json:"index"`         // Индекс варианта
	Message      QwenAPIResponseMessage `json:"message"`       // Сообщение с ответом
	FinishReason string                 `json:"finish_reason"` // Причина завершения (stop, length, tool_calls, etc.)
}

type QwenClient struct {
	// contains filtered or unexported fields
}

type QwenResponse struct {
	Candidates    []Candidate   `json:"choices"`         // Варианты ответов от модели
	UsageMetadata UsageMetadata `json:"usage,omitempty"` // Метаданные использования токенов
}

type QwenStreamOptions struct {
	IncludeUsage bool `json:"include_usage,omitempty"` // Включить информацию об использовании токенов в поток
}

type SafetySetting struct {
	Category  string `json:"category"`  // Категория безопасности
	Threshold string `json:"threshold"` // Порог фильтрации
}

type SimpleLogger struct{}

type TokenRefresher struct {
	// contains filtered or unexported fields
}

type UsageMetadata struct {
	PromptTokens     int `json:"prompt_tokens"`     // Количество токенов в промпте
	CompletionTokens int `json:"completion_tokens"` // Количество токенов в ответе
	TotalTokens      int `json:"total_tokens"`      // Общее количество токенов
}