providerbase

type BaseCapabilityProvider struct {
	ProviderName string
	Client       *http.Client
	BaseURL      string
	APIKey       string
	Model        string
	BuildHeaders HeaderFunc
}

type CapabilityConfig struct {
	Name         string
	BaseURL      string
	APIKey       string
	Model        string
	Timeout      time.Duration
	BuildHeaders HeaderFunc
}

type CompletionTokensDetails struct {
	ReasoningTokens          int `json:"reasoning_tokens"`
	AudioTokens              int `json:"audio_tokens,omitempty"`
	AcceptedPredictionTokens int `json:"accepted_prediction_tokens,omitempty"`
	RejectedPredictionTokens int `json:"rejected_prediction_tokens,omitempty"`
}

type HeaderFunc func(r *http.Request, apiKey string)

type NormalizedToolChoice struct {
	Mode                     string
	SpecificName             string
	AllowedFunctionNames     []string
	DisableParallelToolUse   *bool
	IncludeServerSideToolUse *bool
}

type OpenAIAnnotation struct {
	Type        string             `json:"type"` // "url_citation"
	URLCitation *URLCitationDetail `json:"url_citation,omitempty"`
}

type OpenAICompatChoice struct {
	Index        int                  `json:"index"`
	FinishReason string               `json:"finish_reason"`
	Message      OpenAICompatMessage  `json:"message"`
	Delta        *OpenAICompatMessage `json:"delta,omitempty"`
}

type OpenAICompatCustomCall struct {
	Name  string `json:"name"`
	Input string `json:"input,omitempty"`
}

type OpenAICompatCustomTool struct {
	Name        string            `json:"name"`
	Description string            `json:"description,omitempty"`
	Format      *types.ToolFormat `json:"format,omitempty"`
}

type OpenAICompatErrorResp struct {
	Error struct {
		Message string `json:"message"`
		Type    string `json:"type"`
		Code    any    `json:"code"`
		Param   string `json:"param"`
	} `json:"error"`
}

type OpenAICompatFunction struct {
	Name        string          `json:"name"`
	Description string          `json:"description,omitempty"`
	Parameters  json.RawMessage `json:"parameters,omitempty"`
	Strict      *bool           `json:"strict,omitempty"`
	Arguments   json.RawMessage `json:"arguments,omitempty"`
}

type OpenAICompatMessage struct {
	Role             string                 `json:"role"`
	Content          string                 `json:"content,omitempty"`
	ReasoningContent *string                `json:"reasoning_content,omitempty"` // 推理内容
	Refusal          *string                `json:"refusal,omitempty"`           // 模型拒绝内容
	MultiContent     []map[string]any       `json:"multi_content,omitempty"`     // multimodal content parts
	Name             string                 `json:"name,omitempty"`
	ToolCalls        []OpenAICompatToolCall `json:"tool_calls,omitempty"`
	ToolCallID       string                 `json:"tool_call_id,omitempty"`
	Annotations      []OpenAIAnnotation     `json:"annotations,omitempty"` // URL 引用
}

