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 Runtime's price table entry for this
	// model (configured providers); the Runtime's PriceOverride still wins.
	Price *[3]float64
	// Runtime supplies the HTTP client, retry policy and prices. nil uses
	// DefaultRuntime.
	Runtime *Runtime
	// OmitEmptyKey sends no x-api-key header when APIKey is empty
	// (configured providers without api_key_env).
	OmitEmptyKey bool
}

type ClaudeCode struct {
	Path  string // resolved claude binary
	Model string // "" or HandoffDefaultModel sends no --model
	HandoffOptions
}

type Codex struct {
	BaseURL  string
	TokenURL string
	AuthFile string
	Model    string
	OnText   func(string)
	// ReasoningEffort, if set, is sent as reasoning.effort.
	ReasoningEffort string
	// Runtime supplies the HTTP client, retry policy and prices. nil uses
	// DefaultRuntime.
	Runtime *Runtime
	// contains filtered or unexported fields
}

type CodexExec struct {
	Path  string // resolved codex binary
	Model string // "" or HandoffDefaultModel sends no -m
	HandoffOptions
}

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 HandoffOptions struct {
	// Dir is the working directory the CLI runs in (--cwd). "" keeps
	// tinyagent's own working directory.
	Dir string
	// ReadOnly maps --read-only/read_only onto the CLI's own restriction.
	ReadOnly bool
}

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 MissingCLIError struct {
	Provider, Binary, Configured, Install, SignIn, Docs string
}

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 Runtime's price table entry for this
	// model (configured providers); the Runtime's PriceOverride still wins.
	Price *[3]float64
	// Runtime supplies the HTTP client, retry policy and prices. nil uses
	// DefaultRuntime.
	Runtime *Runtime
}

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 Runtime's price table entry for this
	// model (configured providers); the Runtime's PriceOverride still wins.
	Price *[3]float64
	// Runtime supplies the HTTP client, retry policy and prices. nil uses
	// DefaultRuntime.
	Runtime *Runtime
	// contains filtered or unexported fields
}

type OpenCode struct {
	Path  string // resolved opencode binary
	Model string // "" or HandoffDefaultModel sends no --model
	HandoffOptions
}

type Options struct {
	// OpenAIAPI is the openai provider's transport: auto (or ""), responses,
	// or chat. Other providers ignore it.
	OpenAIAPI string
	// Handoff is what the claude-code, codex-exec and opencode providers map onto
	// the CLI they run. Other providers ignore it.
	Handoff HandoffOptions
	// Runtime supplies the HTTP client, retry policy and prices for the
	// HTTP providers. nil uses DefaultRuntime.
	Runtime *Runtime
}

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 Runtime struct {
	// HTTP sends provider requests. nil uses a client with a 10-minute
	// timeout.
	HTTP *http.Client
	// RetryBase is the first retry's backoff; each later retry doubles it
	// (plus jitter). Zero or negative uses 1s.
	RetryBase time.Duration
	// MaxAttempts is the total number of tries for a transient failure
	// (HTTP 429, 5xx or a network error). Zero or negative uses 6.
	MaxAttempts int
	// Prices maps a model name prefix to USD per million input/output tokens
	// and, optionally, the cache-read price as a multiple of the input price
	// (0 means the standard 0.1). The longest matching prefix wins. nil uses
	// the built-in table; a non-nil empty map prices every model at 0.
	Prices map[string][3]float64
	// PriceOverride, when non-zero, replaces the price table's input and
	// output prices. The table's cache-read multiplier still applies.
	PriceOverride [2]float64
}

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"`
}