providercatalog

type APIFormat string

type Descriptor struct {
	ID                  string
	Name                string
	Transport           Transport
	DefaultBaseURL      string
	DefaultModel        string
	AuthEnvVars         []string
	RequiresAuth        bool
	UsesAmbientAuth     bool
	Public              bool
	Local               bool
	SupportedAPIFormats []APIFormat
	Aliases             []string

	// Custom marks the "bring your own endpoint" catalog entries
	// (custom-openai-compatible, custom-anthropic-compatible). Unlike every other
	// descriptor, RequiresAuth here is just a template default for the credential
	// wizard step, not a fact about the user's actual endpoint — a custom target may
	// or may not need auth, so callers deciding whether a *saved profile* is missing
	// a credential must not treat RequiresAuth as authoritative for these entries.
	Custom bool

	// OAuth reports that this provider offers an in-app OAuth login that yields a
	// credential usable for model calls (browser PKCE and/or device code). Only
	// set for providers where this actually works (not subscription-via-proxy).
	OAuth bool
	// OAuthMintsKey reports that the OAuth flow returns/mints a normal API key
	// (e.g. OpenRouter) rather than a bearer token used directly.
	OAuthMintsKey bool
	// OAuthDeviceFlow reports that RFC 8628 device-code login is supported (for
	// headless / SSH use) in addition to the browser flow.
	OAuthDeviceFlow bool

	// Recommended marks the provider that should be surfaced first and badged
	// (★ … (recommended)) in every catalog-ordered list and picker. At most one
	// descriptor should set this.
	Recommended bool
}

type Transport string