@oh-my-pi/pi-catalog 17.3.1 → 17.3.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [17.3.2] - 2026-08-13
+
+### Added
+
+- Added support for the `deepseek-v4-pro:preview` model
+- Added support for the `gemini-3.7-flash` model
+- Added dynamic Antigravity client-version discovery from the official update manifest (darwin/arm64 channel), so version-gated models appear without a code change; `PI_AI_ANTIGRAVITY_VERSION` remains available as an override.
+
+### Fixed
+
+- Fixed Antigravity discovery missing Gemini 3.7 Flash: Cloud Code Assist gates newer models on the client version in the `User-Agent`, and the pinned `antigravity/hub/2.1.4` was too old. The user-agent now matches the captured 2.8.0 client format (`antigravity/hub/2.8.0 (aidev_client; os_type=darwin; arch=arm64; cl=963137146)`); os_type/arch stay pinned to the darwin/arm64 reference client. Overridable via `PI_AI_ANTIGRAVITY_VERSION` / `PI_AI_ANTIGRAVITY_CL` / `PI_AI_ANTIGRAVITY_OS` / `PI_AI_ANTIGRAVITY_ARCH`.
+
+### Removed
+
+- Removed `ANTIGRAVITY_SYSTEM_INSTRUCTION` from `wire/gemini-headers`; the Antigravity transport and web search no longer inject a fake identity prompt.
+
 ## [17.3.1] - 2026-08-13
 
 ### Added

package/dist/types/wire/gemini-headers.d.ts

@@ -1,3 +1,4 @@
+import type { FetchImpl } from "@oh-my-pi/pi-utils";
 /**
  * Build a User-Agent string that identifies as Gemini CLI to unlock higher rate limits.
  * Uses the same format as the official Gemini CLI (v0.35+):
@@ -8,14 +9,38 @@ export declare const getGeminiCliHeaders: (modelId?: string) => {
     "User-Agent": string;
     "Client-Metadata": string;
 };
-export declare const ANTIGRAVITY_SYSTEM_INSTRUCTION: string;
 /**
  * Antigravity / Cloud Code Assist user agent. Lives in its own file so discovery
  * and usage code can read it without pulling the heavy google-gemini-cli provider
  * (and its @google/genai → google-auth-library dependency chain) into the startup
  * parse graph.
+ *
+ * Format captured from the real 2.8.0 `antigravity/hub` client:
+ * `antigravity/hub/2.8.0 (aidev_client; os_type=darwin; arch=arm64; cl=963137146)`.
+ * The backend gates newer models (e.g. gemini-3.7-flash) on the client version,
+ * so the version tracks the latest Antigravity release via the update manifest
+ * (see {@link ensureAntigravityVersion}) with `DEFAULT_ANTIGRAVITY_VERSION` as
+ * the offline fallback. os_type/arch are pinned to the darwin/arm64 reference
+ * client the version and manifest are captured from, independent of the host
+ * platform. Overrides: PI_AI_ANTIGRAVITY_VERSION / _CL / _OS / _ARCH.
  */
