provider

type AttachmentPolicy struct {
	// MaxInlineBytesTotal caps the total base64-encoded attachment bytes in
	// a single request body. Parts that don't fit are evicted (oldest first)
	// and replaced with a text placeholder that tells the LLM how to
	// re-attach.
	MaxInlineBytesTotal int

	// SupportsURL is true when the provider accepts http(s):// URLs for
	// image file parts (a FilePart with an image/* type and a URL data
	// variant). Anthropic + Google also accept non-image files by URL (see
	// SupportsFileURL).
	SupportsURL bool

	// SupportsFileURL is true when the provider accepts http(s):// URLs for
	// non-image file parts (a FilePart with a URL data variant). Anthropic +
	// Google support PDFs and other file types by URL; OpenAI currently does
	// not on the chat path.
	SupportsFileURL bool

	// MaxURLImages caps how many image/file parts per request can be sent
	// as URLs before we fall back to inline. Shared across both kinds to
	// keep the provider from rejecting oversized fan-out fetches.
	MaxURLImages int

	// MaxURLBytesPerImage is the per-object size ceiling when sending URLs.
	// Objects above this are fetched and inlined (or evicted) rather than
	// referenced.
	MaxURLBytesPerImage int
}

type CapabilitySet struct {
	Text          bool
	Vision        bool
	ImageGen      bool
	Search        bool
	Embedding     bool
	Speech        bool
	Transcription bool
	Reranking     bool
}

type ModelCapabilities struct {
	// IsReasoningModel indicates if the model is a reasoning model
	IsReasoningModel bool

	// SystemMessageMode determines how system messages should be handled.
	// "system" - use standard system role
	// "developer" - convert to developer role (for reasoning models)
	// "remove" - remove system messages entirely
	SystemMessageMode string

	// DefaultReasoningEffort is the default reasoning effort level for this model.
	// Empty string means no default (non-reasoning model or special case like gpt-5-pro).
	DefaultReasoningEffort string

	// DefaultMaxOutputTokens is the recommended max output tokens for this model.
	// 0 means use the standard default.
	DefaultMaxOutputTokens int
}

type ModelCost struct {
	Input      float64 `json:"input"`
	Output     float64 `json:"output"`
	CacheRead  float64 `json:"cache_read,omitempty"`
	CacheWrite float64 `json:"cache_write,omitempty"`
}

type ModelInfo struct {
	ID           string           `json:"id"`
	Name         string           `json:"name"`
	Kind         ModelKind        `json:"kind,omitempty"`
	Family       string           `json:"family,omitempty"`
	ReleaseDate  string           `json:"release_date,omitempty"`
	Attachment   bool             `json:"attachment,omitempty"`
	Reasoning    bool             `json:"reasoning,omitempty"`
	Temperature  bool             `json:"temperature,omitempty"`
	ToolCall     bool             `json:"tool_call,omitempty"`
	Modalities   *ModelModalities `json:"modalities,omitempty"`
	Cost         *ModelCost       `json:"cost,omitempty"`
	Limit        *ModelLimit      `json:"limit,omitempty"`
	Status       string           `json:"status,omitempty"`
	Experimental json.RawMessage  `json:"experimental,omitempty"`
}

type ModelKind string

type ModelLimit struct {
	Context int `json:"context"`
	Input   int `json:"input,omitempty"`
	Output  int `json:"output"`
}

type ModelModalities struct {
	Input  []string `json:"input"`
	Output []string `json:"output"`
}

type ModelsDevProvider struct {
	ID      string               `json:"id"`
	Name    string               `json:"name"`
	API     string               `json:"api,omitempty"`
	NPM     string               `json:"npm,omitempty"`
	Env     []string             `json:"env"`
	Aliases []string             `json:"aliases,omitempty"`
	Models  map[string]ModelInfo `json:"models"`
}

type Options struct {
	APIKey  string
	BaseURL string

	// HTTPClient sends requests only for the explicit openai-compatible provider.
	HTTPClient *http.Client

	// SupportsStructuredOutputs controls native json_schema response formats for
	// the explicit openai-compatible provider. Nil defaults to false for that
	// provider.
	SupportsStructuredOutputs *bool

	// IncludeUsage controls stream_options.include_usage for the explicit
	// openai-compatible provider. Nil defaults to false for that provider.
	IncludeUsage *bool
}

type ProxyOptions struct {
	BaseURL string // Proxy server URL (e.g., "http://localhost:8080")
	Token   string // Bearer token for authentication
}