Add Google Gemini platform via OpenAI-compat endpoint (provider 7)

The 10th registry row: id "google", GEMINI_API_KEY > auth.json "google"
scope, https://generativelanguage.googleapis.com/v1beta/openai (Gemini's
OpenAI-compatibility shim) with KIGI_GOOGLE_BASE_URL override, Bearer,
OpenAI listing + ChatCompletions + Passthrough, enrichment-backed
metadata (models_dev_id google), tool-calling listing restriction.

Review caught a ship-blocking defect: Gemini's compat /models returns
-PREFIXED ids (confirmed via Google's own cookbook), but the
models.dev snapshot keys and the chat endpoint use the BARE id. Without
normalization the enrichment lookup misses and restrict_to_enriched
silently empties the Gemini catalog (login works, zero models
selectable). A doc WebFetch had hidden this — the compat docs show bare
INPUT ids to retrieve/chat but never print the list OUTPUT.

Fix: new spec field strip_listing_id_prefix, applied in the fetch before
filter/enrich/keying. Google sets Some("models/") (defensive: a no-op if
an id is already bare, so correct regardless of the live shape); all other
rows None. The e2e now feeds the REAL prefixed listing ids and asserts
they survive as the bare managed key google/gemini-2.5-pro with the bare
id on the wire (chat rejects the prefix); a registry test pins the config.

Note: models.dev models Gemini reasoning as budget_tokens (not
effort-type), so no auto effort-menu — models still fully work; reasoning
is dynamic. Gemini compat applies default safety filters (no BLOCK_NONE).
This commit is contained in:
2026-07-21 11:47:47 -04:00
parent e373ff8b29
commit 7a2cd8a726
4 changed files with 208 additions and 9 deletions
@@ -597,7 +597,8 @@ mod tests {
"deepseek",
"groq",
"mistral",
"fireworks"
"fireworks",
"google"
]
);
assert_eq!(default_id(&built), Some(XAI_API_KEY_METHOD_ID));
@@ -629,7 +630,8 @@ mod tests {
"deepseek",
"groq",
"mistral",
"fireworks"
"fireworks",
"google"
]
);
assert_eq!(default_id(&built), Some(CACHED_TOKEN_AUTH_METHOD_ID));
@@ -654,7 +656,8 @@ mod tests {
"deepseek",
"groq",
"mistral",
"fireworks"
"fireworks",
"google"
]
);
assert_eq!(default_id(&built), Some(CACHED_TOKEN_AUTH_METHOD_ID));
@@ -682,7 +685,8 @@ mod tests {
"deepseek",
"groq",
"mistral",
"fireworks"
"fireworks",
"google"
]
);
assert_eq!(default_id(&built), None);
@@ -309,6 +309,19 @@ fn fetch_one_platform_models(
})?
}
};
// Canonicalize listing ids before filtering/enrichment/keying. Google's
// OpenAI-compat `/models` returns `models/`-prefixed ids while its chat
// endpoint and the models.dev snapshot use the bare id — without this the
// enrichment lookup misses and `restrict_to_enriched` would empty the
// catalog. No-op for platforms with no configured prefix.
let mut data = data;
if let Some(prefix) = platform.strip_listing_id_prefix() {
for wire in &mut data {
if let Some(bare) = wire.id.strip_prefix(prefix) {
wire.id = bare.to_string();
}
}
}
let total = data.len();
let mut filtered = kigi_models::filter_allowed_models(platform, data);
if filtered.len() != total {
@@ -1395,6 +1408,103 @@ mod tests {
);
}
/// Google/Gemini-cycle e2e: the OpenAI-compat listing returns
/// `models/`-PREFIXED ids (Google's real shape), which the Google spec's
/// `strip_listing_id_prefix` canonicalizes to the bare form the models.dev
/// snapshot + chat endpoint use — WITHOUT the strip, restrict_to_enriched
/// would silently drop every Gemini model. Embedding pollution is
/// restricted away; Passthrough dialect; bare id on the wire.
#[tokio::test(flavor = "multi_thread")]
#[serial_test::serial]
async fn google_compat_listing_strips_prefix_restricts_and_maps_passthrough() {
let platform_server = wiremock::MockServer::start().await;
wiremock::Mock::given(wiremock::matchers::method("GET"))
.and(wiremock::matchers::path("/models"))
.and(wiremock::matchers::header("Authorization", "Bearer gk-1"))
.respond_with(wiremock::ResponseTemplate::new(200).set_body_json(
serde_json::json!({ "data": [
// Real Gemini compat shape: `models/`-prefixed ids.
{ "id": "models/gemini-2.5-pro", "object": "model" },
{ "id": "models/gemini-embedding-001", "object": "model" }
]}),
))
.expect(1)
.mount(&platform_server)
.await;
let modelsdev_server = wiremock::MockServer::start().await;
wiremock::Mock::given(wiremock::matchers::method("GET"))
.and(wiremock::matchers::path("/api.json"))
.respond_with(wiremock::ResponseTemplate::new(200).set_body_json(
serde_json::json!({ "google": { "models": {
"gemini-2.5-pro": {
"limit": {"context": 1048576, "output": 65536},
"tool_call": true
},
"gemini-embedding-001": { "limit": {"context": 2048} }
}}}),
))
.expect(1)
.mount(&modelsdev_server)
.await;
let cache_dir = tempfile::tempdir().unwrap();
let _base = kigi_test_support::EnvGuard::set(
kigi_models::GOOGLE_BASE_URL_ENV,
platform_server.uri(),
);
let _mdev = kigi_test_support::EnvGuard::set(
crate::agent::enrichment_fetch::MODELS_DEV_URL_ENV,
format!("{}/api.json", modelsdev_server.uri()),
);
let _mdev_cache = kigi_test_support::EnvGuard::set(
crate::agent::enrichment_fetch::MODELS_DEV_CACHE_DIR_ENV,
cache_dir.path(),
);
let endpoints = crate::agent::config::EndpointsConfig::default();
let keys = crate::agent::models::PlatformApiKeys::test_single(
kigi_models::PlatformId::Google,
"gk-1",
);
let result = tokio::task::spawn_blocking(move || {
fetch_platform_models_blocking(&endpoints, None, &keys)
})
.await
.unwrap()
.expect("fetch must succeed");
assert_eq!(
result
.models
.iter()
.map(|m| m.id.as_deref().unwrap_or_default())
.collect::<Vec<_>>(),
vec!["google/gemini-2.5-pro"],
"prefix stripped → matches bare snapshot → kept as the bare \
managed key; embedding (not tool-calling) dropped"
);
let entry = &result.models[0];
assert_eq!(
entry.context_window.get(),
1_048_576,
"enrichment matched the bare id"
);
assert_eq!(entry.max_completion_tokens, Some(65_536));
assert_eq!(
entry.model, "gemini-2.5-pro",
"the BARE Gemini id rides the wire (chat rejects the models/ prefix)"
);
let model_entry = crate::agent::config::ModelEntry::from_config_entry(entry);
let creds = crate::agent::config::ResolvedCredentials {
api_key: Some("gk-1".into()),
base_url: entry.base_url.clone(),
auth_type: kigi_chat_state::AuthType::ApiKey,
auth_scheme: Default::default(),
};
let cfg = crate::agent::config::sampling_config_for_model(&model_entry, creds, None);
assert_eq!(
cfg.chat_compat,
kigi_sampling_types::ChatCompat::Passthrough
);
}
#[test]
fn get_env_keys_parses_strings_and_rejects_non_strings() {
use crate::agent::config::EnvKeys;