providers

func CatalogToolSupport ¶

func CatalogToolSupport(provider, modelID string) (supported, known bool)

CatalogToolSupport reports what the provider's own catalog says about a model's tool calling. known is false when no catalog is loaded, the model isn't listed, or the listing doesn't say. An OpenRouter ":variant" suffix falls back to the base id.

func CleanBaseURL ¶

func CleanBaseURL(baseURL string) string

CleanBaseURL is a base URL safe to log: no userinfo, query or fragment.

func DetectProvider ¶

func DetectProvider(baseURL string) string

DetectProvider attempts to detect provider from base URL.

func EndpointID ¶

func EndpointID(provider, baseURL, apiKey string) string

EndpointID names one endpoint's catalog (provider, base URL, key hash) without the key, so callers can tell whether two lookups share one.

func ForgetCatalogsForTest ¶

func ForgetCatalogsForTest()

ForgetCatalogsForTest is for tests only: it drops every catalog loaded in this process, so a test that fetched one doesn't leak it into the next.

func GetPerModelToolProviders ¶

func GetPerModelToolProviders() []string

GetPerModelToolProviders returns the providers with no default tool support whose tool support is decided per model (ToolsPerModel), sorted.

func GetToolCallingProviders ¶

func GetToolCallingProviders() []string

GetToolCallingProviders returns only providers that support function calling.

func HasCatalog ¶

func HasCatalog(provider string) bool

HasCatalog reports whether celeste can list the models a provider serves. Gemini, Vertex, DigitalOcean, local servers and ElevenLabs have none.

func HasModelEndpoint ¶

func HasModelEndpoint(provider string) bool

HasModelEndpoint reports whether the provider answers GET /models/{id}.

func IsAnthropicURL ¶

func IsAnthropicURL(baseURL string) bool

IsAnthropicURL reports whether baseURL points at Anthropic: its host is anthropic.com or a subdomain of it, in any case, with or without a trailing dot or port. It is the one rule both DetectProvider (the header, capabilities, context windows) and the llm backend choice use (#372). A URL without a scheme is read as https.

func IsGeminiURL ¶

func IsGeminiURL(baseURL string) bool

IsGeminiURL reports whether baseURL's host is Google AI Studio's generativelanguage.googleapis.com.

func IsGoogleURL ¶

func IsGoogleURL(baseURL string) bool

IsGoogleURL reports whether baseURL is Gemini (AI Studio) or Vertex AI: the endpoints the native Google backend serves.

func IsLocalEndpoint ¶

func IsLocalEndpoint(baseURL string) bool

IsLocalEndpoint reports whether baseURL is a server on this machine or the local network. It is IsLocalHost: one rule for the timeouts, the window probe and fallback, and the "local" provider (#377).

func IsLocalHost ¶

func IsLocalHost(baseURL string) bool

IsLocalHost reports whether baseURL's parsed host is this machine or the local network: localhost, a loopback, private, link-local or unspecified IP, a single-label host, or a .local, .lan, .internal or .home.arpa name. A hosted URL that merely contains "localhost" in its path is not local. Such a server runs the model on the user's own hardware, which can take minutes before the first byte.

func IsVertexURL ¶

func IsVertexURL(baseURL string) bool

IsVertexURL reports whether baseURL's host is Vertex AI's aiplatform.googleapis.com, global or regional (REGION-aiplatform...).

func IsXAIURL ¶

func IsXAIURL(baseURL string) bool

IsXAIURL reports whether baseURL's host is x.ai or a subdomain of it. It is the one rule DetectProvider ("grok") and the llm backend choice use.

func ListProviders ¶

func ListProviders() []string

ListProviders returns all provider names.

func OrchestratesServerSide ¶

func OrchestratesServerSide(provider, modelID string) bool

OrchestratesServerSide reports whether the model does its own task decomposition, delegation and verification server-side, which makes celeste-cli's local planning phase redundant. Fugu is a trained conductor: it either answers directly or coordinates several frontier models and synthesises the result. Running our planner on top of it means two planners that cannot see each other.

This is deliberately a rule rather than a lookup against the static model list. Sakana ships version-bumped fugu IDs faster than that list is updated, and an unrecognised ID must not silently re-enable local planning against a conductor. The provider is checked too: Sakana serves an OpenAI-compatible API and could host a plain model, which still needs local planning.

func PrepareModels ¶

func PrepareModels(ctx context.Context, provider, baseURL, apiKey string, models ...string)

PrepareModels loads an endpoint's catalog (the cache, or one fetch bounded by the timeout; a fetch that failed in the last five minutes is not retried) and, for providers that answer GET /models/{id}, checks each given model the catalog doesn't list. The answers stay in memory for ResolveFromMemory. It may block on the network: never call it from a Bubble Tea Update.

func ResolveFromMemory ¶

func ResolveFromMemory(provider, baseURL, apiKey, configured string) (model, note string, pending bool)

ResolveFromMemory resolves configured against what this process knows the endpoint serves, with no I/O. A model is replaced only when celeste is sure it's gone: the catalog doesn't list it and, where the provider can say, GET /models/{id} answered 404. pending is true when PrepareModels would know more (no catalog loaded yet, a stale one, or an unchecked miss); until then the configured model is kept. A miss in a list older than the TTL is not proof either.

func ResolveModel ¶

func ResolveModel(provider, configured string, cat []CatalogModel, ok bool) (model, note string)

ResolveModel picks the model a session uses from what the provider serves now, so a retired model is never sent. Pure; ok is false when there is no catalog (offline, no key, a provider without one).

1. No catalog: the configured model, unchanged (the registry default when nothing is configured).
2. The configured model is served: keep it.
3. Otherwise, in order: the provider-flagged default; the newest served version of the configured model (its ID plus "-", "." or ":" and more); the registry default or preferred tool model, if served; the first tool-capable served model; the first served model.

Among ties (several flagged defaults or versions) a tool-capable model wins. The note says what happened; it is empty when nothing was replaced.

func SetCatalogFetchForTest ¶

func SetCatalogFetchForTest(fetch func(ctx context.Context, provider, baseURL, apiKey string) ([]CatalogModel, error)) (restore func())

SetCatalogFetchForTest is for tests only: it replaces the /models fetch, so tests in other packages can see what a fetch was asked (its context, endpoint) without the network. Call the returned func to restore.

func SetCatalogForTest ¶

func SetCatalogForTest(provider string, models []CatalogModel) (restore func())

SetCatalogForTest is for tests only. It makes provider's catalog the given models in every lookup (CachedCatalog, CatalogFor, LoadCatalog, RefreshCatalog), so no test reaches the network or the disk cache. A nil or empty list means "no catalog". Call the returned func to restore. It lives outside a _test.go file because tests in other packages (tui, main) need it.

func ToolsEnabledForModel ¶

func ToolsEnabledForModel(provider, modelID string) bool

ToolsEnabledForModel reports whether celeste should offer tool calling for this provider/model pair. Most providers decide at the provider level (SupportsFunctionCalling); a ToolsPerModel provider (Venice) decides per model instead, since most of its models have no tool support but some do (#151). The chat's skillsEnabled gate calls this instead of reading SupportsFunctionCalling directly, so Venice stops being "no tools" for every model.