model

type Anthropic struct {
	BaseURL   string
	APIKey    string
	Model     string
	MaxTokens int          // defaults to DefaultAnthropicMaxTokens
	OnText    func(string) // if set, stream and report text deltas
	// ReasoningEffort, if set, is sent as output_config.effort.
	ReasoningEffort string
	// Headers, if set, are added to every request after the defaults
	// (configured providers).
	Headers map[string]string
	// Price, if set, replaces the Prices table entry for this model
	// (configured providers); PriceOverride still wins.
	Price *[3]float64
	// OmitEmptyKey sends no x-api-key header when APIKey is empty
	// (configured providers without api_key_env).
	OmitEmptyKey bool
}

type Codex struct {
	BaseURL  string
	TokenURL string
	AuthFile string
	Model    string
	OnText   func(string)
	// ReasoningEffort, if set, is sent as reasoning.effort.
	ReasoningEffort string
	// contains filtered or unexported fields
}

type Cost struct {
	USD              float64 `json:"usd"`
	InputTokens      int     `json:"input_tokens"`
	OutputTokens     int     `json:"output_tokens"`
	CacheReadTokens  int     `json:"cache_read_tokens,omitempty"`
	CacheWriteTokens int     `json:"cache_write_tokens,omitempty"`
}

type Fallback struct {
	Entries []FallbackEntry
	// contains filtered or unexported fields
}

type FallbackEntry struct {
	Spec  string
	Model Model
}

type FunctionCall struct {
	Name      string `json:"name"`
	Arguments string `json:"arguments"`
}

type FunctionSpec struct {
	Name        string         `json:"name"`
	Description string         `json:"description"`
	Parameters  map[string]any `json:"parameters"`
}

type Image struct {
	MIMEType string `json:"mime_type"`
	Data     string `json:"data"`
	// Label names the source for elision notes: a workspace path or an MCP
	// tool name.
	Label string `json:"label,omitempty"`
}

type Message struct {
	Role       string     `json:"role"`
	Content    string     `json:"content,omitempty"`
	ToolCalls  []ToolCall `json:"tool_calls,omitempty"`
	ToolCallID string     `json:"tool_call_id,omitempty"`
	// Images are tool-result images (opt-in --images) or user task
	// attachments (--image), sent in each provider's image form. Content
	// already holds a placeholder or label line for each one.
	Images []Image        `json:"images,omitempty"`
	Extra  map[string]any `json:"extra,omitempty"`
}

type Model interface {
	Query(ctx context.Context, messages []Message, tools []ToolSpec) (Message, Cost, error)
}

type ModelMeta struct {
	InputPricePerMTok   float64
	OutputPricePerMTok  float64
	CacheReadMultiplier float64 // 0 means the standard 0.1
	ContextWindow       int
}

type OpenAI struct {
	BaseURL string
	APIKey  string
	Model   string
	OnText  func(string) // if set, stream and report text deltas
	// ReasoningEffort, if set, is sent as reasoning_effort, or as
	// reasoning.effort when NestedReasoning is set (OpenRouter).
	ReasoningEffort string
	NestedReasoning bool
	// MaxOutputTokens, if > 0, is sent under MaxOutputKey
	// (max_completion_tokens, or max_tokens for Ollama).
	MaxOutputTokens int
	MaxOutputKey    string
	// Headers, if set, are added to every request after the defaults
	// (configured providers).
	Headers map[string]string
	// Price, if set, replaces the Prices table entry for this model
	// (configured providers); PriceOverride still wins.
	Price *[3]float64
}

type OpenAIResponses struct {
	BaseURL string
	APIKey  string
	Model   string
	OnText  func(string) // if set, stream and report text deltas
	// ReasoningEffort, if set, is sent as reasoning.effort.
	ReasoningEffort string
	// MaxOutputTokens, if > 0, is sent as max_output_tokens.
	MaxOutputTokens int

	// Headers, if set, are added to every request after the defaults
	// (configured providers).
	Headers map[string]string
	// Price, if set, replaces the Prices table entry for this model
	// (configured providers); PriceOverride still wins.
	Price *[3]float64
	// contains filtered or unexported fields
}

type Options struct {
	// OpenAIAPI is the openai provider's transport: auto (or ""), responses,
	// or chat. Other providers ignore it.
	OpenAIAPI string
}

type ProviderDef struct {
	ID         string
	API        string
	BaseURL    string
	APIKeyEnv  string
	Headers    map[string]string
	EnvHeaders map[string]string
	Models     map[string]ModelMeta
}

type ProviderEnvError struct {
	Provider, Env, Use string
}

type Retry struct {
	Attempt int           // the attempt about to be made, starting at 2
	Reason  string        // "http_<status>" or "network"; never a response body
	Backoff time.Duration // wait before the attempt
}

type RetryExhaustedError struct {
	Attempts int
	Reason   string // "http_<status>" or "network"; never a response body
	Err      error  // the last attempt's error
}

type Switch struct {
	From     string // model spec that failed
	To       string // model spec the request is re-sent to
	Reason   string // "http_<status>" or "network"; never a response body
	Attempts int    // attempts made on From
}

type ToolCall struct {
	ID       string       `json:"id"`
	Type     string       `json:"type"`
	Function FunctionCall `json:"function"`
}

type ToolResult struct {
	ToolCallID string `json:"tool_call_id"`
	Content    string `json:"content"`
}

type ToolSpec struct {
	Type     string       `json:"type"`
	Function FunctionSpec `json:"function"`
}