registry

type CredentialSpec struct {
	ProviderID   string
	DisplayName  string
	DeploymentID string
	EnvVar       string
	ProbeKind    string
	ProbeBaseURL string
	RequiresKey  bool
	SortOrder    int
}

type EnvFallback struct {
	Field string
	Env   []string
}

type ProbeKind string

type ProviderRegistry struct {
	// contains filtered or unexported fields
}

type ProviderSpec struct {
	ProviderID             string
	DisplayName            string
	DeploymentID           string
	SortOrder              int
	ChatPreference         int
	RequiresKey            bool
	CredentialEnv          string
	CredentialEnvFallbacks []string // additional env var names for the same credential
	CredentialAliases      []string // compatibility env var names accepted by host UIs
	BaseURLEnv             []string
	ProbeKind              ProbeKind
	ProbeBaseURL           string
	LiveFetcherKey         string // key in catalog/live registry
	LiveCatalogKey         string // legacy provider key in ModelCatalog.Providers map
	PublicModelCatalog     bool   // live model listing is available without provider credentials
	ProtocolID             string
	AdapterID              string
	RuntimeProfileKey      string
	PrepareCredentialEnv   bool
	RetryConfig            *RetryConfig
	IsLocal                bool
	// TransportKind selects the runtime client implementation. Empty means
	// OpenAI-compatible; dedicated transports declare their kind explicitly.
	TransportKind string
	// RuntimeBaseURL overrides ProbeBaseURL when chat and model-list endpoints
	// differ. RuntimeCredentialEnv overrides CredentialEnv when setup metadata
	// describes a non-secret value, as with Ollama's base URL.
	RuntimeBaseURL       string
	RuntimeCredentialEnv string
	// RegionOptions lists selectable regions for regional gateways.
	// Populated at registration time; nil for non-regional providers.
	RegionOptions []RegionOption
	// DNSHost is the primary DNS hostname for connectivity preflight checks.
	DNSHost string
	// ThinkingToggleSupported indicates the provider's wire protocol honors
	// the ThinkingEnabled toggle parameter.
	ThinkingToggleSupported bool
	// DefaultThinkingDisabled means the provider defaults thinking OFF when
	// no explicit preference is set (e.g. longcat, kimi, deepseek).
	DefaultThinkingDisabled bool
}

type RegionOption struct {
	Value       string
	DisplayName string
	Endpoint    string
}

type RetryConfig struct {
	BaseDelayMs       int     `json:"base_delay_ms,omitempty"`
	MaxDelayMs        int     `json:"max_delay_ms,omitempty"`
	MaxRetries        int     `json:"max_retries,omitempty"`
	BackoffMultiplier float64 `json:"backoff_multiplier,omitempty"`
	JitterPct         int     `json:"jitter_pct,omitempty"`
	RetryOnCodes      []int   `json:"retry_on_codes,omitempty"`
	AbortOnCodes      []int   `json:"abort_on_codes,omitempty"`
}