-export declare let getAntigravityUserAgent: () => string;
+export declare const DEFAULT_ANTIGRAVITY_VERSION = "2.8.0";
+/** Current Antigravity client version: env override → manifest-discovered → pinned fallback. */
+export declare function getAntigravityVersion(): string;
+/**
+ * Extracts the client version from an electron-builder update manifest.
+ * Returns null when no well-formed `version:` line is present.
+ */
+export declare function parseAntigravityManifestVersion(yamlText: string): string | null;
+/**
+ * Resolves the latest Antigravity release from the official update manifest.
+ * Success is cached for the process lifetime; failures are silent (the pinned
+ * fallback stays valid) and clear the in-flight cache so a later call retries.
+ * Skipped entirely when PI_AI_ANTIGRAVITY_VERSION is set.
+ */
+export declare function ensureAntigravityVersion(fetcher?: FetchImpl, signal?: AbortSignal): Promise<void>;
+/** Antigravity `User-Agent` header value; rebuilt when the discovered version changes. */
+export declare function getAntigravityUserAgent(): string;
 /**
  * Per-wire-id Antigravity Cloud Code Assist request constants, captured from the
  * real `antigravity/hub` client against `daily-cloudcode-pa`. `modelEnum` is the

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-catalog",
-	"version": "17.3.1",
+	"version": "17.3.2",
 	"description": "Model catalog for omp: bundled model database, provider discovery descriptors, model identity, classification, and equivalence",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -35,11 +35,11 @@
 	},
 	"dependencies": {
 		"@bufbuild/protobuf": "^2.12.1",
-		"@oh-my-pi/omptype": "17.3.1",
-		"@oh-my-pi/pi-utils": "17.3.1"
+		"@oh-my-pi/omptype": "17.3.2",
+		"@oh-my-pi/pi-utils": "17.3.2"
 	},
 	"devDependencies": {
-		"@oh-my-pi/pi-ai": "17.3.1",
+		"@oh-my-pi/pi-ai": "17.3.2",
 		"@types/bun": "^1.3.14"
 	},
 	"engines": {

package/src/discovery/antigravity.ts

@@ -6,7 +6,7 @@ import {
 	collapseEffortVariants,
 	type VariantCollapseTable,
 } from "../variant-collapse";
-import { getAntigravityUserAgent } from "../wire/gemini-headers";
+import { ensureAntigravityVersion, getAntigravityUserAgent } from "../wire/gemini-headers";
 
 export const ANTIGRAVITY_PRIMARY_ENDPOINT = "https://daily-cloudcode-pa.googleapis.com";
 export const ANTIGRAVITY_SANDBOX_ENDPOINT = "https://daily-cloudcode-pa.sandbox.googleapis.com";
@@ -161,6 +161,10 @@ export interface FetchAntigravityDiscoveryModelsOptions {
 export async function fetchAntigravityDiscoveryModels(
 	options: FetchAntigravityDiscoveryModelsOptions,
 ): Promise<ModelSpec<"google-gemini-cli">[] | null> {
+	if (options.userAgent === undefined) {
+		await ensureAntigravityVersion(options.fetcher ?? fetch, options.signal);
+	}
+
 	const fetcher = discoveryFetch(options.fetcher);
 	const endpoints = options.endpoint
 		? [trimTrailingSlashes(options.endpoint)]

package/src/models.json

@@ -25988,6 +25988,43 @@
 				}
 			}
 		},
+		"gemini-3.7-flash": {
+			"id": "gemini-3.7-flash",
+			"name": "Gemini 3.7 Flash",
+			"api": "google-gemini-cli",
+			"provider": "google-antigravity",
+			"baseUrl": "https://daily-cloudcode-pa.googleapis.com",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 0.75,
+				"output": 3.75,
+				"cacheRead": 0.075,
+				"cacheWrite": 0
+			},
+			"contextWindow": 1048576,
+			"maxTokens": 65536,
+			"requestModelId": "gemini-3.7-flash-low",
+			"thinking": {
+				"mode": "google-level",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high"
+				],
+				"requiresEffort": true,
+				"effortRouting": {
+					"minimal": "gemini-3.7-flash-low",
+					"low": "gemini-3.7-flash-low",
+					"medium": "gemini-3.7-flash-medium",
+					"high": "gemini-3.7-flash-high"
+				}
+			}
+		},
 		"gpt-oss-120b": {
 			"id": "gpt-oss-120b",
 			"name": "GPT OSS 120B",
@@ -29128,12 +29165,12 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.079996,
-				"output": 0.252,
-				"cacheRead": 0.0252,
+				"input": 0.072,
+				"output": 0.144,
+				"cacheRead": 0.016,
 				"cacheWrite": 0
 			},
-			"contextWindow": 1048576,
+			"contextWindow": 262144,
 			"maxTokens": 262144,
 			"thinking": {
 				"mode": "effort",
@@ -29156,10 +29193,10 @@
 				"image"
 			],
 			"cost": {
-				"input": 1.5,
-				"output": 7.5,
-				"cacheRead": 0.15,
-				"cacheWrite": 0.083333
+				"input": 0.375,
+				"output": 1.875,
+				"cacheRead": 0.0375,
+				"cacheWrite": 0.020833
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -29216,13 +29253,13 @@
 				"image"
 			],
 			"cost": {
-				"input": 2.8,
-				"output": 14,
-				"cacheRead": 0.29,
+				"input": 2.4,
+				"output": 12,
+				"cacheRead": 0.24,
 				"cacheWrite": 0
 			},
-			"contextWindow": 1048576,
-			"maxTokens": 1048576,
+			"contextWindow": 974842,
+			"maxTokens": 974842,
 			"thinking": {
 				"mode": "effort",
 				"efforts": [
@@ -32370,10 +32407,10 @@
 				"image"
 			],
 			"cost": {
-				"input": 1.5,
-				"output": 7.5,
-				"cacheRead": 0.15,
-				"cacheWrite": 0.083333
+				"input": 0.75,
+				"output": 3.75,
+				"cacheRead": 0.075,
+				"cacheWrite": 0.041667
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -32394,19 +32431,29 @@
 			"api": "openai-completions",
 			"provider": "kilo",
 			"baseUrl": "https://api.kilo.ai/api/gateway",
-			"reasoning": false,
+			"reasoning": true,
 			"input": [
-				"text"
+				"text",
+				"image"
 			],
 			"cost": {
-				"input": 0,
-				"output": 0,
-				"cacheRead": 0,
-				"cacheWrite": 0
+				"input": 0.75,
+				"output": 3.75,
+				"cacheRead": 0.075,
+				"cacheWrite": 0.041667
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
-			"supportsComputerUse": false
+			"thinking": {
+				"mode": "effort",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high"
+				],
+				"requiresEffort": true
+			}
 		},
 		"google/gemma-2-27b-it": {
 			"id": "google/gemma-2-27b-it",
@@ -41453,9 +41500,9 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.55,
-				"output": 2.2,
-				"cacheRead": 0.11,
+				"input": 0.5,
+				"output": 2,
+				"cacheRead": 0.1,
 				"cacheWrite": 0
 			},
 			"contextWindow": 202752,
@@ -41533,9 +41580,9 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.6,
-				"output": 2.2,
-				"cacheRead": 0.11,
+				"input": 0.4,
+				"output": 1.75,
+				"cacheRead": 0.08,
 				"cacheWrite": 0
 			},
 			"contextWindow": 202752,
@@ -41562,7 +41609,7 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.07,
+				"input": 0.06,
 				"output": 0.4,
 				"cacheRead": 0.01,
 				"cacheWrite": 0
@@ -41591,8 +41638,8 @@
 				"text"
 			],
 			"cost": {
-				"input": 1,
-				"output": 3.2,
+				"input": 0.95,
+				"output": 2.55,
 				"cacheRead": 0.2,
 				"cacheWrite": 0
 			},
@@ -41649,7 +41696,7 @@
 				"text"
 			],
 			"cost": {
-				"input": 1.38,
+				"input": 1.4,
 				"output": 4.4,
 				"cacheRead": 0.26,
 				"cacheWrite": 0
@@ -41683,7 +41730,7 @@
 				"cacheRead": 0.26,
 				"cacheWrite": 0
 			},
-			"contextWindow": 262144,
+			"contextWindow": 1048576,
 			"maxTokens": 131072,
 			"thinking": {
 				"mode": "effort",
@@ -51050,7 +51097,7 @@
 				"input": 1.5,
 				"output": 9,
 				"cacheRead": 0.15,
-				"cacheWrite": 0
+				"cacheWrite": 0.083333
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -51110,7 +51157,37 @@
 				"input": 1.5,
 				"output": 7.5,
 				"cacheRead": 0.15,
-				"cacheWrite": 0
+				"cacheWrite": 0.041667
+			},
+			"contextWindow": 1048576,
+			"maxTokens": 65536,
+			"thinking": {
+				"mode": "effort",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high"
+				],
+				"requiresEffort": true
+			}
+		},
+		"google/gemini-3.7-flash": {
+			"id": "google/gemini-3.7-flash",
+			"name": "Gemini 3.7 Flash",
+			"api": "openai-completions",
+			"provider": "nanogpt",
+			"baseUrl": "https://nano-gpt.com/api/v1",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 0.375,
+				"output": 1.875,
+				"cacheRead": 0.0375,
+				"cacheWrite": 0.020833
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -71596,6 +71673,35 @@
 				]
 			}
 		},
+		"deepseek-v4-pro:preview": {
+			"id": "deepseek-v4-pro:preview",
+			"name": "deepseek-v4-pro:preview",
+			"api": "ollama-chat",
+			"provider": "ollama-cloud",
+			"baseUrl": "https://ollama.com",
+			"reasoning": true,
+			"thinking": {
+				"mode": "effort",
+				"efforts": [
+					"low",
+					"high",
+					"max"
+				]
+			},
+			"input": [
+				"text"
+			],
+			"cost": {
+				"input": 0,
+				"output": 0,
+				"cacheRead": 0,
+				"cacheWrite": 0
+			},
+			"contextWindow": 524288,
+			"maxTokens": 65536,
+			"omitMaxOutputTokens": true,
+			"supportsComputerUse": false
+		},
 		"devstral-2:123b": {
 			"id": "devstral-2:123b",
 			"name": "devstral-2:123b",
@@ -76127,6 +76233,36 @@
 				"requiresEffort": true
 			}
 		},
+		"gemini-3.7-flash": {
+			"id": "gemini-3.7-flash",
+			"name": "Gemini 3.7 Flash",
+			"api": "google-generative-ai",
+			"provider": "opencode-zen",
+			"baseUrl": "https://opencode.ai/zen/v1",
+			"reasoning": true,
+			"input": [
+				"text",
+				"image"
+			],
+			"cost": {
+				"input": 1.5,
+				"output": 7.5,
+				"cacheRead": 0.15,
+				"cacheWrite": 0
+			},
+			"contextWindow": 1048576,
+			"maxTokens": 65536,
+			"thinking": {
+				"mode": "google-level",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high"
+				],
+				"requiresEffort": true
+			}
+		},
 		"glm-4.6": {
 			"id": "glm-4.6",
 			"name": "GLM-4.6",
@@ -77974,13 +78110,13 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.079996,
-				"output": 0.252,
-				"cacheRead": 0.0252,
+				"input": 0.072,
+				"output": 0.144,
+				"cacheRead": 0.016,
 				"cacheWrite": 0
 			},
 			"contextWindow": 1048576,
-			"maxTokens": 131072,
+			"maxTokens": 262144,
 			"thinking": {
 				"mode": "effort",
 				"efforts": [
@@ -78007,7 +78143,7 @@
 				"input": 0.375,
 				"output": 1.875,
 				"cacheRead": 0.0375,
-				"cacheWrite": 0.0416666666666667
+				"cacheWrite": 0.0208333333333333
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -78066,13 +78202,13 @@
 				"image"
 			],
 			"cost": {
-				"input": 2.8,
-				"output": 14,
-				"cacheRead": 0.29,
+				"input": 2.4,
+				"output": 12,
+				"cacheRead": 0.24,
 				"cacheWrite": 0
 			},
 			"contextWindow": 1048576,
-			"maxTokens": 1048576,
+			"maxTokens": 974842,
 			"thinking": {
 				"mode": "effort",
 				"efforts": [
@@ -81235,10 +81371,10 @@
 				"image"
 			],
 			"cost": {
-				"input": 1.5,
-				"output": 7.5,
-				"cacheRead": 0.15,
-				"cacheWrite": 0.0833333333333333
+				"input": 0.75,
+				"output": 3.75,
+				"cacheRead": 0.075,
+				"cacheWrite": 0.0416666666666667
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -81267,10 +81403,10 @@
 				"image"
 			],
 			"cost": {
-				"input": 0.75,
-				"output": 3.75,
-				"cacheRead": 0.075,
-				"cacheWrite": 0.0833333333333333
+				"input": 0.375,
+				"output": 1.875,
+				"cacheRead": 0.0375,
+				"cacheWrite": 0.0416666666666667
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -81302,7 +81438,7 @@
 				"input": 0.375,
 				"output": 1.875,
 				"cacheRead": 0.0375,
-				"cacheWrite": 0.0416666666666667
+				"cacheWrite": 0.0208333333333333
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -81331,10 +81467,10 @@
 				"image"
 			],
 			"cost": {
-				"input": 0.375,
-				"output": 1.875,
-				"cacheRead": 0.0375,
-				"cacheWrite": 0.0416666666666667
+				"input": 0.1875,
+				"output": 0.9375,
+				"cacheRead": 0.01875,
+				"cacheWrite": 0.0208333333333333
 			},
 			"contextWindow": 1048576,
 			"maxTokens": 65536,
@@ -83285,9 +83421,9 @@
 				"image"
 			],
 			"cost": {
-				"input": 0.5795,
-				"output": 2.44,
-				"cacheRead": 0.0976,
+				"input": 0.5605,
+				"output": 2.36,
+				"cacheRead": 0.0944,
 				"cacheWrite": 0
 			},
 			"contextWindow": 262144,
@@ -83915,7 +84051,7 @@
 				"cacheRead": 0.049999999999999996,
 				"cacheWrite": 0
 			},
-			"contextWindow": 1048576,
+			"contextWindow": 1000000,
 			"maxTokens": 262144,
 			"thinking": {
 				"mode": "effort",
@@ -90620,9 +90756,9 @@
 				"text"
 			],
 			"cost": {
-				"input": 0.49,
-				"output": 1.54,
-				"cacheRead": 0.091,
+				"input": 0.392,
+				"output": 1.232,
+				"cacheRead": 0.0728,
 				"cacheWrite": 0
 			},
 			"contextWindow": 1048576,
@@ -96815,6 +96951,36 @@
 			},
 			"supportsComputerUse": false
 		},
+		"alibaba/qwen3.8-2.4t-a95b": {
+			"id": "alibaba/qwen3.8-2.4t-a95b",
+			"name": "Qwen3.8 2.4T A95B",
+			"api": "anthropic-messages",
+			"provider": "vercel-ai-gateway",
+			"baseUrl": "https://ai-gateway.vercel.sh",
+			"reasoning": true,
+			"input": [
+				"text"
+			],
+			"cost": {
+				"input": 2,
+				"output": 6,
+				"cacheRead": 0.25,
+				"cacheWrite": 0
+			},
+			"contextWindow": 262144,
+			"maxTokens": 131072,
+			"thinking": {
+				"mode": "budget",
+				"efforts": [
+					"minimal",
+					"low",
+					"medium",
+					"high",
+					"xhigh"
+				]
+			},
+			"supportsComputerUse": false
+		},
 		"alibaba/qwen3.8-max": {
 			"id": "alibaba/qwen3.8-max",
 			"name": "Qwen 3.8 Max",
@@ -98529,7 +98695,7 @@
 				"cacheRead": 0,
 				"cacheWrite": 0
 			},
-			"contextWindow": 256000,
+			"contextWindow": 262144,
 			"maxTokens": 131072,
 			"thinking": {
 				"mode": "budget",

package/src/wire/gemini-headers.ts

@@ -1,3 +1,5 @@
+import type { FetchImpl } from "@oh-my-pi/pi-utils";
+
 /**
  * Build a User-Agent string that identifies as Gemini CLI to unlock higher rate limits.
  * Uses the same format as the official Gemini CLI (v0.35+):
@@ -15,30 +17,89 @@ export const getGeminiCliHeaders = (modelId?: string) => ({
 	"Client-Metadata": "ideType=IDE_UNSPECIFIED,platform=PLATFORM_UNSPECIFIED,pluginType=GEMINI",
 });
 
-export const ANTIGRAVITY_SYSTEM_INSTRUCTION =
-	"You are Antigravity, a powerful agentic AI coding assistant designed by the Google Deepmind team working on Advanced Agentic Coding." +
-	"You are pair programming with a USER to solve their coding task. The task may require creating a new codebase, modifying or debugging an existing codebase, or simply answering a question." +
-	"**Absolute paths only**" +
-	"**Proactiveness**";
 /**
  * Antigravity / Cloud Code Assist user agent. Lives in its own file so discovery
  * and usage code can read it without pulling the heavy google-gemini-cli provider
  * (and its @google/genai → google-auth-library dependency chain) into the startup
  * parse graph.
+ *
+ * Format captured from the real 2.8.0 `antigravity/hub` client:
+ * `antigravity/hub/2.8.0 (aidev_client; os_type=darwin; arch=arm64; cl=963137146)`.
+ * The backend gates newer models (e.g. gemini-3.7-flash) on the client version,
+ * so the version tracks the latest Antigravity release via the update manifest
+ * (see {@link ensureAntigravityVersion}) with `DEFAULT_ANTIGRAVITY_VERSION` as
+ * the offline fallback. os_type/arch are pinned to the darwin/arm64 reference
+ * client the version and manifest are captured from, independent of the host
+ * platform. Overrides: PI_AI_ANTIGRAVITY_VERSION / _CL / _OS / _ARCH.
  */
