dsh-image-gen 0.9.0 → 0.9.1

package/README.en.md

@@ -333,7 +333,7 @@ Bring private image generation on your local GPU directly into Agent conversatio
 | Google subscription | auto · 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 4:5 · 5:4 · 16:9 · 9:16 · 21:9 | standard / HD (4K) |
 
 > An `auto` ratio lets the model pick the framing from the prompt; tiers the upstream dropped (e.g. Seedream 5.0's 1K) are never exposed.
-> Google subscription discovers account projects with valid platform enums and includes the ordinary daily endpoint as a compatibility fallback. If discovery returns no project, the legacy compatibility project is still tried but is not cached as an actual account project. Generation failures retain redacted discovery, eligibility, and per-endpoint diagnostics instead of only the last 429. The subscription “Test connection” checks stored sign-in status; successful generation verifies image access for that account. A Code Assist `UNSUPPORTED_CLIENT` response alone does not establish that image generation is unavailable.
+> Google subscription discovers account projects with valid platform enums and includes the ordinary daily endpoint as a compatibility fallback. When discovery returns no project with `UNSUPPORTED_CLIENT`, it retries using the Antigravity client identity without automatically onboarding the account. If discovery still returns no project, the legacy compatibility project is still tried but is not cached as an actual account project. Generation failures retain redacted discovery, eligibility, and per-endpoint diagnostics instead of only the last 429. The subscription “Test connection” checks stored sign-in status; successful generation verifies image access for that account. A Code Assist `UNSUPPORTED_CLIENT` response alone does not establish that image generation is unavailable.
 > Studio exposes separate aspect ratio, resolution, and generation quality controls for OpenAI and compatible providers. Resolution labels show pixel dimensions. Comparison and regeneration preserve these separate parameters.
 > Official OpenAI size presets can be customized with `openaiSizes`, shaped as ratio → tier → pixels, e.g. `{ "16:9": { "2K": "2048x1152", "4K": "3840x2160" } }`. For the gpt-image-2 family, dimensions must be multiples of 16, the longest edge at most 3840, aspect ratio within 1:3–3:1, and total pixels within 655360–8294400. Outputs above 3686400 pixels have experimental upstream support. See the [official API reference](https://developers.openai.com/api/reference/resources/images/methods/generate). Older GPT Image models retain their three standard sizes.
 > Compatible providers use `openaiCompatSizes` in the same format; an empty table retains the legacy sizes. `openaiCompatQuality` sets the default generation quality (empty means omitted), and `openaiCompatQualityOptions` sets Studio choices. Choosing “Provider default (omit)” omits quality for that request. Conversation tools also accept independent `size` and `quality` parameters.

package/README.md

@@ -333,7 +333,7 @@ pnpm dsh plugin --profile web add ./dsh-image-gen
 | Google 订阅        | 自动 · 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 4:5 · 5:4 · 16:9 · 9:16 · 21:9 | 标准 / 高清（4K）                     |
 
 > 「自动」比例表示由模型按 Prompt 自行决定构图；上游已移除的档位（如 Seedream 5.0 的 1K）插件不会暴露。
-> Google 订阅会使用有效的平台枚举发现账号项目，并提供普通 daily 入口作为兼容回退。未返回项目时保留旧兼容项目尝试，但不会把它缓存成账号真实项目；若生图仍失败，错误会保留项目发现、账号资格及各生图入口的脱敏响应，避免只显示最后一个 429。设置中的订阅「测试连接」只检查登录记录，实际生图成功才验证该账号的生图链路；`UNSUPPORTED_CLIENT` 的 Code Assist 提示也不单独判定生图不可用。
+> Google 订阅会使用有效的平台枚举发现账号项目，并提供普通 daily 入口作为兼容回退。项目发现未返回项目且提示 `UNSUPPORTED_CLIENT` 时，会再用 Antigravity 客户端身份重试；该过程不自动开户。仍未返回项目时保留旧兼容项目尝试，但不会把它缓存成账号真实项目；若生图仍失败，错误会保留项目发现、账号资格及各生图入口的脱敏响应，避免只显示最后一个 429。设置中的订阅「测试连接」只检查登录记录，实际生图成功才验证该账号的生图链路；`UNSUPPORTED_CLIENT` 的 Code Assist 提示也不单独判定生图不可用。
 > OpenAI 与兼容渠道的 Studio 控件分别显示「比例 / 分辨率 / 生成质量」，分辨率选项会显示实际像素。多模型对比及再次生成也保留这两类参数。
 > OpenAI 官方可通过设置中的 `openaiSizes` 自定义尺寸表，格式为「比例 → 档位 → 像素」，例如 `{ "16:9": { "2K": "2048x1152", "4K": "3840x2160" } }`。gpt-image-2 系列按官方限制校验：边长为 16 的倍数、最大 3840、比例在 1:3 到 3:1、总像素 655360–8294400；超过 3686400 像素的输出属于上游实验支持。[官方说明](https://developers.openai.com/api/reference/resources/images/methods/generate)。旧版 GPT Image 模型仍只使用三种标准尺寸。
 > OpenAI Compatible 的尺寸表为 `openaiCompatSizes`，格式相同；留空时保持原来的标准尺寸。`openaiCompatQuality` 设置默认生成质量（留空不发送），`openaiCompatQualityOptions` 设置 Studio 可选值。选择「渠道默认（不发送）」可在单次请求中省略 quality；对话工具也支持独立的 `size` 和 `quality` 参数。

package/lib/client.js

@@ -125221,7 +125221,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 `;
 		//#endregion
 		//#region lib/types/client/index.js
-		console.info(`[dsh-image-gen] canvas bundle 2026-10-13T08:42:18.331Z`);
+		console.info(`[dsh-image-gen] canvas bundle 2026-10-15T09:51:10.196Z`);
 		/** Right-sidebar tab-type registration id (DSH 0.1.5 `sidebarRightTabs`). */
 		const SIDEBAR_STUDIO_TAB_ID = "dsh-image-gen/studio";
 		/** The tab kind: a page type opened by kind, recognizing no resource address. */

package/lib/index.js

@@ -7382,6 +7382,81 @@ async function readBoundedBytes$2(response, maxBytes) {
 	return joined;
 }
 //#endregion
+//#region lib/types/fetch-diagnostics.js
+/**
+* Transport-failure diagnostics for provider fetches (#79).
+*
+* Node's undici reports the real reason behind a failed fetch (socket reset,
+* DNS, TLS, ...) only on `error.cause`, and the host's tool-error rendering
+* keeps just `.message` — so the conversation sees nothing but undici's bare
+* "fetch failed". These helpers rethrow transport failures with the failing
+* phase, elapsed seconds, and a bounded cause chain.
+*/
+/** Cap a single transport-failure description so diagnostics cannot flood the conversation. */
+const TRANSPORT_DETAIL_LIMIT = 600;
+/** How deep to walk `error.cause` chains; undici nests at most twice in practice. */
+const CAUSE_CHAIN_DEPTH = 3;
+/** Keep body reads tied to the same request timing, cancellation, and secrets. */
+const responseContexts = /* @__PURE__ */ new WeakMap();
+/**
+* Render one error plus its `cause` chain as a single line, e.g.
+* `TypeError: fetch failed <- Error [UND_ERR_SOCKET]: other side closed`.
+*/
+function describeErrorChain(error, depth = 0) {
+	if (depth >= CAUSE_CHAIN_DEPTH) return "...";
+	if (error === void 0 || error === null) return "unknown transport error";
+	if (typeof error === "object") {
+		const details = error;
+		if (error instanceof Error || typeof details.message === "string") {
+			const label = [typeof details.name === "string" ? details.name : "Error", typeof details.code === "string" && details.code.length > 0 ? `[${details.code}]` : ""].filter((part) => part.length > 0).join(" ");
+			const message = typeof details.message === "string" ? details.message : "";
+			const text = label.length > 0 && message.length > 0 ? `${label}: ${message}` : label || message;
+			return details.cause !== void 0 && details.cause !== null && depth + 1 < CAUSE_CHAIN_DEPTH ? `${text} <- ${describeErrorChain(details.cause, depth + 1)}` : text || "unknown transport error";
+		}
+		if (typeof details.kind === "string") return details.reason === void 0 || details.reason === null ? details.kind : `${details.kind}: ${describeErrorChain(details.reason, depth + 1)}`;
+	}
+	return String(error).trim() || "unknown transport error";
+}
+/** One line describing why a provider fetch failed: the abort reason when the caller cancelled, the cause chain otherwise. */
+function describeTransportFailure(error, signal) {
+	try {
+		if (signal?.aborted === true) return `aborted (${describeErrorChain(signal.reason ?? error)})`;
+		return describeErrorChain(error);
+	} catch {
+		return "unknown transport error";
+	}
+}
+async function withTransportDiagnostics(context, run) {
+	try {
+		return await run();
+	} catch (error) {
+		const elapsed = ((performance.now() - context.startedAt) / 1e3).toFixed(1);
+		const detail = redactSecrets(describeTransportFailure(error, context.signal), ...context.secrets).replace(/\s+/g, " ").slice(0, TRANSPORT_DETAIL_LIMIT);
+		throw new Error(`${context.label} failed after ${elapsed}s: ${detail}`, { cause: error });
+	}
+}
+/**
+* Await one provider fetch and rethrow transport failures as
+* `${label} failed after 12.3s: ${cause chain}`. The original error stays
+* reachable on `cause` for host-side error rendering.
+*/
+async function guardedFetch(label, signal, run, ...secrets) {
+	const context = {
+		label,
+		signal,
+		secrets,
+		startedAt: performance.now()
+	};
+	const response = await withTransportDiagnostics(context, run);
+	responseContexts.set(response, context);
+	return response;
+}
+/** Guard only body I/O; parsing, HTTP checks and size enforcement stay with the adapter. */
+function readResponseBody(response, read) {
+	const context = responseContexts.get(response);
+	return context === void 0 ? read() : withTransportDiagnostics(context, read);
+}
+//#endregion
 //#region lib/types/dashscope.js
 async function generateDashScopeImage(options) {
 	assertQwenImageModel(options.model);
@@ -7435,7 +7510,7 @@ function toDataUrl$3(image) {
 }
 async function requestQwenImage(options) {
 	const base = options.endpoint.replace(/\/+$/, "");
-	const response = await fetch(`${base}/services/aigc/multimodal-generation/generation`, {
+	const response = await guardedFetch(`DashScope image ${options.operation}`, options.signal, () => fetch(`${base}/services/aigc/multimodal-generation/generation`, {
 		method: "POST",
 		...options.signal ? { signal: options.signal } : {},
 		headers: {
@@ -7443,12 +7518,12 @@ async function requestQwenImage(options) {
 			authorization: `Bearer ${options.apiKey}`
 		},
 		body: JSON.stringify(options.requestBody)
-	});
+	}), options.apiKey);
 	if (!response.ok) {
-		const errorText = redactSecrets(await response.text(), options.apiKey);
+		const errorText = redactSecrets(await readResponseBody(response, () => response.text()), options.apiKey);
 		throw new Error(`DashScope image ${options.operation} failed (${String(response.status)}): ${errorText}`);
 	}
-	const payload = await response.json();
+	const payload = JSON.parse(await readResponseBody(response, () => response.text()));
 	const imageUrl = extractImageUrl(payload);
 	if (imageUrl === void 0) throw new Error(`DashScope image ${options.operation} returned no image URL: ${redactSecrets(payload.message ?? JSON.stringify(payload), options.apiKey)}`);
 	return downloadImageBlob(imageUrl, options);
@@ -7463,9 +7538,9 @@ function extractImageUrl(response) {
 	}
 }
 async function downloadImageBlob(imageUrl, options) {
-	const imageResponse = await fetch(imageUrl, { ...options.signal ? { signal: options.signal } : {} });
+	const imageResponse = await guardedFetch("DashScope image download", options.signal, () => fetch(imageUrl, { ...options.signal ? { signal: options.signal } : {} }), options.apiKey);
 	if (!imageResponse.ok) throw new Error(`Failed to fetch DashScope image from URL (${String(imageResponse.status)})`);
-	const buffer = await imageResponse.arrayBuffer();
+	const buffer = await readResponseBody(imageResponse, () => imageResponse.arrayBuffer());
 	if (buffer.byteLength > options.maxBytes) throw new Error(`DashScope generated image (${String(buffer.byteLength)} bytes) exceeds the ${String(options.maxBytes)} byte limit`);
 	const data = new Uint8Array(buffer);
 	const mediaType = detectImageMediaType(data) ?? imageMediaType$3(imageResponse.headers.get("content-type"));
@@ -7520,7 +7595,7 @@ function editGoogleImage(input) {
 /** Shared Google request, response parsing, decoding, and size enforcement. */
 async function requestGoogleImage(input) {
 	const label = `Google image ${input.operation}`;
-	const response = await fetch(input.endpoint, {
+	const response = await guardedFetch(`${label} request`, input.signal, () => fetch(input.endpoint, {
 		method: "POST",
 		redirect: "error",
 		signal: input.signal,
@@ -7538,7 +7613,7 @@ async function requestGoogleImage(input) {
 				image_size: input.imageSize
 			}
 		})
-	});
+	}), input.apiKey);
 	const text = await readBoundedText$2(response, Math.ceil(input.maxBytes * 1.4) + ERROR_LIMIT$2, label);
 	if (!response.ok) throw new Error(`${label} failed (${response.status}): ${redactSecrets(text, input.apiKey).slice(0, ERROR_LIMIT$2)}`);
 	let payload;
@@ -7601,7 +7676,7 @@ async function readBoundedText$2(response, maxBytes, label) {
 	let bytes = 0;
 	try {
 		for (;;) {
-			const next = await reader.read();
+			const next = await readResponseBody(response, () => reader.read());
 			if (next.done) break;
 			bytes += next.value.byteLength;
 			if (bytes > maxBytes) throw new Error(`${label} response exceeded the ${String(maxBytes)} byte limit`);
@@ -8101,7 +8176,7 @@ function jsonError$4(res, status, code) {
 //#region lib/types/openai-compatible.js
 const ERROR_LIMIT$1 = 4096;
 async function generateOpenAICompatibleImage(input) {
-	return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "generations"), {
+	return parseImageResponse(await guardedFetch(`${input.provider} image request`, input.signal, () => fetch(imageEndpoint$1(input.baseURL, "generations"), {
 		method: "POST",
 		redirect: "error",
 		signal: input.signal,
@@ -8120,10 +8195,10 @@ async function generateOpenAICompatibleImage(input) {
 			} : {},
 			...input.extraBody ?? {}
 		})
-	}), input.provider, input);
+	}), input.apiKey), input.provider, input);
 }
 async function editOpenAICompatibleImage(input) {
-	if (input.editFormat === "qwenJson") return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "generations"), {
+	if (input.editFormat === "qwenJson") return parseImageResponse(await guardedFetch("openai-compat image edit request", input.signal, () => fetch(imageEndpoint$1(input.baseURL, "generations"), {
 		method: "POST",
 		redirect: "error",
 		signal: input.signal,
@@ -8140,13 +8215,13 @@ async function editOpenAICompatibleImage(input) {
 			...input.editExtra ?? {},
 			...input.extraBody ?? {}
 		})
-	}), "openai-compat", input);
+	}), input.apiKey), "openai-compat", input);
 	if (input.editFormat === "xaiJson") {
 		const references = input.sourceImages.map((image) => ({
 			type: "image_url",
 			url: toDataUrl$2(image)
 		}));
-		return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "edits"), {
+		return parseImageResponse(await guardedFetch("xai image edit request", input.signal, () => fetch(imageEndpoint$1(input.baseURL, "edits"), {
 			method: "POST",
 			redirect: "error",
 			signal: input.signal,
@@ -8161,7 +8236,7 @@ async function editOpenAICompatibleImage(input) {
 				...input.quality === void 0 ? {} : { quality: input.quality },
 				...input.extraBody ?? {}
 			})
-		}), "xai", input);
+		}), input.apiKey), "xai", input);
 	}
 	if (input.editFormat === "jsonImageUrlArray") {
 		const body = {
@@ -8175,7 +8250,7 @@ async function editOpenAICompatibleImage(input) {
 			...input.editExtra ?? {},
 			...input.extraBody ?? {}
 		};
-		return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "edits"), {
+		return parseImageResponse(await guardedFetch("openai image edit request", input.signal, () => fetch(imageEndpoint$1(input.baseURL, "edits"), {
 			method: "POST",
 			redirect: "error",
 			signal: input.signal,
@@ -8184,7 +8259,7 @@ async function editOpenAICompatibleImage(input) {
 				"content-type": "application/json"
 			},
 			body: JSON.stringify(body)
-		}), "openai", input);
+		}), input.apiKey), "openai", input);
 	}
 	if (input.editFormat === "formReferenceImages") {
 		const form = new FormData();
@@ -8195,13 +8270,13 @@ async function editOpenAICompatibleImage(input) {
 		for (const [key, value] of Object.entries(input.extraBody ?? {})) form.append(key, String(value));
 		form.append("response_format", "b64_json");
 		form.append("reference_images", JSON.stringify(input.sourceImages.map((sourceImage) => Buffer.from(sourceImage.data).toString("base64"))));
-		return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "edits"), {
+		return parseImageResponse(await guardedFetch("openai image edit request", input.signal, () => fetch(imageEndpoint$1(input.baseURL, "edits"), {
 			method: "POST",
 			redirect: "error",
 			signal: input.signal,
 			headers: { authorization: `Bearer ${input.apiKey}` },
 			body: form
-		}), "openai", input);
+		}), input.apiKey), "openai", input);
 	}
 	const form = new FormData();
 	const imageField = input.sourceImages.length > 1 ? "image[]" : "image";
@@ -8216,13 +8291,13 @@ async function editOpenAICompatibleImage(input) {
 	if (input.size !== void 0 && input.size.length > 0) form.append("size", input.size);
 	if (input.quality !== void 0) form.append("quality", input.quality);
 	for (const [key, value] of Object.entries(input.extraBody ?? {})) form.append(key, String(value));
-	return parseImageResponse(await fetch(imageEndpoint$1(input.baseURL, "edits"), {
+	return parseImageResponse(await guardedFetch("openai image edit request", input.signal, () => fetch(imageEndpoint$1(input.baseURL, "edits"), {
 		method: "POST",
 		redirect: "error",
 		signal: input.signal,
 		headers: { authorization: `Bearer ${input.apiKey}` },
 		body: form
-	}), "openai", input);
+	}), input.apiKey), "openai", input);
 }
 async function parseImageResponse(response, provider, input) {
 	const text = await readBoundedText$1(response, Math.ceil(input.maxBytes * 1.4) + ERROR_LIMIT$1);
@@ -8282,15 +8357,15 @@ async function downloadImage$1(url, provider, input) {
 			mediaType: detectImageMediaType(data) ?? imageMediaType$2(parsed.mediaType) ?? "image/png"
 		};
 	}
-	let response = await fetch(url, {
+	let response = await guardedFetch(`${provider} image download`, input.signal, () => fetch(url, {
 		redirect: "follow",
 		signal: input.signal,
 		...input.apiKey === void 0 ? {} : { headers: { authorization: `Bearer ${input.apiKey}` } }
-	});
-	if (!response.ok && input.apiKey !== void 0) response = await fetch(url, {
+	}), input.apiKey);
+	if (!response.ok && input.apiKey !== void 0) response = await guardedFetch(`${provider} image download`, input.signal, () => fetch(url, {
 		redirect: "follow",
 		signal: input.signal
-	});
+	}), input.apiKey);
 	if (!response.ok) throw new Error(`${provider} image download failed (${response.status})`);
 	const data = await readBoundedBytes$1(response, input.maxBytes);
 	const mediaType = detectImageMediaType(data) ?? imageMediaType$2(response.headers.get("content-type"));
@@ -8336,7 +8411,7 @@ async function readBoundedBytes$1(response, maxBytes) {
 	let bytes = 0;
 	try {
 		for (;;) {
-			const next = await reader.read();
+			const next = await readResponseBody(response, () => reader.read());
 			if (next.done) break;
 			bytes += next.value.byteLength;
 			if (bytes > maxBytes) throw new Error(`Image response exceeded the ${String(maxBytes)} byte limit`);
@@ -8358,7 +8433,7 @@ async function readBoundedBytes$1(response, maxBytes) {
 const ERROR_LIMIT = 4096;
 /** Edit one image through Ark ImageGenerations using a data-URL reference. */
 async function editSeedreamImage(input) {
-	const response = await fetch(imageEndpoint(input.baseURL), {
+	const response = await guardedFetch("seedream image editing", input.signal, () => fetch(imageEndpoint(input.baseURL), {
 		method: "POST",
 		redirect: "error",
 		signal: input.signal,
@@ -8374,7 +8449,7 @@ async function editSeedreamImage(input) {
 			...arkOutputBody(input.arkOptions),
 			response_format: "b64_json"
 		})
-	});
+	}), input.apiKey);
 	const text = await readBoundedText(response, Math.ceil(input.maxBytes * 1.4) + ERROR_LIMIT);
 	if (!response.ok) throw new Error(`seedream image editing failed (${response.status}): ${redactSecrets(text, input.apiKey).slice(0, ERROR_LIMIT)}`);
 	let payload;
@@ -8423,10 +8498,10 @@ function firstImage(value) {
 }
 async function downloadImage(url, input) {
 	if (url === void 0) throw new Error("seedream image editing returned no image data");
-	const response = await fetch(url, {
+	const response = await guardedFetch("seedream image download", input.signal, () => fetch(url, {
 		redirect: "follow",
 		signal: input.signal
-	});
+	}), input.apiKey);
 	if (!response.ok) throw new Error(`seedream image download failed (${response.status})`);
 	const mediaType = imageMediaType$1(response.headers.get("content-type"));
 	if (mediaType === void 0) throw new Error("seedream image download returned unsupported content type");
@@ -8456,7 +8531,7 @@ async function readBoundedBytes(response, maxBytes) {
 	let bytes = 0;
 	try {
 		for (;;) {
-			const next = await reader.read();
+			const next = await readResponseBody(response, () => reader.read());
 			if (next.done) break;
 			bytes += next.value.byteLength;
 			if (bytes > maxBytes) throw new Error(`Image response exceeded the ${String(maxBytes)} byte limit`);
@@ -8937,20 +9012,24 @@ function getAntigravityVersion() {
 	return antigravityVersion ?? ANTIGRAVITY_VERSION_FALLBACK;
 }
 /** Fetch and cache the current version once; failures keep the fallback. */
-async function initAntigravityVersion() {
+async function initAntigravityVersion(signal) {
+	signal?.throwIfAborted();
 	if (antigravityVersion !== void 0) return;
-	const parsed = await fetchVersionText(VERSION_URL) ?? await fetchVersionText(CHANGELOG_URL, CHANGELOG_SCAN_CHARS);
+	const parsed = await fetchVersionText(VERSION_URL, void 0, signal) ?? await fetchVersionText(CHANGELOG_URL, CHANGELOG_SCAN_CHARS, signal);
+	signal?.throwIfAborted();
 	if (parsed !== void 0) antigravityVersion = parsed;
 }
-async function fetchVersionText(url, maxChars) {
+async function fetchVersionText(url, maxChars, signal) {
 	try {
-		const response = await fetch(url, { signal: AbortSignal.timeout(VERSION_FETCH_TIMEOUT_MS) });
+		const timeout = AbortSignal.timeout(VERSION_FETCH_TIMEOUT_MS);
+		const response = await fetch(url, { signal: signal === void 0 ? timeout : AbortSignal.any([signal, timeout]) });
 		if (!response.ok) return void 0;
 		let text = await response.text();
 		if (maxChars !== void 0) text = text.slice(0, maxChars);
 		const match = text.match(VERSION_REGEX);
 		return match === null ? void 0 : match[0];
-	} catch {
+	} catch (error) {
+		if (signal?.aborted === true) throw error;
 		return;
 	}
 }
@@ -9016,16 +9095,19 @@ function antigravityAuthorizeUrl(cfg, pkce) {
 	});
 }
 /**
-* Headers for project discovery (loadCodeAssist): the reference keeps the
-* plain SDK identity here, mirroring its project.js loadHeaders.
+* Preserve the SDK discovery identity first. A no-project UNSUPPORTED_CLIENT
+* response can be retried with the same Antigravity identity as generation.
 */
-function loadHeaders(projectId) {
+function loadHeaders(projectId, identity) {
 	return {
-		"User-Agent": "google-api-nodejs-client/9.15.1",
+		"User-Agent": identity === "antigravity" ? antigravityUserAgent() : "google-api-nodejs-client/9.15.1",
 		"X-Goog-Api-Client": "google-cloud-sdk vscode_cloudshelleditor/0.1",
 		"Client-Metadata": JSON.stringify(clientMetadata(projectId))
 	};
 }
+function antigravityUserAgent() {
+	return `Mozilla/5.0 (${process.platform === "darwin" ? "Macintosh; Intel Mac OS X 10_15_7" : "Windows NT 10.0; Win64; x64"}) AppleWebKit/537.36 (KHTML, like Gecko) Antigravity/${getAntigravityVersion()} Chrome/138.0.7204.235 Electron/37.3.1 Safari/537.36`;
+}
 /**
 * Headers for content requests (image generation): the full Electron
 * browser User-Agent with the Antigravity client version, matching the
@@ -9034,7 +9116,7 @@ function loadHeaders(projectId) {
 */
 function contentHeaders(projectId) {
 	return {
-		"User-Agent": `Mozilla/5.0 (${process.platform === "darwin" ? "Macintosh; Intel Mac OS X 10_15_7" : "Windows NT 10.0; Win64; x64"}) AppleWebKit/537.36 (KHTML, like Gecko) Antigravity/${getAntigravityVersion()} Chrome/138.0.7204.235 Electron/37.3.1 Safari/537.36`,
+		"User-Agent": antigravityUserAgent(),
 		"X-Goog-Api-Client": "google-cloud-sdk vscode_cloudshelleditor/0.1",
 		"Client-Metadata": JSON.stringify(clientMetadata(projectId))
 	};
@@ -9100,40 +9182,50 @@ async function antigravityResolveProjectContext(blob, signal) {
 	signal?.throwIfAborted();
 	const metadata = clientMetadata("");
 	const diagnostics = [];
-	for (const base of LOAD_ENDPOINTS) {
-		const label = `loadCodeAssist ${new URL(base).hostname}`;
-		try {
-			const response = await fetch(`${base}/v1internal:loadCodeAssist`, {
-				method: "POST",
-				headers: {
-					"Content-Type": "application/json",
-					Authorization: `Bearer ${blob.accessToken}`,
-					...loadHeaders("")
-				},
-				body: JSON.stringify({ metadata }),
-				signal: signal === void 0 ? AbortSignal.timeout(25e3) : AbortSignal.any([signal, AbortSignal.timeout(25e3)])
-			});
-			if (!response.ok) {
-				diagnostics.push(`${label}: ${httpDiagnostic(response.status, await response.text().catch(() => ""), blob)}`);
-				continue;
-			}
-			const payload = recordOf(await response.json().catch(() => null));
-			if (payload === void 0) {
-				diagnostics.push(`${label}: HTTP ${String(response.status)}, invalid response`);
-				continue;
+	const identityRetryEndpoints = [];
+	for (const identity of ["sdk", "antigravity"]) {
+		const endpoints = identity === "sdk" ? LOAD_ENDPOINTS : identityRetryEndpoints;
+		if (identity === "antigravity") {
+			if (endpoints.length === 0) break;
+			await initAntigravityVersion(signal);
+		}
+		for (const base of endpoints) {
+			signal?.throwIfAborted();
+			const label = `loadCodeAssist ${new URL(base).hostname}${identity === "antigravity" ? ` [Antigravity/${getAntigravityVersion()}]` : ""}`;
+			try {
+				const response = await fetch(`${base}/v1internal:loadCodeAssist`, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						Authorization: `Bearer ${blob.accessToken}`,
+						...loadHeaders("", identity)
+					},
+					body: JSON.stringify({ metadata }),
+					signal: signal === void 0 ? AbortSignal.timeout(25e3) : AbortSignal.any([signal, AbortSignal.timeout(25e3)])
+				});
+				if (!response.ok) {
+					diagnostics.push(`${label}: ${httpDiagnostic(response.status, await response.text().catch(() => ""), blob)}`);
+					continue;
+				}
+				const payload = recordOf(await response.json().catch(() => null));
+				if (payload === void 0) {
+					diagnostics.push(`${label}: HTTP ${String(response.status)}, invalid response`);
+					continue;
+				}
+				const project = payload.cloudaicompanionProject;
+				const projectRecord = recordOf(project);
+				const id = typeof project === "string" ? project : typeof projectRecord?.id === "string" ? projectRecord.id : "";
+				if (id.trim().length > 0) return {
+					projectId: id.trim(),
+					source: "account",
+					diagnostics
+				};
+				diagnostics.push(`${label}: HTTP ${String(response.status)}, ${missingProjectDiagnostic(payload, blob)}`);
+				if (identity === "sdk" && Array.isArray(payload.ineligibleTiers) && payload.ineligibleTiers.some((tier) => recordOf(tier)?.reasonCode === "UNSUPPORTED_CLIENT")) identityRetryEndpoints.push(base);
+			} catch (error) {
+				if (signal?.aborted === true) throw error;
+				diagnostics.push(`${label}: ${diagnosticText(error instanceof Error ? error.message : "request failed", blob)}`);
 			}
-			const project = payload.cloudaicompanionProject;
-			const projectRecord = recordOf(project);
-			const id = typeof project === "string" ? project : typeof projectRecord?.id === "string" ? projectRecord.id : "";
-			if (id.trim().length > 0) return {
-				projectId: id.trim(),
-				source: "account",
-				diagnostics
-			};
-			diagnostics.push(`${label}: HTTP ${String(response.status)}, ${missingProjectDiagnostic(payload, blob)}`);
-		} catch (error) {
-			if (signal?.aborted === true) throw error;
-			diagnostics.push(`${label}: ${diagnosticText(error instanceof Error ? error.message : "request failed", blob)}`);
 		}
 	}
 	return {
@@ -9250,7 +9342,7 @@ function antigravityEnvelope(projectId, request) {
 */
 async function antigravityGenerateImage(options) {
 	options.signal?.throwIfAborted();
-	await initAntigravityVersion();
+	await initAntigravityVersion(options.signal);
 	const inner = antigravityImageBody({
 		prompt: options.prompt,
 		...options.aspectRatio !== void 0 ? { aspectRatio: options.aspectRatio } : {},

package/lib/types/fetch-diagnostics.d.ts

@@ -0,0 +1,10 @@
+/** One line describing why a provider fetch failed: the abort reason when the caller cancelled, the cause chain otherwise. */
+export declare function describeTransportFailure(error: unknown, signal?: AbortSignal): string;
+/**
+ * Await one provider fetch and rethrow transport failures as
+ * `${label} failed after 12.3s: ${cause chain}`. The original error stays
+ * reachable on `cause` for host-side error rendering.
+ */
+export declare function guardedFetch(label: string, signal: AbortSignal | undefined, run: () => Promise<Response>, ...secrets: Array<string | undefined>): Promise<Response>;
+/** Guard only body I/O; parsing, HTTP checks and size enforcement stay with the adapter. */
+export declare function readResponseBody<T>(response: Response, read: () => Promise<T>): Promise<T>;

package/lib/types/subscription/vendors/antigravity.d.ts

@@ -17,7 +17,7 @@ export declare function getAntigravityVersion(): string;
 /** Test seam: pin the version so unit tests never depend on the network. */
 export declare function setAntigravityVersionForTest(version: string | undefined): void;
 /** Fetch and cache the current version once; failures keep the fallback. */
-export declare function initAntigravityVersion(): Promise<void>;
+export declare function initAntigravityVersion(signal?: AbortSignal): Promise<void>;
 export interface AntigravityConfig {
     clientId: string;
     clientSecret: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",