catalog

type Catalog struct {
	Providers map[string]Provider
	// Source says where the data came from: "embedded", "cache" or the URL it was fetched from.
	Source string
}

type Cost struct {
	Input      float64
	Output     float64
	CacheRead  float64
	CacheWrite float64
	// Reasoning is the price of reasoning tokens when they are billed apart from the output.
	Reasoning float64
	// InputAudio and OutputAudio are the prices of audio tokens when they are billed apart.
	InputAudio  float64
	OutputAudio float64
}

type Model struct {
	ID            string
	Name          string
	ContextWindow int
	// MaxInput is the limit on the prompt alone, 0 when the catalog gives none. When it is below the context window the prompt
	// cannot use the whole window (the rest is kept for the output).
	MaxInput int
	// MaxOutput is the output limit, 0 when unknown. See OutputIsKnown.
	MaxOutput int
	// InputModalities lists what the model accepts besides text: "image", "audio", "video", "pdf".
	InputModalities []string
	Reasoning       bool
	// Attachment is true when the model accepts file attachments.
	Attachment bool
	// StructuredOutput is true when the model supports JSON-schema constrained output.
	StructuredOutput bool
	// NoTemperature is true when the catalog says the model does not support the temperature parameter (many reasoning models reject it).
	// A model the catalog says nothing about is assumed to support it.
	NoTemperature bool
	// Interleaved says the model interleaves reasoning with its answer and how: the name of the response field that carries the reasoning
	// ("reasoning_content" or "reasoning_details"), "true" when the catalog gives no field, "" when it does not interleave.
	Interleaved string
	// OpenWeights is true when the trained weights are publicly available.
	OpenWeights bool
	// Family groups the models of a line ("claude-sonnet", "gpt"), "" when the catalog gives none.
	Family string
	// Knowledge is the knowledge cutoff, "YYYY-MM" or "YYYY-MM-DD", "" when unknown.
	Knowledge string
	Cost      Cost
	// Status is "", "alpha", "beta" or "deprecated".
	Status      string
	ReleaseDate string
	// LastUpdated is the date of the last update of the model's entry.
	LastUpdated string
}

type Provider struct {
	ID   string
	Name string
	// BaseURL is the API base URL, empty for providers that have no fixed one (Anthropic, OpenAI, Gemini, AWS...).
	BaseURL string
	// Env lists the environment variables that can hold the API key, the first one first.
	Env []string
	// Protocol is the SDK package the catalog names for the provider: "@ai-sdk/openai-compatible" for most.
	Protocol string
	Models   map[string]Model
	// Unverified is true for a provider that is not in the embedded snapshot: its BaseURL comes from a catalog fetched at run
	// time and must be confirmed by the user before an API key is sent to it.
	Unverified bool
}