jeopi-catalog 16.5.6 → 16.6.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [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/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/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.1",
 	"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.1",
 		"arktype": "2.2.3",
 		"zod": "^4"
 	},
 	"devDependencies": {
-		"jeopi-ai": "16.5.6",
+		"jeopi-ai": "16.6.1",
 		"@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/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/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),
 	};