Module catalog 

Available on crate feature models only.

Curated provider model catalog, lifecycle metadata, and recommended defaults. Curated model identifiers, lifecycle metadata, and provider defaults.

Provider catalogs change independently and often expose deployment-scoped or account-scoped identifiers. This module therefore distinguishes curated ADK recommendations from exhaustive provider discovery:

• crate::catalog::recommended_model returns a stable ADK default only where a portable provider-level model ID exists.
• crate::catalog::lookup_model describes model IDs whose lifecycle ADK knows about.
• crate::catalog::validate_model_selection accepts unknown IDs so private, fine-tuned, newly released, and deployment-scoped models remain usable, but rejects identifiers known to be retired.

Azure AI, Amazon Bedrock, and Volcano Engine Ark intentionally have no universal default. Their model or deployment identifiers vary by resource, region, account, or endpoint and must be supplied explicitly.

Structs

ModelCatalogEntry

One curated model-catalog entry.

Enums

ModelLifecycle

Lifecycle state for a model identifier.

ModelRole

Intended workload role of a curated model.

Constants

ANTHROPIC_DEFAULT

Recommended Anthropic model balancing capability, latency, and cost.

BAIDU_DEFAULT

Recommended Baidu Qianfan model.

CARTESIA_DEFAULT

Recommended Cartesia text-to-speech model.

CATALOG_AS_OF

Date on which the bundled catalog was verified against provider documentation.

CEREBRAS_DEFAULT

Recommended Cerebras production model.

COHERE_DEFAULT

Recommended Cohere model.

DEEPGRAM_DEFAULT

Recommended Deepgram speech-to-text model.

DEEPSEEK_DEFAULT

Recommended DeepSeek model for general agent workloads.

FIREWORKS_DEFAULT

Recommended Fireworks balanced model.

GEMINI_DEFAULT

Recommended Google Gemini model for general agent workloads.

GEMINI_EMBEDDING_DEFAULT

Recommended Gemini embedding model.

GEMINI_LIVE_DEFAULT

Recommended Gemini Live model.

GEMINI_TRANSCRIPTION_DEFAULT

Recommended Gemini speech-to-text model.

GEMINI_TTS_DEFAULT

Recommended Gemini text-to-speech model.

GROQ_DEFAULT

Recommended Groq production model.

KNOWN_PROVIDERS

Providers known to the catalog, including deployment-scoped providers.

MINIMAX_DEFAULT

Recommended MiniMax model. Model IDs are case-sensitive.

MISTRAL_DEFAULT

Recommended Mistral general-purpose model alias.

MODEL_CATALOG

Curated model entries bundled with ADK-Rust.

OLLAMA_DEFAULT

Suggested local Ollama model. The model must already be installed locally.

OPENAI_DEFAULT

Recommended OpenAI model balancing capability, latency, and cost.

OPENAI_EMBEDDING_DEFAULT

Recommended OpenAI embedding model.

OPENAI_LIVE_TRANSCRIPTION_DEFAULT

Recommended OpenAI live transcription model.

OPENAI_REALTIME_DEFAULT

Recommended OpenAI Realtime model.

OPENROUTER_DEFAULT

Recommended OpenRouter model. Callers should use model discovery for user-facing pickers.

PERPLEXITY_DEFAULT

Recommended Perplexity Sonar model.

SAMBANOVA_DEFAULT

Recommended SambaNova production model.

TOGETHER_DEFAULT

Recommended Together AI balanced model.

XAI_DEFAULT

Recommended xAI model.

ZHIPU_DEFAULT

Recommended Zhipu model.

Functions

lookup_model

Look up lifecycle metadata for a provider model ID.

recommended_model

Return the curated portable default for a provider.

requires_explicit_model

Return whether a provider requires an account-, endpoint-, or deployment-specific model ID.

validate_model_selection

Validate a model selection without preventing newly released or private IDs.

warn_if_obsolete

Emit a structured warning for a known deprecated or retired model.