type OpenAICompatRequest struct {
	Model               string                `json:"model"`
	Messages            []OpenAICompatMessage `json:"messages"`
	Tools               []OpenAICompatTool    `json:"tools,omitempty"`
	ToolChoice          any                   `json:"tool_choice,omitempty"`
	ResponseFormat      any                   `json:"response_format,omitempty"`
	MaxTokens           int                   `json:"max_tokens,omitempty"`
	Temperature         float32               `json:"temperature,omitempty"`
	TopP                float32               `json:"top_p,omitempty"`
	Stop                []string              `json:"stop,omitempty"`
	Stream              bool                  `json:"stream,omitempty"`
	FrequencyPenalty    *float32              `json:"frequency_penalty,omitempty"`
	PresencePenalty     *float32              `json:"presence_penalty,omitempty"`
	RepetitionPenalty   *float32              `json:"repetition_penalty,omitempty"`
	N                   *int                  `json:"n,omitempty"`
	LogProbs            *bool                 `json:"logprobs,omitempty"`
	TopLogProbs         *int                  `json:"top_logprobs,omitempty"`
	ParallelToolCalls   *bool                 `json:"parallel_tool_calls,omitempty"`
	ServiceTier         *string               `json:"service_tier,omitempty"`
	StreamOptions       *StreamOptions        `json:"stream_options,omitempty"`
	User                string                `json:"user,omitempty"`
	Thinking            *Thinking             `json:"thinking,omitempty"`
	MaxCompletionTokens *int                  `json:"max_completion_tokens,omitempty"`
	ReasoningEffort     *string               `json:"reasoning_effort,omitempty"`

	// 新增 OpenAI 扩展字段
	Store                *bool             `json:"store,omitempty"`                  // 是否存储用于蒸馏/评估
	Modalities           []string          `json:"modalities,omitempty"`             // ["text", "audio"]
	WebSearchOptions     *WebSearchOptions `json:"web_search_options,omitempty"`     // 内置 web 搜索
	Metadata             map[string]string `json:"metadata,omitempty"`               // OpenAI 级别元数据
	PromptCacheKey       string            `json:"prompt_cache_key,omitempty"`       // prompt cache routing key
	PromptCacheRetention string            `json:"prompt_cache_retention,omitempty"` // prompt cache retention policy

	// Responses API 扩展字段
	PreviousResponseID string   `json:"previous_response_id,omitempty"` // 连续对话上下文 ID
	ConversationID     string   `json:"conversation_id,omitempty"`      // OpenAI server-managed conversation ID
	Include            []string `json:"include,omitempty"`              // include 字段
	Truncation         string   `json:"truncation,omitempty"`           // auto/disabled
}

type OpenAICompatResponse struct {
	ID          string               `json:"id"`
	Model       string               `json:"model"`
	Choices     []OpenAICompatChoice `json:"choices"`
	Usage       *OpenAICompatUsage   `json:"usage,omitempty"`
	Created     int64                `json:"created,omitempty"`
	ServiceTier string               `json:"service_tier,omitempty"`
}

type OpenAICompatTool struct {
	Type     string                  `json:"type"`
	Function *OpenAICompatFunction   `json:"function,omitempty"`
	Custom   *OpenAICompatCustomTool `json:"custom,omitempty"`
}

type OpenAICompatToolCall struct {
	Index    int                     `json:"index"`
	ID       string                  `json:"id"`
	Type     string                  `json:"type"`
	Function *OpenAICompatFunction   `json:"function,omitempty"`
	Custom   *OpenAICompatCustomCall `json:"custom,omitempty"`
}

type OpenAICompatUsage struct {
	PromptTokens            int                      `json:"prompt_tokens"`
	CompletionTokens        int                      `json:"completion_tokens"`
	TotalTokens             int                      `json:"total_tokens"`
	PromptTokensDetails     *PromptTokensDetails     `json:"prompt_tokens_details,omitempty"`
	CompletionTokensDetails *CompletionTokensDetails `json:"completion_tokens_details,omitempty"`
}

type PromptTokensDetails struct {
	CachedTokens int `json:"cached_tokens"`
	AudioTokens  int `json:"audio_tokens,omitempty"`
}

type StreamOptions struct {
	IncludeUsage      bool `json:"include_usage,omitempty"`
	ChunkIncludeUsage bool `json:"chunk_include_usage,omitempty"`
}

type Thinking struct {
	Type string `json:"type"` // "enabled", "disabled", "auto"
}

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

type ToolOutputWriteback struct {
	ToolType string
	CallID   string
	Name     string
	Content  string
	IsError  bool
}

type URLCitationDetail struct {
	StartIndex int    `json:"start_index"`
	EndIndex   int    `json:"end_index"`
	URL        string `json:"url"`
	Title      string `json:"title"`
}

type WebSearchApproxLocation struct {
	Country  string `json:"country,omitempty"`
	Region   string `json:"region,omitempty"`
	City     string `json:"city,omitempty"`
	Timezone string `json:"timezone,omitempty"`
}

type WebSearchOptions struct {
	UserLocation      *WebSearchUserLocation `json:"user_location,omitempty"`
	SearchContextSize string                 `json:"search_context_size,omitempty"` // low/medium/high
}

type WebSearchUserLocation struct {
	Type        string                   `json:"type"` // "approximate"
	Approximate *WebSearchApproxLocation `json:"approximate,omitempty"`
}