-export let getAntigravityUserAgent = () => {
-	const DEFAULT_ANTIGRAVITY_VERSION = "2.1.4";
-	const version = process.env.PI_AI_ANTIGRAVITY_VERSION || DEFAULT_ANTIGRAVITY_VERSION;
-	// Map Node.js platform/arch to Antigravity's expected format.
-	// Verified against Antigravity source: _qn() and wqn() in main.js.
-	// process.platform: win32→windows, others pass through (darwin, linux)
-	// process.arch:     x64→amd64, ia32→386, others pass through (arm64)
-	const os = process.platform === "win32" ? "windows" : process.platform;
-	const arch = process.arch === "x64" ? "amd64" : process.arch === "ia32" ? "386" : process.arch;
-	const userAgent = `antigravity/hub/${version} ${os}/${arch}`;
-	getAntigravityUserAgent = () => userAgent;
-	return userAgent;
-};
+export const DEFAULT_ANTIGRAVITY_VERSION = "2.8.0";
+
+const ANTIGRAVITY_VERSION_MANIFEST_URL =
+	"https://antigravity-hub-auto-updater-974169037036.us-central1.run.app/manifest/latest-arm64-mac.yml";
+const ANTIGRAVITY_VERSION_FETCH_TIMEOUT_MS = 5_000;
+
+let discoveredAntigravityVersion: string | null = null;
+let antigravityVersionFetch: Promise<void> | null = null;
+
+/** Current Antigravity client version: env override → manifest-discovered → pinned fallback. */
+export function getAntigravityVersion(): string {
+	return process.env.PI_AI_ANTIGRAVITY_VERSION || discoveredAntigravityVersion || DEFAULT_ANTIGRAVITY_VERSION;
+}
+
+/**
+ * Extracts the client version from an electron-builder update manifest.
+ * Returns null when no well-formed `version:` line is present.
+ */
+export function parseAntigravityManifestVersion(yamlText: string): string | null {
+	for (const line of yamlText.split(/\r?\n/)) {
+		const match = /^\s*version\s*:\s*(?:"([^"]*)"|'([^']*)'|([^\s#]+))\s*(?:#.*)?$/.exec(line);
+		if (!match) continue;
+		const version = (match[1] ?? match[2] ?? match[3] ?? "").trim();
+		return /^\d+\.\d+\.\d+$/.test(version) ? version : null;
+	}
+	return null;
+}
+
+/**
+ * Resolves the latest Antigravity release from the official update manifest.
+ * Success is cached for the process lifetime; failures are silent (the pinned
+ * fallback stays valid) and clear the in-flight cache so a later call retries.
+ * Skipped entirely when PI_AI_ANTIGRAVITY_VERSION is set.
+ */
+export function ensureAntigravityVersion(fetcher: FetchImpl = fetch, signal?: AbortSignal): Promise<void> {
+	if (process.env.PI_AI_ANTIGRAVITY_VERSION || discoveredAntigravityVersion) return Promise.resolve();
+	if (antigravityVersionFetch) return antigravityVersionFetch;
+
+	antigravityVersionFetch = (async () => {
+		try {
+			const timeoutSignal = AbortSignal.timeout(ANTIGRAVITY_VERSION_FETCH_TIMEOUT_MS);
+			const response = await fetcher(ANTIGRAVITY_VERSION_MANIFEST_URL, {
+				headers: { "Cache-Control": "no-cache", "User-Agent": "electron-builder" },
+				signal: signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal,
+			});
+			if (response.ok) {
+				discoveredAntigravityVersion = parseAntigravityManifestVersion(await response.text());
+			}
+		} catch {
+			// Silent: the pinned fallback remains valid when version discovery fails.
+		} finally {
+			if (!discoveredAntigravityVersion) antigravityVersionFetch = null;
+		}
+	})();
+	return antigravityVersionFetch;
+}
+
+/** Antigravity `User-Agent` header value; rebuilt when the discovered version changes. */
+export function getAntigravityUserAgent(): string {
+	const version = getAntigravityVersion();
+	// The backend does not validate `cl` (verified live: stale, zero, and absent
+	// cl all pass model gating on daily-cloudcode-pa; only the version gates).
+	// The update manifest carries no changelist, so the captured value stays.
+	const cl = process.env.PI_AI_ANTIGRAVITY_CL || "963137146";
+	const os = process.env.PI_AI_ANTIGRAVITY_OS || "darwin";
+	const arch = process.env.PI_AI_ANTIGRAVITY_ARCH || "arm64";
+	return `antigravity/hub/${version} (aidev_client; os_type=${os}; arch=${arch}; cl=${cl})`;
+}
 
 /**
  * Per-wire-id Antigravity Cloud Code Assist request constants, captured from the