jeopi-catalog 16.5.6 → 16.6.2

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [16.6.2] - 2026-10-03
+
+### Changed
+
+- Regenerated the Anthropic catalog with Claude Opus 5.5 and Sonnet 5.5 and updated the first-party default to `claude-opus-5-5`.
+
+### Fixed
+
+- Normalize Anthropic discovery to `/v1/models`, follow all cursor pages, and prefer live display names, token limits, image support, and reasoning capabilities while retaining reference pricing. Failed pagination keeps the previous complete catalog, and discovery requests have bounded timeouts.
+
+## [16.6.0] - 2026-10-01
+
+### Fixed
+
+- Refresh Antigravity's live model catalog with lazily resolved OAuth access, account-and-endpoint-scoped caching, and bounded cancellation. Successful discovery replaces stale bundled entries, including an empty catalog; failed refreshes retain the last authoritative snapshot without extending its lifetime.
+- Preserve authoritative empty Antigravity results during provider-only catalog regeneration while retaining previous entries on discovery failure.
+
 ## [16.5.6] - 2026-10-01
 
 ### Fixed

package/dist/types/discovery/openai-compatible.d.ts

@@ -54,6 +54,8 @@ export interface FetchOpenAICompatibleModelsOptions<TApi extends Api> {
     timeoutMs?: number;
     /** Optional fetch implementation override for testing/custom runtimes. */
     fetch?: FetchImpl;
+    /** Follow Anthropic's `has_more` / `last_id` cursor protocol via `after_id`. */
+    pagination?: "anthropic";
     /**
      * Optional post-normalization filter.
      * Return false to skip a model.

package/dist/types/model-manager.d.ts

@@ -28,6 +28,8 @@ export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload =
     cacheTtlMs?: number;
     /** When true, a successful dynamic fetch is the complete provider catalog and prunes static-only models. */
     dynamicModelsAuthoritative?: boolean;
+    /** Keep a prior complete catalog (including empty) on failed/offline refresh, without extending its TTL. */
+    preserveAuthoritativeCacheOnFailure?: boolean;
     /** Cached model ids to ignore when the cache was written against a different static catalog fingerprint. */
     dropCachedModelIdsOnStaticMismatch?: readonly string[];
     /** Trusted provider-wide headers restored locally, never persisted. */
@@ -59,6 +61,8 @@ export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload =
 export interface ModelResolutionResult<TApi extends Api = Api> {
     models: Model<TApi>[];
     stale: boolean;
+    /** A stale result retained a complete provider snapshot; callers must not resurrect bundled-only ids. */
+    preservedAuthoritativeCache?: boolean;
 }
 /**
  * Stateful facade over provider model resolution.

package/dist/types/provider-models/descriptors.d.ts

@@ -28,7 +28,7 @@ export declare const CATALOG_PROVIDERS: readonly [{
     readonly defaultModel: "us.anthropic.claude-opus-4-8";
 }, {
     readonly id: "anthropic";
-    readonly defaultModel: "claude-opus-4-8";
+    readonly defaultModel: "claude-opus-5-5";
     readonly envVars: readonly ["ANTHROPIC_API_KEY"];
     readonly createModelManagerOptions: (config: ModelManagerConfig) => import("..").ModelManagerOptions<"anthropic-messages", unknown>;
     readonly catalogDiscovery: {

package/dist/types/provider-models/google.d.ts

@@ -15,6 +15,10 @@ export interface GoogleAntigravityModelManagerConfig {
     oauthToken?: string;
     endpoint?: string;
     fetch?: FetchImpl;
+    /** Stable credential identity; falls back to the token when unavailable. */
+    cacheScope?: string;
+    /** Resolve a fresh token only when discovery actually needs the network. */
+    resolveOAuthToken?: (signal: AbortSignal) => Promise<string | undefined>;
 }
 export interface GoogleGeminiCliModelManagerConfig {
     oauthToken?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "jeopi-catalog",
-	"version": "16.5.6",
+	"version": "16.6.2",
 	"description": "Model catalog for jeopi: bundled model database, provider discovery descriptors, model identity, classification, and equivalence",
 	"homepage": "https://github.com/akillness/jeopi",
 	"author": "Can Boluk",
@@ -34,12 +34,12 @@
 	},
 	"dependencies": {
 		"@bufbuild/protobuf": "^2.12.0",
-		"jeopi-utils": "16.5.6",
+		"jeopi-utils": "16.6.2",
 		"arktype": "2.2.3",
 		"zod": "^4"
 	},
 	"devDependencies": {
-		"jeopi-ai": "16.5.6",
+		"jeopi-ai": "16.6.2",
 		"@types/bun": "^1.3.14"
 	},
 	"engines": {

package/src/discovery/antigravity.ts

@@ -161,12 +161,16 @@ export interface FetchAntigravityDiscoveryModelsOptions {
 export async function fetchAntigravityDiscoveryModels(
 	options: FetchAntigravityDiscoveryModelsOptions,
 ): Promise<ModelSpec<"google-gemini-cli">[] | null> {
+	if (!options.token.trim() || options.signal?.aborted) return null;
+	const timeout = AbortSignal.timeout(10_000);
+	const signal = options.signal ? AbortSignal.any([options.signal, timeout]) : timeout;
 	const fetcher = discoveryFetch(options.fetcher);
 	const endpoints = options.endpoint
 		? [trimTrailingSlashes(options.endpoint)]
 		: DEFAULT_ANTIGRAVITY_DISCOVERY_ENDPOINTS.map(trimTrailingSlashes);
 
 	for (const endpoint of endpoints) {
+		if (signal.aborted) return null;
 		let response: Response;
 		try {
 			response = await fetcher(`${endpoint}${FETCH_AVAILABLE_MODELS_PATH}`, {
@@ -177,7 +181,7 @@ export async function fetchAntigravityDiscoveryModels(
 					"User-Agent": options.userAgent ?? getAntigravityUserAgent(),
 				},
 				body: JSON.stringify({}),
-				signal: options.signal,
+				signal,
 			});
 		} catch {
 			continue;
@@ -194,6 +198,7 @@ export async function fetchAntigravityDiscoveryModels(
 			continue;
 		}
 
+		if (signal.aborted) return null;
 		const parsed = parseAntigravityDiscoveryResponse(payload);
 		if (!parsed) {
 			continue;
@@ -241,6 +246,13 @@ export async function fetchAntigravityDiscoveryModels(
 }
 
 function parseAntigravityDiscoveryResponse(value: unknown): AntigravityDiscoveryApiResponse | null {
+	// An absent or corrupt map is a failed discovery, never an authoritative empty catalog.
+	if (typeof value !== "object" || value === null || !("models" in value)) return null;
+	const models = value.models;
+	if (typeof models !== "object" || models === null || Array.isArray(models)) return null;
+	for (const [id, model] of Object.entries(models)) {
+		if (!id.trim() || typeof model !== "object" || model === null || Array.isArray(model)) return null;
+	}
 	const parsed = AntigravityDiscoveryApiResponseSchema(value);
 	if (parsed instanceof type.errors) {
 		return null;

package/src/discovery/openai-compatible.ts

@@ -1,6 +1,6 @@
 import { type } from "arktype";
 import type { Api, FetchImpl, ModelSpec, Provider } from "../types";
-import { discoveryFetch } from "../utils";
+import { discoveryFetch, isRecord } from "../utils";
 
 const MODELS_PATH = "/models";
 
@@ -100,6 +100,8 @@ export interface FetchOpenAICompatibleModelsOptions<TApi extends Api> {
 	timeoutMs?: number;
 	/** Optional fetch implementation override for testing/custom runtimes. */
 	fetch?: FetchImpl;
+	/** Follow Anthropic's `has_more` / `last_id` cursor protocol via `after_id`. */
+	pagination?: "anthropic";
 	/**
 	 * Optional post-normalization filter.
 	 * Return false to skip a model.
@@ -139,42 +141,45 @@ export async function fetchOpenAICompatibleModels<TApi extends Api>(
 	}
 
 	const fetchImpl = discoveryFetch(options.fetch);
-	const fetchPayload = async (signal?: AbortSignal): Promise<unknown | null> => {
-		let response: Response;
-		try {
-			response = await fetchImpl(`${baseUrl}${MODELS_PATH}`, {
-				method: "GET",
-				headers: requestHeaders,
-				signal,
-			});
-		} catch {
-			return null;
-		}
-
-		if (!response.ok) {
-			return null;
-		}
-
-		try {
-			return await response.json();
-		} catch {
-			return null;
+	const fetchEntries = async (signal?: AbortSignal): Promise<ParsedOpenAICompatibleModelRecord[] | null> => {
+		const entries: ParsedOpenAICompatibleModelRecord[] = [];
+		const cursors = new Set<string>();
+		let url = `${baseUrl}${MODELS_PATH}`;
+		while (true) {
+			let payload: unknown;
+			try {
+				const response = await fetchImpl(url, {
+					method: "GET",
+					headers: requestHeaders,
+					signal,
+				});
+				if (!response.ok) return null;
+				payload = await response.json();
+			} catch {
+				return null;
+			}
+			const page = extractModelEntries(payload);
+			if (page === null) return null;
+			entries.push(...page);
+			if (options.pagination !== "anthropic" || !isRecord(payload) || payload.has_more !== true) {
+				return entries;
+			}
+			const cursor = payload.last_id;
+			// A broken/repeated cursor must not loop or cache an incomplete catalog.
+			if (typeof cursor !== "string" || cursor.length === 0 || cursors.has(cursor) || page.length === 0) {
+				return null;
+			}
+			cursors.add(cursor);
+			url = `${baseUrl}${MODELS_PATH}?after_id=${encodeURIComponent(cursor)}`;
 		}
 	};
-	const payload =
+	const entries =
 		options.signal !== undefined
-			? await fetchPayload(options.signal)
+			? await fetchEntries(options.signal)
 			: options.timeoutMs !== undefined
-				? await withOpenAICompatibleDiscoveryTimeout(options.timeoutMs, fetchPayload)
-				: await fetchPayload();
-	if (payload === null) {
-		return null;
-	}
-
-	const entries = extractModelEntries(payload);
-	if (entries === null) {
-		return null;
-	}
+				? await withOpenAICompatibleDiscoveryTimeout(options.timeoutMs, fetchEntries)
+				: await fetchEntries();
+	if (entries === null) return null;
 
 	const context: OpenAICompatibleModelMapperContext<TApi> = {
 		api: options.api,

package/src/model-manager.ts

@@ -39,6 +39,8 @@ export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload =
 	cacheTtlMs?: number;
 	/** When true, a successful dynamic fetch is the complete provider catalog and prunes static-only models. */
 	dynamicModelsAuthoritative?: boolean;
+	/** Keep a prior complete catalog (including empty) on failed/offline refresh, without extending its TTL. */
+	preserveAuthoritativeCacheOnFailure?: boolean;
 	/** Cached model ids to ignore when the cache was written against a different static catalog fingerprint. */
 	dropCachedModelIdsOnStaticMismatch?: readonly string[];
 	/** Trusted provider-wide headers restored locally, never persisted. */
@@ -71,6 +73,8 @@ export interface ModelManagerOptions<TApi extends Api = Api, TModelsDevPayload =
 export interface ModelResolutionResult<TApi extends Api = Api> {
 	models: Model<TApi>[];
 	stale: boolean;
+	/** A stale result retained a complete provider snapshot; callers must not resurrect bundled-only ids. */
+	preservedAuthoritativeCache?: boolean;
 }
 
 /**
@@ -209,6 +213,20 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
 	const shouldUseFreshCacheAsAuthoritative =
 		strategy === "online-if-uncached" && hasUsableFreshCache && hasAuthoritativeCache;
 	const dynamicFetchSucceeded = fetchedDynamicModels !== null;
+	if (
+		!dynamicFetchSucceeded &&
+		dynamicModelsAuthoritative &&
+		options.preserveAuthoritativeCacheOnFailure &&
+		cache?.authoritative &&
+		cacheFingerprintMatches &&
+		!cacheHasUnresolvedHeaders
+	) {
+		return {
+			models: collapseBuiltModelVariants(restoredCache.models),
+			stale: true,
+			preservedAuthoritativeCache: true,
+		};
+	}
 	const cacheModels = dynamicFetchSucceeded
 		? []
 		: prepareCacheModelsForStaticMismatch(

package/src/models.json

@@ -11154,6 +11154,44 @@
 				"supportsDisplay": true
 			}
 		},
+		"claude-fable-5-1": {
+			"id": "claude-fable-5-1",
+			"name": "Claude Fable 5.1",
+			"api": "anthropic-messages",
+			"provider": "anthropic",
+			"baseUrl": "https://api.anthropic.com",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 10,
+				"output": 50,
+				"cacheRead": 1,
+				"cacheWrite": 12.5
+			},
+			"contextWindow": 1000000,
+			"maxTokens": 128000,
+			"thinking": {
+				"mode": "anthropic-adaptive",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high",
+					"xhigh"
+				],
+				"effortMap": {
+					"minimal": "low",
+					"low": "medium",
+					"medium": "high",
+					"high": "xhigh",
+					"xhigh": "max"
+				},
+				"supportsDisplay": true
+			}
+		},
 		"claude-haiku-4-5": {
 			"id": "claude-haiku-4-5",
 			"name": "Claude Haiku 4.5",
@@ -11532,6 +11570,82 @@
 				"supportsDisplay": true
 			}
 		},
+		"claude-opus-5": {
+			"id": "claude-opus-5",
+			"name": "Claude Opus 5",
+			"api": "anthropic-messages",
+			"provider": "anthropic",
+			"baseUrl": "https://api.anthropic.com",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 5,
+				"output": 25,
+				"cacheRead": 0.5,
+				"cacheWrite": 6.25
+			},
+			"contextWindow": 1000000,
+			"maxTokens": 128000,
+			"thinking": {
+				"mode": "anthropic-adaptive",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high",
+					"xhigh"
+				],
+				"effortMap": {
+					"minimal": "low",
+					"low": "medium",
+					"medium": "high",
+					"high": "xhigh",
+					"xhigh": "max"
+				},
+				"supportsDisplay": true
+			}
+		},
+		"claude-opus-5-5": {
+			"id": "claude-opus-5-5",
+			"name": "Claude Opus 5.5",
+			"api": "anthropic-messages",
+			"provider": "anthropic",
+			"baseUrl": "https://api.anthropic.com",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 4,
+				"output": 20,
+				"cacheRead": 0.2,
+				"cacheWrite": 5
+			},
+			"contextWindow": 1000000,
+			"maxTokens": 128000,
+			"thinking": {
+				"mode": "anthropic-adaptive",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high",
+					"xhigh"
+				],
+				"effortMap": {
+					"minimal": "low",
+					"low": "medium",
+					"medium": "high",
+					"high": "xhigh",
+					"xhigh": "max"
+				},
+				"supportsDisplay": true
+			}
+		},
 		"claude-sonnet-4-0": {
 			"id": "claude-sonnet-4-0",
 			"name": "Claude Sonnet 4",
@@ -11711,6 +11825,44 @@
 				},
 				"supportsDisplay": true
 			}
+		},
+		"claude-sonnet-5-5": {
+			"id": "claude-sonnet-5-5",
+			"name": "Claude Sonnet 5.5",
+			"api": "anthropic-messages",
+			"provider": "anthropic",
+			"baseUrl": "https://api.anthropic.com",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 2,
+				"output": 10,
+				"cacheRead": 0.2,
+				"cacheWrite": 2.5
+			},
+			"contextWindow": 1000000,
+			"maxTokens": 128000,
+			"thinking": {
+				"mode": "anthropic-adaptive",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high",
+					"xhigh"
+				],
+				"effortMap": {
+					"minimal": "low",
+					"low": "medium",
+					"medium": "high",
+					"high": "xhigh",
+					"xhigh": "max"
+				},
+				"supportsDisplay": true
+			}
 		}
 	},
 	"azure": {

package/src/provider-models/descriptors.ts

@@ -80,7 +80,7 @@ export const CATALOG_PROVIDERS = [
 	},
 	{
 		id: "anthropic",
-		defaultModel: "claude-opus-4-8",
+		defaultModel: "claude-opus-5-5",
 		envVars: ["ANTHROPIC_API_KEY"],
 		createModelManagerOptions: (config: ModelManagerConfig) => anthropicModelManagerOptions(config),
 		catalogDiscovery: { label: "Anthropic" },

package/src/provider-models/google.ts

@@ -1,4 +1,4 @@
-import { fetchAntigravityDiscoveryModels } from "../discovery/antigravity";
+import { ANTIGRAVITY_PRIMARY_ENDPOINT, fetchAntigravityDiscoveryModels } from "../discovery/antigravity";
 import { fetchGeminiModels } from "../discovery/gemini";
 import type { ModelManagerOptions } from "../model-manager";
 import type { FetchImpl } from "../types";
@@ -21,6 +21,10 @@ export interface GoogleAntigravityModelManagerConfig {
 	oauthToken?: string;
 	endpoint?: string;
 	fetch?: FetchImpl;
+	/** Stable credential identity; falls back to the token when unavailable. */
+	cacheScope?: string;
+	/** Resolve a fresh token only when discovery actually needs the network. */
+	resolveOAuthToken?: (signal: AbortSignal) => Promise<string | undefined>;
 }
 
 export interface GoogleGeminiCliModelManagerConfig {
@@ -60,17 +64,26 @@ export function googleVertexModelManagerOptions(_config?: GoogleVertexModelManag
 export function googleAntigravityModelManagerOptions(
 	config?: GoogleAntigravityModelManagerConfig,
 ): ModelManagerOptions<"google-gemini-cli"> {
-	const token = config?.oauthToken;
+	const token = config?.oauthToken?.trim();
+	const endpoint = (config?.endpoint ?? ANTIGRAVITY_PRIMARY_ENDPOINT).replace(/\/+$/, "");
 	return {
 		providerId: "google-antigravity",
 		...(token
 			? {
-					fetchDynamicModels: () =>
-						fetchAntigravityDiscoveryModels({
-							token,
+					cacheProviderId: `google-antigravity:discovery-v2:${Bun.hash(JSON.stringify([endpoint, config?.cacheScope ?? token])).toString(36)}`,
+					dynamicModelsAuthoritative: true,
+					preserveAuthoritativeCacheOnFailure: true,
+					fetchDynamicModels: async () => {
+						const signal = AbortSignal.timeout(10_000);
+						const resolvedToken = config?.resolveOAuthToken ? await config.resolveOAuthToken(signal) : token;
+						if (!resolvedToken?.trim() || signal.aborted) return null;
+						return fetchAntigravityDiscoveryModels({
+							token: resolvedToken,
 							endpoint: config?.endpoint,
 							fetcher: toDiscoveryFetch(config?.fetch),
-						}),
+							signal,
+						});
+					},
 				}
 			: undefined),
 	};

package/src/provider-models/openai-compat.ts

@@ -160,8 +160,8 @@ function buildAnthropicReferenceMap(
 	for (const model of modelsDevModels) {
 		merged.set(model.id, model);
 	}
-	// Anthropic /v1/models does not carry token limits, so bundled metadata stays canonical
-	// for known models while models.dev only fills gaps for newly discovered ids.
+	// Bundled metadata supplies pricing and missing capabilities; first-party
+	// discovery overrides limits and capabilities when the endpoint reports them.
 	const bundledModels = getBundledModels("anthropic").filter(
 		(model): model is Model<"anthropic-messages"> => model.api === "anthropic-messages",
 	);
@@ -3655,51 +3655,58 @@ export function anthropicModelManagerOptions(
 	config?: AnthropicModelManagerConfig,
 ): ModelManagerOptions<"anthropic-messages"> {
 	const apiKey = config?.apiKey;
-	const baseUrl = config?.baseUrl ?? ANTHROPIC_BASE_URL;
+	const baseUrl = normalizeAnthropicBaseUrl(config?.baseUrl, ANTHROPIC_BASE_URL);
 	return {
 		providerId: "anthropic",
 		modelsDev: {
-			fetch: () => fetchModelsDevPayload(config?.fetch),
+			fetch: () => withCatalogDiscoveryTimeout(10_000, signal => fetchModelsDevPayload(config?.fetch, signal)),
 			map: payload => mapAnthropicModelsDev(payload, baseUrl),
 		},
 		...(apiKey && {
-			fetchDynamicModels: async () => {
-				const modelsDevModels = await fetchModelsDevPayload(config?.fetch)
-					.then(payload => mapAnthropicModelsDev(payload, baseUrl))
-					.catch(() => []);
-				const references = buildAnthropicReferenceMap(modelsDevModels);
-				return (
-					fetchOpenAICompatibleModels({
+			fetchDynamicModels: () =>
+				withCatalogDiscoveryTimeout(15_000, async signal => {
+					const modelsDevModels = await fetchModelsDevPayload(config?.fetch, signal)
+						.then(payload => mapAnthropicModelsDev(payload, baseUrl))
+						.catch(() => []);
+					const references = buildAnthropicReferenceMap(modelsDevModels);
+					return fetchOpenAICompatibleModels({
 						api: "anthropic-messages",
 						provider: "anthropic",
-						baseUrl,
+						baseUrl: toAnthropicDiscoveryBaseUrl(baseUrl),
 						headers: buildAnthropicDiscoveryHeaders(apiKey),
-						mapModel: (
-							entry: OpenAICompatibleModelRecord,
-							defaults: ModelSpec<"anthropic-messages">,
-							_context: OpenAICompatibleModelMapperContext<"anthropic-messages">,
-						): ModelSpec<"anthropic-messages"> => {
-							const discoveredName = typeof entry.display_name === "string" ? entry.display_name : defaults.name;
+						pagination: "anthropic",
+						signal,
+						mapModel: (entry, defaults): ModelSpec<"anthropic-messages"> => {
 							const reference = references.get(defaults.id);
-							if (!reference) {
-								return {
-									...defaults,
-									name: discoveredName,
-								};
-							}
+							const capabilities = isRecord(entry.capabilities) ? entry.capabilities : undefined;
+							const thinking =
+								capabilities && isRecord(capabilities.thinking) ? capabilities.thinking : undefined;
+							const imageInput =
+								capabilities && isRecord(capabilities.image_input) ? capabilities.image_input : undefined;
 							return {
-								...reference,
+								...(reference ?? defaults),
 								id: defaults.id,
-								name: discoveredName,
+								name: toModelName(entry.display_name, reference?.name ?? defaults.name),
 								api: "anthropic-messages",
 								provider: "anthropic",
 								baseUrl,
+								reasoning: toBoolean(thinking?.supported) ?? reference?.reasoning ?? defaults.reasoning,
+								input:
+									toBoolean(imageInput?.supported) === true
+										? ["text", "image"]
+										: toBoolean(imageInput?.supported) === false
+											? ["text"]
+											: (reference?.input ?? defaults.input),
+								contextWindow: toPositiveNumber(
+									entry.max_input_tokens,
+									reference?.contextWindow ?? defaults.contextWindow,
+								),
+								maxTokens: toPositiveNumber(entry.max_tokens, reference?.maxTokens ?? defaults.maxTokens),
 							};
 						},
 						fetch: config?.fetch,
-					}) ?? null
-				);
-			},
+					});
+				}),
 		}),
 	};
 }

package/src/variant-collapse.ts

@@ -220,6 +220,33 @@ function geminiFlashFamily(mode: "budget" | "google-level"): EffortVariantFamily
 	};
 }
 
+function gemini38FlashFamily(mode: "budget" | "google-level"): EffortVariantFamily {
+	const budget = mode === "budget";
+	return {
+		id: "gemini-3.8-flash",
+		name: "Gemini 3.8 Flash",
+		members: ["gemini-3.8-flash-tiered", "gemini-3.8-flash"],
+		routing: {
+			off: "gemini-3.8-flash-tiered",
+			[Effort.Minimal]: "gemini-3.8-flash-tiered",
+			[Effort.Low]: "gemini-3.8-flash-tiered",
+			[Effort.Medium]: "gemini-3.8-flash-tiered",
+			[Effort.High]: "gemini-3.8-flash-tiered",
+		},
+		thinking: budget
+			? { mode: "budget", efforts: GEMINI_3_FLASH_FAMILY_EFFORTS, effortBudgets: GEMINI_3_FLASH_FAMILY_BUDGETS }
+			: { mode: "google-level", efforts: GEMINI_3_FLASH_FAMILY_EFFORTS },
+		suppressWhenOff: true,
+		preserveAbsentEffortRoutes: true,
+		extraAliases: [
+			"gemini-3.8-flash-tiered",
+			"gemini-3.8-flash-low",
+			"gemini-3.8-flash-medium",
+			"gemini-3.8-flash-high",
+		],
+	};
+}
+
 function geminiProFamily(mode: "budget" | "google-level"): EffortVariantFamily {
 	const budget = mode === "budget";
 	return {
@@ -302,12 +329,22 @@ const SHARED_CCA_FAMILIES: readonly EffortVariantFamily[] = [
 
 /** `google-antigravity` (daily-cloudcode-pa): Gemini 3.x on the budget transport. */
 export const ANTIGRAVITY_VARIANT_COLLAPSE_TABLE: VariantCollapseTable = {
-	families: [geminiFlashFamily("budget"), geminiProFamily("budget"), ...SHARED_CCA_FAMILIES],
+	families: [
+		gemini38FlashFamily("budget"),
+		geminiFlashFamily("budget"),
+		geminiProFamily("budget"),
+		...SHARED_CCA_FAMILIES,
+	],
 };
 
 /** `google-gemini-cli` (cloudcode-pa): Gemini 3.x on the level transport (official CLI parity). */
 export const GEMINI_CLI_VARIANT_COLLAPSE_TABLE: VariantCollapseTable = {
-	families: [geminiFlashFamily("google-level"), geminiProFamily("google-level"), ...SHARED_CCA_FAMILIES],
+	families: [
+		gemini38FlashFamily("google-level"),
+		geminiFlashFamily("google-level"),
+		geminiProFamily("google-level"),
+		...SHARED_CCA_FAMILIES,
+	],
 };
 export const DEVIN_VARIANT_COLLAPSE_TABLE: VariantCollapseTable = {
 	families: [

package/src/wire/gemini-headers.ts

@@ -58,6 +58,8 @@ export interface AntigravityModelWireProfile {
 	maxOutputTokens: number;
 }
 export const ANTIGRAVITY_MODEL_WIRE_PROFILES: Readonly<Record<string, AntigravityModelWireProfile>> = {
+	"gemini-3.8-flash-tiered": { modelEnum: "MODEL_PLACEHOLDER_M322", maxOutputTokens: 65536 },
+	"gemini-3.8-flash": { modelEnum: "MODEL_PLACEHOLDER_M322", maxOutputTokens: 65536 },
 	"gemini-3.5-flash-extra-low": { modelEnum: "MODEL_PLACEHOLDER_M187", maxOutputTokens: 65536 },
 	"gemini-3.5-flash-low": { modelEnum: "MODEL_PLACEHOLDER_M20", maxOutputTokens: 65536 },
 	"gemini-3-flash-agent": { modelEnum: "MODEL_PLACEHOLDER_M132", maxOutputTokens: 65536 },